CONVERT CFF FILES INTO ARC/INFO COVERAGES

QUICK USAGE:   &r cff_start

Installation and Startup Instructions:

Within the following instructions, specific examples are provided only as
a guide, and appear at the right margin:

Change to the installation directory    Ex:                 cd /usr/opt
Unpack the CFF to ARC/DLG convertor           tar -xvof cff2arc_dlg.tar
Change to the working (data) directory                cd /home/usr/data
Start up ARC/INFO 7.0 or higher                   $ARCHOME/programs/arc
Set &amlpath                                          &amlpath /usr/opt
Run the startup aml                                        &r cff_start
Complete the menu                           
The following explains in detail the menu options:

*** NOTE: The CFF files MUST already reside in the quad's workspace  ***
***       in order for this program to execute correctly.            ***

Information entered into this form menu will be used to create the system
files prefix.par, prefix.lis, prefix.cat, and prefix.hout from CFF data.
The executed program will create these system files in the workspace based
on the information you give in the menu.

More detailed information on CFF conversion comes after the menu instructions.

INSTRUCTIONS for COMPLETING the MENU

1.  Enter quad prefix:
      The QUAD PREFIX is a maximum of 6 characters specified by the user.
      Each coverage created will be named with this prefix followed by
      a two character abbreviation for the category.
      For example, if you specify a prefix of wow, the coverages will be
      named wowhy for hydrography, wowrd for roads, wowrr for railroads, etc.

2.  Enter quad name:
      The QUAD NAME is the name appearing on the published map:
      for example, RED CLOUD WEST, WY

3.  Enter CFF file name:
      The CFF file name is the prefix before the ".l", ".p", and ".f"
      filename extension.  The CFF files must reside in the workspace.
      This name can be entered with or without an extension, because the
      extension is ignored: for example, 580013520001 or 580013520001.p

4.  Horizontal Datum:
       Only NAD27 CFF file format for the horizontal datum is allowed.
       As of 6/20/95, all CFF files are NAD27.

5.  Enter the SE latitude(Degrees):  for example, 40
6.  Enter the SE latitude(Minutes):  for example, 22
7. Enter the SE latitude(Seconds):  for example, 30

8. Enter the SE longitude(Degrees):  for example, -111
9. Enter the SE longitude(Minutes):  for example, 30
10. Enter the SE longitude(Seconds):  for example, 0

11. Latitude dim (DDMMSS): Key in the size of the quadrangle in the Y
       direction.  Use the format; degrees,minutes, seconds (ddmmss).
       For example, 001500

12. Longitude dim (DDMMSS): Key in the size of the quadrangle in the X
       direction.  Use the format; degrees,minutes, seconds (ddmmss).
       For example, 002000

13. Enter the revision date:
       The REVISION DATE is usually the date of photography:  for example, 1993

14. Contour Interval:
       Enter the contour interval in the native units: for example, if
       it is 20 feet, then enter 20

15. Scale:
       Choose either 1:24000-scale or 1:63360-scale

After all the information has been entered, select the EXECUTE button which
will run the programs that create the quad.par, quad.lis, quad.cat, and
quad.hout files, as well as the ARC coverages.

The CANCEL button will allow you to quit this menu before or after you have
created anything.  You will be returned to the main menu.

********************************************************************************
  ADDITIONAL INFORMATION ABOUT CARTOGRAPHIC FEATURE FILE TO DIGITAL LINE GRAPH
                      ARC/INFO COVERAGE CONVERTER
********************************************************************************

The Cartographic Feature File (CFF) to Digital Line Graph (DLG) converter
is a suite of ARC/INFO Arc Macro Language (AML) routines and C programming
executables that will convert Forest Service CFF attribute codes
to Geological Survey DLG-3 attribute codes.  The ARC/INFO AMLs are written
for Unix ARC/INFO version 7.0.2.  The C programming executables are written
for the Unix Green Hills Compiler.  The software package is called CFFDLG.
The executables reside under the RevPG software's "programs_dgux" directory,
and the source code files reside under the software's rpg_source/dgux/source
directory.

CFFDLG.AML calls the needed C program executables and various ARC/INFO AMLs.
The software package divides the CFF files of digital data into the appropriate
DLG categories, and converts the CFF attribute values to DLG attribute values.
A neatline is generated, along with a yshift to accommodate the USGS RevPG
production software.  An attempt is made to translate CFF line attribute codes
to DLG area features.  Due to the many differences between the Forest Service
and the Geological Survey digitizing standards, the system isn't fully automatic.
The CFF converter also accesses two INFO lookup tables, LCFFDLG.DF and
ACFFDLG.DF, which are used to convert CFF attribute values to DLG attribute
values, based on the Single Edition one map concept, agreed upon by the Forest
Service and the Geological Survey.  For the standalone version, these info
files are located in a sub-directory under the amls called info.

The Forest Service CFF data files must be in ARC generate format, UTM
coordinates, with the spatial values to a tenth of a meter or whole meter
precision.  CFF data in ARC generate format for a quad consists of three
files.  The file with the .l extension has the spatial line coordinates ,
the file with the .p extension has the spatial point coordinates, and the
file with the .f extension has the CFF feature codes, linked to the CFF
spatial features.

The outputs of the CFFDLG conversion package are ARC/INFO coverages in the
workspace.  The feature attribute tables for the coverages
include the AAT, NAT, and PAT files.  For some DLG categories, there may be an
additional degenerate line (point) coverage.  A point coverage will have the
same name as the poly coverage, except an additional "x" is added at the end of
the name.  The output coverage names include the quadrangle (6 letter maximum
prefix) name and a two-digit DLG overlay abbreviation.  The following
categories are supported:

bd   boundaries
hp   hypsography (normally only point data, without any contours)
hy   hydrography
ms   manmade structures
mt   miscellaneous transportation
nv   non-vegetative cover
pl   Public Land Survey System
rd   roads and trails
rr   railroads
sc   vegetative surface cover
sm   survey markers

KNOWN PROBLEMS: Some areas will not be attributed correctly. Depending on area
   of the country, 20 to 60 percent will not be attributed correctly.
   The .hout files, which could potentially be used to create DLGs from the ARC
   coverages, are incorrect for 1:63360- scale (ALASKA) quads.