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.
#% keyword: vector
#% keyword: sampling
#% keyword: database
#% keyword: position
#% keyword: querying
#% keyword: 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['query_map'],
                          column=options['column'],
                          to_column=options['query_column'],
                          upload='to_attr',
                          dmax=options['dmax'],
                          from_layer=options['layer'],
                          to_layer=options['query_layer'])
    except CalledModuleError:
        return 1
    else:
        return 0


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