Overview

This application applies a binary mask on an input image and saves the result in a given TIFF file. Input image and binary mask are loaded from given TIFF files.

See also: masking algorithm

Usage

The application can be called through a command line as follows:

   <application_script_filename> [--inputImgFilePath <input_image_file_path>] [--maskImgFilePath <mask_image_file_path] [--outputImgFilePath <output_image_file_path>]
     
   Arguments:
      --inputImgFilePath  optional; specifies the path of the TIFF file, from
                          which the input image will be loaded; if not 
                          specified by the user, the input image is loaded from
                          file 
                          <DEV_ROOT>/data/Sample/images/Lena_510x509_UInt8.tif
                          
      --maskImgFilePath    optional; specifies the path of the TIFF file, from
                           which the binary image of mask will be loaded; if not
                           specified by the user, the input image is loaded from
                           file
                           <DEV_ROOT>/data/Sample/iamges/binary_mask.tif
                          
      --outputImgFilePath optional; specifies the name of the TIFF file, in
                          which the output image resulting from the 
                          Otsu's binarization will be saved;
                          if not specified by the user, the output image is 
                          saved in file
                          <TEMPORARY_IPSDK_DIR>/Sample/mask.tif

Here is a snapshot of default input and mask images used by the application and of corresponding output image when application is launched without any argument:

Source code documentation

We start by importing all necessary libraries:

import os
import sys, getopt
import PyIPSDK
import PyIPSDK.IPSDKIPLLogical as logic

Then we define the input parameters.

# retrieve program parameters

inputImgPath, maskImgFilePath, outputImgPath = readCmdArguments(argv)

We load our input image from the associated Tiff file, by calling the function ipsdk::image::file::loadTiffImageFile.

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    maskImg = PyIPSDK.loadTiffImageFile(maskImgFilePath)

We then apply the mask calculation on the input image.

# mask computation

outImg = logic.maskImg(inImg, maskImg)

Lastly, we save the image resulting from the operation to the Tiff file.

    # save generated image
    print("Writing result in file : " + outputImgPath)
    PyIPSDK.saveTiffImageFile(outputImgPath, outImg)

See the full source listing