GRASS logo

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.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

r.category map=soils
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