arcgis pro ArcGISProject

ArcGISProject

描述

用于访问 ArcGIS Pro 工程方法和属性。大多数地图自动化工作流都需要引用此对象。

说明

ArcGISProject 对象用于访问 ArcGIS Pro 应用程序中找到的众多工程属性和方法。ArcGISProject 对象通常是最先引用的对象(这些对象是在地图自动化脚本中创建的)之一,因为它是访问几乎所有其他 ArcGIS 工程对象的主要入口点。

引用 ArcGISProject 对象后,您可以使用 listMaps 方法访问地图或使用 listLayouts 方法访问布局。引用 Map 对象后,您可以访问 Layer 或 Table对象,或访问 Layout 对象后,您可以访问 GraphicElementLegendElementMapFrameMapSurroundElementpictureElement 和 TextElement 等布局元素。您可以从这些对象访问工程中的其他对象。ArcGISProject 对象还可以用于管理工程设置,如 defaultGeodatabase 和 defaultToolbox。

importDocument 方法允许您将地图文档 (.mxd)、globe 文档 (.3dd) 和 scene 文档 (.sxd) 导入到工程中。此操作提供了用于将这些文档类型自动转换为 ArcGIS Pro 工程的机制。importDocument 方法还允许您将地图文件 (.mapx)、布局文件 (.pagx) 或报表文件 (.rptx) 导入到现有工程中。

activeMap 属性用于在应用程序内部执行的脚本,例如在 Python 窗格中运行的脚本,或与使用基于活动视图提供信息的验证脚本的脚本工具相关联的脚本。例如,如果地图视图已打开,则会返回相关联的地图。如果布局视图已打开,则会返回与布局上活动地图框相关联的地图。当脚本在应用程序外部运行时,该属性将始终返回 None 值,因为视图仅在应用程序打开时才会相关。

属性

属性 说明 数据类型
activeMap

(只读)


返回与应用程序内部焦点视图相关联的地图对象。None 如果没有打开具有相关联的地图的视图或当脚本在应用程序外部运行时,将会返回。

Map
dateSaved

(只读)


返回报告上次工程保存日期的 Python datetime 对象。

DateTime
defaultGeodatabase

(可读写)


工程的默认地理数据库位置。此字符串必须包含地理数据库的完整路径和文件名称。

String
defaultToolbox

(可读写)


工程的默认工具箱位置。此字符串必须包含工具箱的完整路径和文件名称。

String
documentVersion

(只读)


根据上次保存文档的时间返回文档版本。执行 save 或 saveACopy 将更新文档版本,以匹配应用程序版本。

String
filePath

(只读)


返回报告完全限定的工程路径和文件名的字符串值。

String
homeFolder

(可读写)


工程的主目录文件夹位置。此字符串必须包含所需位置的完整路径。

String

方法概述

方法 说明
importDocument (document_path, {include_layout}, {reuse_existing_maps})
将地图文档 (.mxd)、globe 文档 (.3dd) 和 scene 文档 (.sxd) 导入到 ArcGIS Pro 工程中。还可以导入地图文件 (.mapx)、布局文件 (.pagx) 和报表文件 (.rptx) 的内容。

listBrokenDataSources ()
返回项目中到所有地图原始源数据的连接存在断开情况的 Layer 和/或 Table 对象的 Python 列表。

listColorRamps ({wildcard})
listColorRamps 方法将引用工程中的可用色带。

listLayouts ({wildcard})
返回 ArcGIS 工程 (.aprx) 中的 Layout 对象的 Python 列表。

listMaps ({wildcard})
返回 ArcGIS 工程 (.aprx) 中的 Map 对象的 Python 列表。

listReports ({wildcard})
返回 ArcGIS 工程 (.aprx) 中的报表对象的 Python 列表。

save ()
将更改保存至 ArcGISProject (.aprx)。

saveACopy (file_name)
将 ArcGISProject (.aprx) 保存到新文件路径或另存为新文件名。

updateConnectionProperties (current_connection_info, new_connection_info, {auto_update_joins_and_relates}, {validate}, {ignore_case})
使用工作空间字典或路径替换连接属性。

方法

