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.
- “clearModuli” has no arguments and erases all the moduli stored in a ClaMat object.
-
2.
- “insertModuli” is used to specify moduli and Poisson coefficients of the material. The keys used
to insert mechanical data depend on the type of material:
- For an orthotropic material, the different possible keys are: "E1", "E2", "E3", "G12",
"G23", "G31", "nu12", "nu23", "nu31".
- For isotropic materials the possible keys are "E", "nu" and "G".
- For anisotropic materials the components of matrix
as defined by (II.1.11) are specified. The keys can be "C1111", "C1122", "C1133"...
(Note that when a non-diagonal component of the matrix is defined, its symmetric
value is initialized too.)
-
3.
- “fillModuli” is used to set material moduli and Poisson coefficients. This method has the same
arguments as “insertModuli” but differs by the fact that moduli and Poisson coefficients are
re-initialized before insertion of values.
-
4.
- “clearCTEs” has no arguments and erases all the CTEs stored in a ClaMat object.
-
5.
- “insertCTEs” 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.
- “fillCTEs” 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.
- “clearCMEs” has no arguments and erases all the CMEs stored in a ClaMat object.
-
8.
- “insertCMEs” 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.
- “fillCMEs” 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.
- “clearAllowables” has no arguments and erases all the allowables stored in a ClaMat
object.
-
11.
- “insertAllowables” 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
,
and
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.
- “fillAllowables” is used to set material allowables. This method has the same arguments as
“insertAllowables” but differs by the fact that material allowables are re-initialized before
insertion of values.
-
13.
- “clearThermalData” has no arguments and erases all the thermal data stored in a ClaMat
object.
-
14.
- “insertThermalData” 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.
- “fillThermalData” is used to set material thermal data. This method has the same arguments as
“insertThermalData” but differs by the fact that thermal data are re-initialized before insertion of
values.
-
16.
- “clearMoistureData” has no arguments and erases all the Moisture data stored in a ClaMat
object.
-
17.
- “insertMoistureData” 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.
- “fillMoistureData” is used to set material Moisture data. This method has the same arguments as
“insertMoistureData” 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
“Type” attribute described in section II.3.2.) Several methods allow to retrieve the data that define a
material:
-
1.
- “getDataModuli” returns the moduli that define the ClaMat object.
-
2.
- “getDataCTEs” returns the CTEs that define the ClaMat object.
-
3.
- “getDataCMEs” returns the CMEs that define the ClaMat object.
-
4.
- “getDataAllowables” returns the allowables that characterize the ClaMat object.
-
5.
- “getThermalData” returns the thermal data that define the ClaMat object.
-
6.
- “getMoistureData” 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.