Skip to main content

pyvcell

Release Build status codecov Commit activity License

This is the python wrapper for vcell modeling and simulation for

  1. local scripting of spatial modeling, simulation, data analysis and visualization workflows using Virtual Cell technology
  2. access to Virtual Cell remote APIs - with public access or as an authenticated Virtual Cell user.

Local simulation, analysis and visualization with pyvcell

download or create new spatial models

  • load/save VCML (Virtual Cell’s native format - import/export to VCell UI)
  • load/save SBML (Systems Biology Markup Language)
  • load from Antimony (friendly textual language for SBML)
  • create/edit any VCML object (e.g. species, model, geometry) programmatically

local editing with Python objects

  • edit parameters. add/remove/edit species, compartments, reactions, initial conditions, diffusion coefficients
  • create/edit geometry objects, create/edit vcell applications and simulations

run local simulations

  • run local spatial simulations (for reactions, diffusion, and advection) stored in local workspace.

analyze local simulation result:

  • Time-series summary statistics available as NumPy arrays.
  • spatiotemporal arrays stored as Zarr datastores and available as NumPy arrays.
  • 3D mesh data using VTK unstructured grids, analyzed with VTK

local visualization

  • built-in plotting and 3D visualization via Matplotlib and VTK/PyVista
  • make your own plots or 3D renderings.

installation

The easiest way to install pyvcell is by using the Python Package Index and pip. We highly recommend setting up a virtual environment for dependency management. Run the following command to install pyvcell from PyPI

pip install pyvcell

Usage

import pyvcell.vcml as vc
biomodel = vc.load_vcml_file('path/to/your/model.vcml')
results = vc.simulate(biomodel, "sim1")
results.plotter.plot_concentrations()

Documentation

Full documentation is available at https://virtualcell.github.io/pyvcell/

Examples:

Antimony example

Open in Colab

Parameters example

Open in Colab

Geometry import example

Open in Colab

Metadata

Release files for pyvcell 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyvcell 0.4.1
File Size Uploaded
pyvcell-0.4.1.tar.gz 195.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pyvcell 0.4.1
File Interpreter ABI Platform
pyvcell-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 641.6 kB

Release files / pyvcell-0.4.1.tar.gz

Download URL pyvcell-0.4.1.tar.gz
Size 195.4 kB
Tags Source
SHA-256 checksum
How to use checksums
b76c835a817936292ed7cf82e0014afbed5291daffade13efcb05bf6ed9feb4f
BLAKE2b-256 checksum
How to use checksums
e0504a0f12b617f9f047937ff63e5e6d3d778c5da82ecb6d00d213b73e91d4f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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 / pyvcell-0.4.1-py3-none-any.whl

Download URL pyvcell-0.4.1-py3-none-any.whl
Size 446.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8fa46ae37871c135c3cf7c3f80d227c4d445f9272f03d5b456f6d6efd6bd971e
BLAKE2b-256 checksum
How to use checksums
f1d0d9c65fce06863ff8c1598efd9fea95425030c191bc27b1a919956cd17f07
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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 history Release notifications | RSS feed

This release

0.4.1 This release

2 release files

0.4.0

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.22

2 release files

0.1.21

2 release files

0.1.20

2 release files

0.1.19

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page