3D-GA-Layer in multidimensionales Raster (Geostatistical Analyst Tools)

Zusammenfassung

Exportiert einen geostatistischen 3D-Layer, der mit dem Werkzeug Empirical Bayesian Kriging 3D erstellt wurde, in ein multidimensionales Raster-Dataset im Cloud-Raster-Format (*.crf-Datei). Die Werkzeuge im Toolset "Multidimensionale Analyse" in der Toolbox "Image Analyst" sind für die direkte Verwendung an multidimensionalen Rastern konzipiert und können die 3D-Eigenschaft der Daten erkennen.

Geostatistische Layer in 3D speichern kontinuierliche 3D-Interpolationsergebnisse und werden als horizontale 2D-Ausschnitte in einer bestimmten Höhe dargestellt. Wenn Sie mit dem Bereichsschieberegler die aktuelle Höhe ändern, werden im Layer die vorhergesagten Werte der neuen Höhe berechnet und dargestellt. Mit dem Werkzeug GA-Layer in Raster können Raster interpolierter Vorhersagen in jeder Höhe extrahiert werden. Das Werkzeug 3D-GA-Layer in multidimensionales Raster automatisiert die Extraktion der Raster in mehreren Höhen und speichert diese in einem multidimensionalen Raster-Dataset.

Verwendung

Der geostatistische 3D-Eingabe-Layer muss mit Empirical Bayesian Kriging 3D erstellt werden.
Zum Angeben der gewünschten Höhen haben Sie die folgenden Möglichkeiten:
- Provide elevation values using an iterator—Lassen Sie den Parameter Expliziten Höhenwert eingeben deaktiviert, und geben Sie die gewünschten Werte in den Parametern Minimale Höhe, Maximale Höhe und Höhenintervall ein. Die Iteration beginnt beim Minimum und erhöht bei jedem weiteren Durchlauf den Wert um das Intervall, bis das Maximum erreicht ist. Wenn Sie zum Beispiel als minimale Höhe den Wert 0, als Maximum den Wert 100 und als Intervall den Wert 20 angeben, dann enthält die Ausgabe sechs Höhen: 0, 20, 40, 60, 80 und 100.
- Provide explicit elevation values—Aktivieren Sie den Parameter Expliziten Höhenwert eingeben, und geben Sie die gewünschten Höhen im Parameter Höhenwerte ein.
Der Parameter Höheneinheiten gibt die Einheit jedes Höhenwertes an.
Wenn mit dem angegebenen Höhenintervall der Höhenbereich (Maximale Höhe minus Minimale Höhe) nicht gleichmäßig unterteilt werden kann, wird eine Höhe verwendet, die die maximale Höhe überschreitet. Wenn Sie zum Beispiel als minimale Höhe den Wert 10, als maximale Höhe den Wert 80 und als Höhenintervall den Wert 20 angeben, dann enthält die Ausgabe fünf Höhen: 10, 30, 50, 70 und 90.
Als Standard-Raster-Zellengröße des Parameters Multidimensionales Ausgabe-Raster-Dataset wird der kleinere der beiden Werte der Ausgabeausdehnung der X- und der Y-Dimension, dividiert durch 100, verwendet. Die Standardzahl der Höhenausschnitte beträgt 10. Damit wird ein multidimensionales Raster mit einer X- und Y-Auflösung, die mindestens 10 Mal größer als die Z-Auflösung ist, erstellt. Auf diese Werte sollten Sie insbesondere dann achten, wenn Sie mit ungefähr derselben Auflösung in allen drei Dimensionen arbeiten möchten. Wenn die Zellengröße oder die Anzahl der Höhenausschnitte erhöht wird, dann liegen die Ausgaben näher an derselben Auflösung in allen drei Dimensionen.
Die Ausführungszeit dieses Werkzeugs verhält sich in etwa proportional zur Anzahl der Vorhersagen, die insgesamt erforderlich sind. Außerdem muss für jede Raster-Zelle jeder Höhe ein vorhergesagter Wert berechnet werden. Standardmäßig ist die Ausführungszeit dieses Werkzeugs etwa 60 Prozent länger als beim Exportieren eines einzelnen Höhenausschnittes mit den Standardoptionen des Werkzeugs GA-Layer in Raster. Wenn Zusätzliche Ausgabentypen berücksichtigt werden, dann erhöht sich dadurch die Ausführungszeit nicht wesentlich, da Ausgaben mehrerer Typen gleichzeitig vorhergesagt werden können.
Wenn Zusätzliche Ausgabentypen angegeben wurden, dann ist das Ausgabe-Raster ein multivariates multidimensionales Raster-Dataset mit unterschiedlichen Variablen für die einzelnen Ausgabetypen.
Die Performance der Werkzeuge im Toolset "Multidimensionale Analyse" der Toolbox "Image Analyst" lässt sich verbessern, indem Umgruppierungen am multidimensionalen Raster erstellt werden. Sie können zwar den Parameter Multidimensionale Umgruppierung erstellen verwenden, damit sie automatisch erstellt werden, dadurch nimmt aber die Ausführungszeit des Werkzeugs zu. Sie können das Werkzeug Multidimensionale Umgruppierung erstellen verwenden, um später Umgruppierungen zu erstellen.

