next up previous contents index
Next: II.4 The ``ClaLam'' class Up: II. Composite Reference Manual Previous: II.2 The ``ClaDb'' class   Contents   Index

Subsections


II.3 The ``ClaMat'' class

The ``ClaMat'' class is used to store the materials used in the definition of laminates. Each material is characterized by:

Several methods of the ClaMat class allow to access to data stored in an object. Table II.3.1 gives the list of methods defined in the class.

Table II.3.1: The different methods that have been defined in ``ClaMat'' class. CLA.ClaMat.methods.tab
(FeResPost list of classes is given in Table 1 page [*].)
Method Name Description Example
     
Creation and initialization methods
ClaMat.newnew II.3.1 IV.5.2
ClaMat.initializeinitialize II.3.1  
ClaMat.cloneclone II.3.7  
Manipulation of data defining ClaMat object
ClaMat.clearModuliclearModuli II.3.3  
ClaMat.insertModuliinsertModuli II.3.3  
ClaMat.fillModulifillModuli II.3.3 IV.5.2
ClaMat.getDataModuligetDataModuli II.3.3  
ClaMat.clearCTEsclearCTEs II.3.3  
ClaMat.insertCTEsinsertCTEs II.3.3  
ClaMat.fillCTEsfillCTEs II.3.3 IV.5.2
ClaMat.getDataCTEsgetDataCTEs II.3.3  
ClaMat.clearCMEsclearCMEs II.3.3  
ClaMat.insertCMEsinsertCMEs II.3.3  
ClaMat.fillCMEsfillCMEs II.3.3  
ClaMat.getDataCMEsgetDataCMEs II.3.3  
ClaMat.clearAllowablesclearAllowables II.3.3  
ClaMat.insertAllowablesinsertAllowables II.3.3  
ClaMat.fillAllowablesfillAllowables II.3.3  
ClaMat.getDataAllowablesgetDataAllowables II.3.3  
ClaMat.clearThermalDataclearThermalData II.3.3  
ClaMat.insertThermalDatainsertThermalData II.3.3  
ClaMat.fillThermalDatafillThermalData II.3.3 IV.5.3
ClaMat.getThermalDatagetThermalData II.3.3  
ClaMat.clearMoistureDataclearMoistureData II.3.3  
ClaMat.insertMoistureDatainsertMoistureData II.3.3  
ClaMat.fillMoistureDatafillMoistureData II.3.3  
ClaMat.getMoistureDatagetMoistureData II.3.3  
Extraction of calculated material properties
ClaMat.getCompliancegetCompliance II.3.4 ``EX12/testCla.rb''
ClaMat.getStiffnessgetStiffness II.3.4 IV.5.2
ClaMat.getInPlaneCompliancegetInPlaneCompliance II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getInPlaneStiffnessgetInPlaneStiffness II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getInPlaneAlfaEgetInPlaneAlfaE II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getInPlaneBetaEgetInPlaneBetaE II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getInPlaneAlfagetInPlaneAlfa II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getInPlaneBetagetInPlaneBeta II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getOOPSCompliancegetOOPSCompliance II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getOOPSStiffnessgetOOPSStiffness II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getOOPSAlfaGgetOOPSAlfaG II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getOOPSBetaGgetOOPSBetaG II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getOOPSAlfagetOOPSAlfa II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getOOPSBetagetOOPSBeta II.3.4 ``EX13/extendedCLA.rb''
ClaMat.getInPlaneLambdaTgetInPlaneLambdaT II.3.4 IV.5.3
ClaMat.getRhogetRho II.3.4 IV.5.3
ClaMat.getCpgetCp II.3.4 IV.5.3
ClaMat.getRhoCpgetRhoCp II.3.4 IV.5.3
ClaMat.getInPlaneLambdaHgetInPlaneLambdaH II.3.4  
Management of units methods
ClaMat.getUnitsgetUnits II.3.5  
ClaMat.setUnitssetUnits II.3.5  
ClaMat.changeUnitschangeUnits II.3.5  
Attributes
ClaMat.IdId II.3.2  
ClaMat.TypeType II.3.2  
ClaMat.TypeNameTypeName II.3.2 (read only)
NDF lines
ClaMat.initWithNeutralLinesinitWithNeutralLines II.3.6  
ClaMat.getNeutralLinesgetNeutralLines II.3.6  
     


