Natural Products Linker
Project description
Badges
fair-software.eu recommendations | |
---|---|
(1/5) code repository | |
(2/5) license | |
(3/5) community registry | |
(4/5) citation | |
(5/5) checklist | |
overall | |
Other best practices | |
Documentation | 🔗 |
Build & Test | |
Static analysis | |
Coverage | |
Citation data consistency |
Natural Products Linker (NPLinker)
NPLinker is a python framework for data mining microbial natural products by integrating genomics and metabolomics data.
Original paper: Ranking microbial metabolomic and genomic links in the NPLinker framework using complementary scoring functions.
Setup and usage
Requirement
- Linux or MacOS
- Python version ≥3.9
Installation
NPLinker is a python package, using both pypi packages and non-pypi packages as dependencies. It requires ~4.5GB of disk space to install all the dependencies.
# Check python version (requiring ≥3.9)
python --version
# Create a new virtual environment
python -m venv env
source env/bin/activate
# install from nplinker releases (requiring ~300MB of disk space)
pip install --pre nplinker
# or install the latest from source code
pip install git+https://github.com/nplinker/nplinker@dev
# install nplinker non-pypi dependencies and databases (~4GB)
install-nplinker-deps
A virtual environment is required to install the the non-pypi dependencies. You can also use conda
to manage python environments.
Testing
To run the tests, you need to clone this repo and install the development dependencies:
# Create a new virtual environment
python -m venv env
source env/bin/activate
# Clone the repository and install the development dependencies
git clone https://github.com/NPLinker/nplinker.git
cd nplinker
pip install -e ".[dev]"
install-nplinker-deps
Unit tests
To run the unit tests, you can use the following command:
pytest
Pytest will use all available CPU cores to run the unit tests in parallel.
Integration tests
To run the integration tests, you can use the following command:
pytest -n1 tests/integration
The -n1
is to use one CPU core to run the tests. Change it to -n2
if you want to use two CPU cores to run in parallel.
Usage
See the documentation for more information about how to use NPLinker.
Contributing
If you want to contribute to the development of nplinker, have a look at the contribution guidelines and README for developers.
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 nplinker-2.0.0a4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 26c858efa33beb9cf6d8c9f1be026b2a986df13a2b55dbb46893ccc2bc282519 |
|
MD5 | c5513494ee4d5a1f683e4d268138e77e |
|
BLAKE2b-256 | 735bae9e391784190ebfb3c25990b46c5e34cbe0c3f82749a7de461f7de6a628 |