Geometrie reparieren (Data Management Tools)

Zusammenfassung

Überprüft Features auf Geometrieprobleme und behebt diese. Bei Feststellung eines Geometrieproblems wird eine Reparatur durchgeführt. In einer einzeiligen Beschreibung werden das Feature und das behobene Geometrieproblem identifiziert.

Dieses Werkzeug verwendet zum Reparieren von Geometrieproblemen die gleiche Logik wie das Werkzeug Geometrie überprüfen.

Weitere Informationen zum Überprüfen und Reparieren von Geometrien

Verwendung

Achtung:

Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter "Werkzeuge, die Eingabedaten ändern oder aktualisieren".

Gültige Eingabeformate sind Shapefiles und Feature-Classes, die in einer File-Geodatabase, Enterprise-Datenbank, Enterprise-Geodatabase, einem GeoPackage oder einer SpatiaLite-Datenbank gespeichert sind. Mobile-Geodatabases werden nicht unterstützt. Für Feature-Classes, die in einer Enterprise-Datenbank oder Enterprise-Geodatabase gespeichert sind, werden die folgenden räumlichen Datentypen unterstützt:
- Microsoft SQL Server—Geometry und Geography
- PostgreSQL—PostGIS, Geometry und Geography
- Oracle—SDO_Geometry
- SAP HANA—ST_Geometry
Lizenz:

Es wird eine Desktop Standard- oder Desktop Advanced-Lizenz benötigt, wenn sich die Eingabe in einer Enterprise-Datenbank oder einer Enterprise-Geodatabase befindet.
Feature-Classes, die in einer Enterprise-Geodatabase gespeichert und als versioniert registriert sind, werden nicht unterstützt.
Die Umschaltfläche Rückgängig aktivieren kann nicht auf Eingaben aus einer Enterprise-Geodatabase angewendet werden.
Nachfolgend finden Sie eine Liste mit Geometrieproblemen und der entsprechenden Korrektur, die mit dem Werkzeug durchgeführt wird:
- Null geometry—Der Datensatz wird aus der Feature-Class gelöscht. Um Datensätze mit NULL-Geometrie beizubehalten, deaktivieren Sie den Parameter Features mit NULL-Geometrie löschen.
- Short segment—Das kurze Segment der Geometrie wird gelöscht.
- Incorrect ring ordering—Die Geometrie wird mit der richtigen Ringanordnung aktualisiert.
- Incorrect segment orientation—Die Geometrie wird mit einer richtigen Segmentausrichtung aktualisiert.
- Self intersections—Die Überlappungsflächen in einem Polygon werden zusammengeführt.
- Unclosed rings—Offene Ringe werden durch Verbindung ihrer Endpunkte geschlossen.
- Empty parts—Teile ohne Wert oder mit NULL-Wert werden gelöscht.
- Duplicate vertex—Einer der Stützpunkte wird gelöscht.
- Mismatched attributes—Die Z- oder M-Koordinate wird aktualisiert, damit sie übereinstimmt.
- Discontinuous parts—Aus einem diskontinuierlichen Abschnitt werden mehrere Abschnitte gebildet.
- Empty Z values—Der Z-Wert wird auf 0 festgelegt.
- Bad envelope—Der Envelope des Features wird zwecks Korrektur aktualisiert.
- Bad dataset extent—Die Feature-Class wird zwecks Korrektur aktualisiert.
Nachfolgend werden Geometrieprobleme aufgrund der Speicherung von Daten in einer Enterprise-Geodatabase sowie die entsprechende vom Werkzeug durchgeführte Reparatur (sofern vorhanden) aufgeführt:
- NEEDS_REORDERING—Das Shape wird neu angeordnet, und doppelte Punkte werden entfernt.
- SE_INVALID_ENTITY_TYPE—Der Entitätstyp wird nicht repariert (das Feature muss gelöscht werden).
- SE_SHAPE_INTEGRITY_ERROR—Das Shape wird möglicherweise nicht repariert.
- SE_INVALID_SHAPE_OBJECT—Das Shape-Objekt wird möglicherweise nicht repariert.
- SE_COORD_OUT_OF_BOUNDS—Die Koordinate wird nicht repariert.
- SE_POLY_SHELLS_OVERLAP—Überlappende Hüllen werden zusammengeführt.
- SE_TOO_FEW_POINTS—Die Punkte werden nicht repariert.
- SE_INVALID_PART_SEPARATOR—Das Teil-Trennzeichen wird möglicherweise nicht repariert.
- SE_INVALID_POLYGON_CLOSURE—Nicht geschlossene Hüllen werden verworfen (das resultierende Polygon kann leer bleiben).
- SE_INVALID_OUTER_SHELL—Es wird versucht, die äußeren Hüllen des Features zu reparieren. Dabei werden möglicherweise Hüllen verworfen.
- SE_ZERO_AREA_POLYGON—Das Polygon wird in ein leeres Shape konvertiert.
- SE_POLYGON_HAS_VERTICAL_LINE—Die vertikale Linie wird entfernt (das Shape wird möglicherweise in 2D konvertiert).
- SE_OUTER_SHELLS_OVERLAP—Überlappende Teile werden zusammengeführt.
- SE_SELF_INTERSECTING—Bei Bedarf werden Schnittpunkte hinzugefügt.
Hinweis:

