地形转栅格 (3D Analyst 工具)

汇总

将点、线和面数据插值成符合真实地表的栅格表面。

用法

如果所有输入数据都存储在同一平面坐标系中且 Z 单位相同，则会获得最佳结果。您可以使用尚未投影的数据（纬度-经度），但是结果可能并不精确，尤其是高纬度地区的结果。
如果在一个输出像元内落入多个输入点，地形转栅格将使用平均值进行插值（仅考虑位于像元内的前 100 个点，将忽略剩余点）。如果算法遇到太多点，则可能会出现错误，表明点数据集中的点过多。可用的最大点数为 NRows * NCols，其中 NRows 表示输出栅格中的行数，而 NCols 则表示列数。
如果输入要素数据类型为等值线，则算法将先根据等值线的曲率生成概化的表面形态。然后该算法会将等值线作为高程信息的源。等值线最适合大比例数据，因为此时等值线和拐角可准确地指示出河流和山脊。在较小比例下，对等值线的拐角点进行数字化并将其用作输入点要素类可能同样有效且消耗更少。
输出像元大小参数可以通过数值进行定义，也可以从现有栅格数据集获取。如果没有将像元大小明确指定为参数值，则将从像元大小环境获取相应值（前提是已指定环境）。如果未指定参数像元大小或环境像元大小，但已设置了捕捉栅格环境，则将使用捕捉栅格的像元大小。如果未任何内容，则像元大小会通过使用范围的宽度或高度中的较小值除以 250 来计算，其中范围位于在环境中指定的输出坐标系内。
如果使用数值指定了像元大小，工具将直接将其用于输出栅格。

如果使用栅格数据集指定了像元大小，则参数将显示栅格数据集的路径而不是像元大小值。该栅格数据集的像元大小将直接用于分析，前提是数据集的空间参考与输出空间参考相同。如果数据集的空间参考与输出空间参考不同，将根据指定的像元大小投影方法值进行投影。
表示纵横交错的河流或使用弧段表示河流的两侧时可能并不会产生准确的结果。河流数据的优先级始终高于点或等值线数据，因此与表示河流下行的实际情况冲突的高程数据点将被忽略。使用河流数据是为插值添加地形信息的有效途径，进而保证了输出 DEM 的质量。
对于支持空值的数据格式（例如文件地理数据库要素类），当用作输入时，空值将被忽略。
容差 1 和容差 2 设置的典型值为：
- 对于比例为 1:100,000 的点数据，请分别使用 5.0 和 200.0。
- 对于比例高达 1:500,000 的较不密集的点数据，请分别使用 10.0 和 400.0。
- 对于等值线间距为 10 的等值线数据，请分别使用 5.0 和 100.0。
容差 2 应至少为容差 1 的 6 倍。
要使带有输入和参数的实验更简便，可使用地形转栅格对话框创建一个输出参数文件，此文件可在任何文本编辑器中进行修改，然后用作依据文件实现地形转栅格工具的输入。
此工具是一个占用大量内存的应用程序，因此不能创建较大的输出栅格。需要创建较大的输出时，可使用像元边距参数生成较小的输出栅格。有关此操作的详细信息，请参阅“地形转栅格工作原理”帮助的创建并镶嵌栅格部分。

