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

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

Генерирует отчет об ошибках геометрии в классе пространственных объектов.

Дополнительную информацию об ошибках геометрии, их причинах и влиянии на работу программного обеспечения см. в разделе Инструменты для проверки и восстановления геометрии.

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

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

Лицензия Desktop Standard или Desktop Advanced требуется, если входные данные находятся в многопользовательской базе данных или в многопользовательской базе геоданных.
Классы пространственных объектов, которые хранятся в многопользовательской базе геоданных, регистрируются как версионные и не поддерживаются.
Значение параметра Выходная таблица будет содержать записи для каждой найденной ошибки геометрии. Если ошибки не найдены, таблица будет пустой.
Содержимое значения параметра Выходная таблица, включая коды поля PROBLEM, приведено на английском языке.
Для точечных объектов применима только ошибка нулевой геометрии.
Чтобы выполнить просмотр пространственных объектов, обозначенных как имеющие проблемы геометрии, можно присоединить значение параметра Входные объекты к значению параметра Выходная таблица с помощью инструмента Добавить соединение, указав входное поле OBJECTID или FID и поле FEATURE_ID выходной таблицы. Если какие-то значения параметра Входные объекты хранятся в многопользовательской базе геоданных, базе данных, GeoPackage или базе данных SpatiaLite, выходная таблица также будет содержать поле TEXT_ID, которое используется для столбцов OBJECTID, не основанных на целых числах.
Опция метода проверки геометрии Esri обеспечивает топологическую правильность геометрии при помощи Метода упрощения Esri. Только проверки Esri доступны для данных, сохраненных в многопользовательской базе геоданных.
Опция метода проверки геометрии OGC обеспечивает соответствие геометрии спецификациям OGC, указанным в OpenGIS Implementation Standard for Geographic information – simple feature access – Part 1: common architecture.
После восстановления геометрии объектов при помощи опции OGC, любые последующие изменения могут привести к тому, что геометрия перестанет соответствовать спецификациям OGC.

После изменения объекта запустите инструмент Проверить геометрию, чтобы проверить наличие новых проблем с геометрией. При необходимости запустите инструмент Восстановить геометрию.
Геометрия, проверенная или восстановленная при помощи опции OGC, будет допустима для опции Esri. Чтобы узнать больше обоих методов валидации, см. раздел Что такое простой полигон.
Проблемы, выявленные с помощью этого инструмента, можно решить следующими способами:
- Вручную отредактировать и исправить пространственный объект с ошибками геометрии. Некоторые ошибки нельзя устранить редактированием.
- Используйте инструмент Восстановить геометрию. Некоторые проблемы, связанные с данными, хранящимися в многопользовательских базах геоданных, базах данных, GeoPackage и базах данных SpatiaLite, не могут быть устранены с помощью инструментов ArcGIS.
Значение параметра Выходная таблица содержит следующие поля:
- CLASS—Полный путь и название класса объектов, в котором найдена ошибка.
- FEATURE_ID—Feature ID (FID) или Object ID (OID) объекта с ошибкой геометрии.
- TEXT_ID—Это поле существует, только если значения Входные объекты хранятся в многопользовательской базе геоданных, базе геоданных, GeoPackage или базе данных SpatiaLite.
- PROBLEM—Краткое описание ошибки.
Поле PROBLEM будет содержать следующие коды:
- Short segment—Некоторые сегменты короче, чем допускается единицами системы пространственной привязки, связанной с геометрией.
- Null geometry—У объекта нет геометрии или поле SHAPE пустое.
- Incorrect ring ordering—Полигон топологически прост, но его кольца ориентированы некорректно (внешние кольца – по часовой стрелке, внутренние кольца – против).
- Incorrect segment orientation—Отдельные сегменты не ориентированы согласованно. Точка "до" сегмента i должна совпадать с точкой "от" сегмента i+1.
- Self intersections—Полигон не должен пересекать сам себя.
- Unclosed rings—У последнего сегмента в кольце точка "до" должна совпадать с точкой "от" первого сегмента.
- Empty parts—Геометрия состоит из нескольких частей, одна из которых пустая (без геометрии).
- Duplicate vertex—В геометрии есть две или больше вершины с одинаковыми координатами.
- Mismatched attributes—Координаты z или m конечной точки линейного сегмента не соответствуют координатам z или m совпадающей конечной точки следующего сегмента.
- Discontinuous parts—Одна из частей геометрии состоит из разрозненных или дискретных частей.
- Empty Z values—В геометрии есть одна или несколько вершин с пустым z-значением (например, NaN).
- Bad envelope—Конверт не соответствует координатному экстенту геометрии.
- Bad dataset extent—Свойство экстента для набора данных не содержит все объекты набора данных. Для этой ошибки значение FEATURE_ID будет равно -1.
Для данных, хранящихся в многопользовательских базах геоданных, поле PROBLEM будет содержать один из следующих кодов:
- 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—Полигональная оболочка содержит вертикальную линию.
- SE_OUTER_SHELLS_OVERLAP—Составная область содержит перекрывающиеся части.
- SE_SELF_INTERSECTING—Линия или граница полигона являются самопересекающимися.

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

