spacevlbi 1.1.10

Python package to simulate and optimise space-based VLBI missions

spacevlbi

Python package for simulating and optimising a space-based Very Long Baseline Interferometry (VLBI) mission. This package enables multiple space telescopes to be modelled by propagating their orbital and attitude state. Elements of the spacecraft design that impact when observations can be performed can also be included in the simulation to assess and mitigate their impact on the science return of the mission (e.g. source visibility including Sun/Earth/Moon avoidance, star trackers, radiators, solar panels, ground station access times, etc.).

A ground-based array of radio antenna can also be modelled, enabling the $(u,v)$ coverage that the full interferometer can achieve of a given source(s) to be calculated.

Although the package has been developed specifically for space VLBI applications, it can also be used more generally for modelling other types of astronomy mission and assessing the impact of the spacecraft design on the science return.

Installation

spacevlbi requires the latest development version of the poliastro package. Ensure that pip is installed and run the following command before trying to install spacevlbi:

pip install https://github.com/poliastro/poliastro/archive/main.zip

The latest version of spacevlbi is available on PyPi. Run the following command to install:

pip install spacevlbi

Installing with pip will install/update the other required libraries automatically (numpy, matplotlib, astropy and geopandas).

Structure

In this repository you can find:

• spacevlbi/ directory containing the core Python libraries
• Examples/ directory containing example scripts to demonstrate the use of the package
• docs/ directory containing readthedocs configuration files

Documentation

More detailed documentation for the package is available here.

Provided in the Examples folder is the script ExampleSetup.py. This script shows how the package can be used to model a VLBI array with a single space element. This example is based upon the preliminary concept for the Black Hole Explorer (BHEX) mission. The script ExampleSpaceTelescope.py shows how an object of the SpaceTelescope class can be defined.

Running the provided example will produce the following figures in an Output folder:

• AttitudeSphere.pdf
• GroundStationAccess.pdf
• Orbit.pdf
• UV.pdf
• GroundStationContact.pdf

The terminal will show the simulation progress by printing the current timestep. Once the simulation is complete, additional print statements will confirm the generation of the four figures listed previously. The example script will also calculate the optimal position(s) for a star tracker to avoid Sun and Earth blinding.

Citation

If you use spacevlbi in your publication, please cite: Hudson+ 2025

Author(s)

This software has been developed by Ben Hudson 0000-0002-3368-1864, Technische Universiteit Delft

License

spacevlbi is licensed under GPLv3. See LICENSE.txt for more details.

Technische Universiteit Delft hereby disclaims all copyright interest in the program "spacevlbi". spacevlbi is a python package to simulate space-based VLBI missions written by the Author(s).
Ben Hudson, Faculty of Aerospace Engineering, Technische Universiteit Delft.

© 2024, B. Hudson

Would you like to contribute?

If you have any comments, feedback, or recommendations, feel free to reach out by sending an email to [e-mail]

If you would like to contribute directly, you are welcome to fork this repository.