Puntos NetCDF a clase de entidad (geometría de muestreo discreto) (Multidimensional)

Resumen

Crea una clase de entidad a partir de puntos de archivos netCDF. En la convención de metadatos de Climate and Forecast (CF), un punto es un tipo de geometría de muestreo discreta (DSG).

Descubra cómo funcionan las herramientas de Geometría de muestreo discreto (DSG)

Uso

  • En la convención de metadatos Climate and Forecast (CF), un punto es un solo punto de datos, que no tiene una relación de coordenadas implícita con otros puntos.

  • Los datasets de geometría de muestreo discreto (DSG) se caracterizan por una dimensionalidad menor que la región espacio-tiempo en la que se muestrean los datos.

  • Los archivos netCDF de entrada deben ser compatibles con Climate and Forecast (CF) (CF 1.6 o posterior). Las convenciones de CF definen los metadatos que describen los datos representados por cada variable y las propiedades espaciales y temporales de los datos.

  • Si los archivos netCDF de entrada no son compatibles con CF, puede especificar un archivo Input Climate and Forecast Metadata (in_cf_metadata en Python) con atributos adicionales o modificados. El archivo Input Climate and Forecast Metadata es un archivo en formato XML con una extensión .ncml. Los atributos de este archivo de metadatos se extenderán o invalidarán los metadatos del archivo netCDF. El archivo Input Climate and Forecast Metadata de entrada también se puede utilizar para especificar una variable de representación cartográfica de cuadrícula si el archivo netCDF de entrada no tiene ninguna.

  • Es posible convertir varios archivos netCDF de puntos DSG en una sola clase de entidad con un campo instanceID único. En el caso de las variables de instancia, la coincidencia tiene lugar por nombre de variable. Es decir, si dos variables de diferentes archivos netCDF tienen el mismo nombre, se interpretará que representan lo mismo.

  • Se pueden seleccionar varias variables de instancia para el parámetro Variables de instancia (instance_variables en Python).

  • Puede utilizar el parámetro Extensión de análisis (analysis_extent en Python) para especificar el área de análisis de salida explícitamente para una operación de herramienta independiente o para invalidar la configuración del entorno como parte de un flujo de trabajo. Para especificar la extensión, puede escribir los valores correspondientes, elegir la extensión de visualización, seleccionar una capa o buscar un dataset de entrada.

  • El valor predeterminado de Extensión de análisis se calcula a partir de la extensión de unión de los archivos netCDF de entrada.

  • Si la extensión no se especifica explícitamente como el valor de parámetro, se derivará de la configuración del entorno de análisis.

  • Se crea una clase de entidad de puntos 2D o 3D que contiene toda la información de ubicaciones junto con los valores de los datos correspondientes al parámetro seleccionado Variables de instancia (instance_variables en Python).

  • Una variable de datos del archivo netCDF puede utilizar una variable grid_mapping para definir explícitamente el sistema de referencia de coordenadas (CRS) utilizado para los valores de coordenadas espaciales. El atributo epsg_code de representación cartográfica de cuadrícula se puede usar para seleccionar un GCS o PCS. Además, los atributos esri_pe_string, crs_wkt y spatial_ref de la representación cartográfica de cuadrícula se pueden utilizar para definir una cadena de caracteres WKT 1 o WKT 2. Si cualquiera de estos atributos está presente, no se utiliza ningún otro atributo para el sistema de coordenadas horizontales. Para obtener más información sobre los sistemas de referencia de coordenadas, así como los WKID compatibles, consulte el tema Sistemas de coordenadas, proyecciones y transformaciones.

  • Si los valores de coordenadas espaciales son 3D, la variable grid_mapping también debería especificar un sistema de coordenadas verticales (VCS). Un VCS es una combinación de un datum vertical, una unidad de medida lineal y la dirección (arriba o abajo) que aumentan las coordenadas verticales. El datum se obtiene normalmente de un atributo de la variable de asignación de cuadrícula y las otras propiedades se obtienen de la variable de coordenada vertical. Es posible especificar un datum vertical arbitrario utilizando una cadena de caracteres compuesta de WKT como el valor de uno de los atributos WKT indicados anteriormente. Un datum basado en la gravedad se puede especificar usando el atributo geoid_name o geopotential_datum_name. Además, es posible especificar implícitamente un datum de mareas mediante uno de los nombres estándar de las mareas para la variable de coordenadas verticales. Si no se especifica VCS y no hay una variable de coordenadas verticales, se seleccionará Profundidad del nivel de agua instantánea o Altura (epsg:5831, epsg:5829) como valor predeterminado.

Parámetros

EtiquetaExplicaciónTipo de datos
Archivos o carpetas NetCDF de entrada

Los archivos netCDF de entrada que se utilizarán para crear una clase de entidad. Se pueden utilizar archivos netCDF individuales, así como carpetas que contienen varios archivos netCDF.

Los archivos netCDF de entrada deben tener el mismo tipo de entidad y esquema DSG.

Folder; File
Espacio de trabajo objetivo

Geodatabase corporativa o de archivos en la que se crearán la tabla y clase de entidad de salida. Debe ser un espacio de trabajo existente.

