ArcGIS10.x系列 Python工具箱教程

1.前提

如果你想自己写Python工具箱，那么假定你已经会ArcPy，如果只是自己用，完全没有必要，直接脚本运行。如果是给其他人用，为了简洁明了，适用这里。Python工具箱10.2无法加密，但是工具箱+Sc ript脚本是可以加密的。10.5以上Python工具箱可加密。

本文只介绍Python工具箱，对于工具箱+Script脚本不是特别推荐！

2.需要了解的资料

Python工具箱需要知道哪些内容？

[1]Python工具箱代码模板（可自己新建Python工具箱编辑查看代码）

[2]Arcpy.Parameter （重要*****）

[3]Python工具箱输入参数类型(data_type) （重要*****）

[4]在 Python 工具箱中定义工具

[5]定义 Python 工具箱中的参数（重要*****）

3.Python工具箱制作教程

[1]新建python工具箱

[2]右击新建的Python工具箱编辑

[3] 随后txt打开了代码，复制所有代码到py文件中，我这里用的vscode 连接arcgis python2.7

如上图所示，Python工具箱模板。需要关注的有上述箭头部分。

[4]待代码写完后，将代码复制到 “编辑” 的Python工具箱，然后另存为，选择编码格式“ANSI”，替换！

———————————————————————————————————-

小细节：

①Python工具箱不好调试，print无法输出信息，一般采用arcpy.AddMessage、~~arcpy.AddError~~输出信息；

②然后parameters[0].value .valueAsText这些都是arcpy.parameter的属性，查看我提供的Parameter官网介绍即可。

③注意中文格式，设置utf-8，另存ANSI格式。

④着重看给的资料链接 [2]、[3]、[5] 官网说的很明白（中英文可切换），再结合我的样例代码，就很快理解了！

———————————————————————————————————-

4. Python工具箱具体样例代码（DEM流域分析-河网等级 矢量化）

# 设置中文环境 对于中文字符串 前面加u  打印时 需要在字符串后加 .decode('utf-8')
import sys
defalutencoding = 'utf-8'
if sys.getdefaultencoding() != defalutencoding:
    reload(sys)
    sys.setdefaultencoding(defalutencoding)

import os
import arcpy
from arcpy import env
from arcpy.sa import *  #arcpy栅格计算的基本计算器，高级复杂的在arcpy.gp中

# 定义函数
def check_exists_and_delete(dataset_name):
    # 前提已经设置了env.workspace, 检测存在即删除
    if arcpy.Exists(dataset_name):
        arcpy.Delete_management(dataset_name)
        print(u'已删除:'+str(dataset_name))
        return
    return

class Toolbox(object):
    def __init__(self):
        """Define the toolbox (the name of the toolbox is the name of the
        .pyt file)."""
        self.label = "Python工具箱-流域分析"
        self.alias = "Python工具箱-流域分析"
        # List of tool classes associated with this toolbox
        self.tools = [Tool]
