Geografic-Information-System/lib/init/helptext.html

<!-- meta page description: GRASS GIS Quickstart -->
<h2>Geographic Resources Analysis Support System</h2>

GRASS GIS, commonly referred to as GRASS (Geographic Resources Analysis 
Support System), is a free Geographic Information System (GIS) software
used for geospatial data management and analysis, image processing,
graphics/maps production, spatial modeling, and visualization. GRASS GIS
is currently used in academic and commercial settings around the world,
as well as by many governmental agencies and environmental consulting
companies. GRASS GIS is an official project of the Open Source Geospatial
Foundation (OSGeo).

<h2>1. Graphical startup of GRASS GIS</h2>

<i>For text-based startup see below.</i>
<p>

After <a href="grass.html">launching</a> GRASS GIS, the startup screen will open:
<p>
 
<center>
  <img src="grass_start.png" alt="[GRASS GIS start screen]">
</center>

<h3><img src="circle_1.png" alt="[(1)]">&nbsp;Selecting the GIS Database directory</h3>

GRASS data are stored in a directory referred to as DATABASE
(also called "GISDBASE").  This directory has to be created
with a file manager or the <tt>mkdir</tt> command, before starting to work
with GRASS.  Within this DATABASE, the projects are organized
by project areas stored in subdirectories called LOCATIONs.

<h3><img src="circle_2.png" alt="[(2)]">&nbsp;Selecting the LOCATION (a project)</h3>

A LOCATION is defined by its coordinate system, map projection and
geographical boundaries. The subdirectories and files defining a
LOCATION are created automatically when GRASS is started the first
time with a new LOCATION. It is important to understand that each
projection stays in its own LOCATION.
<p>
See the "Location Wizard"&nbsp;<img src="circle_4.png" alt="[(4)]"> to
easily create a new LOCATION from scratch from a geocoded file, by
defining the parameters or by selecting the corresponding EPSG projection
code.
<p>
See&nbsp;<img src="circle_5.png" alt="[(5)]"> to directly download a
sample LOCATION into the DATABASE. 

<h3><img src="circle_3.png" alt="[(3)]">&nbsp;Selecting the MAPSET (a subproject)</h3>

Each LOCATION can have many MAPSETs. Each MAPSET is a LOCATION's
subdirectory. New MAPSET can be added at GRASS startup (see related
button).

<h3><img src="circle_4.png" alt="[(4)]">&nbsp;Location Wizard</h3>

The "Location Wizard" let's you easily create a new LOCATION. You
will be guided through a series of dialogues to browse and select
predefined projections (also via EPSG code) or to define individual
projections. You can also create new LOCATION easily from a georeferenced
data file (e.g., SHAPE file or GeoTIFF, see below).  Find below also some
rules to define the default raster resolution for a new LOCATION.

<h3><img src="circle_5.png" alt="[(5)]">&nbsp;Download a sample LOCATION</h3>

In the "Location Wizard" there is also a Download button that allows you to
directly download a ready-to-use LOCATION into the DATABASE. You can
choose among different sample LOCATIONS that are currently available at the
<a href="https://grass.osgeo.org/download/sample-data/">Download</a>
section in the GRASS GIS website.

<h3><img src="circle_6.png" alt="[(6)]">&nbsp;Start GRASS</h3>

Once you have selected an existing LOCATION/MAPSET or defined a new
one, you can enter GRASS. The graphical user interface 
<a href="wxGUI.html">wxGUI</a> will open and provide you with a
menu system, map visualization tool, digitizer, and more.


<h2>2. Background: GRASS GIS Location structure</h2>

A LOCATION is simply a set of directories which contains the GRASS
data of a project. Within each LOCATION, a mandatory "PERMANENT"
MAPSET exists which contains projection information and some more
definitions. It can be used to store the base cartography in it as
"PERMANENT" is visible to all users accessing a LOCATION.
<p>

<!-- original drawing: ../../doc/grass_database.svg -->
<center>
  <img src="grass_database.png" alt="[GRASS GIS Location structure]" style="padding:5px;" border="1"><br>
  <i>Fig. 1: GRASS GIS 8 location structure</i>
</center>

<h3>Creating and maintaining MAPSETs</h3>
One motivation to maintain different MAPSETs is to store maps
related to project issues or subregions. Another motivation is to
support simultaneous access of several users to the map layers
stored within the same LOCATION, i.e. teams working on the same
project. For teams, a centralized GRASS DATABASE would be defined
in a shared network file system (e.g. NFS). Besides access to his/her own
MAPSET, each user can also read map layers in other users' MAPSETs,
but s/he can modify or remove only the map layers in his/her own
MAPSET.
<p>
You can learn more about mapsets and how to seamlessly access maps
found in another MAPSET of the same LOCATION in the
<a href="g.mapsets.html">g.mapsets</a> documentation.