Workspace
Nombre de punto de salida

El nombre de la clase de entidad que contendrá las ubicaciones de las variables netCDF. Estas variables se agregarán como campos desde el parámetro Variables de instancia.

String
Variables de instancia
(Opcional)

Las variables netCDF que diferencian a las entidades individuales y representan las ubicaciones en las que se realizan las observaciones. Estas variables se agregarán como campos a la clase de entidad de salida.

String
Incluir subdirectorios
(Opcional)

Especifica si se utilizarán los archivos que residen en los subdirectorios de una carpeta de entrada.

  • Activado: se utilizarán todos los archivos netCDF de todos los subdirectorios.
  • Desactivado: solo se usarán los archivos de la carpeta de entrada. Esta es la opción predeterminada.
Boolean
Input Climate and Forecast Metadata
(Opcional)

El archivo en formato XML con una extensión .ncml que proporcionará información CF ausente o modificada para los archivos netCDF de entrada.

File
Extensión de análisis
(Opcional)

La extensión que define el área de la clase de entidad de salida.

Extent

Salida derivada

EtiquetaExplicaciónTipo de datos
Punto de salida

La clase de entidad de puntos de salida.

Feature Class

arcpy.management.NetCDFPointsToFeatureClass(in_files_or_folders, target_workspace, out_point_name, {instance_variables}, {include_subdirectories}, {in_cf_metadata}, {analysis_extent})
NombreExplicaciónTipo de datos
in_files_or_folders
[in_files_or_folders,...]

Los archivos netCDF de entrada que se utilizarán para crear una clase de entidad. Se pueden utilizar archivos netCDF individuales, así como carpetas que contienen varios archivos netCDF.

Los archivos netCDF de entrada deben tener el mismo tipo de entidad y esquema DSG.

Folder; File
target_workspace

Geodatabase corporativa o de archivos en la que se crearán la tabla y clase de entidad de salida. Debe ser un espacio de trabajo existente.

Workspace
out_point_name

El nombre de la clase de entidad que contendrá las ubicaciones de las variables netCDF. Estas variables se agregarán como campos desde el parámetro instance_variables.

String
instance_variables
[instance_variables,...]
(Opcional)

Las variables netCDF que diferencian a las entidades individuales y representan las ubicaciones en las que se realizan las observaciones. Estas variables se agregarán como campos a la clase de entidad de salida.

String
include_subdirectories
(Opcional)

Especifica si se utilizarán los archivos que residen en los subdirectorios de una carpeta de entrada.

  • INCLUDE_SUBDIRECTORIESSe utilizarán todos los archivos netCDF de todos los subdirectorios.
  • DO_NOT_INCLUDE_SUBDIRECTORIESSolo se usarán los archivos de la carpeta de entrada. Esta es la opción predeterminada.
Boolean
in_cf_metadata
(Opcional)

El archivo en formato XML con una extensión .ncml que proporcionará información CF ausente o modificada para los archivos netCDF de entrada.

File
analysis_extent
(Opcional)

La clase Extent determina la extensión del dataset ráster de salida.

El formato de la clase Extent es el siguiente:

  • Extent (XMin, YMin, XMax, YMax)

    donde:

    • XMin: el valor XMin de la extensión
    • YMin: el valor YMin de la extensión
    • XMax: el valor XMax de la extensión
    • YMax: el valor YMax de la extensión

Extent

Salida derivada

NombreExplicaciónTipo de datos
out_point

La clase de entidad de puntos de salida.

Feature Class

Muestra de código

Ejemplo 1 de NetCDFPointsToFeatureClass (ventana de Python)

En este ejemplo se crea una clase de entidad de punto a partir de una carpeta que contiene archivos netCDF de puntos DSG de un dataset SWOT.

import arcpy
arcpy.md.NetCDFPointsToFeatureClass(r"C:\SWOT", r"C:\ArcGIS\Projects\output.gdb",
                                    "swot_water_frac", "water_frac", 
				    "INCLUDE_SUBDIRECTORIES", None, "DEFAULT")
Ejemplo 2 de NetCDFPointsToFeatureClass (script independiente)

En este ejemplo se crea una clase de entidad a partir de un conjunto de archivos netCDF de puntos DSG de MADIS con un archivo .ncml.

# Name: NetCDFPointsToFeatureClass_Ex_02.py
# Description: Creates a feature class from a netCDF DSG points file from MADIS with a .ncml file. 

# Import system modules
Import arcpy  

# Set the local variables 
in_files_or_folders = r"C:\MADIS" 
target_workspace = r"C:\outputs\madis.gdb" 
out_point_name = "madis_point" 
instance_variables = "temperature;pressure"  
include_subdirectories = "DO_NOT_INCLUDE_SUBDIRECTORIES"
in_cf_metadata = r"C:\MADIS\swot_cf.ncml" 
analysis_extent = ""  

# Execute NetCDFTimeSeriesToFeatureClass
arcpy.md.NetCDFPointsToFeatureClass(in_files_or_folders, target_workspace,
                                    out_point_name, instance_variables,
                                    include_subdirectories, in_cf_metadata,
                                    analysis_extent)