# eblur/xdust architecture

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

- Interactive diagram: https://gitdiagram.com/eblur/xdust
- Repository: https://github.com/eblur/xdust

## Overview

Xdust is a Python dust-physics package: users define grain size distributions and material properties, compute extinction and scattering, then model Galactic small-angle scattering halos. The graph preserves documented grain-population, scattering-model, and halo capabilities, including alternative size distributions and GGADT table preparation. Some implementation details are unsampled; edges are limited to README statements and relationships listed in the SOURCE INDEX.

Main entry points: [`src/xdust/graindist/graindist.py`](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/graindist.py) (Grain distribution), [`src/xdust/scatteringmodel/__init__.py`](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/__init__.py) (Scattering interface), [`src/xdust/grainpop.py`](https://github.com/eblur/xdust/blob/main/src/xdust/grainpop.py) (Grain population), [`src/xdust/halos/galhalo.py`](https://github.com/eblur/xdust/blob/main/src/xdust/halos/galhalo.py) (Galactic halo models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_grain["Grain models"]
  node_dist["Grain distribution<br/>[graindist.py]"]
  node_size_grain["Single-size model<br/>[grain.py]"]
  node_size_power["Power law<br/>[powerlaw.py]"]
  node_size_cutoff["Cutoff power law<br/>[exp_cutoff.py]"]
  node_size_astro["Astrodust sizes<br/>[astrodust.py]"]
  node_size_wd["WD01 sizes<br/>[weingartner.py]"]
  node_composition["Material constants"]
  node_minerals["Mineral materials<br/>[minerals.py]"]
  node_sphere["Spherical grains<br/>[sphere.py]"]
  node_population["Grain population<br/>[grainpop.py]"]
end

subgraph group_scatter["Scattering physics"]
  node_scat_base["Scattering interface<br/>[__init__.py]"]
  node_mie["Mie scattering<br/>[miescat.py]"]
  node_rayleigh["Rayleigh-Gans<br/>[rgscat.py]"]
  node_pah["PAH scattering<br/>[pah.py]"]
  node_ggadt["GGADT scattering<br/>[ggadt.py]"]
  node_ggadt_convert["GGADT table maker<br/>[make_ggadt.py]"]
  node_astro_convert["Astrodust table maker"]
end

subgraph group_halo["Halo modeling"]
  node_halo_base["Halo calculations<br/>[halo.py]"]
  node_galhalo["Galactic halo models<br/>[galhalo.py]"]
end

subgraph group_support["Shared support"]
  node_helpers["Unit helpers<br/>[helpers.py]"]
end

node_user(("Package user"))

node_user -->|"configures"| node_population
node_user -->|"models halos"| node_galhalo
node_dist -->|"selects size model"| node_size_grain
node_dist -->|"selects size model"| node_size_power
node_dist -->|"selects size model"| node_size_cutoff
node_dist -->|"selects size model"| node_size_astro
node_dist -->|"selects size model"| node_size_wd
node_dist -->|"selects material"| node_composition
node_dist -->|"selects shape"| node_sphere
node_population -->|"builds population"| node_dist
node_population -->|"uses scattering model"| node_scat_base
node_mie -->|"implements interface"| node_scat_base
node_rayleigh -->|"implements interface"| node_scat_base
node_pah -->|"implements interface"| node_scat_base
node_ggadt -->|"implements interface"| node_scat_base
node_pah -->|"reads constants"| node_composition
node_astro_convert -->|"uses table maker"| node_ggadt_convert
node_galhalo -->|"extends calculations"| node_halo_base
node_galhalo -->|"calculates from population"| node_population
node_halo_base -->|"uses conversions"| node_helpers
node_dist -->|"size models use shape"| node_sphere

click node_dist "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/graindist.py"
click node_size_grain "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/grain.py"
click node_size_power "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/powerlaw.py"
click node_size_cutoff "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/exp_cutoff.py"
click node_size_astro "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/astrodust.py"
click node_size_wd "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/weingartner.py"
click node_composition "https://github.com/eblur/xdust/tree/main/src/xdust/graindist/composition"
click node_minerals "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/composition/minerals.py"
click node_sphere "https://github.com/eblur/xdust/blob/main/src/xdust/graindist/shape/sphere.py"
click node_population "https://github.com/eblur/xdust/blob/main/src/xdust/grainpop.py"
click node_scat_base "https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/__init__.py"
click node_mie "https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/miescat.py"
click node_rayleigh "https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/rgscat.py"
click node_pah "https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/pah.py"
click node_ggadt "https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/ggadt.py"
click node_ggadt_convert "https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/make_ggadt.py"
click node_astro_convert "https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/make_ggadt_astrodust.py"
click node_halo_base "https://github.com/eblur/xdust/blob/main/src/xdust/halos/halo.py"
click node_galhalo "https://github.com/eblur/xdust/blob/main/src/xdust/halos/galhalo.py"
click node_helpers "https://github.com/eblur/xdust/blob/main/src/xdust/helpers.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_dist,node_size_grain,node_size_power,node_size_cutoff,node_size_astro,node_size_wd,node_composition,node_minerals,node_sphere,node_population,node_user toneBlue
class node_scat_base,node_mie,node_rayleigh,node_pah,node_ggadt,node_ggadt_convert,node_astro_convert toneAmber
class node_halo_base,node_galhalo toneMint
class node_helpers toneRose
```

## Components

### Grain models

- [Grain distribution](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/graindist.py): `src/xdust/graindist/graindist.py`
- [Single-size model](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/grain.py): `src/xdust/graindist/sizedist/grain.py`
- [Power law](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/powerlaw.py): `src/xdust/graindist/sizedist/powerlaw.py`
- [Cutoff power law](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/exp_cutoff.py): `src/xdust/graindist/sizedist/exp_cutoff.py`
- [Astrodust sizes](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/astrodust.py): `src/xdust/graindist/sizedist/astrodust.py`
- [WD01 sizes](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/sizedist/weingartner.py): `src/xdust/graindist/sizedist/weingartner.py`
- [Material constants](https://github.com/eblur/xdust/tree/main/src/xdust/graindist/composition): `src/xdust/graindist/composition`
- [Mineral materials](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/composition/minerals.py): `src/xdust/graindist/composition/minerals.py`
- [Spherical grains](https://github.com/eblur/xdust/blob/main/src/xdust/graindist/shape/sphere.py): `src/xdust/graindist/shape/sphere.py`
- [Grain population](https://github.com/eblur/xdust/blob/main/src/xdust/grainpop.py): `src/xdust/grainpop.py`

### Scattering physics

- [Scattering interface](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/__init__.py): `src/xdust/scatteringmodel/__init__.py`
- [Mie scattering](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/miescat.py): `src/xdust/scatteringmodel/miescat.py`
- [Rayleigh-Gans](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/rgscat.py): `src/xdust/scatteringmodel/rgscat.py`
- [PAH scattering](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/pah.py): `src/xdust/scatteringmodel/pah.py`
- [GGADT scattering](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/ggadt.py): `src/xdust/scatteringmodel/ggadt.py`
- [GGADT table maker](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/make_ggadt.py): `src/xdust/scatteringmodel/make_ggadt.py`
- [Astrodust table maker](https://github.com/eblur/xdust/blob/main/src/xdust/scatteringmodel/make_ggadt_astrodust.py): `src/xdust/scatteringmodel/make_ggadt_astrodust.py`

### Halo modeling

- [Halo calculations](https://github.com/eblur/xdust/blob/main/src/xdust/halos/halo.py): `src/xdust/halos/halo.py`
- [Galactic halo models](https://github.com/eblur/xdust/blob/main/src/xdust/halos/galhalo.py): `src/xdust/halos/galhalo.py`

### Shared support

- [Unit helpers](https://github.com/eblur/xdust/blob/main/src/xdust/helpers.py): `src/xdust/helpers.py`

### Other components

- **Package user**

## Connections

- Package user → Grain population: configures (evidence: `README.md`)
- Package user → Galactic halo models: models halos (evidence: `README.md`)
- Grain distribution → Single-size model: selects size model (evidence: `src/xdust/graindist/graindist.py`)
- Grain distribution → Power law: selects size model (evidence: `src/xdust/graindist/graindist.py`)
- Grain distribution → Cutoff power law: selects size model (evidence: `src/xdust/graindist/graindist.py`)
- Grain distribution → Astrodust sizes: selects size model (evidence: `src/xdust/graindist/graindist.py`)
- Grain distribution → WD01 sizes: selects size model (evidence: `src/xdust/graindist/graindist.py`)
- Grain distribution → Material constants: selects material (evidence: `src/xdust/graindist/graindist.py`)
- Grain distribution → Spherical grains: selects shape (evidence: `src/xdust/graindist/graindist.py`)
- Grain population → Grain distribution: builds population (evidence: `src/xdust/grainpop.py`)
- Grain population → Scattering interface: uses scattering model (evidence: `src/xdust/grainpop.py`)
- Mie scattering → Scattering interface: implements interface (evidence: `src/xdust/scatteringmodel/miescat.py`)
- Rayleigh-Gans → Scattering interface: implements interface (evidence: `src/xdust/scatteringmodel/__init__.py`)
- PAH scattering → Scattering interface: implements interface (evidence: `src/xdust/scatteringmodel/__init__.py`)
- GGADT scattering → Scattering interface: implements interface (evidence: `src/xdust/scatteringmodel/__init__.py`)
- PAH scattering → Material constants: reads constants (evidence: `src/xdust/scatteringmodel/pah.py`)
- Astrodust table maker → GGADT table maker: uses table maker (evidence: `src/xdust/scatteringmodel/make_ggadt_astrodust.py`)
- Galactic halo models → Halo calculations: extends calculations (evidence: `src/xdust/halos/galhalo.py`)
- Galactic halo models → Grain population: calculates from population (evidence: `src/xdust/halos/galhalo.py`)
- Halo calculations → Unit helpers: uses conversions (evidence: `src/xdust/halos/halo.py`)
- Grain distribution → Spherical grains: size models use shape
