Восстановить геометрию (Инструменты Управление данными)

Краткая информация

Проверяет наличие проблем с геометрией объектов и восстанавливает ее. Если обнаружена проблема, будет выполнено исправление, и однострочное описание проидентифицирует объект, а также проблему геометрии, которая была устранена.

Этот инструмент использует ту же логику, что и инструмент Проверить геометрию для исправления проблем с геометрией.

Узнайте больше о проверке и восстановлении геометрии

Использование

Внимание:

Этот инструмент изменяет входные значения. Более подробно о стратегиях предотвращения нежелательных изменений данных см. в разделе Инструменты, которые изменяют или обновляют входные данные.

Допустимые форматы ввода – это шейп-файлы и классы пространственных объектов, хранящиеся в файловой базе геоданных, многопользовательской базе данных, многопользовательской базе геоданных, в GeoPackage или базе данных SpatiaLite. Мобильная база геоданных не поддерживаются. Для классов пространственных объектов, хранящихся в многопользовательской базе данных или базе геоданных, поддерживаются следующие пространственные типы:
- Microsoft SQL Server—Geometry и Geography
- PostgreSQL—PostGIS, Geometry и Geography
- Oracle—SDO_Geometry
- SAP HANA—ST_Geometry
Лицензия:

Лицензия Desktop Standard или Desktop Advanced требуется, если входные данные находятся в многопользовательской базе данных или в многопользовательской базе геоданных.
Классы пространственных объектов, которые хранятся в многопользовательской базе геоданных, регистрируются как версионные и не поддерживаются.
Кнопка-переключатель Включить отмену не работает для входных данных из многопользовательской базы геоданных.
Ниже приведен перечень ошибок геометрии и соответствующих исправлений, которые будут выполняться этим инструментом:
- Null geometry—Запись будет удалена из класса объектов. Чтобы оставить записи с пустой геометрией, снимите отметку с параметра Удалить объекты с пустой геометрией.
- Short segment—Короткий сегмент геометрии будет удален.
- Incorrect ring ordering—Геометрия будет обновлена таким образом, чтобы в ней был установлен корректный порядок колец.
- Incorrect segment orientation—Геометрия будет обновлена таким образом, чтобы в ней была установлена корректная ориентация сегмента.
- Self intersections—Области наложения в полигоне будут слиты.
- Unclosed rings—Незамкнутое кольцо будет замкнуто путем соединения конечных точек кольца.
- Empty parts—Нулевые или пустые части будут удалены.
- Duplicate vertex—Одна из вершин будет удалена.
- Mismatched attributes—Координаты Z или M будут обновлены для соответствия.
- Discontinuous parts—Из дискретной части будет создано несколько частей.
- Empty Z values—Значение z будет установлено на 0.
- Bad envelope—Конверт объекта будет обновлен до правильного.
- Bad dataset extent—Экстент класса объектов будет обновлен до правильного.
Ниже приведен список геометрических проблем, которые могут возникнуть из данных, хранящихся в многопользовательской базе геоданных, и соответствующих исправлений, которые будут выполнены инструментом:
- NEEDS_REORDERING—Форма будет переупорядочена, а повторяющиеся точки удалены.
- SE_INVALID_ENTITY_TYPE—Тип элемента не будет восстановлен (объект должен быть удален).
- SE_SHAPE_INTEGRITY_ERROR—Геометрия не может быть восстановлена.
- SE_INVALID_SHAPE_OBJECT—Возможно, геометрия объекта не может быть восстановлена.
- SE_COORD_OUT_OF_BOUNDS—Координата не будет восстановлена.
- SE_POLY_SHELLS_OVERLAP—Перекрывающиеся оболочки будут объединены.
- SE_TOO_FEW_POINTS—Точки не будут восстановлены.
- SE_INVALID_PART_SEPARATOR—Возможно, разделитель частей не может быть восстановлен.
- SE_INVALID_POLYGON_CLOSURE—Незакрытые оболочки будут отброшены (получившийся полигон можно оставить пустым).
- SE_INVALID_OUTER_SHELL—Будет предпринята попытка починить внешние оболочки объекта; при этом оболочки могут быть отброшены.
- SE_ZERO_AREA_POLYGON—Полигон будет преобразован в пустую форму.
- SE_POLYGON_HAS_VERTICAL_LINE—Вертикальная линия будет удалена (форма может быть преобразована в 2D).
- SE_OUTER_SHELLS_OVERLAP—Перекрывающиеся части будут слиты.
- SE_SELF_INTERSECTING—Точки пересечения будут добавлены, если необходимо.
Примечание:

Некоторые проблемы, связанные с данными, хранящимися в многопользовательской базе данных, не могут быть устранены с помощью инструментов ArcGIS.
После выполнения восстановления инструмент еще раз оценит полученную геометрию и, если будет найдена еще одна ошибка, выполнит для нее соответствующее исправление. Например, в результате исправления геометрии с ошибкой Incorrect ring ordering может появиться геометрия с ошибкой Null geometry.
Опция метода проверки геометрии Esri обеспечивает топологическую правильность геометрии при помощи Метода упрощения Esri. Только проверки Esri доступны для данных, сохраненных в многопользовательской базе геоданных.
Опция метода проверки геометрии OGC обеспечивает соответствие геометрии спецификациям OGC, указанным в OpenGIS Implementation Standard for Geographic information – simple feature access – Part 1: common architecture.
После восстановления геометрии объектов при помощи опции OGC, любые последующие изменения могут привести к тому, что геометрия перестанет соответствовать спецификациям OGC.