importDocument (document_path, {include_layout}, {reuse_existing_maps})
参数 说明 数据类型

document_path

包含(.mxd、.3dd 或 .sxd)文档或地图文件 (.mapx)、布局文件 (.pagx) 或报表文件 (.rptx) 的系统路径和名称的字符串。

String

include_layout


指示是否导入地图文档中的布局 (.mxd) 的布尔型参数。如果设置为 True,则将导入布局和全部数据框。如果设置为 False,则仅导入数据框。对于其他文件类型,可忽略此参数。

(默认值为 True)

Boolean

reuse_existing_maps


默认情况下,导入布局文件 (.pagx) 会复制布局引用的所有地图。如果工程中已存在地图,则可以将 reuse_existing_maps 设置为 False,由此可检查工程中布局文件中引用的地图,并仅复制工程中不存在的地图。这样可以避免在工程中复制地图。对于其他文件类型,可忽略此参数。

(默认值为 False)

Boolean

此方法一次只能导入一个文档。要导入多个文档,请对每个文档执行一次此方法。地图文档 (.mxd) 始终具有布局。迁移地图文档时,您可能并不总是想要导入布局。如果是这种情况,请设置 include_layout=False。

listBrokenDataSources ()

返回值

数据类型 说明
List
Layer 和/或 Table 对象的 Python 列表。

listBrokenDataSources 方法始终返回 Python 列表对象,即使返回一个损坏的图层或表。

listColorRamps ({wildcard})
参数 说明 数据类型

wildcard


通配符将基于色带名称显示在应用程序中。星号 (*) 和字符的组合可用于帮助限制生成的列表。

(默认值为 None)

String

返回值

数据类型 说明
List
将返回 ColorRamp 对象列表。

在一个工程中,可能会有多个色带使用相同的名称。创作工程时,采用可通过唯一名称轻松进行搜索的色带名称非常重要。索引编号可用于返回一个特定的色带。例如,以下行可以返回列表中的第一个色带对象:cr = aprx.listColorRamps("Black*")[0]。

listLayouts ({wildcard})
参数 说明 数据类型

wildcard


通配符基于布局名称且不区分大小写。星号 (*) 和字符的组合可用于帮助限制生成的列表。

(默认值为 None)

String

返回值

数据类型 说明
List
ArcGIS 工程中的 Layout 对象的 Python 列表。

返回 ArcGIS 工程 (.aprx) 中的 Layout 对象的 Python 列表。

listMaps ({wildcard})
参数 说明 数据类型

wildcard


通配符基于地图名称且不区分大小写。星号 (*) 和字符的组合可用于帮助限制生成的列表。

(默认值为 None)

String

返回值

数据类型 说明
List
ArcGIS 工程中的 Map 对象的 Python 列表。

返回 ArcGIS 工程 (.aprx) 中的 Map 对象的 Python 列表。

listReports ({wildcard})
参数 说明 数据类型

wildcard


通配符基于报表名称且不区分大小写。星号 (*) 和字符的组合可用于帮助限制生成的列表。

(默认值为 None)

String

返回值

数据类型 说明
List
ArcGIS 工程中的报表对象的 Python 列表。

返回 ArcGIS 工程 (.aprx) 中的报表对象的 Python 列表。

save ()

将更改保存至 ArcGISProject (.aprx)。已保存此项目,同时项目变量继续引用原始 ArcGISProject对象。

saveACopy (file_name)
参数 说明 数据类型

file_name

用来将 ArcGISProject (.aprx) 保存到新文件路径或另存为新文件名的字符串。

String

该方法会创建新输出工程文件,但工程变量继续引用原始 ArcGISProject 对象。并不会复制工程文件夹中的所有内容。

updateConnectionProperties (current_connection_info, new_connection_info, {auto_update_joins_and_relates}, {validate}, {ignore_case})
参数 说明 数据类型

current_connection_info

用于表示工作空间路径或 Python 字典(包含要更新的源的连接属性)的字符串。

String

new_connection_info

用于表示包含连接属性与新源信息的工作空间路径或 Python 字典的字符串。

String

auto_update_joins_and_relates


如果设置为 True,则 updateConnectionProperties 方法还将更新相关连接或关联的连接。

(默认值为 True)

