Galaxy | Tool Preview

SaveImages (version 3.1.9+galaxy2)
The following types of images can be saved as a file on the hard drive:
- Image: Any of the images produced upstream of SaveImages can be selected for saving. Outlines of objects created by other modules such as Identify modules, Watershed, and various object processing modules can also be saved with this option, but you must use the OverlayOutlines module to create them prior to saving images. Likewise, if you wish to save the objects themselves, you must use the ConvertObjectsToImage module to create a savable image.
- Mask: Relevant only if a module that produces masks has been used such as Crop, MaskImage, or MaskObjects. These modules create a mask of the pixels of interest in the image. Saving the mask will produce a binary image in which the pixels of interest are set to 1; all other pixels are set to 0.
- Cropping: Relevant only if the Crop module is used. The Crop module also creates a cropping image which is typically the same size as the original image. However, since Crop permits removal of the rows and columns that are left blank, the cropping can be of a different size than the mask.
- Movie: A sequence of images can be saved as a TIFF stack.
- Only tiff supports saving as 16-bit or 32-bit. tiff is a "lossless" file format.
- png is also a "lossless" file format and it tends to produce smaller files without losing any image data.
- jpeg is also small but is a "lossy" file format and should not be used for any images that will undergo further quantitative analysis.
- Select npy to save an illumination correction image generated by CorrectIlluminationCalculate.
Several choices are available for constructing the image file name:
- From image filename: The filename will be constructed based on the original filename of an input image specified in NamesAndTypes. You will have the opportunity to prefix or append additional text. If you have metadata associated with your images, you can append text to the image filename using a metadata tag. This is especially useful if you want your output given a unique label according to the metadata corresponding to an image group. The name of the metadata to substitute can be provided for each image for each cycle using the Metadata module.
- Sequential numbers: Same as above, but in addition, each filename will have a number appended to the end that corresponds to the image cycle number (starting at 1).
- Single name: A single name will be given to the file. Since the filename is fixed, this file will be overwritten with each cycle. In this case, you would probably want to save the image on the last cycle (see the Select how often to save setting). The exception to this is to use a metadata tag to provide a unique label, as mentioned in the From image filename option.
Specify at what point during pipeline execution to save file(s).
- Every cycle: Useful for when the image of interest is created every cycle and is not dependent on results from a prior cycle.
- First cycle: Useful for when you are saving an aggregate image created on the first cycle, e.g., CorrectIlluminationCalculate with the 'All setting' used on images obtained directly from NamesAndTypes.
- Last cycle: Useful for when you are saving an aggregate image completed on the last cycle, e.g., CorrectIlluminationCalculate with the 'All setting' used on intermediate images generated during each cycle.

What it does

SaveImages saves image or movie files. Because CellProfiler usually performs many image analysis steps on many groups of images, it does not save any of the resulting images to the hard drive unless you specifically choose to do so with the SaveImages module. You can save any of the processed images created by CellProfiler during the analysis using this module. You can choose from many different image formats for saving your files. This allows you to use the module as a file format converter, by loading files in their original format and then saving them in an alternate format.

Input

Existing CellProfiler pipeline file (.cppipe) or generated by linking CellProfiler tools.

Output

The input CellProfiler pipeline file (.cppipe) in addition to the settings of this module.

IMPORTANT

The first tool in a CellProfiler workflow has to be Starting modules and the last one CellProfiler. You can also execute the entire pipeline with the final CellProfiler tool, in which you feed in the images you want to process as well.