Metadata-Version: 2.1
Name: biosimulators-simularium
Version: 0.2.4
Summary: A Python tool for converting Biosimulators spatial simulation outputs into a Simularium-compliant format.
Home-page: https://github.com/biosimulators/Biosimulators_simularium
Author: Alexander Patrie/BioSimulators Team
Author-email: info@biosimulators.org
License-File: LICENSE.txt

# Biosimulators_simularium
Converting Biosimulators spatial simulation outputs into a Simularium-compliant format.

PLEASE NOTE: The command-line arguments for the standalone version of this program are as follows:

    -a (`str`): archive_rootpath => path to the root of your COMBINE/OMEX archive relative to where you currently are.
    -s (`str`): simularium_fp => desired path where to store the newly generated filepath. Will default to your OMEX archive.


## Getting Started (With Docker)

The easiest way to interact with Biosimulators_simularium on a standalone-basis is by using Docker. 


1. `cd {WHERE YOU ARE GOING TO WORK}`
2. `git clone https://github.com/biosimulators/biosimulators-simularium.git`
3. `cd Biosimulators_simularium`
4. Choose a tag-name for the image(we use a generic name here): `docker build -t biosimularium .`

Say we want to add a `.simularium` file to our COMBINE archive based on a Smoldyn model's output. We have this model file in an archive with the
rootpath of `./biosimulators_simularium/test_files/archives/minE_Andrews_052023` and save it to `./biosimulators_simularium/test_files/archives/minE_Andrews_052023`
(the same archive):

    docker run biosimularium \
      -a './biosimulators_simularium/test_files/archives/minE_Andrews_052023' \
      -s './biosimulators_simularium/test_files/archives/minE_Andrews_052023'


## Getting Started (Building from Source)


### BEFORE STARTING: This application uses Smoldyn to generate simulation data. Please install Smoldyn into your local environment. Instructions below use the Mac silicon install and Python 3.10. More information on installing Smoldyn can be found [here](https://www.smoldyn.org/download.html)

1. Set up a virtual environment. We recommend using Conda: `conda create -n biosimularium 
python=3.10`

2. `conda activate biosimularium`

3. `cd {REPO DESTINATION}`

4. `git clone https://github.com/biosimulators/biosimulators-simularium.git`

5. `cd Biosimulators_simularium`

6. `pip install -e .`

7. FOR MAC ONLY: Download Smoldyn for your Mac (Silicon or Intel): https://www.smoldyn.org/download.html
   - `cd /path/to/your/download/of/smoldyn-2.72-mac` 
   - `sudo -H ./install.sh`

8. OTHERWISE: `pip install smoldyn`


A Jupyter Notebook will soon be available which is based off of the simulariumio tutorial series. This will 
give users the ability to have a tool that quickly generates simularium files with the click of a button based 
on a valid COMBINE/OMEX archive.



