feat: prep7 - part 2 (#4262)

* feat: prep7 - 2

* ci: auto fixes from pre-commit.com hooks.

for more information, see https://pre-commit.ci

* chore: adding changelog file 4262.added.md [dependabot-skip]

* ci: auto fixes from pre-commit.com hooks.

for more information, see https://pre-commit.ci

* ci: auto fixes from pre-commit.com hooks.

for more information, see https://pre-commit.ci

* fix: typo in ``commands.py``

* fix: removing ``edasmp`` mentions as deleted

* fix: removing ``edbound`` mentions as deleted

* fix: removing ``edbx`` mentions as deleted

* fix: pre-commit

* fix: removing ``edcgen``, ``edclist``, ``edcmore``, ``edcnstr``, ``edcontact``, ``edcrb``, ``edcurve``, ``edcadapt``, ``edcpu``, ``edcsc`` and ``edcts`` as removed

* fix: removing all the deprecated ``ED*`` commands

* revert: pre-commit change

* fix: removing ``rexport`` as removed

* ci: auto fixes from pre-commit.com hooks.

for more information, see https://pre-commit.ci

* fix: pre-commit

* fix: ``tbft`` command

* fear: adding `ExplicitDynamics` class

* feat: readding ``DEPRECATED_COMMANDS``

* fix: pre-commit

* fix: adding missing doc

* feat: reverting changes in ``madpl_extended``

* fix: adding ExplicitDynamics in ``commands.py``

* Update src/ansys/mapdl/core/_commands/prep7/keypoints.py

Co-authored-by: Copilot <[email protected]>

* fix: image rendering

* fix: extra space

* fix: pdf error

* fix: svg images

* ci: auto fixes from pre-commit.com hooks.

for more information, see https://pre-commit.ci

* fix: svg images - 2

* fix: permission error

* fix: svg images

* test: svg images only on html

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: pyansys-ci-bot <[email protected]>
Co-authored-by: German <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Revathyvenugopal162 <[email protected]>

Author: 6 people

.github/workflows/doc-build.yml

@@ -257,7 +257,9 @@ jobs:
         if: ${{ inputs.build_pdf }}
         working-directory: doc
         shell: bash
-        run: make pdf
+        run: |
+          sudo apt-get install -y inkscape
+          make pdf
 
       - name: "Show latex dir"
         if: ${{ inputs.build_pdf }}

doc/changelog.d/4262.added.md

@@ -0,0 +1 @@
+\`\`prep7\`\` - part 2

doc/source/conf.py

@@ -14,10 +14,12 @@
 from plotly.io._sg_scraper import plotly_sg_scraper
 import pyvista
 from sphinx.application import Sphinx
+from sphinx.builders.latex import LaTeXBuilder
 from sphinx.util import logging
 from sphinx_gallery.sorting import FileNameSortKey
 
 pio.renderers.default = "sphinx_gallery"
+LaTeXBuilder.supported_image_types = ["image/png", "image/pdf", "image/svg+xml"]
 
 from ansys.mapdl import core as pymapdl
 from ansys.mapdl.core import __version__
@@ -130,7 +132,6 @@
 }
 
 suppress_warnings = ["label.*", "design.fa-build", "config.cache"]
-sd_fontawesome_latex = True
 
 # Graphviz diagrams configuration
 graphviz_output_format = "png"
@@ -376,10 +377,21 @@
 
 
 # -- Options for LaTeX output ------------------------------------------------
-latex_elements: dict[Any, Any] = {}
+latex_elements: dict[Any, Any] = {
+    "preamble": r"""
+\usepackage[inkscapelatex=false]{svg}
+\usepackage{graphicx}
+    """,
+    # Enable shell escape for SVG conversion
+    "extraclassoptions": "openany",
+}
 
 latex_engine = "xelatex"
 
+# Enable shell escape for SVG package (requires inkscape or rsvg-convert installed)
+latex_use_xindy = False
+latex_additional_files = []
+
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).

doc/source/mapdl_commands/prep7/database.rst

@@ -1,28 +1,31 @@
-.. _ref_database_commands_api:
 
-********
+.. _ref_database:
+
+
 Database
-********
+========
+
 
-.. currentmodule:: ansys.mapdl.core
+.. currentmodule:: ansys.mapdl.core._commands.prep7.database
 
-These PREP7 commands are used to read model data into the database,
-list out the database, and control the numbering of entities in the
-database.
+.. autoclass:: ansys.mapdl.core._commands.prep7.database.Database
 
 .. autosummary::
-   :toctree: _autosummary/
-
-   Mapdl.aflist
-   Mapdl.cdread
-   Mapdl.cdwrite
-   Mapdl.cdopt
-   Mapdl.cecheck
-   Mapdl.check
-   Mapdl.igesout
-   Mapdl.mfimport
-   Mapdl.nooffset
-   Mapdl.numcmp
-   Mapdl.nummrg
-   Mapdl.numoff
-   Mapdl.numstr
+   :template: base.rst
+   :toctree: _autosummary
+
+
+   Database.aflist
+   Database.cdopt
+   Database.cdread
+   Database.cdwrite
+   Database.cecheck
+   Database.check
+   Database.cncheck
+   Database.escheck
+   Database.igesout
+   Database.nooffset
+   Database.numcmp
+   Database.nummrg
+   Database.numoff
+   Database.numstr

doc/source/mapdl_commands/prep7/digitizing.rst

@@ -1,22 +1,25 @@
-.. _ref_element_type_commands_api:
 
-************
-Element type
-************
+.. _ref_element_type:
 
-.. currentmodule:: ansys.mapdl.core
 
-These PREP7 commands define the type of elements to be used in the model.
+ElementType
+===========
+
+
+.. currentmodule:: ansys.mapdl.core._commands.prep7.element_type
+
+.. autoclass:: ansys.mapdl.core._commands.prep7.element_type.ElementType
 
 .. autosummary::
-   :toctree: _autosummary/
-
-   Mapdl.dof
-   Mapdl.elbow
-   Mapdl.et
-   Mapdl.etchg
-   Mapdl.etcontrol
-   Mapdl.etdele
-   Mapdl.etlist
-   Mapdl.keyopt
-   Mapdl.nsvr
+   :template: base.rst
+   :toctree: _autosummary
+
+
+   ElementType.dof
+   ElementType.et
+   ElementType.etchg
+   ElementType.etcontrol
+   ElementType.etdele
+   ElementType.etlist
+   ElementType.keyopt
+   ElementType.nsvr

doc/source/mapdl_commands/prep7/element_type.rst

@@ -1,54 +1,62 @@
-.. _ref_elements_commands_api:
 
-********
+.. _ref_elements:
+
+
 Elements
-********
+========
+
 
-.. currentmodule:: ansys.mapdl.core
+.. currentmodule:: ansys.mapdl.core._commands.prep7.elements
 
-These PREP7 commands are used to create, modify, list, etc., elements.
+.. autoclass:: ansys.mapdl.core._commands.prep7.elements.Elements
 
 .. autosummary::
-   :toctree: _autosummary/
-
-   Mapdl.afsurf
-   Mapdl.e
-   Mapdl.ecpchg
-   Mapdl.edele
-   Mapdl.eextrude
-   Mapdl.egen
-   Mapdl.einfin
-   Mapdl.eintf
-   Mapdl.elist
-   Mapdl.emid
-   Mapdl.emodif
-   Mapdl.emore
-   Mapdl.emtgen
-   Mapdl.en
-   Mapdl.endrelease
-   Mapdl.engen
-   Mapdl.enorm
-   Mapdl.ensym
-   Mapdl.eread
-   Mapdl.ereinf
-   Mapdl.errang
-   Mapdl.esurf
-   Mapdl.esym
-   Mapdl.ewrite
-   Mapdl.gcdef
-   Mapdl.gcgen
-   Mapdl.inistate
-   Mapdl.laylist
-   Mapdl.layplot
-   Mapdl.lfsurf
-   Mapdl.ndsurf
-   Mapdl.shsd
-   Mapdl.swadd
-   Mapdl.swdel
-   Mapdl.swgen
-   Mapdl.swlist
-   Mapdl.tshap
-   Mapdl.upgeom
-   Mapdl.usrdof
-   Mapdl.usrelem
-   Mapdl.wtbcreate
+   :template: base.rst
+   :toctree: _autosummary
+
+
+   Elements.afsurf
+   Elements.dflab
+   Elements.e
+   Elements.ecpchg
+   Elements.edele
+   Elements.eembed
+   Elements.egen
+   Elements.egid
+   Elements.einfin
+   Elements.eintf
+   Elements.elbow
+   Elements.elist
+   Elements.emid
+   Elements.emodif
+   Elements.emore
+   Elements.emsel
+   Elements.emtgen
+   Elements.en
+   Elements.endrelease
+   Elements.engen
+   Elements.enorm
+   Elements.ensym
+   Elements.eplot
+   Elements.eread
+   Elements.ereinf
+   Elements.errang
+   Elements.esurf
+   Elements.esym
+   Elements.ewrite
+   Elements.gcdef
+   Elements.gcgen
+   Elements.laylist
+   Elements.layplot
+   Elements.lfsurf
+   Elements.ndsurf
+   Elements.shsd
+   Elements.swadd
+   Elements.swdel
+   Elements.swgen
+   Elements.swlist
+   Elements.tshap
+   Elements.upgeom
+   Elements.usrdof
+   Elements.usrelem
+   Elements.wtbcreate