Вычислить значение (Calculate Value) (Управление данными)
Резюме
Инструмент Вычислить значение (Calculate Value) выдает результирующее значение на основе указанного выражения Python.
Использование
-
Этот инструмент предназначен для использования в ModelBuilder, а не в скриптах Python.
-
Параметр Тип данных (Data Type) используется в ModelBuilder, чтобы упростить связывание выходных данных инструмента Вычислить значение (Calculate Value) с другими инструментами. Например, если вы используете инструмент Вычислить значение (Calculate Value), чтобы вычислить расстояние для использования в качестве входных данных для параметра Буферное расстояние (Buffer Distance) инструмента Буфер (Buffer), задайте Линейные единицы для параметра Тип данных (Data Type).
-
В этом инструменте можно использовать переменные, созданные в ModelBuilder, но переменные, которые желательно использовать в параметре выражения, нельзя соединить с инструментом Вычислить значение (Calculate Value). Чтобы использовать их в выражении, заключите имя переменной в знаки процента (%). Например, если вы хотите разделить переменную 'Input' на 100, выражение будет таким %Input%/100.
Примечание: в предыдущем выражении, если Input = 123, выражение вернет 1. Чтобы получить десятичные значения, добавьте десятичные знаки к значениям в выражении. Например: %Input%/100.00 вернет 1.23. Следующий рисунок показывает другой пример использования переменных в выражении.
Внимание:Встроенные переменные строкового типа должны быть заключены в кавычки ("%string variable%") в выражении. Встроенные переменные числовых типов (double, long) не требуют кавычек (%double%).
-
Выражения могут быть составлены только в стандартном формате Python. Другие языки скриптов не поддерживаются.
-
Инструмент Вычислить значение (Calculate Value) может вычислить простые математические выражения. Например:
- 3+5
- 9*8
- 4+(9/3)
-
Инструмент Вычислить значение (Calculate Value) позволяет использовать математический модуль Python для выполнения более сложных математических операций. Можно получить доступ к математическому модулю, поставив перед нужной функцией «math». Например:
- math.sqrt(25)
- math.cos(0.5)
-
Постоянные также поддерживаются математическим модулем. Например:
- Математические (Math)
-
Поддерживается функция arcgis.rand(). Функция arcgis.rand() была создана для инструментов ArcGIS, ее не следует путать с функцией Python Rand(). Примеры использования arcgis.rand():
- Вычислить случайное значение из равномерного распределения целых чисел между 0 и 10: arcgis.rand("Integer 0 10")
- Вычислить случайное значение из нормального распределения со средним значением 10 и стандартным отклонением 3: arcgis.rand("Normal 10 3")
Внимание:Выражение arcgis.rand надо вводить строчными символами.
-
Как правило, вы будете задавать выражения в параметре Выражение (Expression). Более сложные выражения, такие как мультилинейные вычисления или логические операции (если такие будут), требуют использования параметра Блок кода (Code Block). Параметр Блок кода (Code Block) нельзя использовать сам по себе, его нужно использовать только вместе с параметром Выражение (Expression).
Выражение может ссылаться на переменные, заданные в параметре Блок кода (Code Block).
В параметре Блок кода (Code Block) можно задавать функции и вызывать их из выражения. В приведенном ниже примере, функция выдает строку направления ветра на основе случайного входного значения. В Python функции задаются с помощью ключевого слова def, за которым следует имя функции и входные параметры функции. В нашем случае это функция getWind с одним параметром,wind. Значения возвращаются из функции с помощью ключевого слова return.
Вы можете передать переменную через параметр Выражение (Expression) и использовать логику if-else с встроенными переменными в Блок коде, как показано ниже. Блок кода проверяет, является ли пустой переменная входного размера ячейки (Input Cell Size), затем возвращает значение на основании этого условия.
Методы Python могут применяться непосредственно в параметре Выражение этого инструмента. Например, если у вас имеется входное значение с десятичным числом (в данном случае - значение поля входной таблицы) и вы хотите использовать это значение в выходном имени другого инструмента посредством подстановки встроенной переменной, то это десятичное число можно заменить, используя метод Python Заменить (replace) в выражении инструмента Вычислить значение (Calculate Value).
В параметре блока кода можно вызвать модули Python и объединить или собрать методы, в частности замену. В приведенном ниже примере модуль время (time) импортирован в блок коде, который возвращает текущие дату и время, такие как Fri Mar 19 2010 09:42:39. Это полученное значение используется в качестве имени папки в инструменте Создать папку (Create Folder). Поскольку имя папки не может содержать пробелы и знаки препинания, метод Python заменить (replace) используется с помощью метода с накоплением для каждого элемента, который требуется заменить. В данном примере папка получит имя FriMar192010094239.
Если вы будете вычислять значение в модели и захотите использовать полученные значения с такими инструментами, как Буфер (Buffer), которым требуется значение буферного расстояния, то вам придется:
- возвратить линейную единицу в блок код вместе со значением расстояния,
- изменить тип данных возвращенных значений, как показано ниже, и
- установить параметр типа данных на линейные единицы, чтобы результат выражения был преобразован в значение, выраженное в линейных единицах.
Результат инструмента Вычислить значение (Calculate Value) можно использовать непосредственно в любом из инструментов Spatial Analyst, которые принимают растровые и постоянные значения, такие как Сложить (Plus),Больше (Greater Than) и Меньше (Less Than) (эти инструменты находятся в наборе инструментов Spatial Analyst > группа инструментов Математические (Math)). Для того, чтобы использовать выходные данные инструмента Вычислить значение (Calculate Value), измените тип выходных данных на формализованный растр (Formulated Raster). Этот формат типа выходных данных представляет собой растровую поверхность, значения ячеек которой представлены формулой или константой.
-
В синтаксисе Python поддерживаются отступы. Уровень отступа (два пробела или четыре пробела) не имеет значения, поскольку соответствует всем кодам блокировки.
-
Вам не доступны переменные модели из кода блокировки. Такие переменные должны быть переданы в код блокировки из выражения. Этого можно достичь, сделав определение в Блоке кода (Code Block) и сославшись на определение в поле Выражение (Expression).
Примечание:При написании скриптов Python используйте стандартные выражения Python вместо инструмента Вычислить значение (Calculate Value).
Синтаксис
| Параметр | Объяснение | Тип данных |
expression |
Выражение на Python, по которому будет произведено вычисление. | SQL Expression |
code_block (дополнительно) |
Дополнительный код Python. На код в коде блокировки можно сослаться в параметре Выражение (Expression). | String |
data_type (дополнительно) |
Тип данных, полученных в результате вычисления. Данный параметр следует использовать при построении моделей, чтобы связать инструмент Вычислить значения с другими инструментами. | String |