Data Import from HeXML

Description

Import data from Leica equipment that uses the Hexagon XML format (HeXML).

Access

Home / Data / Import / HeXML

Requirements

Xchange Leica Survey module

Options

The following properties allow control of the import.

General	Description
Import Measurements	Select to import raw total station measurements and level measurements.
Import Images	Select to import photos referenced in the file.
Measurement Date Attribute	Type the name of the attribute where you want the measurement date to be placed.
Coding	Description
Process Codes	Select the checkbox to process feature codes, control codes and string numbers to create lines and polygons.
Join Consecutive Points	Select the checkbox to join all points with the same code that are measured consecutively.
Control Codes	Select the control code table to be used to process control codes.
String Number Attribute	Type the name of the attribute that contains the string number to be used when codes are processed.
Transformation	Description
Apply Transformation	Do one of the following: Select Yes (Scaled) to compute a scaled transformation using points with the same name and apply it to all points in the imported file. Select Yes (Unscaled) to compute an unscaled transformation using points with the same name and apply it to all points in the imported file. Select No to import the points in the file without a transformation. Note: A 2D Conformal with Height transformation is computed if at least one matched point pair has known heights. A 2D Conformal transformation is computed if all matched point pairs have at least one unknown height.
Save Transformation	Select the checkbox to save the computed transformation to the project.
Points	Description
Name Format	Add a prefix or suffix to rename points imported from the file. Note: {0} represents the current point name. Type a character before {0} to add a prefix. Type a character after {0} to add a suffix.
Name Offset	Add a numeric offset to the numeric component of the names of imported points.
Adopt Existing	Do one of the following to manage points with the same name: Select the checkbox to adopt a point in the project in preference to importing a point from the file when points with the same name are encountered. Clear the checkbox to import all points from the file. Points with the same name may be created in the project.
Lookup Tables	Description
Layer	Select the Layer lookup table to be used during the import.
Attribute Definition	Select the Attribute Definition lookup table to be used during the import.
Line Style	Select the Line Style lookup table to be used during the import.

A blank selection for a lookup table indicates that no lookup will be performed.

Notes

A code group is imported as a layer group.
Each code in a code list is imported as a layer and placed in the appropriate layer group.
Points are placed on layers according to their code.
Point attributes are added to the attribute definition for the appropriate layer.
Attributes with the name specified in String Number Attribute are not imported.
Imported lines are placed on the active layer.
If codes are processed on import, point codes with string attributes are joined regardless of the layers Intended Use for the line.
If consecutive points are joined on import, points with the same code are joined when the layers Intended Use is set to Lines or Polygons providing the point is not already part of a line sequence created from control codes or string id's.
If the data file uses freecodes to enter control codes, the free code must precede the point that requires the control code.
To import a line as a breakline, prior to import, for the active layer, in the layers General tab, set Breakline to Yes.
Northing and Easting coordinates imported for level stations are approximate only.
The level measurement methods supported are BF, BFFB, BFBF, BBFF, aBF, aBFFB.
View raw total station measurements and level measurements in the Measurements view.
Place images in the folder specified in the imported file.
Point name matching is performed prior to re-naming.
Transformations are computed and applied only when measurements are imported.
The name of the saved transformation file is included in the import report.
Geodetic coordinates are imported providing the project has a defined coordinate system and projection and no other coordinates exist for the point.
Import of scan data is currently not supported.
If the geoid model referenced in the HeXML file cannot be found, you will be prompted for the location of the geoid model. If you cannot locate the geoid model, the Default Geoid Undulation specified in the projects coordinate systems Earth Constants is used.
The location of the previously used geoid models is saved for future imports.
If the HeXML job does not reference a geoid model, the geoid model specified in the projects coordinate system will be used in preference to the Default Geoid Undulation.

Possible errors

Error or Warning	Description
The input coordinate system '%1' does not match the project coordinate system '%2'.	The coordinate system name referenced in the imported data file has a different name to the coordinate system configured for the project. Ensure the coordinate systems are equivalent.
Geoid file '%1' not found.	The geoid file referenced in the imported data file was not located. Set the location of the geoid model file in the Import options, or navigate to the files location when the open dialog displays prompting you for the geoid models location.
Default geoid separation used for point '%1'.	The geoid file referenced in the imported data file was not located. The default geoid separation will be used.
The input geoid model '%1' does not match the project geoid model '%1'.	The geoid file referenced in the imported data file was located however it has a name and file name that is different to the geoid model specified for the project. If the two geoid models are equivalent then ignore the message.You should ensure that the geoid model you select for the projects coordinate system is equivalent to the geoid model used to collect your data.