Installation#
Using Docker#
First you must have Docker installed and running.
Secondly have look at the availabe AGAT biocontainers at quay.io.
Then:
# get the chosen AGAT container version
docker pull quay.io/biocontainers/agat:0.8.0--pl5262hdfd78af_0
# use an AGAT's tool e.g. agat_convert_sp_gxf2gxf.pl
docker run quay.io/biocontainers/agat:0.8.0--pl5262hdfd78af_0 agat_convert_sp_gxf2gxf.pl --help
Using Singularity#
First you must have Singularity installed and running.
Secondly have look at the availabe AGAT biocontainers at quay.io.
Then:
# get the chosen AGAT container version
singularity pull docker://quay.io/biocontainers/agat:1.0.0--pl5321hdfd78af_0
# run the container
singularity run agat_1.0.0--pl5321hdfd78af_0.sif
You are now in the container. You can use an AGAT's tool e.g. agat_convert_sp_gxf2gxf.pl doing
agat_convert_sp_gxf2gxf.pl --help
Using Bioconda#
Install AGAT#
conda install -c bioconda agat
or in a fresh environment:
conda create -c bioconda -n agat agat
Update AGAT#
conda update agat
Uninstall AGAT#
conda uninstall agat
Old school - Manually#
You will have to install all prerequisites and AGAT manually.
Install prerequisites#
-
R (optional)
You can install it by conda (conda install r-base
), through CRAN (See here for a nice tutorial) or using your package management tool (e.g apt for Debian, Ubuntu, and related Linux distributions). R is optional and can be used to perform some plots. You will need to install the perl depency Statistics::R -
Perl >= 5.8
It should already be available on your computer. If you are unlucky perl.org is the place to go. -
Perl modules
They can be installed in different ways:- using cpan or cpanm
cpanm install bioperl Clone Graph::Directed LWP::UserAgent Carp Sort::Naturally File::Share File::ShareDir::Install Moose YAML LWP::Protocol::https Term::ProgressBar
-
using conda
-
using the provided yaml file
conda env create -f conda_environment_AGAT.yml conda activate agat
- manually
conda install perl-bioperl perl-clone perl-graph perl-lwp-simple perl-carp perl-sort-naturally perl-file-share perl-file-sharedir-install perl-moose perl-yaml perl-lwp-protocol-https perl-term-progressbar
- using your package management tool (e.g apt for Debian, Ubuntu, and related Linux distributions)
apt install libbio-perl-perl libclone-perl libgraph-perl liblwp-useragent-determined-perl libstatistics-r-perl libcarp-clan-perl libsort-naturally-perl libfile-share-perl libfile-sharedir libfile-sharedir-install-perl libyaml-perl liblwp-protocol-https-perl libterm-progressbar-perl
-
Optional Some scripts offer the possibility to perform plots. You will need R and Statistics::R which are not included by default.
-
R
You can install it by conda (conda install r-base
), through CRAN (See here for a nice tutorial) or using your package management tool (e.g apt for Debian, Ubuntu, and related Linux distributions). -
Statistics::R You can install it through conda (
conda install perl-statistics-r
), using cpan/cpanm (cpanm install Statistics::R
), or your package management tool (apt install libstatistics-r-perl
)
-
Install AGAT#
git clone https://github.com/NBISweden/AGAT.git # Clone AGAT
cd AGAT # move into AGAT folder
perl Makefile.PL # Check all the dependencies*
make # Compile
make test # Test
make install # Install
*If dependencies are missing you will be warn. Please refer to the Install prerequisites section.
Remark: On MS Windows, instead of make you'd probably have to use dmake or nmake depending the toolchain you have.
Update AGAT#
From the folder where the repository is located.
git pull # Update to last AGAT
perl Makefile.PL # Check all the dependencies*
make # Compile
make test # Test
make install # Install
Change to a specific version#
From the folder where the repository is located.
git pull # Update the code
git checkout v0.1 # use version v0.1 (See releases tab for a list of available versions)
perl Makefile.PL # Check all the dependencies*
make # Compile
make test # Test
make install # Install
Uninstall AGAT#
perl uninstall_AGAT