Repository to host tool-specific module files for the Nextflow DSL2 community!
Find a file
Lasse Folkersen d6244b42f5
ASCAT (#1332)
* First commit

* putting correct links for singularity and docker containers (just had to search for bioconda+ascat to find them, and then put them in like the rest of the nf-core tools had it

* adding first try of relevant commands (not working yet, just took their basic pipeline example

* test commit

* remove test

* starting up work with module after 3.0.0 upgrade

* add ascat.prepareHTS statemet

* add location of docker for new mulled alleleCounter+ASCAT container

* first full run with ASCAT on HG00154.mapped.ILLUMINA.bwa.GBR.low_coverage.20101123.bam

* add notes on dropbox download

* use a newer pytest_modules.yml

* add outpit

* trying to align with current Sarek output

* adding in FH comments

* busy clearing up arguments and testing. Still WIP

* first working run, in nextflow, with sarek-like output. Still needs more work on input arguments

* cleaning up before writing up findings

* testing with putting in arguments in args

* draft for solution 3 style for arguments

* one more test added

* adding FH map

* finished testing maps for args

* wrap-up cram/crai test successfully

* updates to address ability to put in ref.fasta argument for cram running

* adding remaining import-HTS commands in as args, and removing the chr21/chr22 only testing to test-nextflow.config

* first test with auto-downloading the s3-data (when not given as an argument)

* removing download-logic for supporting files, documenting in meta.yml, fixing ref_fasta bug

* adding mulled singularity container

* removing tests

* fix left padding lint issue

* lint failure in meta.yml

* more linting errors

* add when argument

* adding stub functionality

* add stub run

* correct md5sum for versions.yml

* more testing with -runstub

* stub code in pure bash - not mixed with R

* reformat version.yml

* get rid of absolute paths in test.yml

* correct wrong md5sum

* adding allelecount conda link

* rename normal_bam to input_bam etc

* let the pipeline dev worry about matching the right loci and allele files

* dont hardcode default genomebuild

* adding download instruction comment

* add doi

* fix conda addition bug

* add args documentation

* test new indent

* new test with meta.yml indentation

* retry with new meta.yml

* retry with new meta.yml - now with empty lines around

* retry with new meta.yml - remove trailing whitepsace

* trying to fix found quote character that cannot start any token error

* try with one empty line above triple-quote and no empty line below

* trying with pipe character

* checking if its the ending triple quote

* one more try with meta.yml

* test update bioconda versioning for linting failure

* test update bioconda versioning for linting failure 2

* testing allelecounter version error on conda

Co-authored-by: @lassefolkersen 
Co-authored-by: @FriederikeHanssen
2022-03-15 11:18:43 +01:00
.github Add git aware option to pytest commands (#1379) 2022-03-09 14:55:31 +01:00
docs/images feat: remove social preview image to use GitHub OpenGraph (#461) 2021-04-26 11:59:12 +01:00
modules ASCAT (#1332) 2022-03-15 11:18:43 +01:00
subworkflows/nf-core Fix formatting in yaml files, add yamllint config (#1279) 2022-02-15 11:15:27 +00:00
tests ASCAT (#1332) 2022-03-15 11:18:43 +01:00
.editorconfig Update .editorconfig 2020-06-15 16:47:42 +02:00
.gitattributes Fill out repo 2019-07-26 10:19:07 +01:00
.gitignore New module: isoseq3/cluster (#801) 2021-10-07 10:06:02 +01:00
.gitpod.yml Fix formatting in yaml files, add yamllint config (#1279) 2022-02-15 11:15:27 +00:00
.markdownlint.yml Fix formatting in yaml files, add yamllint config (#1279) 2022-02-15 11:15:27 +00:00
.nf-core.yml Add repository_type to .nf-core.yml (#1252) 2022-02-01 22:33:25 +01:00
.yamllint.yml Fix formatting in yaml files, add yamllint config (#1279) 2022-02-15 11:15:27 +00:00
LICENSE Fill out repo 2019-07-26 10:19:07 +01:00
main.nf feat: Add main.nf (#1077) 2021-11-16 14:49:57 +00:00
README.md Update all modules to new NF DSL2 syntax (#1099) 2021-11-26 07:58:40 +00:00

nf-core/modules

Nextflow run with conda run with docker run with singularity

GitHub Actions Coda Linting Get help on Slack

Follow on Twitter Watch on YouTube

THIS REPOSITORY IS UNDER ACTIVE DEVELOPMENT. SYNTAX, ORGANISATION AND LAYOUT MAY CHANGE WITHOUT NOTICE!

A repository for hosting Nextflow DSL2 module files containing tool-specific process definitions and their associated documentation.

Table of contents

Using existing modules

The module files hosted in this repository define a set of processes for software tools such as fastqc, bwa, samtools etc. This allows you to share and add common functionality across multiple pipelines in a modular fashion.

We have written a helper command in the nf-core/tools package that uses the GitHub API to obtain the relevant information for the module files present in the modules/ directory of this repository. This includes using git commit hashes to track changes for reproducibility purposes, and to download and install all of the relevant module files.

  1. Install the latest version of nf-core/tools (>=2.0)

  2. List the available modules:

    $ nf-core modules list remote
    
                                          ,--./,-.
          ___     __   __   __   ___     /,-._.--~\
    |\ | |__  __ /  ` /  \ |__) |__         }  {
    | \| |       \__, \__/ |  \ |___     \`-._,-`-,
                                          `._,._,'
    
    nf-core/tools version 2.0
    
    INFO     Modules available from nf-core/modules (master):                       pipeline_modules.py:164
    
    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
    ┃ Module Name                    ┃
    ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
    │ bandage/image                  │
    │ bcftools/consensus             │
    │ bcftools/filter                │
    │ bcftools/isec                  │
    ..truncated..
    
  3. Install the module in your pipeline directory:

    $ nf-core modules install fastqc
    
                                          ,--./,-.
          ___     __   __   __   ___     /,-._.--~\
    |\ | |__  __ /  ` /  \ |__) |__         }  {
    | \| |       \__, \__/ |  \ |___     \`-._,-`-,
                                          `._,._,'
    
    nf-core/tools version 2.0
    
    INFO     Installing fastqc                                                      pipeline_modules.py:213
    INFO     Downloaded 3 files to ./modules/nf-core/modules/fastqc                 pipeline_modules.py:236
    
  4. Import the module in your Nextflow script:

    #!/usr/bin/env nextflow
    
    nextflow.enable.dsl = 2
    
    include { FASTQC } from './modules/nf-core/modules/fastqc/main'
    
  5. Remove the module from the pipeline repository if required:

    $ nf-core modules remove fastqc
    
                                          ,--./,-.
          ___     __   __   __   ___     /,-._.--~\
    |\ | |__  __ /  ` /  \ |__) |__         }  {
    | \| |       \__, \__/ |  \ |___     \`-._,-`-,
                                          `._,._,'
    
    nf-core/tools version 2.0
    
    INFO     Removing fastqc                                                        pipeline_modules.py:271
    INFO     Successfully removed fastqc                                            pipeline_modules.py:285
    
  6. Check that a locally installed nf-core module is up-to-date compared to the one hosted in this repo:

    $ nf-core modules lint fastqc
    
                                          ,--./,-.
          ___     __   __   __   ___     /,-._.--~\
    |\ | |__  __ /  ` /  \ |__) |__         }  {
    | \| |       \__, \__/ |  \ |___     \`-._,-`-,
                                          `._,._,'
    
    nf-core/tools version 2.0
    
    INFO     Linting pipeline: .                                                    lint.py:104
    INFO     Linting module: fastqc                                                 lint.py:106
    
    ╭─────────────────────────────────────────────────────────────────────────────────╮
    │ [!] 1 Test Warning                                                              │
    ╰─────────────────────────────────────────────────────────────────────────────────╯
    ╭──────────────┬───────────────────────────────┬──────────────────────────────────╮
    │ Module name  │ Test message                  │ File path                        │
    ├──────────────┼───────────────────────────────┼──────────────────────────────────┤
    │ fastqc       │ Local copy of module outdated │ modules/nf-core/modules/fastqc/  │
    ╰──────────────┴────────────────────────────── ┴──────────────────────────────────╯
    ╭──────────────────────╮
    │ LINT RESULTS SUMMARY │
    ├──────────────────────┤
    │ [✔]  15 Tests Passed │
    │ [!]   1 Test Warning │
    │ [✗]   0 Test Failed  │
    ╰──────────────────────╯
    

Adding new modules

If you wish to contribute a new module, please see the documentation on the nf-core website.

Please be kind to our code reviewers and submit one pull request per module :)

Help

For further information or help, don't hesitate to get in touch on Slack #modules channel (you can join with this invite).

Citation

If you use the module files in this repository for your analysis please you can cite the nf-core publication as follows:

The nf-core framework for community-curated bioinformatics pipelines.

Philip Ewels, Alexander Peltzer, Sven Fillinger, Harshil Patel, Johannes Alneberg, Andreas Wilm, Maxime Ulysse Garcia, Paolo Di Tommaso & Sven Nahnsen.

Nat Biotechnol. 2020 Feb 13. doi: 10.1038/s41587-020-0439-x.