Переменные являются элементами модели, в которых хранятся значения или ссылки на данные. Переменные могут использоваться в качестве входных параметров для инструментов анализа. Использование переменных ускоряет настройку итераций по параметрам инструментов, так как для изменения значений переменной не нужно открывать полное диалоговое окно инструмента. Переменные также можно использовать для публикации входных значений для нескольких инструментов анализа.
Добавление переменной
Переменные можно добавить в модель из параметра инструмента или как автономные переменные.
Добавление переменной из параметра инструмента
Переменная может быть добавлена непосредственно из параметра инструмента. Добавление переменной из параметра инструмента обеспечивает следующее:
- Структура переменной и тип данных совместимы с выбранным параметром инструмента
- Значение параметра инструмента по умолчанию или указанное пользователем значение автоматически заполняется, когда это применимо.
- Определенные входные данные параметра инструмента (например, меню поддерживаемых единиц) доступны в переменной, когда это применимо
- Переменная автоматически подсоединяется к инструменту, не требуя дополнительных действий
Выполните следующие действия, чтобы добавить переменную из параметра инструмента:
- При необходимости выполните действия, чтобы открыть модель и добавить данные и инструменты.
- Выберите элемент инструмента и нажмите Добавить переменную
на его панели инструментов.Откроется меню Выбрать параметр... со списком всех параметров инструмента.
Если кнопка Добавить переменную неактивна, убедитесь, что вы подключены к сеансу анализа и модель активна.
- Выберите нужный параметр, щелкнув на его название.
Переменная добавляется в модель и подсоединяется к инструменту. Если для параметра задано значение по умолчанию, то оно автоматически присваивается переменной, и она отображается в состоянии "готов к выполнению" (синим цветом). Если значение по умолчанию или определенное пользователем отсутствует, то переменная пустая и отображается в состоянии "не готов к выполнению" (серым цветом). Вы можете открыть свойства элемента, чтобы изменить значение переменной.
Создание автономной переменной
Автономная переменная добавляется в модель без привязки к какому-либо параметру инструмента. Чтобы параметры инструмента могли использовать добавленную переменную, ее необходимо соединить с этим инструментом.
Выполните следующие действия, чтобы добавить в модель автономную переменную:
- Выполните шаги по открытию модели, подключитесь к сеансу анализа и активируйте модель при необходимости.
- Щелкните Добавить переменную на панели действий.
Откроется окно Добавить переменную с настройками типа переменной и типа данных. По умолчанию это Одно значение с типом данных Строка.
Если кнопка Добавить переменную неактивна, убедитесь, что вы подключены к сеансу анализа и модель активна.
- Для параметра Выбрать тип переменной при необходимости выберите Несколько значений.
- В меню Выбрать тип данных переменной вы можете при необходимости выбрать другой вариант.
- Щёлкните Добавить.
Переменная добавляется в модель. Вы можете обновить значение переменной, открыв свойства элемента, и нарисовать соединение переменной с элементом инструмента. Соединять переменные можно только с совместимыми с ними параметрами инструмента.
Соединение переменных с инструментами
Когда переменная добавлена в модель, ее нужно соединить с инструментом, который будет использоваться в качестве параметра инструмента. Это можно сделать через диалоговое окно инструмента или нарисовав соединение непосредственно на схеме.
Рисование соединения
Выполните следующие действия, чтобы нарисовать соединение между переменной и инструментом:
- При необходимости выполните действия, чтобы открыть модель и добавить инструменты данных и переменные при необходимости.
- Щелкните порт с правой стороны переменной и перетащите его к порту с левой стороны инструмента.
Появится меню Выбрать входные данные... со списком совместимых параметров инструмента.
- Выберите параметр, в котором будет использоваться переменная (например, Входной слой).
Между переменной и инструментом появляется соединение и инструмент проходит проверку. При открытии диалогового окна инструмента значение переменной будет проставлено в указанном параметре.
Соединение переменных с инструментом через его диалоговое окно
Выполните следующие шаги, чтобы соединить переменные с инструментом через его диалоговое окно:
- При необходимости выполните действия, чтобы открыть модель и добавить инструменты данных и переменные при необходимости.
- Выберите элемент инструмента и щелкните Открыть
на панели инструментов элемента или дважды щелкните элемент инструмента, чтобы открыть его. - Нажмите Выбрать переменную рядом с параметром, к которому ее нужно добавить.
Откроется диалоговое окно Выбрать переменную со списком переменных модели, подходящих для этого параметра. Если список пуст, необходимо создать новую переменную (см. инструкции выше).
- Выберите нужную переменную из списка.
Переменная станет соединена с параметром.
- При необходимости обновите остальные параметры и нажмите Подтвердить.
Между переменной и инструментом появляется соединение и инструмент проходит проверку.
Изменение переменной
Вы можете добавить, обновить или удалить значение переменной, открыв окно со свойствами элемента.
Выполните следующие действия, чтобы обновить переменную входных данных:
- При необходимости, откройте панель ModelBuilder и добавьте переменную.
- Выделите переменную и нажмите Открыть на панели инструментов элемента, либо дважды щелкните по элементу.
Откроется диалоговое окно, показывающее тип переменной.
- Вы можете сделать следующее:
- Для переменных double или integer введите число в текстовое поле или используйте стрелки «вверх» и «вниз», чтобы увеличить или уменьшить значение.
- Для переменных double (несколько значений) введите одно или несколько чисел в текстовое поле, нажимая Добавить или Enter после каждого числа. Чтобы удалить число, нажмите кнопку удаления
для нужного значения. - Для переменных слоя объектов или таблицы щелкните входной набор данных или кнопку Слой и выберите слой из списка, либо укажите путь к поддерживаемому слою.
Примечание:
Если переменная уже соединена с одним и несколькими инструментами анализа, будут доступны только наборы данных, подходящие к этому инструменту и параметру. Если параметры не поддерживают одни и те же объекты (например, один параметр поддерживает только точки, а другой — только полигоны), переменная не сможет определить, какие слои совместимы, что может привести к ошибке для одного или нескольких инструментов.
- Для строковых переменных введите текст в текстовое поле. Если переменная уже соединена с инструментом анализа, для нее может отображаться меню опций.
- Щелкните Подтвердить.
Переменная обновляется и проходит проверку.
Типы переменных
Существует несколько типов переменных:
- Одно значение — позволяет добавить одно значение одного типа данных. Поддерживаются переменные с одним значением для типов данных слой объектов, таблица, double, integer, строка и линейная единица.
- Несколько значений — позволяет добавить нескольких значений одного типа данных. На данный момент этот вариант поддерживает только тип данных double. Например, переменную типа double (несколько значений) можно использовать для параметра Расстояние в инструменте Создать буферы.
Примечание:
Параметры, поддерживающие переменные double с несколькими значениями, также поддерживают одну или несколько переменных double с одним значением.
Поддерживаемые типы данных
Поддерживаются следующие типы данных:
- Double – числа с десятичными знаками после запятой. Этот тип данных можно использовать в переменных с одним или несколькими значениями.
- Слой объектов – элемент размещенного слоя объектов.
- Integer – числа без десятичного разделителя. В переменной можно использовать отрицательные значения, однако их поддерживают не все параметры инструментов.
- Линейная единица — числа и единицы измерения.
- String — строки, содержащие буквенно-цифровые и специальные символы.
- Таблица — элементы размещенных таблиц.
Ограничения
Параметры инструмента, которые принимают строковые переменные типа string, имеют определенные списки допустимых входных значений (например, меню поддерживаемых единиц измерения). Рекомендуется добавить строковые переменные из параметра инструмента или соединить переменную с параметром инструмента перед обновлением значения переменной. Ввод значения в несоединенную строковую переменную может привести к ошибкам.
Следующие параметры инструмента не поддерживают добавление переменной из параметра, но поддерживают соединение отдельной переменной:
| Инструмент | Параметр | Тип переменной |
|---|---|---|
Присоединить объекты | Целевой слой | Слой пространственных объектов или таблица |
Присоединяемый слой | ||
Вычислить составной индекс | Входные объекты или таблица | |
Фильтр по атрибутам | Входной набор данных | |
Вычислить поле | Входной набор данных | |
Агрегировать точки | Размер бина | Линейные единицы измерения |
Суммировать в пределах | Размер бина | |
Обогатить слой | Значение измерения | |
Создать замощение | Размер бина |