Agregar regla a topología

Resumen

Agrega una regla nueva a una topología.

Las reglas que decide agregar dependen de las relaciones espaciales que desea controlar para las clases de entidades que participan en la topología.

Para obtener una lista y descripción completas de las reglas topológicas disponibles, consulte Reglas topológicas de la geodatabase y soluciones a los errores de topología.

Uso

Legado:

Antes de ArcGIS 10.1 for Desktop no era posible agregar reglas a una topología versionada. A partir de la versión ArcGIS 10.1 puede agregar reglas a una topología versionada cuando la geodatabase de ArcSDE es de la versión 10.0 o posterior. Para actualizar su geodatabase, utilice la herramienta Upgrade_Geodatabase.

• Puede introducir el nombre del valor de subtipo al que desea aplicar una regla topológica.

Sintaxis

AddRuleToTopology_management (in_topology, rule_type, in_featureclass, {subtype}, {in_featureclass2}, {subtype2})

Parámetro	Explicación	Tipo de datos
in_topology	Topología a la que se agregará la nueva regla.	Topology Layer
rule_type	Regla topológica que se agregará. Para obtener una lista completa de las reglas y sus funciones, consulte la página de ayuda sobre las reglas de topología. Must Not Have Gaps (Area) — Esta regla precisa que no haya vacíos dentro de un polígono simple o entre polígonos adyacentes. Todos los polígonos deben formar una superficie continua. Siempre existirá un error en el perímetro de la superficie. Puede ignorar este error o marcarlo como una excepción. Utilice esta regla en datos que deben cubrir completamente un área. Por ejemplo, los polígonos de suelo no pueden incluir espacios ni formar vacíos, deben cubrir un área completa. Must Not Overlap (Area) — Requiere que el interior de los polígonos no se superponga. Los polígonos pueden compartir ejes o vértices. Esta regla se utiliza cuando un área no puede pertenecer a dos o más polígonos. Resulta útil para modelar límites administrativos, como códigos postales o distritos electorales, y clasificaciones de área mutuamente exclusivas, como cobertura de suelo o tipo de forma de suelo. Must Be Covered By Feature Class Of (Area-Area) — Requiere que un polígono en una clase (o subtipo) de entidad comparta toda su área con los polígonos en otra clase (o subtipo) de entidad. Un área en la primera clase de entidad que no está cubierta por polígonos desde la otra clase de entidad es un error. Esta regla se utiliza cuando un área de un tipo, como un estado, debería estar completamente cubierto por áreas de otro tipo, tales como condados. Must Cover Each Other (Area-Area) — Requiere que los polígonos en una clase (o subtipo) de entidad compartan toda su área con los polígonos de otra clase (o subtipo) de entidad. Los polígonos pueden compartir ejes o vértices. Cualquier área definida en otra clase de entidad que no esté compartida con otra es un error. Esta regla se utiliza cuando dos sistemas de clasificación se utilizan para la misma área geográfica y cualquier punto dado definido en un sistema también debe estar definido en el otro. Uno de esos casos se produce con datasets jerárquicos anidados, como bloques censales y grupos de bloque o pequeñas cuencas hidrográficas o grandes cuencas hidrográficas. La regla que también se puede aplicar a las clases de entidad poligonales relacionadas no jerárquicas, tales como tipos de suelo y clases de pendiente. Must Be Covered By (Area-Area) — Requiere que los polígonos de una clase (o subtipo) de entidad estén contenido en polígonos de otra clase (o subtipo) de entidad. Los polígonos pueden compartir ejes o vértices. Cualquier área definida en la clase de entidad contenida debe estar cubierta por un área en la clase de entidad de cobertura. Esta regla se utiliza cuando las entidades de área de un tipo dado se deben localizar dentro de las entidades de otro tipo. Esta regla es útil al modelar áreas que sean subconjuntos de un área circundante mayor, como unidades de administración en bosques o bloques dentro de grupos de bloques. Must Not Overlap With (Area-Area) — Requiere que el interior de los polígonos en una clase (o subtipo) de entidad no se deba superponer con el interior de los polígonos en otra clase (o subtipo) de entidad. Los polígonos de las dos clases de entidad pueden compartir ejes o vértices o estar completamente inconexos. Esta regla se utiliza cuando un área no puede pertenecer a dos clases de entidad separadas. Resulta útil para combinar dos sistemas mutuamente exclusivos de clasificación de área, tales como zonificación y tipos de masa de agua, en las que las áreas definidas en la clase de zonificación tampoco se pueden definir en la clase de masa de agua y viceversa. Must Be Covered By Boundary Of (Line-Area) — Requiere que las líneas estén cubiertas por los límites de las entidades de área. Esto es útil para modelar líneas, tales como líneas de lote, que deben coincidir con el eje de las entidades poligonales, tales como lotes. Must Be Covered By Boundary Of (Point-Area) — Requiere que los puntos se encuentren en los límites de las entidades de área. Esto resulta útil cuando las entidades de punto facilitan un sistema de límites, tal como marcadores de límites, los que deben encontrarse en los ejes de determinadas áreas. Must Be Properly Inside (Point-Area) — Requiere que los puntos se encuentren dentro de las entidades de área. Esto resulta útil cuando las entidades de punto están relacionadas con polígonos, tales como pozos y rellenos de pozos o puntos de dirección y parcelas. Must Not Overlap (Line) — Requiere que las líneas no se superpongan con las líneas en la misma clase (o subtipo) de entidad. Esta regla se utiliza en aquellos segmentos de línea que no se deberían duplicar, por ejemplo, en una clase de entidad de arroyo. Las líneas se pueden cruzar o intersecar pero no pueden compartir segmentos. Must Not Intersect (Line) — Requiere que las entidades de línea desde la misma clase (o subtipo) de entidad no se crucen ni se superpongan entre sí. Las líneas pueden compartir extremos. Esta reglas se utilizan para líneas de contorno que nunca se deben cruzar entre sí o en los casos en los que la intersección de las líneas se debe producir únicamente en extremos, tales como segmentos e intersecciones de calles. Must Not Have Dangles (Line) — Requiere que una entidad de línea deba tocar las líneas desde la misma clase (o subtipo) de entidad en ambos extremos. Un extremo que no esté conectado con otra línea se llama nodo colgado (dangle). Esta regla se utiliza cuando las entidades de línea deben formar bucles cerrados, como cuando definen los límites de las entidades poligonales. También se podría utilizar en los casos en los que las líneas se conectan generalmente con otras líneas, como con calles. En este caso, las excepciones se pueden utilizar allí donde la regla se viola ocasionalmente, como con segmentos cul-de-sac o de calle sin salida. Must Not Have Pseudo-Nodes (Line) — Requiere que una línea se conecte, por lo menos, con otras dos líneas en cada extremo. Las líneas que se conectan con otra línea (o con ellas mismas) se dice que tienen pseudonodos. Esta regla se utiliza donde las entidades de línea deben formar bucles cerrados, como cuando definen los límites de los polígonos o cuando las entidades de línea se deben conectar de forma lógica con otras dos entidades de línea en cada extremo, igual que con segmentos en una red de transmisión, marcándose las excepciones para los extremos que originan las transmisiones de primer orden. Must Be Covered By Feature Class Of (Line-Line) — Requiere que las líneas de una clase (o subtipo) de entidad estén cubiertas por las líneas en otra clase (o subtipo) de entidad. Es útil para modelar las líneas coincidentes espacialmente pero distintas lógicamente, tales como las rutas y las calles. Una clase de entidad de ruta de bus no debe salir de las calles definidas en la clase de entidad de calle. Must Not Overlap With (Line-Line) — Requiere que una línea desde una clase (o subtipo) de entidad no se superpongan con las líneas de entidad en otra clase (o subtipo) de entidad. Esta regla se utiliza cuando las entidades de líneas no pueden compartir el mismo espacio. Por ejemplo, las carreteras no deben superponerse con las líneas de ferrocarril o los subtipos de depresión de las líneas de contorno no se pueden superponer con otras líneas de contorno. Must Be Covered By (Point-Line) — Requiere que los puntos en una clase de entidad deben cubrirse con las líneas en otra clase de entidad. No contiene la parte de cobertura de la línea para ser un extremo. Esta regla resulta útil para puntos que se encuentran a lo largo de un conjunto de líneas, tales como carteles de carreteras. Must Be Covered By Endpoint Of (Point-Line) — Requiere que los puntos en una clase de entidad deben cubrirse con los extremos de líneas en otra clase de entidad. Esta regla es similar a la regla de línea El extremo debe cubrirse por, excepto que, en casos en que no se cumpla la regla, la entidad de punto y no la línea es la que se marca como error. Los marcadores de esquinas límites podrían limitarse a ser cubiertos por los extremos de las líneas de límite. Boundary Must Be Covered By (Area-Line) — Requiere que los límites de las entidades poligonales deban estar cubiertos por líneas en otras clases de entidad. Esta reglas se utilizan cuando las entidades de área necesitan tener entidades de línea que marquen los límites de las áreas. Esto es así, generalmente, cuando las áreas tienen un conjunto de atributos y sus límites tienen otros atributos. Por ejemplo, las parcelas podrían almacenarse en la geodatabase junto con sus límites. Cada parcela podría definirse por una o más entidades de línea que almacenan información acerca de su longitud o la fecha cartografiada, y cada parcela debería coincidir exactamente con sus límites. Boundary Must Be Covered By Boundary Of (Area-Area) — Requiere que estos límites de las entidades poligonales en una clase (o subtipo) de entidad los cubran los límites de las entidades poligonales en otra clase (o subtipo) de entidad. Esto es útil cuando las entidades poligonales en una clase de entidad, tales como subdivisiones, están formados por múltiples polígonos en otra clase, como las parcelas y los límites se deben alinear. Must Not Self-Overlap (Line) — Requiere que las entidades de línea no se superpongan entre sí. Pueden cruzarse o tocarse pero no deben tener segmentos coincidentes. Esta regla es útil para las entidades, como calles, en las que los segmentos se podrían tocar en un bucle pero en donde la misma calle no debería seguir el mismo curso dos veces. Must Not Self-Intersect (Line) — Requiere que las entidades de línea no se crucen ni se superpongan entre sí. Esta regla es útil para las líneas, tales como líneas de contorno, que no se puedan cruzar entre sí. Must Not Intersect Or Touch Interior (Line) — Requiere que una línea en una clase (o subtipo) de entidad deba tocar únicamente otras líneas de la misma clase (o subtipo) de entidad en extremos. Cualquier segmento de línea en el que las entidades se superpongan o cualquier intersección que no se produzca en un extremo es un error. Esta regla es útil donde las líneas deban estar conectadas, únicamente, en los extremos, como en el caso de las líneas de lote, que se deben dividir (únicamente se conectan en los extremos) las líneas de lote y no se pueden superponer entre sí. Endpoint Must Be Covered By (Line-Point) — Requiere que los extremos de las entidades de línea estén cubiertos por entidades de puntos en otra clase de entidad. Esto es útil para modelar los casos en los que se debe conectar un ajuste con dos canalizaciones o que se debe encontrar un cruce de calle en la unión de dos calles. Contains Point (Area-Point) — Requiere que un polígono en una clase de entidad contiene, por lo meno, un punto desde otra clase de entidad. Los puntos deben encontrarse en el interior del polígono, no en el límite. Esto es útil cuando cada polígono debe tener, por lo menos, un punto asociado, como cuando las parcelas deben tener un punto de dirección. Must Be Single Part (Line) — Requiere que las línea tengan una única parte. Esta regla es útil allí donde las entidades de línea, como carreteras, no deben tener múltiples partes. Must Coincide With (Point-Point) — Requiere que los puntos en una clase (o subtipo) de entidad coincidan con los puntos de otra clase (o subtipo) de entidad. Esto es útil para los casos en los que los puntos deben estar cubiertos por otros puntos, igual que los transformadores deben coincidir con los polos de potencia en las redes de distribución eléctricas y los puntos de observación deben coincidir con las estaciones. Must Be Disjoint (Point) — Requiere que los puntos se encuentren separados espacialmente de otros puntos en la misma clase (o subtipo) de entidad. Los puntos que se superpongan son errores. Esto resulta útil para asegurarse de que los puntos no coincidan ni se dupliquen dentro de la misma clase de entidad, tal como en capas de ciudades, puntos de ID de lote de parcela, pozos o postes de luz. Must Not Intersect With (Line-Line) — Requiere que las entidades de línea de una clase (o subtipo) de entidad no se crucen ni se superpongan las líneas de otra clase (o subtipo) de entidad con otras. Las líneas pueden compartir extremos. Esta reglas se utilizan cuando existen líneas de dos capas que nunca se deben cruzar entre sí o en los casos en los que la intersección de las líneas se debe producir únicamente en extremos, tales como calles y ferrocarriles. Must Not Intersect or Touch Interior With (Line-Line) — Requiere que una línea en una clase (o subtipo) de entidad deba tocar únicamente otras líneas de otra clase (o subtipo) de entidad en extremos. Cualquier segmento de línea en el que las entidades se superpongan o cualquier intersección que no se produzca en un extremo es un error. Esta regla resulta útil allí donde las líneas de dos capas se deben conectar únicamente en los extremos. Must Be Inside (Line-Area) — Requiere que una línea esté contenida en los límites de una entidad de área. Esto es útil para casos en los que las líneas puedan coincidir total o parcialmente con los límites de área pero no pueden extender más allá de los polígonos, como las carreteras interestatales que deben estar dentro de los límites estatales y los ríos que deben estar dentro de las cuencas hidrográficas. Contains One Point (Area-Point) — Requiere que cada polígono contenga una entidad de puntos y que cada entidad de puntos se encuentre dentro de un único polígono. Esto se utiliza cuando debe haber una correspondencia uno a uno entre las entidades de una clase de entidad poligonal y las entidades de una clase de entidad de puntos, como los límites administrativos y sus capitales. Cada punto debe estar perfectamente dentro de un polígono y cada polígono debe contener exactamente un punto. Los puntos deben encontrarse en el interior del polígono, no en el límite.	String
in_featureclass	Clase de entidad de entrada u origen.	Feature Layer
subtype (Opcional)	Subtipo de la clase de entidad de entrada u origen. Introduzca la descripción (no el código) del subtipo. Déjelo en blanco si no existen subtipos en la clase de entidad de origen o si desea que la regla se aplique a todos los subtipos en la clase de entidad.	String
in_featureclass2 (Opcional)	Clase de entidad de destino para la regla topológica.	Feature Layer
subtype2 (Opcional)	Subtipo de la clase de entidad de destino. Introduzca la descripción (no el código) del subtipo. Déjelo en blanco si no existen subtipos en la clase de entidad de origen o si desea que la regla se aplique a todos los subtipos en la clase de entidad.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_topology

Muestra de código

Ejemplo de AddFeatureClassToTopology (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente muestra cómo utilizar la función 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")

Entornos

• Espacio de trabajo actual

Información sobre licencias

• ArcGIS Desktop Basic: No
• ArcGIS Desktop Standard: Sí
• ArcGIS Desktop Advanced: Sí