Extract Depths (Bathymetry)
Summary
Extracts depth point features from a surface created within the Compose Surface window in ArcGIS for Maritime: Bathymetry. Depth features are points sampled from an interpolated raster surface. Point spacing of extracted depth features will be in the planar distance of the input spatial reference.
Depths represent a measurement of the vertical distance from a given water level to the seafloor.
Usage
Use this tool to create data for use with the Depths To ASCII tool.
The BIS Model parameter consists of a mosaic dataset, attributes, display order, and sorting rules. You create and save BIS models in the Compose Surface window in ArcGIS for Maritime: Bathymetry.
The Clipping Feature parameter requires one feature. This can be a single selected feature or a feature layer with a definition query that references one feature. If Clipping Feature is a path to a feature class, that feature class must contain one polygon. You can use the Create Feature Class tool to create a new feature class to store a clipping feature.
The Depths Feature parameter is the location in which the new output feature class will be generated.
Legacy:Prior to 10.1 Service Pack 1, this parameter expected an existing, Z-enabled feature class with certain fields already defined.
If a Bathymetric Attributed Grid (BAG) is used with this tool, both Depth and TPU values are sampled from the BAG's elevation and uncertainty bands. Depth values will be stored as part of each point's geometry, such that the output will be z-enabled, while TPU values will be added to the attribute table.
Syntax
| Parameter | Explanation | Data Type |
bis_workspace |
The Bathymetric Information System (BIS) geodatabase (.gdb) or a connection (.sde) to the BIS database containing the surface model and mosaic dataset. | Workspace |
bis_model_name |
The name of the composite surface in the BIS Workspace. It is prepopulated with a list of names of the models saved in the workspace. | String |
clip_layer |
A feature layer that contains a single polygon clipping feature that defines the feature extraction extent. | Feature Layer |
spacing_value |
The desired spacing between sampled points in the output, in meters. | Double |
depths_layer |
The feature class that will contain the extracted depth features. This tool will output a new, z-enabled point feature class. | Feature Class |
Code Sample
The following stand-alone script demonstrates how to use the ExtractDepths tool.
# Name: ExtractDepths_Example.py
# Description: Extracts point features from a BIS composite surface.
# Requirements: ArcGIS for Maritime Bathymetry
# setup parameters
bisWorkspace = "C:/data/BIS.gdb"
bisModelName = "NewModel"
clipLayer = "C:/data/MyData.gdb/ClipPolyFC"
spacingValue = 50.0
soundingsLayer = "C:/output/Output.gdb/PointFC"
# For a stand-alone scripts, checkout the extension first
arcpy.CheckOutExtension("Bathymetry")
# execute the tool.
arcpy.ExtractDepths_bathymetry(bisWorkspace, bisModelName, clipLayer, spacingValue, soundingsLayer)