Extract Depths To ASCII (Bathymetry)
摘要
Extracts depths from a surface model stored in a BIS workspace and converts depths to an ASCII file. This model allows you to share your depths with non-Esri software packages. This model runs Extract Depths and Depths To ASCII to create an output feature class and ASCII file.
用法
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 ASCII File parameter references a text file that contains X, Y, Z, and uncertainty attributes from a BIS points feature class. Uncertainty can vary depending on the type of BAG. Depth derived from a BAG created for navigation would specify elevation uncertainty.
-
Before you can run this model, you will need to have done the following:
- Generate a surface model from bathymetry data managed in your BIS.
- Create a polygon feature whose geometry will be the clipping area or the area in which the depths will be extracted from.
语法
| 参数 | 说明 | 数据类型 |
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 [BIS_Model,...] |
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 |
Clipping_Feature |
A feature layer that contains a single polygon clipping feature that defines the feature extraction extent. | Feature Layer |
Spacing__m_ |
The desired spacing between sampled points in the output, in meters. | Double |
Depths_Feature |
The feature class that will contain the extracted depth features. This tool will output a new, z-enabled point feature class. | Feature Class |
ASCII_File |
The text file to which features will be written. | File |
代码实例
The following Python window script demonstrates how to use the ExtractDepthstoASCII tool.
# Name: ExtractingDepthstoASCII_Example.py
# Description: Extracts depths from a surface model and writes them to an ASCII file.
# Requirements: ArcGIS for Maritime Bathymetry
# Import the arcpy module
import arcpy
# reference the BIS workspace
bisWS = "C:/Data/BIS/MyBIS.gdb"
# reference the surface model
surfaceModel = "My Model"
# point to the clipping feature class
clippingFC = "C:/Data/AOI/AOI.gdb/ClippingFC"
# Define the depth spacing value in meters
depthSpacing = 25
# point to where the Depths feature class will be created
depthFC = "C:/Data/BIS/MyBIS.gdb/Depths"
# Define the ASCII file name and where it will get written to
asciiFile = "C:/Data/Output/Depths2ASCII.txt"
# execute the Extract Depths to ASCII model
arcpy.ExtractDepthstoASCII_bathymetry(bisWS, surfaceModel, clippingFC, depthSpacing, depthFC, asciiFile)
print "Successfully extracted depths to the ASCII file"