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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Если для параметра Выходная схема (out_schema = "INSTANCE_AND_OBSERVATION" в Python) задана опция Экземпляр и наблюдение, будет создан класс точечных 2D-объектов, содержащий всю информацию о местоположении вместе с выбранными полями экземпляра и связанную таблицу, содержащую выбранные переменные наблюдений. Также можно создать дополнительный слой, через который будет присоединена таблица к классу объектов на основе поля InstanceID. Если указана опция Маршрут и событие ((out_schema = "ROUTE_AND_EVENT" в Python), будут созданы два результата. Один из них представляет собой класс вертикальных полилинейных объектов с 3D-вершиной и значением измерения для каждого вертикального уровня. Другой результат - это таблица со значениями наблюдений и полями from_z и to_z. Вы можете использовать эту таблицу для создания классов событий линейной динамической сегментации вдоль профилей. Присоединяемый слой не будет создаваться для этой схемы. Когда указана опция 3D-точка (out_schema = "POINT_3D" в Python), будет создан только объект 3D-точек, содержащий все записи (все местоположения со всеми вертикальными уровнями).

  • Переменная данных в файле NetCDF может использовать переменную grid_mapping, явно указывая систему привязки координат (CRS), используемую для значений пространственных координат. Атрибут отображения сетки epsg_code может использоваться для выбора ГСК или СКП. Кроме того, атрибуты отображения сетки esri_pe_string, crs_wkt и spatial_ref могут использоваться для определения строки WKT 1 или WKT 2. Если есть какой-либо из этих атрибутов, никакие другие атрибуты для горизонтальной системы координат не используются. Поддерживаемые строки WKT 1 и WKT2, а также их дочерние элементы приведены здесь: Вертикальные системы координатСистемы координат проекции и Географические системы координат.

  • Если значения пространственных координат являются 3D, переменная grid_mapping должна также указывать вертикальную систему координат (ВСК). ВСК представляет собой комбинацию вертикального датума, линейной единицы измерения и направления (вверх или вниз), в котором увеличиваются вертикальные координаты. Датум обычно получают из атрибута переменной отображения сетки, а другие свойства - из переменной вертикальной координаты. Произвольный вертикальный датум может быть задан с помощью составной строки WKT в качестве значения одного из упомянутых выше атрибутов WKT. Датум на основе гравитации может быть задан с помощью атрибута geoid_name или geopotential_datum_name. Кроме того, косвенным образом можно указать нуль глубины приливов, используя одно из стандартных имен нулевой глубины для переменной вертикальной координаты. Если ВСК не задана, и присутствует переменная вертикальной координаты, по умолчанию будет выбрана Мгновенная глубина или высота уровня воды (epsg:5831, epsg:5829).

Параметры

ПодписьОписаниеТип данных
Входные файлы или папки NetCDF

Входные файлы NetCDF, которые будут использоваться для создания класса объектов. Могут использоваться отдельные файлы NetCDF, а также папки, содержащие несколько файлов NetCDF.

Входные файлы NetCDF должны содержать один и тот же тип и схему объектов DSG.

Folder; File
Целевая рабочая область

Многопользовательская или файловая база геоданных, в которой будет создаваться выходной класс и таблица объектов. Это должна быть существующая рабочая область.

Workspace
Имя выходной точки или полилинии

Имя класса пространственных объектов, который будет содержать местоположения из переменных netCDF. Эти переменные будут добавляться в качестве полей из параметра Переменные экземпляра.

String
Переменные наблюдений
(Дополнительный)

Переменные NetCDF, которые содержат все значения наблюдений в каждом местоположении и на каждом вертикальном уровне. Они будут добавляться в качестве полей в выходную таблицу

String
Имя выходной таблицы соединения или события
(Дополнительный)

Имя выходной таблицы, которая будет содержать все записи из переменных наблюдения.

String
Переменные экземпляра
(Дополнительный)

Переменные NetCDF, которые дифференцируют отдельные объекты и представляют местоположения, в которых проводятся наблюдения. Эти переменные будут добавляться в качестве полей в выходной класс объектов.

String
Выходная схема
(Дополнительный)

Указывает тип выходного класса пространственных объектов, который будет создан.

  • Экземпляр и наблюдениеБудет создан класс пространственных объектов, содержащий 2D-точки, которые содержат местоположение каждого экземпляра, и связанную таблицу, содержащую все переменные наблюдения. Используется по умолчанию
  • Маршрут и событиеБудет создан класс вертикальных полилинейных объектов с 3D-вершинами и таблицей линейных событий для переменных наблюдения.
  • Точки 3DБудет создан класс 3D-объектов со всеми экземплярами на всех вертикальных уровнях.
String
Включить поддиректории
(Дополнительный)

Указывает, будут ли использоваться файлы, находящиеся в подкаталогах входной папки.

  • Отмечено - будут использоваться все файлы netCDF во всех подкаталогах.
  • Не отмечено - будут использоваться только файлы во входной папке. Это значение по умолчанию
Boolean
Входные метаданные Климата и прогноза
(Дополнительный)

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

File
Экстент анализа
(Дополнительный)

Экстент, определяющий область выходного класса пространственных объектов.

Extent
Выходной присоединяемый слой
(Дополнительный)

Выходной слой, который будет создан посредством присоединения выходной таблицы к выходному классу объектов. Это дополнительный результат, доступный только в том случае, если для параметра Выходная схема указана опция Экземпляр и наблюдение.

Feature Layer

Производные выходные данные

ПодписьОписаниеТип данных
Выходная точка или полилиния

Класс объектов выходных точек или полилиний.

Feature Class
Выходная таблица соединения или события

Выходная таблица.

Table

arcpy.md.NetCDFProfilesToFeatureClass(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}, {out_join_layer})
ИмяОписаниеТип данных
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
(Дополнительный)