标注	说明	数据类型
输入要素数据	包含要插值到表面栅格中的 z 值的输入要素。每个要素输入均可具有一个包含 z 值的特定字段并可指定为六种输入类型之一。要素图层 -输入要素数据集。字段 -用于存储属性的字段名称（适当时）。类型 -输入要素数据集的类型。共有九种支持的输入类型：点高程 -表示表面高程的点要素类。 “字段”用于存储点的高程。等值线 -表示高程等值线的线要素类。 “字段” 用于存储等值线的高程。河流 -河流位置的线要素类。所有弧线必须定向为指向下游。要素类中应该仅包含单条弧线组成的河流。此输入类型没有“字段”选项。汇 -表示已知地形凹陷的点要素类。此工具不会试图将任何明确指定为汇的点从分析中移除。所用字段应存储了合理的汇高程。如果选择了 NONE，将仅使用凹陷的位置。边界 -包含表示输出栅格外边界的单个面的要素类。在输出栅格中，位于此边界以外的像元将为 NoData。此选项可用于在创建最终输出栅格之前沿海岸线裁剪出水域。此输入类型没有“字段”选项。湖泊 -指定湖泊位置的面要素类。湖面内的所有输出栅格像元均将指定为使用沿湖岸线所有像元高程值中最小的那个高程值。此输入类型没有“字段”选项。悬崖 -悬崖的线要素类。必须对悬崖线要素进行定向以使线的左侧位于悬崖的低侧，线的右侧位于悬崖的高侧。此输入类型没有“字段”选项。排除 -其中的输入数据应被忽略的区域的面要素类。这些面允许从插值过程中移除高程数据。通常将其用于移除与堤壁和桥相关联的高程数据。这样就可以内插带有连续地形结构的基础山谷。此输入类型没有“字段”选项。海岸 -包含沿海地区轮廓的面要素类。位于这些面之外的最终输出栅格中的像元会被设置为小于用户所指定的最小高度限制的值。此输入类型没有“字段”选项。	TopoInput
输出表面栅格	输出插值后的表面栅格。总为浮点栅格。	Raster Dataset
输出像元大小（可选）	将创建的输出栅格的像元大小。该参数可以通过数值定义，也可以从现有的栅格数据集获取。在像元大小未明确指定为参数值的情况下，如果指定了环境像元大小值，则将使用该值；否则，将使用附加规则，根据其他输入来计算该值。有关详细信息，请参阅使用方法部分。	Analysis Cell Size
输出范围（可选）	输出栅格数据集的范围。插值可能会超出 x 和 y 坐标范围，在此范围之外的像元将为 NoData。要在输出栅格边界上获得最佳插值结果，四边的 x 和 y 坐标界限应该比输入数据的范围至少小 10 个像元。默认范围是输入要素数据所有范围中的最大范围。当前显示范围 - 范围基于活动地图或场景。绘制范围 - 范围将基于在地图或场景上绘制的矩形。图层范围 - 范围基于活动地图图层。选择可用图层或者使用所有图层中的数据范围选项。每个地图图层具有以下选项：所有要素 - 所有要素的范围。选定要素 - 选定要素的范围。可见要素 - 可见要素的范围。浏览 - 范围将基于数据集。剪贴板 - 可在剪贴板中复制和粘贴范围。复制范围 - 将范围坐标和坐标系复制到剪贴板。粘贴范围 - 从剪贴板粘贴范围和坐标系。如果剪贴板不包含坐标系，则范围将使用地图的坐标系。重置范围 - 将范围重置为默认值。当手动提供坐标时，坐标必须为数值，并且位于活动地图的坐标系中。地图可能使用与提供的坐标不同的显示单位。在南纬和西经坐标中使用负号。	Extent
像元边距（可选）	在超出指定输出范围和边界外进行像元插值的距离。该值必须大于或等于 0（零）。默认值为 20。如果输出范围和边界要素数据集与输入数据的界限相同（默认值），则沿 DEM 边内插的值与相邻的 DEM 数据将无法很好的匹配。这是因为插值时使用的是四周均环绕输入数据的点，仅相当于栅格内一半点数的数据。像元边距选项允许在插值中使用超出这些界限的输入数据。	Long
插值所用的最小 z 值（可选）	插值所用的最小 z 值。默认值比所有输入值中最小的值低 20%。	Double
插值所用的最大 z 值（可选）	插值所用的最大 z 值。默认值比所有输入值中最大的值高 20%。	Double
地形强化（可选）	要应用的地形强化类型。可对地形强化选项进行设置以便移除所有汇或洼地，从而创建符合真实地表的 DEM。如果输入要素数据中已明确指出这些凹陷点，则这些洼地将不会被填充。 Enforce—The algorithm will attempt to remove all sinks it encounters, whether they are real or spurious. This is the default. Do not enforce—No sinks will be filled. Enforce with sink—Points identified as sinks in Input feature data represent known topographic depressions and will not be altered. Any sink not identified in input feature data is considered spurious, and the algorithm will attempt to fill it.Having more than 8,000 spurious sinks causes the tool to fail.	String
输入数据的主要类型（可选）	输入要素数据的主要高程数据类型。指定相关的选项可优化河流和山脊生成期间所用搜索方法。 Contour—The dominant type of input data will be elevation contours. This is the default. Spot—The dominant type of input will be point.	String
最大迭代次数（可选）	插值迭代的最大次数。迭代次数必须大于零。通常，默认值 20 适合等值线数据也适合线数据。值 30 可清除少量的汇。在极少数情况下，设置成更高的值 (45–50) 可能适合于清除更多的汇或设置更多的山脊和河流。达到最大迭代次数后，各格网分辨率的迭代将停止。	Long
粗糙度惩罚系数（可选）	作为粗糙度衡量指标的二阶导数平方积分。粗糙度惩罚系数必须大于等于零。如果主要输入数据类型为等值线，则默认值为零。如果主要数据类型为点，则默认值为 0.5。通常不建议使用更大的值。	Double
离散误差系数（可选）	离散误差系数用于在将输入数据转换为栅格时调整平滑量。值必须大于零。正常的调整范围是 0.25 到 4，默认值为 1。值越小，数据的平滑处理就越少；而值越大，平滑处理也就越多。	Double
垂直标准差（可选）	输入数据 z 值中的随机误差量。该值必须大于等于零。默认值为零。如果数据的垂直误差的方差一致性检验为显著随机（非系统），则垂直标准误差可设置为较小的正值。这种情况下，请将垂直标准误差设置为这些误差的标准差。对于大多数高程数据集，垂直误差应该设置为零，但当通过河流线数据对点数据进行栅格化时，可能会将其设置为较小的正值以稳定收敛。	Double
容差 1 （可选）	此容差可反映出高程点相对于表面地形的精度和密度。对于点数据集，请将容差设置为数据高度的标准误差。对于等值线数据集，请使用平均等值线间距的一半。该值必须大于等于零。如果数据类型为等值线，则默认值为 2.5；如果数据类型为点，则默认值为零。	Double
容差 2 （可选）	此容差将通过极大的界限值防止产生地形间隙。值必须大于零。如果数据类型为等值线，则默认值为 100；如果数据类型为点，则默认值为 200。	Double
输出河流折线要素（可选）	河流折线要素和山脊线要素的输出线要素类。线要素创建于插值过程开始之时。它提供了插值表面的大致形态。此值可用于通过比较已知河流和山脊数据验证地形和形态的正确性。折线要素按如下方式编码：不在悬崖上的输入河流线。在悬崖上的输入河流线（瀑布）。 3, 清除伪汇的地形强化。从等值线拐角确定的河流线。从等值线拐角确定的山脊线。未使用代码。数据河流线边条件。未使用代码。表示大型高程数据间隙的线。	Feature Class
输出其余汇点要素（可选）	其余汇点要素的输出点要素类。这些汇未在汇输入要素数据中进行指定且在地形强化期间未被清除。调整容差值（容差 1 和容差 2）可减少其余汇的数量。其余汇通常用于指示输入数据中地形加强算法无法解决的误差。这是检测微小高程误差的有效方法。	Feature Class
输出诊断文件（可选）	此输出诊断文件列出了使用的所有输入和参数以及各分辨率和迭代中清除的凹陷数。	File
输出参数文件（可选）	此输出参数文件列出了使用的所有输入和参数，该文件可与依据文件实现地形转栅格结合使用以便再次运行插值。	File
剖面曲率粗糙度惩罚系数（可选）	剖面曲率粗糙度惩罚系数是一个可用于部分替换总曲率的局部自适应惩罚系数。使用高质量的等值线数据会获得良好的成果，但是对于质量差的数据，会导致收敛不稳定。对于无剖面曲率，设置为 0.0（默认值）；对于中等剖面曲率，设置为 0.5；对于最大剖面曲率，设置为 0.8。不建议并且也不应使用大于 0.8 的值。	Double
输出残差点要素（可选）	由局部离散误差缩放的所有大高程残差的输出点要素类。应对所有大于 10 的比例缩放残差进行检查，查看输入高程和河流数据是否存在错误。大比例缩放残差表示输入高程数据和河流线数据之间存在冲突。这可能也与不良的自动地形强化有关。这些冲突可以通过在首次检查和纠正现有输入数据中的错误后提供附加的流线和/或点高程数据来进行修复。大的未缩放残差通常指示输入高程错误。	Feature Class
输出河流和悬崖错误点要素（可选）	可能发生河流和悬崖错误的位置的输出点要素类。可从点要素类来识别其河流有闭合环、支流和悬崖上河流的位置。还可识别相邻像元与悬崖高低边不一致的的悬崖。这可能是个很好的指标，指示方向不正确的悬崖。点按如下方式编码：数据河流线网络中的真回路。以外栅格编码的河流网络中的回路。通过连接湖泊的河流网络中的回路。支流点。悬崖上的河流（瀑布）。表示从湖泊流出多条河流的点。未使用代码。悬崖旁高度与悬崖方向不一致的点。未使用代码。已移除圆形支流。无流入河流的支流。不同于出现数据河流线支流位置的输出像元中的栅格化支流。处理边条件时出错 - 非常复杂的河流线数据的指示符。	Feature Class
输出等值线错误点要素（可选）	与输入等值线数据有关的可能误差的输出点要素类。高度偏差达到输出栅格所示等值线值标准偏差五倍以上的等值线会报告至此要素类。与不同高程值的等值线相连接的等值线在此要素类中会使用代码 1 进行标记，这是等值线标注错误的明确标志。	Feature Class

