Skip to main content

Calzone

Calzone (CALorimeter ZONE) is a Python package built on top of Geant4. It was developed in the context of geosciences with the objective of studying the emission of radioactivity from volcanoes (Terray et al., 2020), and in particular to simulate the response of gamma spectrometers deployed in the field. To this end, Calzone was developed in conjunction with Goupil (Niess et al., 2024), a backward gamma transport engine, and is interoperable with the latter. Yet, both packages can be used entirely independently, if necessary.

Please refer to the online documentation and the examples for further information.

Installation

Binary distributions of Calzone are available from PyPI, e.g. as

python -m pip install calzone

In addition, Calzone requires 2 GB of Geant4 data tables, which are not included in the Python package. Once Calzone has been installed, these can be downloaded as

python -m calzone download

Please refer to the documentation for alternative installation methods.

Quick start

# file: geometry.toml

[Environment]
sphere = 1E+05  # cm
material = "G4_WATER"

[Environment.Source]
sphere = 1E+02  # cm
material = "G4_WATER"

[Environment.Source.Detector]
cylinder = { length = 5.1, radius = 2.55 }  # cm
material = "G4_SODIUM_IODIDE"
role = "record_deposits"
# file: run.py

import calzone

# Instanciate a simulation engine (using a TOML geometry).
# Requires installing `tomli` for Python < 3.11.
simulation = calzone.Simulation("geometry.toml")

# Generate primary particles.
source = simulation.geometry.find("Source")
energy = 1.0  # MeV
primaries = simulation.particles()  \
    .pid("gamma")                   \
    .energy(energy)                 \
    .inside(source)                 \
    .generate(1000)

# Run the simulation and fetch deposits.
detector = simulation.geometry.find("Detector")
deposits = simulation  \
    .run(primaries)    \
    .deposits[detector.path]

License

The Calzone source is distributed under the GNU LGPLv3 license. See the provided LICENSE and COPYING.LESSER files. Additionaly, Calzone uses software developed by Members of the Geant4 Collaboration, which is under a specific license.

Metadata

Release files for calzone 1.3.1

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

Source distribution (sdist)

Source distribution for calzone 1.3.1
File Size Uploaded Provenance Actions
calzone-1.3.1.tar.gz 125.5 kB With provenance Details for calzone-1.3.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for calzone 1.3.1
File Actions
calzone-1.3.1-cp37-abi3-win_arm64.whl CPython 3.7 abi3 Windows ARM64 Details for calzone-1.3.1-cp37-abi3-win_arm64.whl
calzone-1.3.1-cp37-abi3-win_amd64.whl CPython 3.7 abi3 Windows x86-64 Details for calzone-1.3.1-cp37-abi3-win_amd64.whl
calzone-1.3.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.7 abi3 Linux glibc 2.17+ x86-64 Details for calzone-1.3.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
calzone-1.3.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.7 abi3 Linux glibc 2.17+ ARM64 Details for calzone-1.3.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
calzone-1.3.1-cp37-abi3-macosx_11_0_x86_64.whl CPython 3.7 abi3 macOS 11.0+ x86-64 Details for calzone-1.3.1-cp37-abi3-macosx_11_0_x86_64.whl
calzone-1.3.1-cp37-abi3-macosx_11_0_arm64.whl CPython 3.7 abi3 macOS 11.0+ ARM64 Details for calzone-1.3.1-cp37-abi3-macosx_11_0_arm64.whl

Total release size: 112.4 MB

Release files / calzone-1.3.1.tar.gz

Download URL calzone-1.3.1.tar.gz
Size 125.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3d66df8148582065df5498a2aac3bb2198c0a2ccb6566b737bd72cf452f942f7
BLAKE2b-256 checksum
How to use checksums
d3c00a20da6dac4037fda871541739066a51dd3bed874bae835180b176996dad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / calzone-1.3.1-cp37-abi3-win_arm64.whl

Download URL calzone-1.3.1-cp37-abi3-win_arm64.whl
Size 17.4 MB
Tags CPython 3.7 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
ad71761102b8f2377119bc3f7a6d7077a90450d8e57edea18632687f13d354fe
BLAKE2b-256 checksum
How to use checksums
fab1212f3fef7f8e5217cbee90d86bdbc673bde5edb74237e7b3ab57aed9dff3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / calzone-1.3.1-cp37-abi3-win_amd64.whl

Download URL calzone-1.3.1-cp37-abi3-win_amd64.whl
Size 15.9 MB
Tags CPython 3.7 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
388f88cfd11fe567515e85c7351d1fb13cae68102bd6f726ce9c1799d2a47820
BLAKE2b-256 checksum
How to use checksums
91ad20af44f9146e8f04c4fa736a1762dd0a9cf5eb067b7cea4dffe24660ad11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / calzone-1.3.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL calzone-1.3.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 21.5 MB
Tags CPython 3.7 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
680b87df11d8cb22550e924f3992f563a2b6fe7e2fa84db0a9ef14cbf159b61e
BLAKE2b-256 checksum
How to use checksums
5933caecaed8f8a8c45a782615eebbea034ffaa966d8ed61c41e44149e1f4ff1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / calzone-1.3.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL calzone-1.3.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 20.6 MB
Tags CPython 3.7 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
be8d914dc05e9754f21f00f8306f07fd99cb4d1acce5f1bb492841e992b8c15a
BLAKE2b-256 checksum
How to use checksums
f36445d334b348e458f109f5221d3cfaa208ab5e9ff2299cbe43c27efef36a12
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / calzone-1.3.1-cp37-abi3-macosx_11_0_x86_64.whl

Download URL calzone-1.3.1-cp37-abi3-macosx_11_0_x86_64.whl
Size 19.3 MB
Tags CPython 3.7 abi3 macOS 11.0+ x86-64
SHA-256 checksum
How to use checksums
e70b691fc7279d24301813e0e643bc60fdc78f33ba809b5161b978a7a2b060a8
BLAKE2b-256 checksum
How to use checksums
960e7bee3d3946442ff40d44c3c7640e32288e436fb76f650e83ae2fe65716ae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / calzone-1.3.1-cp37-abi3-macosx_11_0_arm64.whl

Download URL calzone-1.3.1-cp37-abi3-macosx_11_0_arm64.whl
Size 17.5 MB
Tags CPython 3.7 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
a5ed9488ab851f1079727073316674952b304405eefe1d32eb9170c635f9e05c
BLAKE2b-256 checksum
How to use checksums
613f2309bab93092e3f6fc4351313d436b3e8f04ebda480e10bf6ee1ed720689
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for calzone 1.3.1

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.

Full provenance

All 7 files in this release have been uploaded with provenance metadata.

Select from 7 files

Attestation for calzone-1.3.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page