
NOME
r.category - Gestisce i valori delle categorie e le etichette associate con un raster specificato dall'utente
PAROLE CHIAVE
raster, categoria
SINOSSI
r.category
r.category help
r.category map=nome [cats=range[,range,...]] [vals=float[,float,...]] [fs=character|space|tab] [raster=nome] [rules=nome] [format=string] [coefficients=mult1,offset1,mult2,offset2] [--verbose] [--quiet]
Parametri:
- map=nome
- Nome della mappa raster di input
- cats=range[,range,...]
- Valori delle categorie
- Esempio: 1,3,7-9,13
- vals=float[,float,...]
- Lista di valori separati da virgola
- Esempio: 1.4,3.8,13
- fs=character|space|tab
- Separatore di campo in output
- Predefinito: tab
- raster=nome
- Nome della mappa raster da cui copiare la tavola delle categorie
- rules=nome
- File contenente le regole per le etichette di categoria (oppure "-" per leggere dallo stdin)
- format=string
- Etichetta predefinita o stringa del formato per l'etichettatura dinamica
- Usato quando non esiste nessuna etichetta esplicita per la categoria
- coefficients=mult1,offset1,mult2,offset2
- Coefficienti dell'etichetta dinamica
- Moltiplicatore di categoria e offset per $1 e per $2
DESCRIZIONE
r.category visualizza sullo standard output i valori e le etichette
delle categorie per il tematismo raster definito da map=nome.
Può essere usato anche per impostare le etichette delle categorie per
una mappa raster
L'utente può definire tutti i parametri necessari da riga di comando.
ed eseguire il programma in modo non interattivo. Se l'utente non specifica
nessuna categoria (p.es. con l'argomento opzionale cats=intervallo[,intervallo,...],
verranno visualizzati tutti i valori e le etichette di categoria per il named
tematismo raster che si trovano nella mappa. L'intera mappa viene
letta con r.describe, per determinare
quali categorie sono presenti nella mappa. Se viene specificato un
elenco di categorie, verranno visualizzate solo le etichette di quelle categorie.
L'argomento cats può essere definito come singoli valori di
categoria, o come intervalli di valori. L'utente può anche definire
(opzionalmente) un separatore di campo, oltre spazio o tab, per separare il
valore di categoria dalla corrispondente etichetta nell'output, usando l'opzione
fs=carattere|space|tab (si veda l'esempio
più avanti). Se non viene specificato dall'utente nessun separatore di
campo, verrà usato in modo predefinito un segno di tabulazione per
separare questi campi nell'output.
L'output è inviato allo standard output nella forma di una categoria per riga,
col valore di categoria all'inizio della riga, poi un carattere ASCII TAB (o
o qualsiasi altro carattere singolo definito col parametro fs),
poi l'etichetta per la categoria.
NOTE
I caratteri ASCII TAB che si dovessero trovare nell'etichetta sono sostituiti da spazi.
L'output proveniente da r.category può essere ridirezionato
in un file, o passato ad un altro programma tramite una pipe [ | ].
Input da un file
L'opzione rules permette agli utenti di assegnare etichette di categoria
[a partire] da valori che si trovano in un file. L'etichetta può riferirsi a una
singola categoria, a un intervallo di categorie, a valori a virgola mobile o a
intervalli di valori a virgola mobile. Il formato è dato nel seguente modo:
cat:Label
val1:val2:Label
Se il nome di file è indicato con "-", le etichette di categoria vengono
lette dallo stdin
Etichette di categoria predefinite e dinamiche
Etichette di categoria predefinite e dinamiche possono essere create per le
categorie che non sono etichettate in modo esplicito.
La riga del coefficiente può essere seguita da etichette di categoria
esplicite, che hanno la precedenza sulla generazione dell'etichetta dal formato.
0:no data
2: .
5: . ## etichette di categoria esplicite
7: .
le etichette esplicite possono essere anche nella forma:
5.5:5:9 descrizione dell'etichetta
or
15:30 descrizione dell'etichetta
Nella riga del formato
- $1 si riferisce al valore num*5.0+1000 (cioè, usando i primi 2
coefficienti)
- $2 si riferisce al valore num*5.0+1005 (cioè, usando gli ultimi 2
coefficienti)
$1.2 mostrerà $1 seguito da 2 decimali.
Inoltre, la forma $?xxx$yyy$ restituisce yyy se la categoria è 1,
xxx in caso contrario; $yyy$ è opzionale. Così
$1 meter$?s
diventa: 1 meter (per la categoria 1)
2 meters (per la categoria 2), etc.
format='Elevation: $1.2 to $2.2 feet' ## Espressione del formato
coefficients="5.0,1000,5.0,1005" ## Coefficienti
Le righe relative al formato e ai coefficienti saranno usate per generare la
seguente espressione per la creazione della stringa di formattazione appropriata
per la categoria "num":
sprintf(buff,"Elevation: %.2f to %.2f feet", num*5.0+1000, num*5.0*1005)
Note: poichè le righe del formato e del coefficiente devono essere
presenti entrambe, una riga vuota per la stringa del formato
sopprimerà completamente la generazione automatica
dell'etichetta.
Per inserire nell'etichetta un [segno] "$" senza avviare il
riconoscimento della forma plurale, si deve mettere"$$" nella stringa del formato.
Quando si inserisce un segno "$" da riga di comando si devono usare
gli apici singoli, per evitare sostituzioni non desiderate da parte della
shell.
ESEMPI
-
-
visualizza i valori e le etichette associate di tutte le categorie
presenti nel tematismo raster soils;
r.category map=soils cats=10,12,15-20
-
visualizza solo i valori e le etichette di categoria 10, 12, e
da 15 a 20 per le categorie del tematismo soils;
r.category map=soils cats=10,20 fs=':'
-
visualizza i valori e le etichette 10 e 20 per le categorie
del tematismo soils, e usa ":" (al posto di un segno di
tabulazione) come carattere separatore dei valori di categoria dai valori
[dalle etichette] di categoria nell'output.
- Esempio di output:
-
10:Dumps, mine, Cc
20:Kyle clay, KaA
- Esempio di definizione delle etichette di categoria:
r.category diseasemap rules=- << EOF
1:potential absence
2:potential presence
EOF
-
imposta i valori di categoria 1 e 2 alle rispettive etichette di testo.
DA FARE
Respect the fs= field separator setting for input rules.
VEDI ANCHE
Le voci del manuale di UNIX per awk e sort
r.coin,
r.describe,
d.what.rast,
r.support
AUTORI
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory
Hamish Bowman, University of Otago, New Zealand (label creation options)
Last changed: $Date: 2009-02-27 04:00:29 +0100 (Fri, 27 Feb 2009) $
Main index - raster index - Full index
© 2003-2011 GRASS Development Team