CPT217


3D 10-Node Coupled Pore-Pressure-Thermal Mechanical Solid

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

CPT217 Element Description

CPT217 is a higher-order 3D 10-node coupled physics solid element capable of modeling coupled physics phenomena such as structural-pore-fluid-diffusion-thermal analysis and structural implicit gradient regularization using a nonlocal field. The element has a quadratic displacement, and linear pore-pressure and temperature behavior.

The element is defined by 10 nodes and can have the following degrees of freedom at each corner node:

  • Translations in the nodal x, y, and z directions

  • Pore-pressure (PRES)

  • Temperature (TEMP)

  • Nonlocal field values (GFV1, GFV2, GFV3)

and three degrees of freedom at midside nodes:

  • Translations in the nodal x, y, and z directions

CPT217 has elasticity, stress stiffening, large deflection, and large strain capabilities. See CPT217 for more details about this element.

Figure 217.1: CPT217 Geometry

CPT217 Geometry

CPT217 Input Data

The geometry, node locations, and the coordinate system for this element are shown in Figure 217.1: CPT217 Geometry.

In addition to the nodes, for structural-pore-fluid-diffusion-thermal analysis, the element input data includes the orthotropic material properties. Orthotropic material directions correspond to the element coordinate directions. The element coordinate system orientation is as described in the Material Reference.

Element loads are described in Element Loading. Loads can be input (SF and SFE) on the element faces indicated by the circled numbers in Figure 217.1: CPT217 Geometry. Positive pressures act into the element. Positive pressures act into the element. Body loads may be input (BF and BFE) at the element nodes or as a single element value. Nodal forces can be applied to the nodes directly (F).

CPT217 surface, body, and nodal-force loads are given in Table 217.1: CPT217 Surface, Body, and nodal-force loads. Also see Loading Types in the Coupled-Field Analysis Guide.

Most loads can be defined as a function of primary variables by using tabular input. For more information, see Applying Loads Using Tabular Input in the Basic Analysis Guide and the descriptions of individual loading commands in the Command Reference.

Table 217.1: CPT217 Surface, Body, and nodal-force loads

Coupled-Field AnalysisKEYOPTLoad TypeLoadCommand Label
Structural-thermalKEYOPT(11) = 1SurfaceStructural surface pressurePRES
Heat fluxHFLUX
BodyHeat generationHGEN
Nodal ForceHeat flowHEAT
Structural-pore-fluid-diffusionKEYOPT(12) = 1SurfaceStructural surface pressurePRES
Surface flow fluxFFLX
BodyFlow sourceFSOU
TemperatureTEMP
Nodal ForceFluid flowFLOW
Structural-pore-fluid-diffusion-thermalKEYOPT(11) = 1 and KEYOPT(12) = 1SurfaceStructural surface pressurePRES
Heat fluxHFLUX
Surface flow fluxFFLX
BodyHeat generationHGEN
Flow sourceFSOU
Nodal ForceHeat flowHEAT
Fluid flowFLOW
Structural implicit gradient regularizationKEYOPT(18) = 1, 2, or 3SurfaceStructural surface pressurePRES
BodyTemperatureTEMP

As described in Coordinate Systems, you can use the ESYS command to orient the material properties and strain/stress output. Issue the RSYS command to choose output that follows the material coordinate system or the global coordinate system.

The element generally produces an unsymmetric matrix. To avoid convergence difficulty, use the unsymmetric solver (NROPT,UNSYM).

The following table summarizes the element input. Element Input gives a general input description.

CPT217 Input Summary

Nodes

I, J, K, L, M, N, O, P, Q, R

Degrees of Freedom

UX, UY, UZ, PRES, TEMP, GFV1, GFV2, GFV3

Real Constants

None

Material Properties
TB command: See Element Support for Material Models for this element.
MP command: EX, EY, EZ, ALPX, ALPY, ALPZ (or CTEX, CTEY, CTEZ or THSX, THSY, THSZ), PRXY, PRYZ, PRXZ (or NUXY, NUYZ, NUXZ), DENS, GXY, GYZ, GXZ, ALPD, BETD
Surface Loads
Body Loads
Special Features
KEYOPT(6)

Element formulation in coupled-field analyses with structural degrees of freedom:

0 -- 

Pure displacement formulation (default)

1 -- 

Mixed u-P formulation

KEYOPT(11)

Temperature degree of freedom:

0 -- 

Disabled (default)

1 -- 

Enabled

KEYOPT(12)

Pressure degree of freedom:

0 -- 

Disabled (default)

1 -- 

Enabled

KEYOPT(18)

Nonlocal degree of freedom:

0 -- 

Disabled (default)

1 -- 

Enabled (adds one extra degree of freedom per node)

2 -- 

Enabled (adds two extra degrees of freedom per node)

3 -- 

