View source for WinGRASS 6 Current Status

__TOC__

See also '''[http://trac.osgeo.org/grass/wiki/BuildingOnWindows http://trac.osgeo.org/grass/wiki/BuildingOnWindows]'''

This page describes the current status of winGRASS development:

* '''[http://grass.osgeo.org/download/index.php#g64x Lastest downloads]'''

* ''Older precompiled winGRASS/Cygwin packages are available for [http://grass.itc.it/grass63/binary/mswindows/cygwin/ GRASS 6.3], ''
* ''Older native winGRASS packages [http://geog-pc40.ulb.ac.be/grass/wingrass/ GRASS 6.3],''


== Current status - Summary ==

The native windows port of GRASS is slowly coming to a stage where it can be considered mature beta status. All main functions seem to work, but much more testing is needed. The port is of the current SVN release branch for GRASS 6.4.0. The only prior native port of an earlier version is 6.3.0.

The general idea is to reach a point where GRASS runs in MS-Windows without any kind of UNIX emulation. Currently this is possible but limits the use to compiled modules, as scripts are all of UNIX-shell type and cannot run within a Windows cmd.exe environment without a series of UNIX tools such as a shell, awk, sed, etc. So in order to run such scripts a collection of UNIX-like tools needs to be installed, such as Msys or Gnuwin32+Shell.

Another major feature not available in the MS-Windows version are the old-style interactive X monitors (i.e. the x0, PNG, PS, Cairo, etc, monitors opened with '<tt>d.mon&nbsp;x0</tt>'). Only direct rendering works currently. Display is thus "limited" to the Tcl/Tk and wxPython GUIs (the latter might still need some cleanup of UNIX-specific code). Modules like i.points and d.zoom will not work due to their interactive monitor requirements (see [[#Known_Issues]]).

== Installing binary snapshots ==

Regular binary snapshots for windows are available from the main GRASS [http://grass.osgeo.org/download/index.php download page].

== Compiling by yourself ==

=== Guide ===

All informations for compiling yourself are in '''''[http://trac.osgeo.org/grass/wiki/CompileOnWindows Compiling GRASS on MS-Windows]'''''

=== Nullsoft installer ===

See http://trac.osgeo.org/grass/browser/grass/branches/develbranch_6/mswindows

[[Image:Wingrass63 installer1.jpg|220px|New winGRASS installer 1]]
[[Image:Wingrass63 installer2.jpg|220px|New winGRASS installer 2]]
[[Image:Wingrass63 installer3.jpg|220px|New winGRASS installer 3]]

== Known Issues  ==

See also
* [https://trac.osgeo.org/grass/wiki/CompileOnWindows#Errata WinGrass current bug list],
* [http://n2.nabble.com/Grass---Win-f1928820.html winGRASS Mailing list archives],

=== Flagrant ===

* '''wxVdigit''' (vector digitizer) doesn't work. see {{trac|541}}.
: Workaround: Use the old Tcl/Tk {{cmd|v.digit}} module, simply type <tt>v.digit</tt> at the <tt>Cmd></tt> prompt in the Layer Manager GUI.

* '''wxNviz''' (3D visualization) works, but there are some issues. see {{trac|541}}, {{trac|1141}}.
: Please test the new wxNviz on Windows and report any issues. For a workaround: Use the Tcl/Tk {{cmd|nviz}} module, simply type <tt>nviz</tt> at the terminal prompt in shell window.

* '''Spaces in path names'''
** Installation directory: WinGRASS uses the MSys software to run on MS-Windows. Unfortunately MSys isn't very interested in supporting spaces in path names, but WinGrass-development in the last few months tried to get this ready. Currently the default installation directory is c:\Programm Files\Grass-64\
** GIS data directory: It is generally safe to have spaces in your GIS data directory path, but there are few spots where it might still get confused and chop the path off at the first space. If you find one please report it to the bug tracker, the sooner we know about it the sooner we can fix it.
: Workaround: if this is causing problems for you the quick solution is to rename the GIS data directory and replace all spaces with underscores (_).

* The '''{{cmd|r.li}}''' suite and '''{{cmd|d.mon}}''' monitors won't work. These use UNIX pipes and won't work on Windows without a lot of work.

=== Won't fix (at least not immediately) ===

Issues listed here are rather impossible to fix due to the different nature of native Windows. Or, lend us a hand and let's try harder!

* No monitors

This means that you cannot launch any monitor launched with d.mon (x0, PNG, PS, etc). The only way you can render is directly to a file. But you cannot directly display to screen from the command line. This will be solved in GRASS 7 with a new rendering system and possibly via the new wxgrass GUI. So no work will probably be put into this until then. 

The absence of monitors also makes impossible the use of interactive modules based on these monitors, such as:

** i.class. However, See http://trac.osgeo.org/grass/browser/grass-addons/gui/wxpython/wx.class for a start
** i.ortho.photo/photo.2image
** i.ortho.photo/photo.2target
** i.points
** i.vpoints

i.points and i.vpoints have already been replaced by the gis.m georectifier module (File -> Georectify). In replacement of i.class you can digitize training areas with v.digit. This will not however, give you all the information i.class provides, such as the histogram of the region, the statistics and the display of matches. These modules will have to be rewritten to clearly separate display and backend parts, so that the backend can be run on the command line or from any GUI frontend. '''Volunteers needed.'''

Another module affected is d.vect.thematic which uses monitors. This will hopefully be replaced by a C-version in a not too far future.

* Scripts need *nix-like shell

All current GRASS 6.4 scripts are written in shell language. This means they need a shell, and several related tools (awk, sed, etc), to function. The actual WinGrass 6.4-installer includes Msys, so all shell-scripts should work.

In 7.0, these scripts have been rewritten in Python, thus totally eliminating the need for any shell.

=== Platform specific issues ===

==== XP/2000 ====

If the GRASS GUI startup fails with "[Error 14001]" in the MSys terminal on a relatively fresh install of XP, the solution is to install some missing DLL files from Microsoft which apparently don't come standard.
If these library files are missing, [http://www.qgis.org Quantum GIS] and other software from the [http://osgeo4w.osgeo.org OSGeo4W] stack will likely encounter the same trouble as well.

You'll need to install two files: (in order)

* MS's Windows Installer 3.1 Redistributable (v2)
: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=25

* MS's .net framework 3.5 downloader
: http://www.microsoft.com/download/en/details.aspx?id=21

It is recommended to run Windows updates after installing these.

==== Vista ====

* <strike>sometimes {{cmd|r.patch}} fails: {{trac|118}} [ticket closed]</strike>

==== Windows7 ====

* Missing MSVCR71.dll on startup
: Try installing Microsoft's .net frameworks as described above in the XP section. If that doesn't solve it, try these instructions found in a web search: http://i.justrealized.com/2009/how-to-fix-missing-msvcr71dll-problem-in-windows/

=== ToDo ===

==== Installer ====

* <strike>change the Uninstall icon</strike>
* <strike>fix the language errors in the StartMenu link's descriptions</strike>
* <strike>change the name of the South-Dakota sample database to Spearfish60</strike>
* <strike>add a GRASS Command Line link (cmd.exe) into the GRASS StartMenu group</strike>
* create a GRASS Addons installer or integrate the GRASS Addons in the current installer as downloadable options.
: See {{cmd|g.extension|version=65}} in GRASS 6.5+

==== Dependencies ====

===== GRASS Dependencies =====

* <strike>add the Indipendent JPEG support to GRASS *</strike>
* add the FFMPEG support in GRASS (reports an error in building OGSF library; probably needs to specify -lavutil in gcc command) ***
* add the NLS support in GRASS (needs gettext)
* add the wxWidgets support in GRASS (for the wxPython GUI v.digit replacement)

===== GDAL Dependencies =====

* add the ECW support in GDAL */**
* add the JPEG2000 support in GDAL (through Jasper or Kadaku *) **
* add the OGDI support in GDAL *
* add the MrSID support in GDAL */**

===== GRASS and GDAL Dependencies =====

* add the Xerces support in both GDAL and GRASS *
* add the ODBC support in both GDAL and GRASS */**
* add the MySQL support in both GDAL and GRASS */**

===== Miscellaneus Dependencies =====

* add the OpenSSL support in both PostgreSQL and SQLite *
* <strike>add the AVCE00 tools (build from source in minGW)</strike>
* <strike>add the E00compr tools (build from source in minGW)</strike>
* <strike>add the GPSBabel tool (use prebuilt binaries from GPSBabel Web Site)</strike>

<br>
<nowiki>*</nowiki> needs to build related libraries from source in MinGW
<br>
<nowiki>**</nowiki> needs to check the licences first
<br>
<nowiki>***</nowiki> FFMPEG has been already succesfully built on MinGW

==== Internal Libraries ====

* parser: find out why launching a module from the command line without parameters does not call module GUI

==== Vector modules ====

* v.in.ascii crashes on files with irregular line length (see [http://lists.osgeo.org/pipermail/grass-dev/2008-February/035268.html this thread])

==== Raster modules ====
* <strike>r.terraflow does not compile</strike> fix backported 27/3/2008
: This seems to be due to the use of the function getrusage() which is not supported under MinGW. Check this octave patch [http://osdir.com/ml/gnu.octave.maintainers/2006-03/msg00083.html email thread].

==== Other modules ====
* r.li moduels do not compile (they require UNIX sockets, much the same situation as the display monitors)
: Use the older r.le modules instead.

==== GRASS Addons ====
* compile the GRASS Addons

==== TclTk issues ====

* var=val style argument is not valid for batch files: equal sign is a separator like a space. http://support.microsoft.com/?kbid=71247 http://www.gatago.com/alt/msdos/batch/17358926.html
** Could you give an example of where this is a problem ?
* file command returns bad code (catch is needed): http://sources.redhat.com/ml/insight/2003-q1/msg00079.html
** catch {file copy}
** catch {file delete}
** catch {file rename -force} does not work. Delete old file first: catch {file delete}; catch {file rename}
** exec a batch file doing redirection (>&2, 2>&1)
* no -permissions file attributes
** catch {file attributes -permissions}

==== Miscellaneous ====

* metacharacter escape in "sh -c '$cmd'"
* modules not working: <strike>v.neighbors, v.kernel, r.cost</strike>
* <strike>Cannot open Help pages.</strike>
* Have to type "exit" in the console to save ~/.grassrc file. Then, close gis.m to finish the session.
* A previous installation of grass under cygwin is likely to cause problems with WinGrass. Follow the directions to remove cygwin at http://cygwin.com/faq/faq-nochunks.html#faq.setup.uninstall-all

The following items cannot be fixed in the near future:
** can't read "_data(.gronsole.gronsole,4,donecmd)": no such element in array error
*** Could you be more precise about this error ? When does it occur ?

== Dealing with shell scripts or .bat files ==

Bourne shell scripts require MSys (or some other Bourne shell), but you don't need to start GRASS from MSys.

The main issue with scripts is that Windows doesn't understand the "#!" notation used to specify the interpreter.

All of the supplied scripts in $GISBASE/scripts have a corresponding .bat file in $GISBASE/bin which invokes script via %GRASS_SH%. This allows you to run those scripts from the Windows command prompt.

If you write scripts of your own, you need to either add a corresponding .bat file, or give the script a .sh extension and associate that with the shell, e.g. via the ftype and assoc commands. You can use the PATHEXT variable to eliminate the need to type the extension.

== Other libraries ==

GDAL
* lib/gis/OBJ.*/fmode.o is needed for any GRASS related modules.
* modified ltmain.sh to install binary files from wrapper scripts.
* see also [http://trac.osgeo.org/gdal/wiki/BuildingWithMinGW GDAL Building With MinGW]

== Related efforts ==

* http://trac.osgeo.org/osgeo4w/wiki/pkg-grass

[[Category: Development]]