JWSToolKit documentation

Warning

The package is still under development, although many of the features are already functional. Documentation is also still under production. If you have any questions or comments, please don’t hesitate to contact me: valentin.delabrosse@univ-grenoble-alpes.fr

JWSToolKit is an open-source python package designed to simplify the manipulation of observational data from the James Webb Space Telescope. The package has been developed to manipulate spectra, images and data cubes from all JWST instruments.

The package provides tools for extracting spectra, creating maps, projecting coordinates and much more. The package source code and documentation are available on GitHub : https://github.com/delabrov/JWSToolKit

Bugs, requests for new features and help are welcome to improve this package!

Contributors: JWSToolKit was developed by Valentin Delabrosse during his thesis at the Institut de Planétologie et d’Astrophysique de Grenoble (IPAG), France.

Installation

This section provides instructions on how to install JWSToolKit.

The first step before installing JWSToolKit on your machine is to make sure you have created a python environment separate from your Python system. By installing JWSToolKit, dependencies will be installed that can break and modify your existing system dependencies.

Requirements

Before installing JWSToolKit, you should have the following dependencies installed on your machine:

  • numpy - For mathematical processing

  • matplotlib - For data visualisation

  • scipy - For mathematical processing

  • astropy.io - To manipulate data in .fits format

  • tqdm - Progress bar in the terminal

  • photutils - To handle telescope observations

Warning

In particular, pay close attention to the photutils package. To run JWSToolKit routines correctly, you need to have the latest version of photutils installed on your machine, as well as a version of Python later than 3.11.

Installation with pip

To install the package with pip, use the following command:

pip install JWSToolKit

If you want to install a specific version of the package, use the command line:

pip install JWSToolKit==1.0.4

Finally, if the package is already installed on your machine but you wish to update it, use one of the commands:

pip install --upgrade JWSToolKit
pip install --upgrade JWSToolKit==1.0.4

Installation with conda

When using a conda environment, you should install the package via the conda command:

conda install delabrov::jwstoolkit

To update the package or download a specfif version:

conda install delabrov::jwstoolkit=1.0.4

In this situation, it is advisable to create a Python environment separate from the default system environment. To do this, enter the following command:

conda create -n name_of_the_environment

Once created, you can launch the environment with the command:

conda activate name_of_the_environment

Authors and Credits

The tools were developed by Valentin Delabrosse, during his thesis on the analysis of protostellar outflows from DG Tau B using JWST observations of Cycle 1 ID: 1644 (PI: Catherine Dougados). These codes were used to analyze the data and represent the results presented in Delabrosse et al. 2024 and Delabrosse et al. 2025 in prep.

This project has no dedicated article. To cite this package, cite Delabrosse et al. 2024. The package enabled us to generate the images and spectra presented in the article and to help analyze the observations.