<h3>The role of the "PERMANENT" MAPSET</h3>
When creating a new LOCATION, GRASS GIS automatically creates a special
MAPSET called PERMANENT where the core data for the project can be
stored. Data in the PERMANENT MAPSET can only be added, modified or
removed by the owner of the PERMANENT MAPSET; however, they can be
accessed, analyzed, and copied into their own MAPSET by the other
users. The PERMANENT MAPSET is useful for providing general spatial
data (e.g. an elevation model), accessible but write-protected to all 
users who are working in the same LOCATION as the database owner.
To manipulate or add data to PERMANENT, the owner would start
GRASS and choose the relevant LOCATION and the PERMANENT MAPSET.  This
mapset also contains the DEFAULT_WIND file, which holds the default
region boundary coordinate values for the LOCATION (which all users
will inherit when they start using the database). Additionally, in 
all mapsets a WIND file is kept, for storing the current boundary 
coordinate values and the currently selected raster resolution.  Users
have the option of switching back to the default region at any time.

<h2>3. Creating a GRASS Database with Sample Data</h2>

To create the GRASS database:

<ol>
<li> Find a place on your disk where you have write access and that
    has enough disk space to hold your spatial data.</li>
<li> Create a subdirectory that will hold the general GRASS database
    (e.g. using a file manager or with <tt>mkdir /data/grassdata</tt> or 
    <tt>mkdir /home/yourlogin/grassdata</tt>).</li>
</ol>

<p>
Sample data such as the &quot;North Carolina&quot; or the
&quot;Spearfish&quot; sample datasets may be downloaded from
<a href="https://grass.osgeo.org/download/data/">https://grass.osgeo.org/download/data/</a>
and the compressed data package(s) extracted into this new database
directory.
<p>
Now you are ready to select a sample dataset in the GRASS GIS startup screen
(see above) and start the session.

<h2>4. Creating a New Location with the Location Wizard</h2>
The <a href="wxGUI.html">wxGUI</a> graphical user interface provides a
graphical "Location Wizard" which lets you easily create a
new LOCATION for own data. You will be guided through a series of dialogues to
browse and select predefined projections (also via EPSG code) or to
define individual projections. The rules to define the resolution as
described above also apply here.

<p>
<i>Hint: You can create new LOCATION easily from a georeferenced data file
(e.g., SHAPE file or GeoTIFF file with the related metadata properly included).
In this case you are asked whether the data itself should be imported
into the new LOCATION. The default region is then set to match imported map
and the GRASS GIS session is opened.</i>

<p>
After defining new LOCATION, wxGUI starts automatically.
If data were already imported, you can add them into the Layer Manager now
and display them. If your LOCATION is empty you can import your data from 
the menu: Go to "File" -&gt; "Import raster/vector data" (see also the
related Wiki page on <a href="https://grasswiki.osgeo.org/wiki/Importing_data">Importing data</a>).

<h2>5. Text-based startup and location creation</h2>

GRASS GIS can be run entirely without using the graphical user interface.
For a first time startup, the following steps have to be followed:

<ol>
<li> Create the GRASS GIS database directory (with a file manager; or on command line: <tt>mkdir /home/user/grassdata</tt></li>
<li> Create a new location, including it's default PERMANENT mapset,
     without entering the new location:
<ul>
    <li>Using an EPSG code:<br>
        &nbsp;<tt>grass -e -c EPSG:32630 /home/user/grassdata/mylocation</tt></li>
    <li>Using a georeferenced raster or vector file:<br>
        &nbsp;<tt>grass -e -c MyGeoReferenceFile.tif /home/user/grassdata/mylocation</tt></li>
</ul></li>
<li> Create new mapset within the new location and launch GRASS GIS within
     that mapset: <br>
        &nbsp;<tt>grass -c /home/user/grassdata/mylocation/mymapset</tt>
</ol>


<h2>Further Reading</h2>

Please have a look at the GRASS GIS web site for tutorials and books:
<a href="https://grass.osgeo.org/learn/">https://grass.osgeo.org/learn/</a>.

<h2>See also</h2>

<em>
 <a href="index.html">GRASS GIS 8 Reference Manual</a>
<br>
 <a href="grass.html">GRASS GIS 8 startup program manual page</a>
</em>

<p>
 <a href="https://epsg.io/">List of EPSG codes</a> (Database of worldwide coordinate systems)

<!--
<p>
<i>Last changed: $Date$</i>
-->