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。
1、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)
2、ListIndexes(dataset, wild_card)
可返回指定數據集中的要素類、shapefile 或表中的索引的列表。
參數說明
dataset
帶有要返回的索引的指定要素類或表。wild_card
限制返回的結果。如果未指定某一值,則返回所有值。通配符不區分大小寫。- * 表示零個或多個字符。
3、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)
4、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
若已指定,則限制返回到要素數據集的要素類。若留空,則在工作空間中將僅返回獨立要素類。
5、ListFiles(wild_card)
返回當前工作空間中的文件列表。
參數說明
wild_card
限制返回的結果。如果未指定某一值,則返回所有值。通配符不區分大小寫。- * 表示零個或多個字符。
6、ListRasters(wild_card, raster_type)
返回當前工作空間中的柵格列表。
參數說明
-
wild_card
限制返回的結果。如果未指定某一值,則返回所有值。通配符不區分大小寫。- * 表示零個或多個字符。
-
raster_type
將限制結果的柵格類型。以下是可用的柵格類型:- BMP —位圖圖形柵格數據集格式。
- GIF —柵格數據集的圖形交換格式。
- IMG — ERDAS IMAGINE 柵格數據格式
- JP2 —JPEG 2000 柵格數據集格式。
- JPG —聯合圖像專家組柵格數據集格式。
- PNG — 可移植網絡圖形柵格數據集格式。
- TIF —柵格數據集的標記圖像文件。
- GRID — 格網數據格式。
- All —返回所有支持的柵格類型。這是默認設置。
(默認值為 All)
7、ListTables(wild_card, table_type)
返回當前工作空間中的表格列表。
參數說明
wild_card
限制返回的結果。如果未指定某一值,則返回所有值。通配符不區分大小寫。- * 表示零個或多個字符。
table_type
用於限制結果的表類型。以下是有效的表類型:- dBASE —僅返回 dBASE 類型的表。
- INFO —僅返回獨立 INFO 表。
- ALL —返回所有獨立表(包括地理數據庫表)。這是默認設置。
(默認值為 All)
8、ListWorkspaces(wild_card, workspace_type)
返回當前工作空間中的工作空間列表。
參數說明
wild_card
限制返回的結果。如果未指定某一值,則返回所有值。通配符不區分大小寫。- * 表示零個或多個字符。
workspace_type
將限制所返回結果的工作空間類型。以下是可用的工作空間類型:- Access —將僅選擇個人地理數據庫。
- Coverage —將僅選擇 coverage 工作空間。
- FileGDB —將僅選擇文件地理數據庫。
- Folder —將僅選擇 shapefile 工作空間。
- SDE —將僅選擇企業級數據庫。
- All —將選擇所有工作空間。這是默認設置。
(默認值為 All)
9、ListVersions(sde_workspace)
列出連接用戶有權使用的版本
參數說明
sde_workspace
企業級地理數據庫工作空間。