【287】◀▶ arcpy 常用类说明

1. ArcPy 类列表（按字母顺序）

---

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

---

序号	类名称		功能说明		语法 & 举例
01	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()
02	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
03	Row		====<<<< Description >>>>==== 行对象表示表中的某一行。行对象会从 InsertCursor、SearchCursor 和 UpdateCursor 中返回。 ---------------------------------------------------------------------------------- ====<<<< Methods >>>>==== ◈   getValue (field_name)：获取字段值。 ◈   isNull (field_name)：字段值是否为空。 ◈   setNull (field_name)：将字段值设置为空。 ◈   setValue (field_name)：设置字段值。
04	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, #, #)>]>
05	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]
06	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：几何类型：面、折线、点、多点、多面体、尺寸或注记。
07	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'>
08	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
-	----		--------------------------------------------------