DATAKIT SDK  V2026.2
General Mapping (Base Module)


Step Header

Header Field DATAKIT Class Remarks
FILE_SCHEMA.name
FileVersion of Dtk_Component + Dtk_MetaData with title "Header : Schema" See
See Dtk_Component::GetFileVersion
See Dtk_MetaData::GetTitle
FILE_DESCRIPTION.description Dtk_MetaData on Dtk_Component with title "Header : Description" See Dtk_MetaData::GetTitle
FILE_NAME.author Dtk_MetaData on Dtk_Component with title "Header : Author" See Dtk_MetaData::GetTitle
FILE_NAME.organization Dtk_MetaData on Dtk_Component with title "Header : Organization" See Dtk_MetaData::GetTitle
FILE_NAME.preprocessor_version Dtk_MetaData on Dtk_Component with title "Header : Preprocessor Version" See Dtk_MetaData::GetTitle
FILE_NAME.originating_system Dtk_MetaData on Dtk_Component with title "Header : Originating System" See Dtk_MetaData::GetTitle
FILE_NAME.authorization Dtk_MetaData on Dtk_Component with title "Header : Authorization" See Dtk_MetaData::GetTitle
FILE_NAME.time_stamp Dtk_MetaData on Dtk_Component with title "Header : Time Stamp" See Dtk_MetaData::GetTitle
FILE_NAME.name Dtk_MetaData on Dtk_Component with title "Header : File Name" See Dtk_MetaData::GetTitle
FILE_NAME.implementation_level Dtk_MetaData on Dtk_Component with title "Header : Implementation Level" See Dtk_MetaData::GetTitle


Assembly

STEP Entities DATAKIT Class Remarks
shape_definition_representation Dtk_Component of type PrototypeComponentType See Dtk_Component::ComponentType
shape_representation with axis_placement item(s) Dtk_Node Root Dtk_Node of the Dtk_Component
shape_representation with other cases of item(s) One Dtk_Node per item

property_definition_representation + shape_representation_with_parameters Dtk_Component of type PrototypeComponentType + parameters as Dtk_MetaData No geometry
See Dtk_Component::ComponentType
field ID of product Name of the Dtk_Component if ID is not defined, field name is used
Field priority can be changed using StepReader::SetComponentNameMode
next_assembly_usage_occurence Dtk_Component of type InstanceComponentType

Also called NAUO
See Dtk_Component::ComponentType

item_defined_transformation Dtk_transfo Position (matrix)
cartesian_transformation_operator Dtk_transfo Position (matrix)
applied_document_reference + document Dtk_Component External reference to another file
product_definition_relationship + product_definition_with_associated_documents + document_file Dtk_Component of type InstanceComponentType An alternate way with external reference, origin Smaragd (PDM)
additive_manufacturing_setup Dtk_Component of type PrototypeComponentType + Attribute "DtkStep_PRODUCT_TYPE" of its Dtk_Info
AP242E2
additive_manufacturing_setup_relationship : sub-types Dtk_Component of type InstanceComponentType + Attribute "DtkStep_INSTANCE_TYPE" of its Dtk_Info
AP242E2
The model split in several STEP files Attribute "Step_ExternalReferences" in root Dtk_Component Dtk_Info Values can be "MONOLITHIC" , "BASIC_REFERENCES" or "NESTED_REFERENCES"
The model has several roots or missing products Attribute "Step_AddedItem" in root Dtk_Component Dtk_Info Values can be "ORPHAN_GEOMETRIES" or "SEVERAL_ROOTS"
The geometry/topology doesn't belong to a product Attribute "Step_AddedItem" in Dtk_Info of its Dtk_Node

Value is "ORPHAN_GEOMETRY"


BRep Entities

STEP Entities DATAKIT Class Remarks
manifold_solid_brep Dtk_Body, 1 Dtk_Volume, 1 Dtk_Shell (closed) See its closed_shell
brep_with_void Dtk_Body, 1 Dtk_Volume, list of Dtk_Shell (closed) One per closed_shell : outer and inner(s)
shell_based_surface_model Dtk_Body, Dtk_Shell(s) (open or closed) See open_shell or closed_shell
face_based_surface_model Dtk_Body, 1 Dtk_Shell per face (open) Faces are not connected
geometric_set Dtk_Body, content see each type of item Faces are not connected
closed_shell Dtk_Shell (closed)  
oriented_closed_shell Dtk_Shell (closed)  
open_shell Dtk_Shell (open)  
connected_face_set Dtk_Shell

 


