next up previous contents index
Next: I.4 The ``Result'' class Up: I. FeResPost Reference Manual Previous: I.2 The ``CoordSys'' class   Contents   Index


I.3 The ``Group'' class

The ``Group'' corresponds to the Patran notion of group. Group objects can be stored in a DataBase object, retrieved from it and manipulated outside the DataBase. One describes here the manipulation methods outside the DataBase class.

A list of the methods defined in ``Group'' class is given in Table I.3.1.

Table I.3.1: The different methods that have been defined in ``Group'' class.
(FeResPost list of classes is given in Table 1 page [*].)
Method Name Description Example
Creation and initialization methods
Group.newnew I.3.2 IV.2.5.1
Group.initializeinitialize I.3.7  
Group.cloneclone I.3.7  
Identification (attributes)
Group.Name=Name= I.3.7 IV.2.2.3
Group.NameName I.3.7  
Manipulation of entities
Group.getEntitiesByTypegetEntitiesByType I.3.3 IV.2.2.2
Group.getNbrEntitiesgetNbrEntities I.3.3  
Group.getNbrEntitiesByTypegetNbrEntitiesByType I.3.3 IV.2.2.2
Group.setEntitiessetEntities I.3.3 IV.2.5.1
Group.setEntitiesByTypesetEntitiesByType I.3.3  
Group.addEntitiesaddEntities I.3.3  
Group.addEntitiesByTypeaddEntitiesByType I.3.3  
Group.removeEntitiesremoveEntities I.3.3  
Group.removeEntitiesByTyperemoveEntitiesByType I.3.3  
Group.clearAllEntitiesByTypeclearAllEntitiesByType I.3.3  
Group.matchWithDbEntitiesmatchWithDbEntities I.3.3 IV.2.5.1
Group.importEntitiesByTypeimportEntitiesByType I.3.3  
Group.containEntitycontainEntity I.3.3  
Group.++ I.3.4 IV.2.5.1
Group.- I.3.4  
Group.** I.3.4 IV.2.2.4
Group.// I.3.4  
Group.toBlobtoBlob I.3.5  
Group.fromBlobfromBlob I.3.5  
Group.each_elementeach_element I.3.6  
Group.each_mpceach_mpc I.3.6  
Group.each_nodeeach_node I.3.6 IV.2.2.2
Group.each_coordsyseach_coordsys I.3.6  
Other methods
Group.to_sto_s I.3.7  
Attribute readers
Group.NbrElementsNbrElements I.3.7  
Group.NbrNodesNbrNodes I.3.7  
Group.NbrMpcsNbrMpcs I.3.7  
Group.NbrCoordsysNbrCoordsys I.3.7  

I.3.1 The concept of ``Group''

A Group is characterized by its name (a String object) and the entities it contains. Four type of entities can be contained in a FeResPost Group: coordinate systems, nodes, elements and MPCs. At C++ level, for each type of entity, the class group manages a set of integers corresponding to the identifiers of the entities.

Part of the operations dealing with Groups are done by methods defined in DataBase class. The methods of DataBase specially devoted to operations mainly related to Groups are described in section I.1.2.

I.3.2 Creation of a Group object

The singleton method ``Group.newnew'' is used to create Group objects.

I.3.3 Manipulation of entities stored in a Group

The class ``Group'' provides a large choice of methods devoted to the manipulation of the list of entities in its storage. One makes the distinction between operations that modify the content of a Group, and the operations that allow the inspection of this content.

The modification of the Group's content can be done by calls to the following methods:

Presently, four methods devoted to the manipulation of entities and not modifying the Group have been defined:

I.3.4 Group operators

Eight such operators have been defined. One first explains the meaning and behavior of the four elementary dyadic operations.

I.3.5 ``BLOBs''

Group objects can be saved in SQL database as ``BLOB'' objects.

Two methods are defined in Group class to convert object to and from Blobs:

I.3.6 Iterators of Group class

The class ``Group'' provides four iterators:

These iterators iterate on the corresponding entities stored in the Group object. They produce Integer values that are passed to the block.

I.3.7 Other methods

One gives here a list of methods that do not fit in any category listed above:

The ``Group.NameName'' and ``Group.Name=Name='' methods correspond to the ``Name'' attribute.

next up previous contents index
Next: I.4 The ``Result'' class Up: I. FeResPost Reference Manual Previous: I.2 The ``CoordSys'' class   Contents   Index
FeResPost 2017-05-28