Access MAPDL database

Warning

This feature is still in beta. Report any errors or suggestions to pyansys.support@ansys.com.

In PyMAPDL v0.61.2 and later, you can access elements and nodes data from the MAPDL database using the DB module.

Usage

Get the elems and nodes objects.

>>> from ansys.mapdl.core import launch_mapdl
>>> from ansys.mapdl.core.examples import vmfiles
>>> mapdl = launch_mapdl()
>>> mapdl.input(vmfiles["vm271"])
>>> elems = mapdl.db.elems
>>> elems
MAPDL Database Elements
   Number of elements:          3459
   Number of selected elements: 3459
   Maximum element number:      3459

>>> nodes = mapdl.db.nodes
MAPDL Database Nodes
   Number of nodes:          3652
   Number of selected nodes: 3652
   Maximum node number:      3652

Obtain the first element.

>>> elems = mapdl.db.elems
>>> elems.first()
1

Check if the element is selected.

>>> from ansys.mapdl.core.database import DBDef
>>> elems.info(1, DBDef.DB_SELECTED)

Return the element information of element 1.

>>> elems = mapdl.db.elems
>>> elem_info = elems.get(1)
>>> elem_info
ielem: 1
elmdat: 1
elmdat: 1
elmdat: 1
elmdat: 1
elmdat: 0
elmdat: 0
elmdat: 12
elmdat: 0
elmdat: 0
elmdat: 0
nnod: 2
nodes: 1
nodes: 3

Return the nodes belonging to the element.

>>> elem_info.nodes
[1, 3]

Return the element data.

>>> elem_info.elmdat
[1, 1, 1, 1, 0, 0, 12, 0, 0, 0]

Return the selection status and the coordinates of node 22.

>>> nodes = mapdl.db.nodes
>>> sel, coord = nodes.coord(22)
>>> coord
(-0.0014423144202849985, 0.010955465718673852, 0.0, 0.0, 0.0, 0.0)

Note

The coordinates returned by the coord method contain the following: X, Y, Z, THXY, THYZ, and THZX.

Requirements

To use the DB feature, you must meet these requirements:

• ansys.api.mapdl package version should be 0.5.1 or later.

• Ansys MAPDL version should be 2021 R1 or later.

Warning

This feature does not work in the Ansys 2023 R1.