blc5#

Primitives.blc5(xcenter='', ycenter='', width='', height='', depth='', **kwargs)#

Creates a rectangular area or block volume by center and corner points.

Mechanical APDL Command: BLC5

Parameters:
xcenterstr

Working plane X and Y coordinates of the center of the rectangle or block face.

ycenterstr

Working plane X and Y coordinates of the center of the rectangle or block face.

widthstr

The total distance on or parallel to the working plane X-axis defining the width of the rectangle or block face.

heightstr

The total distance on or parallel to the working plane Y-axis defining the height of the rectangle or block face.

depthstr

The perpendicular distance (either positive or negative based on the working plane Z direction) from the working plane representing the depth of the block. If DEPTH = 0 (default), a rectangular area is created on the working plane. If you are working with a model imported from an IGES file (import option set to DEFAULT), you must supply a value for DEPTH or the command is ignored.

Returns:
int

Volume or area number of the block or rectangle.

Notes

Defines a rectangular area anywhere on the working plane or a hexahedral volume with one face anywhere on the working plane by specifying the center and corner points. A rectangle will be defined with four keypoints and four lines. A volume will be defined with eight keypoints, twelve lines, and six areas, with the top and bottom faces parallel to the working plane. See the blc4, rectng, and block commands for alternate ways to create rectangles and blocks.

Examples

Create a square centered at (0, 0) with a width of 0.5 and a height of 0.5

>>> anum = mapdl.blc5(width=0.5, height=0.5)
>>> anum
1
>>> vnum = mapdl.blc5(width=1, height=4, depth=9)
>>> vnum
1