Python/pygrass

pygrass is a library that extends the GRASS capabilities to allow users to access the low-level GRASS API.

Workshops

XIV Italian meeting of GRASS and GFOSS users

Two workshops were presented during the XIV Italian meeting of GRASS at Genova. The workshops use ipython notebook to show the python and pygrass API, all the material are available on github (python, pygrass). All the execute examples are reported here:

• python
  • Data Types
  • Syntax
  • Function
  • Class
  • Other

• pygrass
  • Modules
  • GIS
  • Vector
  • Raster

How to test library

pygrass has doctest inside its code. You can run doctest inside the North Carolina basic location, using the mapset user1.

To test the single module (file) you have to move to the source code of pygrass and run the following code (this is an example of functions.py):

 python -m doctest functions.py

Already tested modules

Working

• functions.py
• gis/region.py
• gis/__init__.py
• modules/__init.py
• vector/abstract.py
• vector/__init__.py
• vector/basic.py
• vector/table.py
• vector/geometry.py
• raster/abstract.py

Not working

• ...

References

• Zambelli, P., Gebbert, S., Ciolli, M., 2013. Pygrass: An Object Oriented Python Application Programming Interface (API) for Geographic Resources Analysis Support System (GRASS) Geographic Information System (GIS). ISPRS International Journal of Geo-Information 2, 201–219. (DOI | PDF)