Clonal Variability Simulation
Project description
CloVarS: a clonal variability simulation of single cells
This repository contains the source code accompanying the article "CloVarS: a simulation of clonal variability in single cells" (in preparation).
What is CloVarS
The Clonal Variability Simulation (CloVarS) is a cell culture simulation that generates synthetic single-cell lineage data, as normally obtained from time-lapse microscopy experiments.
The example below depicts a single colony, starting from a single cell, which grows over 7 days:
Installation
CloVarS requires Python version 3.8+ in order to run. You can install CloVarS in your Python environment with the command:
pip install clovars
This adds the clovars
command to your Python environment, and also installs the necessary dependencies.
How to use CloVarS
CloVarS can be executed in the following modes:
run
- run a simulation with the given settings;view
- visualize the results of a previous simulation run (figures, images, videos);analyse
- run analytical tools on the result of a previous simulation run;fit
- fit experimental data to a variety of curves.
You also need to provide the path to the necessary settings files as a command-line argument. Settings files use the TOML syntax, which makes it easy to open and edit them in any text editor.
This folder has examples for the structure of the settings files. Be sure to pay attention: CloVarS will likely run into errors if the setting files have incorrect or missing values!
For more information on the settings and their meaning, please read the docs here (coming soon!).
Run CloVarS
clovars run path_to/run_settings.toml path_to/colonies.toml
where:
path_to/run_settings.toml
is the path for a TOML file with the run settings;path_to/colonies.toml
is the path for a TOML file describing the colonies to simulate.
View CloVarS results
clovars view path_to/view_settings.toml
where:
path_to/view_settings.toml
is the path for a TOML file with the view settings.
Analyse CloVarS results
clovars analyse path_to/analysis_settings.toml
where:
path_to/analysis_settings.toml
is the path for a TOML file with the analysis settings.
Fit experimental data to treatments
clovars fit path_to/fit_settings.toml
where:
path_to/fit_settings.toml
is the path for a TOML file with the fit settings.
Please refer to this folder for examples on how the experimental data should be formatted.
Dependencies
CloVarS depends on the following third-party Python packages:
License
CloVarS is distributed under the MIT license. Read the LICENSE.md
file for details.
Cite us
If you use CloVarS, cite us:
Faccioni, JL; Oliveira, MM; Lenz, G. CloVarS: a simulation of clonal variability in single cells. (in preparation).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for clovars-0.2.1a0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a7e0ed3d167963989be98ae429b973cf79b246173b0dff6c200f9f7139eb1d26 |
|
MD5 | 2f79ebbbfd74beb0fb0d2c9411048a34 |
|
BLAKE2b-256 | a00096df85c8f438804d0e5458258142d639a2e049d070295e240685143ef9f8 |