Beschriftung	Erläuterung	Datentyp
Geostatistischer Eingabe-Layer in 3D	Der geostatistische 3D-Layer, der das Modell darstellt, das in ein multivariates Raster-Dataset exportiert werden soll.	Geostatistical Layer
Multidimensionales Ausgabe-Raster-Dataset	Das Ausgabe-Raster-Dataset, das die Ergebnisse des Exports des geostatistischen Modells enthält. Die Ausgabe muss als Cloud Raster Format-Datei (`*.crf`) gespeichert werden.	Raster Dataset
Zellengröße (Optional)	Die Zellengröße des multidimensionalen Ausgabe-Rasters	Analysis Cell Size
Expliziten Höhenwert eingeben (Optional)	Gibt an, ob die Höhen als explizite Liste angegeben werden oder ein Iterator verwendet werden soll. Aktiviert—Die Höhenwerte werden als Liste angegeben. Deaktiviert—Die Höhenwerte werden unter Verwendung eines Iterators angegeben. Dies ist die Standardeinstellung.	Boolean
Minimale Höhe (Optional)	Die minimale Höhe, bei der die Iteration gestartet werden soll.	Double
Maximale Höhe (Optional)	Die maximale Höhe, bei der die Iteration beendet werden soll.	Double
Höhenintervall (Optional)	Die Schrittweite, um die bei jeder Iteration die Höhe erhöht werden soll.	Double
Höhenwerte (Optional)	Die Höhenwerte, die exportiert werden sollen.	Double
Höheneinheiten (Optional)	Gibt die Maßeinheiten für die Höhenwerte an. Zoll (US Survey)—Höhen werden in U.S. Survey Zoll angegeben. Fuß (US Survey)—Höhen werden in U.S. Survey Feet angegeben. Yards (US Survey)—Höhen werden in U.S. Survey Yards angegeben. Meilen (US Survey)—Höhen werden in U.S. Survey Meilen angegeben. Seemeilen (US Survey)—Höhen werden in U.S. Survey Seemeilen angegeben. Millimeter—Höhen werden in Millimetern angegeben. Zentimeter—Höhen werden in Zentimetern angegeben. Dezimeter—Höhen werden in Dezimetern angegeben. Meter—Höhen werden in Metern angegeben. Kilometer—Höhen werden in Kilometern angegeben. Zoll (International)—Höhen werden in Zoll (International) angegeben. Fuß (International)—Höhen werden in Fuß (International) angegeben. Yards (International)—Höhen werden in Yards (International) angegeben. Meilen (Britisch)—Höhen werden in Meilen (Britisch) angegeben. Seemeilen (International)—Höhen werden in Seemeilen (International) angegeben.	String
Ausgabetyp (Optional)	Gibt den primären Ausgabetyp des multidimensionalen Ausgabe-Rasters an. Der Parameter Zusätzliche Ausgabentypen kann verwendet werden, um zusätzliche Variablen im multidimensionalen Ausgabe-Raster anzugeben. Weitere Informationen finden Sie unter "Welche Ausgabe-Oberflächentypen können von den Interpolationsmodellen erzeugt werden?" Vorhersage—Ein multidimensionales Raster mit vorhergesagten Werten. Dies ist die Standardeinstellung. Standardfehler der Vorhersage—Ein multidimensionales Raster mit Standardfehlern der Vorhersage. Wahrscheinlichkeit—Ein multidimensionales Raster mit der Vorhersage der Wahrscheinlichkeit, dass ein Schwellenwert überschritten wird. Quantil—Ein multidimensionales Raster mit der Vorhersage des Quantils des vorhergesagten Wertes.	String
Quantil- oder Wahrscheinlichkeitsschwellenwert (Optional)	Wenn der Parameter Ausgabetyp auf Quantil festgelegt ist, dann geben Sie in diesem Parameter das gewünschte Quantil ein. Wenn der Parameter Ausgabetyp auf Wahrscheinlichkeit festgelegt ist, dann geben Sie in diesem Parameter den gewünschten Schwellenwert ein. Danach wird die Wahrscheinlichkeit, mit der dieser Schwellenwert überschritten wird, berechnet. Um die Wahrscheinlichkeit, mit der der Schwellenwert nicht überschritten wird, zu erhalten, müssen Sie diesen Wert von eins subtrahieren.	Double
Zusätzliche Ausgabentypen (Optional)	Gibt für jedes zusätzliche Ausgabe-Raster den Ausgabetyp und den Wert für das Quantil oder die Wahrscheinlichkeit an. Wenn mehrere Ausgabentypen angegeben wurden, dann ist das Ausgabe-Raster ein multivariates Raster-Dataset mit unterschiedlichen Variablen für die einzelnen Ausgabetypen. Weitere Informationen finden Sie unter "Welche Ausgabe-Oberflächentypen können von den Interpolationsmodellen erzeugt werden?" Spalten der Wertetabelle: Output surface type—Specifies the output type. Prediction—A raster of predicted values. Prediction standard error—A raster of standard errors of prediction. Probability—A raster predicting the probability that a threshold is exceeded. Quantile—A raster predicting the quantile of the predicted value. Quantile or probability threshold value—The quantile or probability value for each additional output type.	Value Table
Multidimensionale Umgruppierung erstellen (Optional)	Gibt an, ob multidimensionale Umgruppierungen am multidimensionalen Ausgabe-Raster erstellt werden sollen. Aktiviert—Multidimensionale Umgruppierungen am multidimensionalen Ausgabe-Raster sollen erstellt werden. Deaktiviert—Multidimensionale Umgruppierungen am multidimensionalen Ausgabe-Raster sollen nicht erstellt werden. Dies ist die Standardeinstellung.	Boolean

