ArcMap数据驱动页面+arcpy实现卫片图斑批量出图-北京尧图网络

简介面向GIS数据处理与制图人员的ArcGIS按图斑批量出图操作文档聚焦卫片图斑的自动化出图场景帮助需要把大量图斑逐一导出为JPG图片的读者摆脱手工排版与重复导出。文档围绕数据驱动页面Data Driven Pages展开说明图层、名称字段、排序字段、显示范围与比例尺的配置方法并讲解在布局视图中添加图斑编号、所在区域、面积、类型等动态文本使每张成图都带有对应图斑属性。压缩包内为1个doc文档压缩后约29KB体量轻便适合随查随用。结合Python的arcpy脚本读者可了解遍历页面、切换currentPageID、读取页名及调用ExportToPNG导出的完整思路也能据此改写为JPG输出、调整图像尺寸并补充错误处理。目前已有8322人学习适合具备ArcGIS 10.2及以上环境、希望掌握批量制图自动化的中初级GIS从业者与测绘、自然资源技术人员参考。1. 卫片图斑出图真正累人的是重复劳动卫片图斑核查的活一到手最磨人的往往不是判读而是出图。一个乡镇两百多个图斑每个都要一张带村名、面积、图斑类型的 JPG手工在 ArcMap 里挪数据框、改文本、点导出一天下来手都僵了。Arcgis 批量出图这件事其实不用插件、不用二次开发平台ArcMap 自带的数据驱动页面配一段二十行的 arcpy 脚本就够——把索引图层设成图斑层一页对一个图斑循环切页、导出两百张图压到几分钟。适合手上有一层图斑矢量、需要按要素批量出图的 GIS 作业人员也适合想把这段流程接进自己工具链的开发者。硬门槛只有一个ArcGIS 必须 10 及以上9.x 没有这个功能。2. 环境与选型ArcMap 10.x 加数据驱动页面的最小依赖动手前先把环境确认清楚不然脚本写完跑起来一堆报错排查的方向都会跑偏。这一章把版本、解释器、路线选择和目录组织讲明白后面配置图层和写脚本才有基础。2.1 版本红线与解释器选择数据驱动页面Data Driven Pages是 ArcGIS 10.0 才引入的功能脚本里调用的arcpy.mapping模块同样是 10.0 之后才有的东西。9.x 时代用的是arcgisscripting接口完全不一样网上能搜到的 9.x 出图脚本放到 10 上跑不通反过来也一样。项目正文里强调「Arcgis10 以上9 不行」说的就是这条线。版本之外最容易出错的是解释器。ArcGIS Desktop 10.x 自带的是 Python 2.7装在类似C:\Python27\ArcGIS10.2\这样的路径下arcpy只认这一个。你要是用系统里另外装的 Anaconda 或者 Python 3 去执行第一行import arcpy就会抛ImportError: No module named arcpy。Notepad 的「运行」按钮本质上也是去调用系统关联的 python.exe关联错了坑就在这里。我自己的习惯是两条路二选一要么直接在 ArcMap 的 Python 窗口里粘贴执行解释器天然正确要么开命令行显式写全路径C:\Python27\ArcGIS10.2\python.exe F:\GeoData\script\batch_export.py提示写脚本时别用 Pro 的思路。ArcGIS Pro 里arcpy.mapping已经换成arcpy.mp数据驱动页面换成 Map SeriescurrentPageID那套 API 全变了。这篇里的代码只在 Desktop 10.x 有效。2.2 两条批量出图路线的对比按图斑批量出图业内其实有两套常见做法选错了后面越写越别扭。第一套是手写循环加定义查询遍历图斑属性表的每一行arcpy.mapping.Layer拿到图层改definitionQuery改数据框范围dataFrame.extent再导出。这套的好处是全靠代码控制不需要在界面上做任何配置适合嵌进无人值守的服务里。坏处是数据框范围得自己算比例尺、要素居中、留白全要手写几何运算遇上跨带、跨坐标系的图斑很容易出错。第二套就是数据驱动页面地图里配置一次索引图层之后的居中、比例尺、动态文本全部由 ArcMap 渲染引擎负责脚本只做「切页导出」这一件事。代价是你得有一份保存好的 mxd前期配置在界面上完成。对比项定义查询循环数据驱动页面要素居中与范围自己算 extent引擎自动处理比例尺控制手写 scale 赋值配置界面里选固定/自动动态文本需要逐页替换元素文本配置一次全页生效前期配置无需要在 ArcMap 里配索引图层适合场景无人值守服务、批量脚本人工出图、报告式版面卫片核查这种「版面要求统一、带村名面积等属性文字」的场景第二套明显省事所以项目里走的是数据驱动页面这条线。2.3 工程目录骨架一个能反复用的出图工作区批量出图最容易乱的阶段是文件散落各处mxd 放在桌面输出图片丢到下载目录脚本扔在临时文件夹里下次换个乡镇又要重新找。我一般一开始就把目录固定下来后面换数据只换路径。路径作用注意点GeoData\mxd\存放工程文件mxd 里勾选「存储相对路径」整包拷贝不丢源GeoData\vector\图斑索引图层shapefile 或 gdb 要素类索引图层单独放别和底图混在一个 gdb 里GeoData\basemap\影像、行政区、路网等底图数据量大时建议建金字塔不然每页渲染都慢GeoData\out\输出图片目录按批次建子目录比如out\2024_03\GeoData\script\py 脚本和日志日志和图片分开放出问题先看日志相对路径这一步别省。File Map Document Properties里把「Store relative pathnames」勾上之后整个GeoData文件夹打包发给同事他那边路径不一样也能直接打开。不勾的话脚本里换了盘符图层全是红叹号导出来一堆空白图排查起来非常费劲。3. 地图装配索引图层、动态文本和比例尺怎么配到位脚本之前的功夫全在 mxd 里。配置得好脚本就是十几行配置得糙脚本里就得写一堆补救逻辑。三个方面要配置到位索引图层、动态文本、比例尺与范围。3.1 打开数据驱动页面并配好索引图层入口在Customize Toolbars Data Driven Pages勾上之后工具栏会浮出来点第一个按钮打开Data Driven Pages Setup对话框。这里四个参数决定一切图层Layer选图斑矢量层也就是那份卫片图斑数据。它必须已经加载进当前数据框且没有被定义查询过滤掉过滤掉的要素不会生成页面。名称字段Name Field后续脚本拿它当输出文件名。建议用图斑编号形如WP2024_001不要用带空格、斜杠、冒号的中文名文件名合法性会出问题。排序字段Sort Field决定页码顺序。按编号排最稳便于和台账对账按面积从大到小排也常见方便先看重点图斑。显示范围与比例尺见 3.3 节。配完之后工具栏上会有页码输入框和前后翻页箭头随手翻几页看效果图斑是不是居中、有没有被裁掉这里是最后一道人工检查关口。索引图层的字段建议在配置前就准备好。面积这种字段 if 是图形算出来的用「计算几何」先落到属性表里别指望动态文本自己算。所在村、图斑类型这类挂接字段也提前 join 好并导出为实体字段——动态文本读的是索引图层的真实字段关联表的虚拟字段有时读不出来。3.2 动态文本把村名、面积、图斑类型印到图上版面里那些「这一页是哪个图斑」的文字靠的是动态文本。在布局视图里Insert Dynamic Text常用的几项Page Name等于名称字段的值标题最常用。Page Attribute Field选索引图层的某个字段村名、面积、类型都走这个。插入时它会让你选图层和字段选错图层就是空白。Page Number当前页码 / 总页数做「第 3 页共 215 页」很方便。一个实际版面通常长这样标题写「卫片图斑 WP2024_037 核查图」下面一行是「所在村XX村面积12.4 亩类型建设用地」右下角放页码和制图日期。这些文字一旦配成动态文本翻到哪一页就自动显示哪一页的属性不用逐页改。注意动态文本在布局里看着是带尖括号的占位符只有翻页或导出时才替换成真值。如果发现某页显示成Null那是索引图层该字段本身为空回属性表补齐即可不是文本配置错了。3.3 比例尺与显示范围的取舍这一步直接决定成图能不能用。Data Driven Pages Setup里的 Extent 有三档常用选项以要素范围为中心并裁剪Center and Clip to Feature Extent按图斑自身范围铺满数据框大小图斑看起来一样大。适合出单图斑详图但几张图之间没法比大小。以指定比例尺居中并裁剪Center and Clip with Specified Scale所有页统一比例尺图斑大小可比。核查类出图基本用这个。最佳拟合Best Fit引擎自动算比例尺让图斑刚好放得下省事但比例尺五花八门。卫片核查我一般固定 1:2000 到 1:5000具体看影像分辨率0.5 米影像配 1:2000 够看清地物2 米影像配 1:5000 更合适再放大就是马赛克了。同时把范围边距留出来图斑贴边观感很差Extent 里可以设百分比边距或者用「Map Extent」选项卡里的边距值给 10% 到 20%。注意固定比例尺加上大图斑会出现图斑超出图框被裁的情况。这类图斑要么单独用「以要素范围为中心」再出一版要么在索引图层里给它单独标注、脚本里分流处理。3.4 保存与图层锁定配置完记得保存 mxd。脚本读的就是磁盘上的这个文件ArcMap 界面里改了没保存脚本读到的还是旧配置——这个坑不显眼但每次都有人踩。另外脚本运行期间别再去编辑同一个 mxd读写冲突会导致导出中断。图层层面还有两件事一是底图数据源如果是 SDE 或者网络路径导出时每页都要去拉数据速度会很慢能落到本地就落本地二是导出前确认所有图层都是可见状态被关掉的图层不会出现在图里出完一看少了个行政区界返工成本比检查高得多。4. 脚本拆解arcpy 遍历页面导出的每一行在干什么前置配置做完剩下就是脚本。这段代码不长但每一行的含义和边界条件值得逐行过一遍尤其是页码范围和编码这两处。4.1 最小可用脚本逐行读# -*- coding: utf-8 -*- import arcpy # 已经配好数据驱动页面的工程文件 mxd arcpy.mapping.MapDocument(rF:\GeoData\mxd\WeiPian.mxd) out_dir rF:\GeoData\out # pageCount 是总页数页码从 1 开始所以右边界要 1 for page_num in range(1, mxd.dataDrivenPages.pageCount 1): # 切到当前页渲染引擎会自动把数据框移到该图斑 mxd.dataDrivenPages.currentPageID page_num # pageRow 是当前页对应的索引图层记录pageNameField.name 是字段名 field_name mxd.dataDrivenPages.pageNameField.name name mxd.dataDrivenPages.pageRow.getValue(field_name) out_file out_dir \\ name .png arcpy.mapping.ExportToPNG(mxd, out_file) print(done: name) del mxd几个关键点。arcpy.mapping.MapDocument接收 mxd 的绝对路径返回一个文档对象后续所有操作都基于它。mxd.dataDrivenPages是数据驱动页面的入口对象只有 mxd 里配置过索引图层它才可用否则访问会直接报错。pageCount是总页数currentPageID是当前页号从 1 开始计数不是 0。pageNameField.name返回的是字段名而不是字段值这一点容易看混取值得用pageRow.getValue(字段名)pageRow是当前页对应的那一条索引图层记录等价于属性表里的一行理论上你想取哪个字段都行。原始参考代码里range(1, mxd.dataDrivenPages.pageCount)少写了个1右开区间导致最后一页永远不出图——图斑一共 200 个出 199 张而且不报错只有对着台账数才发现。这是这类脚本最常见的翻车点别照抄。另外原始代码文件名叫.png正文里说的是出 JPG两回事。要 JPG 就把导出函数换成ExportToJPEG。4.2 导出函数的参数怎么调ExportToPNG的完整签名是ExportToPNG(map_document, out_png, {data_frame}, {df_export_width}, {df_export_height}, {resolution}, {world_file}, {color_mode}, {transparent_color}, {position})ExportToJPEG类似但末尾是{quality}和{progressive}。方括号包起来的都可以不填不填就用默认值——默认宽度只有 640 像素出来一张糊图很多人第一次跑完觉得「怎么这么小」就是这个原因。参数含义常用值data_frame要导出的数据框多个数据框时要指定不填表示主数据框df_export_width/df_export_height输出像素尺寸2400 × 18004:3 版面resolution输出 DPI屏幕预览 96打印 200~300world_file是否附带坐标信息文件True 会额外生成.jgw/.pgw方便回贴color_mode色彩模式24-BIT_TRUE_COLOR全彩quality仅 JPEG压缩质量85~95一段调过参数的导出调用长这样# 2400x1800 像素、300dpi附带坐标文件适合打印和归档 arcpy.mapping.ExportToJPEG( mxd, out_file, df_export_width2400, df_export_height1800, resolution300, world_fileTrue, color_mode24-BIT_TRUE_COLOR, quality90 )这里有个容易混淆的点宽高是像素数resolution 是打印分辨率两者共同决定物理尺寸。2400 像素在 300dpi 下是 8 英寸宽换成 96dpi 就变成 25 英寸。想要「A4 幅面、300dpi」反推像素应该是 2480 × 1754 左右比拍脑袋填 3000 靠谱。大批量出图时也别一味往上堆2400 像素 300dpi 出一张大概一两秒堆到 6000 像素就是十倍时间两百张图等的就是十几分钟。4.3 加固异常捕获、跳过已出图、文件名清洗最小脚本能跑通但只适合一次性的活。真正投入日常使用前我一般会补三件事文件名清洗、断点续跑、错误不中断。# -*- coding: utf-8 -*- import arcpy, os, re, codecs, traceback MXD_PATH rF:\GeoData\mxd\WeiPian.mxd OUT_DIR rF:\GeoData\out LOG_PATH rF:\GeoData\script\export_log.txt # Windows 文件名里不能出现的字符一律替换成下划线 def safe_name(raw): return re.sub(r[\\/:*?|], _, raw.strip()) mxd arcpy.mapping.MapDocument(MXD_PATH) total mxd.dataDrivenPages.pageCount field mxd.dataDrivenPages.pageNameField.name log codecs.open(LOG_PATH, w, utf-8) ok, skip, fail 0, 0, 0 for page_num in range(1, total 1): try: mxd.dataDrivenPages.currentPageID page_num name safe_name(mxd.dataDrivenPages.pageRow.getValue(field)) out_file os.path.join(OUT_DIR, name .jpg) # 已存在就跳过脚本中断后可以直接续跑 if os.path.exists(out_file): skip 1 continue arcpy.mapping.ExportToJPEG(mxd, out_file, resolution300, quality90) ok 1 log.write(uOK\t%s\t%s\n % (page_num, name)) except Exception: fail 1 log.write(uFAIL\t%s\t%s\n % (page_num, traceback.format_exc())) log.write(utotal%s ok%s skip%s fail%s\n % (total, ok, skip, fail)) log.close() del mxdsafe_name解决图斑编号里混了斜杠、冒号导致写文件失败的问题这类脏数据在人工维护的图斑表里非常常见。os.path.exists判断加上continue让脚本具备断点续跑能力——两百张图跑到第一百五十张崩了重跑只补剩下的五十张。try/except包住单页循环一页失败不影响整批失败信息连同堆栈写进日志事后按页码定位。日志用codecs.open(..., w, utf-8)而不是普通open因为 Python 2 的默认编码是 ASCII写中文进去直接抛UnicodeEncodeError而这个报错又发生在异常处理里会把真正的错误掩盖掉。4.4 不打开 ArcMap 也能跑脚本不需要 ArcMap 界面开着。Desktop 授权正常的情况下命令行直接执行就能后台出图机器该干别的干别的。少数情况下 64 位后台处理需要额外装 Background Geoprocessing普通的图片导出用 32 位桌面环境就够不用折腾。如果想脱离 Desktop 完全自动化另一条路是脚本工具把 py 文件加成 ArcToolbox 里的脚本工具参数用arcpy.GetParameterAsText()接之后可以在 ModelBuilder 里串进更大的流程。这部分放在第 6 章展开。5. 避坑与排查五个让脚本卡住的真实现场这些坑的共同点是脚本不报错或者报的错跟真实原因不沾边。把现象对上比盲目改代码快得多。5.1 一执行就 ImportError: No module named arcpy现象脚本第一行就崩Notepad 里点运行、或者命令行敲python batch_export.py报找不到 arcpy。原因调用的是系统里另外装的 Python不是 ArcGIS Desktop 自带的 2.7 解释器。arcpy是随 Desktop 安装写进那个特定 Python 环境的不在全局 site-packages 里。解决用全路径调用C:\Python27\ArcGIS10.2\python.exe或者干脆在 ArcMap 的 Python 窗口里跑。检查办法是在命令行执行python -c import sys; print(sys.executable)看输出路径里有没有ArcGIS字样。5.2 图斑 200 个只出了 199 张图现象脚本顺利跑完print一路 ok去文件夹一数少一张少的正好是最后一个图斑。原因range(1, pageCount)是右开区间pageCount那一页取不到。这个错误不抛异常纯逻辑问题。解决写成range(1, pageCount 1)或者用while循环让page_num从 1 递增到pageCount。出完图之后拿文件数量和pageCount对一遍是个十秒钟的自检动作。5.3 中文图斑名称报编码错或者文件名变乱码现象跑到某个图斑时抛UnicodeDecodeError: ascii codec cant decode byte或者文件生成出来了但名字是问号、乱码。原因Python 2 里字符串默认是字节串out_dir \\ name这种拼接只要name含中文就会触发隐式解码用 ASCII 解 UTF-8 必然失败。文件头部那行# -*- coding: utf-8 -*-只声明源文件编码不影响运行时字符串类型。解决路径统一用 unicode 字面量或者用os.path.join拼接并保证两边类型一致写日志用codecs.open(..., w, utf-8)print到 GBK 控制台还可能二次报错日志落文件最省心。5.4 导出的图一片空白只有底色和动态文本现象图片文件正常生成尺寸也对打开一看框里啥都没有或者只有行政区底色找不到图斑。原因常见三种。索引图层数据源断了ArcMap 里显示红叹号渲染时该图层被跳过图斑本身不在当前比例尺的显示范围内固定比例尺配大图斑或者坐标系统不一致图层被设了最小/最大显示比例尺出图比例尺不在区间内。解决先在 ArcMap 里翻几页确认显示正常再跑脚本检查图层属性General页的可见比例尺范围全设成「不在超出范围时显示」数据源路径尽量用相对路径换机器不丢。5.5 文字发虚、图斑边缘有锯齿现象图斑轮廓和标注文字都糊打印出来更明显比例尺没错但观感差。原因只改了df_export_width没改resolution或者两个都没改用的默认 640 像素输出。解决像素尺寸和 DPI 一起设。要 A4 打印就按210mm / 25.4 * 300 ≈ 2480反推宽度高度按版面比例配。抗锯齿在导出层面控制不了源头是底图分辨率和标注字体标注字号在版面里别小于 8pt小字号在任何 DPI 下都糊。6. 二次开发把脚本改成传参即用的出图工具硬编码路径的脚本只能自己用交给同事就得改代码。真正好用的是把它做成一个能传参的小工具把 py 挂到 ArcToolbox 的脚本工具里参数用arcpy.GetParameterAsText()接界面上填 mxd 路径、输出目录、格式、DPI 就能跑不用碰代码。# -*- coding: utf-8 -*- import arcpy, os, re, codecs # 参数顺序与脚本工具里定义的参数顺序一致 mxd_path arcpy.GetParameterAsText(0) # 工程文件 .mxd out_dir arcpy.GetParameterAsText(1) # 输出目录 fmt arcpy.GetParameterAsText(2) or JPEG dpi int(arcpy.GetParameterAsText(3) or 300) start_no int(arcpy.GetParameterAsText(4) or 1) mxd arcpy.mapping.MapDocument(mxd_path) total mxd.dataDrivenPages.pageCount field mxd.dataDrivenPages.pageNameField.name for page_num in range(start_no, total 1): mxd.dataDrivenPages.currentPageID page_num name re.sub(r[\\/:*?|], _, mxd.dataDrivenPages.pageRow.getValue(field)) out_file os.path.join(out_dir, name (.jpg if fmt JPEG else .png)) if fmt JPEG: arcpy.mapping.ExportToJPEG(mxd, out_file, resolutiondpi, quality90) else: arcpy.mapping.ExportToPNG(mxd, out_file, resolutiondpi) arcpy.AddMessage(u%s/%s %s % (page_num, total, name)) del mxdstart_no这个参数看着多余实际很顶用跑到一半中断、或者只想补出某个村的后半段图斑改个起始页码比重新改代码快得多。arcpy.AddMessage会把进度打到工具的消息面板上比print更适合脚本工具环境。参数定好之后可调项其实就那几个我把常用的取值范围列一下方便配默认值参数建议默认可调范围影响输出格式JPEGJPEG / PNGPNG 无损但体积大归档用 PNG日常传阅用 JPEGDPI30096 ~ 400打印取 300屏幕预览 96 足够压缩质量9070 ~ 100低于 80 时图斑边界会出块状伪影起始页码11 ~ pageCount断点续跑用边距百分比150 ~ 30太小图斑贴边太大主体变小再往前一步的改造是把「出哪些图斑」也参数化加一个可选参数接 CSV 或要素类脚本里先按这个清单过滤索引图层的definitionQuery再走页面循环。这样同一份 mxd 既能全量出图也能按村、按批次挑着出不必另存一个工程文件。验证方法我固定用三步先看pageCount是不是等于图斑总数数量不对说明索引图层的定义查询或数据源有问题再随机抽三张第一张、中间一张、最后一张打开看版面重点看最后一张那是页码边界最容易漏的地方最后拿文件名列表和属性表编号做一次比对差集不为空就回去查 5.3 的文件名清洗。三步走完这批图基本可以放心交出去。早些年我图省事脚本直接硬编码路径就交货结果换台机器第一行就崩改完路径又发现编码报错来回折腾一下午。从那以后我每次写这类批量脚本都强制走一遍「解释器确认—页码边界核对—抽最后一张」的流程再急的活也不跳。希望帮到你。本文还有配套的精品资源点击获取

ArcMap数据驱动页面+arcpy实现卫片图斑批量出图

相关推荐

Fibonacci数列与黄金分割的算法优化实践

Prim与Kruskal算法：最小生成树实战与性能对比

Paperclip：面向 React 与 Node.js 的轻量 AI Agent 协议

更多资讯

GitHub Copilot CLI本地模型连接实战指南

开关电源11种拓扑选型指南：从原理到工程避坑

ARIMA模型在电力市场价格预测中的实践与优化

小学生学C++不是为了编程，而是训练逻辑思维

逆向解构引擎：把读文献变成拆论文，高效找研究缺口

RPA流程日志记录：设计原则与最佳实践

今日更新

淘宝商品详情API开发实战与性能优化指南

Unity Package Manager刷新错误排查与解决方案

Java record 规范构造器能否被反序列化或反射绕过

本周精选

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？