Face and Trimmings

STEP Entities DATAKIT Class Remarks
face_surface Dtk_Face  
advanced_face Dtk_Face  
face_bound Dtk_Loop Inner or outer
face_outer_bound Dtk_Loop Outer
edge_loop List of Dtk_Edge in Dtk_Loop of the face_bound / face_outer_bound  
oriented_edge Dtk_Coedge  
edge_curve Dtk_Edge  
surface_curve Dtk_Coedge With only pcurve, no 3D curve
seam_edge Dtk_Edge + 2 Dtk_Coedge Both coedges on a same face
curve_bounded_surface Dtk_Face No connectivity is coded
composite_curve Dtk_Loop  
composite_curve_on_surface Dtk_Loop  
composite_curve_segment Dtk_Edge + Dtk_Coedge  


Surfaces

STEP Entities DATAKIT Class Remarks
b_spline_surface and sub-types Dtk_NurbsSurface Sub-types can be : rational or not, with or without knots, uniform
bezier_surface Dtk_NurbsSurface  
conical_surface Dtk_ConicalSurface  
cylindrical_surface Dtk_CylindricalSurface  
offset_surface Dtk_OffsetSurface  
plane Dtk_PlaneSurface  
spherical_surface Dtk_SphericalSurface  
surface_of_revolution Dtk_StandardRevolutionSurface or Dtk_RevolutionSurface According to Dtk_API::IsReversedRevolutionActivated
surface_of_linear_extrusion Dtk_LinearExtrusionSurface  
toroidal_surface Dtk_ToroidalSurface  
rectangular_trimmed_surface Same as its basis surface Trimming added
surface_replica Same as its basis surface Moved after conversion
rectangular_composite_surface
- -
Not processed


Curves

STEP Entities DATAKIT Class Remarks
line Dtk_Line  
circle Dtk_Ellipse As a circle (one radius)
ellipse Dtk_Ellipse  
hyperbola Dtk_Hyperbola  
parabola Dtk_Parabola  
offset_curve_3d Dtk_NurbsCurve  
b_spline_curve and sub-types Dtk_NurbsCurve Sub-types : rational or not, with or without knots, uniform
bezier_curve Dtk_NurbsCurve  
trimmed_curve on a line Dtk_Line with start-end point Trimming added
trimmed_curve (other than line) Same as its basis curve Trimming added
curve_replica Same as its basis curve Moved after conversion
pcurve Curve (see above) in a Dtk_Coedge

Specifies a curve as UV on a Face


Wireframe

STEP Entities DATAKIT Class Remarks
geometric_set , geometric_curve_set Dtk_Body, one Dtk_Lump per item Set of curves or points
shape_definition_representation + property_definition named "CATIA Geometric Set" + shape_aspect + shape_representation with list of items Dtk_Body, one Dtk_Lump per item From STEP written by Catia ("geometric set" of Catia)
cartesian_point Dtk_Point  
composite_curve Dtk_Shell , open containing a Wire The Wire contains one Dtk_Curve per segment
composite_curve_segment Subtype of Dtk_Curve According to the type of curve


Mesh

STEP Entities DATAKIT Class Remarks
faceted_brep_model Dtk_mesh
AP203 and AP214
face_surface : case of a triangle A triangle in a Dtk_mesh_face One Dtk_mesh_face gathers all triangles of same color
face_surface (not a triangle) Dtk_mesh_face with one mockup If not a triangle
face_bound + polyline A polygon in the mockup of the Dtk_mesh_face  
cartesian_point A vertex in the Dtk_mesh  
tessellated_shape_representation Dtk_mesh
AP242
tessellated_shape_representation_with_accuracy_parameters Dtk_mesh + Tessellation parameters as attribute "Dtk_tesselation_[X]" in its Dtk_Info
AP242E2

