Download the file setup.exe to a local disk, run it and follow the instructions.
When installing the Cygwin tools, please select all packages, or at least:
Additionally you will need the precompiled X Window (XFree86, X11R6.4) System. See next paragraph.
NOTE: When selecting the root install directory, make sure that the "Default Text File Type" is set to Unix.
If you want to use the GRASS monitors (graphical output), you need the X
Server and the X11 libraries. Get them by selecting the XFree86 options in
the Cygwin setup program checklist.
Download at least the following XFree packages: base, bin, lib, etc, doc,
fnts, f100, prog and xserv. Please refer to the XFree install guide for
further details.
Alternative to XFree/Cygwin:
There are a lot of different free and commercial servers.
If you don't want to use the XFree Server, you can download the StarNet X Server from
http://www.starnet.com/en/products/. This is a demo version that will time out
after 2 hours. You can restart it again after it times out.
Currently only the XFree86 Server and the StarNet X Server have been tested with the GRASS distribution.
The Microimages X Server will not work reliable with the X11R6.4 libraries
GRASS is linked with.
The only GRASS features which require an X Server are tcltkgrass and NVIZ. Hopefully, it will be possible to use tcltkgrass on Cygwin without X in the near future, although NVIZ will require X for the foreseeable future.
Download the precompiled X tcl/tk 8.x libraries and executables from
http://grass.itc.it/grass50/binary/windows_cygnus/wingrass_xserver/.
Go to the root directory (cd /) and unpack this file:
cd / tar xzf /where/ever/you/saved/this/xtcltk-*.tar.gz
cd /wherever/you/saved/package
./grass5install.sh grass5.0.2_i686-pc-cygwin_bin.tar.gzThis will install the GRASS package under /usr/local/grass5 and store the start files under /usr/local/bin. Please note that the paths are all relative to the cygwin root (usually C:\CYGWIN or C:\PROGRAM FILES\CYGWIN or similar). Do not install the file from the root directory of cygwin (C:\CYGWIN from Windows or / from within cygwin), due to some bug of cygwin this will result in an error.
Next you should install some data to test GRASS. You can get the global_grass5data.tar.gz sample data set from http://grass.itc.it/data.html. Unpack the data with:
tar xzf global_grass5data.tar.gzin an empty directory, e. g. /home/andreas/data. Again remember to do this from within the cygwin shell.
Depending on the winGRASS version you use (generic winGRASS or winGRASS with X Server support), you continue like this:
d.mon x0 d.mon sel=x0Then continue as usual. All GRASS modules except 'tcltkgrass' and 'nviz' are supported.
6.2.1 XFree86 desktop mode
In cygwin, launch the XFree86 server at Cygwin Bash prompt with:
startxwin.batThen start GRASS in a terminal within the X desctop.
6.2.2 XFree86 multiwindow mode
In cygwin, launch the XFree86 server at Cygwin Bash prompt with:
export DISPLAY=127.0.0.1:0 XWin -multiwindow -clipboard &Now the X Server is listening and will open X related windows in individual windows. Then start GRASS as usual:
grass5 d.mon x0 d.mon sel=x0 tcltkgrass & nviz elevation.dem vect=roads &This runs GRASS similar to a common MS-Windows application.
Please also read the Cygwin/XFree86 User's Guide.
On the GRASS web site you can find a StartGrass.bat script to put in your home directory. Please edit this file to adapt to your local paths. This sets the PATH and all needed environment variables and spawns an xterm window. From within that window run 'grass5'.
Please report any problems, errors and solutions to the GRASS developers mailing list at http://grass.itc.it/grassdevel.html#list or the winGRASS mailing list at http://grass.itc.it/wingrass.html.