2 Installation

To install Vclust, you can either download the pre-compiled binaries, install from Bioconda, or compile the dependencies from source. The compilation process typically takes a few minutes.

Requirements

Vclust requires Python 3.7 or higher.

1. Download precompiled binaries

The quickest way to get started is by downloading prebuilt binaries from the Releases tab. The binaries for Linux systems include the Leiden algorithm by default. Select your platform and download the tool.

2. Installation via Bioconda

Vclust is also available on Bioconda.

TODO

3. Compile from source

3.1. Requirements

1. make
2. g++ version 11 or higher
3. cmake version 3.12 or higher

3.2. Default Installation

The default installation of Vclust includes all functionalities except for the Leiden clustering algorithm.

git clone --recurse-submodules https://github.com/refresh-bio/vclust
cd vclust
make -j

3.3. Installation with Leiden algorithm support

Vclust provides igraph's implementation of the Leiden algorithm. However, because igraph requires several external dependencies (CMake 3.18, Flex, Bison), it is not integrated with Vclust by default. To install these dependencies under Debian/Ubuntu Linux, use the following command:

sudo apt-get install cmake flex bison

Then, build Vclust with Leiden algorithm support:

git clone --recurse-submodules https://github.com/refresh-bio/vclust
cd vclust
make -j LEIDEN=true

4. Tests

To ensure that Vclust works as expected, you can run tests using pytest.

pytest test.py