= GRASS GIS =

[[TOC]]

Maintainer: [wiki:MartinLanda Martin Landa]

== Versions ==

=== 7.0.x (stable) ===

 * Package: `grass`

=== 6.4.x (old stable) ===

 * Package: `grass6`

=== 7.1.svn (daily builds, development version) ===

 * Package: `grass-daily`
 * Daily builds of SVN [http://svn.osgeo.org/grass/grass/trunk trunk]

== User Notes ==

 * A desktop raster/vector GIS system (command line and graphical user interface)
 * Main site: http://grass.osgeo.org/
 * '''First time users should explore the [http://grass.osgeo.org/documentation/first-time-users/ first steps tutorial]''' after installing.

=== Installation === 
 * Get the OSGeo4W Installer [http://download.osgeo.org/osgeo4w/osgeo4w-setup-x86.exe 32bit] or [http://download.osgeo.org/osgeo4w/osgeo4w-setup-x86_64.exe 64bit]. (''400k network-installer, full download is approx 60-80mb'')
  * Generic installer help can be found on the main [WikiStart OSGeo4W] wiki page.
 * Choose '''grass''' package from ''Desktop'' section.

=== Usage === 
The application can be run through:
 * a desktop shortcut (icon)
 * a menu shortcut
 * on the osgeo4w shell through the `grass70.bat`

To start GRASS with graphical user interface, click on the desktop icon.

How to get '''command line''':
 * Start the osgeo4w shell. Then type:
{{{
   grass70 -text
}}}

How to start GRASS with the '''new wxPython GUI''':
 * Start the osgeo4w shell. Then type:
{{{
   grass70 -gui
}}}

=== Later Installation Update === 

 * It is sufficient to re-run the installer which fetches the list of packages to then suggest available updates for the individual packages.

=== Lab Installation as offline set of packages === 

While the OSGeo4W installer is nice for individual installs, it may be problematic for institutional lab installs, where IT managers want to have stand alone applications that they can test, install, and remove easily. To install OSGeo4W-GRASS package as stand alone, see

 * [wiki:FAQ#HowdoIperformanofflineorcomputerlabinstall How do I perform an offline or computer lab install?]
 * and [http://blog.qgis.org/node/124 Unattended install of QGIS (et al) from OSGeo4W]

 * see also the non-OSGeo4W [http://grass.osgeo.org/grass70/binary/mswindows/native/ stand alone installer] for WinGRASS

== TODO ==

 * Test, test test!

== Errata ==

 * While the GRASS libraries and modules are typically extremely well tested and stable, this new Windows install package is not. Because we are very confident in the underlying GIS code we hope that any problems due to the new Windows packaging efforts will be superficial and quickly resolved. You can help this process by reporting bugs: if it seems to be the fault of the installer report bugs to the [http://trac.osgeo.org/osgeo4w/report OSGeo4W bug tracker], if it seems to be the fault of GRASS, report bugs to the [http://trac.osgeo.org/grass/report GRASS bug tracker]. You will need to create yourself an [http://www.osgeo.org/osgeo_userid/ OSGeo ID] to submit and comment on bugs. Bugs don't get fixed unless people point them out! It is expected that some issues related to spaces in the path names still exist, but we hope to have found most of these by now. Also it is likely that the wxPython GUI still has some gremlins in it, please help us find and fix them by reporting any errors you come across! Typically once found they are easy to fix. You can help to find spaces-in-the-path bugs by installing OSGeo4W into "`Program Files\OSGeo4W`" and setting the GRASS data directory to "`Documents and Settings\username`".

 * See also [https://trac.osgeo.org/grass/wiki/CompileOnWindows#Errata keyword: wingrass tickets in the main GRASS bug tracker]

 * Probably more ...

See also the [http://grass.osgeo.org/wiki/WinGRASS_Current_Status#Known_Issues known issues wiki page].

== Packager Notes ==

 * Compile guide: [http://trac.osgeo.org/grass/wiki/CompileOnWindows Build using MinGW] see also support scripts from [http://svn.osgeo.org/grass/grass-addons/tools/wingrass-packager/ SVN]
 * Main WinGRASS [http://grass.osgeo.org/wiki/WinGRASS_Current_Status project current status] page

=== Open Tickets ===

[[TicketQuery(status=new|assigned|reopened&keywords~=grass&order=priority)]]

=== Closed Tickets ===

[[TicketQuery(status=closed&keywords~=grass&order=priority)]]