Указывает тип выходного класса пространственных объектов, который будет создан.

  • INSTANCE_AND_OBSERVATIONБудет создан класс пространственных объектов, содержащий 2D-точки, которые содержат местоположение каждого экземпляра, и связанную таблицу, содержащую все переменные наблюдения. Используется по умолчанию
  • ROUTE_AND_EVENTБудет создан класс вертикальных полилинейных объектов с 3D-вершинами и таблицей линейных событий для переменных наблюдения.
  • POINT_3DБудет создан класс 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_join_layer
(Дополнительный)

Выходной слой, который будет создан посредством присоединения выходной таблицы к выходному классу объектов. Это дополнительный результат, доступный только в том случае, если для параметра out_schema указана опция INSTANCE_AND_OBSERVATION.

Feature Layer

Производные выходные данные

ИмяОписаниеТип данных
out_point_or_polyline

Класс объектов выходных точек или полилиний.

Feature Class
out_table

Выходная таблица.

Table

Пример кода

NetCDFProfilesToFeatureClass, пример 1 (окно Python)

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

import arcpy
arcpy.md.NetCDFProfilesToFeatureClass(r"C:\WOD\wod_ctd_2019.nc", r"C:\ArcGIS\Projects\output.gdb", 
									  "WOD_2019", "Salinity", None, "WOD_2019_table", 
									  "INSTANCE_AND_OBSERVATION", "INCLUDE_SUBDIRECTORIES",
									  None, "DEFAULT", "WOD_2019_layer")
NetCDFProfilesToFeatureClass, пример 2 (автономный скрипт)

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

# Name: NetCDFProfilesToFeatureClass_Ex_02.py
# Description: Creates a 3D point feature class from a set of float data.

# Import system modules
Import arcpy  

# Set the local variables 
in_files_or_folders = r"C:\Argo" 
target_workspace = r"C:\outputs\argo.gdb" 
out_point_or_polyline_name = “argo_3d” 
observation_variables = “temperature;pressure” 
out_table_name = “” 
instance_variables = “” 
out_schema = “POINT_3D” 
include_subdirectories = “DO_NOT_INCLUDE_SUBDIRECTORIES” 
in_cf_metadata = “” 
analysis_extent = “” 
out_join_layer = “” 

# Execute NetCDFProfilesToFeatureClass
arcpy.md.NetCDFProfilesToFeatureClass(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, out_join_layer)

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы