feat: add stochastic fem example (#3648)

* feat: activate mathjax ext and add base rst

* chore: adding changelog file 3648.documentation.md [dependabot-skip]

* feat: more content

* feat: added realizations figure

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

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

* feat: more content

* feat: toctree entry and more content

* feat: more content and new figure

* feat: source code files

* feat: a lot of content

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

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

* feat: more content

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

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

* feat: minor corrections

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

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

* fix: implemented review suggestions

* fix: vale errors

* fix: vale errors

* fix: documentation review

* fix: suggestions from code review

Co-authored-by: Kathy Pippert <[email protected]>

* fix: more review comments

* fix: more review suggestions

* fix: final review suggestions

* fix: final review comments

* ci: skipping non-student versions when running on remote

* ci: empty commit to trigger CICD

---------

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

doc/changelog.d/3648.documentation.md

@@ -0,0 +1 @@
+feat: add stochastic fem example

doc/source/conf.py

@@ -103,6 +103,7 @@
     "sphinxemoji.sphinxemoji",
     "sphinx.ext.graphviz",
     "ansys_sphinx_theme.extension.linkcode",
+    "sphinx.ext.mathjax",
 ]
 
 # Intersphinx mapping

doc/source/examples/extended_examples/index.rst

@@ -25,6 +25,8 @@ with other programs, libraries, and features in development.
 +------------------------------------------------------+--------------------------------------------------------------------------------------------+
 | :ref:`hpc_ml_ga_example`                             |  Demonstrates how to use PyMAPDL in a high-performance computing system managed by SLURM.  |
 +------------------------------------------------------+--------------------------------------------------------------------------------------------+
+| :ref:`stochastic_fem_example`                        |  Demonstrates using PyMAPDL for stochastic FEA using Monte Carlo simulation.               |
++------------------------------------------------------+--------------------------------------------------------------------------------------------+
 
 
 .. toctree::
@@ -39,4 +41,5 @@ with other programs, libraries, and features in development.
     executable/executable.rst
     gui/executable.rst
     hpc/hpc_ml_ga.rst
+    sfem/stochastic_fem.rst