extract#

ansXpl.extract(recordname, sets='ALL', asarray=False)#

Import a Matrix/Vector from a MAPDL result file.

At the moment, this only supports reading the displacement vectors from a result file.

Parameters:
recordnamestr

Record name. Currently only supports the "NSL" record, displacement vectors.

setsstr or int

Number of sets. Can be "ALL" or the number of sets to load.

asarraybool, optional

Return a numpy.ndarray rather than a AnsMath. Default False.

Returns:
numpy.ndarray or ansys.math.core.math.AnsMath

A numpy.ndarray or AnsMath of the displacement vectors, depending on the value of asarray.

Notes

This only works on the "NSL" record of MAPDL result files.

Examples

First, open a result file and extract the displacement vectors for all sets.

>>> xpl.open("file.rst")
>>> mat = xpl.extract("NSL")
>>> mat
Dense APDLMath Matrix (243, 10)

Convert to a dense numpy array

>>> arr = mat.asarray()
>>> arr
array([[-9.30806802e-03, -2.39600770e-02, -5.37856729e-03, ...,
        -5.61188243e-03, -7.17686067e-11,  3.71893252e-03],
       [-1.60960014e-02,  2.00410618e-02,  8.05822565e-03, ...,
        -1.26917511e-02, -5.14133724e-11, -1.38783485e-03],
       [ 2.54040694e-02,  3.91901513e-03, -2.67965796e-03, ...,
        -1.46365178e-02,  8.31735188e-11, -2.33109771e-03],
       ...,
       [-2.80679551e-03, -1.45686692e-02,  8.05466291e-03, ...,
         5.88196684e-03,  1.72211103e-02,  6.10079082e-03],
       [-7.06675717e-03,  1.30455037e-02, -6.31685295e-03, ...,
         1.08619340e-02, -1.72211102e-02,  2.52199472e-03],
       [ 2.29726170e-02,  3.54392176e-03, -1.87020162e-03, ...,
         1.20642736e-02,  2.58299321e-11,  9.14504940e-04]])