GRASS GIS manual: v.in.gama

NAME

v.in.gama - Converts GNU GaMa XML output file to a GRASS vector map layer.

KEYWORDS

SYNOPSIS

v.in.gama
v.in.gama help
v.in.gama [-t] input=name output=name [--overwrite] [--verbose] [--quiet]

Flags:

-t: Do not create attribute table
--overwrite: Allow output files to overwrite existing files
--verbose: Verbose module output
--quiet: Quiet module output

Parameters:

input=name: GNU GaMa XML output file to be converted to binary vector file, if not given reads from standard input
output=name: Name for output vector map

DESCRIPTION

v.in.gama creates a GRASS vector map layer based on GNU GaMa XML output file. This file (which contains adjustment results of geodetic network) can be created by gama-local tool.

EXAMPLE

First, we adjust geodetic network by gama-local tool. The adjustment results are saved also in XML data format.

gama-local --xmlout network.xml network.gkf

Afterwards we create a map layer network by the module v.in.gama:

v.in.gama input=network.xml output=network

This map layer contains two different layers. Layer 1 is connected with attribute table 'network_point', layer 2 with 'network_obs'. In the first layer are stored points of geodetic network. Layer 2 contains observation data (in geometry way lines and points).

NOTES

GNU Gama is a project dedicated to adjustment of geodetic networks. GNU Gama is released under GNU General Public Licence. For parsing XML documents GNU Gama calls expat parser written by James Clark.

GNU Gama currently contains two main development branches. Stable branch of the project is limited to network adjustment in a local coordinate system (program gama-local). In the unstable development branch the adjustment model is based on geocentric coordinate system (program gama-g3).

The development version of the program gama-local enables to save adjustment results besides of the standard text format also in newly designed XML output data format. This feature is fundamental for GRASS module v.in.gama. Currently it is possible to use v.in.gama only in connection with gama-local from unstable development branch.

REFERENCES

GNU Gama adjustment of geodetic networks

AUTHOR

Martin Landa, CTU in Prague, Czech Republic

Last changed: $Date$

Main index - vector index - Full index