GRASS logo

NOME

r.coin - Riporta in forma tabellare le reciproche occorrenze (coincidenze) delle categorie di due tematismi raster.

PAROLE CHIAVE

raster, statistiche

SINOSSI

r.coin
r.coin help
r.coin [-w] map1=string map2=string units=string [--verbose] [--quiet]

Flag:

-w
Rapporto esteso, 132 colonne (predefinito: 80)
--verbose
Output verboso del modulo
--quiet
Output quieto del modulo

Parametri:

map1=string
Nome della prima mappa raster
map2=string
Nome della seconda mappa raster
units=string
Unità di misura
c(celle), p(percentuale), x(percentuale di categoria [colonna]), y(percentuale di categoria [riga]), a(acri), h(ettari), k(chilometri quadrati), m(miglia quadrate)
Opzioni: c,p,x,y,a,h,k,m

DESCRIZIONE

r.coin riporta in forma tabellare le reciproche occorrenze delle categorie di due tematismi, mettendo in relazione le categorie di un tematismo con quelle dell'altro. Questo programma di analisi rispetta le impostazioni della regione geografica corrente e della maschera.

r.coin riporta sotto forma di tabulato la coincidenza di valori di categoria fra i due tematismi raster, e prepara la tabella base dalla quale sarà creato il rapporto. Questa tabulazione è seguita da un'indicazione sulla lunghezza della tabella delle coincidenze. Se la tabella è estremamente lunga, l'utente può decidere che vederla non è poi così importante, e a questo punto può annullare la richiesta. Nel caso che l'utente continui, r.coin dà all'utente la possibilità di scegliere una delle sei unità di misura nelle quali possono essere espressi i risultati del rapporto. Queste unità sono:

c
celle
p
percentuale di regione coperta
x
percentuale sulla categoria di <nome mappa> (colonna)
y
percentuale sulla categoria di <nome mappa> (riga)
a
acri
h
ettari
k
chilometri quadrati
m
miglia quadrate

Si noti che tre di queste opzioni rappresentano i risultati come valori percentuali: "p" si basa sulla somma complessiva del numero delle celle; "x" si basa sul totale delle sole colonne, e "y" si basa sul totale delle sole righe. Per l'output del rapporto è possibile selezionare solo un'unità di misura. È sufficiente immettere una delle lettere che designa un'unità di misura seguito da <RETURN>. Il rapporto sarà visualizzato sullo schermo per poter essere esaminato. Dopo aver esaminato il rapporto sullo schermo, l'utente ha a disposizione diverse opzioni. Il rapporto può essere salvato in un file o inviato a una stampante. Se dev'essere stampato, può essere stampato sia con 80 che con 132 colonne. Infine, l'utente può scegliere l'opzione di rigenerare la tabella delle coincidenze usando una diversa unità di misura.

NOTE

Non è una buona idea eseguire r.coin su un tematismo raster che ha un numero di categorie molto elevato (p.es. eltimetria non riclassificata). Siccome r.coin fornisce informazioni per ogni categoria, e per tutte le categorie, è meglio prima riclassificare quelle categorie (con r.reclass) in un numero più gestibile, e poi eseguire r.coin sul tematismo raster riclassificato.

ESEMPIO

Più avanti c'è un esempio di output sotto forma di tabulato prodotto da r.coin. Qui, l'output della mappa è espresso in miglia quadrate. Il rapporto contiene un tabulato delle coincidenze per le categorie dei tematismi raster owner e road della base di dati geografici di esempio Spearfish. Le categorie della mappa owner si riferiscono in questo caso ai terreni di proprietà privata (categoria 1) o di proprietà dell'U.S. Forest Service (categoria 2). Le categorie del tematismo roads si riferiscono ai diversi tipi di strade (ad eccezione del valore di categoria "0", che indica "assenza di dati", cioè parti della mappa in cui non ci sono strade). r.coin non riporta etichette di categoria. Per ottenere quest'informazione l'utente dovrebbe eseguire r.report o r.category.