Einige Probleme in Verbindung mit Daten, die in einer Enterprise-Datenbank gespeichert werden, können möglicherweise mit ArcGIS-Werkzeugen repariert werden.
Nachdem eine Korrekturmaßnahme durchgeführt wurde, wertet das Werkzeug die resultierende Geometrie erneut aus. Treten erneut Probleme auf, werden auch diese behoben. Das Ergebnis der Reparatur einer Geometrie mit dem Problem Incorrect ring ordering kann zu einer Geometrie mit dem Problem Null geometry führen.
Mit der Option der Geometrievalidierungsmethode von Esri wird mithilfe der Vereinfachungsmethode von Esri sichergestellt, dass die Geometrie topologisch korrekt ist. Für Daten, die in einer Enterprise-Geodatabase gespeichert sind, ist nur die Esri Validierung verfügbar.
Mit der Option der Geometrievalidierungsmethode OGC wird sichergestellt, dass die Geometrie der unter OpenGIS Implementation Standard for Geographic information - Simple feature access - Part 1: Common architecture definierten Spezifikation des Open Geospatial Consortium (OGC) entspricht.
Nachdem die Geometrie eines Features mit der Option OGC repariert wurde, können nachfolgende Bearbeitungen oder Änderungen dazu führen, dass die Geometrie der OGC-Spezifikation nicht mehr entspricht.

Führen Sie nach der Änderung des Features das Werkzeug [Geometrie überprüfen] aus, um zu ermitteln, ob neue Geometrieprobleme vorliegen. Führen Sie das Werkzeug Geometrie reparieren ggf. erneut aus.
Die mit der Option OGC validierte oder reparierte Geometrie ist für die Option Esri gültig. Weitere Informationen zu beiden Validierungsmethoden finden Sie unter What is a simple polygon.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die zu verarbeitende Feature-Class bzw. der zu verarbeitende Feature-Layer. Feature-Services werden nicht unterstützt. Lizenz: Es wird eine Desktop Standard- oder Desktop Advanced-Lizenz benötigt, wenn sich die Eingabe in einer Enterprise-Datenbank oder einer Enterprise-Geodatabase befindet.	Feature Layer
Features mit NULL-Geometrie löschen (Optional)	Legt fest, ob Features mit NULL-Geometrie gelöscht werden. Hinweis: Für Eingaben aus einer Enterprise-Datenbank oder Enterprise-Geodatabase, einem GeoPackage oder einer SpatiaLite-Datenbank ist nur die aktivierte Option gültig. Aktiviert—Features mit NULL-Geometrie werden aus der Eingabe gelöscht. Dies ist die Standardeinstellung. Deaktiviert—Features mit NULL-Geometrie werden nicht aus der Eingabe gelöscht.	Boolean
Überprüfungsmethode (Optional)	Legt fest, welche Geometrievalidierungsmethode zum Identifizieren von Geometrieproblemen verwendet wird. Esri—Es wird die Geometrievalidierungsmethode von Esri verwendet. Dies ist die Standardeinstellung. OGC—Es wird die Geometrievalidierungsmethode des OGC verwendet.	String

