Code_Aster

Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : 1/8 C% : U4)4*)02 R+i!io# : ,1-,

Oprateur INCLUDE_MATERIAU
1 Drank
Rcuprer the characteristics of a preset material in Catalogue Matriaux of Code_A!ter. The files of Catalogue Matriaux are located in the sub-directory material of the directory of instalment, for example /aster/STA10/materiau on the centralized machine. Note for an offsite use at !"# $free soft%are&, a single file is pro'ided in the directory material as demonstration.

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7

Code_Aster
Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : 2/8 C% : U4)4*)02 R+i!io# : ,1-,

Contents
( "ran).................................................................................................................................................. ( * +yntax................................................................................................................................................ , , Catalogue Materials -ster.................................................................................................................. . . /perands N/M0-#N/R 1 T23!0M/"!4! 1 5-R6-NT! 1 T23!05-4!......................................... 7 7 /prande N/M0M-T!R................................................................................................................... 7 8 9ey %ord !:TR-CT6/N.............................................................................................................. 8.8.( /prande C/M3/R.................................................................................................................... 8.8.* /prande T!M30!5-4..................................................................................................................... 8 ; /prande <N6T!04/N=<!<R......................................................................................................... 8 > /prande 6N#/.................................................................................................................................. 8 ? !xemple of use.................................................................................................................................. ;

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7

Code_Aster
Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : */8 C% : U4)4*)02 R+i!io# : ,1-,

Syntaxe
chechmate = INCLUDE_MATERIAU N M_A!N R="#ma$"#r T)*E_M DELE= -ARIANTE= / / +RE!,% +*AR,% ( % &'N(

/ +A,% / +.,% / +It // / / +0,% / / / +N MI,% +MA1I,% +MINI,%

T)*E_-ALE=

2E1TRACTI N=_! ( C M* R=l_c#m3#r TEM*_E-AL=tem3 6% 2UNITE_L N7UEUR= 2IN! = 6 chechmate is of type &su9:ue(. / / +ME % +MM, %

% %

&l_415( &R( &DE!ECT( &DE!AUT(

/ 1% /8 %

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7

Code_Aster
Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : 4/8 C% : U4)4*)02 R+i!io# : ,1-,

Catalogue Matriaux Aster

Code_A!ter has Catalogue Matriaux %hose ob@ecti'es are to pro'ide the users, material characteristics necessary to the realization of numerical studies, to ensure the perenniality of information, to guarantee the reliability and the coherence of the a'ailable data, and to facilitate and automate the access to information.

6n Code_A!ter, the material is defined by a set of characteristics necessary to the implementation of a constituti'e la%, %hich are introduced by general command DE!I_MATERIAU. 6n Catalogue Materials, the material is indexed by its designation in norm -#N/R. Catalogue Matriaux distinguishes t%o types of materials according to the type of study the Amaterial of reference B for generic studies. 6t corresponds to a set of products manufactured according to the same %ell defined specification. 6t is characterized by 'alues median, minimal and maximum typical of the population concerned. 6t is this material %hich it is ad'ised to use if one does not ha'e a perfect description of the material %ith modelizing, the Aparticular material B for specific studies. 6t corresponds to a %ell identified product or a concept of material gi'en. This material is characterized by specific 'alues of its properties, together %ith extreme 'alues related on the heterogeneity of the material and1or uncertainty on the 'alues. This material is finely documented in order to a'oid its systematic use %ithout precaution.

6n addition, one can index 'arious materials $of reference or pri'ate indi'idual& corresponding to the same designation -#N/R. The RCC-M distinguishes, for the same designation -#N/R, the characteristics material follo%ing the technical specification of reference, the type of product $forged, rolled, tube, sheet,C& and dimensions of the component. 6n order to ta)e account of this additional dimension, in Catalogue Materials, one associates %ith each material a letter of the alphabet. To summarize, in Catalogue Matriaux the materials are indexed by a character string %hich is composed of the concatenation designation in norm -#N/R, of %ord R!# $if material of reference& or 3-R $if particular material&, of a letter of the alphabet.

#or example (>MN"70R!#0Catalogue Matriaux is presented in t%o distinct forms a form AfilesB usable by Code_A!ter by command INCLUDE_MATERIAU. They is a set of files ha'ing for name the character string pre'iously described $for example (>MN"70R!#0-& and for extension one of the follo%ing character strings N MI $for the median 'alues&, MINI $for the minimal 'alues& and MA1I $for the maximum 'alues&, a form AfilesB, %here the user can consult the characteristic materials in the form of tables and obtain the origin of the characteristics. This shape of the catalogue is accessible onsite from Code_A!ter %%%.code-aster.org $only in 6ntranet !"#, in the section "ocumentation M&. !ach file material is the independent 'alidation ob@ect by department MMC.

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7

Code_Aster
Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : -/8 C% : U4)4*)02 R+i!io# : ,1-,

Operands NOM_AFNOR / TYPE_MODELE / VARIANTE / TYPE_VALE

Ces operands ma)e it possible to choose the material to be used and thus to define its name according to the rule presented to the preceding paragraph. N M_A!N R="#ma$"#r % &'N(

