arcpy.mapping常用四大件-MapDocument

arcpy.mapping常用四大件-MapDocument

by 李远祥

点开arcpy.mapping的帮助，可以看到其有限的几个类，看起来东西不是很多，但却是非常的使用。由于arcpy定位就是粗粒度的调用，因此，它的类和接口结对不可能像AO那么多，但可别小看了arcpy.mapping的这聊聊无几的类，它几乎封装了ArcMap的所有地图交互操作。下图是arcpy.mapping的类

其中包含了最为常用的几个大类，笔者认为最常用的主要入口的四类分别为MapDocument 、MapsurroundElement 、Layer 、StyleItem 。通过这四个大类作为入口，基本上将地图的几类型操作涵盖在其中。

首先最常用的是MapDocument ，它几乎是获取地图文档内容的第一道入口。通过MapDocument ，能够指向特定路径的mxd文档，继而逐步获取其他的地图文档信息，如框架、图层、数据源、地图整饰要素等。下面可以看看它的一些主要的属性和方法（详细部分可以参考Esri官方帮助，不过对于arcpy.mapping部分还是以英文为主）

MapDocument 的调用方式如下

#使用MapDocument的方式
import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")

再来看看MapDocument最常见的属性activeDataFrame、activeView、author、credits、description、filePath、relativePaths、tags、title 。从这些常见的属性来看，主要是地图文档的一些基本信息，如活动框架、保存路径、存储为相对路径等；而某一些说明，如标签、标题、作者等基本上用途不大，但一般会在地图发布或者arcgis portal 使用的时候需要附加的一些信息。这些属性稍微懂点英文应该都能明白其作用。

然后就是最常用的几个方法，而且也是非常的实用。其方法主要是

• 创建或者删除文档的缩略图（makeThumbnail 、deleteThumbnail），对于一般用户来说意义不大；
• 替换地图文档的数据findAndReplaceWorkspacePaths 和replaceWorkspaces
• 保存地图文档修改 save （保存修改设置）、saveACopy（将文档另存为arcgis的其他低版本）

前面也说过，如果有大量的使用高版本arcgis软件生成的mxd文档，需要保存为较低版本时，那就不需要逐个打开了，采用arcpy.mapping的MapDocument的saveACopy方法，可以很快的实现批量转换。当然，这需要配合Python的一些读写代码，例如下面的实例代码，将某个目录下的所有mxd文档另存为较低版本的10.0版本（笔者一般都是使用最新版本的arcgis软件，有时候成果分发总是比较麻烦，大家也不妨尝试下下面的这种方式）

#将C:\Mxds 路径下的所有mxd文档另存为10.0版本
import glob
import os
import arcpy
for filename in glob.glob(r'C:\\Mxds\*.mxd'):
    fname = os.path.basename(filename)
    mxd = arcpy.mapping.MapDocument(filename)
    fpath = "C:\\Mxds\\100\\"+fname
    mxd.saveACopy(fpath,"10.0")

通过简单的代码便可实现快速转换。

当然，还有就是更改mxd的数据源的操作，这里同样简单，我们也可以看到其findAndReplaceWorkspacePaths 的方法，下面是通过arcpy代码去修改地图文档的数据源

#coding=gbk
#修改数据源
#
import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\PythonTest\changeSource.mxd")
mxd.findAndReplaceWorkspacePaths(r"C:\PythonTest\data\Python.gdb",r"C:\PythonTest\changeSource.gdb","FILEGDB_WORKSPACE")
#另存为一个新的mxd
mxd.saveACopy(r"C:\PythonTest\changeSource2.mxd")

总体上说，MapDocument类提供的功能还是比较直接，作为入口类型的类，基本上通过简单的一两个方法就实现了一些以往通过打开地图来实现的功能。同时，一些基础的信息，如图层信息，也必须通过MapDocument 然后转到DataFrame 再获取图层的指向

#通过MapDocument获取dataframe，从而获取每一个图层
import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "图层")[0]
inLayer=arcpy.mapping.ListLayers(mxd, "", df)
for layer in inLayer:
    #打印图层名称
    print layer.name

 一旦能获取到图层的信息，那么，就能使用Layer类对地图的配置进行各种操作了。