II.3.1 Creation of an object

The singleton method ``ClaMat.newnew'' is used to create ClaMat objects. This method has no argument. (Nor has the ``ClaMat.initializeinitialize'' method an argument.)


II.3.2 Identifier and type

Two attributes are defined for the ``ClaMat'' object: ``ClaMat.IdId'' and ``ClaMat.TypeType''. Five methods allow the manipulation of the identifier of material and of its type:

Note that for the type definition, the integers are 0, 1, 2 or 3 and correspond to "NONE", "isotropic", "orthotropic" or "anisotropic" respectively.


II.3.3 Manipulating Data

Twelve methods allow to set moduli and Poisson's coefficients, thermal expansion coefficients and allowables. These methods have one Hash argument that associates String keys to real values.

  1. ``ClaMat.clearModuliclearModuli'' has no arguments and erases all the moduli stored in a ClaMat object.
  2. ``ClaMat.insertModuliinsertModuli'' is used to specify moduli and Poisson coefficients of the material. The keys used to insert mechanical data depend on the type of material:
  3. ``ClaMat.fillModulifillModuli'' is used to set material moduli and Poisson coefficients. This method has the same arguments as ``ClaMat.insertModuliinsertModuli'' but differs by the fact that moduli and Poisson coefficients are re-initialized before insertion of values.

  4. ``ClaMat.clearCTEsclearCTEs'' has no arguments and erases all the CTEs stored in a ClaMat object.
  5. ``ClaMat.insertCTEsinsertCTEs'' is used to define different components of the thermal expansion coefficients. For orthotropic and anisotropic materials, possible keys are "alfa1", "alfa2", "alfa3", "alfa12", "alfa23" and "alfa31". For isotropic materials, key "alfa" only can be used.
  6. ``ClaMat.fillCTEsfillCTEs'' is used to set material CTEs. This method has the same arguments as ``insertCTEs'' but differs by the fact that CTEs are re-initialized before insertion of values.

  7. ``ClaMat.clearCMEsclearCMEs'' has no arguments and erases all the CMEs stored in a ClaMat object.
  8. ``ClaMat.insertCMEsinsertCMEs'' is used to define different components of the moisture expansion coefficients. For orthotropic and anisotropic materials, possible keys are "beta1", "beta2", "beta3", "beta12", "beta23" and "beta31". For isotropic materials, key "beta" only can be used.
  9. ``ClaMat.fillCMEsfillCMEs'' is used to set material CMEs. This method has the same arguments as ``insertCMEs'' but differs by the fact that CMEs are re-initialized before insertion of values.

  10. ``ClaMat.clearAllowablesclearAllowables'' has no arguments and erases all the allowables stored in a ClaMat object.
  11. ``ClaMat.insertAllowablesinsertAllowables'' is used to add material allowables. The possible keys are "sc", "st", "ss", "ec", "et", "gs", "s1c", "s1t", "s2c", "s2t", "s12", "s23", "s31", "e1c", "e1t", "e2c", "e2t", "e3c", "e3t", "g12", "g23", "g31", "F12", "F23" and "F31". "st" is used to calculate isotropic stress criteria or reserve factors. "F12" "F23" and "F31" correspond to the $ F_{12}^{\text{TW}}$ , $ F_{23}^{\text{TW}}$ and $ F_{31}^{\text{TW}}$ of the Tsai-Wu failure criteria (sections II.1.10.14 and II.1.10.15). Note that the "ilss" allowable defined at material level has no effect because for Ilss criterion calculation, the allowable is always extracted from the laminate definition. (More precisely, the ilss laminate allowable, or the ply allowables are used.)
  12. ``ClaMat.fillAllowablesfillAllowables'' is used to set material allowables. This method has the same arguments as ``ClaMat.insertAllowablesinsertAllowables'' but differs by the fact that material allowables are re-initialized before insertion of values.

  13. ``ClaMat.clearThermalDataclearThermalData'' has no arguments and erases all the thermal data stored in a ClaMat object.
  14. ``ClaMat.insertThermalDatainsertThermalData'' is used to define the thermal data. For orthotropic and anisotropic materials, possible keys are "lambdaT1", "lambdaT2", "lambdaT3", "lambdaT12", "lambdaT23" and "lambdaT31". For isotropic materials, key "lambdaT" only can be used. For all types of materials "rho" and "Cp" keys can be used.
  15. ``ClaMat.fillThermalDatafillThermalData'' is used to set material thermal data. This method has the same arguments as ``ClaMat.insertThermalDatainsertThermalData'' but differs by the fact that thermal data are re-initialized before insertion of values.

  16. ``ClaMat.clearMoistureDataclearMoistureData'' has no arguments and erases all the Moisture data stored in a ClaMat object.
  17. ``ClaMat.insertMoistureDatainsertMoistureData'' is used to define the moisture data. For orthotropic and anisotropic materials, possible keys are "lambdaH1", "lambdaH2", "lambdaH3", "lambdaH12", "lambdaH23" and "lambdaH31". For isotropic materials, key "lambdaH" only can be used.
  18. ``ClaMat.fillMoistureDatafillMoistureData'' is used to set material Moisture data. This method has the same arguments as ``ClaMat.insertMoistureDatainsertMoistureData'' but differs by the fact that moisture data are re-initialized before insertion of values.
