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.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| calzone-1.3.0.tar.gz | 125.4 kB | With provenance | Details for calzone-1.3.0.tar.gz |
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| calzone-1.3.0-cp37-abi3-win_arm64.whl | CPython 3.7 | abi3 | Windows ARM64 | Details for calzone-1.3.0-cp37-abi3-win_arm64.whl |
| calzone-1.3.0-cp37-abi3-win_amd64.whl | CPython 3.7 | abi3 | Windows x86-64 | Details for calzone-1.3.0-cp37-abi3-win_amd64.whl |
| calzone-1.3.0-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.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
| calzone-1.3.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.7 | abi3 | Linux glibc 2.17+ ARM64 | Details for calzone-1.3.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
| calzone-1.3.0-cp37-abi3-macosx_11_0_x86_64.whl | CPython 3.7 | abi3 | macOS 11.0+ x86-64 | Details for calzone-1.3.0-cp37-abi3-macosx_11_0_x86_64.whl |
| calzone-1.3.0-cp37-abi3-macosx_11_0_arm64.whl | CPython 3.7 | abi3 | macOS 11.0+ ARM64 | Details for calzone-1.3.0-cp37-abi3-macosx_11_0_arm64.whl |
Total release size: 112.4 MB
Release files / calzone-1.3.0.tar.gz
| Download URL | calzone-1.3.0.tar.gz |
|---|---|
| Size | 125.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3d98ecbe58ed43945b952b12303d945dcf6f779140a3d8d21410a3f92394e04
|
|
BLAKE2b-256 checksum How to use checksums |
bb7dffed374d4f0b228087b8a26bb3bac8d83432ac5d1da86298db389cab548e
|
| 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 16, 2026.
Transparency logRelease files / calzone-1.3.0-cp37-abi3-win_arm64.whl
| Download URL | calzone-1.3.0-cp37-abi3-win_arm64.whl |
|---|---|
| Size | 17.4 MB |
| Tags | CPython 3.7 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
77b289c6b39119846867756995f28b74b165ecee597e988130ebb652b1f2c212
|
|
BLAKE2b-256 checksum How to use checksums |
0e0f3548c2e435e9d6ccb523faa0df34f71c42bc947e9470bb5d9455a6008caa
|
| 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 16, 2026.
Transparency logRelease files / calzone-1.3.0-cp37-abi3-win_amd64.whl
| Download URL | calzone-1.3.0-cp37-abi3-win_amd64.whl |
|---|---|
| Size | 15.9 MB |
| Tags | CPython 3.7 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
d3d5faddc6c7979dd1499e881d10ba9b566d88c6c3d53eea9f4cd6f458450dfd
|
|
BLAKE2b-256 checksum How to use checksums |
ad61a0d0304a4cfe4d3e3846cec2a0fbf96a2c6771f6f42b6207a5121c7993a5
|
| 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 16, 2026.
Transparency logRelease files / calzone-1.3.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | calzone-1.3.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 21.6 MB |
| Tags | CPython 3.7 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
d975945463cf1bbf89aeb5e55790fb44131a2a24000c1bd3a469a82ff1e25a83
|
|
BLAKE2b-256 checksum How to use checksums |
921ad6828ed6ed3128d2653203888d8aee1a19e056a443012ed365b4f8ce0527
|
| 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 16, 2026.
Transparency logRelease files / calzone-1.3.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | calzone-1.3.0-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 |
0354b711f285b6d207572dcc30d47d37a78f0be605ded3d003b83cb5c133b310
|
|
BLAKE2b-256 checksum How to use checksums |
4f09adb8e18e00f132ff00f92642c7619aa2e3bb4afa303516dada9bb95cc804
|
| 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 16, 2026.
Transparency logRelease files / calzone-1.3.0-cp37-abi3-macosx_11_0_x86_64.whl
| Download URL | calzone-1.3.0-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 |
35fdb905d2315b2bee56cd4792224388acce1850c781ffd5c968b43290409a22
|
|
BLAKE2b-256 checksum How to use checksums |
cb9655f2ad31ccfd60afeb276ca931bbe350edae297a132a0ce20c48e5c4769a
|
| 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 16, 2026.
Transparency logRelease files / calzone-1.3.0-cp37-abi3-macosx_11_0_arm64.whl
| Download URL | calzone-1.3.0-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 |
69aa187cd85120522d1dbc98b119eb9c3aafa064690570ba6a04ec218686e572
|
|
BLAKE2b-256 checksum How to use checksums |
6dabb0542f99ede38b7c96deedcf5dcb96cf9d5f9c36b3817a7c3f313449e698
|
| 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 16, 2026.
Transparency logSecurity for calzone 1.3.0
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.
Attestation for calzone-1.3.0.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 16, 2026.
Transparency logA 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.