NAME

m.in.e00 - Read an ESRI e00 file
(GRASS Vector/Raster/Sites Data Import Program)

SYNOPSIS

m.in.e00
m.in.e00 help
m.in.e00 [-s] input=name [mapset=name] [action=what to do] [verbose=debug level] [logfile=name]

DESCRIPTION

The m.in.e00 program is designed to import ESRI Arc/Info e00 ascii archives. The input file may be a compressed e00 file : m.in.e00 will automatically recognize the format.

The module not only can analyse the content of an Arc/Info file, but try to create the objects described (geometry and attributes).

m.in.e00 will be run non-interactively if the user specifies program arguments on the command line, using the form:

m.in.e00 [-s] input=name [mapset=name] [action=what to do] [verbose=debug level] [logfile=name]

Alternately, the user can simply type:

m.in.e00

on the command line without program arguments. In this case, the user will be prompted for parameter values using the standard GRASS user interface described in the manual entry for parser.

FEATURES

m.in.e00 attemps to retrieve all information in an Arc/Info export file (.e00): points, line, polygon, and grid coverage. The attribute of each "vector" object (points, line, and polygon) is the Arc/Info coverage-ID (and not the coverage-#).

GRASS files created have the name extracted from the first line of the e00 file, i.e. the name of the coverage. The file is read from the current directory unless specified differently.

The following rules are used : A line vector file is created when there is a non-empty ARC section, and neither PAL (Polygon Attribute Label) section, neither PAT (Point/Polygon Attribute Table) table in INFO section. Otherwise a polygon vector file is created, excepted when the ARC section is empty or doesn't exist, in which case a site file is created.

Dig_cats files are created if the PAT or AAT (Arc Attribute Table) tables have more attributes than the standard one. If there is one extra attribute, the dig_cats file has the name of the vector (dig) file created. If there is more than one extra attribute, the dig_cats files have names of the form cover_name.attribute_name. If you want to use one of them, you must rename it so it matches the name of the vector file. Doing this, v.to.rast will use it for the raster file created.

OPTIONS

m.in.e00 requires the user to enter the following information:

Flags:

-i
Use the "feature-ID" of the arc info objects to link geometry and attribute's tables. The default is to use the "feature-#" field (which is an internal link, but you should not rely on it for linking Arc/Info objects to an external database. (GRASS 5.0 option)
-d
Use a database instead of as many dig_cats files as you have attributes in the INFO tables (not yet operational). (GRASS 5.0 option)

Parameters:

mapset=name
For creating a new mapset for the data imported. This may be useful, since we cannot create a projection info file and a default window in an existing mapset. When a file is imported in the current mapset, you should take care that they are in the same projection. Unfortunately, you may run in trouble after that when using g.region (Cf BUGS).
action=what to do
Five options: analyse, raster, lines, vector and all. By default, all is used and everything (grid, points, lines, polygons) is imported. Analyze produces no files, but only a log output (level 5) on stderr, and is useful to see whether the e00 file is clean or not. Raster imports only grid section. Lines imports only the geometry (no label are attached to the lines or polygons) of a point/line/polygon coverage. Vector imports a point/line/polygon coverage with their attributes.
verbose=debug level
Number between 0 (no trace of what's happening) and 9 (very verbose log).
logfile=name
Name of file where log info will be written. By default log info are directed to stderr.

BUGS AND CAVEAT

You must know what to do with all the dig_cats file generated when importing a vector coverage.

No attribute (cats) file is produced when importing a grid.

The program may crash when unexpexted data (mainly in INFO section) are found, or when the input file is corrupted.

There is no support for projection. Using verbose=1 lets you see the parameters of the e00 file, but you must create the DEFAULT_WIND and the PROJ file yourself.

New mapset are always created with proj=0 zone=99. If the default proj and zone are not the same, g.region complains and d.vect or d.rast refuse to display your data. The only thing to do is to import in the current mapset.

NOTES

SEE ALSO

g.mapsets, g.region, g.setproj, v.support, v.to.rast, v.in.shape

AUTHOR

Michel J. Wurtz, DIG/cemagref
mw@teledetection.fr