Параметры модели

Любая переменная модели может быть ее параметром. Есть две основных причины задать переменную модели ее параметром.

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

Настройка параметров модели

Чтобы задать переменную модели как параметр, модель необходимо отредактировать в ModelBuilder. В ModelBuilder щелкните правой кнопкой переменную и выберите Параметр. Если переменная задана как параметр, рядом с ней появляется буква P.

Имя переменной используется в качестве подписи параметра инструмента модели. Можно переименовать параметр модели, переименовав переменную в ModelBuilder. Щелкните правой кнопкой переменную, выберите Переименовать и введите новое имя. При открытии модели на панели Геообработка имя параметра будет отражать новое имя. Значение переменной используется в качестве значения по умолчанию соответствующего параметра модели. Если у переменной нет значения в ModelBuilder, параметр инструмента будет пустым.

Чтобы выходные данные инструмента-модели появлялись в Истории геообработки, сделайте их параметрами модели. К примеру, если на выходе вашего инструмента создается HTML-файл, и вы хотите, чтобы пользователь мог щелчком открыть файл на панели История геообработки, сделайте выходной HTML-файл параметром модели.

Свойства параметра модели

Можно изменить некоторые свойства параметров модели, используя окно модели Свойства. Эти свойства влияют на то, как параметры будут появляться при открытии модели на панели Геообработка.

Щелкните правой кнопкой любую модель набора инструментов и выберите Свойства, а при ее редактировании в ModelBuilder – щелкните кнопку Свойства на ленте ModelBuilder.

Порядок

Измените порядок параметров, перетаскивая их в нужные места и расставляя в нужном порядке на закладке Параметры окна Свойства инструмента.

Тип

  • Требуется - параметр должен иметь значение для запуска инструмента.
  • Дополнительно – для параметра не обязательно вводить значение.
  • Производные - используйте производные параметры для следующих случаев:
    • Выходные данные совпадают с входными. Например, инструмент Вычислить поле обновляет значения поля во входной таблице - он не создает таблицу и не изменяет схему входных данных.
    • Инструмент изменяет схему входных данных. Например, инструмент Добавить поле добавляет поле во входную таблицу.
    • Инструмент выводит скалярное значение, такое как число, строка или логическое значение. Например, инструмент Посчитать строки возвращает производное целочисленное значение.
    • Инструмент создает выходные данные из значений других параметров. Например, инструмент Создать класс пространственных объектов возвращает путь производного класса пространственных объектов, созданный на основе других параметров, имеющих значения пути и имени.
    • Инструмент будет создавать данные в известном местоположении. Например, у вас может быть скрипт, который создает класс пространственных объектов в известной рабочей области. Ни класс пространственных объектов, ни рабочая область не являются опциями параметра.

Назначение обязательного, дополнительного и производного типов происходит автоматически на основе того, как параметр используется в модели. Например, если переменная используется в качестве входной для обязательного параметра, параметр модели будет обязательным. Можно изменить параметры модели из дополнительных, – сделав их обязательными для инструмента-модели, однако нельзя сделать обязательные параметры дополнительными.

Чтобы сделать дополнительный параметр обязательным, задайте Тип опций как Обязательный на вкладке Параметры окна Свойства инструмента.

Направление

В данном свойстве определяется, представляет ли параметр входные данные для инструмента или выходные.

Если тип параметра – производный, то направление параметра автоматически задается как выходное.

Все инструменты-скрипты должны иметь выходные параметры, чтобы они могли использоваться в приложении ModelBuilder. Основной принцип ModelBuilder - соединение выходных данных одних инструментов с входными данными других, и если инструмент-скрипт не имеет выходного параметра, он не очень пригоден в ModelBuilder. Выходными данными может быть набор данных, который вводится в качестве значения параметра, производные выходные данные, для которых местоположение или имя определяются в скрипте, или производное значение, которое рассчитывается или определяется. В крайнем случае, выходным параметром может быть логическая переменная, указывающая на успешное (или нет) завершение работы инструмента.

Категория

Параметры можно объединить в категорию. Параметры по категориям показываются в ниспадающем разделе при открытии инструмента на панели Геообработка.

Фильтры

Фильтры параметров используются для ограничения или запрета входных значений или данных, которые можно указать для параметра инструмента модели. Например, фильтр Список значений требует, чтобы параметры были указаны только значения из списка. При введении для параметра значений, которые не соответствуют фильтру, появится сообщение об ошибке. Модель невозможно запустить, пока не будет введено корректное значение.

Доступны следующие фильтры:

  • Список значений – Список предустановленных ключевых слов. Можно задать фильтр значений списка для строковых или числовых параметров модели.
  • Диапазон – Минимальное и максимальное числовое значение. Диапазон открытый, т.е. включает пограничные – минимальное и максимальное – значений.
  • Класс пространственных объектов – Список допустимых типов объектов, включающий точки, мультиточки, полилинии, полигоны и мультипатч.
  • Файл – Список допустимых расширений, например, .txt или .gpx.
    Примечание:

    Не вводите точку перед расширением. К примеру, введите txt, а не .txt. Разделяйте значения в списке точкой с запятой (;). Например, чтобы допустимыми были файлы .txt и .csv, введите txt; csv.

  • Поле – Список допустимых типов полей, включающий short (короткое целое), long (длинное целое), single (с плавающей точкой одинарной точности), double (с плавающей точкой двойной точности), test (тест), date (дата), OID, geometry (геометрия), BLOB, raster, GUID, global ID и XML.
  • Рабочая область – Тип допустимой рабочей области: папка файловой системы, локальная и корпоративная база геоданных.

Зависимость

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

Символы

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

  • Задать опцию Символы выходного параметра пути к файлу слоя, например, C:\Data\LandUseOverlay\Symbolized.lyrx на вкладке Параметры окна Свойства инструмента.
  • Добавить инструмент Применить символы к слою в конце модели и задайте параметр Слой символов для пути к файлу слоя.

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