Extract Depths (Bathymetry)
Récapitulatif
Extracts depth point features from a surface created within the Compose Surface window in ArcGIS for Maritime : Bathymétrie. 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.
Utilisation
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 : Bathymétrie.
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.
Héritage :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.
Syntaxe
| Paramètre | Explication | Type de données |
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 [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 |
Exemple de code
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)