Input control

Select which file(s) or folder(s) MIA will process through.

Description

Select which file(s) or folder(s) MIA will process through. If a file is selected, that file alone will be processed; however, selecting a folder will cause the system to iterate over all files and sub-folders within that folder. Each file identified here will initialise its own workspace.

It is possible to add filters to limit which files are used. Multiple filters can be applied.

n.b. This module simply creates the workspace for subsequent analysis; no images are automatically loaded at this point. To load image data to the workspace use the "Load image" module.

Parameters

ParameterDescription
Input pathThe file or folder path to process. If a file is selected, that file alone will be processed. If a folder is selected, each file in that folder (and all sub-folders) passing the filters will be processed.
Series modeFor multi-series files, select which series to process:
  • "All series" will create a new workspace for each series in the file.
  • "Series list" allows a comma-separated list of series numbers to be specified.
Series listComma-separated list of series numbers to be processed.
Only load first file per folderOnly load the (alphabetically) first file in each folder.
Only load first matching groupOnly load the (alphabetically) first file matching the group specified by the regular expression "Pattern" parameter. Each candidate filename will be matched against the regular expression in "Pattern" and retained for analysis if the selected group hasn't been seen before. Only one group (specified using standard regex parenthesis notation) can be used.
PatternRegular expression pattern to use when "Only load first matching group" is enabled. This pattern must contain at least one group (specified using standard regex parenthesis notation).
Spatial unitSpatial units for calibrated measurements. Assuming spatial calibration can be read from the input file when loaded, this will convert the input calibrated units to the units specified here.
Temporal unitTemporal units for calibrated measurements. Assuming temporal calibration can be read from the input file when loaded, this will convert the input calibrated units to the units specified here.
Ignore case
Add filterAdd another filename filter. All images to be processed will pass all filters.
Filter sourceType of filter to add.
Filter valueValue to filter filenames against.
Filter typeControl how the present filter operates:
  • "Matches partially (include)" will process an image if the filter value is partially present in the source (e.g. filename or extension).
  • "Matches completely (include)" will process an image if the filter value is exactly the same as the source.
  • "Matches partially (exclude)" will not process an image if the filter value is partially present in the source.
  • "Matches completely (exclude)" will not process an image if the filter value is exactly the same as the source.
Simultaneous jobsThe number of images that will be processed simultaneously. If this is set to "1" while processing a folder each valid file will still be processed, they will just complete one at a time. For large images this is best left as "1" unless using a system with large amounts of RAM.