plvect

Mapdl.plvect(item='', lab2='', lab3='', labp='', mode='', loc='', edge='', kund='', **kwargs)

Displays results as vectors.

APDL Command: PLVECT

Parameters
  • item – Predefined vector item (from Table 223: PLVECT - Valid Item Labels below) or a label identifying the i-component of a user-defined vector.

  • lab2 – Label identifying the j-component of a user-defined vector. In most cases, this value must be blank if Item is selected from Table 223: PLVECT - Valid Item Labels. Individual principal stresses (Item = S) or principal strains (Item = EPxx) may be plotted by specifying the value as 1, 2, or 3.

  • lab3 – Label identifying the k-component of a user-defined vector. Must be blank if Item is selected from list below or for 2-D user defined vector.

  • labp – Label assigned to resultant vector for display labeling (defaults to Item).

  • mode

    Vector or raster mode override key:

    (blank) - Use the setting of KEY on the /DEVICE command.

    RAST - Use raster mode for PLVECT displays.

    VECT - Use vector mode for PLVECT displays.

  • loc

    Vector location for display of field element results:

    ELEM - Display at element centroid (default).

    NODE - Display at element nodes.

  • edge

    Edge display override key:

    (blank) - Use the setting of Key on the /EDGE command.

    OFF - Deactivate the edge display.

    ON - Activate the edge display.

  • kund

    Undisplaced shape key:

    0 - Display vectors on undeformed mesh or geometry.

    1 - Display vectors on deformed mesh or geometry.

Notes

Displays various solution results as vectors (arrows) for the selected nodes and/or elements (elements must contain at least three nodes that are not colinear). For example, PLVECT,U displays the displacement vector for all selected nodes. For section displays [/TYPE], the vectors are shown only on the section face (i.e., cutting plane). The PLVECT display of principal strains and stresses (Item = S, EPTO, EPEL, EPPL, EPCR, or EPTH) on a “cut” of the model (/TYPE,,1 ,5,7,8, or 9) is not supported. The resulting plot displays the vectors on all selected elements, not on just the sliced surface. See the /VSCALE command to scale vector lengths. Vector magnitudes may be shown as a contour display with the PLNSOL command. Various results also depend upon the recalculation method and the selected results location [LAYER, SHELL, and NSEL].

Items may be selected from a set of recognized vector labels (Item) or a vector may be defined from up to three scalar labels (Item,Lab2,Lab3). Scalar labels may be user-defined with the ETABLE command. The vectors appear on an element display as arrows showing the relative magnitude of the vector and its direction. The predefined items will be shown either at the node or at the element centroid, depending on what item is being displayed and depending on the Loc setting. User defined ETABLE items will be shown at the element centroid, regardless of the Loc setting. Stress vectors appear as arrows at the element centroid, with the arrowheads pointing away from each other for tension and toward each other for compression.

For PowerGraphics, vector arrow displays are generated in Global Cartesian (RSYS = 0). All subsequent displays will revert to your original coordinate system.

When vector mode is active (Mode = VECT), use the Z-buffered display type [/TYPE,,6] to maximize speed of PLVECT plots (other hidden display types may make plotting slow). For PowerGraphics [/GRAPHICS,POWER], the items marked with [1] are not supported by PowerGraphics.

It is possible to plot principal stresses (Item = S) or principal strains (Item = EPxx) individually. To do so, specify a Lab2 value of 1, 2, or 3. For example, the following are valid commands:

Table: 223:: : PLVECT - Valid Item Labels

Not supported by PowerGraphics