创建自定义地理（坐标）变换 (数据管理)

摘要

创建在两个地理坐标系或基准之间进行数据变换的变换定义。 该工具的输出可用作任何需要地理变换参数的工具的变换。

使用情况

• 所有的自定义地理变换文件都将存储为扩展名为 .gtf 的文件，并存储在应用程序数据文件夹中的 Esri\ArcGISPro\ArcToolbox\CustomTransformations 文件夹中。

  • 在所有 Windows 操作系统中，AppData 文件夹位于 %appdata%，临时文件夹位于 %temp%。 在命令窗口中输入 %appdata% 将返回应用程序数据文件夹位置。 输入 %temp% 将返回临时文件夹位置。
  • 在 UNIX 系统中，tmp 文件夹和应用程序数据文件夹分别位于主目录的 $TMP 和 $HOME 下。 在终端键入 /tmp 将返回该位置。

• 使用地理变换的任何地理处理工具将检查默认存储位置中的所有自定义变换，并将它们作为变换参数下拉列表中的选项呈现。 这些变换也可用于地理变换环境。

• 无法编辑自定义变换文件。 它们是存储版本和字符串长度信息的二进制文件，如果修改可能会损坏。 要更新变换文件，需创建一个新的自定义地理变换并覆盖现有文件。

• 变换方法可以分为两组：基于方程和基于文件。 基于方程的方法不需要外部信息。 基于文件的方法需要存储在磁盘上的一个或多个文件来计算坐标偏移值。 这些文件类似于具有规律间隔点的栅格，并可使用插值方法和周围点的值来计算位置的偏移量。

• 文件必须放置在以下位置之一：

  • 如果 ArcGIS Coordinate Systems Data 按计算机（针对所有人）进行安装，则需将文件复制到 C:\Program Files (x86)\ArcGIS\CoordinateSystemsData\pedata\Geographic 文件夹。
  • 如果 ArcGIS Coordinate Systems Data 按用户进行安装，则需将文件复制到 C:\Users\username\AppData\Local\Programs\ArcGIS\CoordinateSystemsData\pedata\Geographic 文件夹。
  • 如果未安装 ArcGIS Coordinate Systems Data，则需将文件复制到位于 C:\Program Files\ArcGIS\Pro\Resources\pedata 文件夹中的 ArcGIS AllSource pedata 文件夹中，其中 ArcGIS AllSource 按计算机（针对所有人）进行安装。
  • 如果 ArcGIS AllSource 按用户进行安装，则需将文件复制到位于 C:\Users\username\AppData\Local\Programs\ArcGIS\Pro\Resources\pedata 的 ArcGIS AllSource pedate 文件夹中。

  如果未使用默认安装位置安装 ArcGIS AllSource 或 ArcGIS Coordinate Systems Data，则需将文件复制到等效的 pedata 文件夹中。 如果由于权限限制或隐藏而无法访问这些位置，请咨询系统管理员以获取帮助。

参数

对话框

标注	说明	数据类型
地理变换名称	自定义变换定义的名称。	String
输入地理坐标系	起始地理坐标系统。 提供一个已知 ID (WKID) 或使用选择坐标系按钮 选择坐标系。	Coordinate System
输出地理坐标系	最终地理坐标系统。 提供一个已知 ID (WKID) 或使用选择坐标系按钮 选择坐标系。	Coordinate System
自定义地理变换	自定义变换方法。 方法和参数的列表可在《地理和垂直转换》PDF 中找到。 从下拉列表中选择用于将输入地理坐标系变换为输出地理坐标系的变换方法。 选择后，将在变换方法下方显示其他选项。	String

派生输出

标注	说明	数据类型
输出变换	输出变换。	Value Table

Python

arcpy.management.CreateCustomGeoTransformation(geot_name, in_coor_system, out_coor_system, custom_geot)

名称	说明	数据类型
geot_name	自定义变换定义的名称。	String
in_coor_system	起始地理坐标系统。	Coordinate System
out_coor_system	最终地理坐标系统。	Coordinate System
custom_geot	自定义变换方法。 方法和参数的列表可在《地理和垂直转换》PDF 中找到。 设置封装在字符串中的 METHOD 和 PARAMETER 值，用于自定义变换 GEOGTRAN。 为可用方法设置方法名称，如 Geocentric_Translation、Molodensky、Molodensky_Abridged、Position_Vector、Coordinate_Frame、Molodensky_Badekas、NADCON、HARN、NTV2、Longitude_Rotation、Unit_Change 和 Geographic_2D_Offset。 每种方法都有一组参数。 在自定义地理变换的整个字符串表示中，可以在参数名称旁边输入文本来编辑选项值。 请参阅以下 Python 示例。	String

派生输出

名称	说明	数据类型
out_transformation	输出变换。	Value Table

代码示例

CreateCustomGeoTransformation 示例（独立脚本）

以下独立脚本使用 CreateCustomGeoTransformation 函数来创建自定义变换。

# Name: CreateCustomGeographicTransformation.py
# Description: Create a custom geographic transformation in the default directory.

# import system modules
import arcpy

# set the variables
geoTransfmName = "cgt_geocentric2"

# create a spatial reference object for GCS_Tokyo
inGCS = arcpy.SpatialReference("Tokyo")

# create a spatial reference object for GCS_WGS_1984
outGCS = arcpy.SpatialReference("WGS 1984")

customGeoTransfm = "GEOGTRAN[METHOD['Geocentric_Translation'],PARAMETER['X_Axis_Translation',''],PARAMETER['Y_Axis_Translation',''],PARAMETER['Z_Axis_Translation','']]"

arcpy.management.CreateCustomGeoTransformation(geoTransfmName, inGCS, outGCS, customGeoTransfm)

环境

此工具不使用任何地理处理环境。