QIIME/fr: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
(10 intermediate revisions by 2 users not shown) | |||
Line 6: | Line 6: | ||
<b>Remarque </b>: Depuis février 2020, il n'est pas possible d'installer QIIME avec Anaconda ou Miniconda sur nos grappes en raison de plusieurs problèmes dus aux environnements Conda.</b> | <b>Remarque </b>: Depuis février 2020, il n'est pas possible d'installer QIIME avec Anaconda ou Miniconda sur nos grappes en raison de plusieurs problèmes dus aux environnements Conda.</b> | ||
== QIIME2 | == Module pour QIIME2 == | ||
QIIME2 | QIIME2 est disponible en chargeant un module qui enveloppe un conteneur. Pour connaître les versions disponibles, lancez | ||
{{Command|module spider qiime2}} | {{Command|module spider qiime2}} | ||
Une fois le module chargé, vous pouvez lancer | |||
{{Command|qiime --help}} | {{Command|qiime --help}} | ||
{{Callout | {{Callout | ||
|title=Note | |title=Note | ||
|content= | |content=Étant donné que la commande <code>qiime</code> appelle un conteneur, il se peut que vous deviez définir la variable d'environnement <code>APPTAINER_BIND</code> pour attacher des répertoires particuliers dans ce conteneur pour avoir accès à vos données, par exemple <code>APPTAINER_BIND=/home qiime ...</code> | ||
}} | }} | ||
==Installation == | ==Installation == | ||
L’installation peut se faire en utilisant [[Apptainer/fr|Apptainer]] ou [[EasyBuild/fr|EasyBuild]]. Il est préférable d'utiliser Apptainer pour éviter que plusieurs milliers de fichiers soient générés dans votre répertoire /home, ce qui risquerait de dépasser le quota sur le nombre de fichiers. | L’installation peut se faire en utilisant [[Apptainer/fr|Apptainer]] ou [[EasyBuild/fr|EasyBuild]]. Il est préférable d'utiliser Apptainer pour éviter que plusieurs milliers de fichiers soient générés dans votre répertoire /home, ce qui risquerait de dépasser le quota sur le nombre de fichiers. | ||
{{Outdated/fr}} | |||
Line 37: | Line 36: | ||
Cette étape du build pourrait prendre plus d'une heure, mais il ne faut l'effectuer qu'une seule fois. Sauvegardez le fichier image (dans notre exemple <code>qiime2-2021.11.sif</code>) pour pouvoir le réutiliser plus tard. | Cette étape du build pourrait prendre plus d'une heure, mais il ne faut l'effectuer qu'une seule fois. Sauvegardez le fichier image (dans notre exemple <code>qiime2-2021.11.sif</code>) pour pouvoir le réutiliser plus tard. | ||
Exécutez ensuite votre programme comme décrit dans la [[Apptainer/fr|page Apptainer]]. De façon générale, chaque commande QIIME est exécutée dans un énoncé <code>apptainer exec</code> comme suit%nbsp;: | |||
Exécutez ensuite votre programme comme décrit dans la [[Apptainer/fr|page Apptainer]]. De façon générale, chaque commande QIIME est exécutée dans un énoncé <code>apptainer exec</code> comme suit : | |||
{{Commands | {{Commands | ||
Line 53: | Line 50: | ||
apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ | apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ | ||
-B / | -B /project/def-somePI/someuser/path/to/inputs:/inputs qiime2-2021.11.sif \ | ||
qiime tools import --type 'FeatureData[Sequence]' \ | qiime tools import --type 'FeatureData[Sequence]' \ | ||
--input-path /inputs/some_fastafile.fa \ | --input-path /inputs/some_fastafile.fa \ | ||
Line 59: | Line 56: | ||
apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ | apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ | ||
-B / | -B /project/def-somePI/someuser/path/to/inputs:/inputs qiime2-2021.11.sif \ | ||
qiime tools import \ | qiime tools import \ | ||
--type 'FeatureData[Taxonomy]' \ | --type 'FeatureData[Taxonomy]' \ | ||
Line 67: | Line 64: | ||
apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ | apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ | ||
-B / | -B /project/def-somePI/someuser/path/to/inputs:/inputs qiime2-2021.11.sif \ | ||
qiime feature-classifier fit-classifier-naive-bayes \ | qiime feature-classifier fit-classifier-naive-bayes \ | ||
--i-reference-reads /outputs/some_output_feature.qza \ | --i-reference-reads /outputs/some_output_feature.qza \ | ||
Line 74: | Line 71: | ||
</pre> | </pre> | ||
Notez qu'il est important d'utiliser l'option [[Apptainer/fr#Bind_mount|bind]] (<code>-B</code>) avec chacun des répertoires avec lesquels vous voulez travailler quand des programmes sont exécutés dans votre conteneur. Pour plus d'information, voyez ce [https://www.youtube.com/watch?v=bpmrfVqBowY webinaire Apptainer]. | |||
Notez qu'il est important d'utiliser l'option [[Apptainer/fr#Bind_mount|bind]] (<code>-B</code>) avec chacun des répertoires avec lesquels vous voulez travailler quand des programmes sont exécutés dans votre conteneur. Pour plus d'information, voyez | |||
La première fois que des données sont importées en format QIIME, vous pourriez recevoir un message semblable à | La première fois que des données sont importées en format QIIME, vous pourriez recevoir un message semblable à |
Latest revision as of 20:49, 9 January 2024
QIIME (pour Quantitative Insights Into Microbial Ecology) est un pipeline bioinformatique open source pour l’analyse de microbiomes. À partir de données brutes de séquençage d’ADN générées par des plateformes comme Illumina, QIIME produit des graphiques et statistiques de haute qualité pour, entre autres, le démultiplexage, le filtrage de qualité, la sélection d’OTU, l’attribution taxonomique, la reconstruction phylogénétique et l’analyse de la diversité.
Remarque : QIIME 2 a remplacé QIIME 1 en janvier 2018; la version 1 n'est plus supportée.
Remarque : Depuis février 2020, il n'est pas possible d'installer QIIME avec Anaconda ou Miniconda sur nos grappes en raison de plusieurs problèmes dus aux environnements Conda.
Module pour QIIME2
QIIME2 est disponible en chargeant un module qui enveloppe un conteneur. Pour connaître les versions disponibles, lancez
[name@server ~]$ module spider qiime2
Une fois le module chargé, vous pouvez lancer
[name@server ~]$ qiime --help
Étant donné que la commande qiime
appelle un conteneur, il se peut que vous deviez définir la variable d'environnement APPTAINER_BIND
pour attacher des répertoires particuliers dans ce conteneur pour avoir accès à vos données, par exemple APPTAINER_BIND=/home qiime ...
Installation
L’installation peut se faire en utilisant Apptainer ou EasyBuild. Il est préférable d'utiliser Apptainer pour éviter que plusieurs milliers de fichiers soient générés dans votre répertoire /home, ce qui risquerait de dépasser le quota sur le nombre de fichiers.
Cette page ou cette section contient des informations qui sont désuètes ou qui ne sont plus valides. Elle sera mise à jour par notre équipe technique à un moment ultérieur.
Utilisation avec Apptainer
Les développeurs de QIIME2 publient des images sur Quay.io. Pour utiliser ces images avec nos ressources, il faut d'abord créer une image Apptainer comme suit :
[name@server ~]$ module load apptainer
[name@server ~]$ apptainer build qiime2-2021.11.sif docker://quay.io/qiime2/core:2021.11
Cette étape du build pourrait prendre plus d'une heure, mais il ne faut l'effectuer qu'une seule fois. Sauvegardez le fichier image (dans notre exemple qiime2-2021.11.sif
) pour pouvoir le réutiliser plus tard.
Exécutez ensuite votre programme comme décrit dans la page Apptainer. De façon générale, chaque commande QIIME est exécutée dans un énoncé apptainer exec
comme suit%nbsp;:
[name@server ~]$ apptainer exec qiime2-2021.11.sif <your QIIME command>
Votre script SBATCH ressemblerait à
#!/bin/bash #SBATCH --time=15:00:00 #SBATCH --account=def-someuser apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ -B /project/def-somePI/someuser/path/to/inputs:/inputs qiime2-2021.11.sif \ qiime tools import --type 'FeatureData[Sequence]' \ --input-path /inputs/some_fastafile.fa \ --output-path /outputs/some_output_feature.qza apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ -B /project/def-somePI/someuser/path/to/inputs:/inputs qiime2-2021.11.sif \ qiime tools import \ --type 'FeatureData[Taxonomy]' \ --input-format HeaderlessTSVTaxonomyFormat \ --input-path /inputs/some_taxonomy_file.tax \ --output-path /outputs/some_output_ref-taxonomy.qza apptainer exec -B $PWD:/home -B /scratch/someuser:/outputs \ -B /project/def-somePI/someuser/path/to/inputs:/inputs qiime2-2021.11.sif \ qiime feature-classifier fit-classifier-naive-bayes \ --i-reference-reads /outputs/some_output_feature.qza \ --i-reference-taxonomy /outputs/some_output_ref-taxonomy.qza \ --o-classifier /outputs/some_output_classifier.qza
Notez qu'il est important d'utiliser l'option bind (-B
) avec chacun des répertoires avec lesquels vous voulez travailler quand des programmes sont exécutés dans votre conteneur. Pour plus d'information, voyez ce webinaire Apptainer.
La première fois que des données sont importées en format QIIME, vous pourriez recevoir un message semblable à
Timezone offset does not match system offset: 0 != -18000. Please, check your config files.
Vous pouvez contourner ceci en définissant un fuseau horaire avant d'invoquer Apptainer, comme suit :
[name@server ~]$ export TZ='UTC'
[name@server ~]$ apptainer exec qiime2-2021.11.sif qiime tools import ...