tops_landxml – LandXML¶
New in version 0.6.
Description¶
LandXML is committed to providing an non-proprietary data standard (LandXML), driven by an consortium of partners for the inter-operability of data utilized within the Land Development industry.
The official documentation about the format is provided on the LandXML website.
LandXML is a specialized XML (eXtensible Mark-up Language) data file format containing civil engineering and survey measurement data commonly used in the Land Development and Transportation Industries.
LandXML structure¶
LandXML use a schema which specifies how to formally describe the elements of the document. The schema currently used is version 1.2.
Units tag¶
Currently, the header of the XML file will always be:
<?xml version="1.0"?>
<LandXML xmlns="http://www.landxml.org/schema/LandXML-1.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.landxml.org/schema/LandXML-1.2 http://www.landxml.org/schema/LandXML-1.1/LandXML-1.1.xsd" date="" time="" version="1.1">
<Units>
<Metric areaUnit="squareMeter" linearUnit="meter" volumeUnit="cubicMeter" temperatureUnit="celsius" pressureUnit="milliBars" angularUnit="grads" directionUnit="grads"></Metric>
</Units>
<Project name="Template"></Project>
<Application name="TotalOpen Station" desc="TOPS" manufacturer="" version="" manufacturerURL="http://tops.iosa.it/" timeStamp=""></Application>
</LandXML>
Metric is choosed as the default unit system. If one need Imperial, ask for it in the bug tracker.
Tags and attributs¶
| Tag | Attribut | Value | Parent tag |
|---|---|---|---|
| Survey | |||
| SurveyHeader | Survey | ||
| name | “from TOPS” | Survey | |
| Equipment | Survey | ||
| CgPoints | Survey | ||
| CgPoint | x y [z] | CgPoints | |
| name | point_name | ||
| pntRef | pid | ||
| featureRef | “feature” + point_name | ||
| Feature | CgPoint | ||
| name | “feature” + point_name | CgPoint | |
| Property | Feature | ||
| “attrib” + index | attrib[index] | ||
| InstrumentSetup | Survey | ||
| id | “setup” + id | ||
| stationName | point_name | ||
| instrumentHeight | ih | ||
| orientationAzimuth | hz0 | ||
| Feature | InstrumentSetup | ||
| name | “feature” + point_name | CgPoint | |
| Property | Feature | ||
| “attrib” + index | attrib[index] | ||
| InstrumentPoint | instru_x instru_y instru_z | InstrumentSetup | |
| pntRef | pid | ||
| ObservationGroup | Survey | ||
| id | “o” + id | ||
| setupID | “setup” + id | ||
| Backsight | ObservationGroup | ||
| circle | circle | ||
| BacksightPoint | back_x back_y back_z | Backsight | |
| name | back_name | ||
| RawObservation | ObservationGroup | ||
| setupID* | “setup” + id | ||
| azimuth | azimuth | ||
| horizAngle | angle | ||
| zenithAngle | z_angle | ||
| slopeDistance | dist | ||
| horizDistance | dist | ||
| targetHeight | th | ||
| TargetPoint | x y [z] | RawObservation | |
| desc | point_name | ||
| pntRef | pid | ||
| Feature | RawObservation | ||
| Property | Feature | ||
| instrumentHeight | ih | ||
| edmAccuracyppm | ppm | ||
| edmAccuracyConstant | prism_constant | ||
| “attrib” + index | attrib[index] |
/* Not implemented
Annotations¶
- Units :
- All angular and direction values default to radians unless otherwise noted. Angular values, expressed in the specified Units.angleUnit are measured counter-clockwise from east=0. Horizontal directions, expressed in the specified Units.directionUnit are measured counter-clockwise from 0 degrees = north.
- CgPoints :
- A collection of COGO points. (Cg = COGO = Cordinate Geometry).
- InstrumentSetup :
- The Instrument setup location is defined by either a coordinate text value (“north east” or “north east elev”) or a CgPoint number reference “pntRef” attribute.
- ObservationGroup :
- All observations to the same point in a group should be averaged together (they have consistant orientation).
- TargetPoint :
- Represents a 2D or 3D location for the target. It is defined by either a coordinate text value (“north east” or “north east elev”) or a CgPoint number reference “pntRef” attribute.