counterdex-models
Bounded numerical comparison of trusted, registered models. Compares models on the same reviewed observations, sweeps parameters, tests noise and detection-threshold assumptions, runs seeded Monte Carlo, and ranks a supplied finite measurement grid.
It is a separate, zero-dependency distribution from the exact checker. counterdex 0.3.0 is unchanged, does not import this package, and keeps its published artifacts and replay. Nothing here is a Counterdex certificate.
What a result can and cannot say:
- A lower AICc, a higher relative weight or a closer fit is relative support among the registered models under the stated noise assumption. It is not proof that a model is true.
- Monte Carlo selection frequencies hold only under the simulated truth, noise and threshold.
- Grid ranking orders only the supplied times for fixed parameter vectors. It is not a globally optimal design and not certified discrimination.
- Noise standard deviation, detection threshold and hard allowance are different inputs. Hard allowances are refused here (
hard_allowance_not_accepted); they belong to the exact checker.
Install
pip install counterdex-models
No runtime dependencies; Python 3.11 or newer. The exact checker is a separate package: pip install counterdex.
Run the demonstration
From a checkout of the repository:
python3.11 packages/counterdex_models/examples/demo.py
It uses the public synthetic examples public.single-exponential and public.two-exponential-mixture on readings drawn from a stated mixture (seeded, not real data), and shows:
- Early readings (≤ 4 h): the mixture fits more closely (χ² 2.05 vs 5.71), yet AICc prefers the single exponential, and the mixture's fast rate sits on its bound. The data really came from the mixture, so preference is not truth.
- Grid ranking of candidate later times between the two early fits: 8 h ranks first (0.92 noise SDs apart); times whose predictions fall below the 0.1 mg/L threshold score 0.
- Monte Carlo, 200 seeded replicates, if the stated mixture were true: the mixture is preferred in 9% of early-only designs and in 100% after adding one 8 h reading.
- All readings to 24 h: the mixture is preferred.
- Same readings, other assumptions: a noisier assay (SD 0.3 + 30%) or a 1.5 mg/L threshold flips the preference to the single exponential, so the result is reported as assumption-dependent.
- Sensitivity: which parameter drives the prediction at each time (A1 early, then k1, A2, and k2 late).
It runs in about 2 seconds with zero provider calls.
Command line and requests
cd packages/counterdex_models
python3.11 -m counterdex_models models
python3.11 -m counterdex_models run examples/requests/fit_early.request.json --output /tmp/fit.json
python3.11 -m counterdex_models --registry my_plasma_models:registry run my.request.json
Requests (counterdex-models.request.v1) are strict JSON: unknown fields are refused, models are named by registered id, and values may be numbers, decimal strings or exact n/d strings (rounded to binary64). analysis is one of fit, sensitivity, scenarios, monte_carlo or grid_ranking. See examples/requests/ for one of each. examples/build_examples.py regenerates all of them, and a test checks that the committed files match byte for byte.
Each result carries certification: "none", the inputs it used, the evaluation budget it consumed, an interpretation stating its limits, the runtime (package, Python, fit method, provider_calls: 0) and SHA-256 digests of the canonical request and result.
Adding models
See the interface contract and examples/registry_plugin.py. Models are Python code registered by the operator; request data can only name them.
Method and bounds
- Fitting (
bounded-lm-halton.v1): Levenberg–Marquardt on logistic-transformed coordinates, so every trial stays inside the declared bounds, from the bound midpoint plus a fixed Halton sequence. Gaussian likelihood with the stated noise SD; readings below a detection threshold contribute P(y < threshold). Reports parameters, predictions, residuals, standardized residuals, parameter count, parameters at bounds, local curvature standard errors (uncensored data only), χ², AIC, AICc and BIC. The best local optimum found is not guaranteed global. - Monte Carlo: each replicate uses its own Mersenne Twister stream seeded from
(seed, replicate), with Box–Muller normals, so runs are reproducible, and a stopped run's completed replicates equal a shorter run's. - Bounds: hard caps in
CAPS(8 models, 12 parameters, 512 observations, 64 starts, 500 iterations, 1,000 replicates, 256 grid times, 5,000,000 evaluated points, 120 s). The evaluation cap stops work deterministically; the wall clock is only a safety stop and is reported. - Determinism: identical requests give identical results on the same Python and platform math library. Results record the Python version.
Tests
python3.11 -m unittest discover -s packages/counterdex_models/tests
Besides behaviour, the tests check that the package imports neither counterdex nor any network module, and that the top-level counterdex source manifest still equals the one recorded in the 0.3.0 fixture bundle.
Metadata
Release files for counterdex-models 0.1.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 |
|---|---|---|---|---|
| counterdex_models-0.1.0.tar.gz | 30.2 kB | Without provenance | Details for counterdex_models-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| counterdex_models-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for counterdex_models-0.1.0-py3-none-any.whl |
Total release size: 55.6 kB
Release files / counterdex_models-0.1.0.tar.gz
| Download URL | counterdex_models-0.1.0.tar.gz |
|---|---|
| Size | 30.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e55909ba1ec605ec9098be940150226f1a234935777167edcac2d2d07acc7ac7
|
|
BLAKE2b-256 checksum How to use checksums |
714622cdbccc051f97c5c4367368d012ac637eca273f3362f4f550a263c8a4c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / counterdex_models-0.1.0-py3-none-any.whl
| Download URL | counterdex_models-0.1.0-py3-none-any.whl |
|---|---|
| Size | 25.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f5929df0504d9584ee180f86c9def9d7cfb1d29327b65d6703680cbf2fcf9f30
|
|
BLAKE2b-256 checksum How to use checksums |
e9df698c2a3750b44de1536256b36e16d034170db8c1f042e5d7a4d2d704054c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for counterdex-models 0.1.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.