Skip to main content

Constraint-Aware Execution

POST a workload and a satellite ID. Get back a physically-accurate execution plan — computed from real orbital mechanics, real ground station passes, and real power/thermal constraints.
Available now — CAE v1.0 is live. No API key required.

How It Works

  1. Choose a workload — pick from 5 built-in presets or define a custom DAG
  2. CAE builds the orbital environment — SGP4 propagation from real TLE data, eclipse detection, ground station pass prediction
  3. 4-phase planner runs — topological sort, compute placement (on-board vs ground), transfer insertion, window scheduling
  4. You get a complete plan — placement decisions, transfer schedule, error budget, security summary, and a simulated execution event stream

Capabilities

CapabilityDetails
Orbital propagationSGP4 from real CelesTrak TLE data
Eclipse detectionCylindrical shadow model
Ground network12 stations (KSAT, NASA, AWS)
Compute placementAutomatic on-board vs ground optimization
Transfer schedulingMulti-pass downlink/uplink with FEC overhead
Error correctionReed-Solomon FEC, retransmission reserves
SecurityAES-128/256 encryption, SHA-256/CRC32 integrity
Delivery confidenceDeterministic error budget calculation
Orbital primitivesEclipse, window, and pass step types (I-1)
Pareto planningMulti-objective frontier with 4 relaxation types (I-2)
Constellation DAGMulti-satellite orchestration with ISL routing (I-3)
Hazard predictionEclipse-boundary checkpointing via SAA/thermal detection (I-4)
Orbital Compute UnitStandardized capacity measurement across bus classes (I-5)
MonitoringPer-endpoint latency percentiles and request metrics

Base URL

https://rotastellar-cae.subhadip-mitra.workers.dev
CAE does not require an API key. Access is controlled via CORS origin checking. Requests from rotastellar.com and localhost:4000 are allowed. For cURL testing, include -H "Origin: https://rotastellar.com".

Quick Example

Create an execution plan for the ISS using the on-board ML inference preset:
curl -X POST https://rotastellar-cae.subhadip-mitra.workers.dev/v1/plan \
  -H "Content-Type: application/json" \
  -H "Origin: https://rotastellar.com" \
  -d '{
    "satellite_id": "25544",
    "preset_id": "onboard-ml-inference"
  }'
The response includes the full execution plan with orbital environment, placement decisions, transfer schedule, error budget, and a simulated event stream. See Understanding Plans for a walkthrough.

Endpoints

MethodPathDescription
GET/v1/presetsList workload presets
POST/v1/planCreate an execution plan
GET/v1/plan/:idRetrieve a plan
GET/v1/plan/:id/eventsGet execution event stream
POST/v1/constellation/planPlan a constellation DAG
POST/v1/constellation/paretoConstellation Pareto frontier
POST/v1/hazardsPredict orbital hazards
POST/v1/ocu/negotiateNegotiate OCU capacity
GET/v1/ocu/summary/:busClassOCU summary by bus class
GET/v1/metricsService metrics and latency