index.rst 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. .. PyGrass documentation master file, created by
  2. sphinx-quickstart2 on Sat Jun 16 18:53:32 2012.
  3. You can adapt this file completely to your liking, but it should at least
  4. contain the root `toctree` directive.
  5. PyGRASS documentation
  6. ===================================
  7. Python is a programming language which is more powerful than shell scripting but easier and more forgiving than C. ``PyGRASS`` is an object-oriented Python Application Programming Interface (API) for GRASS GIS. ``PyGRASS`` offers interfaces to GRASS modules and functionality, as well as to vector and raster data. For details, see Zambelli et al. (2013) in the references below. ``PyGRASS`` improves the integration between GRASS GIS and Python, making the use of Python under GRASS more consistent with the language itself. Furthermore, it simplifies GRASS scripting and programming and more natural for the user.
  8. Background: In 2006, GRASS GIS developers started to adopt Python for the new GUI. Due to this Python became more and more important and developers converted all shell scripts from GRASS GIS 6 to Python for GRASS GIS 7.
  9. To work with ``PyGRASS`` you need an up-to-date version of GRASS GIS 7. The only action before starting to work with ``PyGRASS`` is to launch GRASS GIS 7 and from the console launch ``python`` or ``ipython`` (the second one is the recommended way).
  10. Contents:
  11. .. toctree::
  12. :maxdepth: 2
  13. intro
  14. gis
  15. raster
  16. raster_elements
  17. vector
  18. vector_attributes
  19. vector_features
  20. vector_utils
  21. modules
  22. modules_grid
  23. messages
  24. References
  25. ============
  26. * 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(1):201-219. `doi:10.3390/ijgi2010201 <http://dx.doi.org/10.3390/ijgi2010201>`_
  27. * `Python related articles in the GRASS GIS Wiki <http://grasswiki.osgeo.org/wiki/Category:Python>`_
  28. This project has been funded with support from the `Google Summer of Code 2012 <http://trac.osgeo.org/grass/wiki/GSoC#PythonhighlevelmapinteractionforGRASSGIS>`_
  29. ..
  30. Indices and tables
  31. ==================
  32. * :ref:`genindex`
  33. * :ref:`modindex`
  34. * :ref:`search`