Jupiters

Part of the Celestial project.

Jupiters is a Rust Jupiter-system simulation core.

It computes state, evolves that state over time, and exposes simulation-ready data for downstream consumers. It is meant to sit behind endpoints, IPC, or another orchestrating runtime. It is not a UI crate, not a viewer, and not a frontend.

Scope

Jupiters currently ships as:

• a Cargo package named jupiters
• a Rust library crate imported as jupiters
• a runtime binary named jupiters

The project combines scientific subsystems for:

• atmosphere
• biosphere
• geodata
• geology
• hydrology
• lighting
• physics
• rendering-oriented physical state
• satellites
• temporal systems
• terrain

The library exposes reusable domain modules. The binary assembles them into a continuously ticking Jupiter runtime.

What This Crate Is For

Use Jupiters when you need one of these:

• a Rust dependency for Jupiter-system simulation logic
• a runtime process that advances Jupiter state continuously
• a backend core behind REST, gRPC, WebSocket, CLI, or custom IPC endpoints
• an orchestrated Jupiter node inside a larger multi-body simulation system
• a downstream consumer of scientific primitives provided by sciforge

What This Crate Will Not Do

Jupiters does not provide:

• any UI
• any viewer
• any frontend
• any visualization layer
• any render window or presentation loop
• any bundled large datasets
• any hardcoded dependency on sibling repositories

Key Physical Parameters

Key Features

• H₂/He atmosphere with ammonia/water cloud decks
• Great Red Spot and zonal jet stream modeling
• Galilean moons (Io, Europa, Ganymede, Callisto)
• Metallic hydrogen interior and deep water layer
• Internal heat excess (1.67x received solar)
• Powerful magnetic field and radiation belts
• Diamond rain hypothesis in deep atmosphere

Current Status

• version: 0.0.1
• edition: 2024
• license: MIT
• validation gates: cargo fmt, cargo clippy, cargo test

Architecture

Jupiters is split into domain modules plus a runtime binary.

Package Name, Library Name, Binary Name

• Cargo package name: jupiters
• Rust library import path: jupiters
• binary name: jupiters

Dependency declaration:

[dependencies]
jupiters = "0.0.1"

Rust import path:

use jupiters::physics::orbit;

Runtime Binary

The binary in src/main.rs is a long-running simulation process. It constructs a full Jupiter state object, advances simulation time continuously, and keeps running until externally stopped. It does not open a window, draw frames, or embed any visual dashboard.

Why There Is a rendering Module

The rendering module provides physically meaningful data structures for ammonia/CH₄ atmospheric scattering, multi-layer cloud parameters, PBR materials, and band shader uniforms. It does not make this crate a visual application.

Examples

• cargo run --example climate_sim
• cargo run --example earthquake_sim
• cargo run --example tidal_sim

Validation

cargo fmt --check
cargo clippy
cargo test

sciforge Strategy

Jupiters is intentionally downstream from sciforge. Jupiter-specific orchestration belongs here; reusable scientific primitives should move upstream into sciforge when appropriate.

Related Project Files

• CHANGELOG.md: current implemented state
• ComingSoon.md: detailed roadmap and blocked items
• LICENSE: MIT license text