Mapdl.cyclic(nsector='', angle='', kcn='', name='', usrcomp='', usrnmap='', **kwargs)

Specifies a cyclic symmetry analysis.


  • nsector

    The number of sectors in the full 360 degrees, or one of the following options:

    STATUS - Indicates the current cyclic status.

    OFF - Resets model to normal (non-cyclic) status and removes the duplicate sector if

    it exists. This option also deletes automatically detected edge components (generated when USRCOMP = 0).

    UNDOUBLE - Removes the duplicate sector if it exists. The duplicate sector is created

    during the solution (SOLVE) stage of a modal cyclic symmetry analysis.

  • angle – The sector angle in degrees.

  • kcn – An arbitrary reference number assigned to the cyclic coordinate system. The default value of 0 specifies automatic detection.

  • name – The root name of sector low- and high-edge components (line, area, or node components). The default root name (when USRCOMP = 0) is “CYCLIC”. A root name that you specify can contain up to 11 characters.

  • usrcomp – The number of pairs of user-defined low- and high-edge components on the cyclic sector (if any). The default value of 0 specifies automatic detection of sector edges; however, the automatic setting is not valid in all cases. (For more information, see the Notes section below.) If the value is greater than 0, no verification of user-defined components occurs.

  • usrnmap – The name of a user-defined array specifying the matching node pairs between the sector low and high edges. Valid only when USRCOMP = 0. Skips the automatic detection of sector edges. Node pairs may be input in any order, but the low edge node must be the first entry in each pair.


You can input your own value for NSECTOR, ANGLE or KCN; if you do so, the command verifies argument values before executing.

When USRCOMP = 0 and USRNMAP = blank (default), the CYCLIC command automatically detects low- and high-edge components for models comprised of any combination of line, area, or volume elements. If a solid model exists, however, the command uses only the lines, areas, and/or volumes to determine the low- and high-edge components; the elements, if any, are ignored.

Nodes will be automatically rotated unless CYCOPT,USERROT,YES has been specified.

If you issue a CYCOPT,TOLER command to set a tolerance for edge- component pairing before issuing the CYCLIC command, the CYCLIC command uses the specified tolerance when performing automatic edge-component detection.

For 2-D models, autodetection does not consider the CSYS,5 or CSYS,6 coordinate system specification. Autodetection for 180 degree (two- sector) models is not possible unless a central hole exists.

The CYCLIC command sets values and keys so that, if possible, the area- mesh (AMESH) or volume-mesh (VMESH) command meshes the sector with matching node and element face patterns on the low and high edges. (The command has no effect on any other element-creation command.)

Issue the CYCLIC command prior to the meshing command to, if possible, produce a mesh with identical node and element patterns on the low and high sector edges. Only the AMESH or VMESH commands can perform automated matching. (Other meshing operation commands such as VSWEEP cannot.) If you employ a meshing operation other than AMESH or VMESH, you should ensure that node and element face patterns match, if desired. The CYCLIC command output indicates whether each edge- component pair has or can produce a matching node pair.

A cyclic solution (via the SOLVE command) allows dissimilar mesh patterns on the extreme boundaries of a cyclically symmetric model. The allowance for dissimilar patterns is useful when you have only finite- element meshes for your model but not the geometry data necessary to remesh it to obtain identical node patterns. In such cases, it is possible to obtain solution results, although perhaps at the expense of accuracy. A warning message appears because results may be degraded near the sector edges.

The constraint equations (CEs) that tie together the low and high edges of your model are generated at the solution stage of the analysis from the low- and high-edge components (and nowhere else). You should verify that automatically detected components are in the correct locations and that you can account for all components; to do so, you can list (CMLIST) or plot (CMPLOT) the components.

If you issue the CYCLIC command after meshing and have defined element types with rotational degrees of freedom (DOFs), ANSYS generates cyclic CEs for rotational DOFs that may not exist on the sector boundaries. Issue the CYCOPT,DOF command to prevent unused rotational terms from being generated.

Modal cyclic symmetry analysis is supported by the following eigensolvers:

Block Lanczos (MODOPT,LANB)




To learn more about analyzing a cyclically symmetric structure, see the Cyclic Symmetry Analysis Guide.

When using the: CYCLIC: command to automatically detect the sector, if an area is defined with the: AL: command, the lines need to be oriented to form the closed curve.