Markus Neteler
428521e58f
change Python shebang to python3 (#82)
|
vor 6 Jahren | |
|---|---|---|
| .github | vor 6 Jahren | |
| .travis | vor 6 Jahren | |
| db | vor 6 Jahren | |
| demolocation | vor 10 Jahren | |
| display | vor 6 Jahren | |
| doc | vor 6 Jahren | |
| docker | vor 6 Jahren | |
| general | vor 6 Jahren | |
| gui | vor 6 Jahren | |
| imagery | vor 6 Jahren | |
| include | vor 6 Jahren | |
| lib | vor 6 Jahren | |
| locale | vor 6 Jahren | |
| macosx | vor 11 Jahren | |
| man | vor 6 Jahren | |
| misc | vor 6 Jahren | |
| mswindows | vor 6 Jahren | |
| ps | vor 6 Jahren | |
| raster | vor 6 Jahren | |
| raster3d | vor 6 Jahren | |
| rpm | vor 6 Jahren | |
| scripts | vor 6 Jahren | |
| temporal | vor 6 Jahren | |
| testsuite | vor 6 Jahren | |
| tools | vor 6 Jahren | |
| vector | vor 6 Jahren | |
| visualization | vor 9 Jahren | |
| .gitignore | vor 6 Jahren | |
| .travis.yml | vor 6 Jahren | |
| AUTHORS | vor 6 Jahren | |
| CHANGES | vor 8 Jahren | |
| CITING | vor 7 Jahren | |
| COPYING | vor 9 Jahren | |
| Dockerfile | vor 6 Jahren | |
| GPL.TXT | vor 17 Jahren | |
| INSTALL | vor 6 Jahren | |
| Makefile | vor 6 Jahren | |
| NEWS | vor 9 Jahren | |
| README.md | vor 6 Jahren | |
| REQUIREMENTS.html | vor 6 Jahren | |
| SUBMITTING | vor 11 Jahren | |
| TODO | vor 10 Jahren | |
| Vagrantfile | vor 6 Jahren | |
| aclocal.m4 | vor 9 Jahren | |
| binaryInstall.src | vor 6 Jahren | |
| config.guess | vor 6 Jahren | |
| config.sub | vor 6 Jahren | |
| configure | vor 6 Jahren | |
| configure.in | vor 6 Jahren | |
| contributors.csv | vor 6 Jahren | |
| contributors_extra.csv | vor 8 Jahren | |
| grass.pc.in | vor 10 Jahren | |
| grasslib.dox | vor 6 Jahren | |
| install-sh | vor 12 Jahren | |
| translators.csv | vor 6 Jahren |
README.md
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 grassgis78 .
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/ grassgis78 \
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/ grassgis78 \
grass /data/nc_basic_spm/PERMANENT --exec g.region -p
Note that the first grassgis78 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 \
grassgis78 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