SciNumTools3 for Python
Unit-safe quantities, runtime expressions, and validated scientific parameters for Python.
SciNumTools3 helps eliminate hidden assumptions in scientific software by providing:
- ✅ Physical quantities with units
- ✅ Automatic unit conversion
- ✅ Runtime expression evaluation
- ✅ Validated input parameters
- ✅ Structured scientific configuration files
- ✅ Consistent parameter handling across simulation and analysis workflows
Relationship to the C++ Core
scinumtools3 is the official Python binding for the SciNumTools3 C++ project.
The Python package exposes the same core concepts used by the C++ implementation, including:
- Physical Units & Quantities (PUQ)
- Dimensional Input Parameters (DIP)
- Runtime expression evaluation
- Unit-aware validation and conversion
This enables consistent parameter definitions and unit handling across Python analysis workflows and C++ simulation codebases.
C++ Project
The underlying C++ implementation is available on GitHub:
https://github.com/vrtulka23/scinumtools3
The C++ project serves as the reference implementation and provides high-performance support for scientific computing, numerical simulations, and HPC workflows.
Installation
Install directly from PyPI:
pip install scinumtools3
PyPI package:
https://pypi.org/project/scinumtools3/
Why SciNumTools3?
Scientific workflows frequently suffer from:
- inconsistent unit handling
- manual conversion mistakes
- duplicated parameter definitions
- missing validation
- configuration drift between simulation and analysis code
SciNumTools3 provides a unified framework for defining, validating, and evaluating scientific parameters while preserving physical units throughout calculations.
Core Features
Physical Quantities
Create quantities with physical units and perform automatic conversions:
from scinumtools3.puq import Quantity
length = Quantity("1*m")
length = length.convert("km")
print(length)
# 1e-3*km
Unit-Aware Arithmetic
from scinumtools3.puq import Quantity
distance = Quantity("1000*m")
time = Quantity("100*s")
velocity = distance / time
print(velocity)
# 10*m*s-1
Validated Parameters (DIP)
Define scientific parameters with units, constraints, and dependencies.
from scinumtools3.dip import DIP
dip = DIP()
dip.add_string("temperature float = 300 K")
dip.add_string("pressure float = 1 atm")
env = dip.parse()
Example parameter specification:
simulation
timestep float = 0.5 fs
!condition ({.} > 0.0 fs)
temperature float = 300 K
!condition ({.} > 0 K)
pressure float = 1 atm
steps int = 1000000
!condition ({.} > 1)
duration float = ( {?simulation.timestep} * {?simulation.steps} )
ensemble string = "NPT"
!options ["NVE", "NVT", "NPT"]
Domain-Specific Languages
SciNumTools3 is built around two scientific DSLs.
PUEL — Physical Units Expression Language
A concise language for representing physical quantities, units, dimensions, uncertainties, and arrays.
Examples:
ESU_erg
m2*kg*s-2
kg2*ms3:2*cm
1.346591(30)e27*kg
[2,3,4,5]*km
PUEL powers:
- quantity parsing
- dimensional analysis
- unit conversions
- unit-aware calculations
DIPL — Dimensional Input Parameter Language
A declarative language for defining scientific parameters with:
- types
- units
- constraints
- dependencies
- validation rules
This allows scientific applications to maintain a single source of truth for configuration and input validation.
Quick Example
from scinumtools3.puq import Quantity
from scinumtools3.dip import DIP
# Unit conversion
length = Quantity("1*m")
length = length.convert("km")
print(length)
# 1e-3*km
# Validated parameters
dip = DIP()
dip.add_string("foo int m")
dip.add_string("foo = 3 km")
env = dip.parse()
print(env.nodes[0])
# 3000 m
Documentation
Full documentation, API reference, language specifications, and examples:
https://vrtulka23.github.io/scinumtools3/
Documentation includes:
- Python API reference
- PUEL specification
- DIPL specification
- Tutorials and examples
Typical Use Cases
- Scientific computing
- Physics simulations
- Engineering applications
- Data analysis pipelines
- Research software
- Hybrid Python/C++ workflows
- Unit-safe parameter management
Contributing
Contributions are welcome.
git clone https://github.com/vrtulka23/scinumtools3.git
cd scinumtools3
Please open an issue or pull request for bug fixes, improvements, or new features.
License
SciNumTools3 is released under the MIT License.
See the LICENSE file for details.
Links
1 maintainer
Release files for scinumtools3 0.8.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 | |
|---|---|---|---|
| scinumtools3-0.8.0.tar.gz | 642.2 kB | Details |
Built distributions (wheels)
Total release size: 306.4 MB
Release files / scinumtools3-0.8.0.tar.gz
| Download URL | scinumtools3-0.8.0.tar.gz |
|---|---|
| Size | 642.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d4ba720c6af4aabd16b7d911366452cefe35861f14bf1eff260152052bc33963
|
|
BLAKE2b-256 checksum How to use checksums |
af1c2268bb57d2ac65055fd52f579f4cd0750854474dca5e28d72cbcd25a9fa9
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp313-cp313-win_amd64.whl
| Download URL | scinumtools3-0.8.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 32.1 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d05c80835058ad04ab531eb72848143fd22e682520677418a3f2e90591959b47
|
|
BLAKE2b-256 checksum How to use checksums |
5e94bf1bbaf8916022729176ad0c71d3c5b209e03421426a2771e301ad4f42e2
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp313-cp313-musllinux_1_2_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp313-cp313-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 17.0 MB |
| Tags | CPython 3.13 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
5ba12d7fed31d34dec2caddb2e92e3459a38cdc1bec42bbdcf0ef28291758873
|
|
BLAKE2b-256 checksum How to use checksums |
0c0313829aede40d6c81712e5498f926b868755b30f7f8ab9ec292ff6a57aef2
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.7 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
b484045d221e4145b10bd60a86b994bdefbd3c84b4158a6aa70f0b3154a35f49
|
|
BLAKE2b-256 checksum How to use checksums |
550aeec6a1e608f336f8c0a7e3a773d1b039a35b20e7f9015e736d8a9cfc16eb
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | scinumtools3-0.8.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 11.6 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5821955e1a11dbfaa55790969cabad1ab6c7d73f59784dda1efc28d7b5202a24
|
|
BLAKE2b-256 checksum How to use checksums |
5f6677f3b9f3c1f4cd62ecfc9efdb0300ffbd61a24618c1323d34a48cc0503aa
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp312-cp312-win_amd64.whl
| Download URL | scinumtools3-0.8.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 32.1 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3424f7ea5530733329795d0d5f871595af3901f262cd291c2290189e7b0ac835
|
|
BLAKE2b-256 checksum How to use checksums |
5614b19a79e355f7def095d74e4e2edf6c10352e6e168c1996f94787ab34b92f
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp312-cp312-musllinux_1_2_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp312-cp312-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 17.0 MB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
623f26a705a4ddb2a10871f6645ea0aa0c1a6193630b8b5d614827b113de10ac
|
|
BLAKE2b-256 checksum How to use checksums |
5647dde2220a82ec9177da6c866660991d368a6f031acf007d7aa28190603fb3
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.7 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
bf0d7cdf3234273d69ef8536e64427179b2e226b17f9321f9bbe7df85dc0ebf7
|
|
BLAKE2b-256 checksum How to use checksums |
de876a52135379526e17226bad3e034a5cb6e75d9047cd4ff58d576420b09cb4
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | scinumtools3-0.8.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 11.6 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3b1f0bd17d4407c3aabbefc0ef5acf31dbfde9473dd7862122828792c9288c1f
|
|
BLAKE2b-256 checksum How to use checksums |
346eeea0a7d78d318b23151a719b194db702c95c49dfa165fdef283c70846bd4
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp311-cp311-win_amd64.whl
| Download URL | scinumtools3-0.8.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 32.1 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c4e2b118817bcb180f8f0d5944debbd2dc3b67f6b32a87a97cf038f706b47d49
|
|
BLAKE2b-256 checksum How to use checksums |
c5792cd5fb14b8c734947546096e6724cc2f16badc9e33d88c03bf8fb2026d19
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp311-cp311-musllinux_1_2_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp311-cp311-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 17.0 MB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
796ba9690f9827a3e3e4e1da515ac36ffa3f49e18d79b8262332187fdae94034
|
|
BLAKE2b-256 checksum How to use checksums |
d1a53e5bb200035749c664191a241ccffe8005f334adff1b9971f0d56477ccc1
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.7 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
3269602349020bb99cbc114d9321153691231f9812cd2214b602fb864b7cf951
|
|
BLAKE2b-256 checksum How to use checksums |
b44f8017e6c56cc5992e48c4f684b548c85d257a6c287702db72887e18d9672f
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | scinumtools3-0.8.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 11.6 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
371d9ae473ca0f597ac8488365e9cb2523e81afc773774b63844e602713141cb
|
|
BLAKE2b-256 checksum How to use checksums |
d324dd49220f55140e2ae39c349240457052e9f5db9123aa4d3092a8fc9d44df
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp310-cp310-win_amd64.whl
| Download URL | scinumtools3-0.8.0-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 32.1 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f76ea40711f1680de4f36e64bb77a9ead9d6a03b5606e94bef8ecd9498dc7843
|
|
BLAKE2b-256 checksum How to use checksums |
88d6006a48c55b12dd2997c2dc58c6f83ab6db1f849780e5f881fe06c3152fd5
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp310-cp310-musllinux_1_2_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp310-cp310-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 17.0 MB |
| Tags | CPython 3.10 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
e458f3da621cafd9fe9c0fb17fedcb96dc88bcbdb199f8c2b24191ad9031638d
|
|
BLAKE2b-256 checksum How to use checksums |
772482349e83b53b398e1b95f3b1e6e208429d583f5626eace09f57725cae350
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | scinumtools3-0.8.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.7 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
fa1b69971b1df3a2ca3a85a79683e61af90cdbaa9ce04c02fa1077afc8fa3da3
|
|
BLAKE2b-256 checksum How to use checksums |
80858f84224b3cbd0a527c96dff00bbb72b185450f9bf96fb7d6fee18a02a93c
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency logRelease files / scinumtools3-0.8.0-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | scinumtools3-0.8.0-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 11.6 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f0565ab9868159912f8916f3a4212801ba014fe6980c34567248eab96c326b4e
|
|
BLAKE2b-256 checksum How to use checksums |
922e98c2187185c5f372e44c09b747aaed2f68d17a234442e9691e736f22ecb1
|
| Upload date | |
|
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.
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 Sep 16, 2026.
Transparency log
