# iabhiroop/galaxy_gen architecture

> Architecture diagram of the GitHub repository iabhiroop/galaxy_gen, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iabhiroop/galaxy_gen
- Repository: https://github.com/iabhiroop/galaxy_gen

## Overview

galaxy_gen is a Python library for generating and reconstructing galaxy data with several model families. Its main user workflow is to load a selected model and generate samples; the public sampler dispatches among VAE/flow models and the LOFAR diffusion model. Model-specific components implement the neural architectures, while LOFAR adds configuration, model construction, diffusion sampling, and sample-file output. The map follows documented capabilities and indexed references; some source excerpts are partial, so unsampled internal calls are not inferred.

Main entry points: [`galaxy_gen/sampler.py`](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/sampler.py) (Model loading and sampling), [`galaxy_gen/genmodels/lofarModel/model_utils.py`](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/model_utils.py) (LOFAR model loader), [`galaxy_gen/genmodels/lofarModel/sampler.py`](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/sampler.py) (LOFAR sample generation), [`galaxy_gen/genmodels/lofarModel/unet.py`](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/unet.py) (UNet and EDM model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public sampling API"]
  node_public_sampler["Model loading and sampling<br/>[sampler.py]"]
end

subgraph group_vae["VAE and flow models"]
  node_sample_vae["VAEFlow architecture<br/>[samplemodel.py]"]
  node_formation_model["Formation-time model"]
  node_gamma_model["Gamma-flow model<br/>[gammaflowModel.py]"]
  node_mass_model["Mass model<br/>[massesModel.py]"]
  node_metallicity_model["Metallicity model"]
  node_metallicity_diffusion["Metallicity diffusion model"]
end

subgraph group_lofar["LOFAR diffusion"]
  node_lofar_sampler["LOFAR sample generation<br/>[sampler.py]"]
  node_sample_files[("Sample HDF5 files")]
end

subgraph group_lofar_internal["LOFAR model internals"]
  node_lofar_loader["LOFAR model loader<br/>[model_utils.py]"]
  node_lofar_unet["UNet and EDM model<br/>[unet.py]"]
  node_lofar_layers["Network layers<br/>[layers.py]"]
  node_lofar_config["Model configuration<br/>[config.py]"]
  node_lofar_paths["Model and data paths<br/>[paths.py]"]
  node_lofar_diffusion["Diffusion sampler<br/>[diffusion.py]"]
  node_lofar_device["Device utilities<br/>[device_utils.py]"]
end

node_user(("Library user"))

node_user -->|"loads and samples"| node_public_sampler
node_public_sampler -->|"dispatches to"| node_sample_vae
node_public_sampler -->|"dispatches to"| node_formation_model
node_public_sampler -->|"dispatches to"| node_gamma_model
node_public_sampler -->|"dispatches to"| node_mass_model
node_public_sampler -->|"dispatches to"| node_metallicity_model
node_public_sampler -->|"dispatches to"| node_metallicity_diffusion
node_public_sampler -->|"loads via"| node_lofar_loader
node_public_sampler -->|"uses for sampling"| node_lofar_sampler
node_lofar_sampler -->|"samples with"| node_lofar_diffusion
node_lofar_sampler -->|"loads model via"| node_lofar_loader
node_lofar_sampler -->|"writes samples"| node_sample_files
node_lofar_loader -->|"loads configuration"| node_lofar_config
node_lofar_loader -->|"constructs model"| node_lofar_unet
node_lofar_loader -->|"uses model paths"| node_lofar_paths
node_lofar_config -->|"references paths"| node_lofar_paths
node_lofar_unet -->|"constructs from"| node_lofar_config
node_lofar_unet -->|"uses layers"| node_lofar_layers

click node_public_sampler "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/sampler.py"
click node_sample_vae "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/samplemodel.py"
click node_formation_model "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/foramtiontimeModel.py"
click node_gamma_model "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/gammaflowModel.py"
click node_mass_model "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/massesModel.py"
click node_metallicity_model "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/metallicityModel.py"
click node_metallicity_diffusion "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/metallicitydModel.py"
click node_lofar_sampler "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/sampler.py"
click node_lofar_loader "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/model_utils.py"
click node_lofar_unet "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/unet.py"
click node_lofar_layers "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/layers.py"
click node_lofar_config "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/config.py"
click node_lofar_paths "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/paths.py"
click node_lofar_diffusion "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/diffusion.py"
click node_lofar_device "https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/device_utils.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_sampler,node_user toneBlue
class node_sample_vae,node_formation_model,node_gamma_model,node_mass_model,node_metallicity_model,node_metallicity_diffusion toneAmber
class node_lofar_sampler,node_sample_files toneMint
class node_lofar_loader,node_lofar_unet,node_lofar_layers,node_lofar_config,node_lofar_paths,node_lofar_diffusion,node_lofar_device toneRose
```

## Components

### Public sampling API

- [Model loading and sampling](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/sampler.py): `galaxy_gen/sampler.py`

### VAE and flow models

- [VAEFlow architecture](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/samplemodel.py): `galaxy_gen/genmodels/samplemodel.py`
- [Formation-time model](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/foramtiontimeModel.py): `galaxy_gen/genmodels/foramtiontimeModel.py`
- [Gamma-flow model](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/gammaflowModel.py): `galaxy_gen/genmodels/gammaflowModel.py`
- [Mass model](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/massesModel.py): `galaxy_gen/genmodels/massesModel.py`
- [Metallicity model](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/metallicityModel.py): `galaxy_gen/genmodels/metallicityModel.py`
- [Metallicity diffusion model](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/metallicitydModel.py): `galaxy_gen/genmodels/metallicitydModel.py`

### LOFAR diffusion

- [LOFAR sample generation](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/sampler.py): `galaxy_gen/genmodels/lofarModel/sampler.py`
- **Sample HDF5 files**

### LOFAR model internals

- [LOFAR model loader](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/model_utils.py): `galaxy_gen/genmodels/lofarModel/model_utils.py`
- [UNet and EDM model](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/unet.py): `galaxy_gen/genmodels/lofarModel/unet.py`
- [Network layers](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/layers.py): `galaxy_gen/genmodels/lofarModel/layers.py`
- [Model configuration](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/config.py): `galaxy_gen/genmodels/lofarModel/config.py`
- [Model and data paths](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/paths.py): `galaxy_gen/genmodels/lofarModel/paths.py`
- [Diffusion sampler](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/diffusion.py): `galaxy_gen/genmodels/lofarModel/diffusion.py`
- [Device utilities](https://github.com/iabhiroop/galaxy_gen/blob/main/galaxy_gen/genmodels/lofarModel/device_utils.py): `galaxy_gen/genmodels/lofarModel/device_utils.py`

### Other components

- **Library user**

## Connections

- Library user → Model loading and sampling: loads and samples (evidence: `README.md`)
- Model loading and sampling → VAEFlow architecture: dispatches to (evidence: `galaxy_gen/sampler.py`)
- Model loading and sampling → Formation-time model: dispatches to (evidence: `galaxy_gen/sampler.py`)
- Model loading and sampling → Gamma-flow model: dispatches to (evidence: `galaxy_gen/sampler.py`)
- Model loading and sampling → Mass model: dispatches to (evidence: `galaxy_gen/sampler.py`)
- Model loading and sampling → Metallicity model: dispatches to (evidence: `galaxy_gen/sampler.py`)
- Model loading and sampling → Metallicity diffusion model: dispatches to (evidence: `galaxy_gen/sampler.py`)
- Model loading and sampling → LOFAR model loader: loads via (evidence: `galaxy_gen/sampler.py`)
- Model loading and sampling → LOFAR sample generation: uses for sampling (evidence: `galaxy_gen/sampler.py`)
- LOFAR sample generation → Diffusion sampler: samples with (evidence: `galaxy_gen/genmodels/lofarModel/sampler.py`)
- LOFAR sample generation → LOFAR model loader: loads model via (evidence: `galaxy_gen/genmodels/lofarModel/sampler.py`)
- LOFAR sample generation → Sample HDF5 files: writes samples (evidence: `galaxy_gen/genmodels/lofarModel/sampler.py`)
- LOFAR model loader → Model configuration: loads configuration (evidence: `galaxy_gen/genmodels/lofarModel/model_utils.py`)
- LOFAR model loader → UNet and EDM model: constructs model (evidence: `galaxy_gen/genmodels/lofarModel/model_utils.py`)
- LOFAR model loader → Model and data paths: uses model paths (evidence: `galaxy_gen/genmodels/lofarModel/model_utils.py`)
- Model configuration → Model and data paths: references paths (evidence: `galaxy_gen/genmodels/lofarModel/config.py`)
- UNet and EDM model → Model configuration: constructs from (evidence: `galaxy_gen/genmodels/lofarModel/unet.py`)
- UNet and EDM model → Network layers: uses layers (evidence: `galaxy_gen/genmodels/lofarModel/unet.py`)
