Skip to content
GRASS GIS Core Repository
Branch: master
Clone or download
Latest commit 278501c Jun 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github added .github/FUNDING.yml May 25, 2019
.travis Travis-CI: enable ccache for faster builds May 21, 2019
db sqlite driver: Use the same spacing as postgres Jan 30, 2019
demolocation GRASS_DB_ENCODING is environmental variable Mar 30, 2015
display Changed the source code links in HTML manual pages to point to the gi… Jun 15, 2019
doc added missing architecture drawing Jun 15, 2019
general GRASS_VERSION_SVN -> GRASS_VERSION_GIT + update g.version May 19, 2019
gui Merge pull request #9 from landam/g_version_git May 30, 2019
imagery i.vi: fix test May 16, 2019
include Merge pull request #9 from landam/g_version_git May 30, 2019
lib Py2/Py3 compat: Use "gettext.install(..., unicode=True)" in Python 2. May 31, 2019
locale i18N: sync from Transifex Jun 2, 2019
macosx macosx: update mentioned GRASS version Jun 3, 2014
man Happy New Year Jan 1, 2019
misc m.nviz.script: fix memory leaks Apr 2, 2019
mswindows grass.bat: reorder statements, see https://trac.osgeo.org/grass/ticke… Jan 28, 2019
ps
raster r.slope.aspect fix #3860 Jun 11, 2019
raster3d
rpm Fedora grass.spec: automagic byte compilation activated, see https://… Nov 15, 2018
scripts Changed the source code links in HTML manual pages to point to the gi… Jun 15, 2019
temporal fix tests for Python 3 May 17, 2019
testsuite testsuite: comment out non-existing 'other_location' (fixes https://t… May 5, 2019
tools Changed the source code links in HTML manual pages to point to the gi… Jun 15, 2019
vector Changed the source code links in HTML manual pages to point to the gi… Jun 15, 2019
visualization Remove wximgview Oct 12, 2015
.gitignore gitignore: testsuite/examples/testreports/ added (fixes https://trac.… Mar 26, 2019
.travis.yml Travis-CI: enable ccache for faster builds May 21, 2019
AUTHORS Numerous typos fixed (identified with tools/fix_typos.sh) Nov 13, 2016
CHANGES CHANGES: links to release pages added Oct 27, 2016
CITING cite: placeholder for version number Jun 29, 2018
COPYING Fixed missing street in MN address Aug 16, 2016
Dockerfile python-six: added as a new dependency May 5, 2019
GPL.TXT welcome to GRASS 7.0.svn Apr 27, 2008
INSTALL Happy New Year Jan 1, 2019
Makefile GRASS_VERSION_SVN -> GRASS_VERSION_GIT + update g.version May 19, 2019
NEWS NEWS: added Sep 4, 2016
README.md Draft intro added May 23, 2019
REQUIREMENTS.html python-six: added as a new dependency May 5, 2019
SUBMITTING SUBMITTING files moved to Trac http://trac.osgeo.org/grass/wiki/Submi… Jun 27, 2014
TODO unused i.points + i.vpoints removed: replaced by g.gui.gcp Nov 2, 2014
Vagrantfile vagrafile: switch to bionic Sep 8, 2018
aclocal.m4 aclocal.m4: add support for w64-ming32 builds Dec 10, 2015
binaryInstall.src binaryInstall.src: nad2bin no longer used (completes https://trac.osg… Mar 7, 2019
config.guess config.guess + config.sub: updated from http://git.savannah.gnu.org/c… Dec 26, 2018
config.sub config.guess + config.sub: updated from http://git.savannah.gnu.org/c… Dec 26, 2018
configure GRASS_VERSION_SVN -> GRASS_VERSION_GIT + update g.version May 19, 2019
configure.in GRASS_VERSION_SVN -> GRASS_VERSION_GIT + update g.version May 19, 2019
contributors.csv contributors.csv: email updated May 21, 2019
contributors_extra.csv contributors_extra.csv: Nikos Alexandris added Mar 17, 2017
grass.pc.in pkg-config file: update Nov 17, 2014
grasslib.dox Changed the source code links in HTML manual pages to point to the gi… Jun 15, 2019
install-sh install-sh: updated to newer version (source: https://svn.met.no/view… Jun 10, 2013
translators.csv translators.csv: email update (test for grass-commit ML notification) May 21, 2019

README.md

Build Status

GRASS GIS Repository

GRASS GIS (https://grass.osgeo.org/) is a Geographic Information System used for geospatial data management and analysis, image processing, graphics/map production, spatial modeling, and visualization.

How to get write access here?

In general: you don't really need write access as you can simply open a pull request to contribute to GRASS GIS.

Want to become a core developer? See Procedure for gaining Git write access

How to compile GRASS?

See INSTALL file.

Yes, you should really read INSTALL.

How to generate the 'Programmer's Manual'?

This needs doxygen (http://www.doxygen.org) and optionally Graphviz dot (http://www.research.att.com/sw/tools/graphviz/).

To build the GRASS programmer's documentation, run

make htmldocs

or to generate documentation as single html file (recommended for simple reading)

make htmldocs-single

here. This takes quite some time. The result is in lib/html/index.html which refers to further document repositories in

   lib/vector/html/index.html
   lib/db/html/index.html
   lib/gis/html/index.html

The master file is: ./grasslib.dox where all sub-documents have to be linked into.

To generate the documents in PDF format, run

make pdfdocs

An online version is available here

Docker

Build using the downloaded source code (in the directory with the source code):

    docker build -t grassgis77 .

A test run (assuming you have existing GRASS GIS location; it can be downloaded from here)

# case 1: launching in the grassdata directory in which the location is stored:
docker run -it --rm --user=$(id -u):$(id -g) --volume $(pwd):/data --env HOME=/data/ grassgis77 \
    grass --text nc_spm_08_grass7/user1 --exec g.region -p

# case 2: launching anywhere
docker run -it --rm --user=$(id -u):$(id -g) --volume /your/test/grassdata/:/data --env HOME=/data/ grassgis77 \
    grass /data/nc_basic_spm/PERMANENT --exec g.region -p

Note that the first grassgis77 is the name of the image while the second grass is the name of the executable.

To run the tests (again assuming local location):

    docker run -it --rm --user=$(id -u):$(id -g) --volume /your/test/grassdata/:/data --env HOME=/data/ -w /code/grass \
        grassgis77 grass /data/nc_basic_spm/PERMANENT --exec \
            python -m grass.gunittest.main \
                --location nc_basic_spm --location-type nc

Note: If you compiled locally before building the Docker image, you may encounter problems as the local configuration and locally compiled file are copied to and used in the Docker image. To make sure you don't have this issue, clean all the compiled files from the source code:

make distclean
You can’t perform that action at this time.