构建接缝线 (数据管理)

摘要

为镶嵌数据集生成或更新接缝线。接缝线用于排序重叠影像并生成更平滑的镶嵌。

您可以使用此工具执行下列操作:

  • 针对镶嵌数据集中的所有项目生成接缝线。
  • 为使用查询或按感兴趣区域选定的项目生成接缝线。
  • 向镶嵌数据集中添加项目或从中移除项目时更新现有接缝线。

使用情况

  • 生成接缝线,从而使每个轮廓要素具有一条接缝线。

  • 不能为引用的镶嵌数据集构建接缝线。

  • 选中更新现有接缝线选项时,无法使用排序方法升序排序参数。

参数

标注说明数据类型
镶嵌数据集

选择用来构建接缝线的镶嵌数据集。

Mosaic Layer
像元大小

为之后的空间分辨率范围内的栅格数据集生成接缝线。

您可以将此参数留空,这样该工具将在适当的级别自动创建接缝线。

此参数的单位与输入镶嵌数据集的空间参照单位相同。

Double
排序方法
(可选)

设置规则以确定影像重叠时用来生成接缝线的栅格。

  • NORTH_WEST 选择中心点与边界西北角最为接近的栅格数据集。这是默认设置。
  • CLOSEST_TO_VIEWPOINT
  • BY_ATTRIBUTE 根据轮廓属性表中的属性选择栅格数据集。常用属性包括采集日期、云覆盖或视角。
String
升序排列
(可选)

按升序或降序排列栅格数据集。

  • 选中 - 按升序排列栅格。这是默认设置。
  • 未选中 - 按降序排列栅格。

Boolean
排序属性
(可选)

使用按属性排序方法时,根据该字段对栅格数据集进行排序。默认属性为 ObjectID

Field
排序基础值
(可选)

按该值与排序属性参数中栅格值的差值对栅格进行排序。

Variant
视点
(可选)

设置排序方法最接近视点时所使用的坐标位置。

Point
计算方法
(可选)

选择接缝线的构建方法。

  • GEOMETRY根据轮廓的交集为重叠区域生成接缝线。没有重叠影像的区域将合并轮廓。这是默认设置。
  • RADIOMETRY根据影像中要素的光谱图生成接缝线。
  • COPY_FOOTPRINT根据轮廓直接生成接缝线。
  • COPY_TO_SIBLING应用来自其他镶嵌数据集的接缝线。镶嵌数据集必须位于同一组中。例如,全色波段的范围并不总是与多光谱波段的范围匹配。此方法可确保它们共享相同的接缝线。
  • EDGE_DETECTION根据感兴趣区域中要素的边生成区域之间的接缝线。
  • VORONOI使用区域 Voronoi 图生成接缝线。
  • DISPARITY根据立体像对的差异图像生成接缝线。该方法可避免接缝线穿过建筑物。

排序方法参数适用于各种计算方法。

String
混合宽度
(可选)
Double
混合类型
(可选)

确定跨接缝线混合影像的方式。可在接缝线的内部混合,在接缝线的外部混合,或分别在内部和外部混合。

  • BOTH 使用接缝线的任意一侧上的像素混合。例如,如果混合宽度为 10 像素,则将在接缝线的内部和外部分别混合 5 个像素。这是默认设置。
  • INSIDE在接缝线的内部混合。
  • OUTSIDE在接缝线的外部混合。
String
请求大小
(可选)

指定用于重采样的列数和行数。最大值为 5000。基于栅格数据的复杂程度增大或减小该值。图像分辨率越高,提供的栅格数据集信息越详细,但同时也增加了处理时间。

Long
请求大小类型
(可选)

设置请求大小的单位。

  • PIXELS根据像素大小修改请求大小。这是默认选项,将根据栅格像素大小对最接近图像进行重采样。
  • PIXELSIZE_FACTOR通过指定比例因子修改请求大小。此选项通过将像元大小等级表中的栅格像素大小与像素大小因子相乘对最接近图像进行重采样。
String
混合宽度单位
(可选)

指定混合宽度的测量单位。

  • PIXELS使用像素数量进行测量 这是默认设置。
  • GROUND_UNITS使用与镶嵌数据集相同的单位进行测量。
String
感兴趣区
(可选)

为所有与此面相交的栅格构建接缝线。要指定感兴趣区域,请浏览至要素类或创建显示的面图形。

Feature Set
查询定义
(可选)

