Mechanical Modeler

The Contents of the Specification Container - The Part Feature

What is the Part feature?
Technical Article

Abstract

The article entitled "The Structure of a Part Document" [1] shows that the Part document contains four main containers, one of which is the specification container. This container contains the mechanical features. The mechanical features can be divided in three categories:

  • The Part feature: the main feature containing the design of the object to be built.
  • The geometrical features sets: the features containing either other geometrical features sets, or geometrical features.
  • The geometrical features: those which hold a topological result.

This article is the first of a trilogy. The aim of this one is to detail the first category: what is the Part feature, how is it created, how is it retrieved in a Part document?. The second article [2] details the geometrical features sets: their type, how are they created, how are they retrieved in a Part document. At last, the third article [3] details the geometrical features: their type, the existing features and how they are aggregated by the geometrical features set.  

All of these articles are included in a set of documents presented in the "Mechanical Modeler Overview" article. [4]. 


What is the Part Feature?

The Part feature is the highest feature in a Part document [Fig.1].

Fig.1: The Part Feature 

The Part feature is an instance of the MechanicalPart StartUp. The following diagram [Fig.2] shows this StartUp in the partial view of the mechanical StartUps [5] tree. 

Fig.2: The MechanicalRoot Architecture

At the top there is the MechanicalFeature StartUp. All the mechanical features derive from this StartUp. The MechanicalPart StartUp derives from the MechanicalRoot StartUp such as the HybridBody, the GSMTool, and the Sketch StartUps. The first two StartUps define the geometrical features sets described in the referenced article [2].

[Top]

Part Feature Contents

The Part feature contains the design of the object to be built. It aggregates (directly or indirectly) all the mechanical features of the Part document (except itself). The following UML schema [Fig.3] describes its contents.

Fig.3: The Part Feature Contents

The Part feature aggregates:

Retrieving the Part Feature

The Part feature is retrievable thanks to the CATIPrtContainer (MecModInterfaces) interface implemented on the specification container.

  ...
  CATISpecObject_var spSpecObjectOnPart = pIPrtCont->GetPart();
  ...

where pIPrtCont is the CATIPrtContainer interface pointer on the specification container. Refer to the "Specification Container" section in the "Structure of the Part Document" article [1] to see how to retrieve this pointer.

Retrieving the Reference Planes

Once you have a pointer on the Part, you can retrieve its reference planes using the CATIPrtPart  interface (MecModInterfaces).

  ...
  CATIPrtPart * pIPrtPart = NULL ;
  spSpecObjectOnPart->QueryInterface(IID_CATIPrtPart,(void**) & pIPrtPart ) ;
  CATListValCATISpecObject_var ListRefPlanes = pIPrtPart ->GetReferencePlane();
  ...

ListRefPlanes contains three features which implement the CATIGSMPlane (GSMInterfaces) interface.

The Current Feature

The current feature is the current mechanical feature that you can interactively change with the "Define Object in Work" command. The available interface to retrieve or set the current feature is the CATIPrtPart interface.

[Top]


In Short

The specification container is one of the containers of the Part document. It groups together the mechanical features. One of these is the Part feature. It represents the end user design. It aggregates all the other mechanical features of the Part document.

[Top]


References

[1] The Structure of a Part Document
[2] The Contents of the Specification Container - Geometrical Features Sets
[3] The Contents of the Specification Container - Geometrical Features
[4] Mechanical Modeler Overview
[5] Feature Modeler Overview
[6] MechanicalSet StartUp and Non Geometrical Features
[Top]

History

Version: 1 [Dec 2002] Document created
Version: 2 [Nov 2003] Ordered Geometrical Set Introduction + Open_Body renamed in Geometrical Set 
Version: 3 [May 2004] Document updated for R14 novelties
Version: 4 [Mar 2007] Document updated for R18 novelties - MechanicalSet and MechanicalElements
[Top]

Copyright © 2002, Dassault Systèmes. All rights reserved.