ArcPy数据列表遍历
批处理脚本的首要任务之一是为可用数据编写目录,以便在处理过程中可以遍历数据。
ArcPy 具有多个专为创建此类列表而构建的函数。
函数 | 说明 |
---|---|
ListFields(dataset, wild_card, field_type) | 返回在输入值中找到的字段的列表 |
ListIndexes(dataset, wild_card) | 返回在输入值中找到的属性索引的列表 |
ListDatasets(wild_card, feature_type) | 返回当前工作空间中的数据集 |
ListFeatureClasses(wild_card, feature_type, feature_dataset) | 返回当前工作空间中的要素类 |
ListFiles(wild_card) | 返回当前工作空间中的文件 |
ListRasters(wild_card, raster_type) | 返回在当前工作空间中找到的栅格数据的列表 |
ListTables(wild_card, table_type) | 返回在当前工作空间中找到的表的列表 |
ListWorkspaces(wild_card, workspace_type) | 返回在当前工作空间中找到的工作空间的列表 |
ListVersions(sde_workspace) | 返回已连接用户有权使用的版本的列表 |
注意:必须先设置工作空间环境,然后才能使用多个列表函数,包括 ListDatasets、ListFeatureClasses、ListFiles、ListRasters、ListTables 和 ListWorkspaces。
ListFields(dataset, wild_card, field_type)
可返回指定数据集中的要素类、shapefile 或表中的字段的列表。返回的列表可用针对名称和字段类型的搜索条件进行限制,并将包含字段对象。
参数说明
-
dataset
带有要返回的字段的指定要素类或表。 -
wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。- * 表示零个或多个字符。(默认值为 None)
-
field_type
要返回的指定字段类型。以下是可用的字段类型:- All — 返回所有字段类型。这是默认设置。
- BLOB —仅返回 BLOB 字段类型。
- Date —仅返回日期字段类型。
- Double —仅返回双精度字段类型。
- Geometry —仅返回几何字段类型。
- GlobalID —仅返回 GlobalID 字段类型。
- GUID —仅返回 GUID 字段类型。
- Integer —仅返回整型字段类型。
- OID —仅返回 OID 字段类型。
- Raster —仅返回栅格字段类型。
- Single —仅返回单精度字段类型。
- SmallInteger —仅返回短整型字段类型。
- String —仅返回字符串字段类型。
(默认值为 All)
ListIndexes(dataset, wild_card)
可返回指定数据集中的要素类、shapefile 或表中的索引的列表。
参数说明
+dataset
带有要返回的索引的指定要素类或表。
+wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。
- * 表示零个或多个字符。
ListDatasets(wild_card, feature_type)
返回当前工作空间中的数据集的列表。可针对数据集名称和数据集类型指定搜索条件,从而限制返回的列表。
参数说明
+wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。
- * 表示零个或多个字符。
+feature_type
限制由 wild_card 参数返回的结果的数据集类型。以下是可用的数据集类型: - Coverage —仅 coverage。
- Feature —coverage 或地理数据库数据集(取决于工作空间)。
- GeometricNetwork —仅几何网络数据集。
- Mosaic —仅镶嵌数据集。
- Network —仅网络数据集。
- ParcelFabric —仅宗地结构数据集。
- Raster —仅栅格数据集。
- RasterCatalog —仅栅格目录数据集。
- Schematic —仅逻辑示意图数据集。
- Terrain —仅 terrain 数据集。
- Tin —仅 TIN 数据集。
- Topology —仅拓扑数据集。
- All —工作空间中的所有数据集。这是默认值。
(默认值为 All)
ListFeatureClasses(wild_card, feature_type, feature_dataset)
可返回当前工作空间中受名称、要素类型和可选要素数据集限制的要素类的列表。
参数说明
-
wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。- * 表示零个或多个字符。
-
feature_type
将限制结果的要素类型。下表中列出了一些有效要素类型:- Annotation —注记要素类
- Arc —弧(或折线)要素类
- Dimension —尺寸要素类
- Edge —边要素类
- Junction —交汇点要素类
- Label — 标注要素类
- Line —折线(或弧)要素类
- Multipatch —多面体要素类
- Multipoint —多点要素类
- Node —节点要素类
- Point —点要素类
- Polygon —面要素类
- Polyline —折线(或弧)要素类
- Region —区域要素类
- Route —路径要素类
- Tic —控制点要素类
- All — 工作空间中的所有要素类。这是默认设置。
(默认值为 All)
-
feature_dataset
若已指定,则限制返回到要素数据集的要素类。若留空,则在工作空间中将仅返回独立要素类。
ListFiles(wild_card)
返回当前工作空间中的文件列表。
参数说明
-
wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。- * 表示零个或多个字符。
ListRasters(wild_card, raster_type)
返回当前工作空间中的栅格列表。
参数说明
-
wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。- * 表示零个或多个字符。
-
raster_type
将限制结果的栅格类型。以下是可用的栅格类型:- BMP —位图图形栅格数据集格式。
- GIF —栅格数据集的图形交换格式。
- IMG — ERDAS IMAGINE 栅格数据格式
- JP2 —JPEG 2000 栅格数据集格式。
- JPG —联合图像专家组栅格数据集格式。
- PNG — 可移植网络图形栅格数据集格式。
- TIF —栅格数据集的标记图像文件。
- GRID — 格网数据格式。
- All —返回所有支持的栅格类型。这是默认设置。
(默认值为 All)
ListTables(wild_card, table_type)
返回当前工作空间中的表格列表。
参数说明
-
wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。- * 表示零个或多个字符。
-
table_type
用于限制结果的表类型。以下是有效的表类型:- dBASE —仅返回 dBASE 类型的表。
- INFO —仅返回独立 INFO 表。
- ALL —返回所有独立表(包括地理数据库表)。这是默认设置。
(默认值为 All)
ListWorkspaces(wild_card, workspace_type)
返回当前工作空间中的工作空间列表。
参数说明
-
wild_card
限制返回的结果。如果未指定某一值,则返回所有值。通配符不区分大小写。- * 表示零个或多个字符。
-
workspace_type
将限制所返回结果的工作空间类型。以下是可用的工作空间类型:- Access —将仅选择个人地理数据库。
- Coverage —将仅选择 coverage 工作空间。
- FileGDB —将仅选择文件地理数据库。
- Folder —将仅选择 shapefile 工作空间。
- SDE —将仅选择企业级数据库。
- All —将选择所有工作空间。这是默认设置。
(默认值为 All)
ListVersions(sde_workspace)
列出连接用户有权使用的版本
参数说明
-
sde_workspace
企业级地理数据库工作空间。