# zatsaroi/dbsr3 architecture

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

- Interactive diagram: https://gitdiagram.com/zatsaroi/dbsr3
- Repository: https://github.com/zatsaroi/dbsr3

## Overview

DBSR is described as a relativistic B-spline atomic R-matrix suite, but this tree contains atomic-configuration input decks and examples, not the calculation engine. The principal workflow is therefore best understood as selecting a deck for an atomic system or transition and supplying it to DBSR; the runtime handoff and resulting files are not shown. The README documents scattering and radiative capabilities, while the sampled files show configuration data. Dashed links mark the inferred handoff, not inspected program calls.

Main entry points: [`DBSR_MCHF/Al`](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MCHF/Al) (Al and F decks), [`DBSR_MCHF/He`](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MCHF/He) (Helium decks), [`DBSR_MULT3/Mult_orth_version_JJ/test_E0`](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E0) (E0 transitions), [`DBSR_MULT3/Mult_orth_version_JJ/test_E1`](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E1) (E1 transitions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mchf["MCHF configurations"]
  node_al_inputs["Al and F decks"]
  node_he_inputs["Helium decks"]
end

subgraph group_mult["Transition inputs"]
  node_e0_inputs["E0 transitions"]
  node_e1_inputs["E1 transitions"]
  node_e2_inputs["E2 transitions"]
  node_m1_inputs["M1 transitions"]
  node_m2_inputs["M2 transitions"]
end

subgraph group_rb["Rubidium examples"]
  node_rb_bound["Rb bound states"]
  node_rb_excited["Rb excited states"]
  node_rb_ion["Rb ion states"]
  node_rb_configs["Rb target configs"]
  node_rb_ionization["Rb ionization"]
end

subgraph group_xe["Xenon examples"]
  node_xe_hf["Xe Hartree-Fock"]
  node_xe_initial["Xe initial data"]
end

node_user(("Researcher"))
node_dbsr{{"DBSR calculations"}}

node_user -.->|"selects deck"| node_al_inputs
node_user -.->|"selects deck"| node_he_inputs
node_user -.->|"selects deck"| node_e0_inputs
node_user -.->|"selects deck"| node_e1_inputs
node_user -.->|"selects deck"| node_e2_inputs
node_user -.->|"selects deck"| node_m1_inputs
node_user -.->|"selects deck"| node_m2_inputs
node_user -.->|"selects deck"| node_rb_bound
node_user -.->|"selects deck"| node_rb_excited
node_user -.->|"selects deck"| node_rb_ion
node_user -.->|"selects deck"| node_rb_configs
node_user -.->|"selects deck"| node_rb_ionization
node_user -.->|"selects deck"| node_xe_hf
node_user -.->|"selects deck"| node_xe_initial
node_al_inputs -.->|"feeds calculation"| node_dbsr
node_he_inputs -.->|"feeds calculation"| node_dbsr
node_e0_inputs -.->|"feeds calculation"| node_dbsr
node_e1_inputs -.->|"feeds calculation"| node_dbsr
node_e2_inputs -.->|"feeds calculation"| node_dbsr
node_m1_inputs -.->|"feeds calculation"| node_dbsr
node_m2_inputs -.->|"feeds calculation"| node_dbsr
node_rb_bound -.->|"feeds calculation"| node_dbsr
node_rb_excited -.->|"feeds calculation"| node_dbsr
node_rb_ion -.->|"feeds calculation"| node_dbsr
node_rb_configs -.->|"feeds calculation"| node_dbsr
node_rb_ionization -.->|"feeds calculation"| node_dbsr
node_xe_hf -.->|"feeds calculation"| node_dbsr
node_xe_initial -.->|"feeds calculation"| node_dbsr

click node_al_inputs "https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MCHF/Al"
click node_he_inputs "https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MCHF/He"
click node_e0_inputs "https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E0"
click node_e1_inputs "https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E1"
click node_e2_inputs "https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E2"
click node_m1_inputs "https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_M1"
click node_m2_inputs "https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_M2"
click node_rb_bound "https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p5_4d"
click node_rb_excited "https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p5_5p"
click node_rb_ion "https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p5_5s"
click node_rb_configs "https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/dbsr_cc27"
click node_rb_ionization "https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p6"
click node_xe_hf "https://github.com/zatsaroi/dbsr3/tree/master/Xe_bound_example/DBSR_HF"
click node_xe_initial "https://github.com/zatsaroi/dbsr3/tree/master/Xe_bound_example/intial_data"

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_al_inputs,node_he_inputs toneBlue
class node_e0_inputs,node_e1_inputs,node_e2_inputs,node_m1_inputs,node_m2_inputs toneAmber
class node_rb_bound,node_rb_excited,node_rb_ion,node_rb_configs,node_rb_ionization toneMint
class node_xe_hf,node_xe_initial toneRose
class node_user,node_dbsr toneIndigo
```

## Components

### MCHF configurations

- [Al and F decks](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MCHF/Al): `DBSR_MCHF/Al`
- [Helium decks](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MCHF/He): `DBSR_MCHF/He`

### Transition inputs

- [E0 transitions](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E0): `DBSR_MULT3/Mult_orth_version_JJ/test_E0`
- [E1 transitions](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E1): `DBSR_MULT3/Mult_orth_version_JJ/test_E1`
- [E2 transitions](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_E2): `DBSR_MULT3/Mult_orth_version_JJ/test_E2`
- [M1 transitions](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_M1): `DBSR_MULT3/Mult_orth_version_JJ/test_M1`
- [M2 transitions](https://github.com/zatsaroi/dbsr3/tree/master/DBSR_MULT3/Mult_orth_version_JJ/test_M2): `DBSR_MULT3/Mult_orth_version_JJ/test_M2`

### Rubidium examples

- [Rb bound states](https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p5_4d): `Rb_bound_example/4p5_4d`
- [Rb excited states](https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p5_5p): `Rb_bound_example/4p5_5p`
- [Rb ion states](https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p5_5s): `Rb_bound_example/4p5_5s`
- [Rb target configs](https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/dbsr_cc27): `Rb_bound_example/dbsr_cc27`
- [Rb ionization](https://github.com/zatsaroi/dbsr3/tree/master/Rb_bound_example/4p6): `Rb_bound_example/4p6`

### Xenon examples

- [Xe Hartree-Fock](https://github.com/zatsaroi/dbsr3/tree/master/Xe_bound_example/DBSR_HF): `Xe_bound_example/DBSR_HF`
- [Xe initial data](https://github.com/zatsaroi/dbsr3/tree/master/Xe_bound_example/intial_data): `Xe_bound_example/intial_data`

### Other components

- **Researcher**
- **DBSR calculations**

## Connections

- Researcher → Al and F decks: selects deck
- Researcher → Helium decks: selects deck
- Researcher → E0 transitions: selects deck
- Researcher → E1 transitions: selects deck
- Researcher → E2 transitions: selects deck
- Researcher → M1 transitions: selects deck
- Researcher → M2 transitions: selects deck
- Researcher → Rb bound states: selects deck
- Researcher → Rb excited states: selects deck
- Researcher → Rb ion states: selects deck
- Researcher → Rb target configs: selects deck
- Researcher → Rb ionization: selects deck
- Researcher → Xe Hartree-Fock: selects deck
- Researcher → Xe initial data: selects deck
- Al and F decks → DBSR calculations: feeds calculation
- Helium decks → DBSR calculations: feeds calculation
- E0 transitions → DBSR calculations: feeds calculation
- E1 transitions → DBSR calculations: feeds calculation
- E2 transitions → DBSR calculations: feeds calculation
- M1 transitions → DBSR calculations: feeds calculation
- M2 transitions → DBSR calculations: feeds calculation
- Rb bound states → DBSR calculations: feeds calculation
- Rb excited states → DBSR calculations: feeds calculation
- Rb ion states → DBSR calculations: feeds calculation
- Rb target configs → DBSR calculations: feeds calculation
- Rb ionization → DBSR calculations: feeds calculation
- Xe Hartree-Fock → DBSR calculations: feeds calculation
- Xe initial data → DBSR calculations: feeds calculation
