stochas: Smart Data Orchestration
stochas is a Python framework built to handle the complexity of Monte Carlo simulations, parametric studies, and probabilistic modeling.
It provides a robust bridge between abstract statistical rules and concrete simulation data, ensuring your experiments are repeatable, traceable, and easy to manage.
Installation
Install the package via your preferred manager:
uv add stochas
or with pip:
pip install stochas
Core Features
- Salted Seeding: Combines Global Seeds, Parameter Names, and Trial Numbers for unique but deterministic draws.
- Numeric Mixins: Use your data containers directly in math operations (
container * 5.0) without manually extracting values. - Nominal Support: Easily toggle between "Perfect World" (Trial 0) and "Probabilistic World" (Monte Carlo) results.
- Pydantic Foundation: Every component is a Pydantic model, providing out-of-the-box validation and effortless JSON serialization.
- Unit System: Declare SI, IPS, FPS, or a custom unit system once and tag distributions with
unit=u.inch, sampling paths convert values automatically so your input data stays in familiar units while the simulation receives physically consistent numbers.
Why use stochas?
Managing hundreds of simulation trials can quickly become a mess of manual seeds and inconsistent data. stochas solves this by providing:
- Repeatable Randomness: Our "Salted Seed" logic ensures that any specific trial can be perfectly recreated, even years later, by tying randomness to simple to set and store values.
- Smart Containers:
NamedValueobjects behave like numbers or arrays but protect your data from accidental overwrites using a state-machine logic. - Physics-Ready Distributions: A wide range of built-in distributions (Normal, Truncated Normal, Log-Normal, etc.) that handle their own random number generators internally.
- Automatic Unit Conversion: Attach a
UnitDescriptorto any distribution or design variable and letStochasBasemultiply the conversion factor at sampling time (without manual scaling in generator code). - Serialized Registries: Automatically track exactly which "rules" (
Distributions) and "results" (NamedValues) were used in every trial for easy export to JSON or databases.
1 maintainer
Metadata
1 maintainer
Release files for stochas 2.2.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| stochas-2.2.6.tar.gz | 2.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| stochas-2.2.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.6 MB
Release files / stochas-2.2.6.tar.gz
| Download URL | stochas-2.2.6.tar.gz |
|---|---|
| Size | 2.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e3219add9859ca4c625d26f044cc0ad65a50a029ba80dbd71803fee5fa64eba9
|
|
BLAKE2b-256 checksum How to use checksums |
1814142b1e9d7d7bb3959abddecca9f8784c3ee164ea2d4f2e9f66a58f10e544
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / stochas-2.2.6-py3-none-any.whl
| Download URL | stochas-2.2.6-py3-none-any.whl |
|---|---|
| Size | 47.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1c7416f9eaa54aa1a6b16aab48483ffa4e4f4ba34a6381c27dc316b2c05e81be
|
|
BLAKE2b-256 checksum How to use checksums |
3bac846d95c980976ebde7ad3528a1dab6ba9e802fb79d1e295473e5d0891deb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
