[GRASS-translations] [Italiano] Grass manual: r.category italian translation

[Marco Curreli]

Ho tradotto la pagina di manuale di Grass r.category

Ciao,
   Marco

********************************************************************

DESCRIZIONE
r.category visualizza sullo standard output i valori e le etichette
delle categorie per il tematismo raster definito da map=nome. 

 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 del 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
   o
   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
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: 2008-08-22 16:16:53 +0200 (Fri, 22 Aug 2008) $