Semivariogramm-Sensitivität (Geostatistical Analyst)

Mit der Geostatistical Analyst-Lizenz verfügbar.

Zusammenfassung

Dieses Werkzeug führt eine Sensitivitätsanalyse an den vorhergesagten Werten und zugehörigen Standardfehlern durch, in dem die Semivariogramm-Parameter (Nugget, Partial Sill und Hauptbereich/Nebenbereich) des Modells innerhalb eines bestimmten Prozentsatzes der ursprünglichen Werte verändert werden.

Als Quelle beim Füllen der Anfangswerte dieser Parameter (Nugget, Partial Sill und Hauptbereich/Nebenbereich) verwendet das Werkzeug ein geostatistisches Modell. Die Ausgabe des Werkzeugs ist eine Tabelle, in der angegeben wird, welche Parameterwerte verwendet wurden und welche vorhergesagten Werte und Standardfehler das Ergebnis waren. Wenn bei kleinen Änderungen in den Parameterwerten des Modells große Schwankungen in der Ausgabe auftreten, dann können Sie nicht allzu großes Vertrauen in die statistische Sicherheit (Konfidenz) der Ausgabe setzen. Wenn dagegen die Änderungen in der Ausgabe klein sind, dann können Sie den Vorhersagen des Modells vertrauen und Entscheidungen treffen, die auf dessen Ausgabe basieren.

Verwendung

  • Die geostatistische Modellquelle ist entweder ein geostatistischer Layer oder ein geostatistisches Modell (XML).

  • In der Ausgabetabelle entspricht PtID dem OID-Wert in der Feature-Class für Eingabe-Beobachterpunktpositionen, und im Feld RndParam wird angegeben, welcher Semivariogramm-Parameter nach dem Zufallsprinzip geändert wurde.

  • Dieses Werkzeug verwendet bei der Ausführung einen Zufallszahlengenerator. Der verwendete Startwert lässt sich in der Umgebung des Zufallszahlengenerators ändern.

    • Wenn der Startwert 0 (der Standardwert) verwendet wird, dann werden bei jeder Ausführung des Werkzeugs andere Zufallszahlen verwendet, mit denen eine andere Ausgabe generiert wird.
    • Wenn der Zufallszahlen-Startwert auf eine feste Zahl größer als 0 festgelegt ist, erzeugt das Werkzeug bei jeder Ausführung dieselbe Ausgabe, bis der Startwert geändert wird.

    Hinweis:

    Es wird nur der Zufallszahlengenerator vom Typ Mersenne Twister unterstützt; wenn ACM599 – Sammelalgorithmus oder Standard C Rand ausgewählt wird, wird stattdessen Mersenne Twister verwendet.

  • Bei der Python-Skripterstellung wird die ArcPy-Klasse GeostatisticalDatasets zum Füllen des Parameters Eingabe-Dataset(s) verwendet.

  • Für Datenformate, die NULL-Werte unterstützen, z. B. Feature-Classes in File-Geodatabases, wird ein NULL-Wert verwendet, um anzugeben, dass für den Standort keine Vorhersage erstellt werden konnte oder dass der angezeigte Wert bei der Verwendung als Eingabe ignoriert werden soll. Für Datenformate, die NULL-Werte nicht unterstützen, z. B. Shapefiles, wird der Wert -1,7976931348623158e+308 (der negative Wert der in C++ definierten Konstanten DBL_MAX) verwendet, um anzugeben, dass für diese Position keine Vorhersage erstellt werden konnte.

Parameter

BeschriftungErläuterungDatentyp
Geostatistische Eingabe-Modellquelle

Die Quelle des geostatistischen Modells, das analysiert werden soll.

File; Geostatistical Layer
Eingabe-Dataset(s)

Der Name des Eingabe-Datasets und die Feldnamen, die für die Erstellung des Ausgabe-Layers verwendet wurden.

Geostatistical Value Table
Eingabe-Beobachterpunktpositionen

Punktpositionen, an denen die Sensitivitätsanalyse durchgeführt wird.

Feature Layer
Nugget-Spanne (% des Modellwertes)
(optional)

Prozentsatz des Parameters "Nugget", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Nugget" zu erstellen.

Double
Anzahl von Berechnungen für Nugget
(optional)

Anzahl der Werte von "Nugget", die in der Nugget-Spanne nach dem Zufallsprinzip erfasst werden.

Long
Partial-Sill-Spanne (% des Modellwertes)
(optional)

Prozentsatz des Parameters "Partial Sill", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Partial Sill" zu erstellen.

Double
Anzahl von Berechnungen für Partial Sill
(optional)

Anzahl der Werte von "Partial Sill", die in der Partial-Sill-Spanne nach dem Zufallsprinzip erfasst werden.

Long
Hauptbereichsspanne (% des Modellwertes)
(optional)

Prozentsatz des Parameters "Hauptbereich", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Hauptbereich" zu erstellen.

Double
Anzahl von Berechnungen für den Hauptbereich
(optional)

Anzahl der Werte von "Hauptbereich", die in der Hauptbereichsspanne nach dem Zufallsprinzip erfasst werden.

Long
Nebenbereichsspanne (% des Modellwertes)
(optional)

Prozentsatz des Parameters "Nebenbereich", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Nebenbereich" zu erstellen.

