/* SccsID = " @(#)get_m2m.doc	1.1 - 98/08/18 " */

    PROGRAM GET_M2M        Version: 1.0  Aug1998

A.  PURPOSE

    This program reads a file of calibrated baseline data and
    splits out the station designations and mark-to-mark
    distances to facilitate creation of the constraint file
    for input into program CALIBRAT. 


B.  EXECUTION:

    Entering the program name GET_M2M with no parameters
    displays the program version, date of release,
    function of the program, required parameters on the
    command line, and the name of the output file.

    To execute the program:

    Enter the program name followed by the two digit
    state calibrated baseline file name.
    Do not use a period or a file extension.
        split ny
    The output file "ny.m2m" will be generated.


C.  OUTPUT

    An output file will be generated that will contain the
    from station, to station, and the mark-to-mark distance
    for all of the baselines for the respective state.
    Selected header lines as they appear in the source file
    will be replicated for identification.


D.  NOTES:

    CALIBRAT expects station names to be numbers.
    This program is intended to prepare a file
    that can be "cut and pasted" to form a constraint file.

    CBL header lines are generally well reproduced
    for identification purposes, especially the
    county name and, if existing, the closest city.

    Although baselines must have four(4) stations,
    this program accepts any number of stations.

    The program searches for the CBL header, then header 
    lines are then read and selectively copied to output.

    Header lines that contain the key words "NEAREST",
    "ADJ.", "FROM" and "LIST" are recognized and given
    special output format to align with output data.

    Calibration baseline records are characterized as having
    four real numbers after column 76.  These records are
    given a special format to exclude all except the two
    station designations and the mark-to-mark distance.

    The CBL header is recognized as either: 
    1US DEPARTMENT OF COMMERCE      or,
    1 US DEPARTMENT OF COMMERCE.

    The Description header is recognized as either:
    DESCRIPTION    or   DESCRIPTION    or
    1DESCRIPTION   or   NAME:  


F.  KNOWN BUGS:

    The program is designed to search for the NGS recommended
    designations of plain numbers that represent the distance
    from the zero station in meters. The program does this by
    searching for the first series of numbers from the beginning
    of the designation name.  Some additional text is
    recognized and edited out. Hence,

    450                  is recognized and used, and
    HIGHPOINT 450 1983   recognizes and uses 450, but not 1983.
    HIGHPOINT 1983       recognizes 1983. Also,
    450 MTS              recognizes 450,
    450M                 recognizes 450.

    CALIBRAT expects a unique whole number to represent
    each station along the baseline, so HIGHPOINT 1983
    will not require editing unless, for example,
    LOWPOINT 1983 is present, which will result in two
    stations with abbreviated designations of 1983.

    The generated constraint file will require editing for
    those baseline stations that have no digits as part of
    their designation.  Baselines with alphabetic designations, 
    i.e., CBL A, CBL B, et cetera, will require editing.

    Those stations that will require editing are easily identified
    by looking at the output file.  If the abbreviated designations
    align with the column headers of FROM, TO, and ADJ. MARK-MARK,
    then no editing is required.  Those abbreviated designations
    that are out of alignment will be markedly so, because
    correct naming is 10 characters, where uncorrected naming
    is 30 characters.

    A partial list of baselines that will require editing follows.
    This list is not complete, intended for example only.

    STATE      BASELINE DESIGNATION

    CA         NATOMAS LEVEE
    CA         NATOMAS LEVEE TWO
    CA         ONTARIO
    CA         REDDING
    FL         FORT LAUDERDALE
    FL         PENSACOLA
    ME         ROCKLAND
    NY         HEMPSTEAD