Beschriftung

Erläuterung

Datentyp

Eingabe-Features

Die zu verarbeitende Feature-Class bzw. der zu verarbeitende Feature-Layer.

Feature-Services werden nicht unterstützt.

Lizenz:

Es wird eine Desktop Standard- oder Desktop Advanced-Lizenz benötigt, wenn sich die Eingabe in einer Enterprise-Datenbank oder einer Enterprise-Geodatabase befindet.

Feature Layer

Features mit NULL-Geometrie löschen

(Optional)

Legt fest, ob Features mit NULL-Geometrie gelöscht werden.

Hinweis:

Für Eingaben aus einer Enterprise-Datenbank oder Enterprise-Geodatabase, einem GeoPackage oder einer SpatiaLite-Datenbank ist nur die aktivierte Option gültig.

Aktiviert—Features mit NULL-Geometrie werden aus der Eingabe gelöscht. Dies ist die Standardeinstellung.
Deaktiviert—Features mit NULL-Geometrie werden nicht aus der Eingabe gelöscht.

Boolean

Überprüfungsmethode

(Optional)

Legt fest, welche Geometrievalidierungsmethode zum Identifizieren von Geometrieproblemen verwendet wird.

Esri—Es wird die Geometrievalidierungsmethode von Esri verwendet. Dies ist die Standardeinstellung.
OGC—Es wird die Geometrievalidierungsmethode des OGC verwendet.

String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Reparierte Eingabe-Features	Die aktualisierten Eingabe-Features.	Feature Layer

arcpy.management.RepairGeometry(in_features, {delete_null}, {validation_method})

Name Erläuterung Datentyp

Name	Erläuterung	Datentyp
in_features	Die zu verarbeitende Feature-Class bzw. der zu verarbeitende Feature-Layer. Feature-Services werden nicht unterstützt. Lizenz: Es wird eine Desktop Standard- oder Desktop Advanced-Lizenz benötigt, wenn sich die Eingabe in einer Enterprise-Datenbank oder einer Enterprise-Geodatabase befindet.	Feature Layer
delete_null (Optional)	Legt fest, ob Features mit NULL-Geometrie gelöscht werden. Hinweis: Für Eingaben aus einer Enterprise-Datenbank oder Enterprise-Geodatabase, einem GeoPackage oder einer SpatiaLite-Datenbank ist nur die Option `KEEP_NULL` gültig. `DELETE_NULL`—Features mit NULL-Geometrie werden aus der Eingabe gelöscht. Dies ist die Standardeinstellung. `KEEP_NULL`—Features mit NULL-Geometrie werden nicht aus der Eingabe gelöscht.	Boolean
validation_method (Optional)	Legt fest, welche Geometrievalidierungsmethode zum Identifizieren von Geometrieproblemen verwendet wird. `ESRI`—Es wird die Geometrievalidierungsmethode von Esri verwendet. Dies ist die Standardeinstellung. `OGC`—Es wird die Geometrievalidierungsmethode des OGC verwendet.	String

in_features

Die zu verarbeitende Feature-Class bzw. der zu verarbeitende Feature-Layer.

Feature-Services werden nicht unterstützt.

Lizenz:

Es wird eine Desktop Standard- oder Desktop Advanced-Lizenz benötigt, wenn sich die Eingabe in einer Enterprise-Datenbank oder einer Enterprise-Geodatabase befindet.

Feature Layer

delete_null

(Optional)