arcpy.3d.TopoToRaster(in_topo_features, out_surface_raster, {cell_size}, {extent}, {Margin}, {minimum_z_value}, {maximum_z_value}, {enforce}, {data_type}, {maximum_iterations}, {roughness_penalty}, {discrete_error_factor}, {vertical_standard_error}, {tolerance_1}, {tolerance_2}, {out_stream_features}, {out_sink_features}, {out_diagnostic_file}, {out_parameter_file}, {profile_penalty}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})

名称	说明	数据类型
in_topo_features [topo_input,...]	包含要插值到表面栅格中的 z 值的输入要素。每个要素输入均可具有一个包含 z 值的特定字段并可指定为六种输入类型之一。 `<Feature Layer>`—输入要素数据集。 `{Field}`—用于存储属性的字段的名称（适用时）。 `{Type}`—输入要素数据集的类型。共有六种支持的输入类型： `POINTELEVATION`—表示表面高程的点要素类。 “字段”用于存储点的高程。 `CONTOUR`—表示高程等值线的线要素类。 “字段” 用于存储等值线的高程。 `STREAM`—河流位置的线要素类。所有弧线必须定向为指向下游。要素类中应该仅包含单条弧线组成的河流。此输入类型没有“字段”选项。 `SINK`—表示已知地形凹陷的点要素类。地形转栅格不会试图将任何明确指定为汇的点从分析中移除。所用字段应存储了合理的汇高程。如果选择了 NONE，将仅使用凹陷的位置。 `BOUNDARY`—包含表示输出栅格外边界的单个面的要素类。在输出栅格中，位于此边界以外的像元将为 NoData。此选项可用于在创建最终输出栅格之前沿海岸线裁剪出水域。此输入类型没有“字段”选项。 `LAKE`—指定湖泊位置的面要素类。湖面内的所有输出栅格像元均将指定为使用沿湖岸线所有像元高程值中最小的那个高程值。此输入类型没有“字段”选项。 `CLIFF`—悬崖的线要素类。必须对悬崖线要素进行定向以使线的左侧位于悬崖的低侧，线的右侧位于悬崖的高侧。此输入类型没有“字段”选项。 `COAST`—包含沿海地区轮廓的面要素类。位于这些面之外的最终输出栅格中的像元会被设置为小于用户所指定的最小高度限制的值。此输入类型没有“字段”选项。 `EXCLUSION`—其中的输入数据应被忽略的区域的面要素类。这些面允许从插值过程中移除高程数据。通常将其用于移除与堤壁和桥相关联的高程数据。这样就可以内插带有连续地形结构的基础山谷。此输入类型没有“字段”选项。多个输入要素数据集应置于双引号中。各项输入以分号分隔，每个组件间都有一个空格。有关示例，请参阅下面的第一个代码示例。	TopoInput
out_surface_raster	输出插值后的表面栅格。总为浮点栅格。	Raster Dataset
cell_size （可选）	将创建的输出栅格的像元大小。该参数可以通过数值定义，也可以从现有的栅格数据集获取。在像元大小未明确指定为参数值的情况下，如果指定了环境像元大小值，则将使用该值；否则，将使用附加规则，根据其他输入来计算该值。有关详细信息，请参阅使用方法部分。	Analysis Cell Size
extent （可选）	输出栅格数据集的范围。插值可能会超出 x 和 y 坐标范围，在此范围之外的像元将为 NoData。要在输出栅格边界上获得最佳插值结果，四边的 x 和 y 坐标界限应该比输入数据的范围至少小 10 个像元。默认范围是输入要素数据所有范围中的最大范围。 `MAXOF` - 将使用的所有输入的最大范围。 `MINOF` - 将使用的所有输入共用的最小范围。 `DISPLAY` - 范围与可见显示范围相等。图层名称 - 将使用指定图层的范围。 `Extent` 对象 - 将使用指定对象的范围。以空格分隔的坐标字符串 - 将使用指定字符串的范围。坐标按 x-min、y-min、x-max、y-max 的顺序表示。	Extent
Margin （可选）	在超出指定输出范围和边界外进行像元插值的距离。该值必须大于或等于 0（零）。默认值为 20。如果 `extent` 和 `Boundary` 要素数据集与输入数据的界限相同（默认值），则沿 DEM 边内插的值与相邻的 DEM 数据将无法很好的匹配。这是因为插值时使用的是四周均环绕输入数据的点，仅相当于栅格内一半点数的数据。 `Margin` 选项允许在插值中使用超出这些界限的输入数据。	Long
minimum_z_value （可选）	插值所用的最小 z 值。默认值比所有输入值中最小的值低 20%。	Double
maximum_z_value （可选）	插值所用的最大 z 值。默认值比所有输入值中最大的值高 20%。	Double
enforce （可选）	要应用的地形强化类型。可对地形强化选项进行设置以便移除所有汇或洼地，从而创建符合真实地表的 DEM。如果输入要素数据中已明确指出这些凹陷点，则这些洼地将不会被填充。 `ENFORCE`—The algorithm will attempt to remove all sinks it encounters, whether they are real or spurious. This is the default. `NO_ENFORCE`—No sinks will be filled. `ENFORCE_WITH_SINK`—Points identified as sinks in Input feature data represent known topographic depressions and will not be altered. Any sink not identified in input feature data is considered spurious, and the algorithm will attempt to fill it.Having more than 8,000 spurious sinks causes the tool to fail.	String
data_type （可选）	输入要素数据的主要高程数据类型。指定相关的选项可优化河流和山脊生成期间所用搜索方法。 `CONTOUR`—The dominant type of input data will be elevation contours. This is the default. `SPOT`—The dominant type of input will be point.	String
maximum_iterations （可选）	插值迭代的最大次数。迭代次数必须大于零。通常，默认值 20 适合等值线数据也适合线数据。值 30 可清除少量的汇。在极少数情况下，设置成更高的值 (45–50) 可能适合于清除更多的汇或设置更多的山脊和河流。达到最大迭代次数后，各格网分辨率的迭代将停止。	Long
roughness_penalty （可选）	作为粗糙度衡量指标的二阶导数平方积分。粗糙度惩罚系数必须大于等于零。如果主要输入数据类型为 `CONTOUR`，则默认值为零。如果主要数据类型为 `SPOT`，则默认值为 0.5。通常不建议使用更大的值。	Double
discrete_error_factor （可选）	离散误差系数用于在将输入数据转换为栅格时调整平滑量。值必须大于零。正常的调整范围是 0.25 到 4，默认值为 1。值越小，数据的平滑处理就越少；而值越大，平滑处理也就越多。	Double
vertical_standard_error （可选）	输入数据 z 值中的随机误差量。该值必须大于等于零。默认值为零。如果数据的垂直误差的方差一致性检验为显著随机（非系统），则垂直标准误差可设置为较小的正值。这种情况下，请将垂直标准误差设置为这些误差的标准差。对于大多数高程数据集，垂直误差应该设置为零，但当通过河流线数据对点数据进行栅格化时，可能会将其设置为较小的正值以稳定收敛。	Double
tolerance_1 （可选）	此容差可反映出高程点相对于表面地形的精度和密度。对于点数据集，请将容差设置为数据高度的标准误差。对于等值线数据集，请使用平均等值线间距的一半。该值必须大于等于零。如果数据类型为 `CONTOUR`，则默认值为 2.5；如果数据类型为 `SPOT`，则默认值为零。	Double
tolerance_2 （可选）	此容差将通过极大的界限值防止产生地形间隙。值必须大于零。如果数据类型为 `CONTOUR`，则默认值为 100；如果数据类型为 `SPOT`，则默认值为 200。	Double
out_stream_features （可选）	河流折线要素和山脊线要素的输出线要素类。线要素创建于插值过程开始之时。它提供了插值表面的大致形态。此值可用于通过比较已知河流和山脊数据验证地形和形态的正确性。折线要素按如下方式编码：不在悬崖上的输入河流线。在悬崖上的输入河流线（瀑布）。 3, 清除伪汇的地形强化。从等值线拐角确定的河流线。从等值线拐角确定的山脊线。未使用代码。数据河流线边条件。未使用代码。表示大型高程数据间隙的线。	Feature Class
out_sink_features （可选）	其余汇点要素的输出点要素类。这些汇未在汇输入要素数据中进行指定且在地形强化期间未被清除。调整容差值（`tolerance_1` 和 `tolerance_2`）可减少其余汇的数量。其余汇通常用于指示输入数据中地形加强算法无法解决的误差。这是检测微小高程误差的有效方法。	Feature Class
out_diagnostic_file （可选）	此输出诊断文件列出了使用的所有输入和参数以及各分辨率和迭代中清除的凹陷数。	File
out_parameter_file （可选）	此输出参数文件列出了使用的所有输入和参数，该文件可与依据文件实现地形转栅格结合使用以便再次运行插值。	File
profile_penalty （可选）	剖面曲率粗糙度惩罚系数是一个可用于部分替换总曲率的局部自适应惩罚系数。使用高质量的等值线数据会获得良好的成果，但是对于质量差的数据，会导致收敛不稳定。对于无剖面曲率，设置为 0.0（默认值）；对于中等剖面曲率，设置为 0.5；对于最大剖面曲率，设置为 0.8。不建议并且也不应使用大于 0.8 的值。	Double
out_residual_feature （可选）	由局部离散误差缩放的所有大高程残差的输出点要素类。应对所有大于 10 的比例缩放残差进行检查，查看输入高程和河流数据是否存在错误。大比例缩放残差表示输入高程数据和河流线数据之间存在冲突。这可能也与不良的自动地形强化有关。这些冲突可以通过在首次检查和纠正现有输入数据中的错误后提供附加的流线和/或点高程数据来进行修复。大的未缩放残差通常指示输入高程错误。	Feature Class
out_stream_cliff_error_feature （可选）	可能发生河流和悬崖错误的位置的输出点要素类。可从点要素类来识别其河流有闭合环、支流和悬崖上河流的位置。还可识别相邻像元与悬崖高低边不一致的的悬崖。这可能是个很好的指标，指示方向不正确的悬崖。点按如下方式编码：数据河流线网络中的真回路。以外栅格编码的河流网络中的回路。通过连接湖泊的河流网络中的回路。支流点。悬崖上的河流（瀑布）。表示从湖泊流出多条河流的点。未使用代码。悬崖旁高度与悬崖方向不一致的点。未使用代码。已移除圆形支流。无流入河流的支流。不同于出现数据河流线支流位置的输出像元中的栅格化支流。处理边条件时出错 - 非常复杂的河流线数据的指示符。	Feature Class
out_contour_error_feature （可选）	与输入等值线数据有关的可能误差的输出点要素类。高度偏差达到输出栅格所示等值线值标准偏差五倍以上的等值线会报告至此要素类。与不同高程值的等值线相连接的等值线在此要素类中会使用代码 1 进行标记，这是等值线标注错误的明确标志。	Feature Class

