Вычислить поле (Управление данными (Data Management))
Краткая информация
Вычисляет значения в заданном поле класса объектов, слоев объектов или каталога растров.
Использование
-
Выражения Python могут создаваться с использованием свойств объекта Geometry, включая type, extent, centroid, firstpoint, lastpoint, area, length, isMultipart и partCount (например, !shape.area!).
-
Выражения Python могут использовать свойства геометрии area и length с единицами измерения площади или расстояния для конвертации значений в другие единицы измерения (например, !shape.length@kilometers!). Если данные хранятся в географической системе координат и поддерживаются линейные единицы (например, мили), вычисления длин будут проведены по геодезическому алгоритму. Использование единиц площади в географических данных дает сомнительные результаты, так как десятичные градусы в разных частях глобуса имеют разную длину.
- Ключевые слова площадных единиц измерения:
- ACRES | ARES | HECTARES | SQUARECENTIMETERS | SQUAREDECIMETERS | SQUAREINCHES | SQUAREFEET | SQUAREKILOMETERS | SQUAREMETERS | SQUAREMILES | SQUAREMILLIMETERS | SQUAREYARDS | SQUAREMAPUNITS | UNKNOWN
- Ключевые слова линейных единиц измерения:
- CENTIMETERS | DECIMALDEGREES | DECIMETERS | FEET | INCHES | KILOMETERS | METERS | MILES | MILLIMETERS | NAUTICALMILES | pointS | UNKNOWN | YARDS
- Ключевые слова площадных единиц измерения:
Выражения Python могут использоваться для вычисления геодезической площади или длины объекта с помощью свойств geometryArea или geometryLength вместе с площадными или линейными единицами измерения (например, !shape.geodesicArea@hectares! или !shape.geodesicLength@miles!).
-
В диалоговом окне инструмента выражение вводится непосредственно в строку Выражение (Expression) или интерактивно с помощью Калькулятора поля (Field Calculator).
-
При использовании с выбранным набором пространственных объектов, например созданных из запроса в инструментах Создать векторный слой (Make Feature Layer) или Выбрать в слое по атрибуту (Select Layer by Attribute), этот инструмент обновляет только выбранные записи.
-
Вычисление можно применить только к одному полю за один раз.
-
Существующие значения поля будут перезаписаны. Если вы хотите сохранить исходные значения, сделайте копию входной таблицы.
-
Для вычислений Python имена полей должны быть заключены в восклицательные знаки (!fieldname!).
Для вычислений VB, имена полей должны быть заключены в квадратные скобки ([fieldname]).
-
Для вычисления значений строк в текстовых или символьных полях в диалоговом окне значение строки должно быть указано в двойных кавычках ("string"), или, при написании скрипта, строка в двойных кавычках должна быть заключена еще и в одинарные ('"string"').
-
Этот инструмент может также использоваться для обновления символьных элементов. Текст в выражениях следует заключать в одинарные кавычки – например, [CHARITEM] = 'NEW STRING'. Но если строка символов содержит символы одинарных кавычек, выражение должно быть заключено в двойные кавычки – например, [CHARITEM] = "TYPE'A'".
-
Для вычисления значения в числовом поле введите соответствующее числовое значение в качестве параметра Выражение (Expression); кавычек при этом не требуется.
-
Функция arcgis.rand() поддерживается этим инструментом, если задано выражение Python. Функция arcgis.rand() была создана для инструментов ArcGIS, ее не следует путать с функцией Python Rand(). Синтаксис для доступных функций распределений arcgis.rand() можно найти в разделе Синтаксис распределения для произвольных значений.
-
Выражение и блок кода являются соединенными. Блок кода должен иметь обратное отношение к выражению; результат выполнения блока кода должен передаваться в выражение.
-
Параметр Код блокировки (Code Block) позволяет создавать сложные выражения. Вы можете ввести блок кода непосредственно в диалоговое окно или как непрерывную строку в скрипте.
-
Для использования в параметра Блок кода доступны математический модуль и форматирование Python. Вы можете импортировать дополнительные модули. Математический модуль предлагает теоретико-числовые функции и функции представления, степенные и логарифмические функции, тригонометрические функции, функции углового преобразования, гиперболические функции и математические константы. Дополнительные сведения о математическом модуле находятся в справке Python.
Сохраненные VB файлы .cal из предыдущих версий ArcGIS можно использовать сразу, либо после внесения минимальных изменений. Если у вас есть код VBA из предыдущих версий, использовавший ArcObjects, вам будет надо изменить вычисления, чтобы они заработали.
-
При вычислении присоединенных данных нельзя напрямую вычислять содержимое присоединенных столбцов. Однако вы можете напрямую вычислять значения столбцов исходной таблицы. Чтобы вычислить присоединенные данные, вы должны сначала добавить соединенные таблицы или слои в ArcMap. Затем вы можете отдельно вычислить эти данные. Эти изменения появятся и в присоединенных столбцах.
Вычисления полей с использованием Выражения (Expression) VB не поддерживаются 64-битными продуктами, в том числе ArcGIS for Desktop – Background Geoprocessing – Обработка в фоновом режиме (64-bit) и ArcGIS for Server. Для успешной работы с инструментом Вычислить поле (Calculate Field) в этих продуктах выражения необходимо преобразовать в формат Python, а в случае использования Background Geoprocessing – Обработка в фоновом режиме (64-bit), фоновая обработка может также быть отключена.
Выражения Python, в которых соединяются строковые поля, имеющие значение null либо содержащие деление на ноль, возвратят null в качестве значения такого поля.
- Примеры вычислений полей
Синтаксис
Параметр | Объяснение | Тип данных |
in_table |
Входная таблица, содержащая поля, которые будут обновлены при вычислении. | Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View |
field |
Поля, которые будут обновлены при вычислении. | Field |
expression |
Простое выражение вычисления, используемое для создания значения, которое будет внесено в выбранные строки. | SQL Expression |
expression_type (дополнительно) |
Задает тип используемого выражения.
| String |
code_block (дополнительно) |
Разрешает ввод блока кода в сложные выражения. | String |
Пример кода
Пример скрипта Python для выполнения функции CalculateField с запуском из окна Python в ArcGIS.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.AddField_management("vegtable.dbf", "VEG_TYP2", "TEXT", "", "", "20")
arcpy.CalculateField_management("vegtable.dbf", "VEG_TYP2",
'!VEG_TYPE!.split(" ")[-1]', "PYTHON_9.3")
Используйте CalculateField для присвоения новым полям значения центроида.
# Name: CalculateField_Centroids.py
# Description: Use CalculateField to assign centroid values to new fields
# Import system modules
import arcpy
try:
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
# Set local variables
inFeatures = "parcels"
fieldName1 = "xCentroid"
fieldName2 = "yCentroid"
fieldPrecision = 18
fieldScale = 11
# Add fields
arcpy.AddField_management(inFeatures, fieldName1, "DOUBLE",
fieldPrecision, fieldScale)
arcpy.AddField_management(inFeatures, fieldName2, "DOUBLE",
fieldPrecision, fieldScale)
# Calculate centroid
arcpy.CalculateField_management(inFeatures, fieldName1,
"!SHAPE.CENTROID.X!",
"PYTHON_9.3")
arcpy.CalculateField_management(inFeatures, fieldName2,
"!SHAPE.CENTROID.Y!",
"PYTHON_9.3")
except Exception as e:
# If an error occurred, print line number and error message
import traceback
import sys
tb = sys.exc_info()[2]
print("Line {0}".format(tb.tb_lineno))
print(e.message)
Используйте CalculateField с блоком кода для вычисления значений на основании рангов.
# Name: CalculateField_Ranges.py
# Description: Use CalculateField with a codeblock to calculate values
# based on ranges
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
# Set local variables
inTable = "parcels"
fieldName = "areaclass"
expression = "getClass(float(!SHAPE.area!))"
codeblock = """def getClass(area):
if area <= 1000:
return 1
if area > 1000 and area <= 10000:
return 2
else:
return 3"""
# Execute AddField
arcpy.AddField_management(inTable, fieldName, "SHORT")
# Execute CalculateField
arcpy.CalculateField_management(inTable, fieldName, expression, "PYTHON_9.3",
codeblock)
Используйте CalculateField для присвоения новым полям случайных значений.
# Name: CalculateField_Random.py
# Description: Use CalculateField to assign random values to a new field
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
# Set local variables
inFeatures = "parcels"
fieldName = "RndValue"
expression = "arcgis.rand('Integer 0 10')"
# Execute AddField
arcpy.AddField_management(inFeatures, fieldName, "LONG")
# Execute CalculateField
arcpy.CalculateField_management(inFeatures, fieldName, expression, "PYTHON_9.3")