Basilisk and Docker for Reproducible GN&C Simulation: A Workflow Reference

Anubhav Gupta · 2026

Read Basilisk and Docker for Reproducible GN&C Simulation: A Workflow Reference by Anubhav Gupta (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2605-12443.txt.

Introduction

Gupta presents a Docker workflow that makes one space simulation framework easy to rerun anywhere. Basilisk is open source software for spacecraft guidance, navigation and control work. Yet setting it up varies with machine, system and settings, since parts and options differ. The workflow packs the whole build setup, parts and simulation tools into one portable container image. It is shown through tasks of rising difficulty, from simple orbit scripts to attitude control with Monte Carlo checks. The paper also covers BSKSim classes, dynamics models and flight software.

Catalog record

CREATORAnubhav Gupta
YEAR2026
COLLECTIONPAPERS
FORMATTXT
FILE SIZE46915
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2605.12443

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

Basilisk and Docker for Reproducible GN&C Simulation: A Workflow Reference Anubhav Gupta Abstract Basilisk is an open-source astrodynamics simulation framework widely used for spacecraft guidance, navigation, and control (GN&C) research and development. Despite its flexibility and computational capabilities, configuring Basilisk consistently across heterogeneous development environments presents practical challenges due to dependency management, operating system compatibility, and software configuration requirements. This paper presents a Docker-based containerization workflow for Basilisk that encapsulates the complete build environment, dependencies, and simulation infrastructure within a portable container image. The workflow is demonstrated through a progression of simulation scenarios of increasing complexity, from standalone orbital dynamics scripts to BSKSim-based attitude dynamics and control simulations with Monte Carlo analysis. The BSKSim class hierarchy, dynamics model architecture, flight software implementation, and scenario execution patterns are described in detail. The presented workflow provides a self-contained implementation reference for GN&C engineers and researchers seeking reproducible and portable Basilisk simulation environments. This work expands upon a workshop presentation delivered at the 46th Rocky Mountain AAS GN&C Conference, February 2024, available at https://doi.org/10.5281/zenodo.15008785 . Keywords: Basilisk; Docker; astrodynamics simulation; GN&C simulation; spacecraft simulation; containerization; Vizard; simulation workflows Nomenclature n mean orbit rate, s -1 \mu gravitational parameter, km 3 /s 2 a semi-major axis, km e orbital eccentricity i inclination, rad \Omega RAAN, rad \omega argument of periapsis, rad f true anomaly, rad T orbital period, s T_{\text{final}} total simulation time, s Subscripts J_{2} J_{2} perturbation BN body / inertial frame CN CoM / inertial frame \mathbf{r} position vector, km \hat{\mathbf{r}} unit position vector \ddot{\mathbf{r}} acceleration vector, km/s 2 \mathbf{a}_{J_{2}} J_{2} acceleration, km/s 2 \mathbf{I}_{sc} inertia matrix, kg \cdot m 2 K,P MRP control gains N number of logged data points \Delta t_{\text{sim}} simulation time step, s \Delta t_{\text{samp}} sampling period, s 1 Introduction Spacecraft guidance, navigation, and control (GN&C) simulations play a critical role in the design, validation, and analysis of modern space missions, where even minor malfunctions may contribute to mission failure [ 11 ] . Such simulations are frequently used to evaluate spacecraft dynamics, flight software behavior, mission operations concepts, estimation algorithms, and autonomous control strategies prior to deployment. As spacecraft missions increase in complexity, the supporting simulation environments likewise require increasingly sophisticated software infrastructures capable of integrating dynamics models, visualization tools, numerical solvers, and custom flight software components. Existing astrodynamics and spacecraft simulation tools span commercial off-the-shelf, government-developed, and open-source ecosystems, including platforms such as STK, MATLAB/Simulink, GMAT, NASA 42, NASA Trick, and DARTS/DShell [ 11 ] . Basilisk (BSK) is an open-source astrodynamics simulation framework developed collaboratively by the Autonomous Vehicle Systems (AVS) Laboratory at the University of Colorado Boulder and the Laboratory for Atmospheric and Space Physics (LASP) [ 11 ] . The framework provides a modular simulation architecture for spacecraft dynamics and flight software development while supporting both faster-than-real-time and real-time simulation workflows. Its underlying C++ implementation delivers high-speed execution, while a Python interface ensures accessibility for GN&C engineers and researchers. Basilisk has been applied to a broad range of applications including astrodynamics research, spacecraft autonomy studies, mission concept development, and hardware-in-the-loop simulation environments. Basilisk also integrates with Vizard [ 16 ] , a Unity-based three-dimensional visualization tool capable of rendering spacecraft states and simulation telemetry interactively. Despite the flexibility provided by modern simulation frameworks, configuring portable and repeatable software environments for astrodynamics simulations can remain challenging. Scientific software stacks often depend on operating system compatibility, compiler toolchains, Python environments, Conan package management, external libraries, visualization dependencies, and ephemeris datasets. Variations across development machines may therefore introduce inconsistencies in installation procedures, software behavior, or simulation execution workflows. Containerization technologies such as Docker [ 12 ] provide one possible solution to these challenges by packaging software applications and their dependencies into isolated and portable runtime environments. Such workflows simplify software deployment, reduce dependency conflicts, and improve portability across development systems [ 13 ] . In the context of GN&C simulation workflows, containerized environments can help streamline installation procedures and support consistent execution environments for research, collaboration, and educational activities. This work expands upon the workshop presentation titled “Basilisk and Docker for Streamlined GN&C Simulation,” presented at the 46th Rocky Mountain AAS GN&C Conference in February 2024 [ 8 ] , openly available through Zenodo at https://doi.org/10.5281/zenodo.15008785 . The purpose of this document is to provide an expanded implementation reference covering Docker-based Basilisk deployment, modular simulation architecture, scenario-based scripting workflows, BSKSim-based simulation frameworks, visualization integration, and simulation data recording utilities. The remainder of this paper is organized as follows. Section 2 provides background on Basilisk, Vizard, and Docker. Section 3 describes the Docker configuration for Basilisk. Section 4 covers Basilisk’s software architecture. Section 5 presents standalone-script simulation workflows. Section 6 presents BSKSim-based simulation workflows including attitude dynamics, control, and Monte Carlo analysis. Section 7 discusses practical implications and limitations, and Section 8 concludes the paper. 2 Background This section provides an overview of the three core components used in this work: the Basilisk astrodynamics simulation framework, the Vizard visualization tool, and the Docker containerization platform. 2.1 Basilisk Basilisk (BSK) is an open-source astrodynamics simulation framework that supports spacecraft dynamics, guidance, navigation, and control (GN&C) simulations through a modular architecture composed of interconnected software modules and message-passing interfaces. Simulation functionality is organized through reusable modules representing spacecraft dynamics, sensors, actuators, estimation routines, and flight software components, which communicate through structured message interfaces enabling flexible construction of mission-specific simulation workflows. Basilisk has been applied to spacecraft dynamics analysis, mission concept development, flight software testing, and autonomy research [ 11 ] . A simplified representation of the Basilisk execution hierarchy and module-message architecture is shown in Fig. 1 . Simulation Container Processes Tasks Dynamics Module FSW Module Sensor Module Message-Passing Architecture Figure 1: Simplified Basilisk execution hierarchy and module-message architecture. 2.2 Vizard Vizard is a Unity-based three-dimensional visualization application developed alongside Basilisk for interactive rendering of simulation environments and spacecraft states [ 16 ] . The visualization framework interfaces directly with Basilisk simulations and supports both live streaming and offline playback workflows. A key characteristic of Vizard is that it displays only elements explicitly modeled in the simulation — components absent from the simulation model do not appear in the visualization, providing a useful diagnostic aid for identifying missing simulation elements. Vizard may be used to visualize spacecraft trajectories, reference frames, actuator states, celestial bodies, and simulation telemetry within a unified graphical environment. An example visualization is shown in Fig. 2 . Figure 2: Example spacecraft visualization rendered using Vizard during an Earth-orbit Basilisk simulation. 2.3 Docker and Docker Compose Docker is an open-source containerization platform that enables applications and their dependencies to be packaged into portable execution environments [ 12 ] . In scientific and engineering workflows, containerization simplifies dependency management, reduces platform-specific configuration issues, and improves portability across heterogeneous development systems [ 13 , 5 ] . Docker Compose extends this capability by providing a declarative configuration mechanism through a docker-compose.yml file, enabling container services, runtime properties, and volume mounts to be defined and launched with a single command [ 10 ] . Within the workflow presented in this work, Docker is used to encapsulate the Basilisk build environment, supporting libraries, and simulation scripts within a consistent runtime configuration. Environment construction is defined through a Dockerfile , while

Read the complete text