arcpy.ga.GALayer3DToMultidimensionalRaster(in_3d_geostat_layer, out_multidimensional_raster, {cell_size}, {explicit_only}, {min_elev}, {max_elev}, {elev_interval}, {elev_values}, {elev_units}, {output_type}, {quantile_probability_value}, {additional_outputs}, {build_transpose})

Name	Erläuterung	Datentyp
in_3d_geostat_layer	Der geostatistische 3D-Layer, der das Modell darstellt, das in ein multivariates Raster-Dataset exportiert werden soll.	Geostatistical Layer
out_multidimensional_raster	Das Ausgabe-Raster-Dataset, das die Ergebnisse des Exports des geostatistischen Modells enthält. Die Ausgabe muss als Cloud Raster Format-Datei (`*.crf`) gespeichert werden.	Raster Dataset
cell_size (Optional)	Die Zellengröße des multidimensionalen Ausgabe-Rasters	Analysis Cell Size
explicit_only (Optional)	Gibt an, ob die Höhen als explizite Liste angegeben werden oder ein Iterator verwendet werden soll. `EXPLICIT_VALUES`—Die Höhenwerte werden als Liste angegeben. `NO_EXPLICIT_VALUES`—Die Höhenwerte werden unter Verwendung eines Iterators angegeben. Dies ist die Standardeinstellung.	Boolean
min_elev (Optional)	Die minimale Höhe, bei der die Iteration gestartet werden soll.	Double
max_elev (Optional)	Die maximale Höhe, bei der die Iteration beendet werden soll.	Double
elev_interval (Optional)	Die Schrittweite, um die bei jeder Iteration die Höhe erhöht werden soll.	Double
elev_values [elev_values,...] (Optional)	Die Höhenwerte, die exportiert werden sollen.	Double
elev_units (Optional)	Gibt die Maßeinheiten für die Höhenwerte an. `INCH`—Höhen werden in U.S. Survey Zoll angegeben. `FOOT`—Höhen werden in U.S. Survey Feet angegeben. `YARD`—Höhen werden in U.S. Survey Yards angegeben. `MILE_US`—Höhen werden in U.S. Survey Meilen angegeben. `NAUTICAL_MILE`—Höhen werden in U.S. Survey Seemeilen angegeben. `MILLIMETER`—Höhen werden in Millimetern angegeben. `CENTIMETER`—Höhen werden in Zentimetern angegeben. `DECIMETER`—Höhen werden in Dezimetern angegeben. `METER`—Höhen werden in Metern angegeben. `KILOMETER`—Höhen werden in Kilometern angegeben. `INCH_INT`—Höhen werden in Zoll (International) angegeben. `FOOT_INT`—Höhen werden in Fuß (International) angegeben. `YARD_INT`—Höhen werden in Yards (International) angegeben. `MILE_INT`—Höhen werden in Meilen (Britisch) angegeben. `NAUTICAL_MILE_INT`—Höhen werden in Seemeilen (International) angegeben.	String
output_type (Optional)	Gibt den primären Ausgabetyp des multidimensionalen Ausgabe-Rasters an. Der Parameter Zusätzliche Ausgabentypen kann verwendet werden, um zusätzliche Variablen im multidimensionalen Ausgabe-Raster anzugeben. Weitere Informationen finden Sie unter "Welche Ausgabe-Oberflächentypen können von den Interpolationsmodellen erzeugt werden?" `PREDICTION`—Ein multidimensionales Raster mit vorhergesagten Werten. Dies ist die Standardeinstellung. `PREDICTION_STANDARD_ERROR`—Ein multidimensionales Raster mit Standardfehlern der Vorhersage. `PROBABILITY`—Ein multidimensionales Raster mit der Vorhersage der Wahrscheinlichkeit, dass ein Schwellenwert überschritten wird. `QUANTILE`—Ein multidimensionales Raster mit der Vorhersage des Quantils des vorhergesagten Wertes.	String
quantile_probability_value (Optional)	Wenn der Parameter Ausgabetyp auf Quantil festgelegt ist, dann geben Sie in diesem Parameter das gewünschte Quantil ein. Wenn der Parameter Ausgabetyp auf Wahrscheinlichkeit festgelegt ist, dann geben Sie in diesem Parameter den gewünschten Schwellenwert ein. Danach wird die Wahrscheinlichkeit, mit der dieser Schwellenwert überschritten wird, berechnet. Um die Wahrscheinlichkeit, mit der der Schwellenwert nicht überschritten wird, zu erhalten, müssen Sie diesen Wert von eins subtrahieren.	Double
additional_outputs [[output_type, quantile_probability_value],...] (Optional)	Gibt für jedes zusätzliche Ausgabe-Raster den Ausgabetyp und den Wert für das Quantil oder die Wahrscheinlichkeit an. Wenn mehrere Ausgabentypen angegeben wurden, dann ist das Ausgabe-Raster ein multivariates Raster-Dataset mit unterschiedlichen Variablen für die einzelnen Ausgabetypen. Weitere Informationen finden Sie unter "Welche Ausgabe-Oberflächentypen können von den Interpolationsmodellen erzeugt werden?" Spalten der Wertetabelle: `Output surface type`—Specifies the output type. `PREDICTION`—A raster of predicted values. `PREDICTION_STANDARD_ERROR`—A raster of standard errors of prediction. `PROBABILITY`—A raster predicting the probability that a threshold is exceeded. `QUANTILE`—A raster predicting the quantile of the predicted value. `Quantile or probability threshold value`—The quantile or probability value for each additional output type.	Value Table
build_transpose (Optional)	Gibt an, ob multidimensionale Umgruppierungen am multidimensionalen Ausgabe-Raster erstellt werden sollen. `BUILD_TRANSPOSE`—Multidimensionale Umgruppierungen am multidimensionalen Ausgabe-Raster sollen erstellt werden. `DO_NOT_BUILD_TRANSPOSE`—Multidimensionale Umgruppierungen am multidimensionalen Ausgabe-Raster sollen nicht erstellt werden. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

