PREVIOUS     CONTENTS     EXERCISES     NEXT    

STARTING WinGRASS

It is presumed in these exercises that you have already downloaded and installed Cygwin, GRASS 6.0, and the Spearfish57 data, which if you have never done before, is a very big assumption, indeed. You may find some very explicit how-to-do instructions at the WinGRASS for the GREEN website.

With that behind you, you next go wherever you have placed the WinGRASS 6.0 shortcut and link:

GRASS60


Double-left-click on it and you should next see the GRASS 6.0 startup screen:
Entry

If you have followed the procedures at WinGRASS for the GREEN, all you will need to do is to click on the browse button until
/home/[username]/database
appears in the Database: window, and
spearfish57
appears in the location: window.

You should be able to make
PERMANENT
and
user1
displayed as "(Accessible) Mapsets"
with "user1" selected as shown in the above image, by left-clicking on "spearfish57".

Note that the following information is required and has been provided:

  • DATABASE: directory containing location.
  • LOCATION: main directory containing all grass files.
  • MAPSET: directory containing all grass maps.

When you have achieved that, all you need do is to click on "Enter GRASS" and the GUI ("GRASS 6.0.0 Display Manager") should appear in the middle of your screen. If you drag it to the upper right of your screen, and if you drag the Bash window to the upper left of your screen, your desktop should look like this:

desktop
CLICK TO ENLARGE

The blue on white Bash window, if it is important to you can be achieved by using A Kinder, Gentler Bash Screen on the WinGRASS for the GREEN website.

You are now IN WinGRASS 6.0.0!

In most cases, this is the way you will enter GRASS, but it is important that you know how to do it using a text form on the Bash screen, since sooner or later you will need to know how to do that.

We will need to change the environment variable GRASS_GUI so that the entry screen is a text form rather than a graphical screen.

  1. In the Display Manager, click on
    GIS => GRASS working environment => Show current GRASS environment settings

  2. The g.gisenv screen will appear:

    g.gisenv

  3. In the box titled "Grass variable to set (string, optional)", enter
    GRASS_GUI=text

  4. Click Run

  5. The g.gisenv screen will then look like this:

    g.gisenv2

  6. Note the text displayed at the bottom of the screen, particularly that which reads:
    g.gisenv set=GRASS_GUI=text
    This is very similar to that we will later use in the Bash window to change the variable back to what it was originally.

    You can learn more about g.gisenv and the GRASS_GIS variable in the g.gisenv documentation.

  7. Click "Close"

  8. Exit from the Display Manager by clicking on
    File => Exit

  9. In the Bash window, type
    exit
    and press Enter
    We are now completely out of WinGRASS.

  10. Restart WinGRASS by clicking on the shortcut for WinGRASS 6.0

  11. You are confronted with a different kind of Bash screen.

    textform

    This is the Bash text form that may be used to start WinGRASS. It is already filled with all required information, and that is the same information which was required using the graphical entry screen earlier.

    Note that the following information is required and has been provided:

    • DATABASE: directory containing location.
    • LOCATION: main directory containing all grass files.
    • MAPSET: directory containing all grass maps.

    But what we need to learn at this time are the very special commands that must be used to navigate around this form. They are very different from those that a Windows user would intuitively use. They also differ from the commands and keys which may be used in GRASS graphical screens like that for g.gisenv which we used earlier.

    • Jumping between the fields with the arrow keys or with the mouse is not permitted! Using the delete key is not permitted!
    • To "tab", or move between fields, press Enter. Do this several times and watch the cursor cycle through the fields. In a form with few fields, you may also jump to the beginning of any field by pressing Enter a few times.
    • To "reverse tab" (similar to Shift-Tab in Windows), use Control-k. Do this several times and watch the cursor cycle through the fields in the reverse direction.
    • To move to the next letter in any field, use Control-l. Try this several times in any field and note that the cursor moves one letter to the right for each use. It may help to think of right as "lower" and left as "higher".
    • To move to the previous letter in any field, use Control-h. Try this several times in any field and note that the cursor moves one letter to the left for each use.
    • To delete a letter, use the spacebar. The cursor will leave a blank space and will move one letter to the right. Use Enter until the cursor rests on the "s" in "spearfish". Press the spacebar to delete the "s". Use Control-h to back the cursor up to the blank we left. Retype "s" again at the beginning of "spearfish".
    • Be sure everything is left on the form exactly as we found it, and press and release Esc then press Enter. This finalizes the form and will enter us into GRASS but will not start the Display Manager.

  12. In the Bash window, at the command prompt, type:
    g.gisenv set=GRASS-GUI=tcltk
    and press Enter. Note that this is the same format displayed in 6., above.

    The Bash window will now look like this:

    tcltk

  13. If we wanted to run WinGRASS in this mode, we could load the Display Manager by typing d.m & (meaning run d.m and leave the present window open also), but we will not do that because all we need to do now (which we have done) is to change the variable GRASS_GUI from text to tcltk so that the GRASS entry screen will be graphical rather than the text form we just used.

    In the Bash window, type
    exit
    and press Enter, and we will exit WinGRASS completely. The next time we use the WinGRASS 6.0 shortcut to run WinGRASS, it will come up with the expected graphical entry screen.

This page replaces STARTING GRASS

PREVIOUS     CONTENTS     EXERCISES     NEXT