Double
Anzahl von Berechnungen für den Nebenbereich
(optional)

Anzahl der Werte von "Nebenbereich", die in der Nebenbereichsspanne nach dem Zufallsprinzip erfasst werden.

Wenn die Anisotropie in der geostatistischen Eingabe-Modellquelle festgelegt wurde, ist ein Wert erforderlich.

Long
Ausgabetabelle

Tabelle zum Speichern der Ergebnisse der Sensitivitätsanalyse.

Table

arcpy.ga.GASemivariogramSensitivity(in_ga_model_source, in_datasets, in_locations, {nugget_span_percents}, {nugget_calc_times}, {partialsill_span_percents}, {partialsill_calc_times}, {range_span_percents}, {range_calc_times}, {minrange_span_percents}, {minrange_calc_times}, out_table)
NameErläuterungDatentyp
in_ga_model_source

Die Quelle des geostatistischen Modells, das analysiert werden soll.

File; Geostatistical Layer
in_datasets

Ein GeostatisticalDatasets-Objekt.

Alternativ kann dies eine Folge von durch Semikolon getrennten Elementen sein. Dabei besteht jedes Element aus folgenden Komponenten:

  • Dem Katalogpfad und dem Namen des Datasets oder dem Namen eines Layers im aktuellen Inhaltsverzeichnis gefolgt von einem Leerzeichen.
  • Einer Folge von Feldnamen, wobei die einzelnen Namen durch Leerzeichen getrennt sind. Wenn es sich um Raster handelt, werden die Zellenwerte verwendet.
Geostatistical Value Table
in_locations

Punktpositionen, an denen die Sensitivitätsanalyse durchgeführt wird.

Feature Layer
nugget_span_percents
(optional)

Prozentsatz des Parameters "Nugget", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Nugget" zu erstellen.

Double
nugget_calc_times
(optional)

Anzahl der Werte von "Nugget", die in der Nugget-Spanne nach dem Zufallsprinzip erfasst werden.

Long
partialsill_span_percents
(optional)

Prozentsatz des Parameters "Partial Sill", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Partial Sill" zu erstellen.

Double
partialsill_calc_times
(optional)

Anzahl der Werte von "Partial Sill", die in der Partial-Sill-Spanne nach dem Zufallsprinzip erfasst werden.

Long
range_span_percents
(optional)

Prozentsatz des Parameters "Hauptbereich", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Hauptbereich" zu erstellen.

Double
range_calc_times
(optional)

Anzahl der Werte von "Hauptbereich", die in der Hauptbereichsspanne nach dem Zufallsprinzip erfasst werden.

Long
minrange_span_percents
(optional)

Prozentsatz des Parameters "Nebenbereich", der verwendet werden soll, um durch Subtraktion und Addition einen Bereich um diesen Parameter für eine nachfolgende Zufallsauswahl des Parameters "Nebenbereich" zu erstellen.

Double
minrange_calc_times
(optional)

Anzahl der Werte von "Nebenbereich", die in der Nebenbereichsspanne nach dem Zufallsprinzip erfasst werden.

Wenn die Anisotropie in der geostatistischen Eingabe-Modellquelle festgelegt wurde, ist ein Wert erforderlich.

Long
out_table

Tabelle zum Speichern der Ergebnisse der Sensitivitätsanalyse.

Table

Codebeispiel

SemivariogramSensitivity – Beispiel 1 (Python-Fenster)

Führt durch Variieren der Werte von "Nugget", "Partial Sill" und "Bereich" eine Sensitivitätsanalyse durch.

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.GASemivariogramSensitivity_ga(
    "C:/gapyexamples/data/kriging.lyr", "C:/gapyexamples/data/ca_ozone_pts.shp OZONE",
    "C:/gapyexamples/data/obs_pts.shp", "", "", "", "", "", "", "", "", 
    "C:/gapyexamples/output/outtabSS")
SemivariogramSensitivity – Beispiel 2 (eigenständiges Skript)

Führt durch Variieren der Werte von "Nugget", "Partial Sill" und "Bereich" eine Sensitivitätsanalyse durch.

# Name: SemivariogramSensitivity_Example_02.py
# Description: The semivariogram parameters Nugget, Partial Sill and Range can
#   be varied to perform a sensitivity analysis.
# Requirements: Geostatistical Analyst Extension

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"

# Set local variables
inLayer = "C:/gapyexamples/data/kriging.lyr"
inData = "C:/gapyexamples/data/ca_ozone_pts.shp OZONE"
inObs = "C:/gapyexamples/data/obs_pts.shp"
nugPercents = ""
nugCalc = ""
sillPercents = ""
sillCalc = ""
rangePercents = ""
rangeClac = ""
minrangePercent = ""
midrangeCalc = ""
outTable = "C:/gapyexamples/output/outtabSS"

# Execute SemivariogramSensitivity
arcpy.GASemivariogramSensitivity_ga(inLayer, inData, inObs, nugPercents, nugCalc,
                                    sillPercents, sillCalc, rangePercents, rangeClac,
                                    minrangePercent, midrangeCalc, outTable)

Lizenzinformationen

  • Basic: Erfordert Geostatistical Analyst
  • Standard: Erfordert Geostatistical Analyst
  • Advanced: Erfordert Geostatistical Analyst

Verwandte Themen