earths 0.0.4

High-fidelity Earth simulation engine — orbit, atmosphere, geology, hydrology, biosphere, terrain, lighting, rendering, satellites, and temporal systems with full scientific coupling
Documentation
# Coming Soon

## Current State

- Version 0.0.2, published on crates.io
- 11 domain modules: atmosphere, biosphere, geodata, geology, hydrology, lighting, physics, rendering, satellites, temporal, terrain
- ~8,500 lines of code, 275+ public functions, structs and enums
- 347 unit/integration tests covering all subsystems
- Scientific models: Keplerian orbits (Newton–Raphson), Rayleigh/Mie scattering, Ekman/geostrophic winds, Stefan–Boltzmann energy balance, Manning flow, Farquhar photosynthesis, Glen's flow law, tidal forcing with Love numbers, Lotka–Volterra with RK4 integration
- `main.rs` integrates subsystems with explicit feedback loops (CO₂ ↔ NPP, clouds ↔ irradiance, sea level ↔ biome)
- IPC fallback: uses external planet binaries when available, falls back to internal simulation otherwise
- Depends on sciforge for physical, atomic, and astronomical constants

## Planned

- All hardcoded physical constants will be removed once sciforge includes them
- Refactor `main.rs` and `lib.rs`
- Publishing discipline: keep the crate publishable without requiring companion planet source trees in the repository.
- IPC discipline: avoid hardcoded filesystem paths and rely on explicit binary discovery and environment-based configuration.

## Notes

- No UI code, no viewer code, no visual binaries, no images, and no large datasets will be added to this crate. It provides simulation core, IPC hooks, and endpoint-ready outputs only.
- Many future improvements should land in sciforge first when they represent reusable scientific primitives rather than Earth-specific orchestration.
- Some roadmap items are intentionally blocked on sciforge updates so this crate does not drift away from the upstream scientific base.
- Licensing: MIT.