Installation
Pre-built binaries
For convenience, we provide pre-built binaries for a number of platforms:
Linux
We provide a pre-built binary for Linux (x86):
- rastair-v2.0.0-x86_64-unknown-linux-gnu.tar.gz (64-bit, x86)
This binary was built on Ubuntu 20.04 but should work on most recent distributions.
While rastair itself is hard-linked and therefore independent of system libraries, this is unfortunately not yet the case for htslib. If your system uses a GLIBC older than 2.30, then you will have to compile from source.
Mac OSX
For Apple users, we provide both Apple Silicon and Intel binaries:
-
rastair-v2.0.0-aarch64-apple-darwin.zip (ARM "Apple Silicon", for all "M" line processors)
-
rastair-v2.0.0-x86_64-apple-darwin.zip (64-bit, older x86 Intel Macs)
Building from source
Pre-requisites
To compile from source, you need a working Rust installation (version 1.88 or later). Rastair depends on rust-htslib, which currently requires a working clang library as well as cmake. On most systems, these are either already available or can be installed using a standard package manager:
First, clone the repo:
git clone git@bitbucket.org:bsblabludwig/rastair.git
Then follow the platform-specific instructions below.
Ubuntu
sudo apt install libclang-dev cmake
Fedora
sudo dnf install -y clang cmake
Mac OSX (Homebrew)
We assume that you have Xcode developer tools installed. In that case, you only need
brew install cmake
Compile
Finally, build the project using:
cargo xtask release
The binary will be located in target/release/rastair.
On some systems, you might get performance improvements by allowing the compiler to use platform-specific optimisations:
RUSTFLAGS="-C target-cpu=native" cargo xtask release
Docker
You can install the pre-built docker image in the usual way:
docker pull sbludwig/rastair:version-2.0.0
Building using Docker
You can also build Rastair using Docker. Ensure you have Docker installed and running on your system, then, build the image:
docker build -t rastair .
This image is based on the R base image and includes all necessary dependencies to also run the bundled R scripts.
Conda
This is still work in progress: we hope to soon provide a bioconda recipe to install rastair.