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

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

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

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

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

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

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

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

• Файлы должны быть размещены в одном из следующих расположений:

  • Если 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 AllSource pedata по адресу C:\Program Files\ArcGIS\Pro\Resources\pedata, если ArcGIS AllSource устанавливается для каждой машины (для всех).
  • Если ArcGIS AllSource устанавливается для каждого пользователя, скопируйте файл или файлы в папку ArcGIS AllSource обновления pedate по адресу C:\Users\username\AppData\Local\Programs\ArcGIS\Pro\Resources\pedata.

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

• Большинство файлов представлены в двоичном формате по соображениям производительности. Метод GEOID, который преобразует высоты эллипсоида в высоты геоида (или другие высоты, связанные с гравитацией), поддерживает простой формат файла ASCII. Этот формат файла используется Национальной геодезической службой Соединенных Штатов. Строка заголовка содержит нижний левый угол: минимальная широта, за которой следует минимальная долгота в десятичных градусах. Необязательно использовать диапазон долготы от 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

• Не устанавливайте обе вертикальные системы координат на эллипсоидальные (геодезические) высоты. Это поведение будет заблокировано в следующей версии. Вместо этого преобразуйте геодезические высоты как часть географического преобразования (датум).

Параметры

Диалог

Подпись	Описание	Тип данных
Имя вертикального преобразования	Имя пользовательского определения преобразования.	String
Вертикальная система координат источника	Исходная географическая система координат. Укажите идентификатор well known ID (WKID) или воспользуйтесь кнопкой Выбрать систему координат , чтобы выбрать систему координат.	String
Вертикальная система координат цели	Конечная географическая система координат. Укажите идентификатор well known ID (WKID) или воспользуйтесь кнопкой Выбрать систему координат для выбора системы координат.	String
Географическая система координат интерполяции (Дополнительный)	Географическая система координат интерполяции Этот параметр активен только в том случае, если этого требует метод вертикального преобразования. Географическая система координат используется при интерполяции значений отступа из файла, или для этого метода требуются координаты широты и долготы. Методами, для которых не требуется географическая система координат интерполяции, являются Null, Unit Change (изменение единиц), Height Depth Reversal (реверс по высоте и глубине) и Vertical Offset (вертикальное смещение). Укажите идентификатор well known ID (WKID) или воспользуйтесь кнопкой Выбрать систему координат для выбора системы координат.	Coordinate System
Метод вертикального преобразования (Дополнительный)	Метод вертикального преобразования Из ниспадающего списка выберите метод преобразования, который будет использоваться для преобразования данных из входной вертикальной системы координат в выходную вертикальную систему координат. После выбора его параметры появятся в таблице для редактирования. Список методов и параметров доступен в документе по географическим и вертикальным преобразованиямGeographic and Vertical Transformations pdf. Если используется метод, для которого требуется файл, ознакомьтесь с Примечания по использованию, чтобы узнать, куда поместить файл или файлы.	String
Экстент (Дополнительный)	Экстент, в котором применимо преобразование. В качестве системы координат экстента используйте WGS84 (WKID: 4326) или другую географическую систему координат на основе GNSS, такую как NAD 1983 или GDA2020. Если указана система координат проекции или слой, имеющий систему координат проекции, значения будут конвертированы в широту и долготу. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты. Нарисовать экстент - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Эта опция создает класс пространственных объектов в базе геоданных проекта и добавляет слой на карту. Класс объектов будет иметь ту же систему координат, что и карта. Примечание: Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Среды диалогового окна инструмента. Примечание: Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент. Экстент слоя — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями. У каждого слоя карте есть следующие опции: Все объекты - экстент всех объектов слоя. Выбранные объекты - экстент всех выбранных объектов слоя. Отображаемые объекты - экстент всех отображаемых объектов слоя. Примечание: Экстенты опций Выбранные объекты и Отображаемые объекты доступны только для векторных слоев. Обзор — Экстент будет основан на существующем наборе данных. Буфер обмена - экстент может быть скопирован в буфер обмена и вставлен из него. Копировать экстент - копирует координаты экстента и систему координат в буфер обмена. Использовать Вставить экстент - вставляет координаты экстента и, дополнительно, систему координат из буфера обмена. Если значения буфера обмена не содержат систему координат, экстент будет использовать систему координат карты. Примечание: Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта ArcPy Extent: x-min, y-min, x-max, y-max и пространственная привязка. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты. Внимание: На карте могут использоваться единицы отображения, отличные от введенных координат. Использование направления по сторонам света (N, S, E, W) не поддерживается. Используйте знак отрицательного значения для координат юга и запада.	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
)

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

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