Geografic-Information-System/scripts/v.what.vect/v.what.vect.py

#!/usr/bin/env python
#
############################################################################
#
# MODULE:       v.what.vect
# AUTHOR(S):    Markus Neteler, converted to Python by Glynn Clements
# PURPOSE:      Uploads attributes at the location of vector points to the table.
# COPYRIGHT:    (C) 2005, 2008, 2011 by the GRASS Development Team
#
#               This program is free software under the GNU General Public
#               License (>=v2). Read the file COPYING that comes with GRASS
#               for details.
#
#############################################################################

#%module
#% description: Uploads vector values at positions of vector points to the table.
#% keywords: vector
#% keywords: sampling
#% keywords: database
#% keywords: position
#% keywords: querying
#% keywords: attribute table
#%end

#%option G_OPT_V_MAP
#% label: Name of vector points map for which to edit attributes
#%end
#%option G_OPT_V_FIELD
#%end
#%option G_OPT_DB_COLUMN
#% description: Name of attribute column to be updated with the query result
#% required: yes
#%end
#%option G_OPT_V_MAP
#% key: query_map
#% label: Name of vector map to be queried
#% required : yes
#%end
#%option G_OPT_V_FIELD
#% key: query_layer
#%end
#%option G_OPT_DB_COLUMN
#% key: query_column
#% description: Name of attribute column to be queried
#% required: yes
#%end
#%option
#% key: dmax
#% type: double
#% description: Maximum query distance in map units
#% answer: 0.0
#% required: no
#%end

import sys
from grass.script import core as grass
from grass.exceptions import CalledModuleError


def main():
    try:
        grass.run_command('v.distance',
                          from_=options['map'],
                          to=options['qmap'],
                          column=options['column'],
                          to_column=options['qcolumn'],
                          upload='to_attr',
                          dmax=options['dmax'],
                          from_layer=options['layer'],
                          to_layer=options['qlayer'])
    except CalledModuleError:
        return 1
    else:
        return 0


if __name__ == "__main__":
    options, flags = grass.parser()
    sys.exit(main())