Translation status

This page has not yet been translated into Finnish, or its translation is out of date. The current English version is shown as a fallback.

!MATERIAL¶

Definition of material properties

If the material properties are temperature-dependent, they can be entered as a table for the corresponding temperatures.

1st line

!MATERIAL, NAME=<name> [, optional parameter]

Parameter
`NAME`	Material name (required)
`ITEM`	Number of material-property items (optional; defaults to "1" if omitted)
`INPUT`	External file name (optional)

Parameter name	Parameter value	Description
`NAME`	<name>	Material name
`ITEM`	<ITEMnum>	Number of user-defined material-property items
`INPUT`	<filename>	External file name (optional); may also be used together with the 2nd and subsequent lines

2nd and subsequent lines

(2nd line) !ITEM=1, SUBITEM=<k>
(3rd line) VAL1-1-1, VAL1-1-2, … VAL1-1-k, TEMP1-1
(4th line) VAL1-2-1，VAL1-2-2, … VAL1-2-k, TEMP1-2
・・

(Line L+2)VAL1-L-1，VAL1-L-2, … VAL1-L-k, TEMP1-L

Repeat the definition through !ITEM=<ITEMnum>

Subparameter (for `!ITEM`)
`SUBITEM`	Number of sub-property items defined for each material-property item
	(optional; defaults to "1" if omitted)

Subparameter name	Parameter value	Description
`SUBITEM`	<subITEMnum>	Number of user-defined sub-property items

[When the m-th material property is temperature-dependent]

If the temperature-dependent table contains N entries, enter them as follows:

!ITEM=m, SUBITEM=k
VALm1-1, ..., VALm1-k, TEMPm1
VALm2-1, ..., VALm2-k, TEMPm2
...
VALmN-1, ..., VALmN-k, TEMPm-N

Variable name	Attribute	Description
VALmn-k	R	Material-property value (temperature-dependent)
TEMPmn	R	Corresponding temperature

TEMPm1 < TEMPm2 < ... < TEMPmN must hold.

VALm1 is used when the temperature is TEMPm1 or lower, and VALmN is used when the temperature is TEMPmN or higher.

[When the m-th material property is not temperature-dependent]

!ITEM=m, SUBITEM=k
VALm1-1, ..., VALm1-k
VALm2-1, ..., VALm2-k
...
VALmN-1, ..., VALmN-k

Variable name	Attribute	Description
VALmn-k	R	Material-property value (not temperature-dependent)

Note:

An error occurs if material names are duplicated.

An error occurs if the !SECTION option references an undefined MATERIAL.

In the !ELEMENT option, if material properties are entered for each element using the MATITEM parameter, those values take precedence. In this case, material-property values entered using the !MATERIAL option are not used.

An error occurs if the number of !ITEM=m suboptions is inconsistent with the ITEM parameter, or if a suboption is undefined.

The !ITEM=m suboptions do not have to be arranged in ascending order of m.

When the SUBITEM=k suboption and temperature dependence are used, omitted values are set to "0.0".

When temperature dependence is used, definitions must be given in ascending order of temperature.

When temperature dependence is used, an error occurs if the same temperature is used two or more times.

Usage example

!MATERIAL, NAME= STEEL, ITEM= 2
!ITEM=1 No temperature dependence
35.0
!ITEM=2
40.0, 0.0
45.0, 100.0
50.0, 200.0

!MATERIAL, NAME= COPPER         Number of items = 1 (default value)
!ITEM=1 No temperature dependence
80.0

Incorrect usage examples

Example 1 [The number of ITEM parameters and !ITEM=m suboptions is inconsistent -1]

!MATERIAL, NAME= STEEL, ITEM= 2
!ITEM=3
20.0
!ITEM=1
35.0
!ITEM= 2
40.0

Example 2 [The number of ITEM parameters and !ITEM=m suboptions is inconsistent -2]

!MATERIAL, NAME= STEEL, ITEM= 3
!ITEM=3
20.0
!ITEM= 2
40.0
!MATERIAL, NAME= COPPER
...

!MATERIAL, NAME=<name>, ITEM=<ITEMnum>
!ITEM=1, SUBITEM=2
<Young_modulus>, <Poisson_ratio>
!ITEM=2
<Density>
!ITEM=3
<Expansion_coeff>

Parameter name	Parameter value	Description
NAME	<name>	Material name; corresponds to MATERIAL in !SECTION
ITEM	<ITEMnum>	Number of user-defined material-property items (1 or more) <Young_modulus>-----Young's modulus (required) <Poisson_ratio>-------Poisson's ratio (required) <Density>--------------Mass density (required when ITEMnum=2) < Expansion_coeff >--Coefficient of linear expansion (when ITEMnum=3)

(Example)

