Создать пользовательское вертикальное преобразование (Управление данными)

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

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

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

• Любой инструмент геообработки, использующий вертикальные преобразования, проверит все пользовательские преобразования в хранилище по умолчанию и представит их в качестве параметров преобразования. В диалоговом окне Преобразования отображаются комбинированные географические и вертикальные пути преобразования, если они поддерживаются. Преобразования также будут доступны в среде Географические преобразования.

• Все файлы вертикальных географических преобразований сохраняются с расширением .vtf в директории Esri\ArcGISPro\ArcToolbox\CustomTransformations папки пользователя Application Data.

  • Во всех операционных системах Windows папка AppData находится по адресу %appdata%, а папка temp - в %temp%. Ввод %appdata% в командном окне возвращает расположение папки AppData. Ввод %temp% возвращает местоположение папки temp.
  • В системах UNIX папки tmp и Application Data расположены в домашней директории - в $TMP и $HOME, соответственно. Введите /tmp, чтобы вернуть местоположение этой папки.

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

• Этот инструмент предлагает несколько широко используемых методов преобразования по вертикали, включая GEOID, Вертикальное смещение и Вертикальное смещение с сеткой. Некоторые методы основаны на уравнениях, но для большинства методов, таких как GEOID или Вертикальное смещение с сеткой, требуется файл данных. Этот файл может быть в двоичном или ASCII формате. По соображениям производительности предпочтительнее использовать двоичный формат.

  В настоящее время в ArcGIS Pro поддерживаются следующие форматы файлов:

  • EGM84 и EGM96, созданные National Geospatial-Intelligence Agency
  • GEOID, VDATUM, VERTCON и VERTCON3, созданные NOAA's National Geodetic Survey

• Метод GEOID, который преобразует эллипсоидальные высоты в гравитационные, и метод Вертикальное смещение с сеткой, который преобразует две гравитационные системы высот, поддерживают простой формат файла ASCII. Этот формат файла используется NOAA's National Geodetic Survey. Строка заголовка содержит нижний левый угол: минимальная широта, за которой следует минимальная долгота в десятичных градусах. Необязательно использовать диапазон долготы от 0 до 360 градусов (как показано ниже). Далее указаны расстояния между точками широты и долготы, также в десятичных градусах. Следующий набор значений — это количество точек в строке и столбце. Последнее значение является контрольной цифрой и всегда равно 1. Значения смещения, или разделения, являются числами с плавающей запятой и выражаются в метрах. Первая строка начинается с минимальных значений широты и долготы. Первые три строки ниже показывают, что строка значений не обязательно должна состоять из одной строки.

      15.000000000000    291.00000000000    0.1666666666667E-01    0.1666666666665E-01    361   301  1
    -29.2936  -29.3314  -29.3710  -29.4121  -29.4540  -29.4965  -29.5382  -29.5807
    -29.6233  -29.6660  -29.7090  -29.7522  -29.7956  -29.8397  -29.8846  -29.9301

• При использовании файлового метода должен быть задан соответствующий метод интерполяции. В этом инструменте доступно несколько встроенных методов интерполяции.

• Если для вертикального преобразования используется метод, требующий наличия файла или файлов, поместите их в одно из следующих расположений:

  • Если ArcGIS Coordinate Systems Data установлены на каждый компьютер (для всех), скопируйте файл или файлы в папку C:\Program Files (x86)\ArcGIS\CoordinateSystemsData\pedata\Vertical.
  • Если ArcGIS Coordinate Systems Data установлены для каждого пользователя, скопируйте файл или файлы в папку C:\Users\username\AppData\Local\Programs\ArcGIS\CoordinateSystemsData\pedata\Vertical.
  • Если ArcGIS Coordinate Systems Data не установлены, скопируйте файл или файлы в папку ArcGIS Pro pedata по адресу C:\Program Files\ArcGIS\Pro\Resources\pedata, если ArcGIS Pro устанавливается для каждой машины (для всех).
  • Если ArcGIS Pro устанавливается для каждого пользователя, скопируйте файл или файлы в папку ArcGIS Pro обновления pedate по адресу C:\Users\username\AppData\Local\Programs\ArcGIS\Pro\Resources\pedata.

  Если вы не использовали места установки по умолчанию для ArcGIS Pro или ArcGIS Coordinate Systems Data, скопируйте файлы в эквивалентную папку pedata. Если эти папки недоступны из-за ограничений разрешений или скрыты, обратитесь за помощью к своему системному администратору.

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

Параметры

Диалог

