Package for STANdard drug Screening by COllaborative FIltering. Performs benchmarks against datasets and SotA algorithms, and implements training, validation and testing procedures.
Project description
STANdard for drug Screening by COllaborative FIltering (stanscofi) Python Package
This repository is a part of the EU-funded RECeSS project (#101102016), and hosts the code for the open-source Python package stanscofi for the development of collaborative filtering-based drug repurposing algorithms.
Statement of need
As of 2022, current drug development pipelines last around 10 years, costing $2billion in average, while drug commercialization failure rates go up to 90%. These issues can be mitigated by drug repurposing, where chemical compounds are screened for new therapeutic indications in a systematic fashion. In prior works, this approach has been implemented through collaborative filtering. This semi-supervised learning framework leverages known drug-disease matchings in order to recommend new ones.
The stanscofi package comprises method-agnostic training, validation, preprocessing and visualization procedures on several published drug repurposing datasets. The proper implementation of these steps is crucial in order to avoid data leakage, i.e., the model is learnt over information that should be unavailable at prediction time. Indeed, data leakage is the source of a major reproducibility crisis in machine learning. This will be avoided by building training and validation sets which are weakly correlated with respect to the drug and disease feature vectors. The main performance metric will be the area under the curve (AUC), which estimates the diagnostic ability of a recommender system better than accuracy in imbalanced datasets.
Medium-term outcomes to this package will significantly alleviate the economic burden of drug discovery pipelines, and will help find treatments in a more sustainable manner, especially for rare or tropical neglected diseases.
For more information about the datasets accessible in stanscofi, please refer to the following repository.
Install the latest release
Using pip (package hosted on PyPI)
pip install stanscofi
Using conda (package hosted on Anaconda.org)
conda install -c recess stanscofi
Running the notebooks
Example usage
Once installed, to import stanscofi into your Python code
import stanscofi
Please check out notebook Introduction to stanscofi.ipynb. All functions are documented, so one can check out the inputs and outputs of a function func by typing
help(func)
To mesure your environmental impact when using this package (in terms of carbon emissions), please run the following command
! codecarbon init
to initialize the CodeCarbon config. For more information about using CodeCarbon, please refer to the official repository.
Environment
In order to run notebook Introduction to stanscofi.ipynb, it is strongly advised to create a virtual environment using Conda (python>=3.8)
conda create -n stanscofi_env python=3.8.5 -y
conda activate stanscofi_env
python3 -m pip install stanscofi ## or use the conda command above
python3 -m pip install notebook>=6.5.4 markupsafe==2.0.1 ## packages for Jupyter notebook
conda deactivate
conda activate stanscofi_env
cd docs/ && jupyter notebook
The complete list of dependencies for stanscofi can be found at requirements.txt (pip) or meta.yaml (conda).
Licence
This repository is under an OSI-approved MIT license.
Citation
If you use stanscofi in academic research, please cite it as follows
Réda, Clémence. (2023).
STANdard for drug Screening by COllaborative FIltering (stanscofi).
Zenodo. https://doi.org/10.5281/zenodo.8038847
Community guidelines with respect to contributions, issue reporting, and support
Pull requests and issue flagging are welcome, and can be made through the GitHub interface. Support can be provided by reaching out to recess-project[at]proton.me
. However, please note that contributors and users must abide by the Code of Conduct.
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
Built Distribution
Hashes for stanscofi-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 79f64168f5c31f6542d8e413f9e0ccb3fa67b16cb607144ba3da1209d0f63766 |
|
MD5 | 27c22dec23c0ab6084ed7ffc4475766c |
|
BLAKE2b-256 | 09f959a7967f475b3475a5d8ea4019cf537da6a582c70ce3a53151d943615ada |