ImportToolbox (arcpy)

Резюме

Импортирует заданный набор инструментов в ArcPy, обеспечивая доступ к входящим в этот набор инструментам.

Обсуждение

Хотя все базовые наборы инструментов ArcGIS доступны по умолчанию из скрипта, пользовательские наборы инструментов или наборы инструментов сторонних разработчиков должны добавляться с помощью команды ImportToolBox.

Другие наборы инструментов могут находиться в любой из множества папок или баз геоданных различного происхождения. Среди них могут быть наборы инструментов, созданные вами или вашей организацией, а также наборы инструментов, загруженные с сайтов, таких как ресурсный центр геообработки. В любом случае эти наборы инструментов должны быть одношаговым процессом импортированы в ArcPy, прежде чем их можно будет использовать как инструменты в Python.

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

Server	Синтаксис
Интернет ArcGIS for Server	URL;servicename;{username};{password}

Более подробно об использовании сервиса геообработки в Python

Синтаксис

ImportToolbox (input_file, {module_name})

Параметр	Объяснение	Тип данных
input_file	Набор инструментов геообработки, добавляемая в пакет сайта ArcPy.	String
module_name	Если у набора инструментов нет псевдонима, требуется аргумент module_name. Если доступ к инструменту осуществляется через пакет ArcPy, псевдоним набора инструментов, в котором содержится этот инструмент, требует суффикса (arcpy.<toolname>_<alias>). Поскольку доступ к инструментам и их правильное выполнение в ArcPy зависит от псевдонимов наборов инструментов, псевдонимы чрезвычайно важны при импорте пользовательских наборов инструментов. Приучите себя всегда указывать псевдоним пользовательского набора инструментов. Однако, если псевдоним набора инструментов не указан, можно настроить временный псевдоним в качестве второго параметра.	String

Возвращено значение

Тип данных	Объяснение
Module	Возвращает импортированный модуль. Если требуется, имена инструментов можно получить с помощью свойства __all__ модуля.

Пример кода

Пример ImportToolbox

Импорт набора инструментов геообработки для использования в ArcPy.

import arcpy

# Import custom toolbox
#
arcpy.ImportToolbox("c:/tools/My_Analysis_Tools.tbx")

try:
    # Run tool in the custom toolbox.  The tool is identified by 
    #  the tool name and the toolbox alias.
    #
    arcpy.GetPoints_myanalysis("c:/data/forest.shp")
except:
    print arcpy.GetMessages(2)