Getting Started

Installation

Clone the repository and build:

git clone https://github.com/sksat/orts.git
cd orts
cargo build --workspace

Running the Simulator

orts run propagates an orbit and records the result. It needs an orbit to propagate — --sat altitude=400 is the shortest way to say so:

cargo run --bin orts -- run --sat altitude=400

That writes output.rrd and, with no --duration, covers one orbital period. For CSV on stdout instead:

cargo run --bin orts -- run --sat altitude=400 --format csv

Starting the Viewer

orts serve streams the simulation over WebSocket and serves the embedded viewer:

cargo run --bin orts -- serve --sat altitude=400

Then open http://localhost:9001 in your browser.

Custom Parameters

# Higher altitude orbit with larger time step
cargo run --bin orts -- serve --sat altitude=800 --dt 5

# Fine time step with decimated output
cargo run --bin orts -- serve --sat altitude=400 --dt 1 --output-interval 10

--sat is a shorthand for simple cases. For generated or multi-satellite setups, describe the mission in a config file:

cargo run --bin orts -- config example > mission.toml
cargo run --bin orts -- config validate mission.toml
cargo run --bin orts -- serve --config mission.toml

orts --help lists every subcommand (run, serve, replay, convert, config), and orts <subcommand> --help lists its options.

Project Structure

Crate	Description
orts	Core orbital mechanics library
orts-cli	CLI and WebSocket server
arika	Geodesy and coordinate transforms
utsuroi	ODE numerical integrators
tobari	Atmosphere models
uneri	DuckDB + uPlot charting library
viewer	React + Three.js 3D visualization