# Project Structure
Structure map for the Venuss crate.
```text
Venuss/
├── 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 — Venus diagnostics loop: orbit, retrograde rotation, atmosphere
│ ├── lib.rs # Library root, VENUSMASS (4.87e24), equatorial radius (6 052 km), molar masses
│ │
│ ├── atmosphere/ # Atmospheric science (96.5 % CO₂)
│ │ ├── mod.rs # Exports climate, heatwaves, layers, storms, winds
│ │ ├── climate.rs # Surface 737 K, 93 bar, greenhouse factor ~510 K above equilibrium
│ │ ├── heatwaves.rs # Thermal anomaly at lat/lon/pressure, UV absorber heating
│ │ ├── layers.rs # Troposphere, H₂SO₄ cloud deck (48–70 km), mesosphere, thermosphere
│ │ ├── storms.rs # Super-rotating atmosphere 4-day period, polar vortex dipole
│ │ └── winds.rs # Super-rotation 100 m/s at cloud top, surface winds ≈ 1 m/s
│ │
│ ├── biosphere/ # Hypothetical cloud-layer biosphere
│ │ ├── mod.rs # Exports ecosystems, fauna, vegetation
│ │ ├── ecosystems.rs # BiosignatureAssessment — temperate cloud zone (55 km, 310 K, 0.5 bar)
│ │ ├── fauna.rs # Aerial microbe hypothesis — sulfur-based energy, UV shielding
│ │ └── vegetation.rs # Photoautotroph model — UV-powered metabolism in cloud droplets
│ │
│ ├── geodata/ # Geographic reference data
│ │ ├── mod.rs # Exports bathymetry, coordinates, elevation, regions
│ │ ├── bathymetry.rs # Lowland plain basins (Atalanta Planitia) depth profiles
│ │ ├── coordinates.rs # Planetocentric latitude/longitude, IAU pole orientation
│ │ ├── elevation.rs # Mean planetary radius reference (6 051.8 km), global hypsometry
│ │ └── regions.rs # Ishtar Terra, Aphrodite Terra, Alpha Regio highland provinces
│ │
│ ├── geology/ # Interior and surface processes
│ │ ├── mod.rs # Exports earthquakes, erosion, mountains, plate_tectonics, volcanism
│ │ ├── earthquakes.rs # Venusquake — limited seismicity, stagnant lid convection stress
│ │ ├── erosion.rs # Chemical weathering at 737 K, supercritical CO₂ surface reactions
│ │ ├── mountains.rs # Maxwell Montes (10.8 km), Maat Mons shield volcano summit
│ │ ├── plate_tectonics.rs # Stagnant lid regime, episodic resurfacing (300–500 Myr), coronae
│ │ └── volcanism.rs # Active volcanism (Maat Mons, Idunn Mons), basaltic lava flows
│ │
│ ├── hydrology/ # Paleo-ocean and surface fluid modeling
│ │ ├── mod.rs # Exports glaciers, lakes, oceans, rivers
│ │ ├── glaciers.rs # No surface ice — modeling ancient water loss via hydrodynamic escape
│ │ ├── lakes.rs # Hypothetical past liquid water basins before runaway greenhouse
│ │ ├── oceans.rs # Paleo-ocean depth estimates, D/H ratio (150× Earth) constraints
│ │ └── rivers.rs # Relict channel features (lava channels: Baltis Vallis 6 800 km)
│ │
│ ├── lighting/ # Illumination model
│ │ ├── mod.rs # Exports day_night, seasons, solar_position
│ │ ├── day_night.rs # Solar day 116.75 d, sidereal day −243.02 d (retrograde)
│ │ ├── seasons.rs # Negligible axial tilt (2.64°), minimal seasonal variation
│ │ └── solar_position.rs # Solar zenith angle, sub-solar point drift across retrograde rotation
│ │
│ ├── physics/ # Orbital and impact mechanics
│ │ ├── mod.rs # Exports collisions, orbit, rotation, tides
│ │ ├── collisions.rs # Dense atmosphere burns small impactors, crater minimum diameter ≈ 3 km
│ │ ├── orbit.rs # a = 1.082e11 m, e = 0.0068, period 224.7 d, vis-viva, quasi-circular
│ │ ├── rotation.rs # Period −20 996 800 s (−243.02 d retrograde), axial tilt 177.36°
│ │ └── tides.rs # Solar tidal dissipation, spin-orbit coupling, atmospheric tidal torque
│ │
│ ├── rendering/ # Visual rendering pipeline
│ │ ├── mod.rs # Exports atmosphere_scattering, clouds, materials, shaders, surface_haze
│ │ ├── atmosphere_scattering.rs # CO₂ Rayleigh scattering, orange surface illumination through clouds
│ │ ├── clouds.rs # H₂SO₄ droplet cloud layers (48–70 km), UV-dark markings
│ │ ├── materials.rs # PBR surface/atmosphere material properties, Magellan radar texture
│ │ ├── shaders.rs # GPU shader programs — thick atmosphere volume rendering
│ │ └── surface_haze.rs # Near-surface haze rendering, thermal glow at 737 K, lava emission
│ │
│ ├── satellites/ # Natural moons (none) and probes
│ │ ├── mod.rs # Exports artificial, none
│ │ ├── artificial.rs # Venera/Vega landers, Magellan orbiter, Akatsuki, VERITAS, DAVINCI+
│ │ └── none.rs # Venus has no natural satellites — placeholder returns None
│ │
│ ├── temporal/ # Time systems
│ │ ├── mod.rs # Exports calendar, epoch, time_scale
│ │ ├── calendar.rs # Venusian calendar — 224.7 d year, 116.75 d solar day
│ │ ├── epoch.rs # J2000 epoch, Magellan/Venera encounter reference epochs
│ │ └── time_scale.rs # TDB/UT1/TAI conversions at 0.723 AU light-time delay
│ │
│ └── terrain/ # Terrain mesh generation
│ ├── mod.rs # Exports heightmap, lod, mesh, texturing
│ ├── heightmap.rs # Magellan SAR altimetry, 120 m/pixel DEM
│ ├── lod.rs # Level-of-detail streaming for SAR-derived topography
│ ├── mesh.rs # Near-spherical mesh (f ≈ 0), radius 6 051.8 km
│ └── texturing.rs # Magellan radar backscatter false-color maps
│
├── tests/ # Integration tests
│ ├── atmosphere_tests.rs # Tests greenhouse, super-rotation, H₂SO₄ clouds
│ ├── geology_tests.rs # Tests volcanism, stagnant lid, Maxwell Montes
│ ├── hydrology_tests.rs # Tests paleo-ocean, D/H ratio, Baltis Vallis
│ └── physics_tests.rs # Tests orbital period, retrograde rotation, solar tides
│
└── examples/ # Runnable examples
├── climate_sim.rs # Atmospheric layers, greenhouse effect, cloud scattering
├── earthquake_sim.rs # Stagnant lid stress modeling, corona formation
└── tidal_sim.rs # Orbital mechanics, solar tidal locking evolution
```