【287】◀▶ arcpy 常用类说明

ArcPy 类列表（按字母顺序）

01	Raster	创建一个可在 Python 脚本或地图代数表达式中使用的栅格对象。
02	Cursor	Cursor 是一种数据访问对象，可用于在表中迭代一组行或者向表中插入新行。
03	Row	行对象表示表中的某一行。行对象会从 InsertCursor、SearchCursor 和 UpdateCursor 中返回。
04	Array	数组对象中可包含点和数组，它用于构造几何对象。
05	Point	点对象经常与光标配合使用。点要素将返回单个点对象而不是点对象数组。
06	Polyline	折线对象是由一个或多个路径定义的形状，其中路径是指一系列相连线段。
07	Polygon	面对象是指由一系列相连的 x,y 坐标对定义的闭合形状。
08	Extent	范围是在地图单位下提供左下角和右上角坐标指定的一个矩形。

序号

类名称

功能说明

语法 & 举例

Raster

====<<<< Description >>>>====

创建一个可在 Python 脚本或地图代数表达式中使用的栅格对象。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Raster (inRaster)
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈ inRaster：输入栅格数据集。
----------------------------------------------------------------------------------

====<<<< Properties >>>>====

◈ height：行数。（只读）
◈ width：列数。（只读）
◈ maximum：栅格数据集的最大值。（只读）
◈ minimum：栅格数据集的最小值。（只读）
◈ mean：栅格数据集的平均值。（只读）
◈ meanCellHeight：y 方向上的象元大小。（只读）
◈ meanCellWidth：x 方向上的象元大小。（只读）
◈ name/path/
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈ save ({name})：永久保存栅格对象引用的数据集。
　　name：分配给磁盘上的栅格数据集的名称。（String）

# 获取栅格数据
arcpy.env.workspace=r"D:\01-Working\2017\20171204-IDL_Average\temp\TSM"
rs = arcpy.ListRasters()
 
# 遍历栅格数据获取统计信息
# 首先需要建立栅格文件
# 将数据结果保留两位小数
# 输出到txt文档中
 
fo = open("D:\\01-Working\\2017\\20171204-IDL_Average\\temp\\tsm_stats.txt", "w+")
for r in rs:
    ro = arcpy.Raster(r)
    fo.writelines(ro.name + "\n")
    fo.writelines("MAX: " + str(round(ro.maximum, 2)) + "\n")
    fo.writelines("MIN: " + str(round(ro.minimum, 2)) + "\n")
    fo.writelines("MEAN: " + str(round(ro.mean, 2)) + "\n\n")
     
fo.close()

Cursor

====<<<< Description >>>>====

Cursor 是一种数据访问对象，可用于在表中迭代一组行或者向表中插入新行。游标有三种形式：搜索、插入或更新。游标通常用于读取和更新属性。（不同于arcpy.da.SearchCursor）

----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈ deleteRow (row)：删除数据库中的某一行。将删除与游标当前所在位置相对应的行。
◈ insertRow (row)：向数据库中插入新行。
◈ newRow ()：创建空行对象。
◈ next ()：返回当前索引中的下一个对象。（返回 Row）
◈ reset ()：将当前枚举索引（由 next 方法使用）设置回第一个元素。
◈ updateRow (row)：updateRow 方法可用于对更新游标当前所在的行进行更新。

import arcpy
mxd = arcpy.mapping.MapDocument("CURRENT")
lyr = arcpy.mapping.ListLayers(mxd)[0]
 
# 获取指定图层的游标  
cursor = arcpy.UpdateCursor(lyr)
 
# 遍历
for row in cursor:
    # 添加数值
    row.setValue("AREA", 200)
    # 将数据进行更新
    cursor.updateRow(row)
     
# 将其删除
del cursor, row
     
cursor = arcpy.SearchCursor(lyr)
for row in cursor:
    name = row.getValue("NAME")
    print name
 
# 将其删除
del cursor, row
 
cursor = arcpy.InsertCursor(lyr)
for i in range(1, 10):
    row = cursor.newRow()
    row.setValue("NAME", "阿拉斯加")
    row.setValue("ID", i)
    cursor.insertRow(row)
     
# 将其删除
del cursor, row

Row

