# 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)
│ │ ├── lod.rs # Pixel-precise adaptive LOD
│ │ ├── materials.rs # PBR D-type carbonaceous material, phyllosilicate signature
│ │ ├── mesh.rs # Icosphere subdivision, vertex data
│ │ └── 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
```