3ermet to specify the designation of the material in norm -#N/R $for example (>MN"7&. T)*E_M DELE= / +RE!,% / +*AR,%

3ermet to specify if they are the characteristics of the material of reference or those of the particular material %hich one %ishes to use. -ARIANTE= / +A,% ////// / +0,%

3ermet to specify the alternati'e of the material %hich one %ishes to use $characteristics are in general different according to the thic)ness or the diameter and this for the same designation in norm -#N/R&. The paragraph of description of the material of the file material ma)es it possible to )no% the alternati'e interesting the user. T)*E_-ALE= / +N MI,% / +MA1I,% / +MINI,%

3ermet to specify if one %ants to use the median 'alues, minimal or maximum.

!ey "ord EXTRACTION

4es 'alues of characteristics material contained in Catalogue Matriaux are generally tables of 'alues depending on the temperature. +o one informed in Catalogue Matriaux only certain )ey %ords control ratios DE!I_MATERIAU those for %hich the operands are defined by functions $for example ELAS_! , T;ER_NL,C&. /n the other hand, the )ey %ords factors for %hich the operands are defined by realities $for example ELAS,C& in the 'arious files composing the form AfilesB of Catalogue Matriaux are not indicated. /ne can ho%e'er generate these )ey %ords in command DE!I_MATERIAU by )ey %ord E1TRACTI N by specifying the beha'ior or the beha'iors %hich one %ishes to generate and by specifying the 'alue of the temperature to %hich one %ishes to extract the 'alues from the function.

#1

Operand COMPOR
C M* R= l_c#m3#r &l_415( "signe the name of the )ey %ords factors of DE!I_MATERIAU %hich %ill be extracted. #or example, +ELAS, or +T;ER,.

#2

Operand TEMP_EVAL
TEM*_E-AL= tem3 &R( Temperature to %hich, one %ishes to extract the 'alues from the characteristic materials. #or example, one creates in command DE!I_MATERIAU the operand E = E0 under the )ey

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7

Code_Aster
Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : 8/8 C% : U4)4*)02 R+i!io# : ,1-,

%ord factor ELAS by interpolating the 'alue %ith T0 of the operand E = E (T6 defined in the catalogue. The type of interpolation is determined by the corresponding function of the catalogue. 6n general, the interpolation is linear, prohibited extrapolations.

Operand UNITE_LONGUEUR
2UNITE_L N7UEUR= / / +ME +MM, % % &DE!ECT(

3ermet to use the data of the catalogue material %ith the millimetre li)e unit of length. The 'alues indicated in the catalogue material are and remain in meters. 6f the user specifies UNITE_L N7UEUR = +MM, in command INCLUDE_MATERIAU, that means that the user %ishes to handle units of length in millimetres, and 6NC4<"!0M-T!R6-< orders it carries out the transformation of the units.

Operand INFO
2IN! 13as :< 8 = / 1% / 8% printing of the file contents included, printing of the file contents included, in file +MESSA7E,. &DE!AUT(

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7

Code_Aster
Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : ,/8 C% : U4)4*)02 R+i!io# : ,1-,

&