После изменения объекта запустите инструмент Проверить геометрию, чтобы проверить на наличие новых ошибок. Если необходимо, запустите заново инструмент Восстановить геометрию.
Геометрия, проверенная или восстановленная при помощи опции OGC, будет допустима для опции Esri. Чтобы узнать больше об обоих методах проверки, см. раздел Что такое простой полигон.

Подпись	Объяснение	Тип данных
Входные объекты	Класс пространственных объектов или слой, которые будут обработаны. Сервисы объектов не поддерживается. Лицензия: Лицензия Desktop Standard или Desktop Advanced требуется, если входные данные находятся в многопользовательской базе данных или в многопользовательской базе геоданных.	Feature Layer
Удалить объекты с пустой геометрией (Дополнительный)	Определяет, будут ли удаляться объекты с нулевой геометрией. Примечание: Для входных данных из многопользовательской базы данных или многопользовательской базы геоданных, GeoPackage или базы данных SpatiaLite допустимой является только отмеченная опция. Отмечено–Объекты с нулевой геометрией будут удалены из входа. Используется по умолчанию. Не отмечено–Объекты с нулевой геометрией не будут удалены из входных данных.	Boolean
Метод проверки (Дополнительный)	Определяет, какой метод проверки геометрии будет использоваться для выявления ошибок геометрии. Esri–Будет применен метод проверки геометрии Esri. Используется по умолчанию. OGC–Будет использоваться метод проверки геометрии OGC.	String

Подпись

Объяснение

Тип данных

Входные объекты

Класс пространственных объектов или слой, которые будут обработаны.

Сервисы объектов не поддерживается.

Лицензия:

Лицензия Desktop Standard или Desktop Advanced требуется, если входные данные находятся в многопользовательской базе данных или в многопользовательской базе геоданных.

Feature Layer

Удалить объекты с пустой геометрией

(Дополнительный)

Определяет, будут ли удаляться объекты с нулевой геометрией.

Примечание:

Для входных данных из многопользовательской базы данных или многопользовательской базы геоданных, GeoPackage или базы данных SpatiaLite допустимой является только отмеченная опция.

Отмечено–Объекты с нулевой геометрией будут удалены из входа. Используется по умолчанию.
Не отмечено–Объекты с нулевой геометрией не будут удалены из входных данных.

Boolean

Метод проверки

(Дополнительный)

Определяет, какой метод проверки геометрии будет использоваться для выявления ошибок геометрии.

Esri–Будет применен метод проверки геометрии Esri. Используется по умолчанию.
OGC–Будет использоваться метод проверки геометрии OGC.

String

Производные выходные данные

Подпись	Объяснение	Тип данных
Восстановленные входные объекты	Обновленные входные объекты	Feature Layer

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

Имя Объяснение Тип данных

Имя	Объяснение	Тип данных
in_features	Класс пространственных объектов или слой, которые будут обработаны. Сервисы объектов не поддерживается. Лицензия: Лицензия Desktop Standard или Desktop Advanced требуется, если входные данные находятся в многопользовательской базе данных или в многопользовательской базе геоданных.	Feature Layer
delete_null (Дополнительный)	Определяет, будут ли удаляться объекты с нулевой геометрией. Примечание: Для входных данных из многопользовательской базы данных или многопользовательской базы геоданных, GeoPackage или базы данных SpatiaLite допустимой является только опция `KEEP_NULL`. `DELETE_NULL`–Объекты с нулевой геометрией будут удалены из входа. Используется по умолчанию. `KEEP_NULL`–Объекты с нулевой геометрией не будут удалены из входных данных.	Boolean
validation_method (Дополнительный)	Определяет, какой метод проверки геометрии будет использоваться для выявления ошибок геометрии. `ESRI`–Будет применен метод проверки геометрии Esri. Используется по умолчанию. `OGC`–Будет использоваться метод проверки геометрии OGC.	String

in_features

Класс пространственных объектов или слой, которые будут обработаны.

Сервисы объектов не поддерживается.

Лицензия:

Feature Layer

delete_null

(Дополнительный)

Определяет, будут ли удаляться объекты с нулевой геометрией.

Примечание:

Для входных данных из многопользовательской базы данных или многопользовательской базы геоданных, GeoPackage или базы данных SpatiaLite допустимой является только опция KEEP_NULL.

DELETE_NULL–Объекты с нулевой геометрией будут удалены из входа. Используется по умолчанию.
KEEP_NULL–Объекты с нулевой геометрией не будут удалены из входных данных.

Boolean

validation_method

(Дополнительный)

Определяет, какой метод проверки геометрии будет использоваться для выявления ошибок геометрии.

ESRI–Будет применен метод проверки геометрии Esri. Используется по умолчанию.
OGC–Будет использоваться метод проверки геометрии OGC.

String

Производные выходные данные

Имя	Объяснение	Тип данных
out_feature_class	Обновленные входные объекты	Feature Layer

Пример кода

RepairGeometry, пример 1 (окно Python)

В следующем скрипте окна Python показано, как используется функция RepairGeometry в режиме прямого запуска для шейп-файла.

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

RepairGeometry, пример 2 (автономный скрипт)

Следующий автономный скрипт служит примером применения функции RepairGeometry.

# 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)

Параметры среды

Текущая рабочая область, Экстент, Коэффициент параллельной обработки

Особые случаи

Коэффициент параллельной обработки: 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.

Информация о лицензировании

Basic: Ограниченные
Некоторые параметры ограничены уровнем лицензии.
Standard: Да
Advanced: Да

Восстановить геометрию (Инструменты Управление данными)

Краткая информация

Использование

Внимание:

Лицензия:

Примечание:

Параметры

Лицензия:

Примечание:

Производные выходные данные

Параметры среды

Особые случаи

Информация о лицензировании

Связанные разделы