GA Layer To Contour (Geostatistical Analyst)

Disponible con una licencia de Geostatistical Analyst.

Resumen

Crea una clase de entidad de curvas de nivel a partir de una capa de estadísticas geográficas. La clase de entidad de salida puede ser una clase de entidad de línea de líneas de curvas de nivel o una clase de entidad poligonal de curvas de nivel rellenas.

Uso

  • Para los formatos de datos que admiten valores nulos, como clases de entidad de geodatabase de archivos, se utilizará un valor nulo para indicar que no se pudo hacer una predicción para esa ubicación o que el valor se debe ignorar cuando se usa como entrada. Para los formatos de datos que no admiten valores nulos, como los shapefiles, se utiliza el valor -1.7976931348623158e+308 (es el valor negativo de la constante de C++ DBL_MAX definida) para indicar que no se pudo realizar una predicción para esa ubicación.

  • Las entidades poligonales o de polilínea de salida contendrán una geometría ligeramente diferente en función del número de núcleos de CPU de su equipo. Se debe a un número diferente de teselas que se utilizarán en el algoritmo de curvas de nivel (más núcleos admiten un mayor ordenamiento en teselas y, por lo tanto, curvas de nivel más perfeccionadas en la salida). Para obtener resultados reproducibles en equipos con distintos números de núcleos de CPU, use el entorno Factor de procesamiento en paralelo para controlar el número de núcleos que puede utilizar la herramienta.

  • Si la Capa de estadísticas geográficas de entrada representa un modelo de interpolación 3D, debe especificar la elevación de las curvas de nivel que desea exportar usando el parámetro Elevación de salida.

Parámetros

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

La capa de estadísticas geográficas que se analizará.

Geostatistical Layer
Tipo de curva de nivel

Tipo de curva de nivel que representa la capa de estadísticas geográficas.

  • Curva de nivelLa representación de una curva de nivel o isolínea de la capa de estadísticas geográficas. Muestra las líneas con calidad de borrador o de presentación.
  • Curva de nivel rellenaLa representación poligonal de la capa de estadísticas geográficas. Para la visualización gráfica, asume que los valores entre las líneas de curvas de nivel son iguales para todas las ubicaciones dentro del polígono. Muestra las líneas con calidad de borrador o de presentación.
  • Igual que la capaUtilice el renderizador actual de la capa de estadísticas geográficas de entrada.
String
Clase de entidad de salida

La clase de entidad de salida será una polilínea o un polígono, dependiendo del tipo de curva de nivel seleccionado.

Feature Class
Calidad de curva de nivel
(Opcional)

Determina la uniformidad de la representación de la línea de curvas de nivel.

  • BorradorLa calidad Borrador predeterminada presenta una versión generalizada de isolíneas para una visualización más rápida.
  • PresentaciónLa opción Presentación garantiza isolíneas más detalladas para la clase de entidad de salida.
String
Tipo de clasificación
(Opcional)

Especifica cómo se calcularán las divisiones de las curvas de nivel.

  • Intervalo geométricoLas divisiones de las curvas de nivel se calculan en base a intervalos geométricos.
  • Intervalo equivalenteLas divisiones de las curvas de nivel se calculan en base a intervalos equivalentes.
  • CuantilLas divisiones de las curvas de nivel se calculan a partir de cuantiles de los datos de entrada.
  • ManualEspecifique sus propios valores de divisiones.
String
Cantidad de clases
(Opcional)

Especifique el número de clases de la clase de entidad de salida.

Si Tipo de curva de nivel se establece en polígonos de curvas de nivel rellenas de salida, el número de polígonos creados será igual al valor especificado en este parámetro. Si se establece en polilíneas de curvas de nivel de salida, el número de polilíneas será uno menos que el valor especificado en este parámetro (porque los intervalos de clase N definen valores de división de curvas de nivel N-1).

Este parámetro no se aplica si el Tipo de clasificación está establecido en Manual.

Long
Rupturas de clase
(Opcional)

La lista de valores de ruptura si el Tipo de clasificación está establecido en Manual.

  • Para la salida de curvas de nivel, estos son los valores de las líneas de curvas de nivel.
  • Para las curvas de nivel rellenas, se trata de los límites superiores de cada intervalo de clase. Tenga en cuenta que si el valor de ruptura más grande es menor que el máximo de la capa de estadísticas geográficas, la clase de entidad de salida no rellenará toda la extensión rectangular; todas las ubicaciones con valores predichos superiores a la ruptura más elevada no recibirán curvas de nivel rellenas.
Double
Elevación de salida
(Opcional)

Para los modelos de interpolación 3D, puede exportar curvas de nivel en cualquier elevación. Utilice este parámetro para especificar la elevación que desea exportar. Si se deja vacío, la elevación se heredará de la capa de entrada. Las unidades adoptarán de forma predeterminada las mismas unidades de la capa de entrada.

