ansys.mapdl.core.Mapdl.sfgrad#

Mapdl.sfgrad(lab='', slkcn='', sldir='', slzer='', slope='', **kwargs)#

Specifies a gradient (slope) for surface loads.

Mechanical APDL Command: SFGRAD

Parameters:
labstr

Valid surface load label. Load labels are listed under “Surface Loads” in the input table for each element type in the Element Reference.

This command contains some tables and extra information which can be inspected in the original

documentation pointed above… _sfgrad1:

Thermal labels CONV and HFLUX are mutually exclusive.

slkcnstr

Reference number of slope coordinate system (used with Sldir and SLZER to determine COORD). Defaults to 0 (the global Cartesian coordinate system).

sldirstr

Slope direction in coordinate system SLKCN :

  • X - Slope is along X direction (default). Interpreted as R direction for non-Cartesian coordinate systems.

  • Y - Slope is along Y direction. Interpreted as θ direction for non-Cartesian coordinate systems.

  • Z - Slope is along Z direction. Interpreted as Φ direction for spherical or toroidal coordinate systems.

slzerstr

Coordinate location (degrees for angular input) where slope contribution is zero (CVALUE = VALUE). Allows the slope contribution to be shifted along the slope direction. For angular input, SLZER should be between ±180° if the singularity ( cscir ) is at 180° and should be between 0° and 360° if the singularity is at 0°.

slopestr

Slope value (load per unit length or per degree).

Notes

Specifies a gradient (slope) for surface loads. All surface loads issued with the sf, sfe, sfl, or sfa commands while this specification is active will have this gradient applied (for complex pressures, only the real component will be affected; for convections, only the bulk temperature will be affected). The load value, CVALUE, calculated at each node is:

CVALUE = VALUE + ( SLOPE X (COORD- SLZER ))

where VALUE is the load value specified on the subsequent sf, sfe, sfl, or sfa commands and COORD is the coordinate value (in the Sldir direction of coordinate system SLKCN ) of the node. Only one sfgrad specification may be active at a time (repeated use of this command replaces the previous specification with the new specification). Issue sfgrad (with blank fields) to remove the specification. Issue sfgrad,STAT to show the current command status. The sfgrad specification (if active) is removed when the lsread (if any) command is issued.

sfgrad does not work for tabular boundary conditions.

In a mode-superposition harmonic or transient analysis, you must apply the load in the modal portion of the analysis. Mechanical APDL calculates a load vector and writes it to the MODE file, which you can apply via the lvscale command.

This command is also valid in PREP7.