Skip to main content

Core implementations of process-bigraph.composite.Process aligning with BioSimulators simulator tools.

Project description

BioSimulator Processes

Core implementations of process-bigraph.composite.Process() aligning with BioSimulators simulation tools. A complete environment with version-controlled dependencies already installed is available as a Docker container on GHCR.

Installation

There are two primary methods of interaction with biosimulator-processes:

A container available on ghcr:

  1. Ensure that the Docker Daemon is running. Most users do this by opening the Docker Desktop application.

  2. Pull the image from ghcr.io:

      docker pull ghcr.io/vivarium-collective/biosimulator-processes:latest
    
  3. If there are any "dangling" or already-running jupyter servers running on your machine, the docker run command will not properly work. Run the following and close any servers already running, if necessary:

      jupyter server list && jupyter server stop
    
  4. Run the image, ensuring that the running of the container is platform-agnostic:

      docker run --platform linux/amd64 -it -p 8888:8888 ghcr.io/vivarium-collective/biosimulator-processes:latest
    

MAC USERS: Please note that an update of XCode may be required for this to work on your machine.

As an alternative, there is a helper script that does this docker work and more. To use this script:

  1. Add the appropriate permissions to the file:
        
           chmod +x ./scripts/run-docker.sh

  2. Run the script:

           ./scripts/run-docker.sh

The Python Package Index. You may download BioSimulator Processes with:

     pip install biosimulator-processes

We recommend using an environment/package manager like Conda if downloading from PyPI to install the dependencies required for your use. Most of the direct UI content for this tooling will be in the form of a jupyter notebook. The installation for this notebook is provided below.

Using biosimulator_processes.smoldyn_process.SmoldynProcess():

Mac Users PLEASE NOTE:

Amici

You most likely have to install/update swig with brew, among other possible requirements. Please refer to the Amici Python Installation Documentation for more information.

Smoldyn

Due to the multi-lingual nature of Smoldyn, which is primarily developed in C++, the installation process for utilizing the SmoldynProcess process implementation requires separate handling. This is particularly relevant for macOS and Windows users, where setting up the Python bindings can be more complex.

For your convienience, we have created an installation shell script that will install the correct distribution of Smoldyn based on your Mac processor along with the codebase of this repo. To install Smoldyn and this repo on your Mac, please adhere to the following instructions:

  1. Clone this repo from Github:

     git clone https://github.com/biosimulators/biosimulator-processes.git
    
  2. Provide adminstrative access to the scripts directory within the cloned repo:

     cd biosimulator-processes
    
  3. Look for the install-with-smoldyn-for-mac- shell script where corresponds to your machine's processor:

     ls scripts | grep <YOUR MAC PROCESSOR>
     chmod +x ./scripts/install-with-smoldyn-for-mac-<YOUR MAC PROCESSOR>
    
  4. Run the appropriate shell script (for example, using mac silicon):

     scripts/install-with-smoldyn-for-mac-silicon.sh
    

Quick Start Example:

TODO: copy this from the prompter demo

A NOTE FOR DEVELOPERS:

This tooling implements version control for dynamically-created composite containers through poetry. The version control for content on the Python Package Index is performed by setup.py. Also, the PyTest configuration resides within ./pyproject.toml at the root of this repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

biosimulator_processes-0.1.2.tar.gz (72.7 kB view details)

Uploaded Source

Built Distribution

biosimulator_processes-0.1.2-py3-none-any.whl (88.8 kB view details)

Uploaded Python 3

File details

Details for the file biosimulator_processes-0.1.2.tar.gz.

File metadata

  • Download URL: biosimulator_processes-0.1.2.tar.gz
  • Upload date:
  • Size: 72.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.3 Darwin/23.5.0

File hashes

Hashes for biosimulator_processes-0.1.2.tar.gz
Algorithm Hash digest
SHA256 b00b58b6fe1429c9a333994fa9b0c8f5bf7030378fdefa8e805c0f40c4f10a9b
MD5 c92d389383bbb997ae16f52d256700d9
BLAKE2b-256 cd2574e377431909f669d7915de203d661b7a308b0f86c2bede6026b92c91ec7

See more details on using hashes here.

File details

Details for the file biosimulator_processes-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for biosimulator_processes-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4c1cd255b4bb41a334dc103906a587aa3297c982546d39ee14690312acd0ad21
MD5 8b66fc219694e8ae02c545b07994339c
BLAKE2b-256 d6a0f5f567d23c80ac72a6233badc1046cbb788acf36d749426ca8683d9bb825

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page