Properties #

Tensor #

Tensor is an element that defines the material property tensor. Tensor is a child element of phase, each phase can have multiple tensor, and each tensor can contain multiple component. Tensor also must have a name, pointGroup, and rank.

Element structure #

• tensor
  • name The name of the property tensor.
  • pointGroup The symmetry of current tensor. For rank 1, 2, and 3 tensor, now only support custom, for rank 4 tensor, you may choose from the Schönflies symbols, including: Oh, Td, O, Th, T, D6h, D3h, C6v, D6, C6h, C3h,C6,D3h, C3v, D3, S6, C3, D4h, D2d, C4v, D4, C4h, S4, C4, D3h, C2v, D2, C2h, Cs, C2, C1
  • rank The tensor rank, 1, 2, 3, or 4.
  • component For setting the values of each non-zero component in the tensor.

Example #

<phase>
    <label>0</label>
    <tensor>
        <pointGroup>custom</pointGroup>
        <name>permittivity</name>
        <rank>2</rank>
        <component>
            <value>3.5</value>
            <index>11</index>
            <index>22</index>
            <index>33</index>
        </component>
    </tensor>
</phase>

Component #

Component set the value for each non-zero values of a material property tensor. Component is a child element of tensor. Each unique value component of the tensor should have its own component. Each component must have one value child, which set the value for this tensor component, and one or multiple index children, which specify the indices that have the same component value. For a 4th rank tensor, such as the stiffness, if you have chosen a specific point group, you will only need to have one index for each component, since all other equivalent indices will be inferred based on the point group symmetry. For other 1, 2, and 3 rank tensor, now we only support custom point group, which means you need to list all equivalent indices in the component element.

Element structure #

• component
  • value The tensor component value
  • index The tensor index that you want to set value

Example #

<component>
    <value>3.5</value>
    <index>11</index>
    <index>22</index>
    <index>33</index>
</component>