Access MAPDL database#
Warning
This feature is still in beta. To report any errors or suggestions, open an issue on GitHub.
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.