NetCDF 轨迹转要素类(离散采样几何) (多维)

摘要

根据 netCDF 文件中的轨迹创建要素类。 在气候和预报 (CF) 元数据约定中,轨迹是一种离散采样几何 (DSG)。

了解有关离散采样几何 (DSG) 工具工作原理的详细信息

使用情况

  • 气候和预报 (CF) 元数据标准中,轨迹是在空间内沿路径分布的时间单调递增的一系列数据点。

  • 离散采样几何 (DSG) 数据集的特征在于其维数低于对数据进行采样的时空区域。

  • 输入 netCDF 文件应符合气候和预报 (CF) 标准(CF 1.6 或更高版本)。 CF 约定定义了元数据以描述每个变量表示的数据以及数据的空间和时态属性。

  • 如果输入 netCDF 文件不符合 CF 标准,您可以指定具有附加属性或已更改属性的输入气候和预报元数据Python 中为 in_cf_metadata)文件。 输入气候和预报元数据文件是扩展名为 .ncml 的 XML 格式文件。 此元数据文件中的属性将扩展或覆盖 netCDF 文件中的元数据。 如果输入 netCDF 文件没有格网映射变量,输入气候和预报元数据文件也可用于指定此变量。

  • DSG 要素类型通过以 cf_role 属性标记的实例 ID 变量标识。 具有相同模式的多个 netCDF 文件可以转换为具有唯一 InstanceID 字段的单个要素类。 每个 netCDF 文件都应该有一个以相同 cf_role 属性标记的变量,该变量将作为跨多个文件使用的标识字段。 聚合将严格按照该变量的实例维度进行。

  • 对于实例变量和观测变量,均按变量名进行匹配。 也就是说,如果不同 netCDF 文件中的两个变量具有相同的名称,则其会被解释为表示相同的内容。

  • 可以分别在实例变量Python 中为 instance_variables)和观测变量Python 中为 observation_variables)参数中选择多个实例和观测变量(巡航次数、温度、盐度等)。

  • 您可以使用分析范围Python 中为 analysis_extent)参数为独立工具操作明确指定输出分析区域,或将覆盖环境设置作为工作流的一部分。 您可以通过输入值、选择显示范围、选择图层或浏览至输入数据集的方式指定范围。

  • 默认分析范围值根据输入 netCDF 文件的总范围计算得出。

  • 如果范围没有明确指定为参数值,则其会从分析环境设置中派生。

  • 当为输出方案参数指定路径和事件选项(Python 中为 out_schema = "ROUTE_AND_EVENT")时,将创建两个输出。 其中一个输出是显示轨迹路径的 2D 或 3D 折线要素,其中 From TimeTo Time 字段指示每个轨迹的开始和结束时间。 另一个输出是一个表,其中包含每个记录时间的观测值以及已添加时间的相关字段。 指定选项(Python 中为 out_schema = "POINT")时,将创建一个 2D 或 3D 点要素图层,表示沿观测轨迹的位置。
  • netCDF 文件中的数据变量可以使用 grid_mapping 变量来明确定义用于空间坐标值的坐标参考系 (CRS)。 格网映射 epsg_code 属性可用于选择 GCS 或 PCS。 此外,格网映射 esri_pe_stringcrs_wktspatial_ref 属性均可用于定义 WKT 1 或 WKT 2 字符串。 如果存在这些属性中的任何一个,则不会使用水平坐标系的其他属性。 有关坐标参考系和支持的 WKID 的详细信息,请参阅坐标系、投影和变换主题。

  • 如果空间坐标值为 3D,则 grid_mapping 变量还应指定垂直坐标系 (VCS)。 VCS 是垂直基准面、线性测量单位和垂直坐标增加方向(向上或向下)的组合。 基准面通常从格网映射变量的属性获得,而其他属性则从垂直坐标变量获得。 可以使用复合 WKT 字符串作为上方列出的 WKT 属性之一的值来指定任意垂直基准面。 可以使用 geoid_namegeopotential_datum_name 属性指定基于重力的基准面。 此外,可以使用垂直坐标变量的潮汐标准名称之一隐式指定潮汐基准面。 如果未指定 VCS 并且存在垂直坐标变量,则将选择瞬时水位深度或高度(epsg:5831,epsg:5829)作为默认值。

参数

标注说明数据类型
输入 NetCDF 文件或文件夹

将用于创建要素类的输入 netCDF 文件。 可以使用单独的 netCDF 文件,也可以使用包含多个 netCDF 文件的文件夹。

输入 netCDF 文件必须具有相同的 DSG 要素类型和模式。

Folder; File
目标工作空间

将在其中创建输出要素类和表的企业或文件地理数据库。 必须是现有工作空间。

Workspace
输出点或折线名称

要素类的名称,此要素类将包含 netCDF 变量中的位置。 这些变量将从实例变量参数添加为字段。

String
观测变量
(可选)

包含每个位置和每个垂直级别的所有观测值的 netCDF 变量。 这些变量将作为字段添加到输出表

String
输出事件表名称
(可选)

输出表的名称,此表将包含来自观测变量的所有记录。

String
实例变量
(可选)

区分单个要素并表示观测位置的 netCDF 变量。 这些变量将作为字段添加到输出要素类。

String
输出方案
(可选)

