|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| .github/ | H | 10-Oct-2021 | - | 434 | 368 |
| .travis/ | H | 10-Oct-2021 | - | 102 | 83 |
| db/ | H | 03-May-2022 | - | 13,259 | 8,680 |
| demolocation/ | H | 10-Oct-2021 | - | 157 | 133 |
| display/ | H | 03-May-2022 | - | 22,093 | 16,488 |
| doc/ | H | 03-May-2022 | - | 3,063 | 2,130 |
| docker/ | H | 10-Oct-2021 | - | 1,201 | 1,011 |
| general/ | H | 10-Oct-2021 | - | 11,687 | 8,484 |
| gui/ | H | 10-Oct-2021 | - | 161,069 | 126,569 |
| imagery/ | H | 03-May-2022 | - | 84,215 | 67,550 |
| include/ | H | 10-Oct-2021 | - | 32,151 | 22,292 |
| lib/ | H | 03-May-2022 | - | 404,305 | 268,121 |
| locale/ | H | 03-May-2022 | - | 2,591,644 | 2,055,844 |
| macosx/ | H | 10-Oct-2021 | - | 2,502 | 2,037 |
| man/ | H | 07-May-2022 | - | 3,298 | 2,292 |
| misc/ | H | 10-Oct-2021 | - | 4,094 | 2,920 |
| mswindows/ | H | 03-May-2022 | - | 4,890 | 3,736 |
| ps/ | H | 10-Oct-2021 | - | 11,650 | 8,654 |
| raster/ | H | 03-May-2022 | - | 166,866 | 119,356 |
| raster3d/ | H | 03-May-2022 | - | 51,646 | 41,792 |
| rpm/ | H | 03-May-2022 | - | 806 | 613 |
| scripts/ | H | 10-Oct-2021 | - | 26,674 | 16,985 |
| singularity/debian/ | H | 10-Oct-2021 | - | 192 | 168 |
| temporal/ | H | 03-May-2022 | - | 19,788 | 11,573 |
| testsuite/ | H | 10-Oct-2021 | - | 436 | 245 |
| tools/ | H | 03-May-2022 | - | 3,457 | 2,425 |
| vector/ | H | 03-May-2022 | - | 103,360 | 75,914 |
| visualization/ | H | 10-Oct-2021 | - | 644 | 471 |
| .dockerignore | H A D | 10-Oct-2021 | 352 | 16 | 14 |
| .gitignore | H A D | 10-Oct-2021 | 943 | 43 | 41 |
| .travis.yml | H A D | 10-Oct-2021 | 962 | 49 | 38 |
| AUTHORS | H A D | 10-Oct-2021 | 16.6 KiB | 416 | 326 |
| CHANGES | H A D | 10-Oct-2021 | 1.3 KiB | 28 | 21 |
| CITING | H A D | 10-Oct-2021 | 1.6 KiB | 42 | 32 |
| CONTRIBUTING.md | H A D | 10-Oct-2021 | 4.9 KiB | 199 | 137 |
| COPYING | H A D | 10-Oct-2021 | 1.4 KiB | 40 | 31 |
| Dockerfile | H A D | 10-Oct-2021 | 3.3 KiB | 141 | 121 |
| INSTALL | H A D | 10-Oct-2021 | 9.1 KiB | 319 | 210 |
| Makefile | H A D | 03-May-2022 | 3.3 KiB | 124 | 84 |
| NEWS | H A D | 10-Oct-2021 | 487 | 16 | 11 |
| README.md | H A D | 10-Oct-2021 | 3.3 KiB | 111 | 78 |
| SUBMITTING | H A D | 10-Oct-2021 | 68 | 2 | 1 |
| TODO | H A D | 10-Oct-2021 | 1.4 KiB | 44 | 33 |
| Vagrantfile | H A D | 10-Oct-2021 | 3.3 KiB | 115 | 96 |
| aclocal.m4 | H A D | 03-May-2022 | 25.5 KiB | 825 | 740 |
| binaryInstall.src | H A D | 10-Oct-2021 | 9.8 KiB | 349 | 233 |
| config.guess | H A D | 10-Oct-2021 | 48.2 KiB | 1,749 | 1,522 |
| config.sub | H A D | 10-Oct-2021 | 34.4 KiB | 1,885 | 1,698 |
| configure | H A D | 03-May-2022 | 420.6 KiB | 16,770 | 12,688 |
| configure.ac | H A D | 10-Oct-2021 | 47.7 KiB | 2,044 | 1,518 |
| contributors.csv | H A D | 10-Oct-2021 | 4 KiB | 67 | 66 |
| contributors_extra.csv | H A D | 10-Oct-2021 | 2.7 KiB | 60 | 59 |
| grass.pc.in | H A D | 10-Oct-2021 | 930 | 15 | 12 |
| grasslib.dox | H A D | 10-Oct-2021 | 13.8 KiB | 375 | 281 |
| install-sh | H A D | 10-Oct-2021 | 13.3 KiB | 521 | 344 |
| translators.csv | H A D | 10-Oct-2021 | 5.6 KiB | 148 | 147 |
README.md
1[![Build Status](https://travis-ci.com/OSGeo/grass.svg?branch=master)](https://travis-ci.com/OSGeo/grass)
2
3# GRASS GIS Repository
4
5## Description
6
7GRASS GIS ([https://grass.osgeo.org/](https://grass.osgeo.org/)) is
8a Geographic Information System used for geospatial data management and
9analysis, image processing, graphics/map production, spatial modeling, and
10visualization.
11
12## How to get write access here
13
14In general: you don't really need write access as you can simply open
15a [pull request](https://github.com/OSGeo/grass/pulls) to contribute to
16GRASS GIS. See [CONTRIBUTING file](CONTRIBUTING.md) for more details.
17
18Want to become a core developer? See
19[Procedure for gaining Git write access](https://trac.osgeo.org/grass/wiki/HowToContribute#WriteaccesstotheGRASScorerepository)
20
21## How to compile GRASS
22
23> See INSTALL file.
24
25Yes, you should really read [INSTALL](INSTALL). In addition, there are detailed [compile instructions](https://grasswiki.osgeo.org/wiki/Compile_and_Install) in the Wiki.
26
27## Docker
28
29Build a docker image using the downloaded source code (run this in the directory
30containing the source code):
31
32```
33docker build -t grassgis78 .
34```
35
36A test run (assuming you have the existing GRASS GIS test location; it can be
37downloaded from
38[here](https://grass.osgeo.org/sampledata/north_carolina/nc_basic_spm_grass7.zip))
39
40```
41# case 1: launching in the grassdata directory in which the location is stored:
42docker run -it --rm --user=$(id -u):$(id -g) --volume $(pwd):/data \
43 --env HOME=/data/ grassgis78 grass --text nc_basic_spm_grass7/user1 \
44 --exec g.region -p
45
46# case 2: launching anywhere
47docker run -it --rm --user=$(id -u):$(id -g) \
48 --volume /your/test/grassdata/:/data --env HOME=/data/ grassgis78 \
49 grass /data/nc_basic_spm_grass7/PERMANENT --exec g.region -p
50```
51
52Note that the first `grassgis78` is the name of the image while the second
53`grass` is the name of the executable.
54
55To run the tests (again assuming local location):
56
57```
58docker run -it --rm --user=$(id -u):$(id -g) \
59 --volume /your/test/grassdata/:/data --env HOME=/data/ -w /code/grass \
60 grassgis78 grass /data/nc_basic_spm_grass7/PERMANENT --exec \
61 python -m grass.gunittest.main \
62 --location nc_basic_spm_grass7 --location-type nc
63```
64
65Note: If you compiled locally before building the Docker image, you may
66encounter problems as the local configuration and locally compiled file
67are copied to and used in the Docker image. To make sure you don't have
68this issue, clean all the compiled files from the source code:
69
70```
71make distclean
72```
73
74## How to generate the 'Programmer's Manual'
75
76You can generate locally the [GRASS GIS Programmer's Manual](https://grass.osgeo.org/programming7/).
77
78This needs doxygen (<http://www.doxygen.org>) and optionally
79Graphviz dot (<http://www.research.att.com/sw/tools/graphviz/>).
80
81To build the GRASS programmer's documentation, run
82
83```
84make htmldocs
85```
86
87or to generate documentation as single html file
88(recommended for simple reading)
89
90```
91make htmldocs-single
92```
93
94here. This takes quite some time. The result is in `lib/html/index.html`
95which refers to further document repositories in
96
97```
98lib/vector/html/index.html
99lib/db/html/index.html
100lib/gis/html/index.html
101```
102
103The master file is: `./grasslib.dox` where all sub-documents have to
104be linked into.
105
106To generate the documents in PDF format, run
107
108```
109make pdfdocs
110```
111