helptext(1)

1helptext(1)                   Grass User's Manual                  helptext(1)
2
3
4
5GRASS Quickstart
6

Geographic Resources Analysis Support System

8       Commonly  referred to as GRASS, this is a Geographic Information System
9       (GIS) used for geospatial data management and analysis, image  process‐
10       ing,  graphics/map  production,  spatial  modelling, and visualization.
11       GRASS is currently used in academic and commercial settings around  the
12       world,  as well as by many governmental agencies and environmental con‐
13       sulting companies.
14

Introduction

16       GRASS data are stored in a directory  referred  to  as  DATABASE  (also
17       called  "GISDBASE").   This directory has to be created with mkdir or a
18       file manager, before starting to work with GRASS.   Within  this  DATA‐
19       BASE, the projects are organized by project areas stored in subdirecto‐
20       ries called LOCATIONs.
21
22       A LOCATION is defined by its coordinate system, map projection and geo‐
23       graphical  boundaries. The subdirectories and files defining a LOCATION
24       are created automatically when GRASS is started the first time  with  a
25       new LOCATION.
26
27       Each LOCATION can have many MAPSETs. Each MAPSET is a LOCATION's subdi‐
28       rectory. New MAPSET can be added at Grass startup. To remove a  MAPSET,
29       remove   it's   directory   using  your  file  manager  or  by  rm  -rf
30       /path/to/the/mapset_to_delete.
31
32       One motivation to maintain different mapsets is to store  maps  related
33       to  project  issues  or  subregions.  Another  motivation is to support
34       simultaneous access of several users to the map  layers  stored  within
35       the  same LOCATION, i.e. teams working on the same project. For teams a
36       centralized GRASS DATABASE would be defined in a  network  file  system
37       (e.g.  NFS).  Besides  access to his/her own MAPSET, each user can also
38       read map layers in other users' MAPSETs, but s/he can modify or  remove
39       only the map layers in his/her own MAPSET.
40
41       You  can  learn  more  about  mapsets and how to seamlessly access maps
42       found in another MAPSET of the same LOCATION in the g.mapsets  documen‐
43       tation.
44
45       When  creating  a  new  LOCATION, GRASS automatically creates a special
46       MAPSET called PERMANENT where the core data  for  the  project  can  be
47       stored.  Data  in  the  PERMANENT MAPSET can only be added, modified or
48       removed by the owner of the PERMANENT  MAPSET;  however,  they  can  be
49       accessed,  analyzed,  and  copied  into  their  own MAPSET by the other
50       users. The PERMANENT MAPSET is useful  for  providing  general  spatial
51       data  (e.g.  an elevation model), accessible but write-protected to all
52       users who are working in the same LOCATION as the database  owner.   To
53       manipulate  or  add  data to PERMANENT, the owner would start GRASS and
54       choose the relevant LOCATION and the  PERMANENT  MAPSET.   This  mapset
55       also  contains  the  DEFAULT_WIND  file, which holds the default region
56       boundary coordinate values for  the  location  (which  all  users  will
57       inherit  when  they  start  using  the  database). Additionally, in all
58       mapsets a WIND file is kept, for storing the current  boundary  coordi‐
59       nate  values  and the currently selected raster resolution.  Users have
60       the option of switching back to the default region at any time.
61

Creating a GRASS database

63       To create the GRASS database: Find a place on your disk where you  have
64       write  access  and  that has enough diskspace to hold your decompressed
65       data.  Create a subdirectory that will hold the general GRASS  database
66       (e.g. mkdir /data/GRASSDATA or mkdir /home/yourlogin/GRASSDATA).
67
68       Sample data such as the Spearfish sample dataset may be downloaded from
69       http://grass.itc.it/download/data.php and placed in  the  new  database
70       directory.
71
72       Click  on  the  "Create  New Location" button, which will take you to a
73       text screen on which you can enter a new location name, and  then  con‐
74       tinue  by  pressing "ESC"-"RETURN" - i.e. press (NOT hold) the ESC key,
75       and then press the RETURN key on your keyboard.
76
77       Next you will need to assign parameters to the  location  such  as  the
78       coordinate  system and datum you want to use, the project area's bound‐
79       ary coordinates, and the default resolution for raster data:
80              Start by  chosing  between,  X,Y,  Latitude-Longitude,  UTM,  or
81              "other"  coordinate system. This choice depends on your data and
82              the use you will make of it.  You are then prompted for a single
83              line  of text describing the project area, for example "Topo Map
84              of the Alps".
85
86       Next you are requested for some more information about the  projection.
87       Note  that  the  prompts vary from projection to projection, an example
88       follows:
89              (if you chose "D - Other Projection") "specify projection name":
90              "list" gives you the list of all available projections, examples
91              are "tmerc" for Transverse Mercator, "lcc" for Lambert Conformal
92              Conic, "moll" for Mollweide, etc.  specify datum name: again use
93              "list" to get a list of available datums, examples are  "wgs84",
94              "nad27",  "eur79",   etc.  Enter Central Parallel: 0 if you want
95              the Equator as the central parallel Enter Central Meridian: 0 if
96              you  want the Greenwich meridian as central meridian Enter Scale
97              Factor at the Central Meridian Enter plural form of  map  units:
98              for example, meters
99
100       The next step is the description of the project area's boundary coordi‐
101       nates and the definition of the default raster resolution:
102
103       The default raster  resolution  (GRID  RESOLUTION)  has  to  be  chosen
104       according to your needs. Generally, it is advisable to work in steps of
105       0.25 (0.25, 0.5, 1.75, 2.00, 12.25 etc.). This resolution does not con‐
106       cern vector and site data since these are stored with their exact coor‐
107       dinate values. Note that every raster map may have its own  resolution.
108       You can leave this screen with "ESC"-"RETURN" and then if everything is
109       correct accept the list of parameters that appears.
110
111       You will then be back to the startup screen to enter the mapset's  name
112       (if  not  already entered). Another "ESC"-"RETURN" will finally let you
113       leave this screen. This mapset is created within the  new  location  by
114       answering  "yes"  to the next question. The mapset will use the parame‐
115       ters of the location (such as the region and resolution definitions) as
116       its default parameters.
117
118       Now  the  project  area, i.e. the location including a mapset, has been
119       created. You have "arrived" in the GRASS system and can  start  working
120       within this new location.
121

Geographic Resources Analysis Support System

Introduction

Creating a GRASS database

Further Reading

See also