Подпись	Описание	Тип данных
Имя вертикального преобразования	Имя пользовательского определения преобразования.	String
Вертикальная система координат источника	Исходная географическая система координат. Укажите идентификатор well known ID (WKID) или воспользуйтесь кнопкой Выбрать систему координат для выбора системы координат.	String
Вертикальная система координат цели	Конечная географическая система координат. Укажите идентификатор WKID или воспользуйтесь кнопкой Выбрать систему координат для выбора системы координат.	String
Географическая система координат интерполяции (Дополнительный)	Географическая система координат интерполяции Этот параметр активен только в том случае, если этого требует метод вертикального преобразования. Географическая система координат используется при интерполяции значений отступа из файла, или для этого метода требуются координаты широты и долготы. Методами, для которых не требуется географическая система координат интерполяции, являются Null, Unit Change (изменение единиц), Height Depth Reversal (реверс по высоте и глубине) и Vertical Offset (вертикальное смещение). Укажите идентификатор WKID или воспользуйтесь кнопкой Выбрать систему координат для выбора системы координат.	Coordinate System
Метод вертикального преобразования (Дополнительный)	Используемый метод вертикального преобразования. Из ниспадающего списка выберите метод преобразования, который будет использоваться для преобразования данных из входной вертикальной системы координат в выходную вертикальную систему координат. После выбора его параметры появятся в таблице для редактирования. Список методов и параметров доступен в документе по географическим и вертикальным преобразованиямGeographic and Vertical Transformations pdf. Если используется метод, для которого требуется файл, ознакомьтесь с Примечания по использованию, чтобы узнать, куда поместить файл или файлы.	String
Экстент (Дополнительный)	Область, в котором применимо преобразование. В качестве системы координат экстента используйте WGS84 (WKID: 4326) или другую географическую систему координат на основе GNSS, такую как NAD 1983 или GDA2020. Если указана система координат проекции или слой, имеющий систему координат проекции, значения будут конвертированы в широту и долготу. Текущий экстент отображения - экстент будет основан на активной карте или сцене. Нарисовать экстент - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Экстент слоя - экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции: Все объекты - экстент всех объектов. Выбранные объекты - экстент выбранных объектов. Отображаемые объекты - экстент отображаемых объектов. Обзор - экстент будет основан на наборе данных. Буфер обмена - экстент может быть скопирован в буфер обмена и из него. Копировать экстент - копирует экстент и систему координат в буфер обмена. Вставить экстент - вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержат систему координат, экстент будет использовать систему координат карты. Сбросить экстент - экстент будет сброшен до значения по умолчанию. Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.	Extent
Точность (Дополнительный)	Общее подтверждение точности в метрах.	Double

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

Подпись	Описание	Тип данных
Выходное преобразование	Выходное преобразование	Value Table

Python

arcpy.management.CreateCustomVerticalTransformation(vt_name, source_vt_coor_system, target_vt_coor_system, {interpolation_gcs}, {custom_vt}, {extent}, {accuracy})

Имя	Описание	Тип данных
vt_name	Имя пользовательского определения преобразования.	String
source_vt_coor_system	Исходная географическая система координат.	String
target_vt_coor_system	Конечная географическая система координат.	String
interpolation_gcs (Дополнительный)	Географическая система координат интерполяции Этот параметр активен только в том случае, если этого требует метод вертикального преобразования. Географическая система координат используется при интерполяции значений отступа из файла, или для этого метода требуются координаты широты и долготы. Методами, для которых не требуется географическая система координат интерполяции, являются Null, Unit Change (изменение единиц), Height Depth Reversal (реверс по высоте и глубине) и Vertical Offset (вертикальное смещение).	Coordinate System
custom_vt (Дополнительный)	Используемый метод вертикального преобразования. Из ниспадающего списка выберите метод преобразования, который будет использоваться для преобразования данных из входной вертикальной системы координат в выходную вертикальную систему координат. После выбора его параметры появятся в таблице для редактирования. Список методов и параметров доступен в документе по географическим и вертикальным преобразованиямGeographic and Vertical Transformations pdf. Если используется метод, для которого требуется файл, ознакомьтесь с Примечания по использованию, чтобы узнать, куда поместить файл или файлы.	String
extent (Дополнительный)	Область, в котором применимо преобразование. В качестве системы координат экстента используйте WGS84 (WKID: 4326) или другую географическую систему координат на основе GNSS, такую как NAD 1983 или GDA2020. Если указана система координат проекции или слой, имеющий систему координат проекции, значения будут конвертированы в широту и долготу. MAXOF – Будет использоваться максимальный экстент всех входных данных. MINOF – Будет использоваться минимальная область, которая является общей для всех входных данных. DISPLAY — Экстент равен видимому отображению. Имя слоя - будет использоваться тот же экстент, что и в указанном слое. Объект Extent — будет использоваться экстент указанного объекта. Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.	Extent
accuracy (Дополнительный)	Общее подтверждение точности в метрах.	Double

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

Имя	Описание	Тип данных
out_transformation	Выходное преобразование	Value Table

Пример кода

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

Следующий автономный скрипт использует функцию CreateCustomVerticalTransformation для создания пользовательского вертикального преобразования.

import arcpy
arcpy.management.CreateCustomVerticalTransformation(
    vt_name="NAD_1983_2011_ellipsoid_to_GEOID18b",
    source_vt_coor_system='VERTCS["NAD_1983_2011",DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Meter",1.0]]',
    target_vt_coor_system='VERTCS["NAVD88_height_(ftIntl)",VDATUM["North_American_Vertical_Datum_1988"],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Foot",0.3048]]',
    interpolation_gcs='GEOGCS["GCS_NAD_1983_2011",DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]',
    custom_vt="GEOID|g2018u0.bin|Bilinear",
    extent='-110 30 -80 40 GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]',
    accuracy=0.5
)

Параметры среды

Этот инструмент не использует параметры среды геообработки

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

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