Траектории NetCDF в класс объектов (Геометрия дискретной выборки) (Многомерный)

Краткая информация

Создает класс пространственных объектов из траекторий в файлах netCDF. В соглашении о метаданных климата и прогноза (CF), траектория - это тип геометрии дискретной выборки (DSG).

Более подробно о том, как работают инструменты NetCDF Геометрии дискретной выборки (DSG)

Использование

  • В Соглашении о метаданных климата и прогноза траектория — это ряд точек данных вдоль пути, идущего через пространство с монотонно возрастающим временем.

  • Наборы геометрии дискретной выборки (DSG) характеризуются меньшей размерностью, чем пространственно-временной регион, где выполняется выборка данных.

  • Входные файлы netCDF должны быть совместимы со стандартом Climate and Forecast (CF 1.6 или позднее). Соглашения CF определяют метаданные для описания данных, представленных каждой переменной, а также пространственных и временных свойств данных.

  • Если входные файлы netCDF не совместимы с CF, вы можете указать файл Входные метаданные прогноза и климата (in_cf_metadata вPython) с дополнительными или альтернативными атрибутами. Файл Входные метаданные прогноза и климата представляет собой файл в формате XML с расширением .ncml. Атрибуты из этого файла метаданных будут дополнены или перезаписаны метаданными из файла netCDF. Файл Входные метаданные климата и прогноза также можно использовать для определения переменной заполнения грида, если его него у входного файла netCDF.

  • Тип объекта DSG определяется по переменной ID экземпляра, помеченной атрибутом cf_role. Несколько файлов netCDF с одинаковой схемой можно конвертировать в один класс объектов с уникальным полем InstanceID. У каждого файла netCDF должна быть переменная, помеченная таким же атрибутом cf_role, который будет использоваться как поле идентификатора в нескольких файлах. Агрегация будет происходить строго по измерению экземпляра этой переменной.

  • Как для переменных экземпляра, так и для переменных наблюдения сопоставление происходит по имени переменной. То есть, если две переменные в разных файлах netCDF имеют одно и то же имя, они будут интерпретироваться как представляющие одно и то же явление.

  • Можно выбрать несколько переменных экземпляра и наблюдения (номер рейса, температура, соленость и т.д.) в параметрах Переменные экземпляра (instance_variables в Python) и Переменные наблюдения (observation_variables в Python) соответственно.

  • Вы можете использовать параметр Экстент анализа (analysis_extent в Python), чтобы явно указать область выходного анализа для автономной операции инструмента или переопределить параметр среды как часть рабочего процесса. Вы можете задать экстент, указав значения, выбрав экстент отображения, выбрав слой или указав входной набор данных.

  • Значение Экстента анализа по умолчанию вычисляется на основе объединенного экстента входных файлов netCDF.

  • Если экстент не указан явно в качестве значения параметра, он будет получен из настроек среды анализа.

  • Если для параметра Выходная схема указана опция Маршрут и событие (out_schema = "ROUTE_AND_EVENT" в Python), будут созданы два результата. Один из них представляет собой полилинейный 2D- или 3D-объект, показывающий путь траектории, с полями From Time и To Time, в которых обозначается время начала и окончания каждой траектории. Другой результат - это таблица со значениями наблюдений в каждое время записи со связанными полями с добавлением времени. Когда указана опция Точка (out_schema = "POINT" в Python), будет создан слой точечных 2D- или 3D-объектов, который показывает местоположения вдоль каждой траектории, по которой производятся наблюдения.
  • Переменная данных в файле netCDF может использовать переменную grid_mapping для явного определения системы отсчета координат (CRS), используемой для значений пространственных координат. Атрибут параметра отображения сеткиepsg_code можно использовать для выбора ГСК или СКП. Также атрибуты esri_pe_string, crs_wkt и spatial_ref можно использовать для определения строк WKT 1 или WKT 2. Если какой-либо из этих атрибутов присутствует, никакие другие атрибуты для горизонтальной системы координат не используются. Дополнительные сведения о системах координат, а также о поддерживаемых WKID см. в разделе Системы координат, проекции и преобразования.

  • Если значения пространственных координат являются трехмерными, переменная grid_mapping также должна указывать вертикальную систему координат (VCS). VCS представляет собой комбинацию вертикальной точки отсчета, линейной единицы измерения и направления (вверх или вниз), в котором увеличиваются вертикальные координаты. Датум обычно получают из атрибута переменной отображения сетки, а другие свойства получают из переменной вертикальной координаты. Произвольный вертикальный датум можно указать с помощью составной строки WKT в качестве значения одного из атрибутов WKT, перечисленных выше. Датум, основанный на гравитации, можно указать с помощью атрибута geoid_name или geopotential_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
Входные метаданные климата и прогноза
(Дополнительный)

Файл в формате XML с расширением .ncml, в котором будет предоставлена отсутствующая или измененная информация CF для входных файлов netCDF.

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
(Дополнительный)

Файл в формате XML с расширением .ncml, в котором будет предоставлена отсутствующая или измененная информация CF для входных файлов netCDF.

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)

В этом примере создается класс пространственных объектов и таблица из файла траекторий netCDF DSG от NOAA.

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)