Итерировать файлы (ModelBuilder)
Краткая информация
Выполняет итерации над файлами в папке.
Более подробно о том, как работает инструмент Итерировать файлы (Iterate Files) в ModelBuilder
Использование
-
Этот инструмент предназначен для использования в ModelBuilder, а не в скриптах Python.
-
Опция Расширение файла (File Extension) позволяет вам выполнять итерации над файлами с определенным расширением. Например, если вы хотите выполнять итерации только над файлами с расширением .log, установите для параметра Расширение файла (File Extension) значение log.
-
Если файл отображается как набор данных в окне Каталог (Catalog), тогда Итерировать файлы (Iterate Files) пропустит файл. Наиболее частые примеры – это шейп-файлы, dbf файлы, файлы растров (.jpg, .tif, .img, .png, .bmp), файлы САПР (CAD) (.dxf, .dwg), файлы документов карты (.mxd) и персональные базы геоданных (.mdb).
-
У инструмента два элемента выходных данных: Выходной файл и имя (Output File and Name), которые можно использовать как встроенную переменную (Например, %Name%) в других инструментах.
-
Укажите расширение файла в дополнительном параметре расширений, например, txt, .pdf, .zip. Так, если инструмент производит итерацию над текстовыми файлами и результат его работы будет использоваться в инструментах, например, в инструменте ASCII в Raster (ASCII To Raster), то в дополнительном параметре расширений необходимо указать расширение .txt.
Большинство инструментов принимают формат выходного файла инструмента Iterate Files (Итерировать файлы), кроме таких инструментов как, Копировать (Copy), для которых расширение файла необходимо указывать в выходном имени Пример – Если вы используете инструмент Итерировать файлы (Iterate Files), чтобы выполнять итерации с .zip файлами с тем, чтобыиспользовать их в качестве входных объектов для инструмента Копировать (Copy), выходное имя файла должно содержать расширение Name.zip или %Name%.zip.
-
Если итератор добавлен в модель, все инструменты в модели будут повторяться для каждого значения в итераторе. Если вы не хотите запускать каждый инструмент в модели для каждого значения итерации, создайте подмодель/модель в пределах модели/вложенной модели (sub-model/model within a model/nested model), которая содержит только итератор, и добавьте ее как инструмент модели в основную модель.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_folder |
Папка, в которой расположены входные файлы. | Folder |
wildcard (дополнительно) |
Групповой символ.Комбинация * и символов, которые накладывают ограничение на результат. Символ звездочки означает ВСЕ. Если групповой символ не задан, то будут обрабатываться все входные данные. Например, его можно использовать для того, чтобы ограничить итерирование только входными именами, начинающимися с определенного символа или слова (например, A* или Ari* или Land* и т.д.). | String |
extension (дополнительно) |
Расширение файла, такое как TXT, ZIP и т. д. Только файлы с расширением будут итерироваться. Не используйте пробел перед расширением файла. | String |
recursive (дополнительно) |
Определяет, будут ли все вложенные папки в основной обрабатываться рекурсивно.
| Boolean |