diff --git a/.github/.dockstore.yml b/.github/.dockstore.yml
index 030138a0ca97a91f378c4cd4d55e79ac4de1dc55..191fabd22a5c81f1db00e56be6e712ef01451512 100644
--- a/.github/.dockstore.yml
+++ b/.github/.dockstore.yml
@@ -3,3 +3,4 @@ version: 1.2
workflows:
- subclass: nfl
primaryDescriptorPath: /nextflow.config
+ publish: True
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index 25ef2ed3c3c87f3ab115e92de6d830fdb6718b4d..284970f00a1e6d4fa739c1faa0805642fdc0668f 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -69,7 +69,7 @@ If you wish to contribute a new step, please use the following coding standards:
2. Write the process block (see below).
3. Define the output channel if needed (see below).
4. Add any new flags/options to `nextflow.config` with a default (see below).
-5. Add any new flags/options to `nextflow_schema.json` with help text (with `nf-core schema build .`)
+5. Add any new flags/options to `nextflow_schema.json` with help text (with `nf-core schema build .`).
6. Add any new flags/options to the help message (for integer/text parameters, print to help the corresponding `nextflow.config` parameter).
7. Add sanity checks for all relevant parameters.
8. Add any new software to the `scrape_software_versions.py` script in `bin/` and the version command to the `scrape_software_versions` process in `main.nf`.
@@ -87,7 +87,7 @@ Once there, use `nf-core schema build .` to add to `nextflow_schema.json`.
### Default processes resource requirements
-Sensible defaults for process resource requirements (CPUs / memory / time) for a process should be defined in `conf/base.config`. These should generally be specified generic with `withLabel:` selectors so they can be shared across multiple processes/steps of the pipeline. A nf-core standard set of labels that should be followed where possible can be seen in the [nf-core pipeline template](https://github.com/nf-core/tools/blob/master/nf_core/pipeline-template/%7B%7Bcookiecutter.name_noslash%7D%7D/conf/base.config), which has the default process as a single core-process, and then different levels of multi-core configurations for increasingly large memory requirements defined with standardised labels.
+Sensible defaults for process resource requirements (CPUs / memory / time) for a process should be defined in `conf/base.config`. These should generally be specified generic with `withLabel:` selectors so they can be shared across multiple processes/steps of the pipeline. A nf-core standard set of labels that should be followed where possible can be seen in the [nf-core pipeline template](https://github.com/nf-core/tools/blob/master/nf_core/pipeline-template/conf/base.config), which has the default process as a single core-process, and then different levels of multi-core configurations for increasingly large memory requirements defined with standardised labels.
The process resources can be passed on to the tool dynamically within the process with the `${task.cpu}` and `${task.memory}` variables in the `script:` block.
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 5ac2f7f52734df2cde27f756dcf7de5e4525463c..eeaa8479de91fb0b11752b812570bdb062fd1b40 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -55,7 +55,7 @@ Have you provided the following extra information/files:
## Container engine
-- Engine: <!-- [e.g. Conda, Docker, Singularity or Podman] -->
+- Engine: <!-- [e.g. Conda, Docker, Singularity, Podman, Shifter or Charliecloud] -->
- version: <!-- [e.g. 1.0.0] -->
- Image tag: <!-- [e.g. nfcore/hic:1.0.0] -->
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index 2e01a5fe11f6ed4f3e5bfb4bcaff8c8b7bdc56d5..2cec9b3b778f87d420a0d124094557fe5b8efadf 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -1,6 +1,6 @@
---
name: Feature request
-about: Suggest an idea for the nf-core website
+about: Suggest an idea for the nf-core/hic pipeline
labels: enhancement
---
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 1b480fa1ad0db48ab9e5e605f11ec859944778be..0fc5c61df27df619c3fc7a9e7e920622568ef2c1 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -15,9 +15,9 @@ Learn more about contributing: [CONTRIBUTING.md](https://github.com/nf-core/hic/
- [ ] This comment contains a description of changes (with reason).
- [ ] If you've fixed a bug or added code that should be tested, add tests!
- - [ ] If you've added a new tool - add to the software_versions process and a regex to `scrape_software_versions.py`
- - [ ] If you've added a new tool - have you followed the pipeline conventions in the [contribution docs](https://github.com/nf-core/hic/tree/master/.github/CONTRIBUTING.md)
- - [ ] If necessary, also make a PR on the nf-core/hic _branch_ on the [nf-core/test-datasets](https://github.com/nf-core/test-datasets) repository.
+ - [ ] If you've added a new tool - add to the software_versions process and a regex to `scrape_software_versions.py`
+ - [ ] If you've added a new tool - have you followed the pipeline conventions in the [contribution docs](https://github.com/nf-core/hic/tree/master/.github/CONTRIBUTING.md)
+ - [ ] If necessary, also make a PR on the nf-core/hic _branch_ on the [nf-core/test-datasets](https://github.com/nf-core/test-datasets) repository.
- [ ] Make sure your code lints (`nf-core lint .`).
- [ ] Ensure the test suite passes (`nextflow run . -profile test,docker`).
- [ ] Usage Documentation in `docs/usage.md` is updated.
diff --git a/.github/workflows/awsfulltest.yml b/.github/workflows/awsfulltest.yml
index e63ea697aa1c0b27438360e3186e6ddaf2b4afee..685ae01217ed0ffc1101589d1faad35b1edfbcf7 100644
--- a/.github/workflows/awsfulltest.yml
+++ b/.github/workflows/awsfulltest.yml
@@ -9,6 +9,16 @@ on:
types: [completed]
workflow_dispatch:
+
+env:
+ AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+ AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+ TOWER_ACCESS_TOKEN: ${{ secrets.AWS_TOWER_TOKEN }}
+ AWS_JOB_DEFINITION: ${{ secrets.AWS_JOB_DEFINITION }}
+ AWS_JOB_QUEUE: ${{ secrets.AWS_JOB_QUEUE }}
+ AWS_S3_BUCKET: ${{ secrets.AWS_S3_BUCKET }}
+
+
jobs:
run-awstest:
name: Run AWS full tests
@@ -27,13 +37,6 @@ jobs:
# Add full size test data (but still relatively small datasets for few samples)
# on the `test_full.config` test runs with only one set of parameters
# Then specify `-profile test_full` instead of `-profile test` on the AWS batch command
- env:
- AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
- AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
- TOWER_ACCESS_TOKEN: ${{ secrets.AWS_TOWER_TOKEN }}
- AWS_JOB_DEFINITION: ${{ secrets.AWS_JOB_DEFINITION }}
- AWS_JOB_QUEUE: ${{ secrets.AWS_JOB_QUEUE }}
- AWS_S3_BUCKET: ${{ secrets.AWS_S3_BUCKET }}
run: |
aws batch submit-job \
--region eu-west-1 \
diff --git a/.github/workflows/awstest.yml b/.github/workflows/awstest.yml
index 92dfa0ddccbebce1ffae4aca4d631f295cb0e601..d8ab46bc220758ab7c72f0a261e88ce03670bf46 100644
--- a/.github/workflows/awstest.yml
+++ b/.github/workflows/awstest.yml
@@ -6,6 +6,16 @@ name: nf-core AWS test
on:
workflow_dispatch:
+
+env:
+ AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+ AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+ TOWER_ACCESS_TOKEN: ${{ secrets.AWS_TOWER_TOKEN }}
+ AWS_JOB_DEFINITION: ${{ secrets.AWS_JOB_DEFINITION }}
+ AWS_JOB_QUEUE: ${{ secrets.AWS_JOB_QUEUE }}
+ AWS_S3_BUCKET: ${{ secrets.AWS_S3_BUCKET }}
+
+
jobs:
run-awstest:
name: Run AWS tests
@@ -23,13 +33,6 @@ jobs:
# TODO nf-core: You can customise CI pipeline run tests as required
# For example: adding multiple test runs with different parameters
# Remember that you can parallelise this by using strategy.matrix
- env:
- AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
- AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
- TOWER_ACCESS_TOKEN: ${{ secrets.AWS_TOWER_TOKEN }}
- AWS_JOB_DEFINITION: ${{ secrets.AWS_JOB_DEFINITION }}
- AWS_JOB_QUEUE: ${{ secrets.AWS_JOB_QUEUE }}
- AWS_S3_BUCKET: ${{ secrets.AWS_S3_BUCKET }}
run: |
aws batch submit-job \
--region eu-west-1 \
diff --git a/.github/workflows/branch.yml b/.github/workflows/branch.yml
index 92136a144c3e48bc1a11a7c893f2d69f958dd65d..abe9201125b69bddd80b4589f756aaecbd940020 100644
--- a/.github/workflows/branch.yml
+++ b/.github/workflows/branch.yml
@@ -13,7 +13,7 @@ jobs:
- name: Check PRs
if: github.repository == 'nf-core/hic'
run: |
- { [[ ${{github.event.pull_request.head.repo.full_name}} == nf-core/hic ]] && [[ $GITHUB_HEAD_REF = "dev" ]]; } || [[ $GITHUB_HEAD_REF == "patch" ]]
+ { [[ ${{github.event.pull_request.head.repo.full_name }} == nf-core/hic ]] && [[ $GITHUB_HEAD_REF = "dev" ]]; } || [[ $GITHUB_HEAD_REF == "patch" ]]
# If the above check failed, post a comment on the PR explaining the failure
@@ -25,11 +25,12 @@ jobs:
message: |
Hi @${{ github.event.pull_request.user.login }},
- It looks like this pull-request is has been made against the ${{github.event.pull_request.head.repo.full_name}} `master` branch.
+ It looks like this pull-request is has been made against the ${{github.event.pull_request.base.repo.full_name }} `master` branch.
The `master` branch on nf-core repositories should always contain code from the latest release.
- Because of this, PRs to `master` are only allowed if they come from the ${{github.event.pull_request.head.repo.full_name}} `dev` branch.
+ Because of this, PRs to `master` are only allowed if they come from the ${{github.event.pull_request.base.repo.full_name }} `dev` branch.
You do not need to close this PR, you can change the target branch to `dev` by clicking the _"Edit"_ button at the top of this page.
+ Note that even after this, the test will continue to show as failing until you push a new commit.
Thanks again for your contribution!
repo-token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml
index bef81e61905d8f265c06b7001c3c17d56d03ba4a..58e281df6ec884a17db31160853ca23d4ed160f1 100644
--- a/.github/workflows/linting.yml
+++ b/.github/workflows/linting.yml
@@ -69,7 +69,7 @@ jobs:
if: ${{ always() }}
uses: actions/upload-artifact@v2
with:
- name: linting-log-file
+ name: linting-logs
path: |
lint_log.txt
lint_results.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b84d61496f6c71409a4dd0df010a196e400cc338..d11259a2ad55442ea006ced96d7821314349d9e8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,7 +3,7 @@
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-## v1.0dev - [date]
+## v1.3.0dev - [date]
Initial release of nf-core/hic, created with the [nf-core](https://nf-co.re/) template.
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index 405fb1bfd7f0d022a8cee036dab43e72b8af871d..f4fd052f1f1708b3c07343d19575b1e001e2928a 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -1,46 +1,111 @@
-# Contributor Covenant Code of Conduct
+# Code of Conduct at nf-core (v1.0)
## Our Pledge
-In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+In the interest of fostering an open, collaborative, and welcoming environment, we as contributors and maintainers of nf-core, pledge to making participation in our projects and community a harassment-free experience for everyone, regardless of:
-## Our Standards
+- Age
+- Body size
+- Familial status
+- Gender identity and expression
+- Geographical location
+- Level of experience
+- Nationality and national origins
+- Native language
+- Physical and neurological ability
+- Race or ethnicity
+- Religion
+- Sexual identity and orientation
+- Socioeconomic status
-Examples of behavior that contributes to creating a positive environment include:
+Please note that the list above is alphabetised and is therefore not ranked in any order of preference or importance.
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+## Preamble
-Examples of unacceptable behavior by participants include:
+> Note: This Code of Conduct (CoC) has been drafted by the nf-core Safety Officer and been edited after input from members of the nf-core team and others. "We", in this document, refers to the Safety Officer and members of the nf-core core team, both of whom are deemed to be members of the nf-core community and are therefore required to abide by this Code of Conduct. This document will amended periodically to keep it up-to-date, and in case of any dispute, the most current version will apply.
-* The use of sexualized language or imagery and unwelcome sexual attention or advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a professional setting
+An up-to-date list of members of the nf-core core team can be found [here](https://nf-co.re/about). Our current safety officer is Renuka Kudva.
+
+nf-core is a young and growing community that welcomes contributions from anyone with a shared vision for [Open Science Policies](https://www.fosteropenscience.eu/taxonomy/term/8). Open science policies encompass inclusive behaviours and we strive to build and maintain a safe and inclusive environment for all individuals.
+
+We have therefore adopted this code of conduct (CoC), which we require all members of our community and attendees in nf-core events to adhere to in all our workspaces at all times. Workspaces include but are not limited to Slack, meetings on Zoom, Jitsi, YouTube live etc.
+
+Our CoC will be strictly enforced and the nf-core team reserve the right to exclude participants who do not comply with our guidelines from our workspaces and future nf-core activities.
+
+We ask all members of our community to help maintain a supportive and productive workspace and to avoid behaviours that can make individuals feel unsafe or unwelcome. Please help us maintain and uphold this CoC.
+
+Questions, concerns or ideas on what we can include? Contact safety [at] nf-co [dot] re
## Our Responsibilities
-Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+The safety officer is responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behaviour.
+
+The safety officer in consultation with the nf-core core team have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+Members of the core team or the safety officer who violate the CoC will be required to recuse themselves pending investigation. They will not have access to any reports of the violations and be subject to the same actions as others in violation of the CoC.
+
+## When are where does this Code of Conduct apply?
+
+Participation in the nf-core community is contingent on following these guidelines in all our workspaces and events. This includes but is not limited to the following listed alphabetically and therefore in no order of preference:
+
+- Communicating with an official project email address.
+- Communicating with community members within the nf-core Slack channel.
+- Participating in hackathons organised by nf-core (both online and in-person events).
+- Participating in collaborative work on GitHub, Google Suite, community calls, mentorship meetings, email correspondence.
+- Participating in workshops, training, and seminar series organised by nf-core (both online and in-person events). This applies to events hosted on web-based platforms such as Zoom, Jitsi, YouTube live etc.
+- Representing nf-core on social media. This includes both official and personal accounts.
+
+## nf-core cares š
+
+nf-core's CoC and expectations of respectful behaviours for all participants (including organisers and the nf-core team) include but are not limited to the following (listed in alphabetical order):
+
+- Ask for consent before sharing another community memberās personal information (including photographs) on social media.
+- Be respectful of differing viewpoints and experiences. We are all here to learn from one another and a difference in opinion can present a good learning opportunity.
+- Celebrate your accomplishments at events! (Get creative with your use of emojis š š„³ šÆ š !)
+- Demonstrate empathy towards other community members. (We donāt all have the same amount of time to dedicate to nf-core. If tasks are pending, donāt hesitate to gently remind members of your team. If you are leading a task, ask for help if you feel overwhelmed.)
+- Engage with and enquire after others. (This is especially important given the geographically remote nature of the nf-core community, so letās do this the best we can)
+- Focus on what is best for the team and the community. (When in doubt, ask)
+- Graciously accept constructive criticism, yet be unafraid to question, deliberate, and learn.
+- Introduce yourself to members of the community. (Weāve all been outsiders and we know that talking to strangers can be hard for some, but remember weāre interested in getting to know you and your visions for open science!)
+- Show appreciation and **provide clear feedback**. (This is especially important because we donāt see each other in person and it can be harder to interpret subtleties. Also remember that not everyone understands a certain language to the same extent as you do, so **be clear in your communications to be kind.**)
+- Take breaks when you feel like you need them.
+- Using welcoming and inclusive language. (Participants are encouraged to display their chosen pronouns on Zoom or in communication on Slack.)
+
+## nf-core frowns on š
+
+The following behaviours from any participants within the nf-core community (including the organisers) will be considered unacceptable under this code of conduct. Engaging or advocating for any of the following could result in expulsion from nf-core workspaces.
+
+- Deliberate intimidation, stalking or following and sustained disruption of communication among participants of the community. This includes hijacking shared screens through actions such as using the annotate tool in conferencing software such as Zoom.
+- āDoxingā i.e. posting (or threatening to post) another personās personal identifying information online.
+- Spamming or trolling of individuals on social media.
+- Use of sexual or discriminatory imagery, comments, or jokes and unwelcome sexual attention.
+- Verbal and text comments that reinforce social structures of domination related to gender, gender identity and expression, sexual orientation, ability, physical appearance, body size, race, age, religion or work experience.
+
+### Online Trolling
+
+The majority of nf-core interactions and events are held online. Unfortunately, holding events online comes with the added issue of online trolling. This is unacceptable, reports of such behaviour will be taken very seriously, and perpetrators will be excluded from activities immediately.
+
+All community members are required to ask members of the group they are working within for explicit consent prior to taking screenshots of individuals during video calls.
+
+## Procedures for Reporting CoC violations
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+If someone makes you feel uncomfortable through their behaviours or actions, report it as soon as possible.
-## Scope
+You can reach out to members of the [nf-core core team](https://nf-co.re/about) and they will forward your concerns to the safety officer(s).
-This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+Issues directly concerning members of the core team will be dealt with by other members of the core team and the safety manager, and possible conflicts of interest will be taken into account. nf-core is also in discussions about having an ombudsperson, and details will be shared in due course.
-## Enforcement
+All reports will be handled with utmost discretion and confidentially.
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team on [Slack](https://nf-co.re/join/slack). The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+## Attribution and Acknowledgements
-Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+- The [Contributor Covenant, version 1.4](http://contributor-covenant.org/version/1/4)
+- The [OpenCon 2017 Code of Conduct](http://www.opencon2017.org/code_of_conduct) (CC BY 4.0 OpenCon organisers, SPARC and Right to Research Coalition)
+- The [eLife innovation sprint 2020 Code of Conduct](https://sprint.elifesciences.org/code-of-conduct/)
+- The [Mozilla Community Participation Guidelines v3.1](https://www.mozilla.org/en-US/about/governance/policies/participation/) (version 3.1, CC BY-SA 3.0 Mozilla)
-## Attribution
+## Changelog
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [https://www.contributor-covenant.org/version/1/4/code-of-conduct/][version]
+### v1.0 - March 12th, 2021
-[homepage]: https://contributor-covenant.org
-[version]: https://www.contributor-covenant.org/version/1/4/code-of-conduct/
+- Complete rewrite from original [Contributor Covenant](http://contributor-covenant.org/) CoC.
diff --git a/Dockerfile b/Dockerfile
index 1a375e9e6d0474746e7ba47ea2da86430f9db935..5a85bb751a7826c8c6a3d1e3bfff0445df8d5313 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,4 +1,4 @@
-FROM nfcore/base:1.12.1
+FROM nfcore/base:1.13
LABEL authors="Nicolas Servant" \
description="Docker image containing all software requirements for the nf-core/hic pipeline"
@@ -7,11 +7,7 @@ COPY environment.yml /
RUN conda env create --quiet -f /environment.yml && conda clean -a
# Add conda installation dir to PATH (instead of doing 'conda activate')
-ENV PATH /opt/conda/envs/nf-core-hic-1.0dev/bin:$PATH
+ENV PATH /opt/conda/envs/nf-core-hic-1.3.0dev/bin:$PATH
# Dump the details of the installed packages to a file for posterity
-RUN conda env export --name nf-core-hic-1.0dev > nf-core-hic-1.0dev.yml
-
-# Instruct R processes to use these empty files instead of clashing with a local version
-RUN touch .Rprofile
-RUN touch .Renviron
+RUN conda env export --name nf-core-hic-1.3.0dev > nf-core-hic-1.3.0dev.yml
diff --git a/README.md b/README.md
index 30fc4b365283cbe229f28b142c3033f2376c12bb..2a167090cc579eb8aa1159fb69f06c94960e61c5 100644
--- a/README.md
+++ b/README.md
@@ -21,12 +21,12 @@ The pipeline is built using [Nextflow](https://www.nextflow.io), a workflow tool
1. Install [`nextflow`](https://nf-co.re/usage/installation)
-2. Install any of [`Docker`](https://docs.docker.com/engine/installation/), [`Singularity`](https://www.sylabs.io/guides/3.0/user-guide/) or [`Podman`](https://podman.io/) for full pipeline reproducibility _(please only use [`Conda`](https://conda.io/miniconda.html) as a last resort; see [docs](https://nf-co.re/usage/configuration#basic-configuration-profiles))_
+2. Install any of [`Docker`](https://docs.docker.com/engine/installation/), [`Singularity`](https://www.sylabs.io/guides/3.0/user-guide/), [`Podman`](https://podman.io/), [`Shifter`](https://nersc.gitlab.io/development/shifter/how-to-use/) or [`Charliecloud`](https://hpc.github.io/charliecloud/) for full pipeline reproducibility _(please only use [`Conda`](https://conda.io/miniconda.html) as a last resort; see [docs](https://nf-co.re/usage/configuration#basic-configuration-profiles))_
3. Download the pipeline and test it on a minimal dataset with a single command:
```bash
- nextflow run nf-core/hic -profile test,<docker/singularity/podman/conda/institute>
+ nextflow run nf-core/hic -profile test,<docker/singularity/podman/shifter/charliecloud/conda/institute>
```
> Please check [nf-core/configs](https://github.com/nf-core/configs#documentation) to see if a custom config file to run nf-core pipelines already exists for your Institute. If so, you can simply use `-profile <institute>` in your command. This will enable either `docker` or `singularity` and set the appropriate execution settings for your local compute environment.
@@ -36,7 +36,7 @@ The pipeline is built using [Nextflow](https://www.nextflow.io), a workflow tool
<!-- TODO nf-core: Update the example "typical command" below used to run the pipeline -->
```bash
- nextflow run nf-core/hic -profile <docker/singularity/podman/conda/institute> --input '*_R{1,2}.fastq.gz' --genome GRCh37
+ nextflow run nf-core/hic -profile <docker/singularity/podman/shifter/charliecloud/conda/institute> --input '*_R{1,2}.fastq.gz' --genome GRCh37
```
See [usage docs](https://nf-co.re/hic/usage) for all of the available options when running the pipeline.
@@ -83,7 +83,6 @@ You can cite the `nf-core` publication as follows:
> 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](https://dx.doi.org/10.1038/s41587-020-0439-x).
-> ReadCube: [Full Access Link](https://rdcu.be/b1GjZ)
In addition, references of tools and data used in this pipeline are as follows:
diff --git a/assets/email_template.html b/assets/email_template.html
index 177bccd2d802d3a11e2e6ca606e72ac19968126b..d207f011f3ab74ac04ace7a4e277c59900cf058a 100644
--- a/assets/email_template.html
+++ b/assets/email_template.html
@@ -1,6 +1,5 @@
<html>
<head>
- <head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
diff --git a/bin/markdown_to_html.py b/bin/markdown_to_html.py
old mode 100755
new mode 100644
diff --git a/bin/scrape_software_versions.py b/bin/scrape_software_versions.py
old mode 100755
new mode 100644
diff --git a/conf/base.config b/conf/base.config
index 0b2ea226659efbfec4eb0289d8880a6e9df3c8b6..07aaa866f6c83b96dda659d3253e6a31e71900a7 100644
--- a/conf/base.config
+++ b/conf/base.config
@@ -47,5 +47,5 @@ process {
withName:get_software_versions {
cache = false
}
-
+
}
diff --git a/conf/test.config b/conf/test.config
index 02f48cb2238a0a51c70442ee2d0571f364d1218c..6fb6dcef9ca689e80f9bd04fccb0ced82d289504 100644
--- a/conf/test.config
+++ b/conf/test.config
@@ -23,4 +23,6 @@ params {
['Testdata', ['https://github.com/nf-core/test-datasets/raw/exoseq/testdata/Testdata_R1.tiny.fastq.gz', 'https://github.com/nf-core/test-datasets/raw/exoseq/testdata/Testdata_R2.tiny.fastq.gz']],
['SRR389222', ['https://github.com/nf-core/test-datasets/raw/methylseq/testdata/SRR389222_sub1.fastq.gz', 'https://github.com/nf-core/test-datasets/raw/methylseq/testdata/SRR389222_sub2.fastq.gz']]
]
+ // Ignore `--input` as otherwise the parameter validation will throw an error
+ schema_ignore_params = 'genomes,input_paths,input'
}
diff --git a/conf/test_full.config b/conf/test_full.config
index 921372eec05fe6147c540a39463c54f0ebf09bce..b5fabaab29f342773efc5558bc2c2d8715908bde 100644
--- a/conf/test_full.config
+++ b/conf/test_full.config
@@ -19,4 +19,6 @@ params {
['Testdata', ['https://github.com/nf-core/test-datasets/raw/exoseq/testdata/Testdata_R1.tiny.fastq.gz', 'https://github.com/nf-core/test-datasets/raw/exoseq/testdata/Testdata_R2.tiny.fastq.gz']],
['SRR389222', ['https://github.com/nf-core/test-datasets/raw/methylseq/testdata/SRR389222_sub1.fastq.gz', 'https://github.com/nf-core/test-datasets/raw/methylseq/testdata/SRR389222_sub2.fastq.gz']]
]
+ // Ignore `--input` as otherwise the parameter validation will throw an error
+ schema_ignore_params = 'genomes,input_paths,input'
}
diff --git a/docs/output.md b/docs/output.md
index 4a7372e92d17cf7897c93fb403d6bd41c2bc2f29..238d7eb935a46e1fb58d79895a10913bf55a50aa 100644
--- a/docs/output.md
+++ b/docs/output.md
@@ -1,9 +1,5 @@
# nf-core/hic: Output
-## :warning: Please read this documentation on the nf-core website: [https://nf-co.re/hic/output](https://nf-co.re/hic/output)
-
-> _Documentation of pipeline parameters is generated automatically from the pipeline schema and can no longer be found in markdown files._
-
## Introduction
This document describes the output produced by the pipeline. Most of the plots are taken from the MultiQC report, which summarises results at the end of the pipeline.
diff --git a/docs/usage.md b/docs/usage.md
index 76803ddcd3e60bf2dc060ced21e610abf5cff261..45a94e94cd157b813ddf6076a6c6c2b8eadfb221 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -51,7 +51,7 @@ This version number will be logged in reports when you run the pipeline, so that
Use this parameter to choose a configuration profile. Profiles can give configuration presets for different compute environments.
-Several generic profiles are bundled with the pipeline which instruct the pipeline to use software packaged using different methods (Docker, Singularity, Podman, Conda) - see below.
+Several generic profiles are bundled with the pipeline which instruct the pipeline to use software packaged using different methods (Docker, Singularity, Podman, Shifter, Charliecloud, Conda) - see below.
> We highly recommend the use of Docker or Singularity containers for full pipeline reproducibility, however when this is not possible, Conda is also supported.
@@ -71,8 +71,14 @@ If `-profile` is not specified, the pipeline will run locally and expect all sof
* `podman`
* A generic configuration profile to be used with [Podman](https://podman.io/)
* Pulls software from Docker Hub: [`nfcore/hic`](https://hub.docker.com/r/nfcore/hic/)
+* `shifter`
+ * A generic configuration profile to be used with [Shifter](https://nersc.gitlab.io/development/shifter/how-to-use/)
+ * Pulls software from Docker Hub: [`nfcore/hic`](https://hub.docker.com/r/nfcore/hic/)
+* `charliecloud`
+ * A generic configuration profile to be used with [Charliecloud](https://hpc.github.io/charliecloud/)
+ * Pulls software from Docker Hub: [`nfcore/hic`](https://hub.docker.com/r/nfcore/hic/)
* `conda`
- * Please only use Conda as a last resort i.e. when it's not possible to run the pipeline with Docker, Singularity or Podman.
+ * Please only use Conda as a last resort i.e. when it's not possible to run the pipeline with Docker, Singularity, Podman, Shifter or Charliecloud.
* A generic configuration profile to be used with [Conda](https://conda.io/docs/)
* Pulls most software from [Bioconda](https://bioconda.github.io/)
* `test`
@@ -103,6 +109,8 @@ process {
}
```
+To find the exact name of a process you wish to modify the compute resources, check the live-status of a nextflow run displayed on your terminal or check the nextflow error for a line like so: `Error executing process > 'bwa'`. In this case the name to specify in the custom config file is `bwa`.
+
See the main [Nextflow documentation](https://www.nextflow.io/docs/latest/config.html) for more information.
If you are likely to be running `nf-core` pipelines regularly it may be a good idea to request that your custom config file is uploaded to the `nf-core/configs` git repository. Before you do this please can you test that the config file works with your pipeline of choice using the `-c` parameter (see definition above). You can then create a pull request to the `nf-core/configs` repository with the addition of your config file, associated documentation file (see examples in [`nf-core/configs/docs`](https://github.com/nf-core/configs/tree/master/docs)), and amending [`nfcore_custom.config`](https://github.com/nf-core/configs/blob/master/nfcore_custom.config) to include your custom profile.
diff --git a/environment.yml b/environment.yml
index 9d3cc672fa52d0b8a8388fbce901768c9e4c1870..cde6a0c58bdaea5d3a9c55b167d26df11441799e 100644
--- a/environment.yml
+++ b/environment.yml
@@ -1,6 +1,6 @@
# You can use this file to create a conda environment for this pipeline:
# conda env create -f environment.yml
-name: nf-core-hic-1.0dev
+name: nf-core-hic-1.3.0dev
channels:
- conda-forge
- bioconda
diff --git a/lib/Headers.groovy b/lib/Headers.groovy
new file mode 100644
index 0000000000000000000000000000000000000000..15d1d388006df42e226aea961f0d21dbdabaa8cb
--- /dev/null
+++ b/lib/Headers.groovy
@@ -0,0 +1,43 @@
+/*
+ * This file holds several functions used to render the nf-core ANSI header.
+ */
+
+class Headers {
+
+ private static Map log_colours(Boolean monochrome_logs) {
+ Map colorcodes = [:]
+ colorcodes['reset'] = monochrome_logs ? '' : "\033[0m"
+ colorcodes['dim'] = monochrome_logs ? '' : "\033[2m"
+ colorcodes['black'] = monochrome_logs ? '' : "\033[0;30m"
+ colorcodes['green'] = monochrome_logs ? '' : "\033[0;32m"
+ colorcodes['yellow'] = monochrome_logs ? '' : "\033[0;33m"
+ colorcodes['yellow_bold'] = monochrome_logs ? '' : "\033[1;93m"
+ colorcodes['blue'] = monochrome_logs ? '' : "\033[0;34m"
+ colorcodes['purple'] = monochrome_logs ? '' : "\033[0;35m"
+ colorcodes['cyan'] = monochrome_logs ? '' : "\033[0;36m"
+ colorcodes['white'] = monochrome_logs ? '' : "\033[0;37m"
+ colorcodes['red'] = monochrome_logs ? '' : "\033[1;91m"
+ return colorcodes
+ }
+
+ static String dashed_line(monochrome_logs) {
+ Map colors = log_colours(monochrome_logs)
+ return "-${colors.dim}----------------------------------------------------${colors.reset}-"
+ }
+
+ static String nf_core(workflow, monochrome_logs) {
+ Map colors = log_colours(monochrome_logs)
+ String.format(
+ """\n
+ ${dashed_line(monochrome_logs)}
+ ${colors.green},--.${colors.black}/${colors.green},-.${colors.reset}
+ ${colors.blue} ___ __ __ __ ___ ${colors.green}/,-._.--~\'${colors.reset}
+ ${colors.blue} |\\ | |__ __ / ` / \\ |__) |__ ${colors.yellow}} {${colors.reset}
+ ${colors.blue} | \\| | \\__, \\__/ | \\ |___ ${colors.green}\\`-._,-`-,${colors.reset}
+ ${colors.green}`._,._,\'${colors.reset}
+ ${colors.purple} ${workflow.manifest.name} v${workflow.manifest.version}${colors.reset}
+ ${dashed_line(monochrome_logs)}
+ """.stripIndent()
+ )
+ }
+}
diff --git a/lib/NfcoreSchema.groovy b/lib/NfcoreSchema.groovy
new file mode 100644
index 0000000000000000000000000000000000000000..78e8c65d7f2f45b8b503cfeca4aa83b2e22b7404
--- /dev/null
+++ b/lib/NfcoreSchema.groovy
@@ -0,0 +1,571 @@
+/*
+ * This file holds several functions used to perform JSON parameter validation, help and summary rendering for the nf-core pipeline template.
+ */
+
+import org.everit.json.schema.Schema
+import org.everit.json.schema.loader.SchemaLoader
+import org.everit.json.schema.ValidationException
+import org.json.JSONObject
+import org.json.JSONTokener
+import org.json.JSONArray
+import groovy.json.JsonSlurper
+import groovy.json.JsonBuilder
+
+class NfcoreSchema {
+
+ /*
+ * Function to loop over all parameters defined in schema and check
+ * whether the given paremeters adhere to the specificiations
+ */
+ /* groovylint-disable-next-line UnusedPrivateMethodParameter */
+ private static void validateParameters(params, jsonSchema, log) {
+ def has_error = false
+ //=====================================================================//
+ // Check for nextflow core params and unexpected params
+ def json = new File(jsonSchema).text
+ def Map schemaParams = (Map) new JsonSlurper().parseText(json).get('definitions')
+ def nf_params = [
+ // Options for base `nextflow` command
+ 'bg',
+ 'c',
+ 'C',
+ 'config',
+ 'd',
+ 'D',
+ 'dockerize',
+ 'h',
+ 'log',
+ 'q',
+ 'quiet',
+ 'syslog',
+ 'v',
+ 'version',
+
+ // Options for `nextflow run` command
+ 'ansi',
+ 'ansi-log',
+ 'bg',
+ 'bucket-dir',
+ 'c',
+ 'cache',
+ 'config',
+ 'dsl2',
+ 'dump-channels',
+ 'dump-hashes',
+ 'E',
+ 'entry',
+ 'latest',
+ 'lib',
+ 'main-script',
+ 'N',
+ 'name',
+ 'offline',
+ 'params-file',
+ 'pi',
+ 'plugins',
+ 'poll-interval',
+ 'pool-size',
+ 'profile',
+ 'ps',
+ 'qs',
+ 'queue-size',
+ 'r',
+ 'resume',
+ 'revision',
+ 'stdin',
+ 'stub',
+ 'stub-run',
+ 'test',
+ 'w',
+ 'with-charliecloud',
+ 'with-conda',
+ 'with-dag',
+ 'with-docker',
+ 'with-mpi',
+ 'with-notification',
+ 'with-podman',
+ 'with-report',
+ 'with-singularity',
+ 'with-timeline',
+ 'with-tower',
+ 'with-trace',
+ 'with-weblog',
+ 'without-docker',
+ 'without-podman',
+ 'work-dir'
+ ]
+ def unexpectedParams = []
+
+ // Collect expected parameters from the schema
+ def expectedParams = []
+ for (group in schemaParams) {
+ for (p in group.value['properties']) {
+ expectedParams.push(p.key)
+ }
+ }
+
+ for (specifiedParam in params.keySet()) {
+ // nextflow params
+ if (nf_params.contains(specifiedParam)) {
+ log.error "ERROR: You used a core Nextflow option with two hyphens: '--${specifiedParam}'. Please resubmit with '-${specifiedParam}'"
+ has_error = true
+ }
+ // unexpected params
+ def params_ignore = params.schema_ignore_params.split(',') + 'schema_ignore_params'
+ if (!expectedParams.contains(specifiedParam) && !params_ignore.contains(specifiedParam)) {
+ unexpectedParams.push(specifiedParam)
+ }
+ }
+
+ //=====================================================================//
+ // Validate parameters against the schema
+ InputStream inputStream = new File(jsonSchema).newInputStream()
+ JSONObject rawSchema = new JSONObject(new JSONTokener(inputStream))
+
+ // Remove anything that's in params.schema_ignore_params
+ rawSchema = removeIgnoredParams(rawSchema, params)
+
+ Schema schema = SchemaLoader.load(rawSchema)
+
+ // Clean the parameters
+ def cleanedParams = cleanParameters(params)
+
+ // Convert to JSONObject
+ def jsonParams = new JsonBuilder(cleanedParams)
+ JSONObject paramsJSON = new JSONObject(jsonParams.toString())
+
+ // Validate
+ try {
+ schema.validate(paramsJSON)
+ } catch (ValidationException e) {
+ println ''
+ log.error 'ERROR: Validation of pipeline parameters failed!'
+ JSONObject exceptionJSON = e.toJSON()
+ printExceptions(exceptionJSON, paramsJSON, log)
+ println ''
+ has_error = true
+ }
+
+ // Check for unexpected parameters
+ if (unexpectedParams.size() > 0) {
+ Map colors = log_colours(params.monochrome_logs)
+ println ''
+ def warn_msg = 'Found unexpected parameters:'
+ for (unexpectedParam in unexpectedParams) {
+ warn_msg = warn_msg + "\n* --${unexpectedParam}: ${params[unexpectedParam].toString()}"
+ }
+ log.warn warn_msg
+ log.info "- ${colors.dim}Ignore this warning: params.schema_ignore_params = \"${unexpectedParams.join(',')}\" ${colors.reset}"
+ println ''
+ }
+
+ if (has_error) {
+ System.exit(1)
+ }
+ }
+
+ // Loop over nested exceptions and print the causingException
+ private static void printExceptions(exJSON, paramsJSON, log) {
+ def causingExceptions = exJSON['causingExceptions']
+ if (causingExceptions.length() == 0) {
+ def m = exJSON['message'] =~ /required key \[([^\]]+)\] not found/
+ // Missing required param
+ if (m.matches()) {
+ log.error "* Missing required parameter: --${m[0][1]}"
+ }
+ // Other base-level error
+ else if (exJSON['pointerToViolation'] == '#') {
+ log.error "* ${exJSON['message']}"
+ }
+ // Error with specific param
+ else {
+ def param = exJSON['pointerToViolation'] - ~/^#\//
+ def param_val = paramsJSON[param].toString()
+ log.error "* --${param}: ${exJSON['message']} (${param_val})"
+ }
+ }
+ for (ex in causingExceptions) {
+ printExceptions(ex, paramsJSON, log)
+ }
+ }
+
+ // Remove an element from a JSONArray
+ private static JSONArray removeElement(jsonArray, element){
+ def list = []
+ int len = jsonArray.length()
+ for (int i=0;i<len;i++){
+ list.add(jsonArray.get(i).toString())
+ }
+ list.remove(element)
+ JSONArray jsArray = new JSONArray(list)
+ return jsArray
+ }
+
+ private static JSONObject removeIgnoredParams(rawSchema, params){
+ // Remove anything that's in params.schema_ignore_params
+ params.schema_ignore_params.split(',').each{ ignore_param ->
+ if(rawSchema.keySet().contains('definitions')){
+ rawSchema.definitions.each { definition ->
+ for (key in definition.keySet()){
+ if (definition[key].get("properties").keySet().contains(ignore_param)){
+ // Remove the param to ignore
+ definition[key].get("properties").remove(ignore_param)
+ // If the param was required, change this
+ if (definition[key].has("required")) {
+ def cleaned_required = removeElement(definition[key].required, ignore_param)
+ definition[key].put("required", cleaned_required)
+ }
+ }
+ }
+ }
+ }
+ if(rawSchema.keySet().contains('properties') && rawSchema.get('properties').containsKey(ignore_param)) {
+ rawSchema.get("properties").remove(ignore_param)
+ }
+ if(rawSchema.keySet().contains('required') && rawSchema.required.contains(ignore_param)) {
+ def cleaned_required = removeElement(rawSchema.required, ignore_param)
+ rawSchema.put("required", cleaned_required)
+ }
+ }
+ return rawSchema
+ }
+
+ private static Map cleanParameters(params) {
+ def new_params = params.getClass().newInstance(params)
+ for (p in params) {
+ // remove anything evaluating to false
+ if (!p['value']) {
+ new_params.remove(p.key)
+ }
+ // Cast MemoryUnit to String
+ if (p['value'].getClass() == nextflow.util.MemoryUnit) {
+ new_params.replace(p.key, p['value'].toString())
+ }
+ // Cast Duration to String
+ if (p['value'].getClass() == nextflow.util.Duration) {
+ new_params.replace(p.key, p['value'].toString())
+ }
+ // Cast LinkedHashMap to String
+ if (p['value'].getClass() == LinkedHashMap) {
+ new_params.replace(p.key, p['value'].toString())
+ }
+ }
+ return new_params
+ }
+
+ /*
+ * This method tries to read a JSON params file
+ */
+ private static LinkedHashMap params_load(String json_schema) {
+ def params_map = new LinkedHashMap()
+ try {
+ params_map = params_read(json_schema)
+ } catch (Exception e) {
+ println "Could not read parameters settings from JSON. $e"
+ params_map = new LinkedHashMap()
+ }
+ return params_map
+ }
+
+ private static Map log_colours(Boolean monochrome_logs) {
+ Map colorcodes = [:]
+
+ // Reset / Meta
+ colorcodes['reset'] = monochrome_logs ? '' : "\033[0m"
+ colorcodes['bold'] = monochrome_logs ? '' : "\033[1m"
+ colorcodes['dim'] = monochrome_logs ? '' : "\033[2m"
+ colorcodes['underlined'] = monochrome_logs ? '' : "\033[4m"
+ colorcodes['blink'] = monochrome_logs ? '' : "\033[5m"
+ colorcodes['reverse'] = monochrome_logs ? '' : "\033[7m"
+ colorcodes['hidden'] = monochrome_logs ? '' : "\033[8m"
+
+ // Regular Colors
+ colorcodes['black'] = monochrome_logs ? '' : "\033[0;30m"
+ colorcodes['red'] = monochrome_logs ? '' : "\033[0;31m"
+ colorcodes['green'] = monochrome_logs ? '' : "\033[0;32m"
+ colorcodes['yellow'] = monochrome_logs ? '' : "\033[0;33m"
+ colorcodes['blue'] = monochrome_logs ? '' : "\033[0;34m"
+ colorcodes['purple'] = monochrome_logs ? '' : "\033[0;35m"
+ colorcodes['cyan'] = monochrome_logs ? '' : "\033[0;36m"
+ colorcodes['white'] = monochrome_logs ? '' : "\033[0;37m"
+
+ // Bold
+ colorcodes['bblack'] = monochrome_logs ? '' : "\033[1;30m"
+ colorcodes['bred'] = monochrome_logs ? '' : "\033[1;31m"
+ colorcodes['bgreen'] = monochrome_logs ? '' : "\033[1;32m"
+ colorcodes['byellow'] = monochrome_logs ? '' : "\033[1;33m"
+ colorcodes['bblue'] = monochrome_logs ? '' : "\033[1;34m"
+ colorcodes['bpurple'] = monochrome_logs ? '' : "\033[1;35m"
+ colorcodes['bcyan'] = monochrome_logs ? '' : "\033[1;36m"
+ colorcodes['bwhite'] = monochrome_logs ? '' : "\033[1;37m"
+
+ // Underline
+ colorcodes['ublack'] = monochrome_logs ? '' : "\033[4;30m"
+ colorcodes['ured'] = monochrome_logs ? '' : "\033[4;31m"
+ colorcodes['ugreen'] = monochrome_logs ? '' : "\033[4;32m"
+ colorcodes['uyellow'] = monochrome_logs ? '' : "\033[4;33m"
+ colorcodes['ublue'] = monochrome_logs ? '' : "\033[4;34m"
+ colorcodes['upurple'] = monochrome_logs ? '' : "\033[4;35m"
+ colorcodes['ucyan'] = monochrome_logs ? '' : "\033[4;36m"
+ colorcodes['uwhite'] = monochrome_logs ? '' : "\033[4;37m"
+
+ // High Intensity
+ colorcodes['iblack'] = monochrome_logs ? '' : "\033[0;90m"
+ colorcodes['ired'] = monochrome_logs ? '' : "\033[0;91m"
+ colorcodes['igreen'] = monochrome_logs ? '' : "\033[0;92m"
+ colorcodes['iyellow'] = monochrome_logs ? '' : "\033[0;93m"
+ colorcodes['iblue'] = monochrome_logs ? '' : "\033[0;94m"
+ colorcodes['ipurple'] = monochrome_logs ? '' : "\033[0;95m"
+ colorcodes['icyan'] = monochrome_logs ? '' : "\033[0;96m"
+ colorcodes['iwhite'] = monochrome_logs ? '' : "\033[0;97m"
+
+ // Bold High Intensity
+ colorcodes['biblack'] = monochrome_logs ? '' : "\033[1;90m"
+ colorcodes['bired'] = monochrome_logs ? '' : "\033[1;91m"
+ colorcodes['bigreen'] = monochrome_logs ? '' : "\033[1;92m"
+ colorcodes['biyellow'] = monochrome_logs ? '' : "\033[1;93m"
+ colorcodes['biblue'] = monochrome_logs ? '' : "\033[1;94m"
+ colorcodes['bipurple'] = monochrome_logs ? '' : "\033[1;95m"
+ colorcodes['bicyan'] = monochrome_logs ? '' : "\033[1;96m"
+ colorcodes['biwhite'] = monochrome_logs ? '' : "\033[1;97m"
+
+ return colorcodes
+ }
+
+ static String dashed_line(monochrome_logs) {
+ Map colors = log_colours(monochrome_logs)
+ return "-${colors.dim}----------------------------------------------------${colors.reset}-"
+ }
+
+ /*
+ Method to actually read in JSON file using Groovy.
+ Group (as Key), values are all parameters
+ - Parameter1 as Key, Description as Value
+ - Parameter2 as Key, Description as Value
+ ....
+ Group
+ -
+ */
+ private static LinkedHashMap params_read(String json_schema) throws Exception {
+ def json = new File(json_schema).text
+ def Map schema_definitions = (Map) new JsonSlurper().parseText(json).get('definitions')
+ def Map schema_properties = (Map) new JsonSlurper().parseText(json).get('properties')
+ /* Tree looks like this in nf-core schema
+ * definitions <- this is what the first get('definitions') gets us
+ group 1
+ title
+ description
+ properties
+ parameter 1
+ type
+ description
+ parameter 2
+ type
+ description
+ group 2
+ title
+ description
+ properties
+ parameter 1
+ type
+ description
+ * properties <- parameters can also be ungrouped, outside of definitions
+ parameter 1
+ type
+ description
+ */
+
+ // Grouped params
+ def params_map = new LinkedHashMap()
+ schema_definitions.each { key, val ->
+ def Map group = schema_definitions."$key".properties // Gets the property object of the group
+ def title = schema_definitions."$key".title
+ def sub_params = new LinkedHashMap()
+ group.each { innerkey, value ->
+ sub_params.put(innerkey, value)
+ }
+ params_map.put(title, sub_params)
+ }
+
+ // Ungrouped params
+ def ungrouped_params = new LinkedHashMap()
+ schema_properties.each { innerkey, value ->
+ ungrouped_params.put(innerkey, value)
+ }
+ params_map.put("Other parameters", ungrouped_params)
+
+ return params_map
+ }
+
+ /*
+ * Get maximum number of characters across all parameter names
+ */
+ private static Integer params_max_chars(params_map) {
+ Integer max_chars = 0
+ for (group in params_map.keySet()) {
+ def group_params = params_map.get(group) // This gets the parameters of that particular group
+ for (param in group_params.keySet()) {
+ if (param.size() > max_chars) {
+ max_chars = param.size()
+ }
+ }
+ }
+ return max_chars
+ }
+
+ /*
+ * Beautify parameters for --help
+ */
+ private static String params_help(workflow, params, json_schema, command) {
+ Map colors = log_colours(params.monochrome_logs)
+ Integer num_hidden = 0
+ String output = ''
+ output += 'Typical pipeline command:\n\n'
+ output += " ${colors.cyan}${command}${colors.reset}\n\n"
+ Map params_map = params_load(json_schema)
+ Integer max_chars = params_max_chars(params_map) + 1
+ Integer desc_indent = max_chars + 14
+ Integer dec_linewidth = 160 - desc_indent
+ for (group in params_map.keySet()) {
+ Integer num_params = 0
+ String group_output = colors.underlined + colors.bold + group + colors.reset + '\n'
+ def group_params = params_map.get(group) // This gets the parameters of that particular group
+ for (param in group_params.keySet()) {
+ if (group_params.get(param).hidden && !params.show_hidden_params) {
+ num_hidden += 1
+ continue;
+ }
+ def type = '[' + group_params.get(param).type + ']'
+ def description = group_params.get(param).description
+ def defaultValue = group_params.get(param).default ? " [default: " + group_params.get(param).default.toString() + "]" : ''
+ def description_default = description + colors.dim + defaultValue + colors.reset
+ // Wrap long description texts
+ // Loosely based on https://dzone.com/articles/groovy-plain-text-word-wrap
+ if (description_default.length() > dec_linewidth){
+ List olines = []
+ String oline = "" // " " * indent
+ description_default.split(" ").each() { wrd ->
+ if ((oline.size() + wrd.size()) <= dec_linewidth) {
+ oline += wrd + " "
+ } else {
+ olines += oline
+ oline = wrd + " "
+ }
+ }
+ olines += oline
+ description_default = olines.join("\n" + " " * desc_indent)
+ }
+ group_output += " --" + param.padRight(max_chars) + colors.dim + type.padRight(10) + colors.reset + description_default + '\n'
+ num_params += 1
+ }
+ group_output += '\n'
+ if (num_params > 0){
+ output += group_output
+ }
+ }
+ output += dashed_line(params.monochrome_logs)
+ if (num_hidden > 0){
+ output += colors.dim + "\n Hiding $num_hidden params, use --show_hidden_params to show.\n" + colors.reset
+ output += dashed_line(params.monochrome_logs)
+ }
+ return output
+ }
+
+ /*
+ * Groovy Map summarising parameters/workflow options used by the pipeline
+ */
+ private static LinkedHashMap params_summary_map(workflow, params, json_schema) {
+ // Get a selection of core Nextflow workflow options
+ def Map workflow_summary = [:]
+ if (workflow.revision) {
+ workflow_summary['revision'] = workflow.revision
+ }
+ workflow_summary['runName'] = workflow.runName
+ if (workflow.containerEngine) {
+ workflow_summary['containerEngine'] = "$workflow.containerEngine"
+ }
+ if (workflow.container) {
+ workflow_summary['container'] = "$workflow.container"
+ }
+ workflow_summary['launchDir'] = workflow.launchDir
+ workflow_summary['workDir'] = workflow.workDir
+ workflow_summary['projectDir'] = workflow.projectDir
+ workflow_summary['userName'] = workflow.userName
+ workflow_summary['profile'] = workflow.profile
+ workflow_summary['configFiles'] = workflow.configFiles.join(', ')
+
+ // Get pipeline parameters defined in JSON Schema
+ def Map params_summary = [:]
+ def blacklist = ['hostnames']
+ def params_map = params_load(json_schema)
+ for (group in params_map.keySet()) {
+ def sub_params = new LinkedHashMap()
+ def group_params = params_map.get(group) // This gets the parameters of that particular group
+ for (param in group_params.keySet()) {
+ if (params.containsKey(param) && !blacklist.contains(param)) {
+ def params_value = params.get(param)
+ def schema_value = group_params.get(param).default
+ def param_type = group_params.get(param).type
+ if (schema_value == null) {
+ if (param_type == 'boolean') {
+ schema_value = false
+ }
+ if (param_type == 'string') {
+ schema_value = ''
+ }
+ if (param_type == 'integer') {
+ schema_value = 0
+ }
+ } else {
+ if (param_type == 'string') {
+ if (schema_value.contains('$projectDir') || schema_value.contains('${projectDir}')) {
+ def sub_string = schema_value.replace('\$projectDir', '')
+ sub_string = sub_string.replace('\${projectDir}', '')
+ if (params_value.contains(sub_string)) {
+ schema_value = params_value
+ }
+ }
+ if (schema_value.contains('$params.outdir') || schema_value.contains('${params.outdir}')) {
+ def sub_string = schema_value.replace('\$params.outdir', '')
+ sub_string = sub_string.replace('\${params.outdir}', '')
+ if ("${params.outdir}${sub_string}" == params_value) {
+ schema_value = params_value
+ }
+ }
+ }
+ }
+
+ if (params_value != schema_value) {
+ sub_params.put("$param", params_value)
+ }
+ }
+ }
+ params_summary.put(group, sub_params)
+ }
+ return [ 'Core Nextflow options' : workflow_summary ] << params_summary
+ }
+
+ /*
+ * Beautify parameters for summary and return as string
+ */
+ private static String params_summary_log(workflow, params, json_schema) {
+ String output = ''
+ def params_map = params_summary_map(workflow, params, json_schema)
+ def max_chars = params_max_chars(params_map)
+ for (group in params_map.keySet()) {
+ def group_params = params_map.get(group) // This gets the parameters of that particular group
+ if (group_params) {
+ output += group + '\n'
+ for (param in group_params.keySet()) {
+ output += " \u001B[1m" + param.padRight(max_chars) + ": \u001B[1m" + group_params.get(param) + '\n'
+ }
+ output += '\n'
+ }
+ }
+ output += "[Only displaying parameters that differ from pipeline default]\n"
+ output += dashed_line(params.monochrome_logs)
+ output += '\n\n' + dashed_line(params.monochrome_logs)
+ return output
+ }
+
+}
diff --git a/lib/nfcore_external_java_deps.jar b/lib/nfcore_external_java_deps.jar
new file mode 100644
index 0000000000000000000000000000000000000000..805c8bb5e4fd43a12a5891eea5a68788309629b0
Binary files /dev/null and b/lib/nfcore_external_java_deps.jar differ
diff --git a/main.nf b/main.nf
index c481dd57affdc947c3024e974caa455cafa54307..99e50d88308c87118c60b7c6a89e616adef6f92b 100644
--- a/main.nf
+++ b/main.nf
@@ -9,57 +9,32 @@
----------------------------------------------------------------------------------------
*/
-def helpMessage() {
- // TODO nf-core: Add to this help message with new command line parameters
- log.info nfcoreHeader()
- log.info"""
-
- Usage:
-
- The typical command for running the pipeline is as follows:
-
- nextflow run nf-core/hic --input '*_R{1,2}.fastq.gz' -profile docker
-
- Mandatory arguments:
- --input [file] Path to input data (must be surrounded with quotes)
- -profile [str] Configuration profile to use. Can use multiple (comma separated)
- Available: conda, docker, singularity, test, awsbatch, <institute> and more
-
- Options:
- --genome [str] Name of iGenomes reference
- --single_end [bool] Specifies that the input is single-end reads
-
- References If not specified in the configuration file or you wish to overwrite any of the references
- --fasta [file] Path to fasta reference
-
- Other options:
- --outdir [file] The output directory where the results will be saved
- --publish_dir_mode [str] Mode for publishing results in the output directory. Available: symlink, rellink, link, copy, copyNoFollow, move (Default: copy)
- --email [email] Set this parameter to your e-mail address to get a summary e-mail with details of the run sent to you when the workflow exits
- --email_on_fail [email] Same as --email, except only send mail if the workflow is not successful
- --max_multiqc_email_size [str] Threshold size for MultiQC report to be attached in notification email. If file generated by pipeline exceeds the threshold, it will not be attached (Default: 25MB)
- -name [str] Name for the pipeline run. If not specified, Nextflow will automatically generate a random mnemonic
-
- AWSBatch options:
- --awsqueue [str] The AWSBatch JobQueue that needs to be set when running on AWSBatch
- --awsregion [str] The AWS Region for your AWS Batch job to run on
- --awscli [str] Path to the AWS CLI tool
- """.stripIndent()
-}
+log.info Headers.nf_core(workflow, params.monochrome_logs)
-// Show help message
+////////////////////////////////////////////////////
+/* -- PRINT HELP -- */
+////////////////////////////////////////////////////+
+def json_schema = "$projectDir/nextflow_schema.json"
if (params.help) {
- helpMessage()
+ def command = "nextflow run nf-core/hic --input '*_R{1,2}.fastq.gz' -profile docker"
+ log.info NfcoreSchema.params_help(workflow, params, json_schema, command)
exit 0
}
-/*
- * SET UP CONFIGURATION VARIABLES
- */
+////////////////////////////////////////////////////
+/* -- VALIDATE PARAMETERS -- */
+////////////////////////////////////////////////////+
+if (params.validate_params) {
+ NfcoreSchema.validateParameters(params, json_schema, log)
+}
+
+////////////////////////////////////////////////////
+/* -- Collect configuration parameters -- */
+////////////////////////////////////////////////////
// Check if genome exists in the config file
if (params.genomes && params.genome && !params.genomes.containsKey(params.genome)) {
- exit 1, "The provided genome '${params.genome}' is not available in the iGenomes file. Currently the available genomes are ${params.genomes.keySet().join(", ")}"
+ exit 1, "The provided genome '${params.genome}' is not available in the iGenomes file. Currently the available genomes are ${params.genomes.keySet().join(', ')}"
}
// TODO nf-core: Add any reference files that are needed
@@ -73,22 +48,15 @@ if (params.genomes && params.genome && !params.genomes.containsKey(params.genome
params.fasta = params.genome ? params.genomes[ params.genome ].fasta ?: false : false
if (params.fasta) { ch_fasta = file(params.fasta, checkIfExists: true) }
-// Has the run name been specified by the user?
-// this has the bonus effect of catching both -name and --name
-custom_runName = params.name
-if (!(workflow.runName ==~ /[a-z]+_[a-z]+/)) {
- custom_runName = workflow.runName
-}
-
// Check AWS batch settings
if (workflow.profile.contains('awsbatch')) {
// AWSBatch sanity checking
- if (!params.awsqueue || !params.awsregion) exit 1, "Specify correct --awsqueue and --awsregion parameters on AWSBatch!"
+ if (!params.awsqueue || !params.awsregion) exit 1, 'Specify correct --awsqueue and --awsregion parameters on AWSBatch!'
// Check outdir paths to be S3 buckets if running on AWSBatch
// related: https://github.com/nextflow-io/nextflow/issues/813
- if (!params.outdir.startsWith('s3:')) exit 1, "Outdir not on S3 - specify S3 Bucket to run on AWSBatch!"
+ if (!params.outdir.startsWith('s3:')) exit 1, 'Outdir not on S3 - specify S3 Bucket to run on AWSBatch!'
// Prevent trace files to be stored on S3 since S3 does not support rolling files.
- if (params.tracedir.startsWith('s3:')) exit 1, "Specify a local tracedir or run without trace! S3 cannot be used for tracefiles."
+ if (params.tracedir.startsWith('s3:')) exit 1, 'Specify a local tracedir or run without trace! S3 cannot be used for tracefiles.'
}
// Stage config files
@@ -105,13 +73,13 @@ if (params.input_paths) {
Channel
.from(params.input_paths)
.map { row -> [ row[0], [ file(row[1][0], checkIfExists: true) ] ] }
- .ifEmpty { exit 1, "params.input_paths was empty - no input files supplied" }
+ .ifEmpty { exit 1, 'params.input_paths was empty - no input files supplied' }
.into { ch_read_files_fastqc; ch_read_files_trimming }
} else {
Channel
.from(params.input_paths)
.map { row -> [ row[0], [ file(row[1][0], checkIfExists: true), file(row[1][1], checkIfExists: true) ] ] }
- .ifEmpty { exit 1, "params.input_paths was empty - no input files supplied" }
+ .ifEmpty { exit 1, 'params.input_paths was empty - no input files supplied' }
.into { ch_read_files_fastqc; ch_read_files_trimming }
}
} else {
@@ -121,11 +89,15 @@ if (params.input_paths) {
.into { ch_read_files_fastqc; ch_read_files_trimming }
}
+////////////////////////////////////////////////////
+/* -- PRINT PARAMETER SUMMARY -- */
+////////////////////////////////////////////////////
+log.info NfcoreSchema.params_summary_log(workflow, params, json_schema)
+
// Header log info
-log.info nfcoreHeader()
def summary = [:]
if (workflow.revision) summary['Pipeline Release'] = workflow.revision
-summary['Run Name'] = custom_runName ?: workflow.runName
+summary['Run Name'] = workflow.runName
// TODO nf-core: Report custom parameters here
summary['Input'] = params.input
summary['Fasta Ref'] = params.fasta
@@ -152,8 +124,6 @@ if (params.email || params.email_on_fail) {
summary['E-mail on failure'] = params.email_on_fail
summary['MultiQC maxsize'] = params.max_multiqc_email_size
}
-log.info summary.collect { k,v -> "${k.padRight(18)}: $v" }.join("\n")
-log.info "-\033[2m--------------------------------------------------\033[0m-"
// Check the hostnames against configured profiles
checkHostname()
@@ -180,13 +150,13 @@ Channel.from(summary.collect{ [it.key, it.value] })
process get_software_versions {
publishDir "${params.outdir}/pipeline_info", mode: params.publish_dir_mode,
saveAs: { filename ->
- if (filename.indexOf(".csv") > 0) filename
+ if (filename.indexOf('.csv') > 0) filename
else null
- }
+ }
output:
file 'software_versions_mqc.yaml' into ch_software_versions_yaml
- file "software_versions.csv"
+ file 'software_versions.csv'
script:
// TODO nf-core: Get all tools to print their version number here
@@ -207,14 +177,14 @@ process fastqc {
label 'process_medium'
publishDir "${params.outdir}/fastqc", mode: params.publish_dir_mode,
saveAs: { filename ->
- filename.indexOf(".zip") > 0 ? "zips/$filename" : "$filename"
- }
+ filename.indexOf('.zip') > 0 ? "zips/$filename" : "$filename"
+ }
input:
set val(name), file(reads) from ch_read_files_fastqc
output:
- file "*_fastqc.{zip,html}" into ch_fastqc_results
+ file '*_fastqc.{zip,html}' into ch_fastqc_results
script:
"""
@@ -242,8 +212,12 @@ process multiqc {
file "multiqc_plots"
script:
- rtitle = custom_runName ? "--title \"$custom_runName\"" : ''
- rfilename = custom_runName ? "--filename " + custom_runName.replaceAll('\\W','_').replaceAll('_+','_') + "_multiqc_report" : ''
+ rtitle = ''
+ rfilename = ''
+ if (!(workflow.runName ==~ /[a-z]+_[a-z]+/)) {
+ rtitle = "--title \"${workflow.runName}\""
+ rfilename = "--filename " + workflow.runName.replaceAll('\\W','_').replaceAll('_+','_') + "_multiqc_report"
+ }
custom_config_file = params.multiqc_config ? "--config $mqc_custom_config" : ''
// TODO nf-core: Specify which MultiQC modules to use with -m for a faster run time
"""
@@ -262,7 +236,7 @@ process output_documentation {
file images from ch_output_docs_images
output:
- file "results_description.html"
+ file 'results_description.html'
script:
"""
@@ -282,7 +256,7 @@ workflow.onComplete {
}
def email_fields = [:]
email_fields['version'] = workflow.manifest.version
- email_fields['runName'] = custom_runName ?: workflow.runName
+ email_fields['runName'] = workflow.runName
email_fields['success'] = workflow.success
email_fields['dateComplete'] = workflow.complete
email_fields['duration'] = workflow.duration
@@ -389,28 +363,9 @@ workflow.onComplete {
}
-
-def nfcoreHeader() {
- // Log colors ANSI codes
- c_black = params.monochrome_logs ? '' : "\033[0;30m";
- c_blue = params.monochrome_logs ? '' : "\033[0;34m";
- c_cyan = params.monochrome_logs ? '' : "\033[0;36m";
- c_dim = params.monochrome_logs ? '' : "\033[2m";
- c_green = params.monochrome_logs ? '' : "\033[0;32m";
- c_purple = params.monochrome_logs ? '' : "\033[0;35m";
- c_reset = params.monochrome_logs ? '' : "\033[0m";
- c_white = params.monochrome_logs ? '' : "\033[0;37m";
- c_yellow = params.monochrome_logs ? '' : "\033[0;33m";
-
- return """ -${c_dim}--------------------------------------------------${c_reset}-
- ${c_green},--.${c_black}/${c_green},-.${c_reset}
- ${c_blue} ___ __ __ __ ___ ${c_green}/,-._.--~\'${c_reset}
- ${c_blue} |\\ | |__ __ / ` / \\ |__) |__ ${c_yellow}} {${c_reset}
- ${c_blue} | \\| | \\__, \\__/ | \\ |___ ${c_green}\\`-._,-`-,${c_reset}
- ${c_green}`._,._,\'${c_reset}
- ${c_purple} nf-core/hic v${workflow.manifest.version}${c_reset}
- -${c_dim}--------------------------------------------------${c_reset}-
- """.stripIndent()
+workflow.onError {
+ // Print unexpected parameters - easiest is to just rerun validation
+ NfcoreSchema.validateParameters(params, json_schema, log)
}
def checkHostname() {
@@ -419,15 +374,15 @@ def checkHostname() {
def c_red = params.monochrome_logs ? '' : "\033[1;91m"
def c_yellow_bold = params.monochrome_logs ? '' : "\033[1;93m"
if (params.hostnames) {
- def hostname = "hostname".execute().text.trim()
+ def hostname = 'hostname'.execute().text.trim()
params.hostnames.each { prof, hnames ->
hnames.each { hname ->
if (hostname.contains(hname) && !workflow.profile.contains(prof)) {
- log.error "====================================================\n" +
+ log.error '====================================================\n' +
" ${c_red}WARNING!${c_reset} You are running with `-profile $workflow.profile`\n" +
" but your machine hostname is ${c_white}'$hostname'${c_reset}\n" +
" ${c_yellow_bold}It's highly recommended that you use `-profile $prof${c_reset}`\n" +
- "============================================================"
+ '============================================================'
}
}
}
diff --git a/nextflow.config b/nextflow.config
index 44cd92c0ab9b26a7fe1f73ffadee0b170710dc14..1da3046b3e1c12faa562d45c08f55a3f248c76a4 100644
--- a/nextflow.config
+++ b/nextflow.config
@@ -11,13 +11,13 @@ params {
// Workflow flags
// TODO nf-core: Specify your pipeline's command line flags
genome = false
- input = "data/*{1,2}.fastq.gz"
+ input = null
+ input_paths = null
single_end = false
outdir = './results'
publish_dir_mode = 'copy'
// Boilerplate options
- name = false
multiqc_config = false
email = false
email_on_fail = false
@@ -34,6 +34,9 @@ params {
config_profile_description = false
config_profile_contact = false
config_profile_url = false
+ validate_params = true
+ show_hidden_params = false
+ schema_ignore_params = 'genomes,input_paths'
// Defaults only, expecting to be overwritten
max_memory = 128.GB
@@ -57,10 +60,21 @@ try {
}
profiles {
- conda { process.conda = "$projectDir/environment.yml" }
+ conda {
+ docker.enabled = false
+ singularity.enabled = false
+ podman.enabled = false
+ shifter.enabled = false
+ charliecloud = false
+ process.conda = "$projectDir/environment.yml"
+ }
debug { process.beforeScript = 'echo $HOSTNAME' }
docker {
docker.enabled = true
+ singularity.enabled = false
+ podman.enabled = false
+ shifter.enabled = false
+ charliecloud.enabled = false
// Avoid this error:
// WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.
// Testing this in nf-core after discussion here https://github.com/nf-core/tools/pull/351
@@ -68,11 +82,33 @@ profiles {
docker.runOptions = '-u \$(id -u):\$(id -g)'
}
singularity {
+ docker.enabled = false
singularity.enabled = true
+ podman.enabled = false
+ shifter.enabled = false
+ charliecloud.enabled = false
singularity.autoMounts = true
}
podman {
+ singularity.enabled = false
+ docker.enabled = false
podman.enabled = true
+ shifter.enabled = false
+ charliecloud = false
+ }
+ shifter {
+ singularity.enabled = false
+ docker.enabled = false
+ podman.enabled = false
+ shifter.enabled = true
+ charliecloud.enabled = false
+ }
+ charliecloud {
+ singularity.enabled = false
+ docker.enabled = false
+ podman.enabled = false
+ shifter.enabled = false
+ charliecloud.enabled = true
}
test { includeConfig 'conf/test.config' }
test_full { includeConfig 'conf/test_full.config' }
@@ -117,7 +153,7 @@ manifest {
description = 'Analysis of Chromosome Conformation Capture data (Hi-C)'
mainScript = 'main.nf'
nextflowVersion = '>=20.04.0'
- version = '1.0dev'
+ version = '1.3.0dev'
}
// Function to ensure that resource requirements don't go beyond
diff --git a/nextflow_schema.json b/nextflow_schema.json
index 21e29d7e5fc226e377bef6fa7e4d9b498d281eed..e164aa979d6d93620842d160d980a71f64975514 100644
--- a/nextflow_schema.json
+++ b/nextflow_schema.json
@@ -104,12 +104,12 @@
"move"
]
},
- "name": {
- "type": "string",
- "description": "Workflow name.",
- "fa_icon": "fas fa-fingerprint",
- "hidden": true,
- "help_text": "A custom name for the pipeline run. Unlike the core nextflow `-name` option with one hyphen this parameter can be reused multiple times, for example if using `-resume`. Passed through to steps such as MultiQC and used for things like report filenames and titles."
+ "validate_params": {
+ "type": "boolean",
+ "description": "Boolean whether to validate parameters against the schema at runtime",
+ "default": true,
+ "fa_icon": "fas fa-check-square",
+ "hidden": true
},
"email_on_fail": {
"type": "string",
@@ -153,6 +153,13 @@
"default": "${params.outdir}/pipeline_info",
"fa_icon": "fas fa-cogs",
"hidden": true
+ },
+ "show_hidden_params": {
+ "type": "boolean",
+ "fa_icon": "far fa-eye-slash",
+ "description": "Show all params when using `--help`",
+ "hidden": true,
+ "help_text": "By default, parameters set as _hidden_ in the schema are not shown on the command line when a user runs with `--help`. Specifying this option will tell the pipeline to show all parameters."
}
}
},
@@ -176,6 +183,7 @@
"description": "Maximum amount of memory that can be requested for any single job.",
"default": "128.GB",
"fa_icon": "fas fa-memory",
+ "pattern": "^[\\d\\.]+\\s*.(K|M|G|T)?B$",
"hidden": true,
"help_text": "Use to set an upper-limit for the memory requirement for each process. Should be a string in the format integer-unit e.g. `--max_memory '8.GB'`"
},
@@ -184,6 +192,7 @@
"description": "Maximum amount of time that can be requested for any single job.",
"default": "240.h",
"fa_icon": "far fa-clock",
+ "pattern": "^[\\d\\.]+\\.*(s|m|h|d)$",
"hidden": true,
"help_text": "Use to set an upper-limit for the time requirement for each process. Should be a string in the format integer-unit e.g. `--max_time '2.h'`"
}
@@ -218,6 +227,12 @@
"hidden": true,
"fa_icon": "fas fa-users-cog"
},
+ "config_profile_name": {
+ "type": "string",
+ "description": "Institutional config name.",
+ "hidden": true,
+ "fa_icon": "fas fa-users-cog"
+ },
"config_profile_description": {
"type": "string",
"description": "Institutional config description.",