Il corpo del rapporto è organizzato in pannelli. Il tematismo con la maggior parte delle categorie è disposto lungo l'asse verticale della tabella; l'altro lungo l'asse orizzontale. Ogni pannello ha un massimo di 5 categorie (9 se stampate) nella parte alta. In aggiunta, le ultime due colonne contengono il totale delle colonne per ogni riga. Tutte le categorie del tematismo disposte lungo l'asse verticale sono presenti in ogni pannello. In fondo ad ogni colonna c'è un totale, che rappresenta la somma di tutte le righe in quella colonna. Un secondo totale rappresenta la somma di tutte le righe delle categorie diverse da zero. In un pannelloo separato compare il totale di tutte le colonne per ogni riga (Table Row Total).

Notare come le seguenti informazioni possono essere ottenute dal rapporto di esempio.

Nella base di dati Spearfish, nelle aree non di proprietà del Forest Service, ci sono 50.63 miglia quadrate di terreni non utilizzati per le strade. Le strade in quest'area occupano 9.27 miglia quadrate.

Del totale di 102.70 miglia quadrate in Spearfish, 42.80 miglia quadrate sono di proprietà del Forest Service.
In totale ci sono 14.58 miglia quadrate di strade.

Nella categoria 2 ci sono più strade al di fuori dei terreni del Forest Service (2.92 mi2) che all'interno dei suoi confini (0.72 mi2).

Quello che segue è un rapporto di esempio.

+------------------------------------------------------------+
|                    COINCIDENCE TABULATION REPORT           |
|------------------------------------------------------------|
|Location: spearfish    Mapset: PERMANENT   Date: Wed Jun 1  |
|                                                            |
| Layer 1: owner          -- Ownership                       |
| Layer 2: roads          -- Roads                           |
| Mask:    none                                              |
|                                                            |
| Units:   square miles                                      |
|------------------------------------------------------------|
| Window:                North: 4928000.00                   |
|          West: 590000.00               East: 609000.00     |
|                        South: 4914000.00                   |
+------------------------------------------------------------+

Panel #1 of 1
+--------------------------------------------------------+
|        | owner                 |    Panel Row Total    |
|   cat# |         1 |         2 |   w cat 0 | w/o cat 0 |
|--------------------------------------------------------|
|r     0 |     50.63 |     37.49 |     88.12 |     88.12 |
|o     1 |      1.53 |      0.68 |      2.21 |      2.21 |
|a     2 |      2.92 |      0.72 |      3.64 |      3.64 |
|d     3 |      3.97 |      2.57 |      6.54 |      6.54 |
|s     4 |      0.65 |      1.36 |      2.00 |      2.00 |
|      5 |      0.19 |      0.00 |      0.19 |      0.19 |
|--------------------------------------------------------|
|Total   |           |           |           |           |
|with 0  |     59.90 |     42.80 |    102.70 |    102.70 |
|--------------------------------------------------------|
|w/o 0   |      9.27 |      5.32 |     14.58 |     14.58 |
+--------------------------------------------------------+


+--------------------------------+
|        |    Table Row Total    |
|   cat# |   w cat 0 | w/o cat 0 |
|--------------------------------|
|r     0 |     88.12 |     88.12 |
|o     1 |      2.21 |      2.21 |
|a     2 |      3.64 |      3.64 |
|d     3 |      6.54 |      6.54 |
|s     4 |      2.00 |      2.00 |
|      5 |      0.19 |      0.19 |
|--------------------------------|
|Total   |           |           |
|with 0  |    102.70 |    102.70 |
|--------------------------------|
|w/o 0   |     14.58 |     14.58 |
+--------------------------------+

r.coin calcola la coincidenza di due tematismi raster. Anche se r.coin consente all'utente di rigenerare il rapporto usando diverse unità, non è possibile rigenerare il rapporto con tematismi diversi. Per scegliere un nuovo tematismo è necessario rieseguire r.coin.

VEDI ANCHE

g.region, r.category, r.describe, r.reclass, r.report, r.stats

AUTORI

Michael O'Shea,
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