Boolean

validate


如果设置为 True,则仅在 new_connection_info 值为有效连接时,才会更新连接属性。如果为无效连接,则不会替换连接。如果设置为 False,则无论匹配是否有效,此方法都会将所有连接设置为匹配 new_connection_info。在这种情况下,如果匹配不存在,则将损坏数据源。

(默认值为 True)

Boolean

ignore_case


确定搜索是否区分大小写。默认情况下,查询区分大小写。要执行不区分大小写的查询,请将 ignore_case 设置为 True。

(默认值为 False)

Boolean

有关详细说明、参数信息、案例和代码示例,请参阅更新和修复数据源帮助主题。

代码示例

ArcGISProject 示例 1

下面的脚本演示了如何将文档导入到现有 ArcGIS Pro 工程。同时还设置了一些默认工程设置并将结果保存到新文件。

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\blank.aprx")
aprx.importDocument(r"C:\Projects\YosemiteNP\Documents\Yosemite.mxd")
aprx.importDocument(r"C:\Projects\YosemiteNP\Documents\Yosemite_ScenicViews.3dd")
aprx.defaultToolGeoDatabase = r"C:\Projects\YosemiteNP\Data_Vector\YosemiteData.gdb"
aprx.defaultToolbox = r"C:\Projects\YosemiteNP\Analysis\AnalysisTools.tbx"
aprx.saveACopy(r"C:\Projects\YosemiteNP\Yosemite.aprx")

ArcGISProject 示例 2

下面的脚本使用了关键字 current,因此可从 Python 窗口运行此脚本。此脚本打印了工程及其图层中每个地图的名称,以及每个布局的名称及其页面大小。

aprx = arcpy.mp.ArcGISProject("CURRENT")
for m in aprx.listMaps():
    print("Map: " + m.name)
    for lyr in m.listLayers():
        print("  " + lyr.name)
print("Layouts:")
for lyt in aprx.listLayouts():
    print(f"  {lyt.name} ({lyt.pageHeight} x {lyt.pageWidth} {lyt.pageUnits})")

原文地址:https://www.cnblogs.com/gisoracle/p/12313833.html

时间: 02-15

arcgis pro ArcGISProject的相关文章

ArcGIS API for JavaScript 4.2学习笔记[5] 官方API大章节概述与内容转译

内容如上,截图自ESRI官网,连接:ArcGIS API for JavaScript 4.2 [Get Started] 类似于绪论一样的东西,抽取了最需要关注的几个例子.如:加载Map和View,加载layers,使用弹出窗口,视觉化,与使用窗口小部件.(wtf居然没有分析你想搞事情啊web除了展示难道不应该有()&&*--@) [Mapping and Views] (点击进入我写的章节详细介绍) 最基础的,知道地图和视图的区别,能使用2D和3D地图,对地图的布局有一定的了解,对地图

ArcGIS 10.5 named user介绍

1           Named user概述 1.1    Named user简介 Named user是ArcGIS产品自10.3版本正式推出的一种以用户为中心的授权机制,也称"授权用户".获得Named User授权后,用户可以凭借账户密码登入组织.访问资源以及使用各类Apps. 至此,ArcGIS产品常见的授权方式有两种,第一种就是授权机器的方式,也就是按照CPU数,计算核数进行软件购买,比较典型的是ArcGIS Server的授权模式:第二种是Named User的授权模

ArcGIS API for JavaScript 4.2学习笔记[0] AJS4.2概述、新特性、未来产品线计划与AJS笔记目录

放着好好的成熟的AJS 3.19不学,为什么要去碰乳臭未干的AJS 4.2? 诸君,我喜欢嫩的--呸呸呸 诸君,我喜欢3D咋了?新事物会替代旧事物不是~ ArcGIS API for JavaScript 4.2概述 AJS 4.2,即ArcGIS API for JavaScript 4.2,是美国ESRI公司针对WebGIS市场推出的.利用JavaScript和Dojo开发的一款产品,它在2016年12月发布.而AJS 4.0 beta则在一年前就发布了. 关于AJS3和AJS4选择的问题,

ArcGIS 10.3 for Desktop新特性介绍