The type of ClaMat object must have been set prior to the use of any of the three previous methods. (See ``ClaMat.TypeType'' attribute described in section II.3.2.) Several methods allow to retrieve the data that define a material:
  1. ``ClaMat.getDataModuligetDataModuli'' returns the moduli that define the ClaMat object.
  2. ``ClaMat.getDataCTEsgetDataCTEs'' returns the CTEs that define the ClaMat object.
  3. ``ClaMat.getDataCMEsgetDataCMEs'' returns the CMEs that define the ClaMat object.
  4. ``ClaMat.getDataAllowablesgetDataAllowables'' returns the allowables that characterize the ClaMat object.
  5. ``ClaMat.getThermalDatagetThermalData'' returns the thermal data that define the ClaMat object.
  6. ``ClaMat.getMoistureDatagetMoistureData'' returns the moisture data that define the ClaMat object.
Each of these ``get'' methods returns a Hash that associates String and Real objects. (See the ``fill'' corresponding methods for possible values.)

Obviously, the different data inserted in, or retrieved from the ClaMat object should be consistent with the set of units attributed to the same object. This set of units can be attributed to the object after initialization of the data.


II.3.4 Calculated results

Several methods allow to recover stiffness, compliance or conductivity matrices in a specified direction.

All these methods have one optional argument: an angle corresponding to the direction of observation wrt material axes, and in which the components of the matrix are expressed.

On the other hand, three methods return material scalar characteristics and have no argument:

The different calculated results from the ClaMat object are expressed in the units system associated with the object.


II.3.5 Management of Units

The ``ClaMat'' class defines three methods for the management of units:

The Hash arguments or return values mentioned above have String keys and values as explained in section II.1.13. The difference between the ``ClaMat.setUnitssetUnits'' and ``ClaMat.changeUnitschangeUnits'' methods is also explained in the same section.


II.3.6 Saving or initializing with NDF lines

Two methods allow to save or read ClaMat objects from an Array of Strings in neutral format. These two methods are ``ClaMat.initWithNeutralLinesinitWithNeutralLines'' and ``ClaMat.getNeutralLinesgetNeutralLines'' that work in a similar way as the corresponding methods in ``ClaDb'' class (section II.2.6).

However, the lines transmitted to ``ClaMat.initWithNeutralLinesinitWithNeutralLines'' or returned by ``ClaMat.getNeutralLinesgetNeutralLines'' correspond to a single ClaMat object definition.


II.3.7 Other methods

``ClaMat.cloneclone'' method has no argument and returns a copy of the ClaMat object.


next up previous contents index
Next: II.4 The ``ClaLam'' class Up: II. Composite Reference Manual Previous: II.2 The ``ClaDb'' class   Contents   Index
FeResPost 2017-05-28