To find out the default value for each parameter, see conf/analysis.config.
-
do_merge_mtxMerge graft and host MTX (gene by spot) matrices into one MTX matrix -
do_splicing_quantificationRun splicing quantification with velocyto. The pipeline also sorts by cell barcodes the BAM file produced by Space Ranger. -
do_snv_extractRun the BAF extraction sub-workflow to get bulk-level SNV. -
reference_genomePath to the reference genome to use for Space Ranger reads alignment in one-reference analysis route. See https://support.10xgenomics.com/single-cell-gene-expression/software/release-notes/build for Space Ranger requirements of the reference genomes. -
mouse_reference_genomePath to the mouse reference genome for Space Ranger reads alignment in two-reference analysis route. -
human_reference_genomePath to the human reference genome for Space Ranger reads alignment in two-reference analysis route. -
deconvolution_reference_graftPath to a graft (e.g., human) reference genome (e.g., *.fa, *.fna, *.fa.gz, *.fna.gz) to build xenome or xengsort indices. If the indices supplied innextflow.configalready exits, then this parameter is ignored. -
deconvolution_reference_hostPath to a host (e.g., mouse) reference genome (e.g., *.fa, *.fna, *.fa.gz, *.fna.gz) to build xenome or xengsort indices. If the indices supplied innextflow.configalready exits, then this parameter is ignored. -
deconvolution_kmer_sizeK-mer size for building xenome or xengsort indices. See https://github.com/data61/gossamer/blob/master/docs/xenome.md for a detailed description. -
deconvolution_indices_pathPath to save deconvolution indices. -
deconvolution_indices_nameName of the indices. -
xengsort_nXengsort-specific parameter. See https://gitlab.com/genomeinformatics/xengsort for details.
See https://github.com/akdess/BAFExtract for the description of the following filtering parameters:
-
bafextract_minimum_mapping_quality -
bafextract_minimum_base_quality -
bafextract_min_coverage_per_SNV -
bafextract_min_MAF_covg_per_SNV -
bafextract_min_MAF
-
do_img_subworkflowRun the imaging sub-workflow to generate imaging and nuclear morphometric features for each spot on the grid. -
short_workflowRun short imaging workflow instead of the full imaging workflow. See config for details. -
do_imaging_anndataCreate an AnnData object (e.g., for use with Scanpy) from the *.csv.gz data file with imaging and nuclear morphometric features -
do_nuclear_sementationPerform nuclear segmentation (use either HoVer-Net or StarDist to segment nuclei) of the entire WSI. -
target_mppdesired image resolution for scaling the images. Note that specific DL and ML models require full-resolution images, and the supplied pre-trained models are designed for images with a resolution of around 0.25 (mpp). In case a low-magnification image is supplied (e.g., mpp is 0.5) while target_mpp is 0.25, the image is upsampled and will have doubled dimensions. -
tiled_tiff_tile_sizeThe TIFF WSI is internally stored in blocks (for memory management). The tile size determines the block size. This parameter is not the size of tiles used for feature extraction or segmentation aggregation. The grid parametergrid_spot_diamter(in micrometers) and resolution parametertarget_mppdefine the scaled image tile size. -
thumbnail_downsample_factorA factor used to reduce the WSI dimensions to create a low-resolution slide representation. -
check_focusRun DeepFocus module to assess focus (blurryness) of the whole slide image. -
deepfocus_model_pathPath to DeepFocus checkpoint to use. -
stain_normalizationWhether to do any stain or color normalization. -
stainnetPath to checkpoint for stain normalization model. -
macenko_normalizationIf true, then use Macenko stain normalization. If false, use StainNet color normalization. This parameter is ignored ifstain_normalizationis false. -
stain_reference_imageReference image (or a small patch, e.g., 2000 by 2000 pixels) to use with Macenko stain normalization. -
stain_patch_sizeMacenco stain normalization patch size. -
mask_background_cutoffParameter for detecting image background with HoVer-Net. -
pixel_mask_threshold_lowParameter for detecting tissue pixels on the low-resolution image. -
pixel_mask_threshold_highParameter for detecting tissue pixels on the low-resolution image. -
fraction_for_maskFraction of pixels in tissue required to call tile in tissue. -
use_provided_gridWhether to use the grid provided in the input sample sheet. If false and no Space Ranger alignment is done, then a new grid of tiles is generated based on the grid parameters. -
grid_typeType of the grid of tiles to generate. it can be hex, square, or random. -
grid_spot_diamterDiameter of the spot (dimension of a tile) in micrometers. -
grid_spot_horizontal_spacingHorizontal center-to-center distance between adjacent spots (or tiles). -
grid_aspect_correctionFactor to correct Visium slide aspect ratio. -
overlap_scale_factorImaging features extraction parameter. If the factor is 1, then features are extracted from the tile of the ST spot dimension. -
hovernet_segmentationDo HoVer-Net segmetation. If false do StarDist segmentation. -
nuclei_segmentation_dirname of directory to save segmentation. -
hovernet_batch_sizeParameter of HoVer-Net segmetation. This parameter is ignored when segmentation is done with StarDist. -
hovernet_num_inference_workersParameter of HoVer-Net segmetation. This parameter is ignored when segmentation is done with StarDist. -
hovernet_chunk_sizeParameter of HoVer-Net segmetation. This parameter is ignored when segmentation is done with StarDist. -
hovernet_tile_sizeParameter of HoVer-Net segmetation. This parameter is ignored when segmentation is done with StarDist. -
stardist_modelPath to checkpoint of stardist model. -
stardist_block_sizeSize of the image block to run segmentation. Blocks are merged internally at the end of segmentation. -
stardist_expand_sizeSize of cytoplasm arouhd nucleus in pixels. -
hovernet_spot_assignment_factorUsed for either HoVer-Net or StarDist segmentation postprocessing. Scaling factor of the boundary limiting the inclusion of nuclei to an ST spot. A value of 1 means the boundary size equals ST spot size. -
hovernet_spot_assignment_shapeUsed for either HoVer-Net or StarDist segmentation postprocessing. The shape of the boundary, either square or disk. -
hovernet_min_cell_type_probUsed for either HoVer-Net or StarDist segmentation postprocessing. This filtering parameteris used to remove nuclei assigned with low confidence. -
extract_tile_featuresExtract (generate) imaging features for all tiles. -
extract_inception_featuresIfextract_tile_featuresthen do Inception V3 features. -
extract_transpath_featuresIfextract_tile_featuresthen do TransPath features. -
extract_uni_featuresIfextract_tile_featuresthen do UNI features. -
extract_conch_featuresIfextract_tile_featuresthen do CONCH features. -
transpath_features_modelOne of 'CTransPath' or 'MoCoV3'. -
use_conch_normalizerUse specialized CONCH normalizer, instead of the standard normalizer used with UNI and CTransPath. -
uni_model_checkpointPath to downloaded CONCH checkpoint. Download requires registration https://huggingface.co/MahmoodLab/UNI/blob/main/pytorch_model.bin. -
conch_model_checkpointPath to downloaded CONCH checkpoint. Download requires registration https://huggingface.co/MahmoodLab/CONCH/blob/main/pytorch_model.bin. -
do_superpixelsDo superpixel segmentation using SNIC algorithm. -
export_superpixels_contoursIf true, export superpixel contours in JSON format. -
superpixel_compactnessSuperpixel compactness parameter, see details of SNIC algorithm. -
pixels_per_segmentNumber of pixels per superpixel segment, i.e., superpixel size. -
superpixel_patch_sizeSuperpixel patch size. Warning: patches boundaries are kept flat. -
superpixel_downsampling_factorSuperpixel downsampling factor for the input image downsampling . -
od_block_sizeBlock size for OD calculation. -
expand_nuclei_distanceDistance in pixels to expand the nuclei mask. -
export_imageExport the resized and normalized image in OME-TIFF format. -
export_image_metadataExport input image metadata in OME-XML format. -
compressionCompression library to use with OME-TIFF, e.g., 'LZW'. -
downsample_expanded_tileDownsample expanded tile. -
expansion_factorTile is read from expanded area around the tile center. -
subtilingIf true, split tile into subtiles, then extract features and compute average across the subtiles. -
subcoords_factorFactor that defines the size of subtiles. -
subcoords_listCenters of the subtiles within a tile. -
do_clusteringDo dimensionality reduction and clustering. Generate spatial and UMAP plots of imaging feature clusters as well as nucler morphometric features and classification results. -
expansion_factor_for_clusteringFeatures of the specified expansion factor are used for clustering. -
suffix_for_clusteringFeatures of this type are used for clustering. -
plot_dpiDPI (dots per inch) of the figures. -
hovernet_device_modeGPU or CPU device for use with HoVer-Net. -
ctranspath_device_modeGPU or CPU device for use with TransPath inference models. -
sample_tiles_subworkflowRun a subworkflow where a small number of tiles is saved, along with the HoVer-Net classification data. -
tiles_per_slideNumber of randomly selected tiles to use in the sampling tiles subworkflow. -
do_segmentation_anndataDEPRECATED parameter, will be removed in future.