SolvSRK: Examples
Run journeys 01→06 in order. Each page below is a full walkthrough: what the scenario teaches, which APIs matter, the important code pattern, act-by-act narration, and commands to run locally.
Examples source: Journey scripts ship with the SolvSRK release bundle under
python/examples/journeys/. Release note: SolvSRK is a production (GA) release. Examples below match the shipped wheel and C library. Activate a trial or commercial license before running — see Install and Licensing.
What the journeys teach
You have a differential equation model — flight dynamics, reactor kinetics, battery thermal,
PK/PD — that is stiff (widely separated time scales) and noisy (sensor corruption or
non-smooth inputs). Standard BDF solvers (scipy, MATLAB ode15s, vanilla CVODE) Newton-iterate
against the noise: step size collapses, wall-clock blows, integration fails or misses real-time deadlines.
SolvSRK is a stiffness-adaptive integrator built for that regime. You supply an RHS function (and optional Jacobian); the library owns the integrator. Same numerical core in C and Python — no second engine.
UQ: the 30-day trial includes SolvSRK-UQ (emit_uq). After purchase, base
SolvSRK and SolvSRK-UQ are separate SKUs.
Journey index
| # | Journey | What you learn |
|---|---|---|
| 01 | First contact | Confirm the wheel, native libsolvsrk, license state, machine code, and the smallest successful integration (exponential … |
| 02 | Core path (Rössler) | The standard solvsrk.run() call pattern on a chaotic nonlinear ODE, using SolvScout-tuned config when available. |
| 03 | Stiff chemistry (Robertson) | Integrate stiff Robertson kinetics with analytic Jacobian, non-negativity, and mass-conservation wrappers — the producti… |
| 04 | Configuration and SolvScout hand-off | Why config_defaults() is a learning baseline only, how SolvScout recommend_product → run_profile works, and how to tight… |
| 05 | Diagnostics | Read the full integration receipt, export trajectory history to CSV, and enable terminal UQ envelopes when licensed. |
| 06 | Limits | When SolvSRK is the right tool, how it compares to SciPy RK45 on stiff problems, linear Talbot routing via profile token… |
Start with Journey 01 if this is your first install.
Set SOLVSRK_QUIET=1 only when you want silent CLI runs (no narration).
Licensed capabilities on the same wheel
SolvSRK, SolvSRK-Edge, and SolvSRK-UQ share the solvsrk Python package and the
python/examples/journeys/ scripts. Edge and UQ are seat entitlements (features: edge
or features: uq), not separate products:
| Edition | Docs | Journey focus |
|---|---|---|
| Base SolvSRK | Overview | All journeys below |
| SolvSRK-Edge | Edge examples hub | Same journeys — deploy cross-compiled libsolvsrk |
| SolvSRK-UQ | UQ examples hub | Start at 05 Diagnostics |
Example bundle
Every journey is a domain scenario with narrated acts — run the guided tour first to see what each number means, then copy the production one-liner into your pipeline.
| Resource | Purpose |
|---|---|
PROGRESSION.md | Core runbook — journeys 01→06 with dual commands |
SKU_PROGRESSION.md | Vertical SKU runbook — Grid, Pricing, Control, Climate, Thermal, Specialty |
COVERAGE.md | Capability matrix — which APIs each journey exercises |
APPLICATIONS.md | Where the product applies in real programs |
run_examples.py | Interactive menu for core journeys |
run_sku_examples.py | Interactive menu for vertical SKU walkthroughs |
Guided journeys
| # | Script | Scenario |
|---|---|---|
| 01 | 01_first_contact.py | Version, license, and the smallest successful solve |
| 02 | 02_core_path.py | Rössler attractor |
| 03 | 03_stiff_chemistry.py | Robertson kinetics |
| 04 | 04_configuration.py | SolvScout tunes; SolvSRK integrates |
| 05 | 05_diagnostics.py | Every field in the result dict, plus UQ (Robertson) |
| 06 | 06_limits.py | What SolvSRK is for — and what it will not do for you |
Run from the python/ directory after install and license activation.
Set SOLVSRK_QUIET=1 only when you want silent CLI runs (no narration).