vext

Mapdl.vext(na1='', na2='', ninc='', dx='', dy='', dz='', rx='', ry='', rz='', **kwargs)

Generate additional volumes by extruding areas.

APDL Command: VEXT

Parameters
  • na1 – Set of areas (NA1 to NA2 in steps of NINC) that defines the pattern to be extruded. NA2 defaults to NA1, NINC defaults to 1. If NA1 = ALL, NA2 and NINC are ignored and the pattern is defined by all selected areas. A component name may also be substituted for NA1 (NA2 and NINC are ignored).

  • na2 – Set of areas (NA1 to NA2 in steps of NINC) that defines the pattern to be extruded. NA2 defaults to NA1, NINC defaults to 1. If NA1 = ALL, NA2 and NINC are ignored and the pattern is defined by all selected areas. A component name may also be substituted for NA1 (NA2 and NINC are ignored).

  • ninc – Set of areas (NA1 to NA2 in steps of NINC) that defines the pattern to be extruded. NA2 defaults to NA1, NINC defaults to 1. If NA1 = ALL, NA2 and NINC are ignored and the pattern is defined by all selected areas. A component name may also be substituted for NA1 (NA2 and NINC are ignored).

  • dx – Increments to be applied to the X, Y, and Z keypoint coordinates in the active coordinate system (DR, Dθ, DZ for cylindrical; DR, Dθ, DΦ for spherical).

  • dy – Increments to be applied to the X, Y, and Z keypoint coordinates in the active coordinate system (DR, Dθ, DZ for cylindrical; DR, Dθ, DΦ for spherical).

  • dz – Increments to be applied to the X, Y, and Z keypoint coordinates in the active coordinate system (DR, Dθ, DZ for cylindrical; DR, Dθ, DΦ for spherical).

  • rx – Scale factors to be applied to the X, Y, and Z keypoint coordinates in the active coordinate system (RR, Rθ, RZ for cylindrical; RR, Rθ, RΦ for spherical). Note that the Rθ and RΦ scale factors are interpreted as angular offsets. For example, if CSYS = 1, RX, RY, RZ input of (1.5,10,3) would scale the specified keypoints 1.5 times in the radial and 3 times in the Z direction, while adding an offset of 10 degrees to the keypoints. Zero, blank, or negative scale factor values are assumed to be 1.0. Zero or blank angular offsets have no effect.

  • ry – Scale factors to be applied to the X, Y, and Z keypoint coordinates in the active coordinate system (RR, Rθ, RZ for cylindrical; RR, Rθ, RΦ for spherical). Note that the Rθ and RΦ scale factors are interpreted as angular offsets. For example, if CSYS = 1, RX, RY, RZ input of (1.5,10,3) would scale the specified keypoints 1.5 times in the radial and 3 times in the Z direction, while adding an offset of 10 degrees to the keypoints. Zero, blank, or negative scale factor values are assumed to be 1.0. Zero or blank angular offsets have no effect.

  • rz – Scale factors to be applied to the X, Y, and Z keypoint coordinates in the active coordinate system (RR, Rθ, RZ for cylindrical; RR, Rθ, RΦ for spherical). Note that the Rθ and RΦ scale factors are interpreted as angular offsets. For example, if CSYS = 1, RX, RY, RZ input of (1.5,10,3) would scale the specified keypoints 1.5 times in the radial and 3 times in the Z direction, while adding an offset of 10 degrees to the keypoints. Zero, blank, or negative scale factor values are assumed to be 1.0. Zero or blank angular offsets have no effect.

Return type

str

Returns

str – MAPDL command output.

Examples

Create a basic cylinder by extruding a circle.

>>> k0 = mapdl.k("", 0, 0, 0)
>>> k1 = mapdl.k("", 0, 0, 1)
>>> k2 = mapdl.k("", 0, 0, 0.5)
>>> carc0 = mapdl.circle(k0, 1, k1)
>>> a0 = mapdl.al(*carc0)
>>> mapdl.vext(a0, dz=4)

Create a tapered cylinder.

>>> mapdl.vdele('all')
>>> mapdl.vext(a0, dz=4, rx=0.3, ry=0.3, rz=1)

Notes

Generates additional volumes (and their corresponding keypoints, lines, and areas) by extruding and scaling a pattern of areas in the active coordinate system.

If element attributes have been associated with the input area via the AATT command, the opposite area generated by the VEXT operation will also have those attributes (i.e., the element attributes from the input area are copied to the opposite area). Note that only the area opposite the input area will have the same attributes as the input area; the areas adjacent to the input area will not.

If the areas are meshed or belong to meshed volumes, a 3-D mesh can be extruded with this command. Note that the NDIV argument on the ESIZE command should be set before extruding the meshed areas.

Scaling of the input areas, if specified, is performed first, followed by the extrusion.

In a non-Cartesian coordinate system, the VEXT command locates the end face of the volume based on the active coordinate system. However, the extrusion is made along a straight line between the end faces. Note that solid modeling in a toroidal coordinate system is not recommended.

Caution:: : Use of the VEXT command can produce unexpected results when operating in a non-Cartesian coordinate system. For a detailed description of the possible problems that may occur, see Solid Modeling in the Modeling and Meshing Guide.