Skip to content

Commit

Permalink
Merge pull request #47 from allen-cell-animated/Admin/update-readme
Browse files Browse the repository at this point in the history
Admin/update readme
  • Loading branch information
blairlyons authored Aug 6, 2021
2 parents 33175ca + 37c61f7 commit 4153418
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 12 deletions.
24 changes: 20 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,24 +21,40 @@ Simulariumio converts simulation outputs to the format consumed by the [Simulari
* Converts 3D spatiotemporal trajectories to .simularium JSON format
* Accepts spatial trajectories from the following biological simulation engines:
* CytoSim (https://gitlab.com/f.nedelec/cytosim)
* ReaDDy (https://readdy.github.io/)
* PhysiCell (http://physicell.org/)
* MCell (https://mcell.org/)
* MEDYAN (http://medyan.org/)
* PhysiCell (http://physicell.org/)
* ReaDDy (https://readdy.github.io/)
* Smoldyn (http://www.smoldyn.org/)
* SpringSaLaD (https://vcell.org/ssalad)
* Conversions for data from custom engines can be implemented using the TrajectoryConverter class
* Also accepts metrics data for plots to display alongside spatial data

We're working to improve performance for converting large trajectories, and also discussing with the authors of some packages the possibility of adding the ability to export Simularium files directly.

___

## Visualize results
1. In a supported browser (Firefox, Chrome, or Edge), navigate to https://simularium.allencell.org/viewer.
2. Drag the file output from SimulariumIO from your file browser onto the window or use the file upload dialogue to choose your file

## Sharing links to results
1. Upload your Simularium file to one of the supported public cloud providers, currently Dropbox, Google Drive, or Amazon S3, and get a publicly accessible link to the file.
2. In a supported browser, navigate to https://simularium.allencell.org/viewer?trajUrl=[link to your file]. You can share this link with collaborators or post it on your website so that others can interactively view your results.

___

## Quick Start

### Convert spatial trajectory from a supported engine
See the Tutorial for the simulation engine you're using for details:
* [Cytosim Tutorial](examples/Tutorial_cytosim.ipynb)
* [ReaDDy Tutorial](examples/Tutorial_readdy.ipynb)
* [PhysiCell Tutorial](examples/Tutorial_physicell.ipynb)
* [MCell Tutorial](examples/Tutorial_mcell.ipynb)
* [MEDYAN Tutorial](examples/Tutorial_medyan.ipynb)
* [PhysiCell Tutorial](examples/Tutorial_physicell.ipynb)
* [ReaDDy Tutorial](examples/Tutorial_readdy.ipynb)
* [Smoldyn Tutorial](examples/Tutorial_smoldyn.ipynb)
* [SpringSaLaD Tutorial](examples/Tutorial_springsalad.ipynb)

An overview for data from ReaDDy:
```python
Expand Down
8 changes: 8 additions & 0 deletions docs/simulariumio.data_objects.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,14 @@ simulariumio.data\_objects.camera\_data module
:undoc-members:
:show-inheritance:

simulariumio.data\_objects.dimension\_data module
-------------------------------------------------

.. automodule:: simulariumio.data_objects.dimension_data
:members:
:undoc-members:
:show-inheritance:

simulariumio.data\_objects.histogram\_plot\_data module
-------------------------------------------------------

Expand Down
8 changes: 0 additions & 8 deletions docs/simulariumio.filters.rst
Original file line number Diff line number Diff line change
Expand Up @@ -60,14 +60,6 @@ simulariumio.filters.multiply\_time\_filter module
:undoc-members:
:show-inheritance:

simulariumio.filters.reorder\_agents\_filter module
---------------------------------------------------

.. automodule:: simulariumio.filters.reorder_agents_filter
:members:
:undoc-members:
:show-inheritance:

simulariumio.filters.transform\_spatial\_axes\_filter module
------------------------------------------------------------

Expand Down

0 comments on commit 4153418

Please sign in to comment.