Add Bathymetry

摘要

Registers one or more bathymetry datasets described in bathymetry dataset properties (.bdprops) files to a BIS geodatabase, where one bathymetry dataset is described per .bdprops file. A .bdprops file is created using the Define Bathymetry geoprocessing tool. This geoprocessing tool performs in the same way as the Add Bathymetry desktop tool with the difference being that it can be invoked via a Python script or a geoprocessing model, like any other geoprocessing tool. This tool performs a number of validation checks to ensure that no incorrect or duplicate datasets are registered with the BIS geodatabase.

用法

• Turning off the Create backup of Bathymetry Data Index, Generate/update overviews for the Bathymetry Data Index, Update cell size ranges for the Bathymetry Data Index, or Update statistics for the Bathymetry Data Index (requires cell size ranges) parameters could speed up processing, but it also means you must run Diagnose BIS if an error occurs.

• If the Allow datasets defined using a different BIS workspace to be added here parameter is checked, this tool will allow .bdprops files defined using a different BIS workspace to be added to the BIS workspace defined in the tool, as long as the BIS workspaces have matching extended metadata and collection metadata schemas.

语法

AddBathymetry_bathymetry (bis_workspace, in_files, {allow_different_bis}, {ignore_errors}, {create_bdi_backup}, {update_bdi_overviews}, {update_bdi_cell_sizes}, {update_bdi_stats})

参数	说明	数据类型
bis_workspace	The Bathymetric Information System (BIS) geodatabase (.gdb) or a connection (.sde) to the BIS to which the input dataset should be added.	Workspace
in_files [in_files,...]	The input bathymetry dataset properties (.bdprops) files that contain information on the bathymetry datasets to be added to the BIS geodatabase. This parameter accepts one or more files.	File
allow_different_bis (可选)	Indicates whether the tool should accept bathymetry dataset properties files that were generated using a different BIS geodatabase than the one currently selected in the tool. Turning off this parameter could speed processing, but it also means you must run Diagnose BIS if an error occurs. ALLOW_DIFFERENT_BIS —The tool allows you to use datasets from a different BIS workspace. NOT_ALLOW_DIFFERENT_BIS —The tool does not allow you to use datasets from a different BIS workspace. This is the default.	Boolean
ignore_errors (可选)	Indicates whether the tool should ignore failing datasets and continue adding the remaining datasets to the BIS geodatabase. IGNORE_ERRORS —The tool allows you to continue adding datasets even when there is a failure. NOT_IGNORE_ERRORS —The tool does not allow you to continue adding datasets once there is a failure. This is the default.	Boolean
create_bdi_backup (可选)	Indicates whether the tool should create a backup of the Bathymetry Data Index when adding the datasets to the BIS geodatabase. Turning off this parameter could speed processing, but it also means you must run Diagnose BIS if an error occurs. CREATE_BIS_BACKUP —The tool creates a backup of the BIS workspace. This is the default. NOT_CREATE_BIS_BACKUP —The tool does not create a backup of the BIS workspace.	Boolean
update_bdi_overviews (可选)	Indicates whether the tool should update overviews for the Bathymetry Data Index when adding the datasets to the BIS geodatabase. Turning off this parameter could speed processing, but it also means you must run Diagnose BIS if an error occurs. UPDATE_BDI_OVERVIEWS —The tool updates overviews for the BDI when adding datasets. This is the default. NOT_UPDATE_BDI_OVERVIEWS —The tool does not update overviews for the BDI when adding datasets.	Boolean
update_bdi_cell_sizes (可选)	Indicates whether the tool should update cell size ranges for the Bathymetry Data Index when adding the datasets to the BIS geodatabase. Turning off this parameter could speed processing, but it also means you must run Diagnose BIS if an error occurs. UPDATE_BDI_CELL_SIZES —The tool updates cell size ranges for the BDI when adding datasets. This is the default. NOT_UPDATE_BDI_CELL_SIZES —The tool does not update cell size ranges for the BDI when adding datasets.	Boolean
update_bdi_stats (可选)	Indicates whether the tool should update the statistics for the Bathymetry Data Index when adding the datasets to the BIS geodatabase. Turning off this parameter could speed processing, but it also means you must run Diagnose BIS if an error occurs. UPDATE_BDI_STATS —The tool updates the statistics for the BDI when adding datasets. This is the default. NOT_UPDATE_BDI_STATS —The tool does not update the statistics for the BDI when adding datasets.	Boolean

代码实例

AddBathymetry example (stand-alone script)

The following stand-alone script demonstrates how to use the AddBathymetry tool.

# Name: AddBathymetry_Example.py
# Description: Registers a few bathymetry datasets with the BIS geodatabase
# Requirements: ArcGIS for Maritime Bathymetry

import arcpy

# check out the extension
arcpy.CheckOutExtension("Bathymetry")

# set up parameters
bis_workspace = r"C:/Data/BIS.gdb"
in_files = r"C:/Data/NewYork.bdprops;C:/Data/Virginia.bdprops;C:/Data/MontereyBay.bdprops"
allow_different_bis = NOT_ALLOW_DIFFERENT_BIS
ignore_errors = NOT_IGNORE_ERRORS
create_bdi_backup = CREATE_BDI_BACKUP
update_bdi_overviews = NOT_UPDATE_BDI_OVERVIEWS
update_bdi_cell_sizes = NOT_UPDATE_BDI_CELL_SIZES
update_bdi_stats = NOT_UPDATE_BDI_STATS

# execute the tool
arcpy.AddBathymetry_bathymetry(bis_workspace, in_files, allow_different_bis, ignore_errors, create_bdi_backup, update_bdi_overviews, update_bdi_cell_sizes, update_bdi_stats)

环境

• 当前工作空间

许可信息

• ArcGIS for Desktop Basic: 否
• ArcGIS for Desktop Standard: 需要 Maritime Bathymetry
• ArcGIS for Desktop Advanced: 需要 Maritime Bathymetry

有关此主题的反馈?