Enabled (adds three extra degrees of freedom per node)

CPT217 Output Data

The solution output associated with the element is in two forms:

By default, the integration point results are copied to the nodes (ERESX).

The element stress directions are parallel to the element coordinate system, as shown in Figure 217.2: CPT217 Stress Output. A general description of solution output is given in The Item and Sequence Number Table. See the Basic Analysis Guide for ways to view results.

Figure 217.2: CPT217 Stress Output

CPT217 Stress Output


The Element Output Definitions table uses the following notation:

A colon (:) in the Name column indicates that the item can be accessed by the Component Name method (ETABLE, ESOL). The O column indicates the availability of the items in the file jobname.out. The R column indicates the availability of the items in the results file.

In either the O or R columns, Y indicates that the item is always available, a number refers to a table footnote that describes when the item is conditionally available, and - indicates that the item is not available. All output is available only if calculated (based on input values).

Table 217.2: CPT217 Element Output Definitions

NameDefinitionOR
ALL ANALYSES
ELElement number-Y
NODESNodes - I, J, K, L -Y
MATMaterial number-Y
THICKThickness-Y
VOLUVolume-Y
XC, YCLocation where results are reportedY1
ALL ANALYSES WITH A STRUCTURAL FIELD
S:X, Y, Z, XYStressesYY
S:1, 2, 3Principal stresses-Y
S:INTStress intensity-Y
S:EQVEquivalent stressYY
EPEL:X, Y, Z, XYElastic strainsYY
EPEL:1, 2, 3Principal elastic strains-Y
EPEL:EQVEquivalent elastic strain [2]YY
EPTH:X, Y, Z, XYThermal strainsYY
EPTH:EQVEquivalent thermal strain [2]-Y
EPPL:X, Y, Z, XYPlastic strains-Y
EPPL:EQVEquivalent plastic strain [2]-Y
EPTO:X, Y, Z, XYTotal mechanical strains (EPEL + EPPL)-Y
EPTO:EQVTotal equivalent mechanical strain (EPEL + EPPL)-Y
TEMPTemperatures T(I), T(J), T(K), T(L)-Y
ADDITIONAL OUTPUT FOR ANALYSES WITH A TEMPERATURE FIELD
TG:X, YThermal gradient components-Y
TF:X, YThermal flux components-Y
ADDITIONAL OUTPUT FOR ANALYSES WITH A PORE-PRESSURE FIELD
ESIG:X, Y, Z, XYEffective stresses-Y
FGRA:X, YFluid pore-pressure gradient components-Y
FFLX:X, YFluid flow flux components-Y
PMSV:VRAT,PPRE,DSAT,RPERVoid volume ratio, pore pressure, degree of saturation, and relative permeability-Y
EPFRFree strain-Y
ADDITIONAL OUTPUT FOR ANALYSES WITH A NONLOCAL FIELD
MPDP:TOTA,TENS,COMP,RWMicroplane homogenized total, tension, and compression damages (TOTA, TENS, COMP), and split weight factor (RW).-Y
DAMAGE: 1,2,3,MAXDamage in directions 1, 2, 3 (1, 2, 3) and the maximum damage (MAX).-Y
GMDGDamage-Y
IDISStructural-thermal dissipation rate-Y

  1. Available only at centroid as a *GET item.

  2. The equivalent strains use an effective Poisson's ratio: for elastic and thermal this value is set by the user (MP,PRXY); for plastic and creep this value is set at 0.5.

Table 217.3: CPT217 Item and Sequence Numbers lists output available via the ETABLE command using the Sequence Number method. See The General Postprocessor (POST1) in the Basic Analysis Guide and The Item and Sequence Number Table in this document for more information. The following notation is used in the table:

Name

Output quantity as defined in Table 217.2: CPT217 Element Output Definitions

Item

Predetermined Item label for ETABLE command

I,J,...,R

Sequence number for data at nodes I, J, ..., R

Table 217.3: CPT217 Item and Sequence Numbers

Output Quantity NameETABLE and ESOL Command Input
ItemIJKLM,...,R
P1SMISC213--
P2SMISC45-6-
P3SMISC-789-
P4SMISC11-1012-

CPT217 Assumptions and Restrictions

  • The element must not have a zero volume.

  • Elements may be numbered either as shown in Figure 217.1: CPT217 Geometry or may have node L below the I, J, K plane.

  • An edge with a removed midside node implies that the displacement varies linearly, rather than parabolically, along that edge. For information about using midside nodes, see Quadratic Elements (Midside Nodes).

  • Stress stiffening is always included in geometrically nonlinear analyses (NLGEOM,ON). It is ignored in geometrically linear analyses (NLGEOM,OFF). Prestress effects can be activated via the PSTRES command.

CPT217 Product Restrictions

There are no product-specific restrictions for this element.