Table of Contents


stemfind - Finds patterns in STEM images produced by ELDICO system


stemfind [ -h (--help) ] [ -h (--location) ] [ -d (--debug) code ] [ -f (--file) FILE ] [ -F (--force) ] [ -r (--results) FILE ] [ -p (--plot) ] [ --png ] [ --min MINCOLOR ] [ --max MAXCOLOR ] [ -L (--loglevel) LEVEL ] [ -M (--meshes) ] [ -N (--pin) ] [ -P (--particles) ] [ --pmin SIZE ] [ --pmax SIZE ] [ -x (--x) NX ] [ -y (--y) NY ] [ -Y (--y0) ] [ -s (--size) SCALE ] [ --tiff ] [ -u (--update) ] [ -v (--verbose) ] [ -V (--VERSION) ] [ file ]


stemfind is a program to find specific patterns in a STEM image. Currently the program implements particles, alignment pins, grids and meshes. When looking for a particle (default), the program determines the centroid of a blob closest to the vertical center (y=0) or closest to the physical center of the image. For a pin (or needle) the program determines its tip. When using a grid, the program finds meshes in it. When using a mesh, the program tries to locate several particles in it. In either case, the program prints x,y-coordinates as result plus some further stats. The program can produce an output png or tiff file with a cross-marker at the resulting x,y-coordinates. The program accepts TIFF-files as input or plain ASCII data with X*Y pixels.


-o (--out) NAME
Name of output file. This option is valid only with option --png and only for single image processing.
-f (--file) FILE|DIR
If a single file is given, only this file will be processed. If the argument is a directory, all files with extension ".tiff" and ".report" will be taken.
-h (--help)
Prints a summary of program command line options.
-F (--force)
Force reprocessing even if the TIFF-header already contains an entry with the results.
-x (--x) NX
Horizontal dimension of images.Not required when using TIFF files.
-y (--y) NY
Vertical dimension of images. See -x NX.
-N (--pin)
Try to find the tip of a pin. By default, the program looks for particles.
-M (--meshes)
Try to find the meshes in a grid. The program writes center coordinates of all located meshes into the TIFF file header.
-P (--particles)
Try to find the particles in a mesh. The program writes center coordinates of all located particles into the TIFF file header. This is the default.
Create output file in png format with a marker at the x,y-coordinates of the processing results.
--pmin SIZE
Minimum size of a particle in blob locator. Default: 0.1 um
--pmax SIZE
Maximum size of a particle in blob locator. Default: 4.0 um
-p (--plot)
When processing a series of images, show the results of x,y in a 2D-plot. Requires Python matplotlib to work.
-r (--result) FILE
When processing a series of images, the program will create an ASCII file and write data into that file, that can easily be used by plotting routines. The program write lines with the title and subtitle, followed by an array of x-axis data (PHI position), y-axis data (observed deviations of x from center of image), a fitted line through y-axis data, and a fitted line for x-axis data.
-s (--size) SIZE
Maximum size of particle. Default: 20.0 pixels
--scale SCALE
Factor to apply to all input values. Default: 1.0
Create output file in tiff format with a marker at the x,y-coordinates of the processing results. This option works only when using ".report" files as input files and not tiff files.
-u (--update)
By default, TIFF-headers will be updated with processing results. To turn this off, use option -u.
-v (--verbose)
Increases verbosity level for more program output.
Only show program version and exit.
All remaining arguments are considered to be input-file names. Wildcards allowed.

Input Files

TIFF-files or ASCII ".report" files with STEM data from ELDICO system.

Configuration File

The program reads configuration files from the following locations in the given order (in parenthesis: Windows)
current_working_directory/stemfind.cfg (stemfind.ini)
$HOME/.stemfind.cfg (%HOME%\stemfind.ini)

Entries given in the next available file will override all previous entries. This allows for mixing entries that can be changed by the user with entries set by a system administrator.


Claudio Klein, MarXperts GmbH, Norderstedt, Germany.


© Copyright 2021-2023 Marxperts GmbH, Norderstedt, Germany


MarXperts GmbHPhone: +49 - (40) - 529 884-0
Werkstr. 3 FAX: +49 - (40) - 529 884-20
D-22844 Norderstedt -

Table of Contents