Mechanical Modeler

A Description of Update Errors

Using CATIUpdateError and CATMfErrUpdate
Technical Article

Abstract

The aim of this article is to explain the errors generated by the Update mechanism [1] on mechanical features. It is included in a set of articles which describe the Mechanical Modeler and which are  presented in the "Mechanical Modeler Overview" [2] article.


What is an Update Error ?

During the update of a mechanical feature [3] [4] an error can occur. This error is an Update error which has blocked the construction of the geometry. The end-user can correct the error by modifying one or several parameters of the feature. The error is associated with the feature during the generation of its result, in other words in the Build method of the CATIBuild [5] interface

Let's take the simple example of an EdgeFillet feature. If its radius is too big, the Update generates an error and the following dialog box appears [Fig.1]. 

Fig.1:Update Error on Edge Fillet

This dialog box displays the error diagnosis in the column of same name, and it is described in more detail at the bottom of the panel. It is possible to edit the wrong feature to correct the error. In the next section, you will see how to retrieve this diagnosis and get other information about the error.

[Top]

CATIUpdateError 

To analyze the error whether in batch mode or in an interactive session, you should use the CATIUpdateError (MechanicalModeler) interface. The methods to use are the following and in this order:

The CATIUpdateError  interface has other methods, but they are useful only for the CATIBuild [5] implementation.

[Top]

CATMfErrUpdate

This class is instantiated in the Build method of the CATIBuild or CATIBuildShape interface. It enables you to transmit information about the error.

Retrieve the Sick Features

The sick features are the features at the root of the error. Take a look at the next example to help you

Fig.2: Pad Feature

At the first of all there is a Pad with a fillet set on two edges (left picture). Next, the Sketch is edited to replace the support edge of the fillet by a broken edge (right picture). When exiting the Sketcher editor, the following dialog box [Fig. 3] appears to notify you of an update error on the EdgeFillet.1 feature.

Fig.3: Sick Feature

The dialog box displays the Edge.1 feature that you need to edit to modify. Edge.1 is a sick feature for the EdgeFilllet.1 feature. By editing the Edge.1 feature, the error can be corrected.

For a single error several sick features may be involved. The CATMfErrUpdate class has three methods that can be used to retrieve these sick features:

The next figure [Fig.4]  illustrates these three methods: 

Fig.4: Chained Sick Features

In this example, Error1 has two sick features: feature2 and feature3, while Error3 , associated with feature3, has feature4 as a sick feature. Error4, associated with feature4, has itself the feature5 as a sick feature.

Retrieve the NLS Error Messages 

The following set of methods can be used:

Cyclical Errors

Let's take a look at the following example in order to understand the cyclical errors. First we have a PartBody with three Pads: Pad.2 created on the upper face of Pad.1 and Pad.3 created on the upper face of Pad.2 [Fig.5]. Next, Pad.1 is moved to be placed after Pad.3. [Fig.6.]

Fig.5: Pads
Fig.6:Cyclicite Error

[Top]

Error Propagation

With the Dassault Systemes features, the error propagation follows the update path. Here are two examples that illustrate this: the first for the solid and surfacic features set update (Body/PartBody) [Fig.7] and the second for the surfacic features set  case (OGS/GS) [Fig.8].

Fig.7: Solid and Surfacic Features Set Update

In this example, you can notice that the error is propaged from the EdgeFillet  to its aggregating feature, the PartBody, as well as to the Part. The Part update implies the PartBody update and the EdgeFillet update.

Fig.8: Surfacic Features Set Update

In the surfacic example above, the error propagation is clearly not the same as the path of the aggregation. The Point.1 feature has an update error, but GeomSet.1, its aggregating set, has no error. However,  Line.1 and GeomSet.2 do have an update error.

For the CAA feature the error propagation depends on the CATIBuild [5] implementation. 

[Top]


In Short

During the update of a mechanical feature an error can occur. This error blocks the construction of the topology of the feature and can be corrected by editing the underlying sick features or the feature itself. 

[ Top]


References

[1] Feature Modeler Overview
[2] Mechanical Modeler Overview
[3] The Contents of the Specification Container - Geometrical Features Sets
[4] The Contents of the Specification Container - Geometrical Features
[5] Integrating the New Geometrical Feature in the Update Mechanism
[Top]

History

Version: 1 [Dec 2002] Document created
[Top]

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