mapping/spaceranger_count

spaceranger

Description

Count gene expression and protein expression reads from a single capture area.

Type

bash_script

Keywords

spaceranger

Links

Repository

Documentation

Contributors

Launch

Run this component

Run the following command to execute this component with Nextflow:

cat > params.yaml <<'EOM'  
output: "$id.$key.output./path/to/output"  
reorient_images: [ true ]  
create_bam: [ true ]  
filter_probes: [ true ]  
id: "run"  
publish_dir: "output/"  
EOM

nextflow run https://packages.viash-hub.com/vsh/openpipeline_spatial.git \  
  -revision v0.1.1 \  
  -main-script target/nextflow/mapping/spaceranger_count/main.nf \  
  -params-file params.yaml

Inputs

Name	Type & Properties	Description
--gex_reference	file required	Path of folder containing 10x-compatible reference
--input	file required	Path to a directory containing input FASTQ data. Individual FASTQ files should follow the naming convention of 10x Genomics: [Sample Name]_S[Sample Number]_L[Lane Number]_[Read Type]_001.fastq.gz Where: [Sample Name] is the name assigned during sample preparation/sequencing S[Sample Number] is the sample index (usually S1, S2, etc.) L[Lane Number] identifies the sequencing lane (L001, L002, etc.) [Read Type] will be one of: R1 - Read 1 (contains the spatial barcode and UMI) R2 - Read 2 (contains the actual cDNA sequence) I1 - Index Read 1 (if applicable) I2 - Index Read 2 (if applicable)
--probe_set	file required	CSV file specifying the probe set used
--cytaimage	file	Brightfield image generated by the CytAssist instrument. When using CytAssist workflow, either this or --image must be provided.
--image	file	H&E or fluorescence microscope image in TIFF or JPG format. Required for standard Visium workflow, optional when using --cytaimage for CytAssist workflow.

Name

Type & Properties

--gex_reference

file

required

--input

file

required

--probe_set

file

required

--cytaimage

file

--image

file

Outputs

Name	Type & Properties	Description
--output	file required output	The folder to store the alignment results

Name

Type & Properties

--output

file

required

output

Slide Information

Name	Type & Properties	Description
--slide	string	Visium slide serial number (e.g., 'V10J25-015')
--area	string	Visium capture area identifier (e.g., 'A1')
--unknown_slide	string	Use this option if the slide serial number and area were entered incorrectly on the CytAssist instrument and the correct values are unknown. Not compatible with --slide, --area, or --slide-file options
--slidefile	file	Slide design file for offline use
--override_id	boolean_true	Overrides the slide serial number and capture area provided in the Cytassist image metadata

Name

Type & Properties

--slide

string

--area

string

--unknown_slide

string

--slidefile

file

--override_id

boolean_true

Image Options

Name	Type & Properties	Description
--darkimage	file	Multi-channel, dark-background fluorescence image
--colorizedimage	file	Color image representing pre-colored dark-background fluorescence images
--dapi_index	integer	Index of DAPI channel (1-indexed) of fluorescence image
--image_scale	double	Microns per microscope image pixel
--reorient_images	boolean	Whether to rotate and mirror image to align fiducial pattern

Name

Type & Properties

--darkimage

file

--colorizedimage

file

--dapi_index

integer

--image_scale

double

--reorient_images

boolean

Processing Options

Name	Type & Properties	Description
--create_bam	boolean required	Enable or disable BAM file generation
--nosecondary	boolean_true	Disable secondary analysis (e.g., clustering)
--r1_length	integer	Hard trim the input Read 1 to this length before analysis
--r2_length	integer	Hard trim the input Read 2 to this length before analysis
--filter_probes	boolean	Whether to filter the probe set using the "included" column
--custom_bin_size	integer	Bin Visium HD data to specified size in microns (4-100, even values only) in addition to the standard binning size (2 µm, 8 µm, 16 µm)

Name

Type & Properties

--create_bam

boolean

required

--nosecondary

boolean_true

--r1_length

integer

--r2_length

integer

--filter_probes

boolean

--custom_bin_size

integer

Input Selection

Name	Type & Properties	Description
--project	string	Project folder name within mkfastq output
--sample	string	Prefix of FASTQ filenames to select
--lanes	integer multiple	Only use FASTQs from selected lanes

Name

Type & Properties

--project

string

--sample

string

--lanes

integer

multiple