!MATERIAL, NAME=M1,
ITEM=3                   --- Defines three types of property values for material M1
!ITEM=1, SUBITEM=2       --- !ITEM=1 defines Young's modulus and Poisson's ratio (required)
4000.0, 0.3
!ITEM=2                  --- !ITEM=2 defines mass density (required when ITEM=2)
8.0102E-0
!ITEM=3                  --- !ITEM=3 defines the coefficient of linear expansion
1.0E-5

Note:

Temperature-dependent materials cannot be used in modal analysis.

Heat Conduction Analysis¶

For link, plane, solid, and three-dimensional plate elements

!MATERIAL, NAME=<name>, ITEM=3
!ITEM=1, SUBITEM=2
<Density>, <Temperature>

!ITEM=2, SUBITEM=2
<Specific_heat>, <Temperature>

!ITEM=3, SUBITEM=2
<Conductivity>, <Temperature>

Parameter name	Parameter value	Description
`NAME`	<name>	Material name; corresponds to MATERIAL in !SECTION
`ITEM`	<ITEMnum>	Number of user-defined material-property items (always 3) <Density>----------Density <Specific_heat>----Specific heat <Conductivity>-----Thermal conductivity <Temperature>------Temperature

(Example)

!MATERIAL, NAME=M1,
ITEM=3　　　             ---　Defines three types of property values for material M1

!ITEM=1, SUBITEM=１　 　 ---　!ITEM=1 defines density and temperature (required)
7850., 300.
7790., 500.
7700., 800.

!ITEM=2, SUBITEM=1       ---　!ITEM=2 defines specific heat and temperature (required)
0.465, 300.
0.528, 500.
0.622, 800.

!ITEM=3                  ---　!ITEM=3 defines thermal conductivity and temperature (required)
43., 300.
38.6, 500.
27.7, 800.

For interface elements

Define it in the !SECTION header. (Material data is not required.)

(Example)

!SECTION, TYPE=INTERFACE, EGRP=GAP　 ---　Section definition
1.0, 20.15, 8.99835E-9, 8.99835E-9

The !SECTION above defines the gap parameters for interface elements belonging to group name=GAP.

1st parameter: Gap width
2nd parameter: Gap heat-transfer coefficient
3rd parameter: Gap radiation coefficient 1
4th parameter: Gap radiation coefficient 2

Reference¶

program TEST
use hecmw
implicit REAL*8 (A-H,O-Z)
type (hecmwT_local_mesh) :: hecMESH

!C
!C    !MATERIAL, NAME=SUS304, ITEM=3
!C    !ITEM=1, SUBITEM= 3
!C      100.0, 200.0, 300.0, 0.00
!C      101.0, 210.0, 301.0, 1.00
!C      102.0, 220.0, 302.0, 2.00
!C      103.0, 230.0, 303.0, 3.00
!C    !ITEM=3, SUBITEM= 2
!C      1000.0, , 0.00
!C      1001.0, 1., 1.00
!C      1002.0, 2., 2.00
!C      1003.0, 3., 3.00
!C    !ITEM=2
!C      5000.0
!C
!C    !MATERIAL, NAME=FEC, ITEM=2
!C    !ITEM=1, SUBITEM= 3
!C      2100.0, 2200.0, 2300.0, 0.00
!C      2101.0, 2210.0, 2301.0, 1.00
!C      2102.0, 2220.0, 2302.0, 2.00
!C      2103.0, 2230.0, 2303.0, 3.00
!C      3103.0, 3230.0, 2304.0, 4.00
!C    !ITEM=2
!C      6000.0, 10.0
!C      6500.0, 30.0
!C

hecMESH%material%n_mat = 2

nn= hecMESH%material%n_mat
allocate (hecMESH%material%mat_name(nn))

hecMESH%material%mat_name(1)= 'SUS304'
hecMESH%material%mat_name(2)= 'FEC'

nn= hecMESH%material%n_mat
allocate (hecMESH%material%mat_ITEM_index(0:nn))
hecMESH%material%mat_ITEM_index(0)= 0
hecMESH%material%mat_ITEM_index(1)= 3
hecMESH%material%mat_ITEM_index(2)= hecMESH%material%mat_ITEM_index(1) + 2

hecMESH%material%n_mat_ITEM= hecMESH%material%mat_ITEM_index(hecMESH%material%n_mat)

nn= hecMESH%material%n_mat_ITEM
allocate (hecMESH%material%mat_subITEM_index(0:nn))

hecMESH%material%mat_subITEM_index(0)= 0
hecMESH%material%mat_subITEM_index(1)= 3
hecMESH%material%mat_subITEM_index(2)= hecMESH%material%mat_subITEM_index(1) + 1
hecMESH%material%mat_subITEM_index(3)= hecMESH%material%mat_subITEM_index(2) + 2
hecMESH%material%mat_subITEM_index(4)= hecMESH%material%mat_subITEM_index(3) + 3
hecMESH%material%mat_subITEM_index(5)= hecMESH%material%mat_subITEM_index(4) + 1

