Optional Arguments
The following arguments are optional additions to a Bases2Fastq execution command. Arguments that affect run parameters default to the value recorded in the RunParameters.json
file from the sequencing run.
--chemistry-version
Use --chemistry-version
to overwrite the sequencing kit version in RunParameters.json
with one of the following valid values:
Cloudbreak
for a Cloudbreak kitCloudbreakFS
for a Cloudbreak Freestyle kitCloudbreakUQ
for a Cloudbreak UltraQ kit1
for a historical version 1 kit
bases2fastq /input /output --chemistry-version Cloudbreak
--demux-only
Use --demux-only
or -d
to enable demultiplexing-only mode, which performs demultiplexing and outputs index metrics without generating any FASTQ files.
bases2fastq /input /output --d
bases2fastq /input /output --demux-only
--detect-adapters
Use --detect-adapters
to detect adapter sequences and override any sequences present in the run manifest. For more information, see Adapter Trimming.
bases2fastq /input /output --detect-adapters
--error-on-missing
Use --error-on-missing
to make an execution terminate when a non-critical file is missing, rather than the default behavior of skipping the file and continuing the execution.
bases2fastq /input /output --error-on-missing
--exclude-tile
Use --exclude-tile
or -e
to specify a subset of tiles to exclude from processing. The argument uses regex to identify the tiles. To specify multiple subsets, enter the argument multiple times.
The following examples exclude the tiles from lane 1.
bases2fastq /input /output -e 'L1R..C..S.'
bases2fastq /input /output --exclude-tile 'L1R..C..S.'
--filter-mask
Use --filter-mask
to apply a custom base mask to specify the cycles that determine if a read passes filter. Separate each read section with a hyphen. The argument is only compatible with Cloudbreak or Cloudbreak Freestyle chemistry. The default values are R1:Y15N*
and R2:Y15N*
. In AVITI OS, the Filter Mask setting for the Advanced Run Settings add-on can modify the default values.
The following example applies a filter mask with the base mask I1:Y4N*
, which refers to the first four cycles of the Index 1 read.
bases2fastq /input /output --filter-mask I1:Y4N*
The following example applies a filter mask with the base masks R1:Y18N*
and R2:Y18N*
, which refer to the first 18 cycles of both Read 1 and Read 2.
bases2fastq /input /output --filter-mask R1:Y18N*-R2:Y18N*
--flowcell-id
Use --flowcell-id
to overwrite the flow cell ID in RunParameters.json
with another flow cell ID. You can use this argument to add a missing flow cell ID.
The following example updates the flow cell ID to 123abc123
.
bases2fastq /input /output --flowcell-id 123abc123
--force-index-orientation
Use --force-index-orientation
to perform demultiplexing without detecting the index sequence orientation. When used, Bases2Fastq applies the orientation recorded in the run manifest.
bases2fastq /input /output --force-index-orientation
--help
Use --help
or -h
to display the usage statement for Bases2Fastq.
bases2fastq -h
bases2fastq --help
--i1-cycles
Use --i1-cycles
to overwrite the number of cycles in Index 1 in RunParameters.json
with another value.
bases2fastq /input /output --i1-cycles 16
--i2-cycles
Use --i2-cycles
to overwrite the number of cycles in Index 2 in RunParameters.json
with another value.
bases2fastq /input /output --i2-cycles 16
--include-tile
Use --include-tile
or -i
to specify a subset of tiles to include in the execution. To include specific tiles, you must first exclude all tiles with the --exclude-tile
or -e
argument. The argument uses regex to identify the selected tiles. To specify multiple subsets, enter the argument multiple times.
The following example includes the subset of tiles L1R..C..S2
after excluding all tiles.
bases2fastq /input /output --exclude-tile 'L.*R..C..S.' --include-tile 'L1R..C..S2'
The following example includes the additional subset of tiles L2R..C..S1
.
bases2fastq /input /output -e 'L.*R..C..S.' -i 'L1R..C..S2' -i 'L2R..C..S1'
--input-remote
Use --input-remote
to set the rclone remote name that points to the input files.
bases2fastq /input /output --input-remote '<input-name>'
--kit-configuration
Use --kit-configuration
to overwrite the kit configuration in RunParameters.json
with one of the following valid values:
150Cycles
for a 2 x 75 kit300Cycles
for a 2 x 150 kit600Cycles
for a 2 x 300 kit
bases2fastq /input /output --kit-configuration 300Cycles
--legacy-fastq
Use --legacy-fastq
to apply a legacy file naming convention to FASTQ files, such as SampleName_S1_L001_R1_001.fastq.gz
. Some secondary analysis software might require this naming convention.
The --legacy-fastq
argument is not compatible with lane merging. When you use the --legacy-fastq
argument, Bases2Fastq writes the FASTQ files as split lanes. Therefore, if you combine the --split-lanes
and --legacy-fastq
arguments, the --legacy-fastq
argument takes precedence, and Bases2Fastq displays a warning message before proceeding with the execution.
bases2fastq /input /output --legacy-fastq
--log-level
Use --log-level
or -l
to specify the minimum level required to log an event. Use one of the following valid values. The default value is INFO
.
INFO
DEBUG
WARNING
ERROR
bases2fastq /input /output -l DEBUG
bases2fastq /input /output --log-level WARNING
--no-error-on-invalid
Use --no-error-on-invalid
to skip non-critical files that Bases2Fastq identifies as invalid.
bases2fastq /input /output --no-error-on-invalid
--no-projects
Use --no-projects
to organize the output file directory without project folders and instead use the standard, sample-based folder structure.
bases2fastq /input /output --no-projects
--num-threads
Use --num-threads
or -p
to specify the number of threads to use for processing, with a minimum value of 1
and a maximum value that depends on your system. The default value is 1
.
bases2fastq /input /output -p 8
bases2fastq /input /output --num-threads 8
--num-unassigned
Use --num-unassigned
to specify a value ≤ 1000 that indicates the maximum number of unassigned sequences to support. The default value is 30
.
bases2fastq /input /output --num-unassigned 20
--output-remote
Use --output-remote
to set the rclone remote name that points to the input files.
bases2fastq /input /output --output-remote '<output-name>'
--preparation-workflow
Use --preparation-workflow
to overwrite the library prep workflow in RunParameters.json
with one of the following valid values:
Adept
Elevate
ThirdParty
bases2fastq /input /output --preparation-workflow Elevate
--qc-only
Use --qc-only
to enable QC-only mode, which generates a representative view of run metrics on one tile and no FASTQ files. Executions in QC-only mode are faster than executions with demultiplexing and can support the following scenarios:
- Troubleshooting parameters applied to execution
- Troubleshooting execution issues for specific tiles
- Quickly obtaining QC metrics for a run
bases2fastq /input /output --qc-only
You can use --include-tile
to execute QC-only mode on more than one tile. The following example executes QC-only mode on all tiles in lane 1.
bases2fastq /input /output --qc-only --include-tile 'L1R..C..S.'
--r1-cycles
Use --r1-cycles
to overwrite the number of cycles for Read 1 in RunParameters.json
with another value.
bases2fastq /input /output --r1-cycles 48
--r2-cycles
Use --r2-cycles
to overwrite the number of cycles for Read 2 in RunParameters.json
with another value.
bases2fastq /input /output --r2-cycles 48
--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 information on corrected run manifests, see the Run Manifest Documentation.
bases2fastq /input /output -r /input/<corrected_manifest_filename.csv>
bases2fastq /input /output -run-manifest /input/<corrected_manifest_filename.csv>
--settings
Use --settings
to overwrite run manifest settings. Entering the argument for each setting you want to overwrite. For more information on available settings, see the Run Manifest Documentation.
The following example changes the run manifest setting for generating an Index 1 FASTQ file to True
.
bases2fastq /input /output --settings 'I1Fastq,True'
If you want to overwrite two different settings, you can use --settings
twice. The following example also changes the Index 1 base mask to I1:N3Y*
.
bases2fastq /input /output --settings 'I1Fastq,True' --settings 'I1Mask,I1:N3Y*'
--skip-qc-report
Use --skip-qc-report
to skip the creation of an HTML QC report.
bases2fastq /input /output --skip-qc-report
--split-lanes
Use --split-lanes
to divide FASTQ files by flow cell lane.
When you use the --legacy-fastq
argument, Bases2Fastq writes the FASTQ files as split lanes. Therefore, if you combine the --split-lanes
and --legacy-fastq
arguments, the --legacy-fastq
argument takes precedence, and Bases2Fastq displays a warning message before proceeding with the execution.
bases2fastq /input /output --split-lanes
--strict
Use --strict
or -s
to enable strict mode, which prevents processing when any input files are invalid. When you do not enable strict mode, Bases2Fastq warns you that files are missing or corrupt but continues processing.
bases2fastq /input /output -s
bases2fastq /input /output --strict
--version
Use --version
or -v
to display the current version of Bases2Fastq. Bases2Fastq logs the version at the start of any execution on the command line and in the log file.
bases2fastq -v
bases2fastq --version