4.104 sddsspotanalysis

• description: sddsspotanalysis locates and provides details about spots in multi-column SDDS image files.
• examples:
  sddsspotanalysis image.input image.output  
      

• synopsis:
  sddsspotanalysis [Inputfile] [Outputfile] [-pipe[=in][,out]]  
    [-ROI=[{xy}{01}value=value][,{xy}{01}parameter=name]]  
    [-spotROIsize=[{xy}value=value][,{xy}parameter=name]]  
    [-centerOn={xycentroid|xypeak}]  
    [-imageColumns=listOfNames]  
    [-singleSpot]  
    [-levels=[intensity=integer][,saturation=integer]]  
    [-blankOut=[{xy}{01}value=value][,{xy}{01}parameter=name]]  
    [-sizeLines=[{xy}value=value][,{xy}parameter=name]]  
    [-background=[halfwidth=value][,symmetric][,antihalo][,antiloner]]  
    [-despike[=neighbors=integer][,passes=integer][,averageOf=integer][,threshold=value]]  
    [-spotImage=filename]  
      

• files: Inputfile is the multi-column SDDS input image file. Outputfile contains spot property information.
• switches:
  • -pipe[=in][,out] — The standard SDDS Toolkit pipe option.
  • -ROI=[{xy}{01}value=value][,{xy}{01}parameter=name] — Used to give the region of interest in pixel units. All data outside this region is ignored.
  • -spotROIsize=[{xy}value=value][,{xy}parameter=name] — Used to give the full size in pixel units of the region of interest (ROI) around the spot. This ROI is used for computing spot properties.
  • -centerOn={xycentroid|xypeak} — Choose whether to center the spot analysis region on the peak value or the centroid value for x and y.
  • -imageColumns=listOfNames — Give a list of names of columns containing image data. Wildcards may be used.
  • -singleSpot — Used to eliminate multiple spots. All pixels not connected to the most intense pixel by a path through nonzero pixels are set to zero.
  • -levels=[intensity=integer][,saturation=integer] — Use intensity to give the number of intensity levels in the data; 256 is the default, with values from 0 to 255. Use saturation to give the level at which saturation is considered to occur; 254 is the default.
  • -blankOut=[{xy}{01}value=value][,{xy}{01}parameter=name] — Pixels within the specified region are set to zero.
  • -sizeLines=[{xy}value=value][,{xy}parameter=name] — Specify the number of lines to use for analysis of the beam size. The default is 3.
  • -background=[halfwidth=value][,symmetric][,antihalo][,antiloner] — Use halfwidth to specify the number of intensity levels on either side of the most populous intensity to include for computation of the background. The default is 3. Setting this to zero means that the background level is equal to the intensity of the most populous level. If symmetric is given, then pixels within this width of 0 after background subtraction are set to zero if the intensity of all but one adjacent pixel is less than this level; this symmetrizes the background removal and avoids leaving positive noise. If antihalo is given, then each line of the spot ROI is scanned from the outer edge toward the center. Pixels within the halfwidth of 0 after background subtraction are set to zero, until the first pixel is reached which fails this criterion, after which the next line is processed. If antiloner is given, then after background subtraction, the program removes any pixel that is surrounded by all zero pixels.
  • -despike[=neighbors=integer][,passes=integer][,averageOf=integer][,threshold=value] — Enter despiking parameters for smoothing the data for purposes of finding the spot center. If this isn’t used then the program may pick a noise pixel as the spot center. Default equivalent to -despike=neighbors=4,passes=2,averageOf=4.
  • -spotImage=filename — Provide the name of a file to which images of the spots will be written. The file can be plotted with sddscontour.
• see also:
  • sddscongen()
  • sddscontour()
  • sddsimageconvert()
  • sddsimageprofiles()
• author: R. Soliday, ANL/APS.