hecMESH%material%n_mat_subITEM=
&        hecMESH%material%mat_subITEM_index(hecMESH%material%n_mat_ITEM)

nn= hecMESH%material%n_mat_subITEM
allocate (hecMESH%material%mat_TABLE_index(0:nn))
hecMESH%material%mat_TABLE_index( 0)= 0
hecMESH%material%mat_TABLE_index( 1)= 4
hecMESH%material%mat_TABLE_index( 2)= hecMESH%material%mat_TABLE_index( 1) + 4
hecMESH%material%mat_TABLE_index( 3)= hecMESH%material%mat_TABLE_index( 2) + 4
hecMESH%material%mat_TABLE_index( 4)= hecMESH%material%mat_TABLE_index( 3) + 1
hecMESH%material%mat_TABLE_index( 5)= hecMESH%material%mat_TABLE_index( 4) + 4
hecMESH%material%mat_TABLE_index( 6)= hecMESH%material%mat_TABLE_index( 5) + 4
hecMESH%material%mat_TABLE_index( 7)= hecMESH%material%mat_TABLE_index( 6) + 5
hecMESH%material%mat_TABLE_index( 8)= hecMESH%material%mat_TABLE_index( 7) + 5
hecMESH%material%mat_TABLE_index( 9)= hecMESH%material%mat_TABLE_index( 8) + 5
hecMESH%material%mat_TABLE_index(10)= hecMESH%material%mat_TABLE_index( 9) + 2

hecMESH%material%n_mat_TABLE=
&        hecMESH%material%mat_TABLE_index(hecMESH%material%n_mat_subITEM)

nn= hecMESH%material%n_mat_TABLE
allocate (hecMESH%material%mat_VAL (nn))
allocate (hecMESH%material%mat_TEMP(nn))

hecMESH%material%mat_VAL = 0.d0
hecMESH%material%mat_TEMP= 0.d0

hecMESH%material%mat_VAL ( 1)= 100.0d0
hecMESH%material%mat_TEMP( 1)=   0.0d0
hecMESH%material%mat_VAL ( 2)= 101.0d0
hecMESH%material%mat_TEMP( 2)=   1.0d0
hecMESH%material%mat_VAL ( 3)= 102.0d0
hecMESH%material%mat_TEMP( 3)=   2.0d0
hecMESH%material%mat_VAL ( 4)= 103.0d0
hecMESH%material%mat_TEMP( 4)=   3.0d0

hecMESH%material%mat_VAL ( 5)= 200.0d0
hecMESH%material%mat_TEMP( 5)=   0.0d0

hecMESH%material%mat_VAL (13)= 5000.0d0

hecMESH%material%mat_VAL (14)= 1000.0d0
hecMESH%material%mat_TEMP (14)=   0.0d0
hecMESH%material%mat_VAL (15)= 1001.0d0
hecMESH%material%mat_TEMP (15)=   1.0d0
hecMESH%material%mat_VAL (16)= 1002.0d0
hecMESH%material%mat_TEMP (16)=   2.0d0
hecMESH%material%mat_VAL (17)= 1003.0d0
hecMESH%material%mat_TEMP (17)=   3.0d0

hecMESH%material%mat_VAL (18)=  0.0d0
hecMESH%material%mat_TEMP (18)= 0.0d0
hecMESH%material%mat_VAL (19)=  1.0d0
hecMESH%material%mat_TEMP (19)= 1.0d0
hecMESH%material%mat_VAL (20)=  2.0d0
hecMESH%material%mat_TEMP (20)= 2.0d0
hecMESH%material%mat_VAL (21)=  3.0d0
hecMESH%material%mat_TEMP (21)= 3.0d0

hecMESH%material%mat_VAL (22)= 2100.0d0
hecMESH%material%mat_TEMP (22)=   0.0d0
hecMESH%material%mat_VAL (23)= 2101.0d0
hecMESH%material%mat_TEMP (23)=   1.0d0
hecMESH%material%mat_VAL (24)= 2102.0d0
hecMESH%material%mat_TEMP (24)=   2.0d0
hecMESH%material%mat_VAL (25)= 2103.0d0
hecMESH%material%mat_TEMP (25)=   3.0d0
hecMESH%material%mat_VAL (26)= 3103.0d0
hecMESH%material%mat_TEMP (26)=   4.0d0

write (*,'(a,i10)') '%n_mat_ITEM ', hecMESH%material%n_mat_ITEM
write (*,'(a,i10)') '%n_mat_subITEM', hecMESH%material%n_mat_subITEM
write (*,'(a,i10)') '%n_mat_TABLE ', hecMESH%material%n_mat_TABLE

end program TEST

!MATERIAL¶

Linear Static Analysis and Modal Analysis¶

Heat Conduction Analysis¶

Reference¶