Skip to content

Running in python

Thibaud Teil edited this page Dec 12, 2025 · 4 revisions

Cielim Python Test Connector

All python capabilities are gathered in Source/cielim-python

The Cielim test connector enables communication with a Cielim instance to send simulation frames and request rendered images. You can create scenes manually by populating simulation data frames using the Cielim protobuf schema defined in cielimMessage.proto.

Be sure to install the python requirements listed in requirements.txt

Features

  • Connect to and disconnect from Cielim instances
  • Send spacecraft frames as protobuf messages
  • Request and receive rendered camera images

The connector supports both static image generation (without requiring Basilisk or external scene generation tools) and integrated testing workflows.

Compiling the Protobuf Schema

Cielim and the Connector exchange data using the Basilisk cielimMessage.proto schema. The Python interface for this schema has been generated from Basilisk and copied into the Cielim project to eliminate the dependency on Basilisk for schema access. The schemas are currently maintained in sync manually.

Running Integrated Tests

The cielim-python folder contains both integrated and unit tests written in Python. To run all tests, execute the following command in this directory:

pytest

Running Example Scenarios

Navigate to the examples folder and run any of the following:

python random_asteroid_generation.py

If you have downloaded the required support data, you can also try:

python deimos_flyby.py

Clone this wiki locally