titanias 0.0.3

Titania celestial simulation crate for the MilkyWay SolarSystem workspace
Documentation
# Project Structure

Structure map for the Titanias crate.

```text
Titanias/
├── 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 — Titania diagnostics: orbit, tectonics, Messina Chasmata
│   ├── lib.rs                          # Library root, TITANIAMASS (3.53e21 kg), radius 788 km, constants
│   │
│   ├── environment/                    # Surface environment
│   │   ├── mod.rs                      # Exports dust, radiation, thermal
│   │   ├── dust.rs                     # Impact-generated regolith, irradiation-darkened ice grains
│   │   ├── radiation.rs                # Uranian magnetosphere exposure, moderate charged-particle sputtering
│   │   └── thermal.rs                  # Surface ~70–80 K, minimal diurnal variation, extreme cold
│   │
│   ├── exosphere/                      # Tenuous atmosphere
│   │   ├── mod.rs                      # Exports charging, escape, species
│   │   ├── charging.rs                 # Uranian magnetosphere plasma interaction, surface sputtering
│   │   ├── escape.rs                   # Moderate gravity (0.367 m/s²), possible seasonal CO₂ sublimation
│   │   └── species.rs                  # Possible thin CO₂ atmosphere (seasonal), radiolytic production
│   │
│   ├── geodata/                        # Geographic reference data
│   │   ├── mod.rs                      # Exports coordinates, elevation, landing_sites, regions
│   │   ├── coordinates.rs              # Planetocentric lat/lon, IAU Titania-fixed frame
│   │   ├── elevation.rs                # Voyager 2 limb profiles, limited southern hemisphere coverage
│   │   ├── landing_sites.rs            # Candidate sites on smooth inter-crater plains, tectonic graben floors
│   │   └── regions.rs                  # Messina Chasmata, Gertrude crater, Ursula crater, smooth plains
│   │
│   ├── geology/                        # Surface and interior geology
│   │   ├── mod.rs                      # Exports craters, erosion, mountains, regolith, volcanism
│   │   ├── craters.rs                  # Gertrude (326 km), Ursula (135 km), moderate crater density
│   │   ├── erosion.rs                  # Irradiation darkening, viscous relaxation of ancient features
│   │   ├── mountains.rs                # Graben-bounding normal fault scarps, Messina Chasmata walls
│   │   ├── regolith.rs                 # Dark irradiated ice-rock regolith, moderate thickness
│   │   └── volcanism.rs               # Ancient cryovolcanic resurfacing — smooth plains between craters
│   │
│   ├── interactions/                   # Gravitational interactions
│   │   ├── mod.rs                      # Exports earth_tides, uranuss, orbital_dynamics
│   │   ├── earth_tides.rs              # Earth–Titania perturbation (negligible at 19.2 AU)
│   │   ├── uranuss.rs                  # Uranus gravitational influence, largest Uranian moon at 436 300 km
│   │   └── orbital_dynamics.rs         # Near-circular prograde orbit, possible past resonance with Umbriel
│   │
│   ├── lighting/                       # Illumination model
│   │   ├── mod.rs                      # Exports eclipses, uranusshine, solar_position
│   │   ├── eclipses.rs                 # Uranus shadow transits, equinoctial mutual events (every 42 yr)
│   │   ├── uranusshine.rs              # Reflected Uranian light on night side, faint at 19.2 AU
│   │   └── solar_position.rs           # Solar zenith angle, 8.71 d orbital period, extreme axial tilt (98°)
│   │
│   ├── missions/                       # Exploration missions
│   │   ├── mod.rs                      # Exports landers, orbiters, relay
│   │   ├── landers.rs                  # Future Uranus system lander concepts, tectonic terrain access
│   │   ├── orbiters.rs                 # Voyager 2 flyby (1986, only close-up data), Uranus Orbiter priority
│   │   └── relay.rs                    # Communication relay via Uranus orbit, extreme distance link
│   │
│   ├── observation/                    # Remote observation
│   │   ├── mod.rs                      # Exports communications, uranus_view, navigation
│   │   ├── communications.rs           # Deep-space link budget, 19.2 AU light-time delay (~160 min)
│   │   ├── uranus_view.rs              # Uranus apparent size from Titania (~5°), ring system edge-on view
│   │   └── navigation.rs              # Orbital navigation, limited gravity field knowledge
│   │
│   ├── physics/                        # Orbital and impact mechanics
│   │   ├── mod.rs                      # Exports collisions, orbit, rotation, tides
│   │   ├── collisions.rs               # Impact flux at 19.2 AU, heliocentric + planetocentric impactors
│   │   ├── orbit.rs                    # a = 436 300 km, e = 0.0011, period 8.71 d, vis-viva
│   │   ├── rotation.rs                 # Synchronous rotation, period = orbital period
│   │   └── tides.rs                    # Low tidal heating, possible past resonance-driven activity
│   │
│   ├── rendering/                      # Visual rendering pipeline
│   │   ├── mod.rs                      # Exports dust, materials, shaders
│   │   ├── dust.rs                     # Dark irradiated regolith rendering, moderate albedo (0.27)
│   │   ├── lod.rs                      # Pixel-precise adaptive LOD
│   │   ├── materials.rs                # PBR ice-rock mixture, CO₂/H₂O ice spectral features
│   │   ├── mesh.rs                     # Icosphere subdivision, vertex data
│   │   └── shaders.rs                  # GPU shader programs — tectonic graben, cratered terrain
│   │
│   ├── resources/                      # Extractable resources
│   │   ├── mod.rs                      # Exports minerals, regolith, water_ice
│   │   ├── minerals.rs                 # Silicate rock component (~50%), carbonaceous material
│   │   ├── regolith.rs                 # Ice-rock regolith, irradiation-processed surface layer
│   │   └── water_ice.rs               # Water ice surface, possible subsurface ammonia-water ocean
│   │
│   ├── surface/                        # Surface mapping
│   │   ├── mod.rs                      # Exports heightmaps, mapping, zones
│   │   ├── heightmaps.rs               # Voyager 2 limb-derived topography, southern hemisphere bias
│   │   ├── mapping.rs                  # Crater maps, fault maps, Messina Chasmata extent
│   │   └── zones.rs                    # Cratered terrain, Messina graben system, smooth resurfaced plains
│   │
│   ├── temporal/                       # Time systems
│   │   ├── mod.rs                      # Exports calendar, epoch, time_scale
│   │   ├── calendar.rs                 # Titania calendar — 8.71 d orbital period, Uranus year (84 yr)
│   │   ├── epoch.rs                    # J2000 epoch, Voyager 2 encounter date (1986-01-24)
│   │   └── time_scale.rs              # TDB/UT1/TAI conversions at 19.2 AU light-time delay
│   │
│   └── terrain/                        # Terrain mesh generation
│       ├── mod.rs                      # Exports lod, mesh, texturing
│       ├── lod.rs                      # Level-of-detail streaming for tectonic faults and cratered terrain
│       ├── mesh.rs                     # Spherical mesh, radius 788 km (largest Uranian moon)
│       └── texturing.rs               # Voyager 2 imagery drape, partial coverage southern hemisphere
│
├── tests/                              # Integration tests
│   ├── environment_tests.rs            # Tests extreme cold (~75 K), radiation sputtering, regolith darkening
│   ├── exosphere_tests.rs              # Tests CO₂ seasonal atmosphere, sublimation rate estimates
│   ├── geodata_tests.rs                # Tests coordinate transforms, Messina Chasmata location
│   ├── geology_tests.rs                # Tests Gertrude basin, Messina graben mechanics, surface age
│   ├── interactions_tests.rs           # Tests Uranus perturbation, past resonance scenarios
│   ├── lighting_tests.rs              # Tests equinoctial eclipse timing, uranusshine intensity
│   ├── missions_tests.rs              # Tests Voyager 2 flyby parameters, Uranus Orbiter concepts
│   ├── observation_tests.rs            # Tests link budget at 19.2 AU, Uranus apparent diameter
│   ├── physics_tests.rs                # Tests orbital period, synchronous rotation, tidal stress
│   ├── rendering_tests.rs              # Tests surface albedo (0.27), ice-rock material properties
│   ├── resources_tests.rs              # Tests water ice fraction, subsurface ocean viability
│   ├── surface_tests.rs                # Tests Voyager coverage limits, fault system mapping
│   ├── temporal_tests.rs               # Tests epoch conversions, Uranus year period
│   └── terrain_tests.rs               # Tests mesh accuracy, LOD transitions at graben boundaries
│
└── examples/                           # Runnable examples
    ├── check_landing_site.rs           # Evaluate smooth plains near Messina Chasmata for landing
    ├── crater_sim.rs                   # Gertrude/Ursula basin formation in ice-rock crust
    ├── eclipse_sim.rs                  # Uranus shadow transit, equinoctial mutual event timing
    ├── exosphere_sim.rs                # Seasonal CO₂ sublimation atmosphere modeling
    ├── uranus_observation.rs           # Uranus as seen from Titania — tilted disk, ring system
    ├── orbital_sim.rs                  # 8.71-day orbit propagation, long-term stability analysis
    ├── radiation_sim.rs                # Uranian magnetosphere environment at Titania orbit
    ├── resource_survey.rs              # Water ice and silicate composition mapping
    └── tidal_effects.rs               # Past resonance tidal heating — Messina Chasmata formation
```