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.0

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.0
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)

Table of built distributions (wheels) for calzone 1.3.0
File Actions
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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Security 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.

Select from 7 files

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 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