Focal Statistics function

Calculates statistics on the cells within a neighborhood around each cell of an input raster. Several shapes of neighborhood are available.

Note

Se il raster di input è di tipo virgola mobile, sono disponibili solo i tipi statistici Media, Massimo, Mediana, Minimo, Percentile, Intervallo, Deviazione standard e Somma.

Quando viene specificato un intorno circolare, a forma di anello o a forma di cuneo, alcune delle celle diagonali esterne potrebbero non essere considerate nei calcoli poiché il centro della cella deve essere compreso all'interno dell'intorno.

Le celle NoData di input possono ricevere un valore nell'output se l'opzione Ignora NoData nei calcoli è selezionata, a condizione che almeno una cella all'interno dell'intorno abbia un valore valido.

Per ulteriori informazioni su questa funzione, consultare l'argomentoCome funzionano le statistiche focali.

Parametri

Nome Parametro	Descrizione
Raster (Obbligatorio)	Il raster di input.
Vicinato	La forma dell'area intorno a ciascuna cella utilizzata per calcolare le statistiche. Ogni intorno ha dai parametri aggiuntivi con i quali è possibile definire la forma. Rettangolo, Larghezza, Altezza Un intorno rettangolare definito dalla larghezza e dall'altezza. Il valore minimo per la larghezza o l'altezza è di 1 cella e il valore massimo è di 4096 celle. L'opzione predefinita è un quadrato con una larghezza e un'altezza di tre celle. Cerchio, Raggio Un intorno circolare con il dato raggio. Il valore minimo del raggio è di 1 cella e il massimo è di 2047 celle. Il raggio predefinito è di tre celle. Corona circolare, Raggio interno, Raggio esterno Un quartiere a forma di anello o di ciambella definito da un raggio interno e da un raggio esterno. Il valore minimo del raggio è di 1 cella e il raggio esterno deve essere più grande di quello interno. Il raggio interno massimo è di 2046 celle e il raggio esterno massimo è di 2047 celle. La corona circolare predefinita ha un raggio interno di una cella e uno esterno di tre celle. Spicchio, Raggio, Angolo iniziale, Angolo finale Un intorno a forma di spicchio definito dal raggio, l'angolo iniziale e l'angolo finale. Il valore minimo del raggio è di 1 cella e il massimo è di 2047 celle. Lo spicchio si estende in senso antiorario dall'angolo iniziale verso l'angolo finale. Gli angoli sono specificati in gradi, con 0 o 360 che rappresenta l'est. Non possono essere utilizzati angoli negativi. Lo spicchio predefinito va da 0 a 90 gradi, con un raggio di tre celle. Irregolare, Larghezza, Altezza, Valori di intorno L'intorno irregolare consente di specificare un intorno con una forma irregolare, o kernel, attorno alla cella di elaborazione. Utilizzare la tabella dei valori di intorno per definire la forma del kernel. Un valore di 1 indica che la sua cella corrispondente (e valore) fa parte del quartiere. Utilizzare un valore di 0 per escludere una cella dall'elaborazione. Il valore minimo per la larghezza o l'altezza del kernel è di 1 cella e il valore massimo è di 4096 celle. Peso, Larghezza, Altezza, Valori di intorno L'intorno di ponderazione è simile al tipo di intorno irregolare, poiché consente di definire un intorno irregolare attorno alla cella di elaborazione, ma inoltre consente di applicare delle ponderazioni ai valori di input. I valori nei kernel ponderati specificano quali sono le posizioni delle celle da includere nell'intorno e quali sono le ponderazioni per le quali dovrebbero essere moltiplicate. Utilizzare un valore di 0 per escludere una cella dall'elaborazione. I valori decimali sono validi per l'utilizzo come peso. Il valore minimo per la larghezza o l'altezza del kernel è di 1 cella e il valore massimo è di 4096 celle. Nota: Per il tipo di quartiere ponderato, sono supportate solo le statistiche Media, Deviazione standard e Somma.
Tipo statistiche	Specifica il tipo di statistica da calcolare. Media: calcola la media (valore medio) delle celle nel vicinato. Maggioranza: determina la maggioranza (il valore che si verifica più spesso) delle celle nel vicinato. Massimo: determina il massimo (valore più elevato) delle celle nel vicinato. Mediana: calcola la mediana delle celle nel vicinato. La mediana è equivalente al 50mo percentile. Minimo: determina il minimo (valore più piccolo) delle celle nel vicinato. Minoranza: determina la minoranza (valore che si verifica meno spesso) delle celle nel vicinato. Percentile: calcola un percentile delle celle nel vicinato. Quando questo tipo di statistica viene selezionato, diventa disponibile un nuovo parametro di Valore percentile, con il quale è possibile determinare il percentile da calcolare. Intervallo: determina l'intervallo (differenza tra il valore più grande e più piccolo) delle celle nel vicinato. Deviazione standard: calcola la deviazione standard delle celle nel vicinato. Somma: calcola la somma (totale di tutti i valori) delle celle nel vicinato. Varietà: determina la varietà (il numero di valori univoci) delle celle nel vicinato. Il tipo di statistica predefinito è Medio. Se il raster di input è una virgola mobile, sono disponibili solo i tipi statistici Medio, Massimo, Mediano, Minimo, Percentile, Intervallo, Deviazione Standard e Somma. Per Medio, Mediano, Percentile e Deviazione Standard, l'output sarà sempre una virgola mobile. Per Maggioranza e Minoranza, se si verifica un pareggio tra i valori con la frequenza più alta (maggioranza) o più bassa (minoranza) nel vicinato, la posizione della cella in elaborazione riceverà il più basso dei valori in pareggio. Se il valore della stessa cella in elaborazione è uno dei pareggi, verrà invece restituito tale valore.
Ignora NoData nei calcoli	Specifica se i valori NoData devono essere ignorati nel calcolo delle statistiche. Selezionato: se si presenta un valore NoData in un vicinato, il valore verrà ignorato. Solo le celle all'interno del quartiere che hanno valori di dati verranno utilizzati per determinare il valore di output. Si tratta dell'impostazione predefinita. Non selezionato: se una cella in un vicinato presenta un valore di NoData, l'output della cella di elaborazione sarà NoData.
Valore percentile	Specifica quale percentile calcolare quando Percentile è selezionato come tipo di statistica. Il valore predefinito è 90 per il 90esimo percentile. I valori possono spaziare da 0 a 100. Il percentile numero 0 è essenzialmente l'equivalente della statistica Minimo, e il percentile numero 100 è l'equivalente della statistica Massimo, fatta eccezione per il fatto che il risultato sarà una virgola mobile. Un valore di 50 produrrà essenzialmente lo stesso risultato di una statistica media.

File kernel

Per gli intorni Irregolare e Ponderato è possibile salvare un kernel personalizzato come file di testo per l'uso successivo.

Dopo aver specificato la larghezza e l'altezza e aver inserito i valori dell'intorno, utilizzare il pulsante Salva come per esportarlo come file di testo ASCII tramite la finestra di dialogo Salva file kernel di intorno. Utilizzare il pulsante Cerca per aprire la finestra di dialogo File kernel intorno di input per cercare e specificare un file kernel esistente da caricare.

La prima riga nel file kernel registra la larghezza e l'altezza dell'intorno kernel in numero di celle. Le righe successive indicano il modo in cui il valore di input che corrisponde a tale posizione verrà elaborato.

Un valore di 0 nel file kernel per il tipo di intorno irregolare o ponderato indica che la posizione corrispondente non verrà inclusa nel calcolo. Per l'intorno irregolare, un valore di 1 nel file kernel indica che la cella di input corrispondente verrà inclusa nell'operazione. Per l'intorno ponderato, il valore in ciascuna posizione indica il fattore di moltiplicazione applicato al valore della cella di input corrispondente. I valori positivi, negativi e decimali rappresentano opzioni valide da usare come ponderazioni.