class Tool(object):
    def __init__(self):
        """Define the tool (tool name is the name of the class)."""
        self.label = "流域分析"
        self.description = "流域分析要求数据在gdb中操作！只需导入DEM，即可完成填洼-流向-流量-河网-河网分级-分级矢量化。依次生成的结果名称为输入DEM名称+_填洼"
        self.canRunInBackground = False

    def getParameterInfo(self):
        """Define parameter definitions"""
        param_gdb = arcpy.Parameter(
            displayName = "请输入工作空间(GDB)：",
            name = "in_workspace",
            datatype = "DEWorkspace",
            parameterType = "Required",
            direction="Input"
        )
        param_gdb.value = env.workspace

        param_dem = arcpy.Parameter(
            displayName="请输入或选择DEM图层：",
            name="in_dem",
            datatype="GPRasterLayer", # , "DERasterDataset", "GPRasterDataLayer"
            parameterType="Required",
            direction="Input",
        )
        
        param_threshold = arcpy.Parameter(
            displayName="请输入河网分级整型阈值(大于)：",
            name="in_threshold",
            datatype="GPLong",
            parameterType="Required",
            direction="Input",
        )
        param_threshold.value = 1000

        params = [param_gdb, param_dem, param_threshold]
        return params

    def isLicensed(self):
        """Set whether tool is licensed to execute."""
        return True

    def updateParameters(self, parameters):
        """Modify the values and properties of parameters before internal
        validation is performed.  This method is called whenever a parameter
        has been changed."""
        return 

    def updateMessages(self, parameters):
        
        """Modify the messages created by internal validation for each tool
        parameter.  This method is called after internal validation."""
        return

    def execute(self, parameters, messages):
        arcpy.CheckOutExtension("Spatial")  # 必须执行,否则默认不打开??
        env.workspace = parameters[0].valueAsText
        # 相关操作在 系统工具箱->Spatial Analyst Tools->水文分析or地图代数
        # 2.DEM填洼
        DEM_Name = os.path.basename(parameters[1].valueAsText)            # 3-需要修改成自己的DEM名称
        arcpy.AddMessage(u"正在处理DEM图层：" + DEM_Name)
        DEM_TianWa_Name = DEM_Name + u"_填洼"                             # 注意 不能有- 可以是_
        outFill = Fill(DEM_Name)
        check_exists_and_delete(DEM_TianWa_Name)
        outFill.save(DEM_TianWa_Name)
        print(u"完成填洼".decode('utf-8'))
        arcpy.AddMessage(u"完成填洼")

        # 3.DEM流向  根据填洼结果 来计算
        DEM_LiuXiang_Name = DEM_Name + u"_流向"
        outFlowDirection = FlowDirection(DEM_TianWa_Name)
        check_exists_and_delete(DEM_LiuXiang_Name)
        outFlowDirection.save(DEM_LiuXiang_Name)
        print(u"完成流向".decode('utf-8'))
        arcpy.AddMessage(u"完成流向")

        # 4.DEM流量 根据流向结果 来计算
        DEM_LiuLiang_Name = DEM_Name + u"_流量"
        outFlowAccumulation = FlowAccumulation(DEM_LiuXiang_Name)
        check_exists_and_delete(DEM_LiuLiang_Name)
        outFlowAccumulation.save(DEM_LiuLiang_Name)
        print(u"完成流量".decode('utf-8'))
        arcpy.AddMessage(u"完成流量")

        # 5.DEM河网 根据流量 来计算  (arcpy脚本不允许使用RasterCalculator)
        DEM_HeWang_Name = DEM_Name + u"_河网"
        threshold = parameters[2].value                                                  # 4-需要修改成自己的流量阈值
        raster = DEM_LiuLiang_Name
        out_A_Calculator = Con(Raster(raster) > threshold, 1)
        check_exists_and_delete(DEM_HeWang_Name)
        out_A_Calculator.save(DEM_HeWang_Name)
        print(u"完成河网".decode('utf-8'))
        arcpy.AddMessage(u"完成河网")

        # 6.DEM河网分级 根据河网 流向结果 来计算
        DEM_HeWang_FenJi_Name = DEM_Name + u"_河网分级"
        outStreamOrder = StreamOrder(DEM_HeWang_Name, DEM_LiuXiang_Name, "STRAHLER") # STRAHLER分级方法 更合适
        check_exists_and_delete(DEM_HeWang_FenJi_Name)
        outStreamOrder.save(DEM_HeWang_FenJi_Name)
        print(u"完成河网分级".decode('utf-8'))
        arcpy.AddMessage(u"完成河网分级")

        # 6.1 DEM河网分级后栅格结果  矢量化 
        DEM_HeWang_FenJi_SHP_Name = DEM_Name + u"_河网分级矢量"
        check_exists_and_delete(DEM_HeWang_FenJi_SHP_Name)
        StreamToFeature(DEM_HeWang_FenJi_Name, DEM_LiuXiang_Name, DEM_HeWang_FenJi_SHP_Name, "NO_SIMPLIFY")
        print(u"完成河网分级矢量化".decode('utf-8'))
        arcpy.AddMessage(u"完成河网分级矢量化")

        return