GRASS manual page

Da Wikipedia, l'enciclopedia libera.

Contents 1 Nome 2 Sinossi 3 Descrizione 4 Features 5 Opzioni 5.1 Flag 5.2 Parametri 6 ENVIRONMENT VARIABLES 6.1 User Interface Environment Variable 6.2 Tcl/Tk Environment Variables 6.2.1 Example Use of GRASS Tcl/Tk Environment Variables 6.3 Addon path to extra local GRASS modules 6.4 Location Environment Variables 6.4.1 Example 1 6.4.2 Example 2 6.4.3 Example 3 6.4.4 Example 4 6.4.5 Example 5 6.5 Note 7 Esempi 8 BUGS AND CAVEAT 9 FILES 10 Vedi anche 11 Autori (di questa pagina)

Nome

grass62 - comando per far partire GRASS

Sinossi

grass62 [-] [-v] [-h | -help | --help] [-text | -tcltk | -gui] [[[<GISDBASE>/]<LOCATION_NAME>/] <MAPSET>]

Descrizione

Questo comando è usato per far partire GRASS. Analizzerà il sommario dei parametri disponibili per questo comando e poi farà partire GRASS per l'utente. Poiché i comandi di GRASS hanno bisogno di uno specifico ambiente, questo comando deve essere utilizzato prima che ogni altro comando di GRASS possa girare. Il sommario dei parametri disponibili per questo comando è opzionale e fornisce all'utente un metodo per mostrare l'interfaccia utente desiderata, così come il mapset desiderato su cui lavorare.

Features

GRASS salverà all'avvio la desiderata interfaccia utente e mapset. Così, la prossima volta che l'utente avvierà GRASS, scrivendo grass62 (senza alcuna opzione) partirà GRASS con il precedente settaggio per l'interfaccia utente e mapset.

Se tu specifici un interfaccia utente grafica (es Tcl/TK) il comando grass62 proverà a verificare che il sistema da te specificato esista e che puoi accedere con successo. Se uno di questi controlli fallisce, grass62 devierà automaticamente all'interfaccia utente testuale.

Opzioni

Tutte le opzioni della linea di comando sono opzionali.

Flag

-

Prova a far partire GRASS usando variabili d'ambiente e location (guarda di seguito)

-h -help --help

Stampa un breve messaggio su come utilizzare Grass

-text

Indica che dovrebbe essere usata l'interfaccia utente testuale

-gui (or -tcltk)

Indica che dovrebbe essere usata l'interfaccia utente grafica basata su Tcl/Tk

-v --version

Stampa la versione di GRASS

Parametri

GISDBASE

Directory iniziale del database che dovrebbe un percorso completo (es. /usr/local/share/grassdata)

LOCATION_NAME

Directory iniziale della location che è una sottodirectory del GISDBASE

MAPSET

Directory iniziale del mapset che è una sottodirectory del LOCATION_NAME

Note

Voi dovete specificare uno dei seguenti

MAPSET
LOCATION_NAME/MAPSET
GISDBASE/LOCATION_NAME/MAPSET

ENVIRONMENT VARIABLES

User Interface Environment Variable

Il comando grass62 controllerà l'esistenza di una variabile d'ambiente chiamata GRASS_GUI che indica i tipi di interfaccia utente da usare per GRASS. Se questa variabile non è impostata quando grass62 sta girando, allora sarà creata e salvata nel file $HOME/.grassrc6 per la prossima volta che GRASS verrà avviato.

C'è un ordine di precedenza nel percorso grass60 che determina l'interfaccia utente da utilizzare. Qui di seguito c'è la gerarchia di precedenza dal più alto al più basso