代码示例

TopoToRaster 示例 1（Python 窗口）

该示例根据点、线和面数据创建符合真实地表的 Grid 表面栅格。

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.ddd.TopoToRaster("C:/data/spots.shp spot_meters PointElevation; C:/data/contours.shp spot_meters Contour; C:/data/cliff.shp # Cliff",
                       "c:/output/toporast", 32, "740825 4309275 748825 4317275",
                       "20","","","ENFORCE","CONTOUR","40","","1","0")

TopoToRaster 示例 2（独立脚本）

该示例根据点、线和面数据创建符合真实地表的 Grid 表面栅格。

# Name: TopoToRaster_3D_Ex_02.py
# Description: Interpolates a hydrologically correct surface
#              from point, line, and polygon data.
# Requirements: 3D Analyst extension

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inPointElevations = "C:/data/spots.shp spot_meters PointElevation"
inContours = "C:/data/contours.shp spot_meters Contour"
inFeatures = (inPointElevations + ";" + inContours)
outRaster = "C:/output/topoout"

# Run TopoToRaster
arcpy.ddd.TopoToRaster(inFeatures, outRaster)

环境

自动提交, 像元大小, 像元大小投影方法, 当前工作空间, 默认输出 Z 值, 范围, 地理变换, 掩膜, M 分辨率, M 容差, 输出配置关键字, 输出坐标系, 输出包含 M 值, 输出包含 Z 值, 输出 M 值域, 输出 XY 值域, 输出 Z 值域, 临时工作空间, 捕捉栅格, 切片大小, 传递字段属性域描述, XY 分辨率, XY 容差, Z 分辨率, Z 容差

