De capa 3D de GA a ráster multidimensional (Geostatistical Analyst)

Disponible con una licencia de Geostatistical Analyst.

Resumen

Exporta una capa de estadísticas geográficas 3D creada con la herramienta Kriging bayesiano empírico 3D a un dataset ráster multidimensional de Formato de ráster de nube (archivo *.crf). Las herramientas del conjunto de herramientas Análisis multidimensional de la caja de herramientas de Image Analyst están diseñadas para trabajar directamente en rásteres multidimensionales y pueden identificar la naturaleza 3D de los datos.

Las capas de estadísticas geográficas 3D almacenan resultados de interpolación 3D continuos y aparecen como divisiones en zonas horizontales 2D en una elevación determinada. La elevación actual se puede cambiar con el control deslizante de rango y la capa calculará y renderizará los valores predichos de la nueva elevación. Los rásteres de predicciones interpoladas se pueden extraer en cualquier elevación con la herramienta GA Layer To Rasters. La herramienta De capa 3D de GA a ráster multidimensional automatiza el proceso de extracción de rásteres en varias elevaciones y los almacena como un dataset ráster multidimensional.

Uso

  • La Capa de estadísticas geográficas 3D de entrada se debe crear usando Kriging bayesiano empírico 3D.

  • Puede proporcionar las elevaciones deseadas de las siguientes formas:

    • Proporcionar valores de elevación utilizando un iterador: deje desactivado el parámetro Introducir valores de elevación explícitos y proporcione valores para los parámetros Elevación mínima, Elevación máxima e Intervalo de elevación. La iteración comenzará en el mínimo y aumentará con el intervalo hasta el máximo. Por ejemplo, si proporciona una elevación mínima de 0, una máxima de 100 y un intervalo de 20, la salida tendrá seis elevaciones: 0, 20, 40, 60, 80 y 100.
    • Proporcionar valores de elevación explícitos: active el parámetro Introducir valores de elevación explícitos y proporcione las elevaciones deseadas en el parámetro Valores de elevación.
    El parámetro Unidades de elevación especifica la unidad de cada valor de elevación.

  • Si el Intervalo de elevación proporcionado no divide uniformemente el rango de elevación (la Elevación máxima menos la Elevación mínima), se utilizará una elevación que supere la elevación máxima. Por ejemplo, si proporciona una elevación mínima de 10, una elevación máxima de 80 y un intervalo de elevación de 20, la salida tendrá cinco elevaciones: 10, 30, 50, 70 y 90.

  • El tamaño de celda ráster predeterminado del parámetro Dataset ráster multidimensional de salida es el menor de la extensión de salida de las dimensiones x e y, dividido entre 100. El número predeterminado de divisiones en zonas de elevación es 10, por lo que creará un ráster multidimensional con una resolución x e y que sea al menos 10 veces mayor que la resolución z. Debe tener en cuenta estos valores, especialmente si desea aproximadamente la misma resolución en las tres dimensiones. Aumentar el tamaño de celda o aumentar el número de divisiones en zonas de elevación resultará en salidas que tienen una resolución más similar en todas las dimensiones.

  • El tiempo de ejecución de la herramienta es aproximadamente proporcional al número de predicciones generales requeridas y cada celda ráster de cada elevación requiere el cálculo de un valor predicho. De forma predeterminada, el tiempo de ejecución de la herramienta es aproximadamente un 60 por ciento más largo que exportar una sola división en zonas de elevación utilizando las opciones predeterminadas de la herramienta GA Layer To Rasters. Incluir Tipos de salida adicionales no aumentará considerablemente el tiempo de ejecución porque se pueden predecir varios tipos de salida simultáneamente.

  • Si se proporciona algún Tipo de salida adicional, el ráster de salida será un dataset ráster multidimensional multivariante con una variable diferente para cada tipo de salida.

  • Todas las herramientas del conjunto de herramientas Análisis multidimensional de la caja de herramientas Image Analyst tendrán un mayor rendimiento si las transposiciones se crean en el ráster multidimensional. Puede usar el parámetro Generar transposición multidimensional para generarlos automáticamente, pero incrementará el tiempo de ejecución de la herramienta. Puede utilizar la herramienta Generar transposición multidimensional para generar las transposiciones posteriormente.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de estadísticas geográficas 3D de entrada

La capa de estadísticas geográficas 3D que representa el modelo que se exportará a un dataset ráster multivariante.

Geostatistical Layer
Dataset ráster multidimensional de salida

El dataset ráster de salida que contiene los resultados de la exportación del modelo de estadísticas geográficas. La salida se debe guardar como archivo de Formato de ráster de nube (*.crf).

Raster Dataset
Tamaño de celda
(Opcional)

El tamaño de celda del ráster multidimensional de salida.

Analysis Cell Size
Introducir valores de elevación explícitos
(Opcional)

Especifica si se proporcionarán elevaciones como una lista explícita o un iterador. Cada elevación estará representada por una dimensión en el ráster multidimensional de salida.

  • Activado: los valores de elevación se proporcionarán como una lista.
  • Desactivado: los valores de elevación se proporcionarán con un iterador. Esta es la opción predeterminada.
Boolean
Elevación mínima
(Opcional)

La elevación mínima que se utilizará para iniciar la iteración.

Double
Elevación máxima
(Opcional)

La elevación máxima que se utilizará para detener la iteración.

Double
Intervalo de elevación
(Opcional)

El incremento con el que aumentará la elevación con cada iteración.

Double
Valores de elevación
(Opcional)

Los valores de elevación que se van a exportar.

Double
Unidades de elevación
(Opcional)

Especifica la unidad de medida de los valores de elevación.

  • Pulgadas de agrimensura de EE. UU.Las elevaciones están en pulgadas de agrimensura estadounidenses.
  • Pies de agrimensura de EE. UU.Las elevaciones están en pies de agrimensura estadounidenses.
  • Yardas de agrimensura de EE. UU.Las elevaciones están en yardas de agrimensura estadounidenses.
  • Millas de agrimensura de EE. UU.Las elevaciones están en millas de agrimensura estadounidenses.
  • Millas náuticas topográficas de EE. UU.Las elevaciones están en millas náuticas de agrimensura estadounidenses.
  • MilímetrosLas elevaciones están en milímetros.
  • CentímetrosLas elevaciones están en centímetros.
  • DecímetrosLas elevaciones están en decímetros.
  • MetrosLas elevaciones están en metros.
  • KilómetrosLas elevaciones están en kilómetros.
  • Pulgadas internacionalesLas elevaciones están en pulgadas internacionales.
  • Pies internacionalesLas elevaciones están en pies internacionales.
  • Yardas internacionalesLas elevaciones están en yardas internacionales.
  • Millas terrestresLas elevaciones están en millas terrestres.
  • Millas náuticas internacionalesLas elevaciones están en millas náuticas internacionales.
String
Tipo de salida
(Opcional)

Especifica el tipo de salida principal del ráster multidimensional de salida. El parámetro Tipos de salida adicionales se puede utilizar para especificar variables adicionales en el ráster multidimensional de salida.

Para obtener más información, consulte ¿Qué tipos de superficie de salida pueden generar los modelos de interpolación?

  • PredicciónUn ráster multidimensional de valores predichos. Esta es la opción predeterminada.
  • Error estándar de predicciónUn ráster multidimensional de errores estándar de predicción.
  • ProbabilidadUn ráster multidimensional que predice la probabilidad de que se supere un umbral.
  • CuantilUn ráster multidimensional que predice el cuantil del valor predicho.
String
Valor de umbral de probabilidad o cuantil
(Opcional)

Si Tipo de salida se establece como Cuantil, utilice este parámetro para introducir el cuantil solicitado. Si Tipo de salida se establece como Probabilidad, utilice este parámetro para introducir el valor de umbral solicitado y se calculará la probabilidad de que se supere el umbral. Reste este valor de una para obtener la probabilidad de que el umbral no se supere.

Double
Tipos de salida adicionales
(Opcional)

Especifica el tipo de salida y el valor de cuantil o probabilidad para cada tipo de salida adicional. Si se proporcionan tipos de salida adicionales, el ráster de salida será un dataset ráster multivariante con una variable diferente para cada tipo de salida.

Para obtener más información, consulte ¿Qué tipos de superficie de salida pueden generar los modelos de interpolación?

Value Table
Generar transposición multidimensional
(Opcional)

Especifica si las transposiciones multidimensionales se generarán en el ráster multidimensional de salida.

  • Activado: se generarán transposiciones multidimensionales en el ráster multidimensional de salida.
  • Desactivado: no se generarán transposiciones multidimensionales en el ráster multidimensional de salida. Esta es la opción predeterminada.
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})
NombreExplicaciónTipo de datos
in_3d_geostat_layer

La capa de estadísticas geográficas 3D que representa el modelo que se exportará a un dataset ráster multivariante.

Geostatistical Layer
out_multidimensional_raster

El dataset ráster de salida que contiene los resultados de la exportación del modelo de estadísticas geográficas. La salida se debe guardar como archivo de Formato de ráster de nube (*.crf).

Raster Dataset
cell_size
(Opcional)