L'utente deve aggiungere le proprie impostazioni della variabile d'ambiente al file $HOME/.grassrc6 che sarà usato durante il prossimo avvio di GRASS (lista delle variabili d'ambiente modificabili).

Interface precedence

Command line argument
Environment variable GRASS_GUI
Value set in $HOME/.grassrc6
Default value - currently tcltk

Tcl/Tk Environment Variables

Se scegli di usare l'interfaccia grafica utente Tcl/Tk, allora le seguenti variabili d'ambiente possono essere usate dal tuo sistema per oltrepassare i comandi wish e tclsh di default del sistema. Guarda la sezione delle diverse descrizioni immediatamente sotto per un esempio.

GRASS_TCLSH

Command to use to override tclsh

GRASS_WISH

Command to use to override wish

Example Use of GRASS Tcl/Tk Environment Variables

Supponiamo che il vostro sistema ha installato Tcl/Tk 8.0 e voi installate la vostra versione personale Tcl/Tk 8.3 con i binaries installati sotto $HOME/bin. Voi potete usare le variabili qui sopra per avere GRASS che usa invece i binaries Tcl/Tk 8.3.

GRASS_TCLSH = $HOME/bin/tclsh8.3
GRASS_WISH = $HOME/bin/wish8.3

Addon path to extra local GRASS modules

Queste variabili d'ambiente permettono di estendere GRASS localmente con percorsi di moduli sviluppati/installati che non sono distribuiti attraverso le versioni standard di GRASS.

GRASS_ADDON_PATH=/usr/mytools
GRASS_ADDON_PATH=/usr/mytools:/usr/local/othertools

Nell'esempio sopra il percorso (percorsi) verrebbe aggiunto all'ambiente standard del percorso di GRASS.

Location Environment Variables

La sezione sinossi e opzioni sopra descrivono le opzioni che possono essere usate per settare location e mapset che GRASS userà. Questi valori possono anche essere settati con variabile d'ambiente. Comunque, specificando le variabili location e mapset da linea di comando si oltrepasserà questa variabile d'ambiente. Le possibili variabili sono le seguenti:

LOCATION

Un percorso completamente idoneo ad un mapset (es. /usr/local/share/grassdata/spearfish60/PERMANENT). Questa variabile d'ambiente oltrepasserà le variabili GISDBASE, LOCATION_NAME e MAPSET.

GISDBASE

Directory iniziale del database che dovrebbe essere un percorso completo (es. usr/local/share/grassdata)

LOCATION_NAME

Directory iniziale della location che è una sottodirectory del GISDBASE

MAPSET

Directory iniziale del mapset che è una sottodirectory del LOCATION_NAME

Ci sono una varietà di percorsi di queste variabili che possono essere usate per specificare il mapset da usare. I seguenti esempi sono alcuni possibili.

Example 1

The environment variables are defined as follows:

LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT
GISDBASE = /usr/local/share/grassdata
LOCATION_NAME = spearfish60
MAPSET = PERMANENT

Start GRASS with the following command:

grass60 -

GRASS will start with the mapset defined by LOCATION since the LOCATION variable overrides the other variables.

Example 2

The environment variables are defined as follows:

GISDBASE = /usr/local/share/grassdata
LOCATION_NAME = spearfish60
MAPSET = PERMANENT

Start GRASS with the following command:

grass60 -

GRASS will start with the mapset defined by GISDBASE/LOCATION_NAME/MAPSET.

Example 3

The environment variables are defined as follows:

LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT
GISDBASE = /usr/local/share/grassdata
LOCATION_NAME = spearfish60
MAPSET = PERMANENT

Start GRASS with the following command:

grass60 /usr/home/grass/data/thailand/forests

GRASS will start with the mapset /home/grass/data/thailand/forests which overrides the environment variables.

Example 4

The environment variables are defined as follows:

LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT
GISDBASE = /usr/local/share/grassdata
LOCATION_NAME = spearfish60
MAPSET = PERMANENT

Start GRASS with the following command:

grass60 swamps

GRASS will start with the mapset defined by GISDBASE/LOCATION_NAME/swamps since the command line argument for the mapset overrides the environment variable MAPSET.

Example 5

The environment variables are defined as follows:

LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT
GISDBASE = /usr/local/share/grassdata
LOCATION_NAME = spearfish60
MAPSET = PERMANENT

Start GRASS with the following command:

grass60 thailand/forests

GRASS will start with the mapset defined by GISDBASE/thailand/forests since the command line arguments for the location and mapset overrides the environment variables LOCATION_NAME and MAPSET.

Note

Notare che occorrerà settare queste variabili usando l'appropriato metodo richiesto dalla shell UNIX che usate.

Esempi

I seguenti sono alcuni esempi di come potrete avviare GRASS

grass62

Avvia GRASS usando l'interfaccia utente di sistema. L'utente sarà spinto a scegliere appropriate location e mapset.

grass62 -tcltk

Avvia GRASS usando l'interfaccia utente basata su Tcl/Tk. L'utente sarà spinto a scegliere appropriate location e mapset.

grass62 -text

Avvia GRASS usando l'interfaccia utente basata sulla linea di comando. L'utente sarà spinto a scegliere appropriate location e mapset.

grass62 -tcltk -

Avvia GRASS usando l'interfaccia utente basata su Tcl/Tk e prova ad ottenere la location e il mapset da variabili d'ambiente.

Other examples

Guardare la sezione Variabili d'ambiente della location per ulteriori esempi.

BUGS AND CAVEAT

Se avviate GRASS usando l'interfaccia Tcl/Tk dovrete avere un comando wish nella vostra variabile $PATH. Vale a dire, il comando deve chiamarsi wish e non qualcosa tipo wish8.3. Di default, un'installazione di Tcl/Tk non crea un comando wish. Così, l'amministratore del sistema deve creare un appropriato link all'attuale programma wish.

Per esempio, supponiamo che il programma Tcl/Tk8.3 sia installato in /usr/local/bin. Allora l'amministratore del sistema dovrà andare alla directory /usr/local/bin e far girare il comando ln -s wish8.3 wish e ln -s tclsh8.3 tclsh per installare correttamente Tcl/Tk da usare con GRASS.

Inoltre, se avete più di una versione di Tcl/Tk installate, assicuratevi che la versione che voi volete usare con GRASS sia la prima versione che si trova nella vostra variabile $PATH. GRASS ricerca la vostra variabile $PATH fino che non trova la prima versione di wish.

FILES

$UNIX_BIN/grass62 - programma che avvia GRASS

$GISBASE/etc/Init.sh - GRASS initialization script chiamato da grass62

$GISBASE/tcltkgrass/script/gis_set.tcl - Script Tcl/Tk per settare la location e il mapset da usare. Chiamato da Init.sh

Vedi anche

List of implemented GRASS environment variables.

GRASS Web site

Autori (di questa pagina)

Justin Hickey
Markus Neteler