本节书摘来自异步社区《基于ArcGIS的Python编程秘笈(第2版)》一书中的第2章,第2.4节,作者: 【美】Eric Pimpler(派普勒) 更多章节内容可以访问云栖社区“异步社区”公众号查看。
2.4 获取地图文档中的图层列表
大多数情况下,获取地图文档中的图层列表是地理处理脚本中的首要工作之一。获取图层列表后,脚本可以循环遍历每个图层并执行某些类型的处理。制图模块中的ListLayers()函数提供获取图层列表的功能。本节将介绍如何获取地图文档中的图层列表。
2.4.1 准备工作
arcpy.mapping模块包含各种列表函数,使用列表函数可以返回图层、数据框、丢失的数据源、表视图和布局元素等对象的列表。在多步骤的处理过程中,通常先使用列表函数返回Python列表,从返回的列表中获取一项或多项元素来做进一步地处理。每个列表函数可返回一个Python列表,Python列表在第1章中介绍过,它是一种用于存储信息的功能非常强大的数据结构。
在多步骤的处理过程中,第1步通常是用列表函数创建列表。脚本随后的处理过程会迭代访问列表中的一项或多项元素。例如,可以先获取地图文档中的图层列表,然后迭代访问每个图层,找到指定名称的图层后,就可以进行进一步的地理处理。
本节将介绍如何从地图文档中获取图层列表。
2.4.2 操作方法
下面按步骤介绍如何获取地图文档中的图层列表。
(1)在ArcMap中打开C:ArcpyBookCh2Crime_Ch2.mxd。
(2)单击ArcMap“标准”工具条上的“Python”按钮。
(3)导入arcpy.mapping模块。
import arcpy.mapping as mapping
(4)引用当前活动的地图文档(Crime_Ch2.mxd),把该引用赋值给变量。
mxd = mapping.MapDocument("CURRENT")
(5)调用ListLayers()函数,传入对地图文档的引用作为参数。
layers = mapping.ListLayers(mxd)
(6)使用for循环,输出地图文档中每个图层的名称。
for lyr in layers:
print(lyr.name)
(7)运行脚本得到如下输出结果(可以通过查看 C:ArcpyBookcodeCh2GetListLayers.py解决方案文件来检查代码)。
Burglaries in 2009
Crime Density by School District
Bexar County Boundary
Test Performance by School District
Bexar County Boundary
Bexar County Boundary
Texas Counties
School_Districts
Crime Surface
Bexar County Boundary
2.4.3 工作原理
ListLayers()函数用来检索地图文档、数据框或图层文件中的图层列表。在本节中,把对当前地图文档的引用作为参数传递给ListLayers()函数,该函数检索地图文档中所有图层的列表。检索结果存储在名为layers的变量中,layers变量是一个Python列表,Python列表中包含一个或多个图层对象,可以用for循环进行迭代。
2.4.4 拓展
ListLayers()函数是 arcpy.mapping 模块提供的列表函数之一。每种列表函数都返回一个包含某种数据类型的Python列表。例如:ListTableViews()函数返回Table对象列表;ListDataFrames()函数返回 DataFrame 对象列表;ListBookmarks()函数返回地图文档中的书签列表。本书后面的章节会介绍一些其他的列表函数。