====<<<< Description >>>>====

行对象表示表中的某一行。行对象会从 InsertCursor、SearchCursor 和 UpdateCursor 中返回。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈   getValue (field_name)：获取字段值。
◈   isNull (field_name)：字段值是否为空。
◈   setNull (field_name)：将字段值设置为空。
◈   setValue (field_name)：设置字段值。

Array

====<<<< Description>>>>====

数组对象中可包含点和数组，它用于构造几何对象。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Array ({items})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈ items：项目可以包含列表、点对象或另一个数组对象。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈ add (value)：将点或数组对象添加到数组的结尾处。
◈ append (value)：在数组中的最后一个位置追加一个对象。
◈ clone (point_object)：克隆点对象。
◈ extend (items)：通过追加元素扩展数组。
◈ getObject (index)：返回数组中给定索引位置上的对象。
◈ insert (index, value)：在数组中的指定索引处添加一个对象。
◈ next ()：返回当前索引中的下一个对象。
◈ remove (index)：从数组中的指定索引位置移除对象。
◈ removeAll ()：移除所有值并创建一个空对象。
◈ replace (index, value)：替换数组中指定索引位置上的对象。
◈ reset ()：将当前枚举索引（由 next 方法使用）设置回第一个元素。
----------------------------------------------------------------------------------

====<<<< Attributes >>>>====

◈ count：数组的元素个数。

# 创建以元组为元素的列表
>>> coords = [(1, 2), (1, -2), (-1, -2), (-1, 2), (1, 2)]
 
# 创建空的数组对象
>>> ar = arcpy.Array()
>>> ar
<Array []>
 
# 通过循环，将列表信息以点的形式添加到数组对象中
>>> for x, y in coords:
...     ar.add(arcpy.Point(x, y))
...     
 
