Basics of Writing Basilisk Modules

Making New Modules

You should build your own Basilisk modules outside of the primary Basilisk source folder. This keeps your Basilisk source folder free of local customizations that interfere with upgrading the simulation framework. The only exception is if you are planning on pushing the module back to the primary Basilisk source itself. Instructions on how to create modules outside of the main source folder are found at Building Custom Modules.

This chapter covers the basics of designing Basilisk modules, as well as how to write a module using C++, C or Python. As always with code documentation, it is never complete and always work-in-progress.

For general developer support pages on coding guidelines, forking, building the Sphinx documentation system etc., see Support/Developer Information in Basics of Writing Basilisk Modules.

The following pages cover the primary tasks required to make a Basilisk module. This includes how to design the basic module function, how messages work, what methods are required for a module, etc. Note that the dynamics modules are both Basilisk modules and also a sub-class of either Module: dynamicEffector (provide external forces and torques acting on the body, but doesn’t have state differential equations to integrate), or Module: stateEffector (has internal state differential equations to integrate that couple with the spacecraft rigid hub).

Warning

The goal of the following content is to facilitate the process of creating new modules. However, this documentation does not avoid the need to study the Basilisk source code, including how other modules were written, to understand how to create new modules.

• Module Design Considerations
  • Message Connections
  • One Big Module or Several Small Modules
  • Variable Number of Input or Output Messages
• Creating New Message Definitions
  • Msg File Location
  • Msg Data Definition
  • Creating the Msg C/C++ Interface Files
• Making C Modules
  • Module Header File
  • C Message Object
  • Module Definition File
  • Swig Interface File
  • Deprecated SWIG Interface File
• Making C++ Modules
  • Module Header File
  • C++ Message Object
  • Module Definition File
  • Swig Interface File
  • C++ Module with C-Wrapped Output Message
• Making Python Modules
• Module RST Documentation
  • Creating the Documentation Page
  • Testing the Documentation
• Module Unit Test File
• Automation Script to Create a New Basilisk Module
  • Header File
  • C/C++ File
  • Swig File
  • RST Module Documentation
  • Unit Test File
  • User Guide
• Common Basilisk Support Files
• Advanced Topics
  • Creating DynamicObject Basilisk Modules