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

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

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

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

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

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

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

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

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

  • Для параметра Переменные экземпляра (instance_variables в Python) можно выбрать несколько переменных экземпляра.

  • Если входные файлы NetCDF содержат переменные, организованные в группы, в параметре Переменные экземпляра будут указаны абсолютные пути к переменным с косой чертой ("/"), указывающей местоположение относительно корневой группы. Например, переменная precip, расположенная в группе /g1, будет показана как /g1/precip.

  • Несколько файлов точек netCDF DSG, которые заданы как отдельные файлы или папки, можно преобразовать в один класс пространственных объектов с уникальным полем instanceID. Для переменных экземпляра сопоставление выполняется по имени переменной. Это означает, что если две переменные в разных файлах NetCDF имеют одно и то же имя, они будут расценены как представляющие одну и ту же вещь. Если переменные присутствуют в группах, то при сопоставлении имен переменных учитываются их абсолютные пути. Если несколько переменных с одинаковыми именами находятся в разных местах относительно корневой группы (например, /g1/precip и /g2/precip), они будут интерпретироваться как представляющие разные объекты.

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

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

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

  • Будет создан класс точечных 2D- или 3D-объектов, содержащий всю информацию о местоположении вместе со значениями данных для выбранного значения параметра Переменные экземпляра.

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

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

Параметры

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

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

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

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

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

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

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

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

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

String
Включить поддиректории
(Дополнительный)

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

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

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

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

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

Extent

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

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

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

Feature Class

arcpy.management.NetCDFPointsToFeatureClass(in_files_or_folders, target_workspace, out_point_name, {instance_variables}, {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_name

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

String
instance_variables
[instance_variables,...]
(Дополнительный)

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

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

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

Feature Class

Пример кода

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

В этом примере создается класс точечных объектов из папки, содержащей файлы точек netCDF DSG из набора данных SWOT, где переменные расположены внутри групп.

import arcpy
arcpy.md.NetCDFPointsToFeatureClass(r"C:\SWOT", r"C:\ArcGIS\Projects\output.gdb",
                                    "swot_water_frac", "water_frac", 
				    "INCLUDE_SUBDIRECTORIES", None, "DEFAULT")
NetCDFPointsToFeatureClass, пример 2 (автономный скрипт)

В этом примере создается класс объектов из набора файлов точек netCDF DSG из MADIS с файлом .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)