El tamaño de celda del ráster multidimensional de salida.

Analysis Cell Size
explicit_only
(Opcional)

Especifica si se proporcionarán elevaciones como una lista explícita o un iterador.

  • EXPLICIT_VALUESLos valores de elevación se proporcionarán como una lista.
  • NO_EXPLICIT_VALUESLos valores de elevación se proporcionarán con un iterador. Esta es la opción predeterminada.
Boolean
min_elev
(Opcional)

La elevación mínima que se utilizará para iniciar la iteración.

Double
max_elev
(Opcional)

La elevación máxima que se utilizará para detener la iteración.

Double
elev_interval
(Opcional)

El incremento con el que aumentará la elevación con cada iteración.

Double
elev_values
[elev_values,...]
(Opcional)

Los valores de elevación que se van a exportar.

Double
elev_units
(Opcional)

Especifica la unidad de medida de los valores de elevación.

  • INCHLas elevaciones están en pulgadas de agrimensura estadounidenses.
  • FOOTLas elevaciones están en pies de agrimensura estadounidenses.
  • YARDLas elevaciones están en yardas de agrimensura estadounidenses.
  • MILE_USLas elevaciones están en millas de agrimensura estadounidenses.
  • NAUTICAL_MILELas elevaciones están en millas náuticas de agrimensura estadounidenses.
  • MILLIMETERLas elevaciones están en milímetros.
  • CENTIMETERLas elevaciones están en centímetros.
  • DECIMETERLas elevaciones están en decímetros.
  • METERLas elevaciones están en metros.
  • KILOMETERLas elevaciones están en kilómetros.
  • INCH_INTLas elevaciones están en pulgadas internacionales.
  • FOOT_INTLas elevaciones están en pies internacionales.
  • YARD_INTLas elevaciones están en yardas internacionales.
  • MILE_INTLas elevaciones están en millas terrestres.
  • NAUTICAL_MILE_INTLas elevaciones están en millas náuticas internacionales.
String
output_type
(Opcional)

Especifica el tipo de salida principal del ráster multidimensional de salida. El parámetro Tipos de salida adicionales se puede utilizar para especificar variables adicionales en el ráster multidimensional de salida.

Para obtener más información, consulte ¿Qué tipos de superficie de salida pueden generar los modelos de interpolación?

  • PREDICTIONUn ráster multidimensional de valores predichos. Esta es la opción predeterminada.
  • PREDICTION_STANDARD_ERRORUn ráster multidimensional de errores estándar de predicción.
  • PROBABILITYUn ráster multidimensional que predice la probabilidad de que se supere un umbral.
  • QUANTILEUn ráster multidimensional que predice el cuantil del valor predicho.
String
quantile_probability_value
(Opcional)

Si Tipo de salida se establece como Cuantil, utilice este parámetro para introducir el cuantil solicitado. Si Tipo de salida se establece como Probabilidad, utilice este parámetro para introducir el valor de umbral solicitado y se calculará la probabilidad de que se supere el umbral. Reste este valor de una para obtener la probabilidad de que el umbral no se supere.

Double
additional_outputs
[[output_type, quantile_probability_value],...]
(Opcional)

Especifica el tipo de salida y el valor de cuantil o probabilidad para cada tipo de salida adicional. Si se proporcionan tipos de salida adicionales, el ráster de salida será un dataset ráster multivariante con una variable diferente para cada tipo de salida.

Para obtener más información, consulte ¿Qué tipos de superficie de salida pueden generar los modelos de interpolación?

Value Table
build_transpose
(Opcional)

Especifica si las transposiciones multidimensionales se generarán en el ráster multidimensional de salida.

  • BUILD_TRANSPOSESe generarán transposiciones multidimensionales en el ráster multidimensional de salida.
  • DO_NOT_BUILD_TRANSPOSENo se generarán transposiciones multidimensionales en el ráster multidimensional de salida. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de GALayer3DToMultivariateRaster (ventana de Python)

Interpola puntos 3D y convierte la salida en un ráster multivariante.

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")
Ejemplo 2 de GALayer3DToMultivariateRaster (script independiente)

Interpola puntos 3D y convierte la salida en un ráster multivariante con varios tipos de salida y transposiciones.

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

# Import system modules
import arcpy

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


# Check out the ArcGIS Geostatistical Analyst extension license
arcpy.CheckOutExtension("GeoStats")

# Execute 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)

Información de licenciamiento

  • Basic: Requiere Geostatistical Analyst
  • Standard: Requiere Geostatistical Analyst
  • Advanced: Requiere Geostatistical Analyst

Temas relacionados