用来在镶嵌数据集中为特定栅格数据集构建接缝线的 SQL 表达式。

SQL Expression
更新现有接缝线
(可选)

更新受镶嵌数据集项目增减影响的接缝线。仅在之前已生成接缝线的情况下启用该选项,该选项使用现有排序方法和排序顺序生成接缝线。

  • 未选中 - 为所有项目重新生成接缝线并忽略可能存在的现有接缝线。这是默认设置。
  • 选中 - 仅更新没有接缝线的项目。如果新项目与之前创建的接缝线重叠,则可能影响现有接缝线。

接缝线不存在时,将禁用该参数。

Boolean
最小区域大小
(可选)

以像素为单位指定最小区域的大小。将在接缝线结果中移除小于该指定阈值的任何面。默认值为 100 像素。

此参数值应小于定义为 (最大狭长大小) * (最大狭长大小) 的狭长面积。

Long
最小薄度比率
(可选)

定义一个面要薄到怎样的程度才能被视为狭长面。它基于 0 到 1.0 之间的比例,0.0 值代表几乎为直线的面,1.0 值代表为圆的面。

构建接缝线时将移除狭长面。

Double
最大狭长大小
(可选)

指定面仍被视为狭长面时可达到的最大大小。该参数以像素为单位指定,基于请求大小而不是源栅格的空间分辨率。小于该值平方的任何面都将被视为狭长面。小于(最大狭长大小2的任何区域将被视为狭长面。

构建接缝线时将移除狭长面。

Long

派生输出

标注说明数据类型
更新的镶嵌数据集

已更新的镶嵌数据集。

镶嵌图层

arcpy.management.BuildSeamlines(in_mosaic_dataset, cell_size, {sort_method}, {sort_order}, {order_by_attribute}, {order_by_base_value}, {view_point}, {computation_method}, {blend_width}, {blend_type}, {request_size}, {request_size_type}, {blend_width_units}, {area_of_interest}, {where_clause}, {update_existing}, {min_region_size}, {min_thinness_ratio}, {max_sliver_size})
名称说明数据类型
in_mosaic_dataset

选择用来构建接缝线的镶嵌数据集。

Mosaic Layer
cell_size
[cell_size,...]

为之后的空间分辨率范围内的栅格数据集生成接缝线。

您可以将此参数留空,这样该工具将在适当的级别自动创建接缝线。

此参数的单位与输入镶嵌数据集的空间参照单位相同。

Double
sort_method
(可选)

设置规则以确定影像重叠时用来生成接缝线的栅格。

  • NORTH_WEST 选择中心点与边界西北角最为接近的栅格数据集。这是默认设置。
  • CLOSEST_TO_VIEWPOINT
  • BY_ATTRIBUTE 根据轮廓属性表中的属性选择栅格数据集。常用属性包括采集日期、云覆盖或视角。
String
sort_order
(可选)

选择按升序还是降序排列栅格。

  • ASCENDING 按升序排列栅格。这是默认设置。
  • DESCENDING 按降序排列栅格。
Boolean
order_by_attribute
(可选)

使用 BY_ATTRIBUTE 排序方法时,根据该字段对栅格数据集进行排序。默认属性为 ObjectID

Field
order_by_base_value
(可选)

按该值与 order_by_attribute 参数中栅格值的差值对栅格进行排序。

Variant
view_point
(可选)

设置 sort_methodCLOSEST_TO_VIEWPOINT 时所使用的坐标位置。

Point
computation_method
(可选)

选择接缝线的构建方法。

  • GEOMETRY根据轮廓的交集为重叠区域生成接缝线。没有重叠影像的区域将合并轮廓。这是默认设置。
  • RADIOMETRY根据影像中要素的光谱图生成接缝线。
  • COPY_FOOTPRINT根据轮廓直接生成接缝线。
  • COPY_TO_SIBLING应用来自其他镶嵌数据集的接缝线。镶嵌数据集必须位于同一组中。例如,全色波段的范围并不总是与多光谱波段的范围匹配。此方法可确保它们共享相同的接缝线。
  • EDGE_DETECTION根据感兴趣区域中要素的边生成区域之间的接缝线。
  • VORONOI使用区域 Voronoi 图生成接缝线。
  • DISPARITY根据立体像对的差异图像生成接缝线。该方法可避免接缝线穿过建筑物。

排序方法参数适用于各种计算方法。

String
blend_width
(可选)

混合(羽化)发生在接缝线上有重叠栅格的像素之间。混合宽度定义要混合的像素数目。

如果“混合宽度”值为 10,且使用 BOTH 作为混合类型,则将在接缝线的内部和外部分别混合 5 个像素。如果该值为 10,且混合类型为 INSIDE,则将在接缝线的内部混合 10 个像素。

Double
blend_type
(可选)

确定跨接缝线混合影像的方式。可在接缝线的内部混合,在接缝线的外部混合,或分别在内部和外部混合。

  • BOTH 使用接缝线的任意一侧上的像素混合。例如,如果混合宽度为 10 像素,则将在接缝线的内部和外部分别混合 5 个像素。这是默认设置。
  • INSIDE在接缝线的内部混合。
  • OUTSIDE在接缝线的外部混合。
String
request_size
(可选)

指定用于重采样的列数和行数。最大值为 5000。基于栅格数据的复杂程度增大或减小该值。图像分辨率越高,提供的栅格数据集信息越详细,但同时也增加了处理时间。

Long
request_size_type
(可选)

设置请求大小的单位。

  • PIXELS根据像素大小修改请求大小。这是默认选项,将根据栅格像素大小对最接近图像进行重采样。
  • PIXELSIZE_FACTOR通过指定比例因子修改请求大小。此选项通过将像元大小等级表中的栅格像素大小与像素大小因子相乘对最接近图像进行重采样。
String
blend_width_units
(可选)

指定混合宽度的测量单位。

  • PIXELS使用像素数量进行测量 这是默认设置。
  • GROUND_UNITS使用与镶嵌数据集相同的单位进行测量。
String
area_of_interest
(可选)

为所有与此面相交的栅格构建接缝线。要选择感兴趣区域,请使用输入要素类。

Feature Set
where_clause
(可选)

用来在镶嵌数据集中为特定栅格数据集构建接缝线的 SQL 表达式。

SQL Expression
update_existing
(可选)

更新受镶嵌数据集项目增减影响的接缝线。

  • IGNORE_EXISTING为所有项目重新生成接缝线并忽略可能存在的现有接缝线。这是默认设置。
  • UPDATE_EXISTING仅更新没有接缝线的项目。如果新项目与之前创建的接缝线重叠,则可能影响现有接缝线。

接缝线不存在时,将忽略该参数。

Boolean
min_region_size
(可选)

以像素为单位指定最小区域的大小。将在接缝线结果中移除小于该指定阈值的任何面。默认值为 100 像素。

此参数值应小于狭长面积(即 (max_sliver_size) * (max_sliver_size))。

Long
min_thinness_ratio
(可选)

定义一个面要薄到怎样的程度才能被视为狭长面。它基于 0 到 1.0 之间的比例,0.0 值代表几乎为直线的面,1.0 值代表为圆的面。

构建接缝线时将移除狭长面。

Double
max_sliver_size
(可选)

指定面仍被视为狭长面时可达到的最大大小。该参数以像素为单位指定,基于 request_size 而不是源栅格的空间分辨率。小于该值平方的任何面都将被视为狭长面。小于 (max_sliver_size)2 的任何区域将被视为狭长面。

构建接缝线时将移除狭长面。

Long

派生输出

名称说明数据类型
out_mosaic_dataset

已更新的镶嵌数据集。

镶嵌图层

代码示例

BuildSeamlines 示例 1(Python 窗口)

这是 BuildSeamlines 的 Python 示例。

import arcpy
arcpy.BuildSeamlines_management("c:/data/Seamlines.gdb/md", "40",
                                "NORTH_WEST", "#", "#", "#", "#",
                                "RADIOMETRY", "5", "INSIDE", "#", 
                                "#", "GROUND_UNITS")
BuildSeamlines 示例 2(独立脚本)

这是 BuildSeamlines 的 Python 脚本示例。

# Build seamlines using the  NORTH_WEST sort method

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "Seamlines.gdb/md"
cellsize = "40"
sortmethod = "NORTH_WEST"
sortorder = "#"
orderattribute = "#"
orderbase = "#"
viewpnt = "#"
computemethod = "RADIOMETRY"
blendwidth = "5"
blendtype = "INSIDE"
requestsize = "#"

arcpy.BuildSeamlines_management(
    mdname, cellsize, sortmethod, sortorder, orderattribute, 
    orderbase, viewpnt, computemethod, blendwidth, blendtype, 
    requestsize)