# 查看数组对象
>>> ar
<Array [<Point (1.0, 2.0, #, #)>, <Point (1.0, -2.0, #, #)>, 
<Point (-1.0, -2.0, #, #)>, <Point (-1.0, 2.0, #, #)>, 
<Point (1.0, 2.0, #, #)>]>

# 创建列表
>>> coords = [(1, 2), (1, -2), (-1, -2), (-1, 2), (1, 2)]
 
# 转化为含有 Point 对象的列表
>>> points = [arcpy.Point(x, y) for x, y in coords]
 
# 定义数组对象并显示
>>> ar1 = arcpy.Array(points)
>>> ar1
<Array [<Point (1.0, 2.0, #, #)>, <Point (1.0, -2.0, #, #)>, 
<Point (-1.0, -2.0, #, #)>, <Point (-1.0, 2.0, #, #)>, 
<Point (1.0, 2.0, #, #)>]>

Point

====<<<< Description>>>>====

点对象经常与光标配合使用。点要素将返回单个点对象而不是点对象数组。而其他要素类型（面、折线和多点）都将返回一个点对象数组，并且当这些要素具有多个部分时，则返回包含多个点对象数组的数组。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Point ({X}, {Y}, {Z}, {M}, {ID})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈ X：点的 X 坐标。
◈ Y：点的 Y 坐标。
◈ Z：点的 Z 坐标。
◈ M：点的 M 值。
◈ ID：点的形状 ID。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈ clone ()：克隆点对象。
◈ contains (second_geometry)：包含
◈ crosses (second_geometry)：交叉
◈ disjoint (second_geometry)：不相交
◈ equals (second_geometry)：相同
◈ overlaps (second_geometry)：重叠
◈ touches (second_geometry)：接触
◈ within (second_geometry)：内部
----------------------------------------------------------------------------------

====<<<< Attributes >>>>====

◈ ID：唯一标识点的整数。
◈ M：点的 measure value。
◈ X：点的横坐标。
◈ Y：点的纵坐标。
◈ Z：点的高程值。

# 通过元组列表创建 Point 数组
>>> coords = [(1, 2), (1, -2), (-1, -2), (-1, 2), (1, 2)]
 
# 通过这样的形式创建 Point
>>> points = [arcpy.Point(x, y) for x, y in coords]
 
# 创建 Point 数组并显示
>>> arr = arcpy.Array(points)
>>> arr
<Array [<Point (1.0, 2.0, #, #)>, <Point (1.0, -2.0, #, #)>, 
<Point (-1.0, -2.0, #, #)>, <Point (-1.0, 2.0, #, #)>, 
<Point (1.0, 2.0, #, #)>]>

# 通过列表列表创建Point数组
>>> coords = [[1, 2], [1, -2], [-1, -2], [-1, 2], [1, 2]]
 
# 通过这样的形式创建 Point
>>> points = [arcpy.Point(*p) for p in coords]
 
# 创建 Point 数组并显示
>>> arr = arcpy.Array(points)
>>> arr
<Array [<Point (1.0, 2.0, #, #)>, <Point (1.0, -2.0, #, #)>, 
<Point (-1.0, -2.0, #, #)>, <Point (-1.0, 2.0, #, #)>, 
<Point (1.0, 2.0, #, #)>]>

# 另外一种读取方法
>>> coords = [[1, 2], [1, -2], [-1, -2], [-1, 2], [1, 2]]
>>> points = [arcpy.Point(x, y) for x, y in coords]

Polyline

====<<<< Description>>>>====

折线对象是由一个或多个路径定义的形状，其中路径是指一系列相连线段。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Polyline (inputs, {spatial_reference}, {has_z}, {has_m})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈ inputs：用来创建对象的坐标。数据类型可以是点或者数组对象。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈ boundary ()：构造几何边界。面→线、线→点、点→空
◈ buffer (distance)：在距几何的指定距离处构造一个面。
◈ clip (envelope)：构造几何体与指定范围（extent）的交集。
◈ convexHull ()：构造具有最小边界多边形的几何，以便所有外角均为凸角。
◈ cut (cutter)：将该几何分割到剪切折线的左右两侧。
◈ distanceTo (other)：返回两个几何之间的最小距离。

◈ contains (second_geometry)：包含
◈ crosses (second_geometry)：交叉
◈ disjoint (second_geometry)：不相交
◈ intersect (other, dimension)：相交（结果 Geometry，1-点、2-线、4-面）
◈ symmetricDifference (other)：交集取反
◈ union (other)：联合
◈ equals (second_geometry)：相同
◈ overlaps (second_geometry)：重叠
◈ touches (second_geometry)：接触
◈ within (second_geometry)：内部

◈ getLength ({measurement_type}, {units})：使用测量类型返回要素的长度。
◈ getPart ({index})：返回几何特定部分的点对象数组，或包含多个数组（每个数组对应一个部分）的数组。
----------------------------------------------------------------------------------

====<<<< Attributes >>>>====

◈ extent：几何范围。
◈ firstPoint：第一个几何坐标点。
◈ isMultipart：如果此几何的部分数大于一，则为 True。
◈ lastPoint：要素的最后一个坐标。
◈ length：线状要素的长度。点和多点要素类型为零。
◈ partCount：要素几何部分的数目。
◈ pointCount：要素的总点数。
◈ type：几何类型：面、折线、点、多点、多面体、尺寸或注记。

Polygon

====<<<< Description>>>>====

面对象是指由一系列相连的 x,y 坐标对定义的闭合形状。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Polygon (inputs, {spatial_reference}, {has_z}, {has_m})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈ inputs：用来创建对象的坐标。数据类型可以是点或者数组对象。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈ boundary ()：构造几何边界。面→线、线→点、点→空
◈ buffer (distance)：在距几何的指定距离处构造一个面。
◈ clip (envelope)：构造几何体与指定范围（extent）的交集。
◈ convexHull ()：构造具有最小边界多边形的几何，以便所有外角均为凸角。
◈ cut (cutter)：将该几何分割到剪切折线的左右两侧。
◈ distanceTo (other)：返回两个几何之间的最小距离。

◈ difference (other)：差异
◈ contains (second_geometry)：包含
◈ crosses (second_geometry)：交叉
◈ disjoint (second_geometry)：不相交
◈ intersect (other, dimension)：相交（结果 Geometry，1-点、2-线、4-面）
◈ symmetricDifference (other)：交集取反
◈ union (other)：联合
◈ equals (second_geometry)：相同
◈ overlaps (second_geometry)：重叠
◈ touches (second_geometry)：接触
◈ within (second_geometry)：内部

◈ getArea ({type}, {units})：使用测量类型返回要素的面积。
◈ getLength ({measurement_type}, {units})：使用测量类型返回要素的长度。
◈ getPart ({index})：返回几何特定部分的点对象数组，或包含多个数组（每个数组对应一个部分）的数组。
----------------------------------------------------------------------------------

====<<<< Attributes >>>>====

◈ area：面要素的面积。
◈ centroid：如果质心位于要素之内或要素之上则为真；否则返回标注点。返回点对象。
◈ trueCentroid：要素的重心。
◈ extent：几何范围。
◈ firstPoint：第一个几何坐标点。
◈ isMultipart：如果此几何的部分数大于一，则为 True。
◈ lastPoint：要素的最后一个坐标。
◈ length：线状要素的长度。点和多点要素类型为零。
◈ partCount：要素几何部分的数目。
◈ pointCount：要素的总点数。
◈ type：几何类型：面、折线、点、多点、多面体、尺寸或注记。

Polygon 解析：

一个 Polygon 含有多个部分，需要通过 for 循环读取，每个部分是一个 Array 对象

一个 Array 对象内部包括 N 个 Point，需要通过 for 循环读取每个 Point

# 获取 China 所对应的 Geometry
>>> cursor = arcpy.da.SearchCursor("CNTRY92", "SHAPE@", "NAME = 'China'")
 
# 读取符合条件的 Geometry 为一个列表，只有一个元素
>>> polygons = [row[0] for row in cursor]
>>> len(polygons)
1
 
# 获取 China 对应的 Polygon
>>> china = polygons[0]
 
# 判断 China 对应的 Polygon 是否为多部分的
>>> china.isMultipart
True
>>> china.partCount
2
>>> china.pointCount
839
 
# 获取每一部分为一个列表，part 对应 Array 对象
>>> lands = [part for part in china]
>>> lands
 
# 包括 2 个部分，每个部分都是包含 Point 的 Array 对象
>>> len(lands)
2
 
# 将 Array 转换为 list
>>> points = [pnt for pnt in lands[0]]
 
# 通过 Array 建立新的 Polygon 并输出
>>> mainland = arcpy.Polygon(lands[1])
>>> arcpy.CopyFeatures_management(mainland, "mainland.shp")
<Result 'D:\\McDelfino\\Documents\\ArcGIS\\mainland.shp'>

Extent

====<<<< Description>>>>====

范围是在地图单位下提供左下角和右上角坐标指定的一个矩形。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Extent ({XMin}, {YMin}, {XMax}, {YMax}, {ZMin}, {ZMax}, {MMin}, {MMax})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈ XMin：范围 XMin 值。
◈ YMin：范围 YMin 值。
◈ XMax：范围 XMax 值。
◈ YMin：范围 YMax 值。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈ contains / crosses / disjoint / equals / overlaps / touches / within
◈ 方法使用与 Polygon 类似
◈ union (other)：联合◈ equals (second_geometry)：相同◈ overlaps (second_geometry)：重叠◈ touches (second_geometry)：接触◈ within (second_geometry)：内部
----------------------------------------------------------------------------------

====<<<< Attributes >>>>====

◈ XMin：范围 XMin 值。
◈ YMin：范围 YMin 值。
◈ XMax：范围 XMax 值。
◈ YMin：范围 YMax 值。
◈ height：范围高度值。( YMax - YMin )
◈ width：范围宽度值。( XMax - XMin )

◈ lowerLeft：左下角属性：将返回点对象。
◈ lowerRight：右下角属性：将返回点对象。
◈ upperLeft：左上角属性：将返回点对象。
◈ upperRight：右上角属性：将返回点对象。

◈ polygon：以多边形对象的形式返回范围。
◈ spatialReference：范围的空间参考。

>>> e2 = df.extent
>>> e2.XMax
149.1029612143459
>>> e2.XMin
64.02167430592488
>>> e2.YMax
50.20513847572508
>>> e2.YMin
18.71509185629973
>>> e2.MMax
>>> e2.ZMax
>>> pnt = e2.lowerLeft
>>> pnt
<Point (64.0216743059, 18.7150918563, #, #)>
>>> e2.height
31.49004661942535
>>> e2.width
85.08128690842102