# Project Structure
Structure map for the Tritons crate.
```text
Tritons/
├── README.md # Project overview and usage
├── LICENSE # MIT license
├── ChangeLog.md # Version history
├── ComingSoon.md # Planned features
├── Contributing # Contribution guidelines
├── lastest_versions.sh # Restore wildcard dependency versions
│
├── src/
│ ├── main.rs # Entry point — Triton diagnostics: orbit, nitrogen geysers, captured KBO
│ ├── lib.rs # Library root, TRITONMASS (2.14e22 kg), radius 1 353 km, constants
│ │
│ ├── environment/ # Surface environment
│ │ ├── mod.rs # Exports dust, radiation, thermal
│ │ ├── dust.rs # Geyser-deposited dark material, nitrogen ice grain transport
│ │ ├── radiation.rs # Neptune magnetosphere exposure, moderate charged-particle flux
│ │ └── thermal.rs # Surface ~38 K, one of coldest bodies in Solar System, N₂ ice sublimation
│ │
│ ├── exosphere/ # Tenuous atmosphere
│ │ ├── mod.rs # Exports charging, escape, species
│ │ ├── charging.rs # Neptune magnetosphere interaction, auroral-like processes
│ │ ├── escape.rs # N₂ thermal escape, solar-wind sputtering, atmosphere replenished by geysers
│ │ └── species.rs # N₂ (primary, ~1.4 Pa), trace CH₄, CO — thin but detectable atmosphere
│ │
│ ├── geodata/ # Geographic reference data
│ │ ├── mod.rs # Exports coordinates, elevation, landing_sites, regions
│ │ ├── coordinates.rs # Planetocentric lat/lon, IAU Triton-fixed frame
│ │ ├── elevation.rs # Voyager 2 stereo-derived topography, ~40% surface imaged
│ │ ├── landing_sites.rs # Candidate sites on smooth volcanic plains, geyser-free zones
│ │ └── regions.rs # Cantaloupe terrain, Monad Regio, smooth volcanic plains, south polar cap
│ │
│ ├── geology/ # Surface and interior geology
│ │ ├── mod.rs # Exports craters, erosion, mountains, regolith, volcanism
│ │ ├── craters.rs # Very few impact craters — young resurfaced terrain, cryovolcanic burial
│ │ ├── erosion.rs # N₂ ice sublimation, geyser-driven redistribution, wind streaks
│ │ ├── mountains.rs # Ruach Planitia ridges, cantaloupe terrain cell margins
│ │ ├── regolith.rs # N₂ + CH₄ + CO₂ ice deposits, dark geyser plume fallout material
│ │ └── volcanism.rs # Active cryovolcanism — nitrogen geysers (8 km plumes), smooth resurfacing
│ │
│ ├── interactions/ # Gravitational interactions
│ │ ├── mod.rs # Exports earth_tides, neptunes, orbital_dynamics
│ │ ├── earth_tides.rs # Earth–Triton perturbation (negligible at 30 AU)
│ │ ├── neptunes.rs # Neptune gravitational influence, retrograde orbit (captured KBO origin)
│ │ └── orbital_dynamics.rs # Retrograde + highly inclined (157°), tidal circularization from capture
│ │
│ ├── lighting/ # Illumination model
│ │ ├── mod.rs # Exports eclipses, neptuneshine, solar_position
│ │ ├── eclipses.rs # Neptune shadow transits, rare due to orbital inclination
│ │ ├── neptuneshine.rs # Reflected Neptunian light on night side, faint at 30 AU
│ │ └── solar_position.rs # Solar zenith angle, 5.88 d retrograde orbital period, extreme seasons
│ │
│ ├── missions/ # Exploration missions
│ │ ├── mod.rs # Exports landers, orbiters, relay
│ │ ├── landers.rs # Future concepts — geyser proximity science, nitrogen ice sampling
│ │ ├── orbiters.rs # Voyager 2 flyby (1989, only close-up data), Trident/Neptune orbiter concepts
│ │ └── relay.rs # Communication relay via Neptune orbit, extreme 30 AU distance
│ │
│ ├── observation/ # Remote observation
│ │ ├── mod.rs # Exports communications, neptune_view, navigation
│ │ ├── communications.rs # Deep-space link budget, 30 AU light-time delay (~250 min)
│ │ ├── neptune_view.rs # Neptune apparent size from Triton (~8°), blue disk, Great Dark Spot era
│ │ └── navigation.rs # Orbital navigation, retrograde orbit complexity
│ │
│ ├── physics/ # Orbital and impact mechanics
│ │ ├── mod.rs # Exports collisions, orbit, rotation, tides
│ │ ├── collisions.rs # Low impact flux at 30 AU, KBO-origin capture collision history
│ │ ├── orbit.rs # a = 354 800 km, e ≈ 0.000 02, period 5.88 d retrograde, vis-viva
│ │ ├── rotation.rs # Synchronous rotation (retrograde), tidally locked to Neptune
│ │ └── tides.rs # Post-capture tidal circularization, residual tidal heating
│ │
│ ├── rendering/ # Visual rendering pipeline
│ │ ├── mod.rs # Exports dust, exosphere, materials, shaders
│ │ ├── dust.rs # Nitrogen ice grain rendering, bright surface albedo (0.76)
│ │ ├── exosphere.rs # Exosphere visualization endpoint
│ │ ├── lod.rs # Pixel-precise adaptive LOD
│ │ ├── materials.rs # PBR N₂ ice (bright), cantaloupe terrain (pinkish), dark geyser streaks
│ │ ├── mesh.rs # Icosphere subdivision, vertex data
│ │ └── shaders.rs # GPU shader programs — cantaloupe dimples, geyser plume scattering
│ │
│ ├── resources/ # Extractable resources
│ │ ├── mod.rs # Exports minerals, regolith, water_ice
│ │ ├── minerals.rs # Possible rocky core silicates, carbon compounds in dark material
│ │ ├── regolith.rs # N₂/CH₄/CO₂ ice mantle, dark tholin-like organic deposits
│ │ └── water_ice.rs # Water ice detected spectroscopically, possible subsurface ocean
│ │
│ ├── surface/ # Surface mapping
│ │ ├── mod.rs # Exports heightmaps, mapping, zones
│ │ ├── heightmaps.rs # Voyager 2 stereo-derived elevation, partial hemisphere coverage
│ │ ├── mapping.rs # Terrain unit maps, geyser streak distribution, albedo features
│ │ └── zones.rs # Cantaloupe terrain, smooth volcanic plains, south polar N₂ cap
│ │
│ ├── temporal/ # Time systems
│ │ ├── mod.rs # Exports calendar, epoch, time_scale
│ │ ├── calendar.rs # Triton calendar — 5.88 d retrograde period, Neptune year (165 yr), extreme seasons
│ │ ├── epoch.rs # J2000 epoch, Voyager 2 encounter date (1989-08-25)
│ │ └── time_scale.rs # TDB/UT1/TAI conversions at 30 AU light-time delay
│ │
│ └── terrain/ # Terrain mesh generation
│ ├── mod.rs # Exports lod, mesh, texturing
│ ├── lod.rs # Level-of-detail streaming for cantaloupe terrain cellular pattern
│ ├── mesh.rs # Spherical mesh, radius 1 353 km, near-spherical shape
│ └── texturing.rs # Voyager 2 imagery drape, cantaloupe + smooth plain textures
│
├── tests/ # Integration tests
│ ├── environment_tests.rs # Tests 38 K surface, geyser deposits, nitrogen ice sublimation
│ ├── exosphere_tests.rs # Tests N₂ atmosphere (~1.4 Pa), CH₄ trace abundance
│ ├── geodata_tests.rs # Tests coordinate transforms, cantaloupe terrain boundaries
│ ├── geology_tests.rs # Tests geyser mechanics, cantaloupe formation, young surface age
│ ├── interactions_tests.rs # Tests retrograde capture dynamics, tidal circularization history
│ ├── lighting_tests.rs # Tests Neptune shadow timing, neptuneshine intensity at 30 AU
│ ├── missions_tests.rs # Tests Voyager 2 flyby parameters, Trident concept trajectory
│ ├── observation_tests.rs # Tests link budget at 30 AU, Neptune apparent diameter
│ ├── physics_tests.rs # Tests retrograde orbital period, tidal circularization, near-zero e
│ ├── rendering_tests.rs # Tests surface albedo (0.76), cantaloupe terrain color
│ ├── resources_tests.rs # Tests N₂ ice abundance, water ice spectral detection
│ ├── surface_tests.rs # Tests Voyager coverage limits, terrain unit classification
│ ├── temporal_tests.rs # Tests epoch conversions, extreme Neptune year length
│ └── terrain_tests.rs # Tests mesh accuracy, LOD transitions on cantaloupe cells
│
└── examples/ # Runnable examples
├── check_landing_site.rs # Evaluate smooth volcanic plains for geyser-safe landing
├── crater_sim.rs # Rare impact cratering on cryovolcanically resurfaced terrain
├── eclipse_sim.rs # Neptune shadow transit timing, inclined retrograde orbit geometry
├── exosphere_sim.rs # N₂ thin atmosphere, geyser plume column modeling
├── neptune_observation.rs # Neptune as seen from Triton — blue disk, cloud bands
├── orbital_sim.rs # 5.88-day retrograde orbit, post-capture tidal evolution
├── radiation_sim.rs # Neptune magnetosphere environment at Triton orbit
├── resource_survey.rs # Nitrogen ice and water ice distribution mapping
└── tidal_effects.rs # Post-capture tidal heating — cryovolcanism and geyser driving
```