[GRASS-translations] manpages italian translation: r.colors
Marco Curreli
marcocurreli at tiscali.it
Fri Nov 27 18:39:23 EST 2009
<h2>DESCRIZIONE</h2>
<i>r.colors</i> permette all'utente di creare o modificare la tavola dei
colori per un tematismo raster. Il tematismo (specificato sulla riga di
comando con <b>map=</b><i>name</i>) deve esistere nel percorso di
ricerca del mapset corrente. La tavola dei colori definita con
<b>color=</b><i>type</i> dev'essere una delle seguenti:
<pre>
color type description
-----------+----------------------------------------------------------
aspect toni di grigio per rappresentare le esposizioni
aspectcolr colori "rainbow" per rappresentare le esposizioni
bcyr dal blu al rosso passando per il ciano e il giallo
bgyr dal blu al rosso passando per il verde e il giallo
byg dal blu al verde passando per il giallo
byr dal blu al rosso passando per il giallo
celsius dal blu al rosso per rappresentare la temperatura
in gradi Celsius
curvature per rappresentare le curvature del terreno
(da v.surf.rst e r.slope.aspect)
differences colori per rappresentare differenze
elevation rappresenta campi di variazione relativi di valori
raster con un gradiente di colori in base
all'altitudine
etopo2 colori per il modello batimetrico/topografico globale ETOPO2
evi colori migliorati per l'indice di vegetazione
grey scala di grigi
grey1.0 scala di grigi per valori rasternell'intervallo 0.0-1.0
grey255 scala di grigi per valori raster nellintervallo 0-255
gyr dal verde al rosso passando per il giallo
ndvi colori per l'indice di vegetazione NDVI
(Normalized Difference Vegetation Index)
population color table covering human population classification breaks
rainbow tavola dei colori rainbow
ramp gradiente di colore
ryb dal rosso al blu passando per il giallo
ryg dal rosso al verde passando per il giallo
sepia dal bruno giallognolo al bianco
slope colori r.slope.aspect-type slope colors for raster values 0-90
srtm color palette for Shuttle Radar Topography Mission elevation
terrain global elevation color table covering -11000 to +8850m
wave color wave
random tavola di colori casuali
grey.eq scala di grigi con istogramma equalizzato
grey.log scala di grigi con istogramma trasformato logaritmicamente
rules crea una nuova tavola dei colori basandosi su regole
definite dall'utente lette dallo stdin
</pre>
<p>
L'opzione <b>rast</b> permette all'utente di specificare una mappa
raster <i>nome</i> dalla quale copiare la tavola dei colori..
<p>
Tutte le tavole dei colori sono memorizzate in $GISBASE/etc/colors/.
In questa directory possono essere memorizzate anche ulteriori tavole
dei colori definite dall'utente col parametro <em>color</em>.
<p>
Il flag <b>-e</b> equalizza la tavola dei colori del raster originale.
Se usato nella forma <b>-e color=</b><em>grey</em>, può rendere non
necessaria la regola <em>grey.eq</em>. Si noti comunque che questo non
produce una tavola dei colori identica a <em>color=grey.eq</em>,
perché <em>grey.eq</em> scala la frazione per 256 per ottenere un
livello di grigio, mentre <b>-e</b> la utilizza per interpolare la
tavola dei colori originale. Se la tavola dei colori originale è una
scala di grigi 0-255, <b>-e</b> scala effettivamente per 255. Vengono
usati algoritmi differenti. Il flag <b>-e</b> funziona con tutte le
tavole dei colori, sia che appartengano a mappe raster con valori
a virgola mobile, che mappe con valori interi.
<p>
Il flag <b>-g</b> divide il campo di variazione dei valori di grigio del
raster in 100 livelli discreti logaritmicamente uguali (dove "livello
discreto" è una regola che assegna lo stesso tono di grigio tra i
punti di inizio e di fine). Se usato nella forma
<b>-g color=</b><em>grey</em>, può rendere non necessaria la
regola <em>grey.log</em>. Si noti comunque che questo non produce una
tavola dei colori identica a <em>color=grey.log</em>. Vengono usati
algoritmi differenti. Diversamente da <b>color=</b><em>grey.log</em>,
<b>-g</b> è può essere usato sia coi raster con valori a
virgola mobile che con quelli con valori interi, senza problemi di
risultato con grandi dataset [serie di dati], di qualsiasi tavola dei
colori originale. Lo scaling logaritmico non funziona su valori negativi.
Nel caso in cui il campo di variazione include lo zero, non c'è
alcuna soluzione realistica.
<p>
I flag <b>-e</b> e <b>-g</b> non sono mutuamente esclusivi.
<p>
Se viene specificato dall'utente il flag <b>-w</b>, il file della tavola
dei colori corrente per la mappa di input non viene sovrascritto.
Ciò significa che la tavola dei colori viene creata solo se
<i>map</i> non ha già una tavola dei colori. Se non viene
specificata quest'opzione, verrà creata la tavola dei colori, se
non ne esiste una, o modicata una tavola esistente.
<p>
Se viene impostato dall'utente il flag <b>-q</b>, <i>r.colors</i> viene
eseguito "silenziosamente", senza mostrare sullo standard output i
numerosi messaggi sul suo stato d'avanzamento. <p>I tipi di tavola dei
colori <i>aspect, grey, grey.eq</i> (scala di grigi con istogramma
equalizzato), <i>byg</i> (blu-giallo-verde), <i>byr</i>(blu-giallo-rosso),
<i>gyr</i> (verde-giallo-rosso), <i>rainbow, ramp, ryg</i>
(rosso-giallo-verde), <i>random</i> e <i>wave</i> sono tavole dei colori
predefinite che <i>r.colors</i> è in grado di creare senza
ulteriori input.
<p>
In generale, le tavole che associano colori a percentuali (aspect, bcyr, byg,
byr, elevation, grey, gyr, rainbow, ramp, ryb, ryg e wave) possono essere
applicate a ogni tipo di dato, mentre quelle che usano valori assoluti
(aspectcolr, curvature, etopo2, evi, ndvi, population, slope, srtm e terrain)
vanno bene solo per dati con determinati campi di variazione.
Si può avere un'idea approssimativa di come applicare una tavola
dei colori leggendo il file della regola corrispondente
($GISBASE/etc/colors/<nome>). Per esempio, la regola <em>slope</em>
è definita come:
<div class="code"><pre>
0 255:255:255
2 255:255:0
5 0:255:0
10 0:255 255
15 0:0:255
30 255:0:255
50 255:0:0
90 0:0:0
</pre></div>
<p>
Questa regola è fatta per la mappa generata da r.slope.aspect,
dove il valore è un angolo di inclinazione compreso fra 0 e 90
gradi.
<p>
In modo simile, la regola <em>aspectcolr</em>:
<div class="code"><pre>
0 white
1 yellow
90 green
180 cyan
270 red
360 yellow
</pre></div>
<p>
è fatta per la mappa creata da r.slope.aspect, dove il valore
è un angolo di direzione compreso tra 0 e 360 gradi.
<p>
La tavola dei colori del tipo <i>rules</i> fa leggere a <i>r.colors</i>
le definizioni della tavola dei colori dallo standard input (stdin),
e crea di conseguenza la tavola dei colori.
<p>
Usando la tavola dei colori del tipo <i>rules</i>, ci sono <!--three-->
due modi di creare una tavola dei colori: <!--by color list,-->
in base a valori di categoria, e in base a valori percentuali.
<!-- HB: this causes an error in current code, maybe easy to enable functionality from old code??
<p>
Building a customized color table by color list is the simplest of the three
rules methods: just list the colors you wish to appear in the color table in the
order that you wish them to appear. Use the standard GRASS color names: white,
black, red, green, blue, yellow, magenta, cyan, aqua, grey, gray, orange, brown,
purple, violet, and indigo.
<p>
For example, to create a color table for the raster map layer <i>elevation</i>
that assigns greens to low map category values, browns to the next larger
map category values, and yellows to the still larger map category values,
one would type:
<div class="code"><pre>
<b>r.colors map=</b><i>elevation</i> <b>color=</b><i>rules</i>
green
brown
yellow
end
</pre></div>
-->
<p>
Per creare una tavola dei colori sulla base di indici di valori di
categoria, l'utente deve determinare il campo di variazione dei valori di
categoria nel tematismo raster col quale verrà utilizzata la tavola
dei colori. Determinati valori di categoria saranno associati a
determinati colori. Da notare che non è necessario assegnare un
colore ad ogni valore di categoria valido, perché <i>r.colors</i>
interpola un gradiente di colore per completare le categorie che sono
state escluse dalla definizione del colore. Il formato di tale definizione
è il seguente:
<div class="code"><pre>
valore_categoria nome_colore
valore_categoria nome_colore
.. ..
.. ..
valore_categoria nome_colore
end
</pre></div>
<p>
Ogni valore di categoria dev'essere valido per il tematismo raster, i
valori di categoria devono essere disposti in ordine crescente, e si
devono utilizzare solo nomi di colori standard di GRASS (vedi sopra).
<p>
I colori possono anche essere specificati con i numeri di codice del
colore, ognuno nel campo di variazione 0-255. Il formato di una
definizione della tavola dei colori per valori di categoria usando i
codici invece dei nomi del colore è la seguente:
<div class="code"><pre>
valore_categoria num_rosso:num_verde:num_blu
valore_categoria num_rosso:num_verde:num_blu
.. .. .. ..
.. .. .. ..
valore_categoria num_rosso:num_verde:num_blu
end
</pre></div>
<p>
Definendo una tavola dei colori in base a valori percentuali, una tavola
dei colori viene trattata come se fosse numerata da 0 a 100. Il formato
della definizione di questa tavola <!--dei colori in base a valori "percentuali"-->
è lo stesso di quello della definizione dei colori per valori di categoria,
con la differenza che i valori di categoria sono sostituiti da valori
percentuali, ognuno nel campo di variazione 0-100, in ordine crescente.
Il formato è il seguente:
<div class="code"><pre>
valore_percentuale% nome_colore
valore_percentuale% nome_colore
.. ..
.. ..
valore_percentuale% nome_colore
end
</pre></div>
<p>
Utilizzando le regole per la definizione della tavola dei colori in base a
valori percentuali, i colori possono essere specificati coi numeri di
codice del colore, ognuno nel campo di variazione 0-255. Il formato della
definizione di questa tavola <!--dei colori per i valori percentuali usando i
numeri del colore invece dei nomi del colore--> è il seguente:
<div class="code"><pre>
valore_percentuale% num_rosso:num_verde:num_blu
valore_percentuale% num_rosso:num_verde:num_blu
.. .. .. ..
.. .. .. ..
valore_percentuale% num_rosso:num_verde:num_blu
end
</pre></div>
<p>
Si noti che si possono anche combinare questi <!--three-->due metodi per
definire la tavola dei colori; per esempio:
<div class="code"><pre>
0 black
10% yellow
78 blue<!--\n magenta
purple
brown-->
100% 0:255:230
end
</pre></div>
<p>
Per impostare il colore per NULL (assenza di dati), si deve usare il parametro "nv":
<div class="code"><pre>
0 black
10% yellow
nv white
end
</pre></div>
<h2>ESEMPI</h2>
L'esempio che segue mostra come si possono definire i colori per una mappa
con tre categorie, assegnando il rosso per la categoria 1, il verde per la
categoria 2, e il blu per la categoria 3. Si inizia col creare, con un
editor di testo, il seguente file di definizione delle regole (salvarlo
col nome <i>rules.file</i>):
<div class="code"><pre>
1 red
2 green
3 blue
end
</pre></div>
<p>
La tavola dei colori può quindi essere assegnata alla mappa
<i>threecats</i> coi seguenti comandi di GRASS (si può fare in due
modi):
<div class="code"><pre>
# leggendo l'input da stdin
cat rules.file | r.colors map=threecats color=rules
# leggendo direttamente da file
r.colors map=threecats rules=rules.file
</pre></div>
<p><br>
Per creare una LUT (Look-Up Table) dall'aspetto naturale per un tematismo
<i>elevation</i>, utilizzare il seguente file di definizione delle regole.
Vengono assegnate sfumature di verde chiaro alle altitudini più basse
(il primo 20% della LUT), quindi toni di verde più scuro
(i successivi 15% e 20%) e toni di marrone chiaro (un altro 20%)
per elevazioni medie, toni di marrone scuro (altro 15%) per le elevazioni
maggiori, ed infine il giallo per le vette più alte (l'ultimo
10% della LUT).
<div class="code"><pre>
0% 0:230:0
20% 0:160:0
35% 50:130:0
55% 120:100:30
75% 120:130:40
90% 170:160:50
100% 255:255:100
</pre></div>
<h2>VEDI ANCHE</h2>
<em>
<a href="d.colors.html">d.colors</a>,
<a href="d.colortable.html">d.colortable</a>,
<a href="d.histogram.html">d.histogram</a>,
<a href="d.legend.html">d.legend</a>,
<a href="r.colors.stddev.html">r.colors.stddev</a>,
<a href="r.support.html">r.support</a>,
<a href="r.univar.html">r.univar</a>,
<a href="v.colors.html">v.colors</a>
</em>
<p>
<a href="http://colorbrewer.org">ColorBrewer</a> è uno strumento
online per aiutare a scegliere gli schemi di colore più adatti
per mappe e altre composizioni grafiche.
<h2>AUTORI</h2>
Michael Shapiro and David Johnson
<p>
<i>Last changed: $Date: 2008-12-04 11:43:15 +0100 (Thu, 04 Dec 2008) $</i>
<!-- Tradotto da Marco Curreli <marcocurreli at tiscali.it> marzo 2009-->
More information about the grass-translations
mailing list