gom inspection exchange format v1

GOM Inspection Exchange Format
GOM Inspection Exchange Format
Version 1.03a
1 Introduction.........................................................................4
2 General File Structure.........................................................5
3 User Keywords....................................................................7
4 Primitives.............................................................................8
4.1
Point..............................................................................9
4.2
Line..............................................................................10
4.3
Plane...........................................................................11
4.4
Circle...........................................................................13
4.5
Slotted hole.................................................................14
4.6
Rectangular hole.........................................................16
4.7
Sphere.........................................................................18
4.8
Cylinder.......................................................................19
4.9
Cone............................................................................21
4.10 Polygon hole................................................................23
5 Other Probe Primitives.....................................................25
5.1
Probe border segment.................................................25
5.2
Probe center point.......................................................27
6 Dimensions........................................................................28
Rev. No.: 36
Created by: GOM Support
Page 1 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
6.1
Angle...........................................................................28
6.2
Distance......................................................................30
6.3
Directed distance.........................................................32
6.4
Disc caliper..................................................................33
6.5
Edge caliper................................................................35
7 CMM inspection.................................................................38
7.1
Inspection point...........................................................41
7.2
Vector point.................................................................43
7.3
Edge point (2V)...........................................................45
7.4
Edge point (1V)...........................................................48
7.5
Circle...........................................................................51
7.6
Slotted hole.................................................................54
7.7
Rectangular hole.........................................................58
7.8
Polygon hole................................................................59
7.9
Dimension (scalar)......................................................62
7.10 Distance......................................................................64
7.11 Angle...........................................................................66
7.12 Touch point (disc)........................................................67
7.13 Touch point (edge)......................................................70
7.14 Referenced distance...................................................73
7.15 Referenced symmetric point........................................75
8 Point clouds and sections................................................78
Rev. No.: 36
Created by: GOM Support
Page 2 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
8.1
Point cloud...................................................................78
8.2
Section........................................................................80
8.3
Edge............................................................................81
8.4
Border line...................................................................83
8.5
Tape line......................................................................84
9 Changes.............................................................................86
9.1
Changes in v1.01.........................................................86
9.2
Changes in v1.02.........................................................86
9.3
Changes in v1.03.........................................................86
9.4
Changes in v1.03a.......................................................87
Rev. No.: 36
Created by: GOM Support
Page 3 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
1 Introduction
The file format described by this document is intended to be
used as exchange format for third party software. The format
supports elements of type primitive, probe primitive, dimension
and CMM inspection. Also supported are point clouds and different section types (section, edge, border line, tape line).
Please note, that this file format does not support all elements,
which are available in the GOM software.
The data, which is being exported, contains nominal (i.e. tolerances) and actual measured data, essential 3D drawing information (i.e. position of an angle) and user data (i.e. name of an
element). Again, not all properties (such as visualization color or
label position) are stored in this file format.
Please note, that big point clouds or sections may create huge
file sizes, because this format uses the XML structure to define
its contents. All character strings inside the file format use the
XML quoting and a UTF-8 encoding. The documentation for
XML can be found at www.xml.com or www.xml.org.
To export the data from the GOM software, you have to choose
the menu “File -> Export -> Tables”. Then use the template
“XML -> GOM_XML_v1.03a”.
This file format was introduced with GOM software version
v6.1.1.
There was a XML based format already in v6.0.0 of the GOM
software, but that file format was specialized for measurement
plans. So these two file formats have nothing in common except
using XML.
Rev. No.: 36
Created by: GOM Support
Page 4 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
2 General File Structure
The main structure of this format is
<?xml version="1.0" encoding="UTF-8"?>
<gom>
<header>
<version>1.03a</version>
</header>
<user_keywords>
. . .
</user_keywords>
<elements>
. . .
</elements>
</gom>
The processing instruction in the first line has to reflect the encoding of the file. If the encoding is wrong, some names and
string values may be imported incorrectly. Exported files always
have an UTF-8 encoding.
The root tag is <gom>. There is nothing outside this section except the processing instruction in the first line. The section includes three sub tags:
● <header> includes the version of the file.
●
<user_keywords> includes all keywords.
●
<elements> includes all data of the exported elements.
Each element has its own sub tag (such as
<primitive_point>) and keeps its data inside that sub
tag.
Rev. No.: 36
Created by: GOM Support
Page 5 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
Some general information:
● All lengths are given in millimeters and all angles are given in degrees.
●
●
●
Some tags have an attribute „use“ or „valid“. If those attributes are set to „no“ or „false“, then the tag may contain no data (i.e. <radius valid=“false“></radius>).
This may happen even for elements, which seem to need
that data. For example a CMM inspection circle seems to
need a nominal radius. But elements, which were imported into the GOM software sometimes do not have that information. (For the CMM inspection circle it is possible to
be only interested in the in plane deviation, so no nominal
radius is needed.)
All normals and directions, which occur in the element
data, are normalized, because otherwise these vectors
may become numerically unstable for very short vectors.
There are some XML comments inside the file, which give
a hint if the XML tag's name needs additional explanations.
Rev. No.: 36
Created by: GOM Support
Page 6 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
3 User Keywords
User keywords are arbitrary keywords, which consist of an identifier, a description and a content. Each of these values can be
changed by the user in GOM software. These keywords store
information, which the user wants to add to his project or session (such as who is working on the project and what is the
number of the measured part).
These keywords are defined as follows:
<keyword>
<identifier>identifier</identifier>
<description>description</description>
<content>content</content>
</keyword>
●
<identifier>: This is a unique name (i.e. „insp“). It is
used to reference the keyword within the GOM software, i.e. in snapshots.
●
<description>: A string, that describes the content
(i.e. „Inspector“).
●
<content>: A string, that holds an information about
this project or session (i.e. „J. Doe“).
Rev. No.: 36
Created by: GOM Support
Page 7 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
4 Primitives
The tag name of each type of primitive starts with ''primitive_“.
All types of primitives share the following data:
<primitive_type>
<origin>primitive or probe</origin>
<name>name</name>
<is_nominal>true or false</is_nominal>
<comment>comment</comment>
. . .
<results>
<adjustment>
<maximum valid="true or false">
floating point number
</maximum>
<minimum valid="true or false">
floating point number
</minimum>
<residual valid="true or false">
floating point number
</residual>
<sigma valid="true or false">
floating point number
</sigma>
</adjustment>
</results>
</primitive_type>
These tags contain the following data:
● <origin>: This tag contains a string value: 'primitive' or
'probe'. It informs about the origin of this element (in the
Rev. No.: 36
Created by: GOM Support
Page 8 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
GOM software there are primitives and probe primitives).
For example the primitive point and the probe surface
point are both exported as <primitive_point>. So if
you are interested in the original type of such a <primitive_point>, you can check the <origin> tag.
●
<name>: This tag contains the name of the exported ele-
ment.
●
<is_nominal>: This tag contains a string value: 'true' or
'false'. This string can be used to determine nominal and
actual elements. In the GOM software, you can change
this flag by using the context menus “set as reference”
and “unset reference” in the explorer.
●
<comment>: This tag contains the comment of the expor-
ted element. This is a string, which the user can edit in
the GOM software.
●
<results>: This tag contains the adjustment tag with
floating point numbers for maximum, minimum, residual
and sigma values. Each of these values can be valid or
invalid depending on the valid-attribute.
Remark: Adjustment value availableness depends on
the way the element was created.
4.1 Point
A primitive point is written in the form:
<primitive_point>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
Rev. No.: 36
Created by: GOM Support
Page 9 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_point>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive point:
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the exported 3D point.
4.2 Line
A primitive line is written in the form:
<primitive_line>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<direction valid="true or false">
Rev. No.: 36
Created by: GOM Support
Page 10 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</direction>
<length>floating point number</length>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_line>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive line:
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center of the exported line.
●
<data_3d> - <direction>: This tag contains the
normalized vector of the direction of this line if the valid
attribute is „true“.
●
<data_3d> - <length>: This tag contains the length
of the visualization of the line.
4.3 Plane
A primitive plane is written in the form:
<primitive_plane>
please have a look at page 8 for shared tags
<data_3d>
Rev. No.: 36
Created by: GOM Support
Page 11 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<edge_length>
floating point number
</edge_length>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_plane>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive plane:
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center point of the visualization
of the exported plane.
Rev. No.: 36
Created by: GOM Support
Page 12 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<data_3d> - <normal>: This tag contains the nor-
malized vector of the normal of this plane if the valid attribute is „true“
●
<data_3d> - <edge_length>: This tag contains the
edge length of the visualization of this plane.
4.4 Circle
A primitive circle is written in the form:
<primitive_circle>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<radius>floating point number</radius>
</data_3d>
<results>
please have a look at page 8 for details
Rev. No.: 36
Created by: GOM Support
Page 13 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</results>
</primitive_circle>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive circle:
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center point of the exported
circle.
●
<data_3d> - <normal>: This tag contains the nor-
malized vector of the normal of this circle if the valid attribute is „true“
●
<data_3d> - <radius>: This tag contains the radius
of this circle.
4.5 Slotted hole
A primitive slotted hole is written in the form:
<primitive_slotted_hole>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
Rev. No.: 36
Created by: GOM Support
Page 14 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<y>floating point number</y>
<z>floating point number</z>
</normal>
<direction valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</direction>
<length valid="true or false">
floating point number
</length>
<width valid="true or false">
floating point number
</width>
<radius valid="true or false">
floating point number
</radius>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_slotted_hole>
All shared tags of primitives are described at the beginning of
this chapter.
Rev. No.: 36
Created by: GOM Support
Page 15 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
Other tags for the primitive slotted hole:
● <data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center point of the exported slotted hole.
●
<data_3d> - <normal>: This tag contains the nor-
malized vector of the normal of this slotted hole if the
valid attribute is „true“
●
<data_3d> - <direction>: This tag contains the
normalized vector of the direction of this slotted hole if
the valid attribute is „true“.
●
<data_3d> - <length>: This tag contains the length
of this slotted hole if the valid attribute is „true“.
●
<data_3d> - <width>: This tag contains the width of
this slotted hole if the valid attribute is „true“.
●
<data_3d> - <radius>: This tag contains the radius
of circle at each end of this slotted hole if the valid attribute is „true“.
4.6 Rectangular hole
A primitive rectangular hole is written in the form:
<primitive_rectangular_hole>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
Rev. No.: 36
Created by: GOM Support
Page 16 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<direction valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</direction>
<length valid="true or false">
floating point number
</length>
<width valid="true or false">
floating point number
</width>
<radius valid="true or false">
floating point number
</radius>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_rectangular_hole>
Rev. No.: 36
Created by: GOM Support
Page 17 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive rectangular hole:
● <data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center point of the exported rectangular hole.
●
<data_3d> - <normal>: This tag contains the nor-
malized vector of the normal of this rectangular hole if
the valid attribute is „true“
●
<data_3d> - <direction>: This tag contains the
normalized vector of the direction of this rectangular
hole if the valid attribute is „true“.
●
<data_3d> - <length>: This tag contains the length
of this rectangular hole if the valid attribute is „true“.
●
<data_3d> - <width>: This tag contains the width of
this rectangular hole if the valid attribute is „true“.
●
<data_3d> - <radius>: This tag contains the radius
of circle at each corner of this rectangular hole if the
valid attribute is „true“.
4.7 Sphere
A primitive sphere is written in the form:
<primitive_sphere>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
Rev. No.: 36
Created by: GOM Support
Page 18 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<z>floating point number</z>
</coordinate>
<radius>floating point number</radius>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_sphere>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive sphere:
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center point of the exported
sphere.
●
<data_3d> - <radius>: This tag contains the radius
of this sphere.
4.8 Cylinder
A primitive cylinder is written in the form:
<primitive_cylinder>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
Rev. No.: 36
Created by: GOM Support
Page 19 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</coordinate>
<direction valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</direction>
<radius>floating point number</radius>
<visualization_length>
floating point number
</visualization_length>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_cylinder>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive cylinder:
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center point of the visualized cylinder.
●
<data_3d> - <direction>: This tag contains the
normalized vector of the direction of this cylinder if the
valid attribute is „true“.
●
<data_3d> - <radius>: This tag contains the radius
of this cylinder.
Rev. No.: 36
Created by: GOM Support
Page 20 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<data_3d> - <visualization_length>: This tag
contains the length of the visualization of this cylinder.
4.9 Cone
A primitive cone is written in the form:
<primitive_cone>
please have a look at page 8 for shared tags
<data_3d>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<first_radius>
floating point number
</first_radius>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
<second_radius>
floating point number
</second_radius>
Rev. No.: 36
Created by: GOM Support
Page 21 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<visualization_length>
floating point number
</visualization_length>
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_cone>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive cone:
●
<data_3d> - <first_coordinate>: This tag con-
tains the first x, y, z coordinates of exported cone.
●
<data_3d> - <first_radius>: This tag contains the
first radius of this cone.
Please note, that the cone is not a frustrum. The radius
describes the element but it does not limit it for computations.
●
<data_3d> - <second_coordinate>: This tag con-
tains the second x, y, z coordinates of this cone.
●
<data_3d> - <visualization_length>: This tag
contains the length of the visualization of this cone.
●
<data_3d> - <second_radius>: This tag contains
the second radius of this cone.
Please note, that the cone is not a frustrum. The radius
describes the element but it does not limit it for computations.
Rev. No.: 36
Created by: GOM Support
Page 22 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
4.10 Polygon hole
A primitive polygon hole is written in the form:
<primitive_polygon_hole>
please have a look at page 8 for shared tags
<data_3d>
<number_of_points>
integer number
</number_of_points>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<orientation>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</orientation>
<outer_radius>
floating point number
</outer_radius>
Rev. No.: 36
Created by: GOM Support
Page 23 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</data_3d>
<results>
please have a look at page 8 for details
</results>
</primitive_polygon_hole>
All shared tags of primitives are described at the beginning of
this chapter.
Other tags for the primitive polygon hole:
●
<data_3d> - <number_of_points>: Number of edge
points of this polygon hole. All edges have the same
length.
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center point of the exported
hole.
●
<data_3d> - <normal>: This tag contains the nor-
malized vector of the normal of this hole.
●
<data_3d> - <orientation>: This tag contains the
normalized vector of the direction of the starting point
of this hole.
●
<data_3d> - <outer_radius>: This tag contains the
outer radius of this hole.
Rev. No.: 36
Created by: GOM Support
Page 24 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
5 Other Probe Primitives
Most of the probe primitives are exported as normal primitives
and can only be distinguished from them by the <origin> tag.
This was done because of the similarities of both kinds of elements.
But there are some probe elements, which do not have a similar
element. These probe primitives are the probe border segment
and the probe center point.
The probe border segment is a limited line and the probe center
point is a point of a touch ball.
5.1 Probe border segment
A probe border segment is written in the form:
<probe_border_segment>
please have a look at page 8 for shared tags
<data_3d>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
Rev. No.: 36
Created by: GOM Support
Page 25 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</data_3d>
<results>
<adjustment>
<residual valid="true or false">
floating point number
</residual>
</adjustment>
</results>
</probe_border_segment>
All shared tags of primitives are described at the beginning of
the previous chapter.
Other tags for the probe border segment:
●
<data_3d> – <first_coordinate>
<data_3d> – <second_coordinate>: This tag con-
tains the x, y, z coordinates of the first respectively
second point of the exported border segment. These
are the end points of the limited line.
●
<data_3d> - <normal>: This tag contains the nor-
malized vector of the normal of this border segment if
the valid attribute is „true“.
Rev. No.: 36
Created by: GOM Support
Page 26 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<results> - <adjustment> - <residual>: This
tag contains the residual value. This value can be valid
or invalid depending on the valid-attribute.
5.2 Probe center point
A probe center point is written in the form:
<probe_center_point>
please have a look at page 8 for shared tags
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<touch_ball_radius>
floating point number
</touch_ball_radius>
</data_3d>
</probe_center_point>
All shared tags of primitives are described at the beginning of
the previous chapter.
Other tags for the probe center point:
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates of the center of the exported point.
●
<data_3d> - <touch_ball_radius>: This tag con-
tains the radius of the touch ball.
Rev. No.: 36
Created by: GOM Support
Page 27 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
6 Dimensions
The tag name of each type of dimension starts with
''dimension_“.
All types of dimensions share the following data:
<dimension_type>
<name>name</name>
<is_nominal>true or false</is_nominal>
<comment>comment</comment>
. . .
</dimension_type>
Shared tags:
●
<name>: This tag contains the name of the exported
element.
●
<is_nominal>: This tag contains a string value: 'true'
or 'false'. This string can be used to determine nominal
and actual elements.
●
<comment>: This tag contains the comment of the ex-
ported element. This is a string, which the user can edit
in the GOM software.
6.1 Angle
A dimension angle is written in the form:
<dimension_angle>
please have a look at page 28 for shared tags
<data_3d>
Rev. No.: 36
Created by: GOM Support
Page 28 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<angle>floating point number</angle>
<angle_restriction>
"XYZ, XY, XZ, or YZ"
</angle_restriction>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<first_arm_of_angle>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_arm_of_angle>
<second_arm_of_angle>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_arm_of_angle>
</data_3d>
</dimension_angle>
All shared tags of dimensions are described at the beginning of
this chapter.
Other tags for the dimension angle:
Rev. No.: 36
Created by: GOM Support
Page 29 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<data_3d> - <angle>: This tag contains the angle of
the exported dimension angle.
●
<data_3d> - <angle_restriction>: This tag con-
tains the restriction of the exported dimension angle. If
the restriction is not “XYZ”, then the directions used for
this angle are projected onto the “XY”, “XZ” or “YZ”
plane.
●
<data_3d> - <coordinate>: This tag contains the x,
y, z coordinates for the visualization of the dimension
angle.
●
<data_3d> – <first_arm_of_angle>
<data_3d> – <second_arm_of_angle>: These tags
contain the direction of the angle's arms.
6.2 Distance
A dimension distance is written in the form:
<dimension_distance>
please have a look at page 28 for shared tags
<distance_direction>
"XYZ, XY, XZ, YZ, X, Y or Z"
</distance_direction>
<data_3d>
<length>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
<total>floating point number</total>
Rev. No.: 36
Created by: GOM Support
Page 30 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</length>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
</data_3d>
</dimension_distance>
All shared tags of dimensions are described at the beginning of
this chapter.
Other tags for the dimension distance:
● <distance_direction>: This tag contains the direction of the exported distance. For example the distance
can be restricted to X distance (“X”) or YZ distance
(“YZ”). “XYZ” is the Euclidean distance.
●
<data_3d> - <length>: This tag contains the length
of the exported distance.
●
<data_3d> - <first_coordinate>
<data_3d> - <second_coordinate>: These tags
contain the x, y, z coordinates for visualization of the dimension distance.
Rev. No.: 36
Created by: GOM Support
Page 31 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
6.3 Directed distance
A dimension directed distance is written in the form:
<dimension_directed_distance>
please have a look at page 28 for shared tags
<data_3d>
<distance>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
<total>floating point number</total>
</distance>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<direction>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</direction>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
Rev. No.: 36
Created by: GOM Support
Page 32 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<z>floating point number</z>
</second_coordinate>
</data_3d>
</dimension_directed_distance>
All shared tags of dimension are described at the beginning of
this chapter.
Other tags for the dimension directed distance:
● <data_3d> - <distance>: This tag contains the distance of the exported element.
●
<data_3d> - <first_coordinate>
<data_3d> - <second_coordinate>: These tags
contain the x, y, z coordinates for visualization of the dimension directed distance.
●
<direction>: Starting at <first_coordinate>, this
is the direction of the distance.
6.4 Disc caliper
A dimension disc caliper is written in the form:
<dimension_caliper_disc>
please have a look at page 28 for shared tags
<data_3d>
<length>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
<total>floating point number</total>
Rev. No.: 36
Created by: GOM Support
Page 33 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</length>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
<radius>floating point number</radius>
<visualization_radius>
floating point number
</visualization_radius>
<caliper_type>
"inner or outer"
</caliper_type>
</data_3d>
</dimension_caliper_disc>
All shared tags of dimension are described at the beginning of
this chapter.
Other tags for the dimension disc caliper:
● <data_3d> - <length>: This tag contains the length
of the disc caliper.
Rev. No.: 36
Created by: GOM Support
Page 34 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<data_3d> - <first_coordinate>
<data_3d> - <second_coordinate>: These tags
contain the x, y, z coordinates of the visualization of the
disc caliper.
●
<data_3d> - <radius>: This tag contains the radius
of the disc caliper.
●
<data_3d> - <visualization_radius>: This tag
contains the radius of the visualization of the disc caliper.
●
<data_3d> - <caliper_type>: This tag contains a
value 'inner' or 'outer'. This distinguishes the type of a
disc caliper between inner and outer.
6.5 Edge caliper
A dimension edge caliper is written in the form:
<dimension_caliper_edge>
please have a look at page 28 for shared tags
<data_3d>
<length>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
<total>floating point number</total>
</length>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
Rev. No.: 36
Created by: GOM Support
Page 35 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
<edge_length>
floating point number
</edge_length>
<visualization_edge_length>
floating point number
</visualization_edge_length>
<edge_direction>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</edge_direction>
<caliper_type>
"inner or outer"
</caliper_type>
</data_3d>
</dimension_caliper_edge>
Rev. No.: 36
Created by: GOM Support
Page 36 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
All shared tags of dimension are described at the beginning of
this chapter.
Other tags for the dimension edge caliper:
● <data_3d> - <length>: This tag contains the length
of the edge caliper.
●
<data_3d> - <first_coordinate>
<data_3d> - <second_coordinate>: These tags
contain the x, y, z coordinates of the visualization of the
edge caliper.
●
<data_3d> - <edge_length>: This tag contains the
edge length of the edge caliper.
●
<data_3d> - <visualization_edge_length>: This
tag contains the edge length for visualization of the
edge caliper.
●
<data_3d> - <edge_direction>: This tag contains
the normalized vector of the direction of this edge caliper.
●
<data_3d> - <caliper_type>: This tag contains a
value 'inner' or 'outer'. This distinguishes the type of a
segment caliper between inner and outer.
Rev. No.: 36
Created by: GOM Support
Page 37 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
7 CMM inspection
CMM inspection elements allow a deviation analysis, which is
similar to the deviation analysis known from coordinate measuring machines. These elements have certain nominal values.
The actual values from the measured data can only be used, if
the CMM element was linked to a measured element inside the
GOM software (for example a measured element can be a non
reference primitive or a non reference mesh).
The tag name for each CMM element starts with ''cmm_inspection_“, so the structure is:
<cmm_inspection_type>
. . .
</cmm_inspection_type>
Tags shared by all
All types of CMM elements share the following data:
<name>name</name>
<comment>comment</comment>
●
<name>: This tag contains the name of the exported ele-
ment.
●
<comment>: This tag contains the comment of the expor-
ted element. This is a string, which the user can edit in
the GOM software.
Tags shared by many.
Most of the CMM elements share the following data. Please
have a look at the different element types to find out, which tags
are supported by which element.
Rev. No.: 36
Created by: GOM Support
Page 38 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
Rev. No.: 36
Created by: GOM Support
Page 39 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
</tolerances>
●
●
●
<search_radius>: This tag contains the radius for the
search of measured data, which can be used to make a
comparison with this element.
<rps>: This tag contains the directions, which are used
for registration by reference point system (RPS). Possible
values are: XYZ, XY, XZ, YZ, X, Y and Z.
Please note, that there is a valid attribute, which determines, if this element is used for RPS at all.
<measure_opposite_side>: This can be used for example in sheet metal applications. This tag contains the
offset, if the measured data was created on the opposite
side of the nominal data. The offset is then the thickness
of the material, which the sheet metal consists of.
Please note, that there is a use attribute for this tag.
●
<nominal> - <coordinate>: This tag contains the
nominal x, y, z coordinates of this CMM element.
●
<actual> - <coordinate>: This tag contains the ac-
tual x, y, z coordinates, which are only valid, if an actual element was linked to this CMM element.
●
<tolerances> – <x>
<tolerances> – <y>
<tolerances> – <z>
<tolerances> – <xyz>: This tag contains the upper and
lower limits for the tolerances in x, y, z and xyz direction. The
xyz tolerance is a tolerance for the Euclidean distance. These
tags have a use attribute, which determines, if a tolerance is
used or ignored.
Rev. No.: 36
Created by: GOM Support
Page 40 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
7.1 Inspection point
For the position control using inspection points, nominal points
are compared to the measuring data by means of point projection, and the respective deviations are determined. For this purpose, some inspection point menus provide a selection list for
the projection mode.
An inspection point contains information only about the X, Y and
Z coordinates without vectors and without any special computation requirements.
CMM nominal element inspection point.
The image shows a CMM inspection point after CMM inspection together with its
partner element, the polygonized measuring data. In the 3D view, for this element
always only the nominal point is visible.
The actual point is not shown during CMM inspection and results as intersection
point between the polygonized measuring data and the nominal point projected
onto the measuring data.
An CMM inspection point is written in the form:
<cmm_inspection_point>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<nominal>
<coordinate>
Rev. No.: 36
Created by: GOM Support
Page 41 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
</tolerances>
</cmm_inspection_point>
All shared tags of CMM elements are described at the beginning
of this chapter. Other tags do not exist for this element type.
Rev. No.: 36
Created by: GOM Support
Page 42 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
7.2 Vector point
For the position control using vector points, nominal points are
compared to the measuring data by means of projection of socalled approach vectors (normal vectors), and the respective
deviations are determined.
CMM nominal element vector point
The image shows a CMM vector point after CMM inspection and the polygonized
measuring data. In the 3D view, for this element always the nominal point and the
approach vector are visible.
The actual point is not shown during CMM inspection and results as intersection
point between the polygonized measuring data and the approach vector (normal
vector). For a better understanding, it was inserted into this example image as a
gray point.
An CMM inspection vector point is written in the form:
<cmm_inspection_vector_point>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<nominal>
<coordinate>
Rev. No.: 36
Created by: GOM Support
Page 43 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
Rev. No.: 36
Created by: GOM Support
Page 44 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<spring use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</spring>
</tolerances>
</cmm_inspection_vector_point>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection vector point:
● <nominal> – <normal>: This tag contains the normalized vector of the normal of this vector point.
●
<actual> – <normal>: This tag contains the normal-
ized vector of the actual normal, which was found at
the actual coordinate. It is only valid, if an actual element
was linked to this vector point.
●
<tolerances> – <spring>: This tag contains the up-
per and lower limits for the tolerances in spring direction (here the spring direction is the same as the direction of the normal). This tag has a use attribute, which
determines, if the tolerance is used or ignored.
7.3 Edge point (2V)
For the position control using edge points (2V), nominal edge
points are compared to the actual border line (green) by means
of projecting the so-called trimming and spring vectors (S, T),
and the respective deviations are determined.
The intersection point of the spring and trimming vectors with
the border line is the actual element.
CMM nominal element edge point (2V)
Rev. No.: 36
Created by: GOM Support
Page 45 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
The image shows a CMM edge point (2V) with 2 vectors (trimming T, spring S) together with the corresponding CAD data and the measured border line (green line).
The actual point is not shown during CMM inspection and results as intersection
point between the border line (green line) and the plane (red) on which lie the vectors T and S. For a better understanding, it was inserted into this example image as
a gray point.
An CMM inspection edge point (2V) is written in the form:
<cmm_inspection_edge_point_2v>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<spring>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
Rev. No.: 36
Created by: GOM Support
Page 46 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</spring>
<trimming>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</trimming>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
Rev. No.: 36
Created by: GOM Support
Page 47 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</xyz>
<spring use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</spring>
<trimming use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</trimming>
</tolerances>
</cmm_inspection_edge_point_2v>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection edge point (2V):
●
<nominal> – <spring>
<nominal> – <trimming>: These tags contain the
normalized vectors for the spring and trimming directions.
●
<tolerances> – <spring>
<tolerances> – <trimming>: These tags contain
the upper and lower tolerances for spring and trimming
directions. These tags have a use attribute, which determines, if the tolerance is used or ignored.
●
<actual> - <normal>: This tag contains the normal
of the actual point. The attribute valid determines, if the
normal is available or not.
7.4 Edge point (1V)
For the position control using edge points (1V), nominal edge
points are compared to the actual border line (green) by means
of projecting the so-called trimming vector (T), and the respective deviations are determined.
Rev. No.: 36
Created by: GOM Support
Page 48 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
The intersection point of the trimming vector with the border line
is the actual element. The actual point is not shown during CMM
inspection.
CMM nominal element edge point (1V)
The image shows a CMM edge point (1V) with one vector (trimming T) together
with the corresponding CAD data and the measured border line (green line). The
actual point is not shown during CMM inspection and results as intersection point
between the border line (green line) and the vector T (shortest orthogonal
distance). For a better understanding, it was inserted into this example image as a
gray point.
An CMM inspection edge point (1V) is written in the form:
<cmm_inspection_edge_point_1v>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<trimming>
<x>floating point number</x>
Rev. No.: 36
Created by: GOM Support
Page 49 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<y>floating point number</y>
<z>floating point number</z>
</trimming>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
<trimming use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</trimming>
</tolerances>
</cmm_inspection_edge_point_1v>
Rev. No.: 36
Created by: GOM Support
Page 50 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection edge point (1V):
● <nominal> – <trimming>: This tag contains the normalized direction for trimming.
●
<tolerances> – <trimming>: This tag contains the
upper and lower tolerances for the trimming. This tag
has a use attribute, which determines, if the tolerance
is used or ignored.
7.5 Circle
For the position control using CMM element circle, the nominal
and actual circles are compared and the respective deviation
values are determined.
CMM element circle (shown with nominal and actual elements)
The image shows a CMM circle together with the measured actual element (green).
When comparing circles, the center coordinates and the circle radii are compared.
An CMM inspection circle is written in the form:
<cmm_inspection_circle>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
Rev. No.: 36
Created by: GOM Support
Page 51 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<radius valid="true or false">
floating point number
</radius>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<radius>floating point number</radius>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
Rev. No.: 36
Created by: GOM Support
Page 52 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
<spring use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</spring>
<in_plane use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</in_plane>
<diameter use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</diameter>
</tolerances>
</cmm_inspection_circle>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection circle:
● <nominal> – <normal>: This tag contains the normals of the nominal circle.
Rev. No.: 36
Created by: GOM Support
Page 53 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<nominal> – <radius>: This tag contains the radius
of the nominal circle.
Please note, that there is a valid attribute for this tag.
(For example, this is useful, if only an in plane tolerance has to be checked.)
●
<actual> – <normal>: This tag contains the normal
of the measured element. It is only valid, if an actual element was linked to this element.
●
<actual> – <radius>: This tag contains the radius of
the measured element. It is only valid, if an actual element was linked to this element.
●
<tolerances> – <spring>
<tolerances> – <in_plane>
<tolerances> – <diameter>: These tags contain
the upper and lower tolerances for spring, in plane and
diameter. This tag has a use attribute, which determines, if the tolerance is used or ignored.
7.6 Slotted hole
For the position control using CMM element slotted hole, the
nominal and actual slotted holes are compared and the respective deviation values are determined.
CMM element slotted hole (shown with nominal and actual elements)
The image shows a CMM slotted hole together with the measured actual element
(green).
When comparing slotted holes, the center coordinates are compared, as well as
the length and width of the hole.
Rev. No.: 36
Created by: GOM Support
Page 54 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
An CMM inspection slotted hole is written in the form:
<cmm_inspection_slotted_hole>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<direction valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</direction>
<length valid="true or false">
floating point number
</length>
<width valid="true or false">
floating point number
</width>
</nominal>
Rev. No.: 36
Created by: GOM Support
Page 55 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<direction valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</direction>
<length valid="true or false">
floating point number
</length>
<width valid="true or false">
floating point number
</width>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
Rev. No.: 36
Created by: GOM Support
Page 56 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
<spring use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</spring>
<in_plane use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</in_plane>
<length use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</length>
<width use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</width>
</tolerances>
</cmm_inspection_slotted_hole>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection slotted hole:
●
<nominal> – <normal>
<nominal> – <direction>
<nominal> – <length>
<nominal> – <width>: These tags contain the nor-
mals of the center point, the direction of the center line
and the length and width of the slotted hole.
Please note, that there is a valid attribute for most of
Rev. No.: 36
Created by: GOM Support
Page 57 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
these tags. If a valid attribute is set to false, then the
according nominal value is not available.
●
<actual> – <normal>
<actual> – <direction>
<actual> – <length>
<actual> – <width>: These tags contain the normals
of the center point, the direction of the center line and
the length and width of the measured slotted hole. It is
only valid, if an actual element was linked to this element.
●
<tolerances> – <spring>
<tolerances> – <in_plane>
<tolerances> – <length>
<tolerances> – <width>: These tags contain the
upper and lower tolerances for spring, in plane, lenght
and width. This tag has a use attribute, which determines, if the tolerance is used or ignored.
7.7 Rectangular hole
For the position control using CMM element rectangular hole,
the nominal and actual rectangular holes are compared and the
respective deviation values are determined.
CMM element rectangular hole (shown with nominal and actual elements)
The image shows a CMM rectangular hole together with the measured actual element (green).
When comparing rectangular holes, the center coordinates are compared, as well
as the length and width of the hole.
Rev. No.: 36
Created by: GOM Support
Page 58 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
An CMM inspection rectangular hole is written in the form like
an CMM inspection slotted hole.
<cmm_inspection_rectangular_hole>
please have a look at the form of inspection
slotted hole
</cmm_inspection_rectangular_hole>
7.8 Polygon hole
For the position control using CMM element polygon hole, the
nominal and actual holes are compared and the respective deviation values are determined.
An CMM inspection polygon hole is written in the form:
<cmm_inspection_polygon_hole>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<number_of_points>
integer number
</number_of_points>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
Rev. No.: 36
Created by: GOM Support
Page 59 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<orientation valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</orientation>
<outer_radius valid="true or false">
floating point number
</outer_radius>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<orientation>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</orientation>
<outer_radius>
floating point number
</outer_radius>
</actual>
<tolerances>
<x use="yes or no">
Rev. No.: 36
Created by: GOM Support
Page 60 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
<spring use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</spring>
<in_plane use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</in_plane>
<incircle_diameter use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</incircle_diameter>
</tolerances>
</cmm_inspection_polygon_hole>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection polygon hole:
● <number_of_points>: Number of edge points of this
polygon hole. All edges have the same length.
Rev. No.: 36
Created by: GOM Support
Page 61 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<nominal> – <normal>: This tag contains the nor-
mals of the nominal hole.
●
<nominal> – <orientation>: This tag contains the
orientation of the starting point of the nominal hole.
Please note, that there is a valid attribute for this tag.
(For example, this is useful, if only a xyz tolerance has
to be checked.)
●
<nominal> – <outer_radius>: This tag contains the
outer radius of the nominal hole. Please note, that
there is a valid attribute for this tag. (For example, this
is useful, if only a xyz tolerance has to be checked.)
●
<actual> – <normal>: This tag contains the normal
of the measured element.
●
<actual> – <orientation>: This tag contains the orientation of the starting point of the actual hole.
●
<actual> – <outer_radius>: This tag contains the
radius of the measured element. It is only valid, if an actual element was linked to this element.
●
<tolerances> – <spring>
<tolerances> – <in_plane>
<tolerances> – <incircle_diameter>: These tags
contain the upper and lower tolerances for spring, in plane
and inner diameter. Each tag has a use attribute, which determines, if the tolerance is used or ignored.
7.9 Dimension (scalar)
Dimension inspection compares mere distance values, i.e. it is
checked to what extent a nominal value corresponds to the
measured value (actual). The actual elements may be of the
type distance, circle, slotted hole, sphere, cylinder or rectangular hole.
Rev. No.: 36
Created by: GOM Support
Page 62 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
An CMM inspection distance (scalar) is written in the form:
<cmm_inspection_distance_scalar>
<name>name</name>
<comment>comment</comment>
<nominal>
<length>floating point number</length>
</nominal>
<actual valid="true or false">
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
</actual>
<tolerances>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
</tolerances>
</cmm_inspection_distance_scalar>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection distance (scalar):
● <nominal> - <length>: This tag contains the nominal length.
●
<actual> - <first_coordinate>
<actual> - <second_coordinate>: These tags con-
Rev. No.: 36
Created by: GOM Support
Page 63 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
tain the x, y, z coordinates of first and second point of
this distance.
7.10 Distance
Distance inspection compares distance dependent distance values, i.e. it is checked to what extent a nominal value corresponds to the measured value (actual). The actual elements can
be of the type distance.
An CMM inspection distance is written in the form:
<cmm_inspection_distance>
<name>name</name>
<comment>comment</comment>
<nominal>
<length>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</u>
<total>floating point number</total>
</length>
</nominal>
<actual valid="true or false">
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
Rev. No.: 36
Created by: GOM Support
Page 64 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
</tolerances>
</cmm_inspection_distance>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection distance:
● <nominal> - <length>: This tag contains the nominal length. The length is splitted into x, y, z and total. So
the check of the distance can be restricted to a certain
direction (for example x).
●
<actual> - <first_coordinate>
<actual> - <second_coordinate>: These tags con-
tain the x, y, z coordinates of the first and second point
of this distance.
Rev. No.: 36
Created by: GOM Support
Page 65 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
7.11 Angle
Angle inspection compares angles, i.e. it is checked to what extent a nominal angle corresponds to the measured angle (actual). The actual elements must be of the type angle
An CMM inspection angle is written in the form:
<cmm_inspection_angle>
<name>name</name>
<comment>comment</comment>
<nominal>
<angle>floating point number</angle>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<first_arm_of_angle>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_arm_of_angle>
<second_arm_of_angle>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_arm_of_angle>
</actual>
<tolerances>
<angle use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
Rev. No.: 36
Created by: GOM Support
Page 66 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</angle>
</tolerances>
</cmm_inspection_angle>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection angle:
● <nominal> - <angle>: This tag contains the nominal
angle.
●
<actual> – <coordinate>
<actual> – <first_arm_of_angle>
<actual> – <second_arm_of_angle>: These tags
contain the x, y, z coordinates of the angle point and
both directions of the arms of the angle.
●
<tolerances> - <angle>: This tag contains the up-
per and lower tolerances for the angle. This tag has a
use attribute, which determines, if the tolerance is used
or ignored.
7.12 Touch point (disc)
Touch point (disc) projects a circular plane onto primitives, point
clouds, sections, 3D meshes, ... and creates a point at the location of the initial touch. The function is similar to the disc caliper
with the difference that here the result is a point instead of a distance.
An CMM inspection touch point (disc) is written in the form:
<cmm_inspection_touch_point_disc>
<name>name</name>
<comment>comment</comment>
<search_radius>
Rev. No.: 36
Created by: GOM Support
Page 67 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<project_on_center_line>
"true or false"
</project_on_center_line>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<touch_direction>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</touch_direction>
<clearance>
floating point number
</clearance>
<radius>floating point number</radius>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
Rev. No.: 36
Created by: GOM Support
Page 68 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<touch use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</touch>
</tolerances>
</cmm_inspection_touch_point_disc>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection touch point (disc):
● <project_on_center_line>: This tag determines, if
the resulting point should be projected on the center
line of this element, which is defined by the coordinate
and the touch direction.
●
<nominal> – <coordinate>: This tag contains the x, y,
z coordinates of the starting point.
●
<nominal> – <touch_direction>: This tag contains
the normalized direction, in which the disc will be moved.
●
<nominal> – <clearance>: This tag contains a distance, which will be used to move the disc into the opposite
direction, before touching a measured element will be
tested.
●
<nominal> – <radius>: This tag contains the radius
of the disc.
Rev. No.: 36
Created by: GOM Support
Page 69 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<actual> – <coordinate>: This tag contains the x,
y, z coordinates where a collision with the linked measured element was detected.
●
<tolerances> - <touch>: This tag contains the up-
per and lower tolerances for touch. This tag has a use
attribute, which determines, if the tolerance is used or
ignored.
7.13 Touch point (edge)
Touch point (edge) projects an edge onto 3D meshes, primitives, point clouds, sections, ... and creates a point at the location of the initial touch. The function is similar to the edge caliper
with the difference that here the result is a point instead of a distance.
An CMM inspection touch point (edge) is written in the form:
<cmm_inspection_touch_point_edge>
<name>name</name>
<comment>comment</comment>
<search_radius>
floating point number
</search_radius>
<rps valid="true or false">string</rps>
<measure_opposite_side use="yes or no">
floating point number
</measure_opposite_side>
<project_on_center_line>
"true or false"
</project_on_center_line>
<nominal>
<coordinate>
<x>floating point number</x>
Rev. No.: 36
Created by: GOM Support
Page 70 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<touch_direction>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</touch_direction>
<edge_direction>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</edge_direction>
<clearance>
floating point number
</clearance>
<edge_height>
floating point number
</edge_height>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
Rev. No.: 36
Created by: GOM Support
Page 71 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<touch use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</touch>
</tolerances>
</cmm_inspection_touch_point_edge>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection touch point (edge):
● <project_on_center_line>: This tag determines, if
the resulting point should be projected on the center
line of this element, which is defined by the coordinate
and the touch direction.
●
<nominal> – <coordinate>: This tag contains the x,
y, z coordinates of the starting point.
●
<nominal> – <touch_direction>: This tag contains
the normalized direction, in which the edge will be moved.
●
<nominal> – <edge_direction>: This tag contains
the normalized direction of the edge.
●
<nominal> – <clearance>: This tag contains a distance, which will be used to move the edge into the opposite direction, before touching a measured element will be
tested.
●
<nominal> – <edge_height>: This tag contains the
height of the edge.
Rev. No.: 36
Created by: GOM Support
Page 72 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<actual> – <coordinate>: This tag contains the x,
y, z coordinates where a collision with the linked measured element was detected.
●
<tolerances> - <touch>: This tag contains the up-
per and lower tolerances for touch. This tag has a use
attribute, which determines, if the tolerance is used or
ignored.
7.14 Referenced distance
With referenced distances you may perform a distance control
with assigned CMM elements, e.g. vector point or circle.
A CMM inspection referenced distance is written in the form:
<cmm_inspection_referenced_distance>
<name>name</name>
<comment>comment</comment>
<direction>
"XYZ, XY, XZ, YZ, X, Y or Z"
</direction>
<nominal>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
</nominal>
<actual valid="true or false">
Rev. No.: 36
Created by: GOM Support
Page 73 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
</tolerances>
</cmm_inspection_referenced_distance>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection referenced distance:
Rev. No.: 36
Created by: GOM Support
Page 74 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<direction>: This tag contains the direction (xyz, xy,
xz, yz, x, y, or z), which is relevant for comparison. The
xyz direction means the Euclidean distance.
●
<nominal> – <first_coordinate>
<nominal> – <second_coordinate>: These tags
contain the x, y, z coordinates of the nominal elements
of the referenced CMM elements.
●
<actual> – <first_coordinate>
<actual> – <second_coordinate>: These tags con-
tain the x, y, z coordinates of the actual elements of the
referenced CMM elements.
7.15 Referenced symmetric point
With Referenced symmetric point you may create a symmetric
point between two assigned CMM elements, e.g. vector point or
circle.
A CMM inspection referenced symmetric point is written in the
form:
<cmm_inspection_referenced_symmetric_point>
<name>name</name>
<comment>comment</comment>
<nominal>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
Rev. No.: 36
Created by: GOM Support
Page 75 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
</nominal>
<actual valid="true or false">
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<first_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</first_coordinate>
<second_coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</second_coordinate>
</actual>
<tolerances>
<x use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</x>
<y use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</y>
<z use="yes or no">
Rev. No.: 36
Created by: GOM Support
Page 76 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</z>
<xyz use="yes or no">
<upper_limit>float</upper_limit>
<lower_limit>float</lower_limit>
</xyz>
</tolerances>
</cmm_inspection_referenced_symmetric_point>
All shared tags of CMM elements are described at the beginning
of this chapter.
Other tags for the CMM inspection symmetric point:
● <nominal> – <coordinate>: This tag contains the x,
y, z coordinates of the symmetric point, which was created from the nominal elements of the referenced CMM
elements.
●
<nominal> – <first_coordinate>: This tag con-
tains the nominal x, y, z coordinates of the first referenced CMM element.
●
<nominal> – <second_coordinate>: This tag con-
tains the nominal x, y, z coordinates of the second referenced CMM element.
●
<actual> – <coordinate>: This tag contains the x,
y, z coordinates of the symmetric point, which was created from the actual elements of the referenced CMM
elements.
●
<actual> – <first_coordinate>: This tag contains
the actual x, y, z coordinates of the first referenced
CMM element.
●
<actual> – <second_coordinate>: This tag con-
tains the actual x, y, z coordinates of the second referenced CMM element.
Rev. No.: 36
Created by: GOM Support
Page 77 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
8 Point clouds and sections
The tag name for point clouds is “point_cloud“ and the tag name
of each type of section element starts with ''section_“.
All these elements share the following data:
<element_type number_of_points="integer">
<name>name</name>
<is_nominal>true or false</is_nominal>
<comment>comment</comment>
. . .
</element_type>
●
<element_type number_of_points=”integer”>:
The attribute number_of_points says how many points belong to this element.
●
<name>: This tag contains the name of the exported
element.
●
<is_nominal>: This tag contains a string value: 'true'
or 'false'. This string can be used to determine nominal
and actual elements.
●
<comment>: This tag contains the comment of the ex-
ported element. This is a string, which the user can edit
in the GOM software.
8.1 Point cloud
A point cloud is written in the form:
<point_cloud number_of_points="integer">
please have a look at page 78 for shared tags
Rev. No.: 36
Created by: GOM Support
Page 78 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<point>
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</data_3d>
</point>
</point_cloud>
All shared tags of point clouds are described at the beginning of
this chapter.
Other tags for the point cloud:
● <point>: This tag contains all data, that belongs to
one point of the point cloud.
●
<point> - <data_3d> - <coordinate>: This tag
contains the x, y, z coordinates of each point.
●
<point> - <data_3d> - <normal>: This tag con-
tains the normalized vector of the normal of each point.
Rev. No.: 36
Created by: GOM Support
Page 79 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
8.2 Section
A section is written in the form:
<section_section number_of_points="integer">
please have a look at page 78 for shared tags
<point id="integer">
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</data_3d>
</point>
</section_section>
All shared tags of sections are described at the beginning of this
chapter.
Other tags for the section:
●
<point>: This tag contains all data, that belongs to one
point of the section. The attribute id contains an integer
value, which is the number of that point.
Rev. No.: 36
Created by: GOM Support
Page 80 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
All points are exported in ascending order of the id attribute.
●
<point> - <data_3d> - <coordinate>: This tag
contains the x, y, z coordinates of each point.
●
<point> - <data_3d> - <normal>: This tag con-
tains the normalized vector of the normal of each point.
8.3 Edge
A section edge is written in the form:
<section_edge_section number_of_points="integer">
please have a look at page 78 for shared tags
<point id="integer">
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
<trimming valid="true or false">
<x>floating point number</x>
Rev. No.: 36
Created by: GOM Support
Page 81 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<y>floating point number</y>
<z>floating point number</z>
</trimming>
<edge_normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</edge_normal>
<edge_trimming valid="true or
false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</edge_trimming>
</data_3d>
</point>
</section_edge_section>
All shared tags of section are described at the beginning of this
chapter.
Other tags for the section edge:
●
<point>: This tag contains all data, that belongs to one
point of the section. The attribute id contains an integer
value, which is the number of that point.
All points are exported in ascending order of the id attribute.
Rev. No.: 36
Created by: GOM Support
Page 82 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
<point> - <data_3d> - <coordinate>: This tag
contains the x, y, z coordinates of each point.
●
<point> - <data_3d> - <normal>: This tag con-
tains the normalized vector of the normal of each point.
Note:The normal values are the same as the spring
values.
●
<point> - <data_3d> - <trimming>: This tag con-
tains the normalized vector of the trimming direction of
each point.
●
<point> - <data_3d> - <edge_normal>: This tag
contains the normalized vector of the normal of the
edge, which is following the point.
Note:The normal values are the same as the spring
values.
●
<point> - <data_3d> - <edge_trimming>: This
tag contains the normalized vector of the trimming direction of the edge, which is following the point.
8.4 Border line
A border line is written in the form:
<section_border_line number_of_points="integer">
please have a look at page 78 for shared tags
<point id="integer">
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
Rev. No.: 36
Created by: GOM Support
Page 83 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</data_3d>
</point>
</section_border_line>
All shared tags of section are described at the beginning of this
chapter.
Other tags for the border line:
●
<point>: This tag contains all data, that belongs to one
point of the section. The attribute id contains an integer
value, which is the number of that point.
All points are exported in ascending order of the id attribute.
●
<point> - <data_3d> - <coordinate>: This tag
contains the x, y, z coordinates of each point.
●
<point> - <data_3d> - <normal>: This tag con-
tains the normalized vector of the normal of each point.
8.5 Tape line
A tape line is written in the form:
<section_tape_line number_of_points="integer">
please have a look at page 78 for shared tags
<point id="integer">
Rev. No.: 36
Created by: GOM Support
Page 84 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
<data_3d>
<coordinate>
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</coordinate>
<normal valid="true or false">
<x>floating point number</x>
<y>floating point number</y>
<z>floating point number</z>
</normal>
</data_3d>
</point>
</section_tape_line>
All shared tags of sections are described at the beginning of this
chapter.
Other tags for the tape line:
●
<point>: This tag contains all data, that belongs to one
point of the section. The attribute id contains an integer
value, which is the number of that point.
All points are exported in ascending order of the id attribute.
●
<point> - <data_3d> - <coordinate>: This tag
contains the x, y, z coordinates of each point.
●
<point> - <data_3d> - <normal>: This tag con-
tains the normalized vector of the normal of each point.
Rev. No.: 36
Created by: GOM Support
Page 85 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
9 Changes
9.1 Changes in v1.01
●
●
The disc caliper and segment caliper don't have the
tags <is_inner> and <is_outer> anymore. They
were replaced with the tag <caliper_type>.
The point clouds and sections now have a valid attribute for the normal vector.
9.2 Changes in v1.02
●
●
●
●
●
Now the cylinder exports the center point of the axis
and the direction is normalized (error in the exported
file).
The slotted hole and rectangular hole (probe primitives)
export the center coordinate as <coordinate> and not
as <center_coordinate> (error in the exported file).
The slotted hole and rectangular hole (primitives and
probe primitives) now export the normalized direction of
their center line (error in the exported file).
The tolerances for the CMM inspection circle now all
contain the tags <upper_limit> and <lower_limit>
(error in the exported file).
The value for <measure_opposite_side> (used in
most of the CMM inspection elements) will now always
use exactly 6 post decimal positions.
9.3 Changes in v1.03
●
<probe_border_segment> and <probe_center_point>
now export the <origin> tag (error in the exported file).
●
The <normal> tag in the <probe_border_segment> now
has an attribute valid.
Rev. No.: 36
Created by: GOM Support
Page 86 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a
GOM Inspection Exchange Format
●
●
●
●
The documentation of the <angle_restriction> tag for
the <dimension_angle> is now corrected and completed.
The <dimension_directed_distance> was missing the
data for the direction. New tag <direction> added.
The <cmm_inspection_edge_point_2v> now has a
<normal> tag in the <actual> section.
The
<cmm_inspection_referenced_symmetric_point>
now contains the tags <first_coordinate> and
<second_coordinate> in the <nominal> and the <actual> sections.
●
●
●
The <cmm_inspection_touch_point_disc> and the
<cmm_inspection_touch_point_edge> now contain the
tag <project_on_center_line>.
The <section_edge_section> contains now the tags
<edge_trimming> and <edge_normal>. These tags contain the trimming and normal vectors of the edges
between the points.
There are two new element types
<primitive_polygon_hole> and
<cmm_inspection_polygon_hole>.
9.4 Changes in v1.03a
●
In this documentation the elements <point_cloud>,
<section_section>, <section_edge_section>,
<section_border_line> and <section_tape_line>
were missing the number_of_points attribute.
Rev. No.: 36
Created by: GOM Support
Page 87 of 87
Created: 02/13/08
Last modified at: 07/23/08
GOM Insp. Exchange Format
v1.03a