Вычислить заново экстент класса объектов (Управление данными)

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

Заново вычисляет свойства xy, z и m экстента класса объектов, на основе объектов, входящих в этот класс.

Класс пространственных объектов имеет экстент, основанный на всех координатах в классе объектов. Этот пространственный экстент используется при добавлении класса объектов на карту для повторной центровки и отображения всех объектов. Вместо изучения каждого объекта класса при добавлении класса объектов на карту (потенциально длительный процесс), класс объектов содержит свойство экстента с указанием последнего известного пространственного объекта. Однако свойство экстента не всегда обновляется при редактировании объектов в классе объектов. Это означает, что значения свойства экстента могут не содержать актуальные сведения о пространственном экстенте объектов. Инструмент Вычислить заново экстент класса объектов считывает все объекты и обновляет свойства экстента.

Примечание:

Экстенты XY, Z и M – это не тоже самое, что домены в пространственной привязке. Домены XY, Z и M значений в пространственной привязке задают допустимый диапазон значений координат, которые можно сохранить в классе объектов. Экстенты класса объектов отражают реальный диапазон значений координат, в пределах которых располагаются объекты этого класса. Эти экстенты не могут быть больше, чем значения домена.

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

  • Этот инструмент обновляет классы пространственных объектов базы геоданных или шейп-файлы (точечные, мультиточечные, линейные или полигональные).

  • В многопользовательской базе геоданных экстент является свойством схемы класса объектов, для выполнения необходимо запустить эксклюзивную блокировку схемы.

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

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

  • Инструмент не сможет работать, если у вас отсутствуют права на редактирование класса объектов.

  • Пересчет экстента класса объектов не может быть отменен.

  • Значения экстента возвращаются свойством extent функции arcpy.Describe.

  • Внимание:

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

Параметры

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

Шейп-файл или класс объектов базы геоданных, которые будут обновлены.

Feature Layer
Сохранять экстент
(Дополнительный)

Указывает, будет ли сохраняться экстент для не зарегистрированных классов объектов. Этот параметр активен только в том случае, если входной класс объектов является незарегистрированной пространственной таблицей в базе данных или многопользовательской базе геоданных.

Если входной класс объектов часто обновляется, можно не сохранять значение повторно вычисленного экстента. Если вы выбираете сохранение экстента, он не будет вычисляться заново каждый раз при добавлении класса объектов на карту.

  • Отмечено - экстент будет сохранен для входного класса объектов.
  • Не отмечено - экстент не будет сохранен для входного класса объектов. Это значение по умолчанию
Boolean

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

ПодписьОписаниеТип данных
Обновленный класс пространственных объектов

Обновленный класс пространственных объектов.

Feature Class

arcpy.management.RecalculateFeatureClassExtent(in_features, {store_extent})
ИмяОписаниеТип данных
in_features

Шейп-файл или класс объектов базы геоданных, которые будут обновлены.

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

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

Если входной класс объектов часто обновляется, можно не сохранять значение повторно вычисленного экстента. Если вы выбираете сохранение экстента, он не будет вычисляться заново каждый раз при добавлении класса объектов на карту.

  • STORE_EXTENTЭкстент будет сохранен для входного класса объектов.
  • DO_NOT_STORE_EXTENTЭкстент не будет сохранен для входного класса объектов. Это значение по умолчанию
Boolean

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

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

Обновленный класс пространственных объектов.

Feature Class

Пример кода

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

Пример скрипта окна Python для использования функции RecalculateFeatureClassExtent в режиме прямого запуска. Он заново вычисляет экстент по xy, z или m класса объектов.

import arcpy
feature_class = r"C:\Data\europe.gdb\norway_cities"
arcpy.management.RecalculateFeatureClassExtent(feature_class)