添加拓扑规则 (数据管理)

描述

向拓扑添加新规则。

选择添加的规则取决于要监视的参与拓扑要素类的空间关系。

有关可用拓扑规则的完整列表和描述，请参阅地理数据库拓扑规则和针对点、线或面的拓扑错误修复。

使用方法

• 可输入要应用拓扑规则的子类型值的名称。

语法

arcpy.management.AddRuleToTopology(in_topology, rule_type, in_featureclass, {subtype}, {in_featureclass2}, {subtype2})

参数	说明	数据类型
in_topology	要添加新规则的拓扑。	Topology Layer
rule_type	要添加的拓扑规则。有关规则及其用途的完整列表，请参阅点、线或面要素的拓扑规则和修复。 Must Not Have Gaps (Area) — 此规则要求单一面之中或两个相邻面之间没有空白。所有面必须组成一个连续表面。表面的周长始终存在错误。您可以忽略这个错误或将其标记为异常。此规则用于必须完全覆盖某个区域的数据。例如，土壤面不能包含空隙或具有空白，这些面必须覆盖整个区域。 Must Not Overlap (Area) — 要求面的内部不重叠。面可以共享边或折点。当某区域不能属于两个或多个面时，使用此规则。此规则适用于行政边界（如“邮政编码”区或选举区）以及相互排斥的地域分类（如土地覆盖或地貌类型）。 Must Be Covered By Feature Class Of (Area-Area) — 要求一个要素类（或子类型）中的面必须向另一个要素类（或子类型）中的面共享自身所有的区域。第一个要素类中若存在未被其他要素类的面覆盖的区域则视作错误。当一种类型的区域（如一个州）应被另一种类型的区域（如所有的下辖县）完全覆盖时，使用此规则。 Must Cover Each Other (Area-Area) — 要求一个要素类（或子类型）的面必须与另一个要素类（或子类型）的面共享双方的所有区域。面可以共享边或折点。任何一个要素类中存在未与另一个要素类共享的区域都视作错误。当两个分类系统用于相同的地理区域时使用此规则，在一个系统中定义的任意指定点也必须在另一个系统中定义。通常嵌套的等级数据集需要应用此规则，如人口普查区块和区块组或小分水岭和大的流域盆地。此规则还可应用于非等级相关的面要素类（如土壤类型和坡度分类）。 Must Be Covered By (Area-Area) — 要求一个要素类（或子类型）的面必须包含于另一个要素类（或子类型）的面中。面可以共享边或折点。在被包含要素类中定义的所有区域必须被覆盖要素类中的区域所覆盖。当指定类型的区域要素必须位于另一类型的要素中时，使用此规则。当建模作为较大范围区域的子集区域（如森林中的管理单位或区块组中的区块）时，此规则非常有用。 Must Not Overlap With (Area-Area) — 要求一个要素类（或子类型）面的内部不得与另一个要素类（或子类型）面的内部相重叠。两个要素类的面可以共享边或折点，或完全不相交。当某区域不能属于两个单独的要素类时，使用此规则。此规则适用于结合两个相互排斥的区域分类系统（如区域划分和水体类型，其中，在区域划分类中定义的区域无法在水体类中也进行定义，反之亦然）。 Must Be Covered By Boundary Of (Line-Area) — 要求线被面要素的边界覆盖。这适于建模必须与面要素（如地块）的边重合的线（如地块线）。 Must Be Covered By Boundary Of (Point-Area) — 要求点位于面要素的边界上。这在点要素帮助支持边界系统（如必须设在某些区域边界上的边界标记）时非常有用。 Must Be Properly Inside (Point-Area) — 要求点必须位于面要素内部。这在点要素与面有关时非常有用，如井和井垫或地址点和宗地。 Must Not Overlap (Line) — 要求线不能与同一要素类（或子类型）中的线重叠。例如，当河流要素类中线段不能重复时，使用此规则。线可以交叉或相交，但不能共享线段。 Must Not Intersect (Line) — 要求相同要素类（或子类型）中的线要素不能彼此相交或重叠。线可以共享端点。此规则适用于绝不应彼此交叉的等值线，或只能在端点相交的线（如街段和交叉路口）。 Must Not Have Dangles (Line) — 要求线要素的两个端点必须都接触到相同要素类（或子类型）中的线。未连接到另一条线的端点称为悬挂点。当线要素必须形成闭合环时（例如由这些线要素定义面要素的边界），使用此规则。它还可在线通常会连接到其他线（如街道）时使用。在这种情况下，可以偶尔违反规则使用异常，例如死胡同 (cul-de-sac) 或没有出口的街段的情况。 Must Not Have Pseudo-Nodes (Line) — 要求线在每个端点处至少连接两条其他线。连接到一条其他线（或到其自身）的线被认为是包含了伪结点。在线要素必须形成闭合环时使用此规则，例如由这些线要素定义面的边界，或逻辑上要求线要素必须在每个端点连接两条其他线要素的情况。河流网络中的线段就是如此，但需要将一级河流的源头标记为异常。 Must Be Covered By Feature Class Of (Line-Line) — 要求一个要素类（或子类型）中的线必须被另一个要素类（或子类型）中的线所覆盖。此选项适于建模逻辑不同但空间重合的线（如路径和街道）。公交路线要素类不能离开在街道要素类中定义的街道。 Must Not Overlap With (Line-Line) — 要求一个要素类（或子类型）中的线不能与另一个要素类（或子类型）中的线要素重叠。线要素无法共享同一空间时使用此规则。例如道路不能与铁路重叠，或洼地子类型的等值线不能与其他等值线重叠。 Must Be Covered By (Point-Line) — 要求一个要素类中的点被另一要素类中的线覆盖。它不能将线的覆盖部分约束为端点。此规则适用于沿一组线出现的点，如公路沿线的公路标志。 Must Be Covered By Endpoint Of (Point-Line) — 要求一个要素类中的点必须被另一要素类中线的端点覆盖。除了当违反此规则时，标记为错误的是点要素而不是线之外，此规则与线规则“端点必须被其他要素覆盖”极为相似。边界拐角标记可以被约束，以使其被边界线的端点覆盖。 Boundary Must Be Covered By (Area-Line) — 要求面要素的边界必须被另一要素类中的线覆盖。此规则在区域要素需要具有标记区域边界的线要素时使用。通常在区域具有一组属性且这些区域的边界具有其他属性时使用。例如，宗地可能与其边界一同存储在地理数据库中。每个宗地可能由一个或多个存储着与其长度或测量日期相关的信息的线要素定义，而且每个宗地都应与其边界完全匹配。 Boundary Must Be Covered By Boundary Of (Area-Area) — 要求一个要素类（或子类型）中的面要素的边界被另一个要素类（或子类型）中面要素的边界覆盖。当一个要素类中的面要素（如住宅小区）由另一个类（如宗地）中的多个面组成，且共享边界必须对齐时，此规则非常有用。 Must Not Self-Overlap (Line) — 要求线要素不得与自身重叠。这些线要素可以交叉或接触自身但不得有重合的线段。此规则适用于街道等线段可能接触闭合线的要素，但同一街道不应出现两次相同的路线。 Must Not Self-Intersect (Line) — 要求线要素不得自交叉或与自身重叠。此规则适用于不能与自身交叉的线（如等值线）。 Must Not Intersect Or Touch Interior (Line) — 要求一个要素类（或子类型）中的线必须仅在端点处接触相同要素类（或子类型）的其他线。任何其中有要素重叠的线段或任何不是在端点处发生的相交都是错误。此规则适用于线只能在端点处连接的情况，例如地块线必须连接（仅连接到端点）至其他地块线，并且不能相互重叠。 Endpoint Must Be Covered By (Line-Point) — 要求线要素的端点必须被另一要素类中的点要素覆盖。在某些建模情况下，例如设备必须连接两条管线，或者交叉路口必须出现在两条街道的交汇处时，此工具十分有用。 Contains Point (Area-Point) — 要求一个要素类中的面至少包含另一个要素类中的一个点。点必须位于面要素中，而不是边界上。当每个面至少应包含一个关联点时（如宗地必须具有地址点），此规则非常有用。 Must Be Single Part (Line) — 要求线只有一个部分。当线要素（如高速公路）不能有多个部分时，此规则非常有用。 Must Coincide With (Point-Point) — 要求一个要素类（或子类型）中的点必须与另一个要素类（或子类型）中的点重合。此规则适用于点必须被其他点覆盖的情况，如变压器必须与配电网络中的电线杆重合，观察点必须与工作站重合。 Must Be Disjoint (Point) — 要求点与相同要素类（或子类型）中的其他点在空间上相互分离。重叠的任何点都是错误。此规则可确保相同要素类的点不重合或不重复，如城市图层中、宗地块 ID 点、井或路灯杆。 Must Not Intersect With (Line-Line) — 要求一个要素类（或子类型）中的线要素不能与另一个要素类（或子类型）中的线要素相交或重叠。线可以共享端点。当两个图层中的线绝不应当交叉或只能在端点处发生相交时（如街道和铁路），使用此规则。 Must Not Intersect or Touch Interior With (Line-Line) — 要求一个要素类（或子类型）中的线必须仅在端点处接触另一要素类（或子类型）的其他线。任何其中有要素重叠的线段或任何不是在端点处发生的相交都是错误。当两个图层中的线必须仅在端点处连接时，此规则非常有用。 Must Be Inside (Line-Area) — 要求线包含在面要素的边界内。当线可能与面边界部分重合或全部重合但不能延伸到面之外（如必须位于州边界内部的高速公路和必须位于分水岭内部的河流）时，此选项十分有用。 Contains One Point (Area-Point) — 要求每个面包含一个点要素且每个点要素落在单独的面要素中。如果在面要素类的要素和点要素类的要素之间必须存在一对一的对应关系（如行政边界与其首都），此规则非常有用。每个点必须完全位于一个面要素内部，而每个面要素必须完全包含一个点。点必须位于面要素中，而不是边界上。	String
in_featureclass	输入或源要素类。	Feature Layer
subtype （可选）	输入或源要素类的子类型。输入子类型的描述（而不是代码）。如果源要素上不存在子类型，或者要将规则应用于要素类中的所有子类型，则将此留空。	String
in_featureclass2 （可选）	拓扑规则的目标要素类。	Feature Layer
subtype2 （可选）	目标要素类的子类型。输入子类型的描述（而不是代码）。如果源要素上不存在子类型，或者要将规则应用于要素类中的所有子类型，则将此留空。	String

派生输出

名称	说明	数据类型
out_topology	已更新的拓扑。	拓扑图层

代码示例

AddFeatureClassToTopology 示例（独立脚本）

以下独立脚本演示了如何使用 AddRuleToTopology 函数。

# Name: AddRuleToTopology_Example.py
# Description: Adds a rule to a topology
# Import system modules
import arcpy
# Any intersection of ParcelOutline (BlockLines subtype only) needs to be reviewed
arcpy.AddRuleToTopology_management("C:/data/Landbase.gdb/LegalFabric/topology", 
                                   "Must Not Intersect (Line)",
                                   "C:/data/Landbase.gdb/LegalFabric/ParcelOutline",
                                   "BlockLines")

环境

当前工作空间

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是