If you simply want to access projects previously processed, you can skip this step. To install the prerequisites follow system requirements.
To install MiGA itself, you'll just need:
gem install miga-base
If necessary, you can use sudo gem install miga-base
or
gem install --user miga-base
instead.
If you want to get MiGA working from source instead of using the gem, you can use:
# Get the source. Make sure you use --recursive, to clone submodules:
git clone --recursive https://github.com/bio-miga/miga.git
cd miga
# You can use bundle to make sure you have the required gems,
# or simply install them manually:
bundle
# And finally make MiGA available in the PATH.
# This is not mandatory but it saves time and effort:
echo "export PATH=\"$(pwd)/bin:\$PATH\"" >> ~/.bashrc
source ~/.bashrc
To initialize MiGA for data processing, simply execute and follow the instructions:
miga init
For additional initialization parameters, use miga init -h
.
If some of the prerequisites are not already available in your $PATH
, you'll
have to first tell MiGA how to find them.
For that, create (or modify) a bash
configuration file at ~/.miga_modules
loading any necessary packages.
For example, if you're in a cluster architecture using modules
, this is where
you should load them.
Note that some contents may already be present in this file from previous
steps.
Do not remove or modify those lines if you're not sure what they do.
Here's an example of a configuration file for a single computer:
#!/bin/bash
# File: ~/.miga_modules
# Enable software installed in this user
export PATH="$HOME/apps/bin:$PATH"
# Enable MyTaxa
export PATH="$HOME/apps/MyTaxa:$PATH"
Here is an example of a configuration file for a cluster:
#!/bin/bash
# File: ~/.miga_modules
shopt -s expand_aliases
module purge
module load gcc/4.9.0
module load ruby/2.1.5
module load R/3.3.2
module load prodigal/2.6.1
module load bedtools/2.21.0
module load scythe/0.993
module load fastqc/0.11.2
module load idba/1.1.1_kMSS
module load hmmer/3.1b1
# Enable MyTaxa
export PATH="$HOME/shared3/apps/MyTaxa:$PATH"
# Workaround for broken FastQC in the cluster
alias fastqc="perl $(which --skip-alias --skip-functions fastqc)"
# Workaround for broken KronaTools in the cluster
alias ktImportText="perl -I$HOME/shared3/apps/KronaTools-2.5/lib/ \
$HOME/shared3/bin/ktImportText"
Once you complete this file, rerun:
miga init