Command Line Interface
lls-pipeline
Usage:
Options:
[INPUT_IMAGE] Path to the image file to read, in a format
readable by AICSImageIO, for example .tiff
or .czi
--skew [X|Y] Axis along which to deskew the image.
Choices: `{"X", "Y"}`. These can be provided
as `str`. \[default: Y]
--angle FLOAT Angle of deskewing, in degrees, as a float.
\[default: 30.0]
--invert-scan-direction / --no-invert-scan-direction
If `True`, reverse the order of planes along
the scan (Z) axis before deskewing. This is
required for oblique plane microscopes whose
stage/galvo scans can be in opposite
directions. Leaving this `False` preserves
the original behaviour compatible with Zeiss
LLS. \[default: no-invert-scan-direction]
--physical-pixel-sizes <FLOAT FLOAT FLOAT>...
Pixel size of the microscope, in microns.
This can alternatively be provided as a
`tuple[float]` of `(Z, Y, X)` This takes
three arguments, corresponding to the Z, Y
and X pixel dimensions respectively
\[default: 0.3, 0.1499219272808386,
0.1499219272808386]
--roi-list PATH List of regions of interest, each of which
must be an `N × D` array, where N is the
number of vertices and D the coordinates of
each vertex. This can alternatively be
provided as a `str` or `Path`, or a list of
those, in which case each they are
interpreted as paths to ImageJ ROI zip files
that are read from disk.
--roi-subset TEXT A subset of all the ROIs to process. Each
list item should be an index into the ROI
list indicating an ROI to include. This
allows you to process only a subset of the
regions from a ROI file specified using the
`roi_list` parameter. If `None`, it is
assumed that you want to process all ROIs.
Accepts either repeated flags (--roi-subset
2 --roi-subset 5) or a comma-separated list
(--roi-subset 2,5,7).
--z-range <INTEGER INTEGER>... The range of Z slices to take as a tuple of
the form `(first, last)`. All Z slices
before the first index or after the last
index will be cropped out.
--deconvolution / --disable-deconvolution
\[default: disable-deconvolution]
--decon-processing [cuda_gpu|opencl_gpu|cpu]
Hardware to use to perform the
deconvolution. Choices: `{"cuda_gpu",
"opencl_gpu", "cpu"}`. Can be provided as
`str`. \[default: cpu]
--psf PATH List of Point Spread Functions to use for
deconvolution. Each of which should be a 3D
array. Each PSF can also be provided as a
`str` path, in which case they will be
loaded from disk as images.
--decon-num-iter INTEGER Number of iterations to perform in
deconvolution \[default: 10]
--background TEXT Background value to subtract for
deconvolution. Only used when
`decon_processing` is set to `GPU`. This can
either be a literal number, "auto" which
uses the median of the last slice, or
"second_last" which uses the median of the
last slice. \[default: 0]
--time-range <INTEGER INTEGER>...
The range of times to process. This defaults
to all time points in the image array.
--channel-range <INTEGER INTEGER>...
The range of channels to process. This
defaults to all time points in the image
array.
--save-dir PATH The directory where the output data will be
saved. This can be specified as a `str` or
`Path`.
--save-name TEXT The filename that will be used for output
files. This should not contain a leading
directory or file extension. The final
output files will have additional elements
added to the end of this prefix to indicate
the region of interest, channel, timepoint,
file extension etc.
--save-type [h5|tiff|omezarr] The data type to save the result as. This
will also be used to determine the file
extension of the output files. Choices:
`{"h5", "tiff", "omezarr"}`. Choices can
alternatively be specifed as `str`, for
example `'tiff'`. \[default: h5]
--process-parallel INTEGER Number of worker processes for cropping
ROIs. Each worker processes a subset of the
ROI list independently, sharing the GPU. 1
(default) keeps the serial behaviour; higher
values help when a single ROI does not
saturate the GPU. 0 means 'auto': a memory-
safe worker count is derived from the memory
estimate (disabled for
deconvolution/workflow runs, which it cannot
size). Ignored when cropping is disabled.
\[default: 1]
--memory-safety-factor FLOAT Multiplier applied to the estimated per-
worker working set in the memory estimate,
covering OpenCL scratch buffers and
fragmentation. Increase if you hit OOM
crashes with parallel processing; decrease
for more aggressive packing. \[default:
1.5]
--workflow PATH If defined, this is a workflow to add
lightsheet processing onto
--json-config PATH Path to a JSON file from which parameters
will be read.
--yaml-config PATH Path to a YAML file from which parameters
will be read.
--estimate / --no-estimate If provided, print a VRAM/RAM memory
estimate for the configured pipeline and
exit without processing. Useful for sizing
SLURM jobs or picking a value for --process-
parallel. \[default: no-estimate]
--show-schema / --no-show-schema
If provided, image processing will not be
performed, and instead a JSON document
outlining the JSON/YAML options will be
printed to stdout. This can be used to
assist with writing a config file for use
with the --json-config and --yaml-config
options. \[default: no-show-schema]
--help Show this message and exit.