File Format - XYZ
File Format - XYZ
Purpose
XYZ is a bathymetry data format used by HAPI for sounding data import and export.
General Architecture
XYZ is comma-delimited and follows a Northing-Easting-Level layout. It does not carry ordinary Point Code, Point Number, Rotation, or Point Name metadata.
Delimited Anatomy
| Index | Field | Meaning |
|---|---|---|
[0] | Northing | Y-coordinate. |
[1] | Easting | X-coordinate. |
[2] | Raw Level | Bathymetry sounding value. |
Depth Rule
The old file-format note states that positive sounding values should be inverted in memory:
Z Coordinate = Raw Level * -1.0
Forced Metadata
| Field | Injected Value | Reason |
|---|---|---|
| Point Code | P | Treat as a random level point. |
| Point Number | 0 | Dummy value; sounding points do not carry point numbers. |
| Rotation | 0 | No rotation is available. |
| Point Name | Empty string | No point name is available. |
Styling Override
XYZ bathymetry data should use depth-style treatment rather than ordinary level-style mapping. The old note states that the base Symbol Level Type should be set to Depth.
Related Scripts
Source Basis
HAPI User Manual.pdf, Sections 2.3.1 and 2.3.4.File Format - XYZ File.md.
