简介《Arcgis按图斑批量出图按卫片图斑批量出图》是一份面向GIS制图、国土调查与卫片核查从业者的实操型文档重点解决大量图斑逐一手工导出效率低、易出错的问题。资源包共1个doc文件约29KB以图文说明配合脚本示例的方式组织适合已具备ArcMap基础、希望掌握自动化出图流程的初中级用户。文档围绕数据驱动页面展开涵盖图层与名称字段设置、排序和显示范围配置、布局动态文本引用图斑属性以及借助arcpy遍历页面并导出JPG/PNG的核心脚本同时提示ArcGIS 10.2以上环境与文本编辑器执行脚本等前提。读者可据此搭建按卫片图斑批量输出图片的流程理解页面切换、页名获取和导出参数调整思路并迁移到同类批量制图任务。已有8302人学习可作为批量出图入门的参考材料。1. 按图斑批量出图一张图斑一张 JPG手点三十次不如让脚本跑一遍卫片图斑下来是一批几十上百个面验收要的却是每个图斑一张 JPG图上还得带村名、面积、图斑类型。在 ArcMap 里开数据驱动页面、点下一条、导出、再改文件名重复五十遍这套流程我在不同团队见过不同的人各写一遍每次都能漏掉几张。Arcgis 按图斑批量出图这件事的本质其实就是把「切页面 导出 命名」三件事交给一个 for 循环人只负责把索引图层和布局配对。这个项目干的就是这个ArcGIS 10 以上数据驱动页面负责切图斑一段 arcpy 脚本负责遍历和落盘跑完直接拿到一批按图斑号命名的 PNG 或 JPG。适合做国土、林业、水利这类要交图斑成果的内业人员也适合手里有一堆面要素、需要一要素一张图的开发。2. 技术底盘拆解数据驱动页面加 arcpy.mapping 这套组合怎么打2.1 为什么卡在 ArcGIS 10Data Driven Pages 是版本分水岭这个项目的第一条硬约束写在最前面——ArcGIS 10 以上9 不行。原因不是玄学是数据驱动页面Data Driven Pages这个功能本身就是 10.0 才进 ArcMap 的9.x 时代要做批量出图只能靠 ArcObjects 写 COM 组件或者在 VBA 里循环门槛完全不是一个量级。所以选型上没什么可纠结的手上有 10.x 就用手上的没必要为了一个出图需求去折腾 ArcObjects。第二个隐性约束是 Python 版本。ArcGIS 10.2 自带的是 Python 2.7脚本里的import arcpy只有走这个解释器才能成功print mapName这种不带括号的写法也是 Python 2 的语法。很多人在自己电脑上装了 Python 3然后双击 .py 文件看到一闪而过的黑框就以为是代码错了——其实是解释器根本没找对。这条我在第 5 章会单独展开。第三个约束是数据驱动页面的驱动机制。它不认「文件夹里有多少个 shp」只认「索引图层里有多少行要素」。也就是说一个图斑一行、一行对应一张图这个一一映射关系必须提前在属性表里成立。如果你的图斑层是一个多部件要素、或者几十个图斑合并成了一行那出来的就是一张图无论脚本怎么改都变不出来。把这三条约束捋清楚后面的架构就顺了索引图层提供「页」mxd 布局提供「版式」arcpy 提供「循环和导出」。三者之间的耦合点只有一个——mxd.dataDrivenPages这个对象。2.2 出图链路的三个角色索引图层、mxd 布局、导出函数把整条链路摊开看其实就三个角色在配合。索引图层决定了「出多少张、每张叫什么、每张看哪里」。它必须是一个面要素类也可以是要素图层一行对应一个图斑里面至少要有三个字段一个唯一标识图斑号、一个用于排序的字段可以是图斑号本身也可以是面积降序、以及若干想印在图上的属性村名、面积、类型。这个图层不一定要和你要展示的所有图层放在一起它只负责「定位」。mxd 布局决定了「每张图长什么样」。页面大小、图框位置、图例、比例尺、指北针、动态文本、公司/项目抬头全部在这一层定死。数据驱动页面开启之后布局里的每个元素都会跟着当前页面重绘。这一步是纯手工活也是整个流程里最需要审美和耐心的地方。导出函数决定了「每张图以什么格式、多大、多清晰落盘」。arcpy.mapping.ExportToPNG、ExportToJPEG、ExportToPDF这一族函数参数签名基本一致换格式只需要换函数名。三者串起来的关系可以用一张表说清楚角色对应对象决定什么改错后的典型现象索引图层面要素类 属性表页面数量、页名、排序、定位范围张数不对、名字重复、图上没东西mxd 布局.mxd 文件 Data Driven Pages 配置版式、比例尺、动态文本图糊、文字串位、范围偏移导出函数arcpy.mapping.ExportToXXX格式、分辨率、质量图片模糊、文件过大、编码异常常见的误区是把这三个角色混在一起想有人一上来就写脚本结果发现脚本跑得挺顺但导出来的图全是同一个范围——因为数据驱动页面压根没启用currentPageID赋值无效每次都导出第一页。所以正确的顺序永远是先配图层、再配布局、最后写脚本。倒过来做排查成本翻倍。2.3 工程目录与字段约定动手前先把规矩定死我个人的习惯是脚本开跑之前先把目录和字段定死不要边跑边改。目录结构大概是这个样子F:\GeoData\Tuban\ ├── TubanExport.mxd # 配好数据驱动页面的地图文档 ├── data\ │ ├── tuban_index.shp # 索引图层一个图斑一行 │ ├── tuban_boundary.shp # 行政区界 │ └── imagery.tif # 影像底图 └── out\ # 导出目录脚本自动创建输出目录单独放不要和源数据混在一起。原因很简单脚本跑第二遍的时候你需要一眼看出哪些是新生成的混在源数据里就得靠文件时间戳去猜。字段命名上尽量不要用中文别名。ArcMap 里显示中文别名没问题但脚本里getValue()拿的是字段名不是别名一旦两者不一致很容易出现「明明有值却拿到 None」。我把索引用到的字段统一按这个规矩来TBH图斑号文本型唯一作为页面名称字段CUN所属村文本型动态文本里用MJ面积双精度动态文本里用需要格式化LX图斑类型文本型TBH一定要唯一。这不是建议是硬要求——数据驱动页面允许重复但脚本用图斑号拼文件名的时候会直接覆盖最后你就少了好几张图而且没有任何报错提示。还有一个容易被忽略的点坐标系。索引图层和 mxd 的坐标系必须一致否则设置显示范围时会偏移几百米导出来的图斑跑到画框外面去。检查方法很简单在 ArcMap 的图层属性里看一眼数据源坐标系和地图框的坐标系对一下就行。3. 从零跑通数据驱动页面配置与动态文本的完整操作3.1 索引图层字段检查pageNameField 到底绑的是哪一列打开 ArcMap把索引图层加载进去第一件事是右键打开属性表确认三件事行数是不是等于图斑数、TBH有没有重复值、有没有空值。查重复最省事的办法是字段计算器里跑一下 Python或者直接导到表格软件里排序看。我一般会在属性表里加一个临时字段# 在字段计算器的 Python 解析器里作用于新加的 check 字段 # 逻辑把当前行的 TBH 和整列的计数比一下 !TBH! _ str(sum(1 for v in !TBH!))这种写法在字段计算器里其实跑不通更靠谱的是把属性表导出成 CSV用一段独立脚本查# -*- coding: utf-8 -*- # 检查索引图层里 pageNameField 指定的字段是否唯一 import arcpy from collections import Counter INDEX rF:\GeoData\Tuban\data\tuban_index.shp FIELD TBH vals [r[0] for r in arcpy.da.SearchCursor(INDEX, [FIELD])] cnt Counter(vals) print(u总行数: %d % len(vals)) print(u空值数: %d % sum(1 for v in vals if v in (None, ))) for v, c in cnt.items(): if c 1: print(u重复: %s 出现 %d 次 % (v, c))arcpy.da.SearchCursor是 10.1 之后引入的游标接口比老的arcpy.SearchCursor快不少也更好读。r[0]取的是字段列表里第一个字段的值Counter直接统计出现频次重复项一眼就能看出来。这段脚本我一般会在正式出图前跑一遍两秒钟的事能省掉后面一堆排查。pageNameField绑的就是这个TBH字段。在数据驱动页面设置里选它之后ArcMap 会把每一行的值当作页面的「页名」——这个名字只用于标识和动态文本不会自动变成文件名文件名还是脚本自己拼的这一点别搞混。3.2 Data Driven Pages 工具条的六项设置逐项过在 ArcMap 顶部菜单里找Customize → Toolbars → Data Driven Pages把工具条调出来点第一个按钮Setup会弹出一个设置窗口。窗口里的东西不多但每一项都影响最终结果。第一项图层Layer。这里选索引图层也就是刚才那个tuban_index.shp。选错成影像或者行政区界后面的页数和范围全错。第二项名称字段Name Field。选TBH。这个字段同时用于页面标识和动态文本DDP标签。第三项排序字段Sort Field。我一般选TBH升序这样导出来的文件按图斑号自然有序交付的时候看着舒服。如果业务上要求按面积从大到小出就选MJ降序此时页面顺序和文件名顺序就不一致了心里要有数。第四项显示范围Extent。这里有三个选项差别很大Best Fit最佳适配每个图斑自动缩放图斑小的放大、图斑大的缩小。Center and Maintain Scale中心并保持比例尺所有图只按中心点移动比例尺统一。Data Driven Scale数据驱动比例尺比例尺从索引图层的某个字段读。交成果图一般用第一种或者第二种。用第一种的好处是每个图斑都占满画框缺点是不同图之间比例尺不一致多个图斑拼在一起看会失真用第二种好处是横向可比缺点是面积差异大的图斑小的那张可能只有指甲盖大。我通常选第一种然后在布局里放一个动态比例尺文本让读图的人自己知道当前比例。第五项边距Margin。给显示范围留一圈余量通常设 5% 到 10%。设 0 的话图斑会紧贴画框边缘很难看。第六项比例尺Scale。这一项只在选「中心并保持比例尺」时生效填一个固定分母比如 5000。设置完之后工具条上的翻页按钮就能用了点一下翻一页ArcMap 视图会跟着跳到对应图斑。这一步是验证配置有没有生效最直接的办法——如果点了没反应说明索引图层或者名称字段选错了。3.3 布局里的动态文本把村名、面积、图斑类型印在图上切到布局视图Layout View从菜单Insert → Dynamic Text里能看到一串可插入的动态标签常用的几个是Data Driven Page Name当前页名也就是TBH的值Data Driven Page Number当前是第几页Data Driven Page Count总共多少页Data Driven Page Attribute取索引图层里任意一个字段的值这个最有用前面三个直接插就行。第四个需要你在插入的时候选字段选CUN就是村名选MJ就是面积。插进去之后布局上显示的是一段带尖括号的标签文本比如dyn typepage propertyattribute fieldCUN/切换到下一页它会自动变成对应的值。面积的显示有个小坑MJ是双精度直接插进去可能是12345.678901234。属性表里的「数字格式」设置在布局文本里不生效得在文本属性里手动改或者在脚本里干脆不用动态文本改成出图后统一处理。我一般是在布局里把小数位设成 0 或 1够用就行。动态文本插好之后顺手把图例、指北针、比例尺、图框、项目抬头都摆好。这一步是纯手工没什么技巧但要注意图例的图层列表最好只留必要的几个影像底图、界线的图例有时候纯属占地方右键图例项删掉就行。3.4 保存 mxd 并验证页面数量配置完保存 mxd。保存路径里不要有中文和空格这个不是迷信——arcpy.mapping.MapDocument对中文路径的支持时好时坏尤其是路径里有空格和括号的时候报错信息还特别模糊。我一般会把工程放在F:\GeoData\这种纯英文路径下省掉一类问题。保存之后在 ArcMap 的 Python 窗口里跑两行验证一下import arcpy mxd arcpy.mapping.MapDocument(rF:\GeoData\Tuban\TubanExport.mxd) print mxd.dataDrivenPages.pageCount print mxd.dataDrivenPages.pageNameField.name第一行输出应该是索引图层的行数第二行应该输出TBH。这两个值对了说明 mxd 里的数据驱动页面配置是有效的脚本可以直接跑。如果pageCount报错说对象不存在那就是数据驱动页面没启用回到工具条重新点一次Setup并确认勾选启用。这一步很多人会跳过直接去写脚本然后在脚本里各种try/except猜问题。先在 ArcMap 的 Python 窗口里用两行命令确认地基没问题后面能省掉一半时间。4. 核心脚本拆解一个 for 循环把 pageCount 压成一批图片4.1 运行环境arcpy 只能跑在 ArcGIS 自带的那套 Python 里先说结论脚本用 Notepad 写没问题但执行的时候必须走 ArcGIS 自带的 Python 2.7 解释器。路径大概是C:\Python27\ArcGIS10.2\python.exe具体版本号看安装情况。Notepad 的「运行」按钮默认调用的是系统 PATH 里的 python如果 PATH 里是 Python 3就会出现ImportError: No module named arcpy或者语法错误提示print那行。有几种靠谱的跑法一是直接在 ArcMap 的 Python 窗口里粘贴执行适合调试二是用命令行C:\Python27\ArcGIS10.2\python.exe D:\export.py适合正式跑三是在 Notepad 的运行对话框里把命令写成上面那种完整路径。我的习惯是第二种。脚本跑批的时候输出信息多命令行窗口能翻历史比 Python 窗口好用。4.2 原始脚本逐行拆三行核心逻辑与一个隐蔽的漏页先看项目里给的那段基础脚本它短到只有几行但信息量不小# coding:utf-8 import arcpy mxd arcpy.mapping.MapDocument(rF:\GeoData\ChinaArea\ChinaVector.mxd) for pageNum in range(1, mxd.dataDrivenPages.pageCount): mxd.dataDrivenPages.currentPageID pageNum mapName mxd.dataDrivenPages.pageRow.getValue(mxd.dataDrivenPages.pageNameField.name) print mapName arcpy.mapping.ExportToPNG(mxd, rF:\GeoData\ChinaArea\Province\\ mapName .png) print okMapDocument把 mxd 读进内存这一步会连带加载所有图层引用。如果 mxd 里有图层的数据源已经移动或者改名这里不会立刻报错但导出的时候会得到一张缺图层的图——这是第 5 章要讲的坑之一。currentPageID pageNum是切页的核心等价于在 ArcMap 里点「下一页」。注意这个 ID 是从 1 开始的不是 0。pageRow.getValue(...)拿到的是当前页对应那一行要素的指定字段值。pageRow只有在currentPageID被赋值之后才是有效的赋值之前访问会返回None或者直接抛异常。ExportToPNG把当前布局状态整个渲染成一张图。它接受的是MapDocument对象不是数据框所以导出的是整张版面包括图例、指北针、动态文本全都进去。这里有一个隐蔽的问题range(1, pageCount)的右边界是开区间。假设pageCount 50这个循环只会跑到 49第 50 个图斑永远出不来。而且它不会报错脚本最后还会打印ok你以为全部成功了交付的时候被退回来才发现少一张。这个 bug 的翻车概率极高我在两个项目上都见过。正确写法是range(1, pageCount 1)。另外mapName从字段读出来的类型不一定是字符串。如果TBH是数值型字段getValue返回的是int或float和字符串直接拼接会抛TypeError。所以拼接之前必须str()一下。4.3 改进版脚本加文件名清洗、日志和异常捕获基于上面几个问题我在实际项目里用的版本会长一些但稳得多# -*- coding: utf-8 -*- import arcpy import os import re import traceback MXD_PATH uF:\\GeoData\\Tuban\\TubanExport.mxd OUT_DIR uF:\\GeoData\\Tuban\\out PREFIX u卫片图斑_ DPI 200 # 导出分辨率默认 96 太糊 QUALITY 85 # JPG 质量1-100 def safe_name(v): 把字段值洗成合法文件名去非法字符、去空值 s u%s % v # 统一转 unicode防数值型字段 s re.sub(ur[\\/:*?|], u_, s) s s.strip().replace(u , u) return s or uunnamed def main(): if not os.path.isdir(OUT_DIR): os.makedirs(OUT_DIR) # 输出目录不存在就建 mxd arcpy.mapping.MapDocument(MXD_PATH) ddp mxd.dataDrivenPages total ddp.pageCount # 必须先取出来循环里反复取会慢 field ddp.pageNameField.name print(upageCount %d, nameField %s % (total, field)) for i in range(1, total 1): # 右边界 1否则漏最后一页 ddp.currentPageID i raw ddp.pageRow.getValue(field) name safe_name(raw) out os.path.join(OUT_DIR, PREFIX name u.jpg) if os.path.exists(out): # 同名不覆盖加序号 out os.path.join(OUT_DIR, PREFIX name u_%d.jpg % i) arcpy.mapping.ExportToJPEG( mxd, out, resolutionDPI, image_qualityQUALITY ) print(u[%d/%d] %s % (i, total, out)) del mxd # 释放文件锁否则下次打不开 print(uall done) if __name__ __main__: try: main() except Exception: traceback.print_exc() # 把完整堆栈打出来别只 print esafe_name处理的是文件名合法性。Windows 文件名不能包含\ / : * ? |这九个字符而图斑号里带斜杠、带括号的情况非常常见比如2023-01/A区这种。不洗直接拼ExportToJPEG会抛 IO 错误而且报错信息只说路径无效看不出是哪个图斑的问题。os.path.join比字符串拼接更稳它会自动处理路径分隔符也不会因为多一个斜杠出问题。但要注意Python 2 里os.path.join的各个参数编码必须一致OUT_DIR是 unicodename也必须是 unicode混着 bytes 会抛UnicodeDecodeError。这就是safe_name里第一步就u%s % v的原因。os.path.exists那段是给重复跑准备的。加了_%d后缀之后同名文件不会互相覆盖跑三遍能拿到三批文件对比着看很方便。不加这段的话第二遍跑会静默覆盖第一遍的成果等发现的时候已经晚了。del mxd这一行看着无关紧要其实挺关键。MapDocument对象不释放mxd 文件会一直被进程持有下一次 ArcMap 打开或者脚本再跑可能报「文件被占用」。4.4 导出参数分辨率、像素尺寸与格式选择ExportToJPEG和ExportToPNG的参数签名基本一致常用的几个列在下表参数含义常用值说明map_document要导出的 mxd 对象必填传对象不传路径out_file输出文件完整路径必填目录必须已存在data_frame指定数据框省略单数据框可省略取第一个df_export_width输出宽度页面单位省略和 height 同时给才生效df_export_height输出高度页面单位省略与宽度成比例缩放resolution分辨率 DPI200 / 300不给默认 96图会糊image_qualityJPG 压缩质量80–90只对 JPEG 有效world_file是否生成坐标辅助文件False需要配准时才开分辨率是这里面最值得调的一项。默认 96 DPI 是屏幕分辨率导出来的 A4 图只有 794×1123 像素左右打印出来一塌糊涂。设成 200 或 300像素量翻几倍文件大小也跟着涨但交付质量够看。我一般用 200A3 幅面下大概 2300×1600 像素几十个图斑一共几百兆U 盘能扛住。格式上PNG 无损、体积大适合图面有大量细线和小字的情况JPG 有损、体积小适合底图是影像的情况。卫片图斑的底图通常是影像JPG 更合适压缩痕迹在影像上不明显。项目原文里两种格式都提到了ExportToPNG换ExportToJPEG只需要改函数名其他参数不变。还有一个细节如果同时给了df_export_width和resolution最终像素是页面物理尺寸乘以 DPIdf_export_width反而可能被忽略。所以要么只调resolution要么只调df_export_width/height两个一起给容易得到意料之外的尺寸。5. 避坑与排查五个把批量出图卡死的现场5.1 现象脚本打印 ok但交付时少了一张图原因range(1, pageCount)是左闭右开区间最后一个页面 ID 没被遍历到。这是这套脚本里最经典的 bug而且它不报错、不告警脚本还会正常打印结束语。解决改成range(1, pageCount 1)。改完之后建议加一行自检把实际导出的文件数和pageCount对比一下import glob, os n len(glob.glob(os.path.join(OUT_DIR, u*.jpg))) print(uexpected%d, actual%d % (total, n))两个数不相等就别交付先查是不是有文件被同名覆盖了。5.2 现象中文图斑号导出的文件名是乱码或者直接抛 UnicodeDecodeError原因Python 2 里字符串有str字节和unicode两种。pageRow.getValue()返回的通常是 unicode而用rF:\...这种原始字符串写的路径是 str。两者用或者os.path.join拼接时Python 会尝试把 str 按 ASCII 解码成 unicode一旦路径里有中文就炸。解决路径字面量统一加u前缀写成 unicode比如uF:\\GeoData\\out字段值拼接前先u%s % v强制转 unicode脚本头部保留# -*- coding: utf-8 -*-并确保文件本身以 UTF-8 无 BOM 保存。Notepad 里在「编码」菜单选「UTF-8 无 BOM 编码」别选带 BOM 的那个带 BOM 会让 Python 2 在文件开头报语法错误。5.3 现象双击 py 文件闪退或者提示 No module named arcpy原因系统默认关联的 Python 不是 ArcGIS 自带的那套。ArcGIS 10.2 的 arcpy 只装在 Python 2.7 的ArcGIS10.2子目录下系统里另外装的 Python 3 完全看不到它。解决不要双击。用命令行显式指定解释器C:\Python27\ArcGIS10.2\python.exe D:\export.py。如果想省事写一个.bat文件放在脚本旁边里面就这一行。另外 Notepad 的运行对话框里也要写完整路径别写python export.py。判断当前解释器对不对跑一句import sys; print sys.version看到 2.7 就对了。5.4 现象图导出来了但字和线糊成一团打印看不清原因没有传resolution参数用了默认的 96 DPI。屏幕上看还行一比一打印就露馅。解决加resolution200或300。同时检查一下布局的页面尺寸有没有设对——页面设成 A4导出再怎么调分辨率也就那么大要出 A3 就提前把页面改成 A3。还有一点如果图上用了半透明填充或者羽化效果低分辨率下会格外难看这种情况直接上 300。5.5 现象脚本跑到一半报打开地图文档失败或者导出的是空白图原因两种可能。一是同一个 mxd 正在 ArcMap 里开着文件被独占锁住二是 mxd 里的图层数据源已经移动脚本能读到文档结构但渲染时找不到数据导出来就是空版面。解决跑批之前先关掉 ArcMap。数据源的问题在 ArcMap 里打开 mxd 看图层上有没有红色感叹号有的话右键Data → Repair Data Source重新指一下。修完保存再用脚本的mxd.listLayers()打印一遍图层列表确认每个图层的dataSource路径都真实存在for lyr in arcpy.mapping.ListLayers(mxd): if lyr.supports(DATASOURCE): print lyr.name, lyr.dataSource这一步花不到一分钟能挡掉一大半「导出来是白图」的问题。6. 二次开发把这套脚本改成别人也能用的出图工具单个项目跑通之后真正花时间的是把它交给下一个项目的人用。我的做法是把三样东西从代码里抽出来mxd 路径、输出目录、文件名前缀全部改成命令行参数或者配置文件。用argparse不太合适Python 2.7 支持但 ArcGIS 环境里写起来啰嗦我一般用一个同目录的config.py把路径常量集中放脚本import config。这样换项目只改一个文件主脚本一行不动。第二个改造点是「从清单表驱动」。数据驱动页面是按图斑层全部出行但实际交付经常只要其中一部分——比如只出面积大于某个阈值的、或者只出某个村范围内的。与其在 ArcMap 里反复筛选图层不如加一个筛选字段脚本里用SearchCursor先把要出的图斑号读成一个集合循环里判断当前页名在不在集合里不在就continue。这段逻辑加进去不到十行但把「改需求就要重配 mxd」变成了「改一张表」。第三个改造点是输出组织。图斑多的时候几百张 JPG 堆在一个文件夹里没法看我按村名建子目录OUT_DIR/CUN/TBH.jpg交付的时候对方按村找图体验完全不一样。目录名同样要走一遍safe_name不然村名里带个括号就建不出来。验证方法我固定用两条一是导出数量对得上索引图层行数过滤后按过滤后的数对二是随机抽三张图打开看动态文本里的图斑号和文件名是否一致。第二条尤其重要因为文件名和图上内容对不上这种错只有靠眼睛看才能发现脚本再怎么写都验不出来。说到底这套东西的技术含量不高难的是那些不写在文档里的细节——右边界要不要加一、路径要不要转 unicode、默认分辨率是多少。我第一版脚本就是因为range少了个1少交了七张图被退回来重做。从那以后我每次写完批量脚本都强制走一遍「打印总数 → 统计实际文件数 → 随机抽三张肉眼核对」这套流程哪怕项目再小也不跳。希望帮到你。本文还有配套的精品资源点击获取
简介《Arcgis按图斑批量出图按卫片图斑批量出图》是一份面向GIS制图、国土调查与卫片核查从业者的实操型文档重点解决大量图斑逐一手工导出效率低、易出错的问题。资源包共1个doc文件约29KB以图文说明配合脚本示例的方式组织适合已具备ArcMap基础、希望掌握自动化出图流程的初中级用户。文档围绕数据驱动页面展开涵盖图层与名称字段设置、排序和显示范围配置、布局动态文本引用图斑属性以及借助arcpy遍历页面并导出JPG/PNG的核心脚本同时提示ArcGIS 10.2以上环境与文本编辑器执行脚本等前提。读者可据此搭建按卫片图斑批量输出图片的流程理解页面切换、页名获取和导出参数调整思路并迁移到同类批量制图任务。已有8302人学习可作为批量出图入门的参考材料。1. 按图斑批量出图一张图斑一张 JPG手点三十次不如让脚本跑一遍卫片图斑下来是一批几十上百个面验收要的却是每个图斑一张 JPG图上还得带村名、面积、图斑类型。在 ArcMap 里开数据驱动页面、点下一条、导出、再改文件名重复五十遍这套流程我在不同团队见过不同的人各写一遍每次都能漏掉几张。Arcgis 按图斑批量出图这件事的本质其实就是把「切页面 导出 命名」三件事交给一个 for 循环人只负责把索引图层和布局配对。这个项目干的就是这个ArcGIS 10 以上数据驱动页面负责切图斑一段 arcpy 脚本负责遍历和落盘跑完直接拿到一批按图斑号命名的 PNG 或 JPG。适合做国土、林业、水利这类要交图斑成果的内业人员也适合手里有一堆面要素、需要一要素一张图的开发。2. 技术底盘拆解数据驱动页面加 arcpy.mapping 这套组合怎么打2.1 为什么卡在 ArcGIS 10Data Driven Pages 是版本分水岭这个项目的第一条硬约束写在最前面——ArcGIS 10 以上9 不行。原因不是玄学是数据驱动页面Data Driven Pages这个功能本身就是 10.0 才进 ArcMap 的9.x 时代要做批量出图只能靠 ArcObjects 写 COM 组件或者在 VBA 里循环门槛完全不是一个量级。所以选型上没什么可纠结的手上有 10.x 就用手上的没必要为了一个出图需求去折腾 ArcObjects。第二个隐性约束是 Python 版本。ArcGIS 10.2 自带的是 Python 2.7脚本里的import arcpy只有走这个解释器才能成功print mapName这种不带括号的写法也是 Python 2 的语法。很多人在自己电脑上装了 Python 3然后双击 .py 文件看到一闪而过的黑框就以为是代码错了——其实是解释器根本没找对。这条我在第 5 章会单独展开。第三个约束是数据驱动页面的驱动机制。它不认「文件夹里有多少个 shp」只认「索引图层里有多少行要素」。也就是说一个图斑一行、一行对应一张图这个一一映射关系必须提前在属性表里成立。如果你的图斑层是一个多部件要素、或者几十个图斑合并成了一行那出来的就是一张图无论脚本怎么改都变不出来。把这三条约束捋清楚后面的架构就顺了索引图层提供「页」mxd 布局提供「版式」arcpy 提供「循环和导出」。三者之间的耦合点只有一个——mxd.dataDrivenPages这个对象。2.2 出图链路的三个角色索引图层、mxd 布局、导出函数把整条链路摊开看其实就三个角色在配合。索引图层决定了「出多少张、每张叫什么、每张看哪里」。它必须是一个面要素类也可以是要素图层一行对应一个图斑里面至少要有三个字段一个唯一标识图斑号、一个用于排序的字段可以是图斑号本身也可以是面积降序、以及若干想印在图上的属性村名、面积、类型。这个图层不一定要和你要展示的所有图层放在一起它只负责「定位」。mxd 布局决定了「每张图长什么样」。页面大小、图框位置、图例、比例尺、指北针、动态文本、公司/项目抬头全部在这一层定死。数据驱动页面开启之后布局里的每个元素都会跟着当前页面重绘。这一步是纯手工活也是整个流程里最需要审美和耐心的地方。导出函数决定了「每张图以什么格式、多大、多清晰落盘」。arcpy.mapping.ExportToPNG、ExportToJPEG、ExportToPDF这一族函数参数签名基本一致换格式只需要换函数名。三者串起来的关系可以用一张表说清楚角色对应对象决定什么改错后的典型现象索引图层面要素类 属性表页面数量、页名、排序、定位范围张数不对、名字重复、图上没东西mxd 布局.mxd 文件 Data Driven Pages 配置版式、比例尺、动态文本图糊、文字串位、范围偏移导出函数arcpy.mapping.ExportToXXX格式、分辨率、质量图片模糊、文件过大、编码异常常见的误区是把这三个角色混在一起想有人一上来就写脚本结果发现脚本跑得挺顺但导出来的图全是同一个范围——因为数据驱动页面压根没启用currentPageID赋值无效每次都导出第一页。所以正确的顺序永远是先配图层、再配布局、最后写脚本。倒过来做排查成本翻倍。2.3 工程目录与字段约定动手前先把规矩定死我个人的习惯是脚本开跑之前先把目录和字段定死不要边跑边改。目录结构大概是这个样子F:\GeoData\Tuban\ ├── TubanExport.mxd # 配好数据驱动页面的地图文档 ├── data\ │ ├── tuban_index.shp # 索引图层一个图斑一行 │ ├── tuban_boundary.shp # 行政区界 │ └── imagery.tif # 影像底图 └── out\ # 导出目录脚本自动创建输出目录单独放不要和源数据混在一起。原因很简单脚本跑第二遍的时候你需要一眼看出哪些是新生成的混在源数据里就得靠文件时间戳去猜。字段命名上尽量不要用中文别名。ArcMap 里显示中文别名没问题但脚本里getValue()拿的是字段名不是别名一旦两者不一致很容易出现「明明有值却拿到 None」。我把索引用到的字段统一按这个规矩来TBH图斑号文本型唯一作为页面名称字段CUN所属村文本型动态文本里用MJ面积双精度动态文本里用需要格式化LX图斑类型文本型TBH一定要唯一。这不是建议是硬要求——数据驱动页面允许重复但脚本用图斑号拼文件名的时候会直接覆盖最后你就少了好几张图而且没有任何报错提示。还有一个容易被忽略的点坐标系。索引图层和 mxd 的坐标系必须一致否则设置显示范围时会偏移几百米导出来的图斑跑到画框外面去。检查方法很简单在 ArcMap 的图层属性里看一眼数据源坐标系和地图框的坐标系对一下就行。3. 从零跑通数据驱动页面配置与动态文本的完整操作3.1 索引图层字段检查pageNameField 到底绑的是哪一列打开 ArcMap把索引图层加载进去第一件事是右键打开属性表确认三件事行数是不是等于图斑数、TBH有没有重复值、有没有空值。查重复最省事的办法是字段计算器里跑一下 Python或者直接导到表格软件里排序看。我一般会在属性表里加一个临时字段# 在字段计算器的 Python 解析器里作用于新加的 check 字段 # 逻辑把当前行的 TBH 和整列的计数比一下 !TBH! _ str(sum(1 for v in !TBH!))这种写法在字段计算器里其实跑不通更靠谱的是把属性表导出成 CSV用一段独立脚本查# -*- coding: utf-8 -*- # 检查索引图层里 pageNameField 指定的字段是否唯一 import arcpy from collections import Counter INDEX rF:\GeoData\Tuban\data\tuban_index.shp FIELD TBH vals [r[0] for r in arcpy.da.SearchCursor(INDEX, [FIELD])] cnt Counter(vals) print(u总行数: %d % len(vals)) print(u空值数: %d % sum(1 for v in vals if v in (None, ))) for v, c in cnt.items(): if c 1: print(u重复: %s 出现 %d 次 % (v, c))arcpy.da.SearchCursor是 10.1 之后引入的游标接口比老的arcpy.SearchCursor快不少也更好读。r[0]取的是字段列表里第一个字段的值Counter直接统计出现频次重复项一眼就能看出来。这段脚本我一般会在正式出图前跑一遍两秒钟的事能省掉后面一堆排查。pageNameField绑的就是这个TBH字段。在数据驱动页面设置里选它之后ArcMap 会把每一行的值当作页面的「页名」——这个名字只用于标识和动态文本不会自动变成文件名文件名还是脚本自己拼的这一点别搞混。3.2 Data Driven Pages 工具条的六项设置逐项过在 ArcMap 顶部菜单里找Customize → Toolbars → Data Driven Pages把工具条调出来点第一个按钮Setup会弹出一个设置窗口。窗口里的东西不多但每一项都影响最终结果。第一项图层Layer。这里选索引图层也就是刚才那个tuban_index.shp。选错成影像或者行政区界后面的页数和范围全错。第二项名称字段Name Field。选TBH。这个字段同时用于页面标识和动态文本DDP标签。第三项排序字段Sort Field。我一般选TBH升序这样导出来的文件按图斑号自然有序交付的时候看着舒服。如果业务上要求按面积从大到小出就选MJ降序此时页面顺序和文件名顺序就不一致了心里要有数。第四项显示范围Extent。这里有三个选项差别很大Best Fit最佳适配每个图斑自动缩放图斑小的放大、图斑大的缩小。Center and Maintain Scale中心并保持比例尺所有图只按中心点移动比例尺统一。Data Driven Scale数据驱动比例尺比例尺从索引图层的某个字段读。交成果图一般用第一种或者第二种。用第一种的好处是每个图斑都占满画框缺点是不同图之间比例尺不一致多个图斑拼在一起看会失真用第二种好处是横向可比缺点是面积差异大的图斑小的那张可能只有指甲盖大。我通常选第一种然后在布局里放一个动态比例尺文本让读图的人自己知道当前比例。第五项边距Margin。给显示范围留一圈余量通常设 5% 到 10%。设 0 的话图斑会紧贴画框边缘很难看。第六项比例尺Scale。这一项只在选「中心并保持比例尺」时生效填一个固定分母比如 5000。设置完之后工具条上的翻页按钮就能用了点一下翻一页ArcMap 视图会跟着跳到对应图斑。这一步是验证配置有没有生效最直接的办法——如果点了没反应说明索引图层或者名称字段选错了。3.3 布局里的动态文本把村名、面积、图斑类型印在图上切到布局视图Layout View从菜单Insert → Dynamic Text里能看到一串可插入的动态标签常用的几个是Data Driven Page Name当前页名也就是TBH的值Data Driven Page Number当前是第几页Data Driven Page Count总共多少页Data Driven Page Attribute取索引图层里任意一个字段的值这个最有用前面三个直接插就行。第四个需要你在插入的时候选字段选CUN就是村名选MJ就是面积。插进去之后布局上显示的是一段带尖括号的标签文本比如dyn typepage propertyattribute fieldCUN/切换到下一页它会自动变成对应的值。面积的显示有个小坑MJ是双精度直接插进去可能是12345.678901234。属性表里的「数字格式」设置在布局文本里不生效得在文本属性里手动改或者在脚本里干脆不用动态文本改成出图后统一处理。我一般是在布局里把小数位设成 0 或 1够用就行。动态文本插好之后顺手把图例、指北针、比例尺、图框、项目抬头都摆好。这一步是纯手工没什么技巧但要注意图例的图层列表最好只留必要的几个影像底图、界线的图例有时候纯属占地方右键图例项删掉就行。3.4 保存 mxd 并验证页面数量配置完保存 mxd。保存路径里不要有中文和空格这个不是迷信——arcpy.mapping.MapDocument对中文路径的支持时好时坏尤其是路径里有空格和括号的时候报错信息还特别模糊。我一般会把工程放在F:\GeoData\这种纯英文路径下省掉一类问题。保存之后在 ArcMap 的 Python 窗口里跑两行验证一下import arcpy mxd arcpy.mapping.MapDocument(rF:\GeoData\Tuban\TubanExport.mxd) print mxd.dataDrivenPages.pageCount print mxd.dataDrivenPages.pageNameField.name第一行输出应该是索引图层的行数第二行应该输出TBH。这两个值对了说明 mxd 里的数据驱动页面配置是有效的脚本可以直接跑。如果pageCount报错说对象不存在那就是数据驱动页面没启用回到工具条重新点一次Setup并确认勾选启用。这一步很多人会跳过直接去写脚本然后在脚本里各种try/except猜问题。先在 ArcMap 的 Python 窗口里用两行命令确认地基没问题后面能省掉一半时间。4. 核心脚本拆解一个 for 循环把 pageCount 压成一批图片4.1 运行环境arcpy 只能跑在 ArcGIS 自带的那套 Python 里先说结论脚本用 Notepad 写没问题但执行的时候必须走 ArcGIS 自带的 Python 2.7 解释器。路径大概是C:\Python27\ArcGIS10.2\python.exe具体版本号看安装情况。Notepad 的「运行」按钮默认调用的是系统 PATH 里的 python如果 PATH 里是 Python 3就会出现ImportError: No module named arcpy或者语法错误提示print那行。有几种靠谱的跑法一是直接在 ArcMap 的 Python 窗口里粘贴执行适合调试二是用命令行C:\Python27\ArcGIS10.2\python.exe D:\export.py适合正式跑三是在 Notepad 的运行对话框里把命令写成上面那种完整路径。我的习惯是第二种。脚本跑批的时候输出信息多命令行窗口能翻历史比 Python 窗口好用。4.2 原始脚本逐行拆三行核心逻辑与一个隐蔽的漏页先看项目里给的那段基础脚本它短到只有几行但信息量不小# coding:utf-8 import arcpy mxd arcpy.mapping.MapDocument(rF:\GeoData\ChinaArea\ChinaVector.mxd) for pageNum in range(1, mxd.dataDrivenPages.pageCount): mxd.dataDrivenPages.currentPageID pageNum mapName mxd.dataDrivenPages.pageRow.getValue(mxd.dataDrivenPages.pageNameField.name) print mapName arcpy.mapping.ExportToPNG(mxd, rF:\GeoData\ChinaArea\Province\\ mapName .png) print okMapDocument把 mxd 读进内存这一步会连带加载所有图层引用。如果 mxd 里有图层的数据源已经移动或者改名这里不会立刻报错但导出的时候会得到一张缺图层的图——这是第 5 章要讲的坑之一。currentPageID pageNum是切页的核心等价于在 ArcMap 里点「下一页」。注意这个 ID 是从 1 开始的不是 0。pageRow.getValue(...)拿到的是当前页对应那一行要素的指定字段值。pageRow只有在currentPageID被赋值之后才是有效的赋值之前访问会返回None或者直接抛异常。ExportToPNG把当前布局状态整个渲染成一张图。它接受的是MapDocument对象不是数据框所以导出的是整张版面包括图例、指北针、动态文本全都进去。这里有一个隐蔽的问题range(1, pageCount)的右边界是开区间。假设pageCount 50这个循环只会跑到 49第 50 个图斑永远出不来。而且它不会报错脚本最后还会打印ok你以为全部成功了交付的时候被退回来才发现少一张。这个 bug 的翻车概率极高我在两个项目上都见过。正确写法是range(1, pageCount 1)。另外mapName从字段读出来的类型不一定是字符串。如果TBH是数值型字段getValue返回的是int或float和字符串直接拼接会抛TypeError。所以拼接之前必须str()一下。4.3 改进版脚本加文件名清洗、日志和异常捕获基于上面几个问题我在实际项目里用的版本会长一些但稳得多# -*- coding: utf-8 -*- import arcpy import os import re import traceback MXD_PATH uF:\\GeoData\\Tuban\\TubanExport.mxd OUT_DIR uF:\\GeoData\\Tuban\\out PREFIX u卫片图斑_ DPI 200 # 导出分辨率默认 96 太糊 QUALITY 85 # JPG 质量1-100 def safe_name(v): 把字段值洗成合法文件名去非法字符、去空值 s u%s % v # 统一转 unicode防数值型字段 s re.sub(ur[\\/:*?|], u_, s) s s.strip().replace(u , u) return s or uunnamed def main(): if not os.path.isdir(OUT_DIR): os.makedirs(OUT_DIR) # 输出目录不存在就建 mxd arcpy.mapping.MapDocument(MXD_PATH) ddp mxd.dataDrivenPages total ddp.pageCount # 必须先取出来循环里反复取会慢 field ddp.pageNameField.name print(upageCount %d, nameField %s % (total, field)) for i in range(1, total 1): # 右边界 1否则漏最后一页 ddp.currentPageID i raw ddp.pageRow.getValue(field) name safe_name(raw) out os.path.join(OUT_DIR, PREFIX name u.jpg) if os.path.exists(out): # 同名不覆盖加序号 out os.path.join(OUT_DIR, PREFIX name u_%d.jpg % i) arcpy.mapping.ExportToJPEG( mxd, out, resolutionDPI, image_qualityQUALITY ) print(u[%d/%d] %s % (i, total, out)) del mxd # 释放文件锁否则下次打不开 print(uall done) if __name__ __main__: try: main() except Exception: traceback.print_exc() # 把完整堆栈打出来别只 print esafe_name处理的是文件名合法性。Windows 文件名不能包含\ / : * ? |这九个字符而图斑号里带斜杠、带括号的情况非常常见比如2023-01/A区这种。不洗直接拼ExportToJPEG会抛 IO 错误而且报错信息只说路径无效看不出是哪个图斑的问题。os.path.join比字符串拼接更稳它会自动处理路径分隔符也不会因为多一个斜杠出问题。但要注意Python 2 里os.path.join的各个参数编码必须一致OUT_DIR是 unicodename也必须是 unicode混着 bytes 会抛UnicodeDecodeError。这就是safe_name里第一步就u%s % v的原因。os.path.exists那段是给重复跑准备的。加了_%d后缀之后同名文件不会互相覆盖跑三遍能拿到三批文件对比着看很方便。不加这段的话第二遍跑会静默覆盖第一遍的成果等发现的时候已经晚了。del mxd这一行看着无关紧要其实挺关键。MapDocument对象不释放mxd 文件会一直被进程持有下一次 ArcMap 打开或者脚本再跑可能报「文件被占用」。4.4 导出参数分辨率、像素尺寸与格式选择ExportToJPEG和ExportToPNG的参数签名基本一致常用的几个列在下表参数含义常用值说明map_document要导出的 mxd 对象必填传对象不传路径out_file输出文件完整路径必填目录必须已存在data_frame指定数据框省略单数据框可省略取第一个df_export_width输出宽度页面单位省略和 height 同时给才生效df_export_height输出高度页面单位省略与宽度成比例缩放resolution分辨率 DPI200 / 300不给默认 96图会糊image_qualityJPG 压缩质量80–90只对 JPEG 有效world_file是否生成坐标辅助文件False需要配准时才开分辨率是这里面最值得调的一项。默认 96 DPI 是屏幕分辨率导出来的 A4 图只有 794×1123 像素左右打印出来一塌糊涂。设成 200 或 300像素量翻几倍文件大小也跟着涨但交付质量够看。我一般用 200A3 幅面下大概 2300×1600 像素几十个图斑一共几百兆U 盘能扛住。格式上PNG 无损、体积大适合图面有大量细线和小字的情况JPG 有损、体积小适合底图是影像的情况。卫片图斑的底图通常是影像JPG 更合适压缩痕迹在影像上不明显。项目原文里两种格式都提到了ExportToPNG换ExportToJPEG只需要改函数名其他参数不变。还有一个细节如果同时给了df_export_width和resolution最终像素是页面物理尺寸乘以 DPIdf_export_width反而可能被忽略。所以要么只调resolution要么只调df_export_width/height两个一起给容易得到意料之外的尺寸。5. 避坑与排查五个把批量出图卡死的现场5.1 现象脚本打印 ok但交付时少了一张图原因range(1, pageCount)是左闭右开区间最后一个页面 ID 没被遍历到。这是这套脚本里最经典的 bug而且它不报错、不告警脚本还会正常打印结束语。解决改成range(1, pageCount 1)。改完之后建议加一行自检把实际导出的文件数和pageCount对比一下import glob, os n len(glob.glob(os.path.join(OUT_DIR, u*.jpg))) print(uexpected%d, actual%d % (total, n))两个数不相等就别交付先查是不是有文件被同名覆盖了。5.2 现象中文图斑号导出的文件名是乱码或者直接抛 UnicodeDecodeError原因Python 2 里字符串有str字节和unicode两种。pageRow.getValue()返回的通常是 unicode而用rF:\...这种原始字符串写的路径是 str。两者用或者os.path.join拼接时Python 会尝试把 str 按 ASCII 解码成 unicode一旦路径里有中文就炸。解决路径字面量统一加u前缀写成 unicode比如uF:\\GeoData\\out字段值拼接前先u%s % v强制转 unicode脚本头部保留# -*- coding: utf-8 -*-并确保文件本身以 UTF-8 无 BOM 保存。Notepad 里在「编码」菜单选「UTF-8 无 BOM 编码」别选带 BOM 的那个带 BOM 会让 Python 2 在文件开头报语法错误。5.3 现象双击 py 文件闪退或者提示 No module named arcpy原因系统默认关联的 Python 不是 ArcGIS 自带的那套。ArcGIS 10.2 的 arcpy 只装在 Python 2.7 的ArcGIS10.2子目录下系统里另外装的 Python 3 完全看不到它。解决不要双击。用命令行显式指定解释器C:\Python27\ArcGIS10.2\python.exe D:\export.py。如果想省事写一个.bat文件放在脚本旁边里面就这一行。另外 Notepad 的运行对话框里也要写完整路径别写python export.py。判断当前解释器对不对跑一句import sys; print sys.version看到 2.7 就对了。5.4 现象图导出来了但字和线糊成一团打印看不清原因没有传resolution参数用了默认的 96 DPI。屏幕上看还行一比一打印就露馅。解决加resolution200或300。同时检查一下布局的页面尺寸有没有设对——页面设成 A4导出再怎么调分辨率也就那么大要出 A3 就提前把页面改成 A3。还有一点如果图上用了半透明填充或者羽化效果低分辨率下会格外难看这种情况直接上 300。5.5 现象脚本跑到一半报打开地图文档失败或者导出的是空白图原因两种可能。一是同一个 mxd 正在 ArcMap 里开着文件被独占锁住二是 mxd 里的图层数据源已经移动脚本能读到文档结构但渲染时找不到数据导出来就是空版面。解决跑批之前先关掉 ArcMap。数据源的问题在 ArcMap 里打开 mxd 看图层上有没有红色感叹号有的话右键Data → Repair Data Source重新指一下。修完保存再用脚本的mxd.listLayers()打印一遍图层列表确认每个图层的dataSource路径都真实存在for lyr in arcpy.mapping.ListLayers(mxd): if lyr.supports(DATASOURCE): print lyr.name, lyr.dataSource这一步花不到一分钟能挡掉一大半「导出来是白图」的问题。6. 二次开发把这套脚本改成别人也能用的出图工具单个项目跑通之后真正花时间的是把它交给下一个项目的人用。我的做法是把三样东西从代码里抽出来mxd 路径、输出目录、文件名前缀全部改成命令行参数或者配置文件。用argparse不太合适Python 2.7 支持但 ArcGIS 环境里写起来啰嗦我一般用一个同目录的config.py把路径常量集中放脚本import config。这样换项目只改一个文件主脚本一行不动。第二个改造点是「从清单表驱动」。数据驱动页面是按图斑层全部出行但实际交付经常只要其中一部分——比如只出面积大于某个阈值的、或者只出某个村范围内的。与其在 ArcMap 里反复筛选图层不如加一个筛选字段脚本里用SearchCursor先把要出的图斑号读成一个集合循环里判断当前页名在不在集合里不在就continue。这段逻辑加进去不到十行但把「改需求就要重配 mxd」变成了「改一张表」。第三个改造点是输出组织。图斑多的时候几百张 JPG 堆在一个文件夹里没法看我按村名建子目录OUT_DIR/CUN/TBH.jpg交付的时候对方按村找图体验完全不一样。目录名同样要走一遍safe_name不然村名里带个括号就建不出来。验证方法我固定用两条一是导出数量对得上索引图层行数过滤后按过滤后的数对二是随机抽三张图打开看动态文本里的图斑号和文件名是否一致。第二条尤其重要因为文件名和图上内容对不上这种错只有靠眼睛看才能发现脚本再怎么写都验不出来。说到底这套东西的技术含量不高难的是那些不写在文档里的细节——右边界要不要加一、路径要不要转 unicode、默认分辨率是多少。我第一版脚本就是因为range少了个1少交了七张图被退回来重做。从那以后我每次写完批量脚本都强制走一遍「打印总数 → 统计实际文件数 → 随机抽三张肉眼核对」这套流程哪怕项目再小也不跳。希望帮到你。本文还有配套的精品资源点击获取
