Installation
Prerequisites
If you simply want to access projects previously processed, you can skip this step. To install the prerequisites follow system requirements.
Getting MiGA
To install MiGA itself, you'll just need:
1
gem install miga-base
Copied!
If necessary, you can use
sudo gem install miga-base or gem install --user miga-base instead.Getting MiGA source
If you want to get MiGA working from source instead of using the gem, you can use:
1
# Get the source. Make sure you use --recursive, to clone submodules:
2
git clone --recursive https://github.com/bio-miga/miga.git
3
cd miga
4
5
# You can use bundle to make sure you have the required gems,
6
# or simply install them manually:
7
bundle
8
9
# And finally make MiGA available in the PATH.
10
# This is not mandatory but it saves time and effort:
11
echo "export PATH=\"$(pwd)/bin:\$PATH\"" >> ~/.bashrc
12
source ~/.bashrc
Copied!
Initializing MiGA
To initialize MiGA for data processing, simply execute and follow the instructions:
1
miga init
Copied!
For additional initialization parameters, use
miga init -h.Pre-loading Software
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:1
#!/bin/bash
2
# File: ~/.miga_modules
3
4
# Enable software installed in this user
5
export PATH="$HOME/apps/bin:$PATH"
6
7
# Enable MyTaxa
8
export PATH="$HOME/apps/MyTaxa:$PATH"
Copied!
Here is an example of a configuration file for a cluster:
1
#!/bin/bash
2
# File: ~/.miga_modules
3
4
shopt -s expand_aliases
5
module purge
6
module load gcc/4.9.0
7
module load ruby/2.1.5
8
module load R/3.3.2
9
module load prodigal/2.6.1
10
module load bedtools/2.21.0
11
module load scythe/0.993
12
module load fastqc/0.11.2
13
module load idba/1.1.1_kMSS
14
module load hmmer/3.1b1
15
16
# Enable MyTaxa
17
export PATH="$HOME/shared3/apps/MyTaxa:$PATH"
18
19
# Workaround for broken FastQC in the cluster
20
alias fastqc="perl $(which --skip-alias --skip-functions fastqc)"
21
22
# Workaround for broken KronaTools in the cluster
23
alias ktImportText="perl -I$HOME/shared3/apps/KronaTools-2.5/lib/ \
24
$HOME/shared3/bin/ktImportText"
Copied!
Once you complete this file, rerun:
1
miga init
Copied!
Last modified 1yr ago