Linear Unit

arcpy.ga.GALayerToContour(in_geostat_layer, contour_type, out_feature_class, {contour_quality}, {classification_type}, {classes_count}, {classes_breaks}, {out_elevation})
NombreExplicaciónTipo de datos
in_geostat_layer

La capa de estadísticas geográficas que se analizará.

Geostatistical Layer
contour_type

Tipo de curva de nivel que representa la capa de estadísticas geográficas.

  • CONTOURLa representación de una curva de nivel o isolínea de la capa de estadísticas geográficas. Muestra las líneas con calidad de borrador o de presentación.
  • FILLED_CONTOURLa representación poligonal de la capa de estadísticas geográficas. Para la visualización gráfica, asume que los valores entre las líneas de curvas de nivel son iguales para todas las ubicaciones dentro del polígono. Muestra las líneas con calidad de borrador o de presentación.
  • SAME_AS_LAYERUtilice el renderizador actual de la capa de estadísticas geográficas de entrada.
String
out_feature_class

La clase de entidad de salida será una polilínea o un polígono, dependiendo del tipo de curva de nivel seleccionado.

Feature Class
contour_quality
(Opcional)

Determina la uniformidad de la representación de la línea de curvas de nivel.

  • DRAFTLa calidad Borrador predeterminada presenta una versión generalizada de isolíneas para una visualización más rápida.
  • PRESENTATIONLa opción Presentación garantiza isolíneas más detalladas para la clase de entidad de salida.
String
classification_type
(Opcional)

Especifica cómo se calcularán las divisiones de las curvas de nivel.

  • GEOMETRIC_INTERVALLas divisiones de las curvas de nivel se calculan en base a intervalos geométricos.
  • EQUAL_INTERVALLas divisiones de las curvas de nivel se calculan en base a intervalos equivalentes.
  • QUANTILELas divisiones de las curvas de nivel se calculan a partir de cuantiles de los datos de entrada.
  • MANUALEspecifique sus propios valores de divisiones.
String
classes_count
(Opcional)

Especifique el número de clases de la clase de entidad de salida.

Si contour_type se establece en polígonos de curvas de nivel rellenas de salida, el número de polígonos creados será igual al valor especificado en este parámetro. Si se establece en polilíneas de curvas de nivel de salida, el número de polilíneas será uno menos que el valor especificado en este parámetro (porque los intervalos de clase N definen valores de división de curvas de nivel N-1).

Este parámetro no se aplica si classification_type está establecido como Manual.

Long
classes_breaks
[classes_breaks,...]
(Opcional)

La lista de valores de ruptura si classification_type está establecido en Manual. Los valores se deben transmitir como una lista y pueden estar en cualquier orden.

  • Para la salida de curvas de nivel, estos son los valores de las líneas de curvas de nivel.
  • Para las curvas de nivel rellenas, se trata de los límites superiores de cada intervalo de clase. Tenga en cuenta que si el valor de ruptura más grande es menor que el máximo de la capa de estadísticas geográficas, la clase de entidad de salida no rellenará toda la extensión rectangular; todas las ubicaciones con valores predichos superiores a la ruptura más elevada no recibirán curvas de nivel rellenas.
Double
out_elevation
(Opcional)

Para los modelos de interpolación 3D, puede exportar curvas de nivel en cualquier elevación. Utilice este parámetro para especificar la elevación que desea exportar. Si se deja vacío, la elevación se heredará de la capa de entrada. Las unidades adoptarán de forma predeterminada las mismas unidades de la capa de entrada.

Linear Unit

Muestra de código

Ejemplo de ventana interactiva de GALayerToContour

Exporta una capa de estadísticas geográficas a una clase de entidad de curvas de nivel.

import arcpy
from arcpy import env
env.workspace = "C:/gapyexamples/data"
arcpy.GALayerToContour_ga("kriging.lyr", "Contour", "krig_contour",
                          "Presentation", "GEOMETRIC_INTERVAL", 10, "")
Ejemplo de script de GALayerToContour

Exporta una capa de estadísticas geográficas a una clase de entidad de curvas de nivel.

# Name: GALayerToContour_Example_02.py
# Description: Exports a geostatistical layer to filled contours with
#              class breaks at 100, 500 and 2000.
# Requirements: Geostatistical Analyst Extension

# Import system modules
import arcpy

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

# Set local variables
in_geostat_layer = "kriging.lyr"
contour_type = "Filled_contour"
out_feature_class = "C:/gapyexamples/output/krig_filled_contour.shp"
contour_quality = "Presentation"
classification_type = "Manual"
classes_count = ""
classes_breaks = [100, 500, 2000]

# Execute GALayerToContour
arcpy.GALayerToContour_ga(in_geostat_layer, contour_type, out_feature_class,
                          contour_quality, classification_type, classes_count,
                          classes_breaks)

Información de licenciamiento

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

Temas relacionados