Skip to main content

Python package to simulate and optimise space-based VLBI missions

Project description

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

The latest version is available on PyPi. Ensure that pip is installed and run the following command:

pip install spacevlbi

Installing with pip will install/update all of the required libraries automatically (numpy, poliastro, matplotlib, astropy).

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

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.

Author(s)

This software has been developed by Ben Hudson ORCID logo 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

Citation

If you use spacevlbi in your publication, please cite:

Hudson, Ben (2024): Python package for simulating and optimising a space-based VLBI mission. 4TU.ResearchData. software. https://doi.org/10.4121/392b8d8c-4eb2-4420-b46b-1cb697764a2b

Would you like to contribute?

If you have any comments, feedback, or recommendations, feel free to reach out by sending an email to benhudson@tudelft.nl

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spacevlbi-1.1.5.tar.gz (188.7 kB view details)

Uploaded Source

Built Distribution

spacevlbi-1.1.5-py3-none-any.whl (56.0 kB view details)

Uploaded Python 3

File details

Details for the file spacevlbi-1.1.5.tar.gz.

File metadata

  • Download URL: spacevlbi-1.1.5.tar.gz
  • Upload date:
  • Size: 188.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for spacevlbi-1.1.5.tar.gz
Algorithm Hash digest
SHA256 67bb82a4f2cfcbd6876e6fa1d7ce0cfe9d4d464f7445c1245215df01337cfca3
MD5 5894338d1d812600c721c0b922dc9bb3
BLAKE2b-256 8e355b9cb2c7e29feb38723e9ea9fb459929306b5d602071324886a222b6a8df

See more details on using hashes here.

File details

Details for the file spacevlbi-1.1.5-py3-none-any.whl.

File metadata

  • Download URL: spacevlbi-1.1.5-py3-none-any.whl
  • Upload date:
  • Size: 56.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for spacevlbi-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c001b3767e71c41bfe64ca61c073b3583e9ae142d4427b82f6cfedbdcf273780
MD5 eb99520ad26c4e6561b67e7a2ac3b66e
BLAKE2b-256 2d4145ff57e4863a85e472c86b794a2d6051f25cfadd27dcc91019167adfb33d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page