GALayer3DToMultivariateRaster: Beispiel 1 (Python-Fenster)

Interpolieren von 3D-Punkten und Konvertieren der Ausgabe in ein multivariates Raster.

import arcpy
arcpy.ga.EmpiricalBayesianKriging3D("my3DLayer", "Shape.Z", "myValueField", "my3DGALayer")
arcpy.ga.GALayer3DToMultivariateRaster("my3DGALayer", r"C:\\gapydata\\outputMDRD.crf", 1000,
                                       "NO_EXPLICIT_VALUES", 0, 500, 50, "","METERS",
                                       "PREDICTION", "", [["PREDICTION_STANDARD_ERROR",""]],
                                       "BUILD_TRANSPOSE")

GALayer3DToMultivariateRaster: Beispiel 2 (eigenständiges Skript)

Interpolieren von 3D-Punkten und Konvertieren der Ausgabe in ein multivariates Raster mit mehreren Ausgabetypen und Umgruppierungen.

# Name: GALayer3DToMDR_Example_02.py
# Description: Interpolates 3D points and exports to a multidimensional raster dataset.
# Requirements: Geostatistical Analyst extension

# Import system modules
import arcpy

# Set local variables
in3DPoints = "C:/gapyexamples/input/my3DPoints.shp"
elevationField = "Shape.Z"
valueField = "myValueField"
outGALayer = "myGALayer"

# Run Empirical Bayesian Kriging 3D
arcpy.ga.EmpiricalBayesianKriging3D(in3DPoints, elevationField, valueField, outGALayer)

# Export predictions and standard errors to multidimensional raster with tranposes.

# Set up variables
outMDRaster = r"C:\\gapydata\\outputMDRD.crf"
explicitVals = "NO_EXPLICIT_VALUES"
cell_size = 1000
min_elev = 0
max_elev = 500
elev_interval = 50
elev_list = ""
elev_units = "METERS"
out_type = "PREDICTION"
quan_value = ""
add_outputs = [["PREDICTION_STANDARD_ERROR",""]]
transpose = "BUILD_TRANSPOSE"

# Additionally output prediction standard errors.
arcpy.ga.GALayer3DToMultivariateRaster(outGALayer, outMDRaster, cell_size, explicitVals,
                                       min_elev, max_elev, elev_interval, elev_list,
                                       elev_units, out_type, quan_value, add_outputs,
                                       transpose)

Umgebungen

Zellengröße, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-Koordinatensystem, Faktor für parallele Verarbeitung, Fang-Raster

Lizenzierungsinformationen