.. _Parallel3D:

Parallel3D Material Wrapper
^^^^^^^^^^^^^^^^^^^^^^^^^^^

This command is used to construct a Parallel3D material object. It is a wrapper that imposes an iso-strain condition to an arbitrary number of previously-defined 3D nDMaterial objects. Therefore, in each sub-material the strains are equal, the parallel stress and tangent are equal to the (weighted) sum of those of the sub-materials.


.. function:: nDMaterial Parallel3D $matTag    $tag1 $tag2 ... $tagN   <-weights $w1 $w2 ... $wN>


.. csv-table:: 
   :header: "Argument", "Type", "Description"
   :widths: 10, 10, 40

   $matTag, |integer|, "unique tag identifying this series material wrapper"
   $tag1 $tag2 ... $tagN, N |integer|, "unique tags identifying previously defined nD materials"
   $w1 $w2 ... $wN, N |float|, "weight factors, optional. If not defined, they will be assumed all equal to 1"

Usage Notes
"""""""""""

.. admonition:: Limitations

   * The only material formulation for the Parallel3D material object is "ThreeDimensional".
   * The only material formulation allowed for the sub-material objects is "ThreeDimensional".

.. admonition:: Responses

   * All responses available for the nDMaterial object: **stress** (or **stresses**), **strain** (or **strains**), **tangent** (or **Tangent**), **TempAndElong**.
   * **material** **$matId** ... : use the **material** keyword followed by the 1-based index of the sub-material (and followed by the desired response) to forward the request to the matId sub-material.
   * **homogenized** ... : use the **homogenized** keyword followed by the desired response to forward the request to all sub-materials, and to compute its weighted average.

.. admonition:: Example 1 - Simple Linear Validation

   | :download:`Parallel3DExample1.py`

Code Developed by: **Massimo Petracca** at ASDEA Software, Italy.