pltrac

Mapdl.pltrac(analopt='', item='', comp='', trpnum='', name='', mxloop='', toler='', option='', escl='', mscl='', **kwargs)

Displays a particle flow or charged particle trace on an element

APDL Command: PLTRAC display.

Parameters
  • analopt

    Analysis option

    FLUID - Particle trace in fluid flow (default)

    ELEC - Particle trace in electric field

    MAGN - Particle trace in magnetic field

    EMAG - Particle trace in presence of both electric and magnetic fields

  • item – Label identifying the item to be contoured. Valid item labels are shown in Table 222: PLTRAC - Valid Item and Component Labels below. Some items also require a component label. If Item is blank, display only the path trajectory.

  • comp – Component of the item (if required). Valid component labels are shown in Table 222: PLTRAC - Valid Item and Component Labels below.

  • trpnum – Trace point number for storing trajectory data for use with PATH logic. Defaults to 0 (no trajectory path data is stored for further processing with PATH logic).

  • name – Name of prefix of array variable. Defaults to TRAC. NamePOIN stores trajectory path points for trace point number TRPNum. If Analopt = ELEC, MAGN, or EMAG, two additional array parameters, NameDATA and NameLABL, store trajectory path data and labels for the same TRPNum.

  • mxloop – Maximum number of loops traced by a particle. Defaults to 25 for Opt = FLUID; otherwise, defaults to 1000.

  • toler – Length tolerance used for particle trajectory geometry calculation. Valid only for Analopt = ELEC, MAGN, or EMAG. If particle trace appears to terminate inside an element, adjusting the length tolerance may be necessary. Defaults to 1.0 x 10-8.

  • option

    Flow trace option:

    0 - Use the undeformed mesh for computing the flow trace.

    1 - Use the deformed mesh for computing the flow trace.

  • escl – Electric field scale factor. Setting this scale factor affects only the tracing, not the field solution results. A negative factor corresponds to the opposite vector direction. Valid only for Analopt = ELEC or EMAG. Defaults to 1.

  • mscl – Magnetic field scale factor. Setting this scale factor affects only the tracing, not the field solution results. A negative factor corresponds to the opposite vector direction. Valid only for Analopt = MAGN or EMAG. Defaults to 1.

Notes

For a specified item, the variation of the item is displayed along the particle trace as a color-contoured ribbon. The TRPOIN command must be used to define a point on the trajectory path. Multiple traces may be displayed simultaneously by defining multiple trace points. Issue the TRPLIS command to list the current tracing points. Issue the TRPDEL command to delete tracing points defined earlier. Use the PAPUT command with the POIN option to retrieve the particle trajectory points as path points.

The model must be 3-D for the ELEC, MAGN, and EMAG analysis options.

Three array parameters are created at the time of the particle trace: TRACPOIN, TRACDATA and TRACLABL. These array parameters can be used to put the particle velocity and the elapsed time into path form. The procedure to put the arrays into a path named PATHNAME is as follows:

Not used if Analopt = FLUID. If working in the GUI, use the “All information” option to retrieve information from all three arrays at once.

If OPTION is set to 1, the deformed mesh is based on the displacement degrees of freedom UX, UY, and UZ, which must be available in the load step.

Table: 222:: : PLTRAC - Valid Item and Component Labels

See the Basic Analysis Guide for more information on particle flow and charged particle traces. See Animation in the Basic Analysis Guide for information on particle trace animation.

Distributed ANSYS Restriction: This command is not supported in Distributed ANSYS.