# circejie/hdifftg architecture

> Architecture diagram of the GitHub repository circejie/hdifftg, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/circejie/hdifftg
- Repository: https://github.com/circejie/hdifftg

## Overview

##### Project type and purpose
- This is a small command‐line research/experiment tool for running the HDiffTG model on the 3dhp dataset.
- It orchestrates one or more experiment runs using a JSON config, a Bash wrapper, and a Python script that invokes the model binary.

##### File structure
- 3dhp_gt_HDiffTG.json – experiment configuration (model parameters, input/output paths)
- Experiments.sh – shell script that automates one or more runs (invokes the Python script with configs)
- run_HDiffTG_3dhp.py – main Python entry point, loads config, model binary, dataset, runs inference/training, writes results
- LICENSE – license file (not part of runtime flow)
- README.md – very brief project summary and a link to the pre-trained model binary

##### README for additional insights
- No detailed architecture notes, simply points to the HDiffTG binary
- Implies external dependency: the downloaded 3dhp-18.8.bin model

## Diagram (Mermaid)

```mermaid
flowchart TB
    Experiments["Experiments.sh"]:::shell
    Config["3dhp_gt_HDiffTG.json"]:::data
    Runner["run_HDiffTG_3dhp.py"]:::python
    Model[(Model Binary\n3dhp-18.8.bin)]:::external
    Dataset[(3dhp Dataset)]:::external
    Results[(Results\nLogs/Metrics)]:::data
    Readme["README.md"]:::external
    License["LICENSE"]:::external

    Experiments -->|"reads config"| Config
    Experiments -->|"invokes runner"| Runner
    Runner -->|"loads config"| Config
    Runner -->|"loads model"| Model
    Runner -->|"loads dataset"| Dataset
    Runner -->|"processes data and writes"| Results

    click Experiments "https://github.com/circejie/hdifftg/blob/main/Experiments.sh"
    click Config "https://github.com/circejie/hdifftg/blob/main/3dhp_gt_HDiffTG.json"
    click Runner "https://github.com/circejie/hdifftg/blob/main/run_HDiffTG_3dhp.py"
    click Readme "https://github.com/circejie/hdifftg/blob/main/README.md"
    click License "https://github.com/circejie/hdifftg/tree/main/LICENSE"

    classDef shell fill:#a2f0a2,stroke:#333,stroke-width:1px
    classDef python fill:#a2c4f0,stroke:#333,stroke-width:1px
    classDef data fill:#f9e79f,stroke:#333,stroke-width:1px
    classDef external stroke-dasharray: 5 5,stroke:#555,fill:#fff,stroke-width:1px
    class Experiments shell
    class Runner python
    class Config,Results data
    class Model,Dataset,Readme,License external
```
