mea_replace Documentation

mea_replace.pl - Merge/reformat millimeter measurements
mea_replace is primarily for updating a large millimeter
measurement file with new measurements, but also serves as a
general file operations tool for millimeter measurements.
It works by taking in a base millimeter measurement file
(FROM) and optionally replacing (REPLACE) or deleting
(DELETE) measurements before they are output.

If REPLACE is given, measurements in REPLACE will replace
measurements in FROM that have the same Picture ID (FSC)
and Point ID. Measurements in FROM but not REPLACE will
be output as they appear in FROM. If there are measurements
in REPLACE that are not in FROM, they will only be output
if ADD=YES (the default).

If DELETE is given, measurements in FROM or REPLACE that
are in DELETE will not be output.

Four examples of file operations are:

  1. Merge w/ delete - this is what the Fortran program
     mea_replace did. It allows for refinement of measurements
     in a large solution. This is run by giving the program
     three input files, FROM, REPLACE, and DELETE and
     and setting ADD to YES. To add new measurements to the
     solution, add them to REPLACE. To delete points, add them
     to DELETE. Put all changed measurements in REPLACE, so
     they will replace the old measurements.

  2. Replace - this can be used to bring in measurements from
     a known good source, without changing which measurements
     are in the solution. This is done by giving two input
     files, FROM and REPLACE, and setting ADD to NO.
     The output will have the same number of lines as FROM,
     with the same ID's, even if there are extra measurements
     in REPLACE.

  3. Delete - Give two input files, FROM and DELETE, and
     the measurements in DELETE will be removed from FROM.

  4. Reformat - Give only FROM and TO, and FROM's
     contents will be output in the new format.

For more information, see the web page.

PROGRAMMER: Ben Atkin

Base mm measurement file

NONE

Replacement mm meas file

--

Delete file

--

Output file

NONE

Add to FROM?

YES

ADDITIONAL NOTES:

Parm	Description
FROM	Base millimeter measurement file
REPLACE	Millimeter measurement file containing measurements to add to and/or replace measurements in base meeasurement file (FROM)
DELETE	Measurement file containing measurements that will be removed from the output
TO	The output file, which will have the measurements in FROM file, plus any measurements in REPLACE, minus any measurements in REPLACE. When there are records with the same Picture ID (fsc) and Point ID between FROM and REPLACE, the ones in REPLACE will be output.
ADD	If set to yes, measurements appearing in REPLACE but not in FROM will appear in the output. If set to NO, and DELETE is not given, the output will have exactly the same number of points and point id/image id combinations, only possibly different values.