Python bindings for SpecUtils using nanobind and scikit-build

These details have been verified by PyPI

Project links

Homepage

GitHub Statistics

Maintainers

wcjohns

These details have not been verified by PyPI

Project description

Gamma Spectrum file utilities

SpecUtils is a library for reading, manipulating, and exporting spectrum files produced by RadioIsotope Identification Devices (RIIDs), Radiation Portal Monitors (RPMs), radiation search systems, Personal Radiation Detectors (PRDs), and many laboratory detection systems. It opens N42 (2006 and 2012 formats), SPE, SPC, CSV, TXT, PCF, DAT, and many more files; altogether much more than a 100 file format variants. This library lets you either programmatically access and/or modify the parsed information, or you can save it to any of 13 different formats, or create spectrum files from scratch.

This package is a Python wrapper around the C++ SpecUtils library, with the bindings created using nanobind. SpecUtils is primarily developed as part of InterSpec, but is also used by Cambio, and a number of other projects.

An example use is:

import SpecUtils

# Create a SpecFile object
spec = SpecUtils.SpecFile()

# Load a spectrum file
spec.loadFile("spectrum_file.n42", SpecUtils.ParserType.Auto)

# Get list of all individual records in the spectrum file
meass = spec.measurements() 
print( "There are", len(meass), "spectrum records." )

# Get first measurement
meas = meass[0]

# Get gamma counts, and the lower energy of each channel
counts = meas.gammaCounts()
energies = meas.channelEnergies()

# Get neutron counts
neutrons = meas.neutronCountsSum()

# Get start time
startime = meas.startTime()

# Print out CSV information of energies and counts
print( "StartTime: ", startime )
print( "Neutron counts: ", neutrons, "\n" )
print( "Energy (keV), Counts" )
for i in range(len(counts)):
    print( f"{energies[i]},{counts[i]}" )

For further examples, see the examples directory. To run the examples, run the following commands:

python test_python.py
python make_file_example.py
python make_html_plot.py /some/path/to/a/file.n42

Installation

You can install the package using pip like this:

mkdir my_venv
python -m venv my_venv

source my_venv/bin/activate
pip install SandiaSpecUtils

python
>>> import SpecUtils
>>> spec = SpecUtils.SpecFile()
>>> ...

Or instead, you can compile from source yourself, with something like:

git clone https://github.com/sandialabs/SpecUtils.git SpecUtils

# Optionsally make/use a virtual environment
mkdir my_venv
python3 -m venv my_venv
source my_venv/bin/activate  # Windows PowerShell: .\my_venv\Scripts\Activate.ps1

# Compile and install the bindings
pip install --use-feature=in-tree-build SpecUtils/bindings/python

# Use the package
python
>>> import SpecUtils

Support

Please create an issue on the SpecUtils GitHub repository, or email InterSpec@sandia.gov if you have any questions or problems.

Project details

These details have been verified by PyPI

Project links

Homepage

GitHub Statistics

Maintainers

wcjohns

These details have not been verified by PyPI

Release history Release notifications | RSS feed

This version

0.0.10

Feb 10, 2026

0.0.9

Oct 2, 2025

0.0.7

Sep 26, 2025

0.0.6

Jul 1, 2025

0.0.5

Jul 1, 2025

0.0.4

Mar 11, 2025

0.0.3

Mar 10, 2025

0.0.2

Dec 18, 2024

0.0.1

Dec 17, 2024

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sandiaspecutils-0.0.10.tar.gz (550.7 kB view details)

Uploaded Feb 10, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sandiaspecutils-0.0.10-pp311-pypy311_pp73-win_amd64.whl (915.7 kB view details)

Uploaded Feb 10, 2026 PyPyWindows x86-64

sandiaspecutils-0.0.10-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded Feb 10, 2026 PyPymanylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sandiaspecutils-0.0.10-cp314-cp314t-win_amd64.whl (950.5 kB view details)

Uploaded Feb 10, 2026 CPython 3.14tWindows x86-64

sandiaspecutils-0.0.10-cp314-cp314t-win32.whl (870.8 kB view details)

Uploaded Feb 10, 2026 CPython 3.14tWindows x86

sandiaspecutils-0.0.10-cp314-cp314t-musllinux_1_2_x86_64.whl (1.8 MB view details)

Uploaded Feb 10, 2026 CPython 3.14tmusllinux: musl 1.2+ x86-64

