ansys.mapdl.core.Mapdl.dnsol#

Mapdl.dnsol(node='', item='', comp='', v1='', v2='', v3='', v4='', v5='', v6='', datakey='', **kwargs)#

Defines or modifies solution results at a node.

Mechanical APDL Command: DNSOL

Parameters:
nodestr

Node for which results are specified. If ALL, apply to all selected nodes ( nsel ). If NODE = P, graphical picking is enabled and all remaining command fields are ignored (valid only in the GUI). A component name may also be substituted for NODE.

itemstr

Label identifying results, see DNSOL - Valid Item and Component Labels. Some items also require a component label.

compstr

Component of the item. Valid component labels are shown DNSOL - Valid Item and Component Labels below.

v1str

Value assigned to result. If zero, a zero value will be assigned. If blank, the value remains unchanged. Additional values (if any) assigned to the remaining components (in the order corresponding to the Comp list shown below for the specified Item (starting from the specified Comp label and proceeding to the right).

v2str

Value assigned to result. If zero, a zero value will be assigned. If blank, the value remains unchanged. Additional values (if any) assigned to the remaining components (in the order corresponding to the Comp list shown below for the specified Item (starting from the specified Comp label and proceeding to the right).

v3str

Value assigned to result. If zero, a zero value will be assigned. If blank, the value remains unchanged. Additional values (if any) assigned to the remaining components (in the order corresponding to the Comp list shown below for the specified Item (starting from the specified Comp label and proceeding to the right).

v4str

Value assigned to result. If zero, a zero value will be assigned. If blank, the value remains unchanged. Additional values (if any) assigned to the remaining components (in the order corresponding to the Comp list shown below for the specified Item (starting from the specified Comp label and proceeding to the right).

v5str

Value assigned to result. If zero, a zero value will be assigned. If blank, the value remains unchanged. Additional values (if any) assigned to the remaining components (in the order corresponding to the Comp list shown below for the specified Item (starting from the specified Comp label and proceeding to the right).

v6str

Value assigned to result. If zero, a zero value will be assigned. If blank, the value remains unchanged. Additional values (if any) assigned to the remaining components (in the order corresponding to the Comp list shown below for the specified Item (starting from the specified Comp label and proceeding to the right).

datakeystr

Key to specify which data is modified:

  • AUTO - Nodal-averaged results are used if available. Otherwise, the element-based data is used if available. (Default)

  • ESOL - Only element-based results are used. If they are not available, the command is ignored.

  • NAR - Only nodal-averaged results are used. If they are not available, the command is ignored.

Notes

dnsol can be used only with FULL graphics activated ( graphics,FULL); it will not work correctly with PowerGraphics activated.

dnsol defines or modifies solution results in the database at a node. For example, dnsol,35,U,X,.001,.002,.001 assigns values 0.001, 0.002, and 0.001 to UX, UY, and UZ (respectively) for node 35. All results that are changed in the database, including the nodal degree of freedom results, are available for all subsequent operations. All data is stored in the solution coordinate system but is displayed in the results coordinate system ( rsys ). Use prnsol to list the current results.

Data input by dnsol is stored in temporary space and does not replace information in the database. Therefore, data input by this command may be overwritten if a change is made to the selected set of nodes or if an output operation acts on a new Item.

Issuing dnsol requires you to place the data type (stress/strain) in the element nodal records. To work around this requirement, use the desol command or equivalent path to add a dummy element stress/strain record.

Result items are available depending on element type; check the individual element for availability. Valid item and component labels for element results are shown in DNSOL - Valid Item and Component Labels.

Using dnsol with Nodal-Averaged Results#

If nodal-averaged results ( outres,NAR or another nodal-averaged label) are in the database, then dnsol acts on the nodal-averaged data for the applicable items (S, EPEL, EPPL, EPCR, EPTH, EPSW) by default. You can change this behavior via the DataKey argument.

dnsol behavior differs when the command acts on nodal-averaged results. The nodal-averaged results that are defined or modified will be apparent in subsequent command operations (for example prnsol, plnsol ) in both full model graphics mode ( graphics,FULL) and PowerGraphics mode ( graphics,POWER). The resultant data is stored in the global Cartesian coordinate system but is displayed in the results coordinate system ( rsys ). dnsol can only be applied to nodal-averaged results if they are already in the database; otherwise, the modifications are applied to the element-based solution in temporary memory. The modified nodal-averaged results are not saved to the results file automatically. To save separate records of modified nodal-averaged results, use lcwrite, rappnd, or reswrite.

dnsol can only modify component values ( Comp = X, Y, Z, XY, YZ, or XZ) for nodal- averaged results. If you attempt to modify principal values using dnsol with DataKey = AUTO, then the modification is applied to element-based results if they are available.

DNSOL - Valid Item and Component Labels#

Valid Item and Component Labels for Nodal DOF Results#

Item

Comp

Description

U

X, Y, Z

X, Y, or Z structural displacement.

ROT

X, Y, Z

X, Y, or Z structural rotation.

TEMP[ DNSOL_temp ]

Temperature.

PRES

Pressure.

VOLT

Electric potential.

MAG

Magnetic scalar potential.

V

X, Y, Z

X, Y, or Z fluid velocity.

A

X, Y, Z

X, Y, or Z magnetic vector potential.

CONC

Concentration.

This command contains some tables and extra information which can be inspected in the original documentation pointed above.

For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, use the labels TBOT, TE2, TE3,…, TTOP instead of TEMP.

For these component values, nodal-averaged results are modified if they are available in the results file and DataKey = AUTO or NAR.

Modifying principal values of nodal-averaged results is not supported.