GRASS logo

NOME

r.average - Trova la media dei valori in una mappa di copertura all'interno di aree che hanno lo stesso valore di categoria in una mappa di base definita dall'utente.

PAROLE CHIAVE

raster, statistiche

SINOSSI

r.average
r.average help
r.average [-c] base=nome cover=nome output=nome [--overwrite] [--verbose] [--quiet]

Flag:

-c
Esegue i calcoli sui valori estratti dalle etichette di categoria della mappa di copertura
--overwrite
Sovrascrive i file esistenti
--verbose
Output verboso del modulo
--quiet
Output quieto del modulo

Parametri:

base=nome
Nome della mappa raster di base
cover=nome
Nome della mappa raster di copertura
output=nome
Nome della mappa raster di output

DESCRIZIONE

r.average calcola il valore medio dei dati contenuti in un tematismo raster cover, su aree corrispondenti alle categorie del tematismo raster base definito dall'utente. Questi valori mediati sono archiviati nel file delle etichette delle categorie associato a un nuovo tematismo output. I valori da mediare sono letti da un tematismo cover definito dall'utente. Verranno mediati i valori di categoria della mappa cover, a meno che non venga impostato il flag -c. Se viene impostato il flag -c, verranno mediati invece i valori che appaiono nel file delle etichette di categoria della mappa cover (si veda l'esempio seguente).

La mappa output è in realtà una riclassificazione della mappa base (si veda r.reclass), e avrà esattamente gli stessi valori di categoria della mappa base. I valori mediati calcolati con r.average vengono archiviati nel file delle etichette di categoria della mappa output. La mappa base=mappa è un tematismo raster esistente contenuto nel percorso di ricerca del mapset corrente dell'utente. Per ogni gruppo di celle della mappa base aventi il medesimo valore di categoria, verranno mediati i valori assegnati alle stesse celle nella mappa cover. La mappa cover è un tematismo raster esistente contenente i valori (nella forma di valori di categoria della cella o etichette di categoria della cella) da mediare all'interno di ogni categoria della mappa base.

NOTE

L'opzione -c richiede che l'etichetta di categoria per ogni categoria nella mappa cover sia un numero valido, intero o decimale. Per l'esattezza, se la prima voce nell'etichetta è numerica, viene usato quel valore; altrimenti viene usato zero. La tavola seguente contempla tutti i casi possibili:

         etichetta    valore 
         di categoria usato da -c 
         ______________________
          .12           .12 
          .80 KF        .8 
          no data       0 

(Questo flag è molto simile all'operatore @ di r.mapcalc, per cui si consiglia all'utente di leggere la pagina di manuale di r.mapcalc per vedere come si comporta in questo caso).

L'utente dovrebbe utilizzare il risultato di r.average con attenzione. Poiché questa utilità assegna un valore a ogni cella che è basato su un'informazione globale (cioè, informazione a livello di location spaziale piuttosto che solo la location della cella stessa), il tematismo risultante è valido solo se le impostazioni della regione geografica e della maschera sono le stesse di quelle esistenti al momento della creazione della mappa stessa.

I risultati sono influenzati dalle impostazioni della regione e della maschera.

ESEMPIO

Supponendo che farms sia una mappa con 7 aziende agricole (cioè 7 categorie), e che soils.Kfactor sia una mappa di valori del fattore K del suolo avente il seguente file delle categorie:
        cat     cat 
        value   label 
        0       no soil data 
        1       .10 
        2       .15 
        3       .17 
        4       .20 
        5       .24 
        6       .28 
        7       .32 
        8       .37 
        9       .43 
Il comando

r.average -c base=farms cover=soils.Kfactor output=K.by.farm
calcolerà il fattore K medio per ogni azienda, e memorizzerà i risultati nella mappa di output K.by.farm, che sarà una riclassificazione di farms con le etichette di categoria come illustrato qui sotto (solo un esempio):
        cat     cat 
        value   label 
        1       .1023 
        2       .1532 
        3       .172 
        4       .3872 
        5       .003 
        6       .28 
        7       .2345 

VEDI ANCHE

g.region, r.category, r.clump, r.describe, r.mapcalc, r.mfilter, r.mode, r.neighbors, r.reclass, r.statistics, r.stats

AUTORE

Michael Shapiro, U.S. Army Construction Engineering Research Laboratory

Last changed: $Date: 2008-05-16 21:09:06 +0200 (Fri, 16 May 2008) $


Main index - raster index - Full index

© 2003-2011 GRASS Development Team