'xample of use
DE.UT (6 ///////////////// MAT= = INCLUDE_MATERIAU ( N M_A!N T)*E_M DELE= -ARIANTE= T)*E_-ALE= IN! = R= +1>MND?,% +RE!,% +A, % +N MI,% 8 6

chmat= = A!!E_MATERIAU ( MES; = m@% A!!E=_! ( 7R U*_MA= (+STRIA1,/ % +SAUA,6% MATER=MAT=66 !IN (6

Dfinir its o"n material

T&i! "ara ra"& i! &a%3/a2 $et/ee# t&e u!e a#d t&e de+e%o"1e#t) '#e u!e! a #ot 9ua%i3ied o+er%oad /&ic& i! re!"o#!i$i%it2 3or t&e u!er/de+e%o"er) /ne approaches here the definition of a catalogue for a material gi'en by an user. The catalogue thus de'eloped %ill be able to integrate the catalogue managed in configuration after the necessary s)ill, but in the meantime it can be used in o'erload. #or that, it is enough to define a particular directory %here the ne% catalogue %ill be stored, and to use the argument B re3_mat &:irect#r@ "ame( in the launching of the study $c3 Du(.E..EEF&.

(#1

Management of t)e unit of lengt) of t)e *our

mesh to manage the change of unit, one has the function c#e$_u"it. c#e$_u"it (N6 is %orth (. if UNITE_L N7UEUR is %orth +Me, and is %orth UNITE_L N7UEUR is %orth +MM,. #or example, for a Guantity in M3a, one %ill %rite E = 8/1e11 C c#e$_u"it (B 56

10

if

(#2

'xtraction and e+aluation according to t)e temperature

"ans the %riting of the catalogue, it is necessary to determine %hich are the )ey %ords turned o'er in the presence of E1TRACTI N and those %hich are not it. !xample 6f one does not reGuest the extraction from a gi'en temperature, one %ishes to obtain the elastic properties depending on the temperature, )ey %ord ELAS_! . Hhereas if one reGuests these properties from *EIC, one %ishes to obtain the )ey %ord factor ELAS. /ne %ill %rite eDtracti#"=True $in the catalogue& to indicate that the )ey %ord factor must be preser'ed if E1TRACTI N is present $in the command set&, eDtracti#"=!alse to indicate that it should be preser'ed if E1TRACTI N is absent. 6f eDtracti#" is not indicated, the )ey %ord is preser'ed in both cases. /ne indicates %hich function must be e'aluated according to the temperature $only currently supported command 'ariable& by using the function tem3_eEal E = tem3_eEal (_A86 %here _A8 is a function defined before.

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7

Code_Aster
Titre : Procdure INCLUDE_MATERIAU Re!"o#!a$%e : Mat&ieu C'URT'I(

Version default
Date : 24/08/2011 Pa e : 8/8 C% : U4)4*)02 R+i!io# : ,1-,

(#2#1

Syntax, "ords reser+ed

the catalogue does not call DE!I_MATERIAU itself, it defines only the list of the )ey %ords. #or that, it is necessary to use the function :e$i_m#tscles and to name m#tscles the result of this function m#tscles = :e$i_m#tscles (F6 a catalogue material is not a macro-command. Jo%e'er, he obeys the same rules concerning the naming of the intermediate concepts $functions of the properties depending on the temperature in particular&. 6n order not to cause conflicts %ith the concepts of the command set of the user, it is necessary to ta)e care to prefix the intermediate concepts of the catalogue %ith a +_, $c3 Dd7.E(.E*F& and to destroy the concepts %hich can the being. 4astly, a restricted number of commands are usable in a catalogue those %hich primarily handle the functions $to consult the file 9i93@t/Macr#/i"clu:e_materiau_#3s/3@ to ha'e the exhausti'e list&.

.ar#i# : T&e tra#!%atio# "roce!! u!ed o# t&i! /e$!ite i! a 0Mac&i#e Tra#!%atio#0) It 1a2 $e i1"reci!e a#d i#accurate i# /&o%e or i# "art a#d i! "ro+ided a! a co#+e#ie#ce) Lice#!ed u#der t&e ter1! o3 t&e 4NU 5DL 6&tt"://///) #u)or /co"2%e3t/3d%)&t1%7