Legt fest, ob Features mit NULL-Geometrie gelöscht werden.

Hinweis:

Für Eingaben aus einer Enterprise-Datenbank oder Enterprise-Geodatabase, einem GeoPackage oder einer SpatiaLite-Datenbank ist nur die Option KEEP_NULL gültig.

DELETE_NULL—Features mit NULL-Geometrie werden aus der Eingabe gelöscht. Dies ist die Standardeinstellung.
KEEP_NULL—Features mit NULL-Geometrie werden nicht aus der Eingabe gelöscht.

Boolean

validation_method

(Optional)

Legt fest, welche Geometrievalidierungsmethode zum Identifizieren von Geometrieproblemen verwendet wird.

ESRI—Es wird die Geometrievalidierungsmethode von Esri verwendet. Dies ist die Standardeinstellung.
OGC—Es wird die Geometrievalidierungsmethode des OGC verwendet.

String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_feature_class	Die aktualisierten Eingabe-Features.	Feature Layer

Codebeispiel

RepairGeometry: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion RepairGeometry im Direkt-Modus für ein Shapefile verwendet wird.

import arcpy
arcpy.management.RepairGeometry("c:/data/data.shp")

RepairGeometry: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript ist ein Beispiel für die Anwendung der Funktion RepairGeometry in einer Skriptumgebung.

# Description:
#   Goes through the table generated by the Check Geometry tool and does
#   the following
#   1) backs-up all features which will be 'fixed' to a "_bad_geom" feature class
#   2) runs RepairGeometry on all feature classes listed in the table

import arcpy
import os

# Table that was produced by Check Geometry tool
table = r"c:\temp\data.gdb\cg_sample1"

# Create local variables
fcs = []

# Loop through the table and get the list of fcs
for row in arcpy.da.SearchCursor(table, ("CLASS")):
    # Get the class (feature class) from the cursor
    if not row[0] in fcs:
        fcs.append(row[0])

# Now loop through the fcs list, backup the bad geometries into fc + "_bad_geom"
# then repair the fc
print("> Processing {0} feature classes".format(len(fcs)))
for fc in fcs:
    print("Processing " + fc)
    lyr = 'temporary_layer'
    if arcpy.Exists(lyr):
        arcpy.management.Delete(lyr)

    tv = "cg_table_view"
    if arcpy.Exists(tv):
        arcpy.management.Delete(tv)

    arcpy.management.MakeTableView(table, tv, ("\"CLASS\" = '%s'" % fc))
    arcpy.management.MakeFeatureLayer(fc, lyr)
    arcpy.management.AddJoin(lyr, arcpy.Describe(lyr).OIDFieldName, tv, "FEATURE_ID")
    arcpy.management.CopyFeatures(lyr, fc + "_bad_geom")
    arcpy.management.RemoveJoin(lyr, os.path.basename(table))
    arcpy.management.RepairGeometry(lyr)

Umgebungen

Aktueller Workspace, Ausdehnung, Faktor für parallele Verarbeitung

Sonderfälle

Faktor für parallele Verarbeitung: If the environment is not set (the default) or is set to 0, parallel processing will be disabled. If set to 100, the tool will attempt to distribute the work to all the logical cores on the machine. Specifying a factor between 1 and 99 will cause the tool to identify the percentage of logical cores to use by applying the formula (Parallel Processing Factor / 100 * Logical Cores) rounded up to the nearest integer. If the result of this formula is 0 or 1, parallel processing will not be enabled.

Lizenzierungsinformationen

Basic: Eingeschränkt
Einige Parameter sind durch die Lizenzstufe eingeschränkt.
Standard: Ja
Advanced: Ja

Geometrie reparieren (Data Management Tools)

Zusammenfassung

Verwendung

Achtung:

Lizenz:

Hinweis:

Parameter

Lizenz:

Hinweis:

Abgeleitete Ausgabe

Umgebungen

Sonderfälle

Lizenzierungsinformationen

Verwandte Themen