Base File Name

Base File Name

Base file name to save tracking data in (no extension) ?

This option allows the base file name for all the tracking results to be specified. This base name should not include an extension. During the tracking process DigImage automatically creates files of the form base_name.ext, where base_name is the basic file name specified by this entry and .ext is one of the following:

           .PAR    This file is a copy of the Track2D.DIG file and is used to
                   store the controlling parameters for each run so that they
                   may later be recovered during the analysis phase (eg. with
                   Trk2DVel). This file has a binary format and should not be
                   accessed directly.

           .WLD    This file stores a copy of the pixel to world coordinate
                   transformation found in CalWorld.DIG at the time of
                   running the tracking. As with the .PAR file, this is used
                   later in the analysis stage. This file has a binary format
                   and should not be accessed directly.

           .IND    The tracked particles produce data in two files. For each
                   time step there is an entry (one line) produced in the
                   formatted .IND file giving the sample number, two indexes
                   into the .PRT file (corresponding to the records containing
                   the first and last particles for that sample image), the
                   rms error of the reference coordinate system transformation
                   (as set by [;P Coordinate system mapping]), the number of
                   matches found, the buffer number used to contain this
                   sample, the number of times DigImage had to retry acquiring
                   the image to achieve an acceptable rms error (as specified
                   by [LZ Limit on rms error for mapping]), and the degree of
                   correction required by the audio time code pulses in
                   response to loss of synchronisation of the video hardware.
                   The fourth to eighth entries may be subsequently used to
                   trap any low quality frames (this feature is available
                   within the Trk2DVel utility).

           .PRT    This file contains the basic particle location and matching
                   data in a nonstandard binary format. The file contains six
                   bytes for each particle. The first two bytes contain
                   information relating to the type of particle (eg. whether
                   it was faint, large, elliptical etc.) and the index it had
                   in the previous time step. The next four bytes are two
                   unsigned integer*2 representations of the real world
                   particle coordinates rescaled to make full use of the 16
                   bits (ie. the world coordinates of the tracking region are
                   divided into 65536 units). This file should not be accessed

Parent menu

Main Menu

DigImage User Documentation


Stuart Dalziel, last page update: 19 February 1996