AddToolbox (arcpy)

Resumen

Imports the specified toolbox into ArcPy, allowing for access to the toolbox's associated tools.

Nota:

Equivalent to the ImportToolbox function.

Debate

While any of the core ArcGIS toolboxes are accessible by default in a script, your own custom or third-party toolboxes must be added using ImportToolbox to use them in a script.

Other toolboxes may be found in any number of different folders or geodatabases, and may have many different origins; they may be toolboxes you have personally created, or are toolboxes created internally by your organization, or are toolboxes you have downloaded from sites like the Geoprocessing Resource Center. In any case, these toolboxes need to be imported into ArcPy in a one-step process before they can be used as tools in Python.

Server toolboxes can also be added using a semicolon delimiter.

Server	Syntax
Internet ArcGIS for Server	URL;servicename;{username};{password}

Learn more about using a geoprocessing service in Python

Sintaxis

AddToolbox (input_file, {module_name})

Parámetro	Explicación	Tipo de datos
input_file	The geoprocessing toolbox to be added to the ArcPy site package.	String
module_name	If the toolbox does not have an alias, the module_name is required. When a tool is accessed through the ArcPy site package, the toolbox alias where the tool is contained is a required suffix (arcpy.<toolname>_<alias>). Since ArcPy depends on toolbox aliases to access and execute the correct tool, aliases are extremely important when importing custom toolboxes. A good practice is to always define a custom toolbox's alias. However, if the toolbox alias is not defined, a temporary alias can be set as the second parameter.	String

Valor de retorno

Tipo de datos	Explicación
Module	Returns the imported module. If needed, tool names can be accessed from the module's __all__ property.

Ejemplo de código

AddToolbox example

Add the specified toolbox.

import arcpy

# Import custom toolbox
#
arcpy.AddToolbox("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)