bowshockpy 1.0.0

A Python package for generating spectral channel maps of a jet-driven bowshock model

BowshockPy

A Python package for generating spectral channel maps of a jet-driven bowshock model

BowshockPy is a Python package that generates synthetic spectral cubes, position-velocity diagrams, and moment images for a simple analytical jet-driven bowshock model, using the prescription for protostellar jets presented in Ostriker et al. (2001) and Tabone et al. (2018). The software computes column density and is able to calculate the intensities of low-J rotational transitions of a linear molecule such as CO, providing mock observations of the emission that radio interferometers as ALMA are able to detect at millimeter wavelengths.

Documentation

An extensive documentation on BowshockPy can be found here.

Requirements

BowshockPy requires:

• astropy
• matplotlib
• numpy
• photutils
• scipy

It has been tested in python versions 3.9-3.12, but it could work with other versions also.

Installation

You can install BowshockPy from PyPI.

$ pip install bowshockpy

How to use

There are two different ways to use BowshockPy:

1. Run it from the terminal specifying an input file: Use an example of input file and modify the input parameters according your scientific goals. Then, run BowshockPy in your terminal:

$ bowshockpy -r inputfile.py

2. Import BowshockPy package in your Python code: We include an notebook tutorial that shows how to use the main classes.

See the documentation for more details on the usage of BowshockPy.

Contributing

If you are interested in contributing, see contributing

License

This project is licensed under the MIT License. For details see the LICENSE.

Citation

@software{gblazquez2025,
  author    = {Blazquez-Calero, Guillermo AND et al.},
  title     = {{BowshockPy}: A Python package for the generation of synthetic spectral channel maps of a jet-driven
bowshock model},
  year      = {2025},
  version   = {1.0.0},
  url       = {https://github.com/gblazquez/bowshockpy}
}