Skip to content

First Core Run

This walkthrough copies the installed user resources, runs a compact orbit study, and inspects the resulting artifacts in the local Console.

1. Copy The User Resources

Choose an empty working directory:

astraeus resources copy astraeus-resources

The example used here is:

astraeus-resources/examples/user/first-orbit.yaml

It propagates a six-satellite Walker constellation for 90 minutes. The example is deliberately small, but it produces a complete state timeline suitable for 2D and 3D inspection.

2. Validate The RunSpec

astraeus run astraeus-resources/examples/user/first-orbit.yaml --dry-run --run-id first-orbit-check

A dry run validates and resolves the RunSpec without performing the requested engineering stages. It creates an inspectable planned run, so the validation and execution commands use different run IDs. Fix validation errors before starting the full run.

3. Run The Study

astraeus run astraeus-resources/examples/user/first-orbit.yaml --run-id first-orbit

The CLI prints the completed run path:

runs/core/first-orbit/

4. Inspect The First Artifacts

Start with:

Artifact What it tells you
run_manifest.json execution status, stage plan, provenance, warnings, and artifact families
metrics_summary.json compact engineering and execution metrics
environment_summary.json runtime and stage context
runspec.json canonical input Astraeus executed
config/resolved_constellation_layout.json synthesized satellites and shell layout
states/timeline_state_vectors_teme.parquet propagated state timeline

The run directory is the durable result and remains the shared evidence source for the Console and review commands.

Generate the compact deterministic review:

astraeus review run --run-dir runs/core/first-orbit

The default review is written to runs/core/first-orbit/run_review.md.

flowchart LR SPEC["RunSpec"] --> RUN["astraeus run"] RUN --> BUNDLE["Durable run bundle"] BUNDLE --> REVIEW["Console and review"] BUNDLE --> REUSE["Later analysis and comparison"]

5. Open The Console

astraeus console --runs-root runs

Select first-orbit in the run browser. Check that:

  • the run is reported as successful
  • six satellites are present
  • the 2D and 3D views cover the requested 90-minute timeline
  • the RunSpec and artifact locations match the run you launched

The Console covers common launch and review workflows. The CLI and RunSpec remain authoritative for the complete configuration surface.

Troubleshooting

Symptom Check
resources copy says the destination is not empty Choose a new directory, or reuse the resources you copied earlier.
The RunSpec cannot be found Run the command from the directory that contains astraeus-resources, or pass an absolute path.
The Console does not list the run Start it with --runs-root pointing to the directory that contains core/first-orbit.
A different run opens Select first-orbit explicitly in the run browser.

Next Steps