Installation

Ths section contains step-by-step instructions for setting up StemCNV-check. All commands should be run in a linux terminal, including WSL (Windows Subsystem for Linux) on Windows.

Tip

If you are not familiar with using scientific software on Linux and/or are a Windows user, it is strongly recommended to read through the Basics for non-linux Users section first. This will also explain how to setup WSL (Windows Subsystem for Linux) on Windows.

Installation of Conda

Note

Conda is a software that facilitates the distribution and installation of primarily scientific software with the ability to control which specific versions are used. StemCNV-check utilises this for almost all steps of the workflow and as such depends on a working conda setup. In principle any conda setup can be used, but for anyone not familiar we recommend the following.

Install the miniforge conda. In short, use these commands:

wget "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3-$(uname)-$(uname -m).sh
During the installation follow instructions and suggestions that are displayed in the terminal. When the istaller askes if it should update the shell profile to the allow automatic initialisation of conda, answer/type: yes instead of the default no. In all other cases the default answers should let you continue.
After successful installation of conda WSL has to be restarted (close and reopen the window) or reload the updated .bashrc of WSL using the command: source ~/.bashrc

Installation of StemCNV-check

It is recommended to install StemCNV-check with conda through the bioconda channel.

StemCNV-check requires at least 8GB of RAM and 4 CPU cores with default settings, however at least 12-16GB RAM are recommended.

Tip

If your are using WSL, by default the WSL system will only have access to half of the available RAM on your computer. You can change this memory size in the WSL settings, but remember that Windows generally also requires up to 4GB of RAM for itself. StemCNV-check will automatically detect the available RAM in WSL and restrict itself to that.

Install the development version from github (only for developers)

Alternatively to bioconda, one can perform the following steps to install and setup up the development version of StemCNV-check.

  • Clone the StemCNV-check git repository

git clone https://github.com/bihealth/StemCNV-check.git

  • Set up conda environment for StemCNV-check and install dependencies

    • for WSL (on Windows)

      conda install python=3.12 "gcc_linux-64<14" apptainer fuse-overlayfs

    • for Linux

      conda install python=3.12

Tip

If you also use conda for other projects, you may prefer to use a specific environment only for StemCNV-check: conda create -n stemcnv-check python=3.12; conda activate stemcnv-check

  • Change into the StemCNV-check directory:

    cd StemCNV-check

  • Install StemCNV-check and its dependencies with pip:

    pip install -e .[docs,dev,test]

Updating the development version

As long as you are in the StemCNV-check directory you can update the development version of StemCNV-check with this command:

git pull
pip install -e .