指定将创建的输出要素类类型。

  • 路径和事件将创建一个显示路径信息的 2D 或 3D 折线要素类。
  • 将创建一个显示所有执行观测的位置的 2D 或 3D 要素类。
String
包括子目录
(可选)

指定是否使用输入文件夹的子目录中的文件。

  • 选中 - 将使用所有子目录中的所有 netCDF 文件。
  • 未选中 - 仅使用输入文件夹中的文件。 这是默认设置。
Boolean
输入气候和预报元数据
(可选)

具有 .ncml 扩展名的 XML 格式文件,将为输入 netCDF 文件提供缺失或更改的 CF 信息。

File
分析范围
(可选)

定义输出要素类区域的范围。

Extent

派生输出

标注说明数据类型
输出点或折线

输出点或折线要素类。

Feature Class
输出事件表

输出表。

Table

arcpy.management.NetCDFTrajectoriesToFeatureClass(in_files_or_folders, target_workspace, out_point_or_polyline_name, {observation_variables}, {out_table_name}, {instance_variables}, {out_schema}, {include_subdirectories}, {in_cf_metadata}, {analysis_extent})
名称说明数据类型
in_files_or_folders
[in_files_or_folders,...]

将用于创建要素类的输入 netCDF 文件。 可以使用单独的 netCDF 文件,也可以使用包含多个 netCDF 文件的文件夹。

输入 netCDF 文件必须具有相同的 DSG 要素类型和模式。

Folder; File
target_workspace

将在其中创建输出要素类和表的企业或文件地理数据库。 必须是现有工作空间。

Workspace
out_point_or_polyline_name

要素类的名称,此要素类将包含 netCDF 变量中的位置。 这些变量将从 instance_variables 参数添加为字段。

String
observation_variables
[observation_variables,...]
(可选)

包含每个位置和每个垂直级别的所有观测值的 netCDF 变量。 这些变量将作为字段添加到输出表

String
out_table_name
(可选)

输出表的名称,此表将包含来自观测变量的所有记录。

String
instance_variables
[instance_variables,...]
(可选)

区分单个要素并表示观测位置的 netCDF 变量。 这些变量将作为字段添加到输出要素类。

String
out_schema
(可选)

指定将创建的输出要素类类型。

  • ROUTE_AND_EVENT将创建一个显示路径信息的 2D 或 3D 折线要素类。
  • POINT将创建一个显示所有执行观测的位置的 2D 或 3D 要素类。
String
include_subdirectories
(可选)

指定是否使用输入文件夹的子目录中的文件。

  • INCLUDE_SUBDIRECTORIES将使用所有子目录中的所有 netCDF 文件。
  • DO_NOT_INCLUDE_SUBDIRECTORIES仅使用输入文件夹中的文件。 这是默认设置。
Boolean
in_cf_metadata
(可选)

具有 .ncml 扩展名的 XML 格式文件,将为输入 netCDF 文件提供缺失或更改的 CF 信息。

File
analysis_extent
(可选)

Extent 类决定输出栅格数据集的范围。

Extent 类的形式如下:

  • Extent (XMin, YMin, XMax, YMax)

    其中:

    • XMin - 范围的 XMin 值
    • YMin - 范围的 YMin 值
    • XMax - 范围的 XMax 值
    • YMax - 范围的 YMax 值

Extent

派生输出

名称说明数据类型
out_point_or_polyline

输出点或折线要素类。

Feature Class
out_table

输出表。

Table

代码示例

NetCDFTrajectoriesToFeatureClass 示例 1(Python 窗口)

此示例从 NOAA 的 netCDF DSG 轨迹文件创建一个要素类和一个表。

import arcpy
arcpy.md.NetCDFTrajectoriesToFeatureClass(r"C:\AMLR\amlr_202002160447.nc", r"C:\ArcGIS\Projects\output.gdb", 
										  "amlr", "temperature", None, "amrl_table", "ROUTE_AND_EVENT", 
										  "INCLUDE_SUBDIRECTORIES", None, "DEFAULT")
NetCDFTrajectoriesToFeatureClass 示例 2(独立脚本)

此示例从飓风轨迹的 netCDF DSG 轨迹文件创建一个要素类和一个表。

# Name: NetCDFTrajectoriesToFeatureClass_Ex_02.py
# Description: Creates a polyline feature class from a netCDF DSG trajectories file of hurricane track. 

# Import system modules
Import arcpy  

# Set the local variables 
in_files_or_folders = r"C:\IBTrACS\Katrina"  
target_workspace = r"C:\outputs\hurricane.gdb" 
out_point_or_polyline_name = "Katrina_2005" 
observation_variables = "wind_speed" 
out_table_name = "" 
instance_variables = "" 
out_schema = "ROUTE_AND_EVENT" 
include_subdirectories = "DO_NOT_INCLUDE_SUBDIRECTORIES" 
in_cf_metadata = "" 
analysis_extent = "" 

# Execute NetCDFTrajectoriesToFeatureClass
arcpy.md.NetCDFTrajectoriesToFeatureClass(in_files_or_folders, target_workspace,
                                      out_point_or_polyline_name, observation_variables,
                                      out_table_name, instance_variables, out_schema,
                                      include_subdirectories, in_cf_metadata,
                                      analysis_extent)