sandiaspecutils-0.0.10-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.14tmanylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sandiaspecutils-0.0.10-cp314-cp314t-macosx_10_15_universal2.whl (2.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.14tmacOS 10.15+ universal2 (ARM64, x86-64)

sandiaspecutils-0.0.10-cp312-abi3-win_amd64.whl (916.5 kB view details)

Uploaded Feb 10, 2026 CPython 3.12+Windows x86-64

sandiaspecutils-0.0.10-cp312-abi3-win32.whl (848.7 kB view details)

Uploaded Feb 10, 2026 CPython 3.12+Windows x86

sandiaspecutils-0.0.10-cp312-abi3-musllinux_1_2_x86_64.whl (1.8 MB view details)

Uploaded Feb 10, 2026 CPython 3.12+musllinux: musl 1.2+ x86-64

sandiaspecutils-0.0.10-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.12+manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sandiaspecutils-0.0.10-cp312-abi3-macosx_10_14_universal2.whl (2.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.12+macOS 10.14+ universal2 (ARM64, x86-64)

sandiaspecutils-0.0.10-cp311-cp311-win_amd64.whl (917.3 kB view details)

Uploaded Feb 10, 2026 CPython 3.11Windows x86-64

sandiaspecutils-0.0.10-cp311-cp311-win32.whl (849.4 kB view details)

Uploaded Feb 10, 2026 CPython 3.11Windows x86

sandiaspecutils-0.0.10-cp311-cp311-musllinux_1_2_x86_64.whl (1.8 MB view details)

Uploaded Feb 10, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

sandiaspecutils-0.0.10-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sandiaspecutils-0.0.10-cp311-cp311-macosx_10_14_universal2.whl (2.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.11macOS 10.14+ universal2 (ARM64, x86-64)

sandiaspecutils-0.0.10-cp310-cp310-win_amd64.whl (917.2 kB view details)

Uploaded Feb 10, 2026 CPython 3.10Windows x86-64

sandiaspecutils-0.0.10-cp310-cp310-win32.whl (849.3 kB view details)

Uploaded Feb 10, 2026 CPython 3.10Windows x86

sandiaspecutils-0.0.10-cp310-cp310-musllinux_1_2_x86_64.whl (1.8 MB view details)

Uploaded Feb 10, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

sandiaspecutils-0.0.10-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sandiaspecutils-0.0.10-cp310-cp310-macosx_10_14_universal2.whl (2.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.10macOS 10.14+ universal2 (ARM64, x86-64)

sandiaspecutils-0.0.10-cp39-cp39-win_amd64.whl (917.6 kB view details)

Uploaded Feb 10, 2026 CPython 3.9Windows x86-64

sandiaspecutils-0.0.10-cp39-cp39-win32.whl (849.5 kB view details)

Uploaded Feb 10, 2026 CPython 3.9Windows x86

sandiaspecutils-0.0.10-cp39-cp39-musllinux_1_2_x86_64.whl (1.8 MB view details)

Uploaded Feb 10, 2026 CPython 3.9musllinux: musl 1.2+ x86-64

sandiaspecutils-0.0.10-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.9manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sandiaspecutils-0.0.10-cp39-cp39-macosx_10_14_universal2.whl (2.3 MB view details)

Uploaded Feb 10, 2026 CPython 3.9macOS 10.14+ universal2 (ARM64, x86-64)

File details

Details for the file sandiaspecutils-0.0.10.tar.gz.

File metadata

Download URL: sandiaspecutils-0.0.10.tar.gz
Upload date: Feb 10, 2026
Size: 550.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sandiaspecutils-0.0.10.tar.gz
Algorithm	Hash digest
SHA256	`3256a9c84541d7e6ce45c455ae98ed390358e832507578f490be26506d6e213f`
MD5	`e0359911ca2d16d2b897ac941c87c44d`
BLAKE2b-256	`344372fde65f2c405fc5f662d04057fabc93c7d1689ca02b98f68c3ae607bac5`

Algorithm	Hash digest
SHA256	`1860edf45c4b9588cdebfbf8c38615b87320e70201ad1fad9cf393b65bcc408a`
MD5	`53021d2bc98c71d9bbb2fa70055dd11e`
BLAKE2b-256	`f717777ee87046cf547f1e39a66d34ed109954111941858a3aa514d23e150ed2`

Algorithm	Hash digest
SHA256	`396581bdc292fe3c272cfe1b80537d786e7ae6db016dabb44ba0ef4c854cf1a3`
MD5	`4a88f9802d98f5409dd0bbf8310c1b53`
BLAKE2b-256	`5d73c0b29f0d2c7fb79eb249db53a8aec938011d7339991676e45c506cc76ee0`

Algorithm	Hash digest
SHA256	`4ebb12eed5819194d06574d3aba7fa1c8457202b3b7aa83c55af5efb868efdb8`
MD5	`d180559bb220c56e51168fc0a2653346`
BLAKE2b-256	`ed731f15b2891d6aa5018fc36f9fdde4d0061fc90ff7fffbf32273fe5cd8fa63`

Algorithm	Hash digest
SHA256	`84de68886087ce0e8d7ef26983dc729e94faf7910a678bab81a3348f92301174`
MD5	`ba17c96c88c1497b274a77461a581381`
BLAKE2b-256	`8a13b2efd01d087db0c15e0cb6b5be6fa812fb7b6391c55424fbc4746eba73f4`

Algorithm	Hash digest
SHA256	`573d3cd5486b58d1fdefd0eb0b19686e4b60e6dd12df1ddf59a84e27b6a5fb71`
MD5	`5b3888ecab0604915338eaceb397e2bd`
BLAKE2b-256	`fdbc5806f09152154e22d8736832b80afcd5bb33764331272d69080d40157e7b`

Algorithm	Hash digest
SHA256	`8a80e72320f075f012a2e9d9df555954fa55baf65546c6e454dfae93210f556a`
MD5	`408c3b7b457215af13a120c9456caf60`
BLAKE2b-256	`b0ae134844e250821c76fc13cd1c3463edf012d638074e909f8e6c03c4cf0b70`

Algorithm	Hash digest
SHA256	`b8be57cf34c7c7297df1726c60d31807dce1e19c4554f4084a4b5be0e5c87076`
MD5	`c38ef3b05faa94f8ca786a4e493afc13`
BLAKE2b-256	`e900f6f97c9d077a17ca77e3d5adc379279d66353544f27705f25d4ec81a6fb4`

Algorithm	Hash digest
SHA256	`6e85b3204843e71089a5dbaff74fb0a9cbdc69007be167a7eb40f1513aad28f2`
MD5	`225d05a9c5aa42cc0d164b53496c66f0`
BLAKE2b-256	`3c1ff19b247024688fa264b76f42d3c9343bcd4e7daf2ad48d41aa194f7ff584`

Algorithm	Hash digest
SHA256	`d3fe1519818894ce9031f9f3cb25b551a17cb00b0086c51d1b50ae60fe43a86e`
MD5	`98a411918a7b337976603d5672c75849`
BLAKE2b-256	`6fc5afaa7200a57a210d062cdbc46e3dd580cf4cb6db8b24f2e3324074f5d92b`

Algorithm	Hash digest
SHA256	`cb773b222c170f295bdcc0ac940d2370fe2e7e9a60d33e92e3e8c3dc3d4cf631`
MD5	`36099982c6d060cb76532a616011a1e8`
BLAKE2b-256	`568bb19ed6b234a6bb20b1dbc562ea5bd8cacf8bb26def547c270acd7e666153`

Algorithm	Hash digest
SHA256	`542102e8f5d369f79096977d70e495208a526e4545a37347c171e218cd6b5ec5`
MD5	`1bb569a678fca34572ee12380f350b94`
BLAKE2b-256	`19571e7c6fde441ac5604c498bff4313109fcc40f5211583a3963f22095ccb17`

Algorithm	Hash digest
SHA256	`761b53779ce04b22346528f30ffbe7af714f3a2714ecbcbee60f1c61a81ed914`
MD5	`31b426bfb15c8d4160a2e0531a8fe2bf`
BLAKE2b-256	`96369cb4efd3c8ba8e7fa0619f83c22d4031e7e32f39b4e7310605fc2c9a6564`

Algorithm	Hash digest
SHA256	`f23e888adbe20c212f7bbfe477a70ffb22197c4d7ed6809d57a95d321eacba54`
MD5	`eed027a6ad04b6a71de58badcd52c5c4`
BLAKE2b-256	`0285a2044075db822cb19e2933e0c36e0c4f8da0e84ea214adcba5ad818a0258`

Algorithm	Hash digest
SHA256	`5e10b40f50ad48b20b8312d8cce8c9cd91a0d461f36d449e758cefe5663d95cd`
MD5	`4915d0da95c66f13848944440ccadf82`
BLAKE2b-256	`b26942790f3f00ad5b9abf6b6a77d334df7e60703afb8e717228718a64f7ce68`

Algorithm	Hash digest
SHA256	`8615ed93577c97b8e4c7b8e368a02274b3859e0ebd86ad8ca97bcf8f871f697c`
MD5	`f0e9165e46f92ff3b7ca179dfb222d86`
BLAKE2b-256	`e1c633039bbf262507d27d03abbe47be6ae188733151c95284c46f13f9f9016c`

Algorithm	Hash digest
SHA256	`511ec8c848a32bf6307e2dcce58aa68aa3cc49d16a5af4ce614202b03ff50a1f`
MD5	`71d07e81d4a7708c8eb7b673476e2d73`
BLAKE2b-256	`175a44bb4c3df62720bb2fe86ab4c8f12b1b9d39060133afc5c1663b431fc478`

Algorithm	Hash digest
SHA256	`6e006c3a31c01f27c99d388992159e421d6b65e9989f86f105e17c361143b9fe`
MD5	`257dc1f1aa36ce0904fb129b60c93bf7`
BLAKE2b-256	`fc91a7272def939fba47e851d9a28e8641f8dd849a37de6280404a4796e8239e`

Algorithm	Hash digest
SHA256	`d483042fc60fb7067b9327b2f8f01a77abc098c7a26047d26f28b091a38408bf`
MD5	`a846a6e358f7a8e04891ad25dcc28c2e`
BLAKE2b-256	`eff6672ba470dd716e846aac1ff3b7e9a0931ce562cfac734f7fa655288c9f65`

Algorithm	Hash digest
SHA256	`0a304c92bab4ab3634b6f44e8258443296d2c218633cc1d590cd8aca541c2c8e`
MD5	`4e3c10ee01c08e149cc23a73df1090cb`
BLAKE2b-256	`20ab76dc2aaa571aca2e311c838b3cae5f7dba3f5045b43ebd30aadb9e40d563`

Algorithm	Hash digest
SHA256	`1c160cb6680f6ecb27414db60cdaf8116100e65e5632af0de911411a943c6556`
MD5	`fd71dbf29372f4eb0c4f4ffbfd45d9ee`
BLAKE2b-256	`2bc30748421bf3ef00af2514da2aa2c0ce722a0389684428394847a56c11f69a`

SandiaSpecUtils 0.0.10

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

Gamma Spectrum file utilities

Installation

Support

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Algorithm	Hash digest
SHA256	`a4b465ce212d958b77a886e64da8600c093c3f11cee5615d2549bfe167b5854f`
MD5	`aaaf64c67c8206e6ec000295596073a9`
BLAKE2b-256	`4527e6795b418ad866e0ef04567a1205e478aafddeb88dc01b246b9561a90bd1`

Algorithm	Hash digest
SHA256	`ce26ce835dc44ed4e34af60f89f5005836effb441c76046aae17eeacd9297870`
MD5	`cf144ec2909c141b8b4ecb6d028fffe6`
BLAKE2b-256	`de481f27d5facbbf2f5bb6f077e31e0a87b5dac2be2aaa4ad4d5dd7d9a216cf8`

Algorithm	Hash digest
SHA256	`76deb8268f7e74ce793b44e1747d8209d447476ff9a001975b39979dfbface95`
MD5	`65dfc1e0e0e7840af4b0550a8506e2e5`
BLAKE2b-256	`b6ebc5e1de53d265de7fc3aba110c39679be3ac343c4702919cee51bc8564c29`

Algorithm	Hash digest
SHA256	`dcb624f4f42a49e48bf51650d5bfa6efd863dd072d778c3864ad0597ed741b9f`
MD5	`d841b1878d5e344335bc252bf32ef3be`
BLAKE2b-256	`e94885cb2d0ee4098e6194e480dd7076ecf5f79a8b8c9ad657a2dfdb5a8377b8`

Algorithm	Hash digest
SHA256	`5ce335bedde9c65092031079e96625cc54e620c109214b9332a66805785ca465`
MD5	`f692b8cbf91074a85dcfe9c783547f62`
BLAKE2b-256	`bcdc5c966bbdb02e913670db9fdc67eeb3864cce836d6565c9729fad1b610b97`

Algorithm	Hash digest
SHA256	`605ad3f6b2a48eadf1badb42bd4817bceba6fa13f68bd8773dff2d1cf4bbf16f`
MD5	`cb7e88971edf034337047bf9004fbbb1`
BLAKE2b-256	`2f6006ce63608440a98e2a09c935ce9fb620ad5a0079940612c0523a5df9b749`

Algorithm	Hash digest
SHA256	`7542564e0eddaa139f279414167048782c65a5346fb7122f61cc0db6ee1c750c`
MD5	`7dcd615dbde9f8fef4dc5ad70732f56e`
BLAKE2b-256	`d406f84bc99b7cb6e1f4456feb5b502f1d2be548c336b9523697616d818fdc3d`