GRASS GIS Python library documentation

Python, a widely used general-purpose, high-level programming language provides a powerful scripting interface. Being easy-to-use yet powerful, it enables users to efficiently exploit the capabilities of the GRASS GIS software. Python scripts for GRASS GIS can be written at high level (GRASS GIS modules) as well as at low level (GRASS GIS libraries) through a dedicated interface. The graphical user interface and the GRASS GIS Temporal Framework are entirely written in Python.

A set of packages is provided to the user in order to provide functionality at various levels:

• script package provides Python interface to launch GRASS GIS modules in scripts
• PyGRASS is an object-oriented Python Application Programming Interface (API) for GRASS GIS which uses the GRASS C API as backend but additionally offers a convenient interface to the GRASS GIS modules
• GRASS GIS Temporal Framework implements the temporal GIS functionality of GRASS GIS and provides an API to implement spatio-temporal processing modules
• Testing GRASS GIS source code and modules using gunittest package
• exceptions package contains exceptions used by other packages
• imaging package is a library to create animated images and films
• pydispatch package is a library for signal-dispatching

Contents:

• GRASS GIS Python scripting with script package
  • Parts of the API
    • script package
  • Syntax
  • Combining multiple modules
  • Processing many maps
  • Providing GRASS module interface to a script
• PyGRASS documentation
  • GRASS database management
  • Region management
  • Introduction to Raster classes
    • RasterRow
    • RasterRowIO
    • RasterSegment
  • Introduction to Vector classes
    • Vector
    • VectorTopo
    • Working with Vector Maps
    • More Features of the VectorTopo Class
    • Accessing Attribute Tables
    • Geometry Classes
    • More Examples
  • Interface to GRASS GIS modules
    • Launching GRASS GIS modules in parallel
  • PyGRASS message interface
  • pygrass package
    • Subpackages
    • Submodules
    • pygrass.errors module
    • pygrass.orderdict module
    • pygrass.utils module
    • Module contents
  • References
• GRASS GIS Temporal Framework
  • Introduction
  • Temporal API
    • Low level API
    • High level API
    • Shared Module functionality
  • Examples
    • Howto start example
    • Creation of a space time dataset
    • Temporal shifting
  • References
• exceptions package
  • Module contents
• imaging package
  • Submodules
  • imaging.images2avi module
  • imaging.images2gif module
  • imaging.images2ims module
  • imaging.images2swf module
  • Module contents
• Testing GRASS GIS source code and modules
  • Introduction
  • Basic example
  • Building blocks and terminology
  • Testing with gunittest package in general
  • Tests of GRASS modules
  • Tests of C and C++ code
  • Tests of Python code
  • Testing Python code with doctest
  • Tests as general scripts
  • Data
  • Data specific to one test
  • Tests creating separate Mapsets, Locations and GRASS Databases
  • Analyzing quality of source code
  • Further reading
    • gunittest package
    • Running the test framework of GRASS GIS
• pydispatch package
  • Submodules
  • pydispatch.dispatcher module
  • pydispatch.errors module
  • pydispatch.robust module
  • pydispatch.robustapply module
  • pydispatch.saferef module
  • pydispatch.signal module
  • Module contents