Strange/incorrect docs examples in ansys.mapdl.core.math

[jgd10]

Describe the bug
Some of the examples in the docstrings in ansys.mapdl.core.math don't seem to be correct, although I'm not sure if it's this or if they are just unclear.

For example:

class AnsMat(ApdlMathObj):
...
    def asarray(self):
        """Returns vector as a numpy array

        Examples
        --------
        >>> from ansys.mapdl import Mapdl
        >>> mm = mapdl.math()
        >>> v = mm.ones(10)
        >>> v.asarray()
        [1. 1. 1. 1. 1. 1. 1. 1. 1. 1.]
        """
        return self._mapdl._mat_data(self.id)

The example given uses the mapdl namespace but doesn't import it, and the import is importing Mapdl which isn't available at the level it is shown at. So I am assuming that it should read:

from ansys.mapdl.core import launch_mapdl
mapdl = launch_mapdl()
mm = mapdl.math()
v = mm.ones(10)
v.asarray()

Am I understanding this correctly?

I noticed other ineeresting examples in the following docstirngs:

• MapdlMath init
• AnsVec asarray
• AnsMat T

[akaszynski]

This is broken and uses the older API and we need to fix this.

[jgd10]

OK I'll take this on for now