许可信息

基本: 需要 3D Analyst 或 Spatial Analyst
标准: 需要 3D Analyst 或 Spatial Analyst
高级: 需要 3D Analyst 或 Spatial Analyst

标注	说明	数据类型
输入要素数据	包含要插值到表面栅格中的 z 值的输入要素。每个要素输入均可具有一个包含 z 值的特定字段并可指定为六种输入类型之一。要素图层 -输入要素数据集。字段 -用于存储属性的字段名称（适当时）。类型 -输入要素数据集的类型。共有九种支持的输入类型：点高程 -表示表面高程的点要素类。 “字段”用于存储点的高程。等值线 -表示高程等值线的线要素类。 “字段” 用于存储等值线的高程。河流 -河流位置的线要素类。所有弧线必须定向为指向下游。要素类中应该仅包含单条弧线组成的河流。此输入类型没有“字段”选项。汇 -表示已知地形凹陷的点要素类。此工具不会试图将任何明确指定为汇的点从分析中移除。所用字段应存储了合理的汇高程。如果选择了 NONE，将仅使用凹陷的位置。边界 -包含表示输出栅格外边界的单个面的要素类。在输出栅格中，位于此边界以外的像元将为 NoData。此选项可用于在创建最终输出栅格之前沿海岸线裁剪出水域。此输入类型没有“字段”选项。湖泊 -指定湖泊位置的面要素类。湖面内的所有输出栅格像元均将指定为使用沿湖岸线所有像元高程值中最小的那个高程值。此输入类型没有“字段”选项。悬崖 -悬崖的线要素类。必须对悬崖线要素进行定向以使线的左侧位于悬崖的低侧，线的右侧位于悬崖的高侧。此输入类型没有“字段”选项。排除 -其中的输入数据应被忽略的区域的面要素类。这些面允许从插值过程中移除高程数据。通常将其用于移除与堤壁和桥相关联的高程数据。这样就可以内插带有连续地形结构的基础山谷。此输入类型没有“字段”选项。海岸 -包含沿海地区轮廓的面要素类。位于这些面之外的最终输出栅格中的像元会被设置为小于用户所指定的最小高度限制的值。此输入类型没有“字段”选项。	TopoInput
输出表面栅格	输出插值后的表面栅格。总为浮点栅格。	Raster Dataset
输出像元大小（可选）	将创建的输出栅格的像元大小。该参数可以通过数值定义，也可以从现有的栅格数据集获取。在像元大小未明确指定为参数值的情况下，如果指定了环境像元大小值，则将使用该值；否则，将使用附加规则，根据其他输入来计算该值。有关详细信息，请参阅使用方法部分。	Analysis Cell Size
输出范围（可选）	输出栅格数据集的范围。插值可能会超出 x 和 y 坐标范围，在此范围之外的像元将为 NoData。要在输出栅格边界上获得最佳插值结果，四边的 x 和 y 坐标界限应该比输入数据的范围至少小 10 个像元。默认范围是输入要素数据所有范围中的最大范围。当前显示范围 - 范围基于活动地图或场景。绘制范围 - 范围将基于在地图或场景上绘制的矩形。图层范围 - 范围基于活动地图图层。选择可用图层或者使用所有图层中的数据范围选项。每个地图图层具有以下选项：所有要素 - 所有要素的范围。选定要素 - 选定要素的范围。可见要素 - 可见要素的范围。浏览 - 范围将基于数据集。剪贴板 - 可在剪贴板中复制和粘贴范围。复制范围 - 将范围坐标和坐标系复制到剪贴板。粘贴范围 - 从剪贴板粘贴范围和坐标系。如果剪贴板不包含坐标系，则范围将使用地图的坐标系。重置范围 - 将范围重置为默认值。当手动提供坐标时，坐标必须为数值，并且位于活动地图的坐标系中。地图可能使用与提供的坐标不同的显示单位。在南纬和西经坐标中使用负号。	Extent
像元边距（可选）	在超出指定输出范围和边界外进行像元插值的距离。该值必须大于或等于 0（零）。默认值为 20。如果输出范围和边界要素数据集与输入数据的界限相同（默认值），则沿 DEM 边内插的值与相邻的 DEM 数据将无法很好的匹配。这是因为插值时使用的是四周均环绕输入数据的点，仅相当于栅格内一半点数的数据。像元边距选项允许在插值中使用超出这些界限的输入数据。	Long
插值所用的最小 z 值（可选）	插值所用的最小 z 值。默认值比所有输入值中最小的值低 20%。	Double
插值所用的最大 z 值（可选）	插值所用的最大 z 值。默认值比所有输入值中最大的值高 20%。	Double
地形强化（可选）	要应用的地形强化类型。可对地形强化选项进行设置以便移除所有汇或洼地，从而创建符合真实地表的 DEM。如果输入要素数据中已明确指出这些凹陷点，则这些洼地将不会被填充。 Enforce—The algorithm will attempt to remove all sinks it encounters, whether they are real or spurious. This is the default. Do not enforce—No sinks will be filled. Enforce with sink—Points identified as sinks in Input feature data represent known topographic depressions and will not be altered. Any sink not identified in input feature data is considered spurious, and the algorithm will attempt to fill it.Having more than 8,000 spurious sinks causes the tool to fail.	String
输入数据的主要类型（可选）	输入要素数据的主要高程数据类型。指定相关的选项可优化河流和山脊生成期间所用搜索方法。 Contour—The dominant type of input data will be elevation contours. This is the default. Spot—The dominant type of input will be point.	String
最大迭代次数（可选）	插值迭代的最大次数。迭代次数必须大于零。通常，默认值 20 适合等值线数据也适合线数据。值 30 可清除少量的汇。在极少数情况下，设置成更高的值 (45–50) 可能适合于清除更多的汇或设置更多的山脊和河流。达到最大迭代次数后，各格网分辨率的迭代将停止。	Long
粗糙度惩罚系数（可选）	作为粗糙度衡量指标的二阶导数平方积分。粗糙度惩罚系数必须大于等于零。如果主要输入数据类型为等值线，则默认值为零。如果主要数据类型为点，则默认值为 0.5。通常不建议使用更大的值。	Double
离散误差系数（可选）	离散误差系数用于在将输入数据转换为栅格时调整平滑量。值必须大于零。正常的调整范围是 0.25 到 4，默认值为 1。值越小，数据的平滑处理就越少；而值越大，平滑处理也就越多。	Double
垂直标准差（可选）	输入数据 z 值中的随机误差量。该值必须大于等于零。默认值为零。如果数据的垂直误差的方差一致性检验为显著随机（非系统），则垂直标准误差可设置为较小的正值。这种情况下，请将垂直标准误差设置为这些误差的标准差。对于大多数高程数据集，垂直误差应该设置为零，但当通过河流线数据对点数据进行栅格化时，可能会将其设置为较小的正值以稳定收敛。	Double
容差 1 （可选）	此容差可反映出高程点相对于表面地形的精度和密度。对于点数据集，请将容差设置为数据高度的标准误差。对于等值线数据集，请使用平均等值线间距的一半。该值必须大于等于零。如果数据类型为等值线，则默认值为 2.5；如果数据类型为点，则默认值为零。	Double
容差 2 （可选）	此容差将通过极大的界限值防止产生地形间隙。值必须大于零。如果数据类型为等值线，则默认值为 100；如果数据类型为点，则默认值为 200。	Double
输出河流折线要素（可选）	河流折线要素和山脊线要素的输出线要素类。线要素创建于插值过程开始之时。它提供了插值表面的大致形态。此值可用于通过比较已知河流和山脊数据验证地形和形态的正确性。折线要素按如下方式编码：不在悬崖上的输入河流线。在悬崖上的输入河流线（瀑布）。 3, 清除伪汇的地形强化。从等值线拐角确定的河流线。从等值线拐角确定的山脊线。未使用代码。数据河流线边条件。未使用代码。表示大型高程数据间隙的线。	Feature Class
输出其余汇点要素（可选）	其余汇点要素的输出点要素类。这些汇未在汇输入要素数据中进行指定且在地形强化期间未被清除。调整容差值（容差 1 和容差 2）可减少其余汇的数量。其余汇通常用于指示输入数据中地形加强算法无法解决的误差。这是检测微小高程误差的有效方法。	Feature Class
输出诊断文件（可选）	此输出诊断文件列出了使用的所有输入和参数以及各分辨率和迭代中清除的凹陷数。	File
输出参数文件（可选）	此输出参数文件列出了使用的所有输入和参数，该文件可与依据文件实现地形转栅格结合使用以便再次运行插值。	File
剖面曲率粗糙度惩罚系数（可选）	剖面曲率粗糙度惩罚系数是一个可用于部分替换总曲率的局部自适应惩罚系数。使用高质量的等值线数据会获得良好的成果，但是对于质量差的数据，会导致收敛不稳定。对于无剖面曲率，设置为 0.0（默认值）；对于中等剖面曲率，设置为 0.5；对于最大剖面曲率，设置为 0.8。不建议并且也不应使用大于 0.8 的值。	Double
输出残差点要素（可选）	由局部离散误差缩放的所有大高程残差的输出点要素类。应对所有大于 10 的比例缩放残差进行检查，查看输入高程和河流数据是否存在错误。大比例缩放残差表示输入高程数据和河流线数据之间存在冲突。这可能也与不良的自动地形强化有关。这些冲突可以通过在首次检查和纠正现有输入数据中的错误后提供附加的流线和/或点高程数据来进行修复。大的未缩放残差通常指示输入高程错误。	Feature Class
输出河流和悬崖错误点要素（可选）	可能发生河流和悬崖错误的位置的输出点要素类。可从点要素类来识别其河流有闭合环、支流和悬崖上河流的位置。还可识别相邻像元与悬崖高低边不一致的的悬崖。这可能是个很好的指标，指示方向不正确的悬崖。点按如下方式编码：数据河流线网络中的真回路。以外栅格编码的河流网络中的回路。通过连接湖泊的河流网络中的回路。支流点。悬崖上的河流（瀑布）。表示从湖泊流出多条河流的点。未使用代码。悬崖旁高度与悬崖方向不一致的点。未使用代码。已移除圆形支流。无流入河流的支流。不同于出现数据河流线支流位置的输出像元中的栅格化支流。处理边条件时出错 - 非常复杂的河流线数据的指示符。	Feature Class
输出等值线错误点要素（可选）	与输入等值线数据有关的可能误差的输出点要素类。高度偏差达到输出栅格所示等值线值标准偏差五倍以上的等值线会报告至此要素类。与不同高程值的等值线相连接的等值线在此要素类中会使用代码 1 进行标记，这是等值线标注错误的明确标志。	Feature Class

地形转栅格 (3D Analyst 工具)

汇总

用法

参数

环境

许可信息

相关主题