Metadata-Version: 2.4
Name: astrologics
Version: 0.3.2
Summary: An analysis framework for monotonous Boolean model ensemble
Author-email: Saran Pankaew <saran.pankeaw@curie.fr>, Vincent Noël <vincent.noel@curie.fr>
License-Expression: MIT
Requires-Python: >3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: scikit-learn
Requires-Dist: tslearn
Requires-Dist: fastcluster
Requires-Dist: tqdm
Requires-Dist: maboss
Requires-Dist: boolsim
Requires-Dist: mpbn
Requires-Dist: seaborn
Dynamic: license-file

<img align="left" width="160" src="https://github.com/sysbio-curie/AstroLogics/raw/main/doc/images/Logo_full.svg" />

# An analysis framework for monotonous Boolean model ensemble

This is a repository of data, code and analyses of AstroLogics framework.
A step-by step tutorial can be found in the folder tutorial. Please have a look at our [tutorials](https://astrologics.readthedocs.io/en/latest/tutorials.html). 

## Overview
AstroLogics is a Python package designed for analysing monotonous Boolean model ensemble, a product of Boolean model synthesis from method such as [Bonesis](https://bnediction.github.io/bonesis/index.html).

Our framework includes two major processes 
1. Dynamical properties analysis : 
    - Calculated distance between models through probabilistic approxmition via [MaBoSS](https://github.com/sysbio-curie/MaBoSS).
2. Logical function evaluation : 
    - Features logical equation and identify key logical features between model clusters
3. Statistical analysis :
    - Perform statistical analysis between model clusters to identify key logical featuers between clusters

<p align="center">
<img height="400" src="./doc/images/Figure_Overview_framework_version2.png" />
<br>
<em> Overview of the framework showing the two major processes in the framework. <strong>Dynamics</strong>: dynamical properties analysis. <strong>Logics</strong>: Logical function evaluation 
<strong>Statistics</strong>: statistical framework to link model's logic with statistics.
</em>
</br>
</p>

## Getting Started
### Requirements (for AstroLogics)
- Python version 3.8 or greater
- Python's packages listed here:
    - pandas
    - numpy
    - scipy, sklearn
    - maboss
    - boolsim
    - bonesis
    - mpbn
### Installation 

There are several ways to install AstroLogics


#### PyPi

```
pip install astrologics
```

#### Conda
```
conda install -c colomoto astrologics
```

#### From source
First clone this directory:
```
git clone https://https://github.com/sysbio-curie/AstroLogics
```

Then install AstroLogics with pip
```
pip install AstroLogics
```


## Tutorials

Tutorials are available as Jupyter notebooks

### Run with Binder

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/sysbio-curie/AstroLogics/main?filepath=AstroLogics)


### Run locally with Docker
To run this notebook using the built docker image, run : 
```
docker run -p 8888:8888 -d sysbiocurie/astrologics
```

### Run locally with Conda
Creating the conda environment
```
conda env create --file environment.yml
```

To activate it : 
```
conda activate astrologics
```


To run the notebook: 
```
jupyter-lab
```

## Documentation

Our documentation is available on [ReadTheDocs](https://astrologics.readthedocs.io/)


## Citing AstroLogics
Coming soon