[X] can be LinearTol, AngleTol, Ratio or MaxSize
tessellated_geometric_set Fills the Dtk_mesh (general case)
AP242
coordinates_list The vertices of a Dtk_mesh
AP242
tessellated_solid or tessellated_shell Fills the Dtk_mesh (surfacic)
AP242
tessellated_solid or tessellated_shell containing cubic_bezier_triangulated_face Fills the Dtk_mesh (surfacic) + Attribute "DtkMesh_BZ3" in Dtk_Info
AP242E2
triangulated_face , triangulated_surface_set Dtk_mesh_face (surfacic : triangles only)
AP242
complex_triangulated_face , complex_triangulated_surface_set Dtk_mesh_face (surfacic : triangles, fans, strips)
AP242
cubic_bezier_triangulated_face Dtk_mesh_face (triangles) + Attribute "DtkMesh_BZ_[i]" in Dtk_Info
AP242E2

[i] from 0 to 9 (10 points of Bezier patch)
tessellated_edge , tessellated_connecting_edge Dtk_mesh_face : boundary polylines on a face
AP242
tessellated_wire Fills the Dtk_mesh (wireframe)
AP242
tessellated_curve_set Dtk_mesh_face : Polyline
AP242
tessellated_point_set , tessellated_vertex Fills the Dtk_mesh (points)
AP242
+ repositioned_tessellated_item Moves the Dtk_mesh to a position
AP242


Graphical Attributes

STEP Entities DATAKIT Class Remarks
styled_item + presentation_style_assignment Attachment of graphical attribute in Dtk_Info of a Dtk_Entity  
surface_style_usage Attribute Color in Dtk_Info Style data on face or shell or solid
See Dtk_Info::GetColor
draughting_pre_defined_color Attribute Color in Dtk_Info Values can be black, white, red, green, blue, yellow, magenta or cyan
colour_rgb Dtk_RGB Color defined as R,G,B values
pre_defined_curve_font Attribute CurveLineType in Dtk_Info See Dtk_Info::GetCurveLineType
curve_style Attribute Color, CurveLineType and CurveThicknessInMM in Dtk_Info Gathers style data on free curve
See Dtk_Info::GetColor and Dtk_Info::GetCurveLineType and Dtk_Info::GetCurveThicknessInMM
pre_defined_marker or marker_type Attribute PointSymbolType in Dtk_Info See Dtk_Info::GetPointSymbolType
point_style Attribute Color, PointSymbolType and CurveThicknessInMM in Dtk_Info Gathers style data on free point
See Dtk_Info::GetColor and Dtk_Info::GetPointSymbolType and Dtk_Info::GetCurveThicknessInMM
presentation_layer_assignment Attribute Layer in Dtk_Info General case : defined with a number
See Dtk_Info::GetLayer
presentation_layer_assignment Attribute Layer in Dtk_Info + information in Dtk_LayerInfosSet See Generalities about entity attributes on how to retrieve layer name based on its ID
invisibility Attribute BlankedStatus in Dtk_Info See Dtk_Info::GetBlankedStatus
surface_style_transparent , surface_style_rendering_with_properties A() in Attribute Color of Dtk_Info Recorded as A = 1 - transparency
context_dependent_over_riding_styled_item with only one level of instance Graphical attributes on a Dtk_Component of type Instance

More than 1 level : not supported


Other attributes

STEP Entities DATAKIT Class Remarks
v5_uuid_attribute Attribute PersistentName in Dtk_Info and attribute Uuid in Dtk_Info
From AP242E4

See Dtk_Info::GetPersistentName() and Dtk_Info::GetUuid()
Available for Dtk_Component, Dtk_Body, Dtk_Face, Dtk_Edge, Dtk_Vertex, Dtk_Fdt

Properties and Metadata

STEP Entities DATAKIT Class Remarks
product , field name Dtk_MetaData on Dtk_Component with title "Nomenclature" See Dtk_MetaData::GetTitle
product , field description Dtk_MetaData on Dtk_Component with title "Description" See Dtk_MetaData::GetTitle
product_definition , field definition Dtk_MetaData on Dtk_Component with title "Definition"

See Dtk_MetaData::GetTitle

