规划GIS会

这里预置了PNG,JPG和PDF这三种常用的图片类型，如果还有需求可以再添加。之前有网友提出希望可以批量导图，要实现起来并不难，于是就做了这个工具。在ArcGIS Pro中设定好布局后，可以直接导出为各种类型的图片。这是很基本的功能，但是如果你的布局很多，一张一张导图就有点费劲。3、导出图片分辨率，默认设置为300，可手动调整。1、要导出图片的文件夹位置。以上便实现了工具的主要功能。

这里的宽度和高度最后乘的那个系数其实我也不太明白为什么是1.3333，这是自己慢慢测试出来的，反正最后刚好可以截到边界，我就不深究了，有知道的望告知。首先要确定你的VS已经安装了【Interop.Microsoft.Office.Interop.Excel】。估计这会是一个相对通用的需要，于是就专业做了这样一个方法，也顺便水一篇。然后就是创建图片对象，然后保存到剪贴板，再粘贴保存。

CIM（Cartographic Information Model）（地图信息模型）是ArcGIS Pro SDK中的一种数据模型，用于表示地图和图层的符号、样式和布局信息。CIM提供了一种统一的方式来描述地理信息系统（GIS）中的地图元素，包括点、线、面、文本、图例等。Layout中包含多种元素，比较重要的有：地图(MapFrameElement）、文本(TextElement）、图片(PictureElement）、图例(LegendElement)等。

就是三调数据，需包含【JQDLBM】、【JQDLMC】和【CZCSXM】3个字段（其中【CZCSXM】是三调数据固定字段，正常不用处理）需包含【GHDLBM】、【GHDLMC】和【SSBJLX】3个字段（别名可以是中文，但字段名发必须为英文）上面数据检查工具也很方便，哪里有问题一下也能找出来，过了检查工具，基本入库就不会有什么问题了。有想一起学习的可以私聊。首先，需要一个输入文件夹，名为【1-输入文件】，位于当前工程的根目录下。如上图所示，在【村庄规划】组，有两个工作面板：【准备工作】和【入库】。

但是实际使用过程中，发现有些用地在规范之外，比如【1104A养殖坑塘】等，目前我只能按自己碰到的情况先做一个修正，比如【1104A养殖坑塘】就归类到【1104坑塘水面】。然后还要归纳一下大类，这里不像用地用海，可以从小类或中类直接取编码前两位归纳大类，只能做一个对照表，然后属性映射。面积字段，以投影面积为例，选择【shape_area】，如果要统计椭球面积，就选择相应的面积字段。在弹出的工具框中，分别输入三调图斑，要统计的面积字段，以及要输出Excel表格的位置。以上便是工具的核心代码。

如右图所示，工具读取输入GDB里的要素名，如果和空库里的要素同名，就会执行【追加】，输入的要素如果有和空库要素同名字段，则会保留字段和字段值，如果存在空库要素没有的字段，则丢弃该字段。工具的核心是应用【追加】工具，所以需要获取各个要素类的完整路径，这里不能直接用gdb路径+要素名，因为可能存在要素数据集。如果你手头已经整理了一部分要素类数据，但是数据格式，字段值可能并没有完全按照规范设置好，需要将这些数据按规范批量和库，就可以尝试用这个工具。做好的数据需要把要素名改成和标准空库对应的要素同名。

不过做了不能白做，而且和【排序】工具相比还是有点优势，不用打开工具箱，输入参数，还是会更方便一点，因此还是水一篇。如上图所示，在待处理的要素上右键单击，在弹出的右键列表中，点击【CC工具箱——从上至下从左至右排序】按钮即可。不过后来在ArcGIS Pro中发现了一个【排序】工具，已经可以完美实现这个功能需求，发现自己做了个白工。发现【排序】工具后，我把原来的代码全删了。直接调用【排序】工具，因此代码量很少，基本没什么东西。【排序】工具会生成新的要素，用【复制要素】工具再覆盖回来即可。

随着二次开发的不断学习，目前零零碎碎的已经做了一些相对成型可用的工具。我把这些工具整合了一下，欢迎大家试用，帮忙反馈一下bug，以及提一些需要改进的地方或者需求。这里放一些文档的截图，具体使用方法自己查看上面放出的使用文档下载。这里就当是一个意见和BUG收集贴，希望大家积极留言或私信。时间和能力允许的话我会尽量满足要求。

我在之前做的工具中，UI这部分基本没怎么深入，都是直接用的现成的控件。其中有一个问题比较突出，就是没有工具执行的进度框提示。曾经也用过系统自带的信息提示框和进度条，但太简陋，确实不好用。于是就想抄一个进度框来用，自然而然想到了ArcGIS中地理工具执行时显示的进度框：这里做一个简单版的，够用就行（其实是目前只会这些）。进度框无法单独使用，这里结合之前做的一个【面要素拓扑】一起使用。

国空的数据库体量很大，单是要素类就有100多个，不是以前村规数据库能比的，手动建库是不可能的，工具自动建库就是一个很合理的选择。如上图所示，点击【属性结构描述表转空库】按钮，在弹出的工具框中，选择你修改好的Excel表格，以及放数据库的文件夹位置，再选择正确的坐标系，然后点击执行即可。考虑到工具的通用性，这里没有对数据的结构进行整理，比如和要素数据集的关系等。数据库标准里有每个要素类和表格的【属性结构描述表】，里面规定了要素类、表的名称、别名、字段等属性，只要提取出来就可以用来建库。

如上图所示，选择一个线要素【需注意必须是数据库文件，不能是cad文件】，右键点击，在弹出的菜单中点击【线闭合】按钮即可。找出未闭合的线后，将它的点集合提取出来，将第一个点复制到点集合的末尾，这样点集合就形成一个闭环，然后重新创建要素即可。涉及要素编辑，就按流程建立编辑操作，并打开要素图层，逐行遍历，获取要素，这些都是常规操作。这里通过提取线的首末点，如果首末点的坐标一致，则说明是闭合的，否则就是不闭合。首先要判断线要素是否闭合，已闭合的就不再处理，只处理没闭合的。重点是上面【TODO】里的内容。

GeometryEngine是ArcGIS Pro SDK中的一个关键组件，它提供了一系列用于处理几何图形（Point、Polyline、Polygon……）的方法和算法。例如计算距离、缓冲区分析、叠加分析和几何关系检查等。这里汇总一下在开发中可能会用到的功能，方便查询。

在规划工作中有时候会收到一种带坐标点的txt文件：上网查了一下资料，这是根据《勘测定界界址点坐标交换格式》制作的固定格式文件。其中包含了坐标系、精度、地块编号、地块名称、坐标点等信息。这个工具的目的就是将TXT格式坐标批量转换为数据库文件，并读取地块编号，地块名称，地块用途、3个属性，写到要素类的字段中。（其它信息感觉好像没什么用，就暂不写入了。如上图所示，点击【TXT文件转要素类(批量)】按钮，在弹出的工具框中输入参数。1、输入包含txt文件的文件夹：2、输出gdb数据库的位置。

在ArcGIS中，如果需要向独立表(StandaloneTable)添加行(Row)，或者向要素类(FeatureClass)添加要素(Feature)，一般情况下都是在编辑状态下进行手动编辑的。在工具箱中也有一些类似工具，比如【追加、合并】等，缺点是自由度不高，特别是涉及更改字段值等操作的时候。本文演示的是在ArcGIS Pro SDK中进行编辑操作，主要是【向独立表(StandaloneTable)添加行(Row)】和【向要素类(FeatureClass)添加要素(Feature)】。

这里关键的一个方法就是【GeometryEngine.Instance.GeodesicArea(inspector.Shape)】，这是【ArcGIS.Core.Geometry】自带的一个计算椭球面积的方法，就这么一行简单的代码，花了很长的时间才找到。，用于统计当前所选择的面要素的面积，主要是为了解决“亩”的转换，确实是一个很方便好用的工具。如上图所示，在地图框中，选择部分的面要素，右键单击，在弹出的右键列表中，点击【面积汇总】按钮即可。在弹出的【面积统计】工具框中，显示了两部分共8个面积指标。

由于一些不规范的输入，或是其它数据转换而来，要素类或者独立表的字段值经常含有空值、空格等影响数据质量的内容。这个工具的目的就是清理、转换这些字段内容，提高数据质量。如上图所示，点击【清洗字段值】按钮，在弹出的工具框中，选择要素图层或独立表，再选择一种处理模式，点击执行即可。这里的【处理模式】有4种，【字符串：清除空格；字符串：清除空值；数字：空值转0；数字：0转空值】。功能如字面意思，很好理解。

在国空、村规的实际工作中，将要素类加载到地图中后，需要将图斑的符号系统修改成国空或村规的样式。一般的做法是使用样式库或已经做好的图层文件进行匹配，这个工具要实现的功能是直接应用特定的符号系统，其实用的方法也就是GP工具的【应用图层的符号设置】，并没有多少代码，但好处在于有了这个工具，就不用保存预制好的符号库或图层文件了，在任何场景下都可以运用自如。如上图所示，右击要素图层，点击【应用符号系统】按钮，在弹出的工具框中，选择要应用的符号类别，工具已经预制了2种符号【国空用地（市级）】和【村规用地】。

经纬度坐标的表达方式比较常用的一般有2种，【度分秒和十进制度】。在成果展示中，以【度分秒】居多，但如果要将坐标导入ArcGIS中，则一般需要用到【十进制度】，这个转换可以在Excel中进行，也可以在ArcGIS中的字段计算里计算，但都有点小麻烦。为了更方便的转换，就做了这个小工具。如上图所示，点击【度分秒转十进制度】按钮，选择要素图层或独立表，再选择度分秒（文本型）和十进制度（浮点型）的字段。

我们可以在三调中直接统计出这三大类用地的面积。主要方法是在ArcGIS中将这三大类对应的用地提取出来，再进行统计。不过每次都要在复制一长串的筛选语句，贴到GP工具里执行，有点不方便。于是便做了这个小工具，主打的就是一个懒人需求。

如上图所示，点击【提取特定文字】工具，选择地图内的要素图层或独立表，再选择要处理的包含复杂文字的字段和要输出结果的字段，再选择提取模式，点击执行即可。有时候我们会遇到一些混杂着各种中文、英文、数字、特殊符号的文字，这个工具的目的是从这些复杂文字中提取出想要的特定文字。比如说从CAD测绘图中可以读取到类似【混3】、【砖2】的文字，如果想要从中提取出层数或结构，就可以用这个工具实现。核心代码并不长，正则表达式之前在python中用过，这次在c#中实现，基本差不多，还是很好用的。这是一个基于字段计算的工具。

在工作中，即使很不喜欢用shp文件，但还是经常会收到shp格式的文件。关于shp文件的吐糟就不多说了，除了文件小、字段名长度限制，不能储存弧线段等问题，还有一种处理方式也让人很是难受。如上图，有些shp文件是分散在不同的文件夹里的，虽然方便了文件的分散传送，但没法像数据库一样统计管理，用起来很不方便。这个工具的目的就是处理这一类型的文件，将分散的shp文件合并成一个数据库要素，并且保留文件名，转换成一个标记字段的字段值。

SelectionSet的3个主要方法：Contains、FromDictionary和ToDictionary。在ArcGIS Pro SDK中，SelectionSet类用于处理地图或图层中的【选定要素集合】。一般情况下，当你使用【选择】工具进行要素的选择时，就会得到【Selection】的内容。SelectionSet类提供了许多成员、属性和方法，用于管理和操作选择集。获取成员对象 ID的列表。从选择集创建映射成员及其相应对象 ID 的字典。确定指定映射成员中的记录是否在选择集中。

ArcGIS Pro与旧的ArcGIS桌面应用程序的显著不同之处在于，它采用多线程架构，可以有效的发挥多核CPU的优势。这使得二次开发工具的性能变得更好，但也对开发工作带来了更多的难点和挑战。当然，我们在ArcGIS Pro二次开发中也不用那么深入学习。因为ArcGIS Pro SDK的基础架构已经降低了代码的复杂性。在大多数情况下，我们只需处理两个线程：【用户界面线程】和应用程序提供的单个【专用工作线程】。

在之前的文章中有涉及DDL的知识点，随着深入的学习，在这里做一个小总结。

根据现在村规成果要求，【空间功能结构调整表】是必需的。以福建省为例，它长这样：下面就来实现从现状用地和规划用地导出这样的Excel表格。如上图所示，点击【汇总村庄空间功能结构调整表】工具，选择【现状用地】和【规划用地】图层，选择要保存输出的Excel文件路径，再点击【执行】即可。流程长但不复杂，更重要的是Excel模板和输入【现状用地、规划用地】的准备。

本工具的作用是将现状用地或规划用地导出Excel格式的用地用海汇总表。这次试着在ArcGIS Pro SDK中来实现同样的功能。如上图如示，点击【用地用海汇总表】按钮，选择用地图层、用地编码、要导出保存的汇总表位置，以及要汇总的类型【大类、中类、小类】，点击执行即可。

如题，要实现的功能描述比较绕口，如图如示：我们在将汇总的面积填入准备好的Excel表模板后，某些行因为没有面积值（这里预先输入为0，方便计算），需要将行删除再进行输出。更复杂一点，比如需要根据【现状面积】和【规划面积】2列一起判断，当2者都为0时，则删除当前行。实现结果如下：【茶园】行现状用地为0，但规划用地不为0，所以没有被删除。

可以添加到Map中的多种文件格式（包括图层文件和包、地理数据库项目、Web图层和服务、栅格、shape、KML、KMZ、CAD、表、视频文件、NetCDF）可以导入地图的一些文件和包（包括地图文档MXD、3DD、SXD、地图包MPK、MMPK、地图文件MAPX、布局文件PAGX、报表文件RPTX）带有高程值的数据（包括高程表面、高程图层、影像图层和服务、WCS动态图层和服务、栅格、TIN、图层文件LYR和LYRX）地理数据库要素（包括要素类、要素数据集、栅格等）文本文件（TXT、CSV、TAB）

属性映射经常用于属性表或Excel表的赋值，比如按用地用海表对规划用地的用地编码或用地名称赋值，将汇总好的用地指标表赋值给已经制好的Excel模板等。下面试着在ArcGIS Pro SDK中实现功能上述这两个功能。

如题如见，这是一个检查现状、规划用地变化的工具。通过此工具，可以生成变化图斑，检查规划中发生的变化，明确是正常的规划措施，还是因为误操作产生的图斑变化。如上图所示，点击【检查现状规划用地变化】按钮，打开工具框，在下拉框中选择自备的现状和规划图层，并选择相应图层的编码或名称字段。这里前后必须保持一致，比如说现状用地选择了用地名称，那么规划图层也要选择用地名称，因为工具是通过这2个字段的值是否发生变化来判断用地变化的。然后点击运行即可。

在国空或村庄规划的编制过程中，随着规划用地的调整，经常会手动修改用地编码和用地名称，不可避免的会出现错误，如果单靠人工校对，累人又不能保证准确性。这个工具的目的就是检查用地编码和用地名称是否规范，二者是否一一对应。如上图所示，右键点击地图中的要素图层，点击【检查用地用海字段】按钮，打开工具框，选择图层的用地编码字段和用地名称字段，点击运行即可。运行结果如下图：要素会新增一个【用地用海检查】字段，用地编码和用地名称的规范性错误会列在字段里。

在国土空间规划中，用地用海分类采用三级分类体系，共设置24种一级类、106种二级类及39 种三级类。在某些场景中，需要按等级归类并汇总统计。这个小工具的作用就是通过用地编码生成三级地类，作为后续统计的基础。如上图所示，右键点击地图中的要素图层，点击【生成分级用地用海】按钮，打开工具框，选择图层的用地编码字段、分级类型和是否生成名称，点击运行即可。其中分级类型中，如果选【大类】，会生成新字段【大类编码】；选【中类】，则会生成新字段【大类编码、中类编码】，以此类推。

在那篇文章里，只简单记录了txt文件和Excel文件的读写，近些天体验了Excel文件的操作，内容比较多，也比较复杂，所以这里再单独记一篇。Excel文件打开和关闭这些框架代码就不再写了，可以看上面的帖子，这里就重点记录其它关键操作的核心代码，也不另外再放工程文件。

ArcGIS Pro SDK中的弹出式右键菜单非常多，在地图视图、布局视图、地理处理、文件目录等地方，随便右键点击某个文件、要素，一般都会弹出一个右键菜单。这些菜单实际上都有一个专有ID进行控制，总数量估计得有数百个？。目前，我也只接触了几个常用的，在这里列出来，方便以后查阅。后面用多了，就在这个帖子里慢慢补充。

在数据库创建要素类是一个很基本的功能。ArcGIS Pro中已经提供了一个工具：【数据管理工具】——【要素类】——【创建要素类】，可以实现这个功能。这里演示的是如何在SDK中实现。以上代码比较简单，虽然我也才刚学到这里，但是感觉DDL应该是比较重要的知识点，这篇文章就算是一个基础，后面还会深入研究。

ArcGIS Pro SDK 3.0中的Geoprocessing类是用于执行地理处理工具的核心类。地理处理工具是用于执行空间分析、数据转换、数据管理等任务的工具集，包括常见的空间分析工具、栅格处理工具、矢量处理工具、地图制图工具等。最近在使用过程中发现遗漏了不少东西，再次记录，方便查阅。这次主要记录Geoprocessing的主要方法和参数的使用。

PS：可以直接点击...bin\Debug\net6.0-windows\下的.esriAddinX文件直接安装。将CAD文件打开并转换为FeatureClass，必须指定要素类型，如【点，线，面……这里虽然是以表格的形式打开，但是实际上它仍然是一个要素类，可以自由转换格式。如果是打开shp数据的表格，同样的，可以带【.dbf】的后缀，也可以不加。需要注意的是，打开shp文件，可以带【.shp】的后缀，也可以不加。需要注意的是，打开CAD文件，必须带【.dwg】的后缀。这点上，shp数据是放得比较宽松的。

在字段串字段的值中，因为复制、输入不正确等原因，经常会带着空格，造成后续计算字段时发生错误，这个工具的目的是消除所有字符串字段中的空格。

在国土空间规划中，用地用海的名称和代码是一一对应的，手动修改用地代码后，还需要相应的修改名称，纯纯的重复工作，因此做了这个工具。右键点击地图中的要素图层，点击【用地名称和代码互转】按钮，打开工具框，选择转换前和转换后字段、转换模式，点击运行即可。

在规划工作中，经常需要输入表格数据，如【用地用海分类表】。之前是经验是做一个Excel表格，通过导入Excel，转换成数据库表格（Tabel）。但这样有一点不好的地方，Excel表格作为输入数据，在制作成插件或工具之后，必须一起使用，容易发生丢失或路径变化等问题。于是这有了这个想法，把表格内容以Dictionary形式内置，再通过Dictionary转化成Table。如上图所示，点击【创建表格】创建一个空表格，再点击【添加新行】插入用地用海的代码和名称。其实2步可以合成1步，这样做只是为了更好的演示。