# Project Structure
Structure map for the Jupiters crate.
```text
Jupiters/
├── 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 — unified Jupiter simulation with cloud biome materials, orbital/climate loop
│ ├── lib.rs # Library root, JUPITERMASS, equatorial radius, molar masses (H₂/He/CH₄/NH₃), matmosphere()
│ │
│ ├── atmosphere/ # Atmospheric science (H₂/He dominated)
│ │ ├── mod.rs # Exports climate, heatwaves, layers, storms, winds
│ │ ├── climate.rs # Equilibrium/effective temp (110 K / 124.4 K), NH₃ fraction, internal heating, radiative forcing
│ │ ├── heatwaves.rs # Thermal anomaly vs 1-bar reference, ammonia boiling point (239.8 K), danger levels
│ │ ├── layers.rs # 1-bar reference altitude, tropospheric lapse rate (0.002 K/m), barometric pressure profile
│ │ ├── storms.rs # Great Red Spot (180 m/s, 12 000 km radius), Oval BA (150 m/s), jovian storm modeling
│ │ └── winds.rs # Coriolis parameter, geostrophic/gradient wind speed for Jupiter's rapid rotation
│ │
│ ├── biosphere/ # Theoretical aerial biosphere
│ │ ├── mod.rs # Exports aerochemistry, ecosystems, fauna
│ │ ├── aerochemistry.rs # H₂/acetylene chemotroph metabolic rate, Arrhenius kinetics for cloud-layer organisms
│ │ ├── ecosystems.rs # Shannon/Simpson diversity, species-area relation, net primary productivity
│ │ └── fauna.rs # Logistic growth, forward projection, Kleiber metabolic scaling
│ │
│ ├── geodata/ # Geographic and interior data
│ │ ├── mod.rs # Exports bathymetry, coordinates, elevation, regions
│ │ ├── bathymetry.rs # Deep interior layer depth sampling at configurable resolution
│ │ ├── coordinates.rs # LatLon ↔ ECEF on Jupiter oblate ellipsoid, geodetic flattening conversion
│ │ ├── elevation.rs # Global cloud-top elevation grid from heightmap
│ │ └── regions.rs # Atmospheric bands, vortex regions, polar caps, storm systems, cloud features
│ │
│ ├── geology/ # Interior processes
│ │ ├── mod.rs # Exports earthquakes, erosion, mountains, plate_tectonics, volcanism
│ │ ├── earthquakes.rs # Icequake seismic moment/magnitude, P/S wave velocities, Gutenberg-Richter relation
│ │ ├── erosion.rs # Wind erosion threshold and rate computation for atmospheric particles
│ │ ├── mountains.rs # Metallic hydrogen/rocky core density, Airy isostatic root depth
│ │ ├── plate_tectonics.rs # Interior convection cell, Euler pole, metallic H (1000 kg/m³), rocky core (25 000)
│ │ └── volcanism.rs # CryoMagma — H₂O/NH₃/CH₄ weight fractions, Arrhenius viscosity, liquidus temperature
│ │
│ ├── hydrology/ # Interior fluid layers
│ │ ├── mod.rs # Exports glaciers, lakes, oceans, rivers
│ │ ├── glaciers.rs # Glen's flow law (n = 3, A = 2.4e-24), basal shear stress, mass balance
│ │ ├── lakes.rs # CryoLake — mean depth, shoreline ratio, residence time, interior metallic H density
│ │ ├── oceans.rs # Interior metallic/molecular H bulk modulus, sound speed, dynamic viscosity
│ │ └── rivers.rs # Atmospheric flow cross-section, discharge, Manning velocity, Froude number
│ │
│ ├── lighting/ # Illumination and day cycles
│ │ ├── mod.rs # Exports day_night, seasons, solar_position
│ │ ├── day_night.rs # Twilight zones from solar elevation at Jupiter distance
│ │ ├── seasons.rs # Axial tilt 3.13°, orbital period 4332.59 d, solar longitude, sub-solar latitude
│ │ └── solar_position.rs # Solar azimuth/elevation/distance, Jupiter ephemeris, 9.925 h rotation
│ │
│ ├── physics/ # Orbital and impact mechanics
│ │ ├── mod.rs # Exports collisions, orbit, rotation, tides
│ │ ├── collisions.rs # Asteroid impact: kinetic energy (J / Mt TNT), crater diameter, fireball radius
│ │ ├── orbit.rs # Semi-major 5.2044 AU, e = 0.0489, vis-viva, Kepler period, escape velocity
│ │ ├── rotation.rs # Sidereal period 35 730 s, axial tilt 3.13°, surface velocity, precession (500 kyr)
│ │ └── tides.rs # Tidal acceleration/potential from Io and Sun, bulge height
│ │
│ ├── rendering/ # Visual rendering
│ │ ├── mod.rs # Exports atmosphere_scattering, clouds, materials, ocean_rendering, shaders
│ │ ├── atmosphere_scattering.rs # Rayleigh/Mie scattering for H₂/He atmosphere, ammonia absorption
│ │ ├── clouds.rs # Ammonia ice, NH₄SH, water ice, deep water, high-altitude haze layers
│ │ ├── materials.rs # PBR materials — ammonia cloud, NH₄SH, deep atmosphere, haze, core rock, metallic H
│ │ ├── ocean_rendering.rs # Interior metallic ocean rendering, wave spectrum at high P/T
│ │ └── shaders.rs # GLSL uniforms for cloud-top PBR, sun direction, camera, matrices
│ │
│ ├── satellites/ # Galilean moons and probes
│ │ ├── mod.rs # Exports artificial, callisto, europa, ganymede, io
│ │ ├── artificial.rs # Orbital elements, J2 perturbations around Jupiter
│ │ ├── callisto.rs # Satellite stub — Callisto (name, mass, radius placeholder)
│ │ ├── europa.rs # Satellite stub — Europa (name, mass, radius placeholder)
│ │ ├── ganymede.rs # Satellite stub — Ganymede (name, mass, radius placeholder)
│ │ └── io.rs # IoState — mass (8.93e22 kg), radius, orbital period (152 853 s), IPC interface
│ │
│ ├── temporal/ # Time and calendar
│ │ ├── mod.rs # Exports calendar, epoch, time_scale
│ │ ├── calendar.rs # Julian ↔ Gregorian, Jupiter day (35 730 s), year (3.743e8 s), Unix epoch
│ │ ├── epoch.rs # J2000 (2 451 545.0), J1950, MJD offset, centuries-since-J2000
│ │ └── time_scale.rs # Simulation clock, speed multiplier, pause/resume, Jupiter-day unit
│ │
│ └── terrain/ # Cloud-top terrain generation
│ ├── mod.rs # Exports heightmap, lod, mesh, texturing
│ ├── heightmap.rs # Banded cloud-top structure, Great Red Spot (+8 km), Oval BA, polar cap, zonal waves
│ ├── lod.rs # Cube-face quadtree LOD subdivision, max level 15, split distance heuristics
│ ├── mesh.rs # Spherical mesh from lat/lon region, normals, tangents, UVs
│ └── texturing.rs # CloudBiome — ammonia ice, NH₄SH, water ice, deep cloud, haze, storm, polar vortex
│
├── tests/ # Integration tests
│ ├── atmosphere_tests.rs # Tests layer profiles, barometric model, storm parameters
│ ├── geology_tests.rs # Tests interior density, icequake scaling, convection cells
│ ├── hydrology_tests.rs # Tests metallic H properties, Glen's flow law, atmospheric flow
│ └── physics_tests.rs # Tests orbital period, escape velocity, tidal forces from Io
│
└── examples/ # Runnable examples
├── climate_sim.rs # Atmospheric layers, climate state, NH₃ forcing, energy balance
├── earthquake_sim.rs # Interior icequake modeling, seismic moment, wave velocities
└── tidal_sim.rs # Orbital mechanics, Io tidal interaction, bulge heights
```