product_definition_with_associated_documents , field definition 4 Dtk_MetaData on Dtk_Component with titles : "DtkStep_PRODUCT_DEF_DOCUMENT_ID", "DtkStep_PRODUCT_DEF_DOCUMENT_NAME", "DtkStep_PRODUCT_DEF_DOCUMENT_DESCRIPTION" and "DtkStep_PRODUCT_DEF_DOCUMENT_TYPE"

See Dtk_MetaData::GetTitle
Sub-type of product_definition

product_definition_formation , field revision Dtk_MetaData on Dtk_Component with title "Revision" See Dtk_MetaData::GetTitle
product_definition_formation_with_specified_source , field source Dtk_MetaData on Dtk_Component with title "Source". Value can be "made" or "bought"
See Dtk_MetaData::GetTitle
Sub-type of product_definition_formation
product_definition_context , field life_cycle_stage Dtk_MetaData on Dtk_Component with title "LifeCycleStage" See Dtk_MetaData::GetTitle
global_unit_assigned_context : length_unit ConceptionUnitScale of Dtk_Component See Dtk_Component::GetConceptionUnitScale
global_unit_assigned_context : plane_angle_unit Attribute Dtk_ConceptionAngleUnit in Dtk_Info of the Dtk_Component (radian)  
global_uncertainty_assigned_context , uncertainty_measure_with_unit (length) Dtk_MetaData on Dtk_Component with title "Uncertainty"

Value is a real in MM
See Dtk_MetaData::GetTitle

property_definition_representation + property_definition pointing on product_definition_shape Attribute "PDR.name : PDR.representation.name : item.name" in Dtk_Info Value : see below (Dtk_Val)
descriptive_representation_item Dtk_Val of type DTK_VAL_TYPE_STRING See Dtk_Val::GetValType
boolean_representation_item Dtk_Val of type DTK_VAL_TYPE_INT
AP203E2 and later

See Dtk_Val::GetValType
integer_representation_item Dtk_Val of type DTK_VAL_TYPE_INT
AP203E2 and later

See Dtk_Val::GetValType
real_representation_item Dtk_Val of type DTK_VAL_TYPE_DOUBLE
AP203E2 and later

See Dtk_Val::GetValType
value_representation_item (count_measure or numeric_measure) Dtk_Val of type DTK_VAL_TYPE_INT or DTK_VAL_TYPE_DOUBLE See Dtk_Val::GetValType
measure_representation_item and sub-types Dtk_Val of type DTK_VAL_TYPE_STRING : "real unit" E.g. "1000 mm3"
Unit : mm, kg or s. Others are ignored
See Dtk_Val::GetValType
one cartesian_point Dtk_Val of type DTK_VAL_TYPE_PNT See Dtk_Val::GetValType
one direction Dtk_Val of type DTK_VAL_TYPE_DIR See Dtk_Val::GetValType
coordinates_list Several Dtk_Val of type DTK_VAL_TYPE_PNT Names as " : 1", " : 2", etc
See Dtk_Val::GetValType
make_from_usage_option A Dtk_Node Virtual with Dtk_MetaData (for id and name)
- Alone : attached to the Dtk_Component
- With a shape_definition_representation (designating a body) : attached to a Dtk_Node Dtk_Body
 
property_definition_representation + property_definition applied on a product
Dtk_MetaData on Dtk_Component Controlled by configuration, see StepReader::SetModeProperty
By default, title is "PDR.name : PDR.representation.name : item.name"
If only PDR.name is defined, title is "PDR.Name"
property_definition_representation + property_definition associated to a shape_aspect associated to an item mapped to a Dtk_Body
Dtk_MetaData on Dtk_Body

Controlled by configuration, see StepReader::SetModeProperty
By default, title is "PDR.name : PDR.representation.name : item.name"
If only PDR.name is defined, title is "PDR.Name"


Remarks about this mapping

- If you encounter "Undefined" as the FileVersion of your Dtk_Component, it means the FILE_SCHEMA.name of the input STEP file is not correctly defined. In that case, we launch the reading process using the more recent schema available (currently AP242), because of STEP backward compatibility.
(2) - As described in ISO/TS 10303-442 AP242 managed model based 3d engineering - EXPRESS MIM Long form.