nextflow_schema.json

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://raw.githubusercontent.com/nf-core/scdownstream/master/nextflow_schema.json",
    "title": "nf-core/scdownstream pipeline parameters",
    "description": "A single cell transcriptomics pipeline for QC, integration and making the results presentable",
    "type": "object",
    "$defs": {
        "input_output_options": {
            "title": "Input/output options",
            "type": "object",
            "fa_icon": "fas fa-terminal",
            "description": "Define where the pipeline should find input data and save output data.",
            "required": ["outdir"],
            "properties": {
                "input": {
                    "type": "string",
                    "format": "file-path",
                    "exists": true,
                    "schema": "assets/schema_input.json",
                    "mimetype": "text/csv",
                    "pattern": "^\\S+\\.csv$",
                    "description": "Path to comma-separated file containing information about the samples in the experiment.",
                    "help_text": "You will need to create a design file with information about the samples in your experiment before running the pipeline. Use this parameter to specify its location. It has to be a comma-separated file with 3 columns, and a header row. See [usage docs](https://nf-co.re/scdownstream/usage#samplesheet-input).",
                    "fa_icon": "fas fa-file-csv"
                },
                "outdir": {
                    "type": "string",
                    "format": "directory-path",
                    "description": "The output directory where the results will be saved. You have to use absolute paths to storage on Cloud infrastructure.",
                    "fa_icon": "fas fa-folder-open"
                },
                "save_intermediates": {
                    "type": "boolean",
                    "default": false,
                    "description": "Save intermediate files to the output directory",
                    "fa_icon": "fas fa-save"
                },
                "email": {
                    "type": "string",
                    "description": "Email address for completion summary.",
                    "fa_icon": "fas fa-envelope",
                    "help_text": "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. If set in your user config file (`~/.nextflow/config`) then you don't need to specify this on the command line for every run.",
                    "pattern": "^([a-zA-Z0-9_\\-\\.]+)@([a-zA-Z0-9_\\-\\.]+)\\.([a-zA-Z]{2,5})$"
                },
                "multiqc_title": {
                    "type": "string",
                    "description": "MultiQC report title. Printed as page header, used for filename if not otherwise specified.",
                    "fa_icon": "fas fa-file-signature"
                }
            }
        },
        "reference_mapping_options": {
            "title": "Reference mapping options",
            "type": "object",
            "fa_icon": "fas fa-map-marked-alt",
            "description": "Options for mapping new data to a reference. Check the [section in the usage docs](https://nf-co.re/scdownstream/docs/usage/#reference-mapping) for more information.",
            "properties": {
                "base_adata": {
                    "type": "string",
                    "format": "file-path",
                    "description": "If you want to project new data onto an already integrated object, specify the path to the base AnnData object here",
                    "help_text": "The file should be in the .h5ad format.",
                    "pattern": "^\\S+\\.h5ad$",
                    "exists": true
                },
                "base_label_col": {
                    "type": "string",
                    "default": "label",
                    "description": "The column in the base AnnData object that contains the label (e.g. cell type) information."
                },
                "base_embeddings": {
                    "type": "string",
                    "description": "The keys in the obsm of the base AnnData object that contain the embeddings (without leading `X_`). Required if `input` is not provided - otherwise it is ignored.",
                    "help_text": "If the `input` parameter is not provided (no new data to add), integration will not be performed. In order to be able to utilize existing integration results, you need to provide the keys in the obsm of the base AnnData object that contain the embeddings (without leading `X_`).",
                    "pattern": "^((scvi|scanvi|harmony|bbknn|combat|seurat)(,(scvi|scanvi|harmony|bbknn|combat|seurat))*)?$"
                },
                "reference_model": {
                    "type": "string",
                    "format": "file-path",
                    "description": "If you want to use a pre-trained scVI/scANVI model as a reference for integration, specify the path to the model `.pt` file here",
                    "help_text": "The file should be in the .pt format. If provided, you also need to provide a `reference_model_type`.",
                    "pattern": "^\\S+\\.pt$",
                    "exists": true
                },
                "reference_model_type": {
                    "type": "string",
                    "default": "scvi",
                    "description": "Specify the type of model provided in the `reference_model` parameter",
                    "help_text": "Can be either 'scvi' or 'scanvi'.",
                    "pattern": "^(scvi|scanvi)$"
                }
            }
        },
        "pipeline_options": {
            "title": "Pipeline options",
            "type": "object",
            "description": "Options for selecting which tools should be used for certain tasks",
            "properties": {
                "preprocess_only": {
                    "type": "boolean",
                    "default": false,
                    "description": "Only run the preprocessing steps, skip the integration and clustering steps"
                },
                "unify_gene_symbols": {
                    "type": "boolean",
                    "default": false,
                    "description": "Unify gene symbols to the latest version of the Ensembl database"
                },
                "memory_scale": {
                    "type": "integer",
                    "default": 1,
                    "minimum": 1,
                    "description": "Scale the memory requirements for each process by this factor. Should be increased if you have a large number of cells.",
                    "fa_icon": "fas fa-memory"
                },
                "ambient_removal": {
                    "type": "string",
                    "default": "decontx",
                    "enum": ["none", "decontx", "cellbender", "soupx", "scar"],
                    "description": "Specify the tool to use for ambient RNA removal"
                },
                "doublet_detection": {
                    "type": "string",
                    "default": "scrublet",
                    "description": "Specify the tools to use for doublet detection. Setting to 'none' will skip this step",
                    "help_text": "If you want to use multiple tools, separate them with a comma. Available methods are: solo, scrublet, doubletdetection, scds",
                    "pattern": "^(none|((solo|scrublet|doubletdetection|scds)?,?)*[^,]+$)"
                },
                "doublet_detection_threshold": {
                    "type": "integer",
                    "default": 1,
                    "description": "Number of tools that need to agree on a doublet for it to be called as such"
                },
                "force_obs_cols": {
                    "type": "string",
                    "default": "",
                    "description": "Force keeping certain columns in the merged AnnData object, even if they are not present in all samples",
                    "help_text": "If you want to keep certain columns in the merged AnnData object, even if they are not present in all samples, specify them here. Separate them with a comma.",
                    "pattern": "^([a-zA-Z0-9_]*(,[a-zA-Z0-9_]*)*)?$"
                },
                "integration_methods": {
                    "type": "string",
                    "default": "scvi",
                    "description": "Specify the tool to use for integration",
                    "help_text": "If you want to use multiple tools, separate them with a comma. Available methods are: scvi, scanvi, harmony, bbknn, combat, seurat",
                    "pattern": "^((scvi|scanvi|harmony|bbknn|combat|seurat)(,(scvi|scanvi|harmony|bbknn|combat|seurat))*)?$"
                },
                "integration_hvgs": {
                    "type": "integer",
                    "default": 10000,
                    "minimum": 100,
                    "description": "Number of highly variable genes to use for integration"
                },
                "clustering_resolutions": {
                    "type": "string",
                    "default": "0.5,1.0",
                    "description": "Specify the resolutions for clustering",
                    "help_text": "Specify the resolutions for clustering. If you want to use multiple resolutions, separate them with a comma.",
                    "pattern": "^\\d+(\\.\\d+)?(,\\d+(\\.\\d+)?)*$"
                },
                "cluster_per_label": {
                    "type": "boolean",
                    "default": false,
                    "description": "Create a UMAP and a clustering for each unique value in the label column (and for each integration method)"
                },
                "cluster_global": {
                    "type": "boolean",
                    "default": true,
                    "description": "Create a global UMAP and clustering (for each integration method)"
                },
                "skip_liana": {
                    "type": "boolean",
                    "default": false,
                    "description": "Skip the LIANA step. For large datasets, the pipeline might fail due to high memory usage in this step. Use this option to skip it."
                },
                "skip_rankgenesgroups": {
                    "type": "boolean",
                    "default": false,
                    "description": "Skip the rank_genes_groups step. For large datasets, the pipeline might fail due to high memory usage in this step. Use this option to skip it."
                },
                "celltypist_model": {
                    "type": "string",
                    "default": "",
                    "description": "Specify the models to use for the celltypist cell type annotation",
                    "help_text": "If you want to use multiple models, separate them with a comma. Available models can be found [here](https://www.celltypist.org/models).",
                    "pattern": "^([a-zA-Z0-9_]*(,[a-zA-Z0-9_]*)*)?$"
                },
                "cellbender_epochs": {
                    "type": "integer",
                    "default": 150,
                    "description": "Number of epochs to train the CellBender model"
                },
                "var_aggr_method": {
                    "type": "string",
                    "default": "mean",
                    "description": "Method to aggregate gene expression values for non-unique genes",
                    "help_text": "Method to aggregate gene expression values for non-unique genes. Available methods are: mean, sum, max",
                    "enum": ["mean", "sum", "max"]
                },
                "use_gpu": {
                    "type": "boolean",
                    "default": false,
                    "description": "Use GPU acceleration for tasks that support it",
                    "hidden": true
                },
                "prep_cellxgene": {
                    "type": "boolean",
                    "default": false,
                    "description": "Prepare the output for visualisation in cellxgene",
                    "fa_icon": "fas fa-chart-line"
                }
            }
        },
        "scVI_options": {
            "title": "scVI/scANVI options",
            "type": "object",
            "fa_icon": "fas fa-microscope",
            "description": "Options for the scVI and scANVI integration methods",
            "properties": {
                "scvi_n_latent": {
                    "type": "integer",
                    "default": 30,
                    "description": "Number of latent dimensions for scVI/scANVI"
                },
                "scvi_n_hidden": {
                    "type": "integer",
                    "default": 128,
                    "description": "Number of hidden units in the neural network for scVI/scANVI"
                },
                "scvi_n_layers": {
                    "type": "integer",
                    "default": 2,
                    "description": "Number of layers in the neural network for scVI/scANVI"
                },
                "scvi_dispersion": {
                    "type": "string",
                    "default": "gene",
                    "enum": ["gene", "gene-batch", "gene-label", "gene-cell"],
                    "description": "Dispersion parameter for scVI/scANVI",
                    "help_text": "Dispersion parameter for scVI/scANVI. Can be 'gene', 'gene-batch', 'gene-label', or 'gene-cell'."
                },
                "scvi_gene_likelihood": {
                    "type": "string",
                    "default": "zinb",
                    "enum": ["zinb", "nb", "poisson", "normal"],
                    "description": "Gene likelihood for scVI/scANVI",
                    "help_text": "Gene likelihood for scVI/scANVI. Can be 'zinb', 'nb', 'poisson', or 'normal'."
                },
                "scvi_max_epochs": {
                    "type": "integer",
                    "description": "Maximum number of epochs for training scVI/scANVI. If not set, a heuristic provided by scVI/scANVI will be used."
                }
            }
        },
        "institutional_config_options": {
            "title": "Institutional config options",
            "type": "object",
            "fa_icon": "fas fa-university",
            "description": "Parameters used to describe centralised config profiles. These should not be edited.",
            "help_text": "The centralised nf-core configuration profiles use a handful of pipeline parameters to describe themselves. This information is then printed to the Nextflow log when you run a pipeline. You should not need to change these values when you run a pipeline.",
            "properties": {
                "custom_config_version": {
                    "type": "string",
                    "description": "Git commit id for Institutional configs.",
                    "default": "master",
                    "hidden": true,
                    "fa_icon": "fas fa-users-cog"
                },
                "custom_config_base": {
                    "type": "string",
                    "description": "Base directory for Institutional configs.",
                    "default": "https://raw.githubusercontent.com/nf-core/configs/master",
                    "hidden": true,
                    "help_text": "If you're running offline, Nextflow will not be able to fetch the institutional config files from the internet. If you don't need them, then this is not a problem. If you do need them, you should download the files from the repo and tell Nextflow where to find them with this parameter.",
                    "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.",
                    "hidden": true,
                    "fa_icon": "fas fa-users-cog"
                },
                "config_profile_contact": {
                    "type": "string",
                    "description": "Institutional config contact information.",
                    "hidden": true,
                    "fa_icon": "fas fa-users-cog"
                },
                "config_profile_url": {
                    "type": "string",
                    "description": "Institutional config URL link.",
                    "hidden": true,
                    "fa_icon": "fas fa-users-cog"
                }
            }
        },
        "generic_options": {
            "title": "Generic options",
            "type": "object",
            "fa_icon": "fas fa-file-import",
            "description": "Less common options for the pipeline, typically set in a config file.",
            "help_text": "These options are common to all nf-core pipelines and allow you to customise some of the core preferences for how the pipeline runs.\n\nTypically these options would be set in a Nextflow config file loaded for all pipeline runs, such as `~/.nextflow/config`.",
            "properties": {
                "version": {
                    "type": "boolean",
                    "description": "Display version and exit.",
                    "fa_icon": "fas fa-question-circle",
                    "hidden": true
                },
                "publish_dir_mode": {
                    "type": "string",
                    "default": "copy",
                    "description": "Method used to save pipeline results to output directory.",
                    "help_text": "The Nextflow `publishDir` option specifies which intermediate files should be saved to the output directory. This option tells the pipeline what method should be used to move these files. See [Nextflow docs](https://www.nextflow.io/docs/latest/process.html#publishdir) for details.",
                    "fa_icon": "fas fa-copy",
                    "enum": ["symlink", "rellink", "link", "copy", "copyNoFollow", "move"],
                    "hidden": true
                },
                "email_on_fail": {
                    "type": "string",
                    "description": "Email address for completion summary, only when pipeline fails.",
                    "fa_icon": "fas fa-exclamation-triangle",
                    "pattern": "^([a-zA-Z0-9_\\-\\.]+)@([a-zA-Z0-9_\\-\\.]+)\\.([a-zA-Z]{2,5})$",
                    "help_text": "An email address to send a summary email to when the pipeline is completed - ONLY sent if the pipeline does not exit successfully.",
                    "hidden": true
                },
                "plaintext_email": {
                    "type": "boolean",
                    "description": "Send plain-text email instead of HTML.",
                    "fa_icon": "fas fa-remove-format",
                    "hidden": true
                },
                "max_multiqc_email_size": {
                    "type": "string",
                    "description": "File size limit when attaching MultiQC reports to summary emails.",
                    "pattern": "^\\d+(\\.\\d+)?\\.?\\s*(K|M|G|T)?B$",
                    "default": "25.MB",
                    "fa_icon": "fas fa-file-upload",
                    "hidden": true
                },
                "monochrome_logs": {
                    "type": "boolean",
                    "description": "Do not use coloured log outputs.",
                    "fa_icon": "fas fa-palette",
                    "hidden": true
                },
                "hook_url": {
                    "type": "string",
                    "description": "Incoming hook URL for messaging service",
                    "fa_icon": "fas fa-people-group",
                    "help_text": "Incoming hook URL for messaging service. Currently, MS Teams and Slack are supported.",
                    "hidden": true
                },
                "multiqc_config": {
                    "type": "string",
                    "format": "file-path",
                    "description": "Custom config file to supply to MultiQC.",
                    "fa_icon": "fas fa-cog",
                    "hidden": true
                },
                "multiqc_logo": {
                    "type": "string",
                    "description": "Custom logo file to supply to MultiQC. File name must also be set in the MultiQC config file",
                    "fa_icon": "fas fa-image",
                    "hidden": true
                },
                "multiqc_methods_description": {
                    "type": "string",
                    "description": "Custom MultiQC yaml file containing HTML including a methods description.",
                    "fa_icon": "fas fa-cog"
                },
                "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
                },
                "pipelines_testdata_base_path": {
                    "type": "string",
                    "fa_icon": "far fa-check-circle",
                    "description": "Base URL or local path to location of pipeline test dataset files",
                    "default": "https://raw.githubusercontent.com/nf-core/test-datasets/",
                    "hidden": true
                }
            }
        }
    },
    "allOf": [
        {
            "$ref": "#/$defs/input_output_options"
        },
        {
            "$ref": "#/$defs/reference_mapping_options"
        },
        {
            "$ref": "#/$defs/pipeline_options"
        },
        {
            "$ref": "#/$defs/scVI_options"
        },
        {
            "$ref": "#/$defs/institutional_config_options"
        },
        {
            "$ref": "#/$defs/generic_options"
        }
    ]
}