# Project Structure

Structure map for the Deimoss crate.

```text
Deimoss/
├── 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 — Deimos diagnostics: orbit, surface, captured-asteroid origin
│   ├── lib.rs                          # Library root, DEIMOSMASS (1.48e15 kg), mean radius 6.2 km, constants
│   │
│   ├── environment/                    # Surface environment
│   │   ├── mod.rs                      # Exports dust, radiation, thermal
│   │   ├── dust.rs                     # Thick regolith blanket, impact gardening on low-gravity body
│   │   ├── radiation.rs                # Unshielded solar + GCR exposure at 1.52 AU, no magnetic field
│   │   └── thermal.rs                  # Surface temperature ~233 K (day) / 150 K (night), low thermal inertia
│   │
│   ├── exosphere/                      # Tenuous atmosphere
│   │   ├── mod.rs                      # Exports charging, escape, species
│   │   ├── charging.rs                 # Solar-wind electrostatic charging on regolith grains
│   │   ├── escape.rs                   # Negligible gravity (0.003 m/s²) — near-zero escape velocity (~5.6 m/s)
│   │   └── species.rs                  # No measurable exosphere, possible transient sputtered species
│   │
│   ├── geodata/                        # Geographic reference data
│   │   ├── mod.rs                      # Exports coordinates, elevation, landing_sites, regions
│   │   ├── coordinates.rs              # Body-fixed frame, IAU Deimos-fixed reference, triaxial shape
│   │   ├── elevation.rs                # Shape model from Viking/MRO imagery, irregular topography
│   │   ├── landing_sites.rs            # Smooth regolith plains — low-risk touchdown on filled craters
│   │   └── regions.rs                  # Swift crater, Voltaire crater, smooth infilled terrains
│   │
│   ├── geology/                        # Surface and interior geology
│   │   ├── mod.rs                      # Exports craters, erosion, mountains, regolith, volcanism
│   │   ├── craters.rs                  # Swift (1 km), Voltaire (1.9 km), heavily infilled by regolith
│   │   ├── erosion.rs                  # Regolith infilling of craters, impact gardening, smooth appearance
│   │   ├── mountains.rs                # No significant relief — irregular shape with gentle undulations
│   │   ├── regolith.rs                 # Thick regolith mantle (~100 m), smooths topography, fine-grained
│   │   └── volcanism.rs               # No volcanism — undifferentiated rubble-pile interior, no heat source
│   │
│   ├── interactions/                   # Gravitational interactions
│   │   ├── mod.rs                      # Exports earth_tides, marss, orbital_dynamics
│   │   ├── earth_tides.rs              # Earth–Deimos perturbation (negligible at 1.52 AU)
│   │   ├── marss.rs                    # Mars gravitational influence, near-circular orbit at 23 460 km
│   │   └── orbital_dynamics.rs         # Slowly receding from Mars, near-equatorial orbit, e ≈ 0.0002
│   │
│   ├── lighting/                       # Illumination model
│   │   ├── mod.rs                      # Exports eclipses, marsshine, solar_position
│   │   ├── eclipses.rs                 # Mars shadow transits, infrequent due to high orbit
│   │   ├── marsshine.rs                # Reflected Martian light, reddish illumination on night side
│   │   └── solar_position.rs           # Solar zenith angle, 1.26 d synchronous rotation cycle
│   │
│   ├── missions/                       # Exploration missions
│   │   ├── mod.rs                      # Exports landers, orbiters, relay
│   │   ├── landers.rs                  # Future lander concepts — ISRU pathfinder, low-gravity operations
│   │   ├── orbiters.rs                 # Viking flybys, MRO imaging, Mars Express distant observations
│   │   └── relay.rs                    # Mars relay network, high-orbit position advantageous for coverage
│   │
│   ├── observation/                    # Remote observation
│   │   ├── mod.rs                      # Exports communications, mars_view, navigation
│   │   ├── communications.rs           # Mars-relay link, 1.52 AU Earth light-time delay (3–22 min)
│   │   ├── mars_view.rs               # Mars apparent size from Deimos (~2.5°), full-disk view
│   │   └── navigation.rs              # Irregular gravity field navigation, shape-model-based ephemeris
│   │
│   ├── physics/                        # Orbital and impact mechanics
│   │   ├── mod.rs                      # Exports collisions, orbit, rotation, tides
│   │   ├── collisions.rs               # Impact flux at 1.52 AU, Mars-crossing impactors
│   │   ├── orbit.rs                    # a = 23 460 km, e = 0.0002, period 1.26 d, vis-viva
│   │   ├── rotation.rs                 # Synchronous rotation, period = orbital period, D-type asteroid shape
│   │   └── tides.rs                    # Minimal tidal stress — distant from Mars, slow orbital evolution
│   │
│   ├── rendering/                      # Visual rendering pipeline
│   │   ├── mod.rs                      # Exports dust, materials, shaders
│   │   ├── dust.rs                     # Regolith dust rendering, very dark surface albedo (0.07)
│   │   ├── materials.rs                # PBR D-type carbonaceous material, phyllosilicate signature
│   │   └── shaders.rs                  # GPU shader programs — irregular triaxial shape, smooth regolith
│   │
│   ├── resources/                      # Extractable resources
│   │   ├── mod.rs                      # Exports minerals, regolith, water_ice
│   │   ├── minerals.rs                 # Carbonaceous chondrite minerals, phyllosilicates, possible organics
│   │   ├── regolith.rs                 # Thick fine-grained regolith — ISRU feedstock, shielding material
│   │   └── water_ice.rs               # Possible bound water in phyllosilicates, D-type spectral hydration
│   │
│   ├── surface/                        # Surface mapping
│   │   ├── mod.rs                      # Exports heightmaps, mapping, zones
│   │   ├── heightmaps.rs               # Viking/MRO shape model, irregular triaxial 15 × 12 × 11 km
│   │   ├── mapping.rs                  # Albedo maps, crater maps, regolith thickness estimates
│   │   └── zones.rs                    # Smooth terrains, cratered regions, Swift/Voltaire units
│   │
│   ├── temporal/                       # Time systems
│   │   ├── mod.rs                      # Exports calendar, epoch, time_scale
│   │   ├── calendar.rs                 # Deimos calendar — 1.26 d orbital period, Mars year reference
│   │   ├── epoch.rs                    # J2000 epoch, Viking encounter reference dates
│   │   └── time_scale.rs              # TDB/UT1/TAI conversions at 1.52 AU light-time delay
│   │
│   └── terrain/                        # Terrain mesh generation
│       ├── mod.rs                      # Exports lod, mesh, texturing
│       ├── lod.rs                      # Level-of-detail streaming for smooth irregular shape
│       ├── mesh.rs                     # Triaxial mesh, 15 × 12 × 11 km, low-poly irregular body
│       └── texturing.rs               # Viking/MRO imagery drape, dark carbonaceous textures
│
├── tests/                              # Integration tests
│   ├── environment_tests.rs            # Tests radiation dose, thermal cycling, regolith gardening
│   ├── exosphere_tests.rs              # Tests near-zero exosphere, escape velocity validation
│   ├── geodata_tests.rs                # Tests coordinate transforms, Swift/Voltaire locations
│   ├── geology_tests.rs                # Tests crater infilling, regolith thickness, D-type composition
│   ├── interactions_tests.rs           # Tests Mars perturbation, slow orbital recession
│   ├── lighting_tests.rs              # Tests Mars shadow transits, marsshine intensity
│   ├── missions_tests.rs              # Tests Viking flyby parameters, MRO imaging geometry
│   ├── observation_tests.rs            # Tests Mars apparent diameter, relay link budget
│   ├── physics_tests.rs                # Tests orbital period, synchronous rotation, escape velocity
│   ├── rendering_tests.rs              # Tests surface albedo (0.07), irregular shape rendering
│   ├── resources_tests.rs              # Tests phyllosilicate fraction, bound water estimates
│   ├── surface_tests.rs                # Tests shape model accuracy, smooth terrain mapping
│   ├── temporal_tests.rs               # Tests epoch conversions, orbital period sync
│   └── terrain_tests.rs               # Tests irregular mesh accuracy, LOD transitions
│
└── examples/                           # Runnable examples
    ├── check_landing_site.rs           # Evaluate smooth regolith plains for low-gravity touchdown
    ├── crater_sim.rs                   # Swift/Voltaire crater formation on sub-escape-velocity body
    ├── eclipse_sim.rs                  # Mars shadow transit timing from high orbit
    ├── exosphere_sim.rs                # Near-zero exosphere validation, sputtering estimates
    ├── mars_observation.rs             # Mars as seen from Deimos — full disk reddish view
    ├── orbital_sim.rs                  # 1.26-day orbit propagation, tidal recession from Mars
    ├── radiation_sim.rs                # Solar + GCR environment at 1.52 AU, no shielding
    ├── resource_survey.rs              # Carbonaceous mineral and bound water mapping
    └── tidal_effects.rs               # Minimal tidal stress analysis — slow orbital evolution
```
