DESCRIPTION

g.proj provides a means of manipulating GRASS projection information files. If compiled without OGR present, the functionality is limited to reporting the projection information for the current location, either in conventional GRASS (-p flag) or PROJ.4 (-j flag) format, and verifying the datum transformation information in the location (-d flag).

When compiled with OGR, functionality is increased and allows output of the projection information in the Well-Known Text (WKT) format popularised by proprietary GIS.

If one of the parameters georef, wkt or proj4 is specified, rather than the projection information being read from the current location it is imported from an external source as follows:

georef=filename

g.proj attempts to invoke GDAL and OGR in turn to read a georeferenced file filename. The projection information will be read from this file. If the file is not georeferenced or cannot be read, XY (unprojected) will be used.

wkt=filename or -

The file filename should contain a projection description in WKT format with no line-breaks (e.g. a '.prj' file). If - is given for the filename, the WKT description will be read from stdin rather than a file.

proj4=description or -

description should be a projection description in PROJ.4 format, enclosed in quotation marks if there are any spaces. If - is given for description, the PROJ.4 description will be read from stdin rather than as a directly-supplied command-line parameter.

The -p, -j, -w, etc. flags are all functional when importing projection information from an external source, meaning that g.proj can be used to convert between representations of the information.

In addition, if the -c flag is specified, g.proj will create new GRASS projection files (PROJ_INFO, PROJ_UNITS, WIND and DEFAULT_WIND) based on the imported information. If the location parameter is specified in addition to -c, then a new location will be created. Otherwise the projection information files in the current location will be overwritten. The program will warn before doing this.

If compiled without OGR, the -c flag and location parameter will still be operational. However, since projection information cannot be read from an external source in this case, their use will be limited to creating a new location with the same co-ordinate system as the current one (or overwriting the projection files in the current location with identical copies).

NOTES

GRASS uses a local copy of the GDAL CSV co-ordinate system and datum information files, stored in the directory $(GISBASE)/etc/ogr_csv . This allows many possible ways of initializing a co-ordinate system, such as EPSG codes etc.

EXAMPLES

REFERENCES

SEE ALSO

AUTHOR

Last changed: $Date$