Optional Arguments
The following arguments are optional additions to a Cells2Stats execution command:
--batch
Use --batch
or -b
to restrict analysis to batch(es) that match the comma-delimited list of batches. Allowed values are B1-B8, based on how many batches are present in the run.
cells2stats /input --batch <BATCH_LIST>
cells2stats /input -b <BATCH_LIST>
--bases2fastq
Use --bases2fastq
or -B
to specify the path to the Bases2Fastq binary to use. This is an external dependency that is used to generate FASTQ files during OPS analysis.
cells2stats /input --bases2fastq <PATH_TO_BASES2FASTQ_BINARY>
cells2stats /input -B <PATH_TO_BASES2FASTQ_BINARY>
--bowtie
Use --bowtie
to specify the path to the Bowtie binary to use. This is an external dependency that is used in Optical Pooled Screen analysis.
cells2stats /input --bowtie <PATH_TO_BOWTIE_BINARY>
--bowtie-build
Use --bowtie-build
to specify the path to the Bowtie-build binary to use. This is an external dependency that is used in Optical Pooled Screen analysis.
cells2stats /input --bowtie-build <PATH_TO_BOWTIE_BUILD_BINARY>
--cellprofiler
Use --cellprofiler
or -c
to specify the path to the CellProfiler utility to use. This is an external dependency that is used to generate morphology metrics. If you do not want to specify a CellProfiler utility and do not have CellProfiler installed, then run with --skip-cellprofiler.
cells2stats /input --cellprofiler <PATH/TO/CELLPROFILER>
cells2stats /input -c <PATH/TO/CELLPROFILER>
--error-on-missing
Use --error-on-missing
or -m
to terminate an execution for a missing file. By default, missing files are skipped and execution continues.
cells2stats /input --error-on-missing
cells2stats /input -m
--help
Use --help
or -h
to display the usage statement for Cells2Stats.
cells2stats --help
cells2stats -h
--input-remote
Use --input-remote
to set the rclone remote name for the remote INPUT_DIRECTORY
.
cells2stats /input --input-remote '<INPUT_DIRECTORY_NAME>'
--log-level
Use --log-level
or -l
to specify the minimum level required to log an event. The default value is INFO
. Use one of the following valid values:
INFO
DEBUG
WARNING
ERROR
cells2stats /input --log-level <MIN_LOG_LEVEL>
cells2stats /input -l <MIN_LOG_LEVEL>
--max-unassigned
Use --max-unassigned
or -u
to limit the number of unassigned sequenced that are reported, from 1-10000 sequences. By default, the value is set to 30.
cells2stats /input --max-unassigned <MAX_UNASSIGNED_SEQUENCES>
cells2stats /input -u <MAX_UNASSIGNED_SEQUENCES>
--no-error-on-invalid
Use --no-error-on-invalid
or -n
to skip invalid files and continue execution. By default, missing files are skipped and execution continues.
cells2stats /input --no-error-on-invalid
cells2stats /input -n
--num-threads
Use --num-threads
or -j
to specify the number of threads to use for processing, with a minimum value of 1
and a maximum value that is based on your system. The default value is 1
.
cells2stats /input --num-threads <NUMBER_OF_THREADS>
cells2stats /input -j <NUMBER_OF_THREADS>
The following examples specify 8
as the number of thread to use for processing:
cells2stats /input --num-threads 8
cells2stats /input -j 8
--output
Use --output
or -o
to specify the location to save the output to. The default location is the INPUT_RUN_DIRECTORY/CYTOPROFILING/<TIMESTAMP>
folder.
cells2stats /input --output <PATH/TO/OUTPUT_LOCATION>
cells2stats /input -o <PATH/TO/OUTPUT_LOCATION>
--output-remote
Use --output-remote
to set the rclone remote name that points to the output files.
cells2stats /input -o /output --output-remote '<OUTPUT_DIRECTORY_NAME>'
--panel
Use --panel
or -p
to define an alternate panel.json
file location, instead of the panel.json
file output by the instrument. The file path can direct to a local or remote location.
cells2stats /input -o /output --panel <PATH/TO/ALTERNATE_PANEL.JSON>
cells2stats /input -o /output -p <PATH/TO/ALTERNATE_PANEL.JSON>
--python
Use --python
or -P
to set the path of the python version to execute.
cells2stats /input -o /output --python <PATH/TO/PYTHON_VERSION>
cells2stats /input -o /output -P <PATH/TO/PYTHON_VERSION>
--run-manifest
Use --run-manifest
or -r
to define the location of an alternate run manifest for the execution instead of the RunManifest.csv
file output by the instrument. For more information on corrected run manifests, see the Run Manifest Documentation.
cells2stats /input -o /output --run-manifest <PATH/TO/CORRECTED_MANIFEST.CSV>
cells2stats /input -o /output -r <PATH/TO/CORRECTED_MANIFEST.CSV>
--samtools
Use --samtools
to specify the path to the Samtools binary to use. This is an external dependency that is used in Optical Pooled Screen analysis. For more information, see the Samtools documentation.
cells2stats /input --samtools <PATH/TO/SAMTOOLS_BINARY>
--segmentation
Use --segmentation
or -S
to pass in a directory of alternative cell segmentation masks. For more information on how to create a directory of cell segmentation masks, see the Resegmentation Using Python tutorial and see the expected format of an Alternative Cell Segmentation Directory.
cells2stats /input -o /output --segmentation <PATH/TO/ALTERNATIVE_CELL_SEGMENTATION_DIRECTORY>
cells2stats /input -o /output -S <PATH/TO/ALTERNATIVE_CELL_SEGMENTATION_DIRECTORY>
--skip-cellprofiler
Use --skip-cellprofiler
to skip the execution of CellProfiler. This saves execution time and allows you to run Cells2Stats without a CellProfiler dependency. When you skip the execution of CellProfiler, morphology features will not be generated in your RawCellStats.csv
or RawCellStats.parquet
files.
cells2stats /input --skip-cellprofiler
cells2stats /input -s
--skip-html-report
Use --skip-html-report
or -H
to skip the creation of the MultiQC HTML report.
cells2stats /input --skip-html-report
cells2stats /input -H
--tca-manifest
Use --tca-manifest
to define an alternate target cell assignment manifest file. The file must be in .csv
format.
cells2stats /input --tca-manifest <PATH/TO/ALTERNATE_TCA_MANIFEST.CSV>
--tile
Use --tile
or -t
to specify the tiles to run on. The argument uses regex to identify the selected tiles. To specify multiple subsets, enter the argument multiple times.
cells2stats --tile <TILES_REGEX>
cells2stats -t <TILES_REGEX>
The following example includes the subset of tiles in Lane 1 L1R..C..S.
:
cells2stats --tile 'L1R..C..S.'
--verbose-transfer
Use --verbose-transfer, -T
to print file names to the terminal when logs are copied.
cells2stats --verbose-transfer, -T
--version
Use --version
or -v
to display the current Cells2Stats version. Cells2Stats logs the version at the start of any execution on the command line and in the log file.
cells2stats --version
cells2stats -v
--visualization
Use --visualization
or -V
to create CytoCanvas™ input files as part of the Cells2Stats output. Use this command if you have a directory of alternative segmentation masks that you want to perform target to cell assignment and regenerate all cell statistics files and visualization files. Otherwise, you can use use --visualization-only
.
cells2stats /input --visualization -S <PATH/TO/ALTERNATIVE_CELL_SEGMENTATION_DIRECTORY>
cells2stats /input -V -S <PATH/TO/ALTERNATIVE_CELL_SEGMENTATION_DIRECTORY>
--visualization-only
Use --visualization-only
or -O
to create CytoCanvas input files as the Cells2Stats output without performing target to cell assignment or regenerating cell statistics files. Use this command if you want to prepare your original run output for visualization in CytoCanvas.
cells2stats /input --visualization-only
cells2stats /input -O
--well
Use --well
or -w
to specify which well or wells to use for a run. Use the following valid values:
- For a 12-well consumable, use A1-F2.
- For a 48-well consumable, use A1-L4.
cells2stats --well <WELL_LOCATIONS>
cells2stats -w <WELL_LOCATIONS>
The following example includes wells A1, A2, and B1:
cells2stats --well A1,A2,B1
cells2stats -w A1,A2,B1