Summary
Exports a depth point feature class to an ASCII text file. You can use the ASCII text file for working with depth information in non-GIS systems. Depth point features exported to an ASCII text file will contain the X, Y, and Z locations for each point feature. If a Bathymetric Attribute Grid (BAG) is used in the creation of the Depth feature, the Total Propagated Uncertainty (TPU) value will also be written to the depth feature and exported to the ASCII text file.
Depths represent a measurement of the vertical distance from a given water level to the seafloor.
A BAG is a multidimensional hydrographic data file that models elevation and Total Propagated Uncertainty (TPU) values in a gridded format. It conforms to standards created by the Open Navigation Surface Working Group.
Usage
Use the Extract Depths tool to create the depth features that are going to be exported to ASCII.
The Input Depth Features parameter is a feature layer that references the depth features that will be converted to a text file.
The Input Depth Features parameter requires all of the following attributes: Uncertainty, PrimitiveId, ModelId, BisWorkspacePath, and BisId. These fields will be present if the depth features were created with the Extract Depths tool.
The Output 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.
Syntax
DepthsToASCII_bathymetry (in_features, out_file)
| Parameter | Explanation | Data Type |
in_features | Input points to export to ASCII. | Feature Layer |
out_file | The text file to which features will be written. | File |
Code Sample
DepthsToASCII example (stand-alone script)
The following stand-alone script demonstrates how to use the DepthsToASCII tool.
# Name: DepthsToASCII_Example.py
# Description: Exports a Bathymetry points feature class to an ascii file
# Requirements: ArcGIS for Maritime Bathymetry
import arcpy
# setup parameters
in_features = "C:/data/MyData.gdb/PointFC"
out_file = "C:/output/MyOutput.txt"
# execute the tool. For a stand-alone scripts, check out the extension first - arcpy.CheckOutExtension("Bathymetry")
arcpy.DepthsToASCII_bathymetry(in_features, out_file)
Environments
Licensing Information
- ArcGIS for Desktop Basic: No
- ArcGIS for Desktop Standard: Requires Maritime Bathymetry
- ArcGIS for Desktop Advanced: Requires Maritime Bathymetry