Skip to main content

Crate tanmatra

Crate tanmatra 

Source
Expand description

§tanmatra — Atomic and Subatomic Physics

tanmatra (Sanskrit: तन्मात्र — subtle element) provides atomic and subatomic physics computations: Standard Model particles, nuclear structure, radioactive decay, spectral lines, and nuclear reactions.

§Architecture

Fundamental ─── particle.rs ─── Standard Model (quarks, leptons, bosons, forces)
     |
     v
Nuclear ──────── nucleus.rs ─── Bethe-Weizsacker binding energy, nuclear radii
     |            decay.rs ──── Radioactive decay, half-lives, decay chains
     |            reaction.rs ─ Nuclear reactions, Q-values, Coulomb barriers
     v
Atomic ────────── atomic.rs ─── Electron configurations, spectral lines, ionization

§Quick Start

use tanmatra::prelude::*;

// Iron-56 binding energy per nucleon
let fe56 = Nucleus::iron_56();
let bea = fe56.binding_energy_per_nucleon();
assert!(bea > 8.4 && bea < 9.2); // ~8.8 MeV

// H-alpha spectral line
let h_alpha = spectral_line_nm(1, 2, 3).unwrap();
assert!((h_alpha - 656.3).abs() < 1.0);

// Electron configuration of iron
let config = electron_configuration(26).unwrap();
let short = format_configuration_short(&config, 26);
assert_eq!(short, "[Ar] 4s2 3d6");

§Feature Flags

FeatureDefaultDescription
stdYesStandard library support. Disable for no_std + alloc
loggingNoStructured tracing via the tracing crate
fullNoEnables all optional features

§Data Sources

  • CODATA 2022: Fundamental physical constants (NIST)
  • PDG 2024: Particle masses (Particle Data Group)
  • NNDC/NUBASE: Nuclear half-lives (National Nuclear Data Center)
  • NIST ASD: Ionization energies (Atomic Spectra Database)

Modules§

atomic
Atomic structure: quantum numbers, electron configurations, and spectral lines.
bridge
Cross-crate bridges — primitive-value conversions from other AGNOS science crates. Cross-crate bridges — convert primitive values from other AGNOS science crates into tanmatra atomic/nuclear physics parameters and vice versa.
constants
Physical constants from CODATA 2022.
decay
Radioactive decay calculations.
error
Error types for tanmatra.
integration
Integration APIs for downstream consumers (soorat rendering). Integration APIs for downstream consumers.
nucleus
Nuclear structure and binding energy calculations.
particle
Standard Model particles and fundamental forces.
prelude
Prelude module — import everything commonly needed.
reaction
Nuclear reactions and Q-value calculations.
relativity
Relativistic kinematics.
scattering
Scattering theory: Rutherford, Mott, Born, Compton, and pair production cross-sections.
timekeeping
Frequency standards, atomic time scales, and relativistic clock corrections. Frequency standards, atomic time scales, and relativistic clock corrections.