Skip to content

Commit 390baa0

Browse files
authored
Get started with GUI: remove unnecessary command line instructions, other adjustments (#6)
1 parent 075df6d commit 390baa0

File tree

1 file changed

+12
-50
lines changed

1 file changed

+12
-50
lines changed

content/tutorials/get_started/fast_track.qmd

Lines changed: 12 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Get started with GRASS GIS"
2+
title: "Get started with GRASS GIS GUI"
33
author: "Veronica Andreo"
44
date: 2024-03-19
55
date-modified: today
@@ -16,20 +16,18 @@ execute:
1616

1717

1818
In this notebook we will walk you through **5 simple steps** to get you started
19-
with GRASS GIS.
19+
with GRASS GIS using its graphical user interface (GUI).
20+
21+
If you want to use Python or R, check out tutorials to get started with
22+
[GRASS GIS in Jupyter Notebooks](fast_track_grass_and_python.qmd) or [R](fast_track_grass_and_R.qmd).
2023

2124
## Step 1: Install the software
2225

2326
GRASS GIS is available on Windows, Linux and macOS. The binaries for Windows and
2427
macOS can be found at <https://grass.osgeo.org/download/>.
28+
We recommend using the **current** release version.
2529

26-
Which version to choose? We recommend the **current** release version, which at
27-
the time of writing this post is **8.4**.
28-
29-
If you like testing the latest and greatest, you can go for the *preview*
30-
version which is *updated daily* and reflects the latest state of the source
31-
code.
32-
30+
GRASS GIS package [is available for many Linux distributions](https://grass.osgeo.org/download/linux/).
3331
Let's see an example of how to install GRASS GIS on **Linux/Ubuntu**:
3432

3533
```
@@ -38,22 +36,11 @@ sudo apt-get update
3836
sudo apt-get install grass grass-gui grass-dev
3937
```
4038

41-
On **Windows**, you can either select the
42-
[**standalone installer**](https://grass.osgeo.org/download/windows/#standalone-installers)
43-
which will bring GRASS GIS bundeled with all its dependencies or use the OSGeo
44-
for Windows (OSGeo4W)
45-
[**meta-installer**](https://grass.osgeo.org/download/windows/#OSGeo4W)
46-
that will allow you to install many other geospatial software packages and will
47-
resolve all dependencies for you.
48-
49-
![Install GRASS with OSGeo4W installer](images/osgeo4w_install_grass.png){width=60%}
50-
5139
## Step 2: Open GRASS GIS
5240

53-
Just double click on the GRASS GIS ![](images/grass-32x32.png) icon or type `grass`
54-
in a terminal. In any case, you'll get both the terminal and the graphical user
55-
interface (GUI). You can use GRASS tools in either. It's a matter of taste,
56-
task on hand and habit, too.
41+
Just double click on the GRASS GIS ![](images/grass-32x32.png) icon.
42+
You will get the GUI and terminal. You can use GRASS tools in either.
43+
It's a matter of taste, task on hand and habit, too.
5744

5845
![GRASS Graphical User Interface and terminal](images/grass_gui_first_time_and_cli_combined.png){width=60%}
5946

@@ -100,20 +87,6 @@ in the info bar or use ![](images/project-add.png) icon.
10087

10188
![Create a new GRASS project](images/create_new_project_gui.png){width=75%}
10289

103-
Projects can also be created from command line when starting GRASS. This is
104-
how we would create an UTM20S project, for example:
105-
106-
```
107-
grass -c EPSG:32720 /home/username/grassdata/utm20s
108-
```
109-
110-
Alternatively, pass a georeferenced file which CRS will be used to create your
111-
project:
112-
113-
```
114-
grass -c myraster.tif /home/username/grassdata/utm20s
115-
```
116-
11790
## Step 4: Import your data
11891

11992
Once you have created your GRASS project, you'll notice it contains the
@@ -148,14 +121,6 @@ Maps will be added to the layer tree and displayed automatically.
148121

149122
![](images/raster_and_vector_imported.png){width=75%}
150123

151-
We could execute the same tasks from either the "Console" tab or the terminal.
152-
In that case, the commands to import a raster and a vector map would be:
153-
154-
```
155-
r.import input=myraster.tif output=myraster
156-
v.import input=myvector.gpkg output=myvector
157-
```
158-
159124
## Step 5: Set the computational region
160125

161126
The last important step, especially if you are working with raster data, is to
@@ -209,11 +174,8 @@ g.region -p raster=myraster
209174
There are several sources you can get help from:
210175

211176
* [Manual pages online](https://grass.osgeo.org/grass-stable/manuals/full_index.html)
212-
* [g.manual](https://grass.osgeo.org/grass-stable/manuals/g.manual.html): eg.,
213-
`g.manual r.info`
214-
* `--help` or `--h` flag in command line, eg., `r.info --h`
215-
* [Tutorials](https://grass.osgeo.org/learn/tutorials) on the website
216-
* Join the GRASS community [chat](https://app.element.io/#/room/#grassgis_community:gitter.im) or subscribe to the [mailing list](https://lists.osgeo.org/mailman/listinfo/grass-user).
177+
* Join the GRASS [community](https://grass.osgeo.org/support/community/).
178+
* Ask for commercial [support](https://grass.osgeo.org/support/community/).
217179

218180
**You are ready! Enjoy!** {{< fa rocket >}}
219181

0 commit comments

Comments
 (0)