punchbowl

punchbowl is the science calibration code for the PUNCH mission.

Start by checking the documentation.

Accessing the data

Data are available via the Solar Data Analysis Center. See the PUNCH website for details.

Installing `punchbowl`

Install with pip install punchbowl to get the released version.

To get the latest unreleased version: clone the repo and install it locally.

Setting up the PUNCH environment

Using uv

Clone this repository on your local machine
Navigate to the repository and create a virtual environment in Python using uv with uv sync --no-sources --no-dev (super users who want to install optional-dependencies, use uv sync --no-sources --no-dev --all-extras)
Activate the virtual environment by running source .venv/bin/activate on Mac/Linux or .venv\Scripts\activate on Windows
Explore some data!

Using venv

Clone this repository on your local machine
Navigate to the repository and create a virtual environment in Python using python -m venv my_venv_name
Activate the virtual environment by running source my_venv_name/bin/activate on Mac/Linux or my_venv_name\Scripts\activate on Windows
Install the project environment dependencies by running pip install . (super users who want to install optional-dependencies, use pip install -e ".[super-user]")
Explore some data!

Running `punchbowl`

The documentation provides details on how to run the various components. It also provides a short explanation of each underlying algorithm. Please reach out with a discussion for more help.

Testing

You need Docker or Podman Desktop.

Install Podman Desktop using your preferred method
Pull the mariadb image with podman pull docker.io/library/mariadb
Run tests with pytest

Getting help

Please open an issue or discussion on this repo.

Contributing

We appreciate all contributions. If you have a problem with the code or would like to see a new feature, please open an issue. Or you can submit a pull request.

If you would like to contribute by submitting a pull request, ensure that you have installed the environment as a super-user to activate necessary dependencies. You will also need to set up pre-commit so that it will analyze your staged files. To do this, run pre-commit install in the punchbowl, solpolpy, and/or regularizepsf repositories after setting up your environment. This step should only need to be done once after installing the environment.

Thanks to all the contributors to punchbowl!

Metadata

Release files for punchbowl 0.0.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for punchbowl 0.0.25
File	Size	Uploaded
punchbowl-0.0.25.tar.gz	22.5 MB	Oct 16, 2026	Details

Release files / punchbowl-0.0.25.tar.gz

Download URL	punchbowl-0.0.25.tar.gz
Size	22.5 MB
Tags	Source
SHA-256 checksum How to use checksums	`1fe9737c30b367cf3db601086e7d162f113920fba94ad1bf345b556ed61130e5`
BLAKE2b-256 checksum How to use checksums	`4a15a680562e771fb3add55d194944ff55633f9e76d3083b06aa59b5054147fc`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.