Подпись

Объяснение

Тип данных

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

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

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

Лицензия:

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

Feature Layer

Выходная таблица

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

Отчет (в виде таблицы) о найденных проблемах.

Table

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

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

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

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

String

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

Подпись	Объяснение	Тип данных
Содержит Ошибки геометрии	Определяет, выявил ли инструмент какие-либо проблемы с геометрией.	Boolean

arcpy.management.CheckGeometry(in_features, {out_table}, {validation_method})

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

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

in_features [in_features,...]

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

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

Лицензия:

Feature Layer

out_table

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

Отчет (в виде таблицы) о найденных проблемах.

Table

validation_method

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

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

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

String

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

Имя	Объяснение	Тип данных
problems_found	Определяет, выявил ли инструмент какие-либо проблемы с геометрией.	Boolean

Пример кода

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

Пример скрипта Python для выполнения функции CheckGeometry, в режиме прямого доступа в файловой базе геоданных.

import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.management.CheckGeometry(["contours", "roads", "vegetation"], "CheckGeom_Result")

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

Следующий автономный скрипт использует функцию CheckGeometry путем перебора всех классов пространственных объектов в файловой базе геоданных.

# BatchCheckGeometry.py
# Description: Loop through all the feature classes in a geodatabase, and
#              generate a report of the problems encountered with feature
#              geometry.

# Import modules
import arcpy
import os

# The geodatabase in which the feature classes will be checked
arcpy.env.workspace = "C:\\data\\St_Lucia.gdb"
out_table = "checkGeometryResult"

# A variable that will hold the list of all the feature classes
# in the geodatabase
fc_list = []

# Identify all feature classes in the geodatabase
for path, dirnames, fcs in arcpy.da.Walk(arcpy.env.workspace,
                                         datatype='FeatureClass'):
    for fc in fcs:
        fc_list.append(os.path.join(path, fc))

print("Running the check geometry tool on {} feature classes".format(
    len(fc_list)))
arcpy.management.CheckGeometry(fc_list, out_table)

print("{} geometry problems found, see {} for details.".format(
    arcpy.management.GetCount(out_table)[0], out_table))

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

Следующий скрипт использует функцию CheckGeometry и проверяет полученный результат, чтобы определить, были ли найдены какие-либо проблемы

import arcpy

result = arcpy.management.CheckGeometry('c:/data/data.gdb/badgeometryfc')
if result[1] == 'true':
    # Geometry problems found, print the tool messages.
    print(result.getMessages())

else:
    # No problems found
    print("No problems Found")

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

Экстент, Временная рабочая область, Текущая рабочая область, Выходное ключевое слово конфигурации, Коэффициент параллельной обработки

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

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

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

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

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

Лицензия:

Параметры

Лицензия:

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

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

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

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

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