ArcGIS 10.3是一个完整公布的ArcGIS平台,它包含新的产品(ArcGIS Pro),针对10.2版本号产品进行了功能增强和稳定性的改进. ArcGIS 10.3 for Server新特性介绍 http://blog.csdn.net/linghe301/article/details/31358733 ------------------------------------------------------------------ 版权全部,文章同意转载,但必须以链接方式注明源地

实践 ArcGIS Web 3D

ArcGIS 产品家族的 Web 3D 功能众多用户期待已久.从 ArcGIS 10.3.1 版本号開始,Esri 放了个大招,千呼万唤始出来的 Web 3D 功能,最终不再犹抱琵琶半遮面了. 那究竟怎样将创建和公布3D场景呢? 以下就把今天的測试过程记录下. 測试环境 硬件 处理器:Intel Core i7 4710MQ @ 2.50GHz 内存:16G 显卡:NVIDIA GeForce GT 730M OS Windows 10 Pro 软件 ArcGIS Pro 1.1.1 (必要)

Portal for ArcGIS 资源承载数据类型

在Portal中数据主要分为两大类:Web内容与桌面内容.对于Web内容与桌面内容中的每个项目(item)又被具体分为maps,layers, styles, tools,applications,和 datafiles: 在web内容中,地图对应Web maps,图层对应不同的空间服务内容,工具对应不同的地理处理工具,应用程序对应各种各样的Web和制图应用,数据文件(datafile)对应可以发布为地理服务的内容.在桌面中,地图对应地图包和地图文档,图层对应图层包,工具对应地理处理工具和地址定

GIS制图课程目录(持续整理)

GIS制图课程目录 by 李远祥 由于过去一年都没有进行更新,近期终于抽出时间来进行相关知识的整理,因此,对专项技术进行了不同技术线条的梳理.为了方便阅读,特意整理一下全书的目录结构,希望对读者有帮助.由于Esri推出了ArcGIS Pro 桌面软件,旨在逐步替换传统的ArcMap,因此,在本书中会逐渐加入ArcGIS Pro的教程,部分的制图操作会在ArcGIS Pro中有所体现. [前言] GIS制图课程前言 [理论篇] 理论篇-地图学与GIS制图的基础理论(一) 理论篇-地图学与GIS制图

gis 服务分析总结

服务过程:设计,制作,发布,使用 地图服务: KML服务:地图服务和影像服务也可以通过 Keyhole 标记语言 (KML) 网络链接的形式提供,google earth可访问 制图:图层及其基本属性 可用未用服务: 获取要素: 移动数据访问: 网络分析:交通网分析问题,路径分析:先创建网络分析图层,然后发布 (Schematics 服务)逻辑示意图:服务允许 Web 应用程序通过 Web 服务访问逻辑示意图,查看,生成,更新,编辑逻辑示意图 OGC:客户可通过使用开放并经认可的标准使用服务功能

2014Esri全球用户大会之影像和栅格

1.现在Esri已将影像作为GIS解决方案的一部分,其详细战略部署是如何的? 在过去的十年.Esri有规划的在ArcGIS平台(主要为Desktop和Server)中管理和开发影像和栅格功能.这包含影像管理和服务公布,Desktop和Server中的影像处理增强工具,以及管理大规模影像数据的能力.ArcGIS10.3中.影像技术最大的优化在于将影像处理变得更加简单,用户能够轻松的使用影像,管理影像以及获得有价值的信息产品. ArcGIS平台的多个产品都已经集成了影像功能.包含ArcGIS for

[非官方]ArcGIS10.2 for Desktop扩展工具包——XTools Pro

XTools Pro 是一套为ArcGIS平台设计的矢量空间分析. 形状转换和表管理扩展工具,大大增强了 ArcGIS 的功能,使用该工具能够提高 ArcGIS 用户的效率和性能. XTools Pro 包括矢量空间分析. 形状转换. 并表管理的 70 多个工具和超过 40 地理处理工具.在一个单一的工具栏为 ArcGIS 用户收集的最基本的功能.新的实用工具有助于节省您的时间和提高工作效率! 该工具相当于把ArcGIS Desktop平台软件更加的实用化,业务化,更贴合用户的应用,非常多相似的