Non-executable

viva-amici

viva-amici authors
v0.0.1MITOct 2026

Citation: No publication identified in inspected sources

A process-bigraph bridge that compiles Antimony or SBML models into AMICI per-model C++/SWIG extensions and integrates them with SUNDIALS CVODES, exposing time-stepped and one-shot simulation processes plus exponential-decay, Lotka-Volterra, and MAPK cascade composites.

How this model is classified mathematically and dynamically.

Formalism
Determinism
Deterministic
Time dynamics
Discrete
Spatial
Non-spatial
Multiscale
No

Organisms, entities and processes this model represents.

Organisms
Not recorded
Infectious agents
Not recorded
Health conditions
Not recorded
Biological processes
Molecular entities
Not recorded
Proteins / genes
Not recorded

The data this model consumes and produces when executed.

Parameters

NameDefaultUnitMeaning
interval0.5time unitPer-step integration window.
k0.2rate unitFirst-order decay rate constant.
alpha1.1rate unitPrey birth rate.
beta0.4rate unitPredation rate.
d_gain0.1rate unitPredator growth per prey eaten.
signal1dimensionless unitInput signal driving KKK activation.
k10.05rate unitActivation rate from signal to KKK.
k20.15rate unitActivation rate from KKK to KK.
k30.15rate unitActivation rate from KK to K.
rtol1e-8dimensionless unitCVODES relative tolerance.

Initial conditions

NameValueUnit
model state storesSpecies/state values supplied through the states port; examples include A=10, prey=10, predator=5, and KKK/KK/K=0.dimensionless unit

Outputs

NameQuantityUnitFormat
state trajectoriesPer-step state deltas emitted by AmiciProcess and collected by the RAMEmitter.Not recordedin-memory map
observablesDerived observable deltas such as predator/prey ratio, total population, downstream MAPK signal, and amplification.Not recordedin-memory map
demo reportSelf-contained HTML report containing Plotly time-series charts, architecture diagrams, and the PBG document tree.Not recordedHTML

Experiment protocol

The demo runs exponential decay for 20 time units, Lotka-Volterra for 40 time units, and MAPK cascade for 80 time units through fixed per-step intervals.

Timestep
0.5 time unit
Duration
40 time unit
Observables
statesobservables

Runtime environment, dependencies, and compute requirements.

Language
Python >=3.11
Environment
native

The first unique model source compiles a C++ extension and is reported as approximately 10 seconds in the README; later runs use the AMICI cache.

Compute requirements

CPU cores
1
GPU
Not required
Parallelism
single
Typical runtime
10 seconds

Dependencies

runtime
  • bigraph-schema >=0.0.60
  • process-bigraph >=0.0.66
  • amici >=1.0
  • antimony >=2.13
  • numpy
  • bigraph-viz >=2.0.3
  • pyyaml >=6.0
  • jsonschema >=4.21
  • jinja2 >=3.1
  • pypdf >=4.0
  • matplotlib
  • plotly
  • vivarium-workbench
  • ninja
optional
  • pytest
system
  • C/C++ compiler toolchain
  • SWIG
  • CMake
  • Ninja
  • BLAS/LAPACK
  • HDF5

Containers

  • docker (Dockerfile)

Entry points

  • python demo/demo_report.py

    Run the three AMICI-driven composite simulations and write the self-contained HTML demo report.

Tests

pytestpytest tests/

Artifacts stored with this model.

  • 240 B
  • 3.7 KB
  • 715 B
  • 1.6 KB
  • 14 KB
  • 3.2 KB
  • 6.4 KB
  • 718 KB
  • 1.0 KB

Identifiers and integrity.

Metadata review
Approved · 1da614bf-946a-4400-a0be-4fd0f1d00f74 · Oct 2026
Contacts
Related
  • Is derived from
    url:https://github.com/AMICI-dev/AMICI
External IDs
  • url:https://github.com/vivarium-collective/viva-amici
MISM — Multiscale Immune Systems Modeling

Multiscale Model Portal

Research reported on this website is supported by the National Institute of Allergy and Infectious Diseases (NIAID) of the National Institutes of Health under award number U54AI191253. The content is solely the responsibility of the authors and does not necessarily represent the official views of the National Institutes of Health.

© 2026 Multiscale Immune Systems Modeling. All rights reserved.

Privacy Policy