doc: ansys shapeopt showcase (#404)

<!--
Please use a PR title that conforms to *conventional commits*:
"<commit_type>: Describe your change"; for example: "fix: prevent race
condition". Some other commit types are: fix, feat, ci, doc, refactor...
For a full list of commit types visit
https://www.conventionalcommits.org/en/v1.0.0/
-->

#### Relevant issue or PR
<!-- If the changes resolve an issue or follow some other PR, link to
them here. Only link something if it is directly relevant. -->

#### Description of changes
<!-- Add a high-level description of changes, focusing on the *what* and
*why*. -->

#### Testing done
<!-- Describe how the changes were tested; e.g., "CI passes", "Tested
manually in stagingrepo#123", screenshots of a terminal session that
verify the changes, or any other evidence of testing the changes. -->

---------

Co-authored-by: Oliver Littlewood <[email protected]>
Co-authored-by: Andrei Paleyes <[email protected]>
Co-authored-by: Andrei Paleyes <[email protected]>
Co-authored-by: Dion Häfner <[email protected]>
Co-authored-by: Nolan Black <[email protected]>

Author: 5 people

demo/_showcase/ansys-shapeopt/.gitignore

@@ -0,0 +1 @@
+/tmp_img

demo/_showcase/ansys-shapeopt/README.md

@@ -0,0 +1,77 @@
+# Ansys Tesseract Integration
+
+This directory contains an example Tesseract configuration and scripts demonstrating how to use Tesseract-JAX with Ansys spaceclaim and PyMAPDL. The overall workflow is illustrated below:
+
+![Workflow](imgs/workflow_1.png)
+
+The main entry point of this demo is `optimization.ipynb`. The evolution of the mesh over the optimization on two different initial conditions can be seen here:
+
+| Grid IC | Random IC |
+|----------|----------|
+| ![Workflow](imgs/mesh_grid_adam.gif)    | ![Workflow](imgs/mesh_rnd_adam.gif)     |
+
+where the loss decay is plotted here:
+
+![Workflow](imgs/loss.png)
+## Get Started
+
+### Prerequisites
+
+A Windows machine A with:
+1. Ansys SpaceClaim + MAPDL installed with an active license.
+2. Python with a virtual environment (e.g. via conda, venv).
+3. Two open ports.
+4. Known IP address, obtain it by running
+
+```powershell
+(Get-NetIPAddress -AddressFamily IPv4 -InterfaceAlias "Wi-Fi","Ethernet" | Where-Object {$_.IPAddress -notlike "169.254.*" -and $_.IPAddress -ne $null}).IPAddress
+```
+
+A machine B, ideally running linux, with:
+1. Docker installed and running.
+2. Python with a virtual environment (e.g. via conda, venv).
+
+### SpaceClaim Tesseract setup
+
+In Windows Powershell, install the the required dependencies by running:
+
+```bash
+pip install tesseract-core[runtime] trimesh
+```
+
+Clone this repository, navigate to `demo/_showcase/ansys-shapeopt/spaceclaim` and start the Tesseract runtime server with:
+
+```bash
+tesseract-runtime serve --port <port_number_1> --host 0.0.0.0
+```
+Note that we do not build a Tesseract Docker image for SpaceClaim in this example. Instead, we use an existing SpaceClaim installation directly from the host machine. More details about this Tesseract can be found [here](https://docs.pasteurlabs.ai/projects/tesseract-core/latest/content/examples/ansys_integration/spaceclaim_tess.html).
+
+### PyMAPDL Server
+
+On machine A, run the following Powershell command to start Ansys with gRPC server enabled:
+
+```powershell
+Start-Process -FilePath "F:\ANSYS Inc\v242\ansys\bin\winx64\ANSYS242.exe" -ArgumentList "-grpc", "-port", "<port_number_2>"
+```
+
+replace "v242" with your Ansys version and ensure the path is correct. More details about PyMAPDL Tesseract can be found [here](https://docs.pasteurlabs.ai/projects/tesseract-core/latest/content/examples/ansys_integration/pymapdl_tess.html).
+
+### Building Tesseracts
+
+On machine B, navigate to `demo/_showcase/ansys-shapeopt/` and run
+
+```bash
+pip install -r requirements.txt
+```
+
+and build the needed tesseracts using
+
+```bash
+tesseract build spaceclaim
+tesseract build pymapdl
+tesseract build sdf_fd
+```
+
+### Run the notebook
+
+At this stage you are ready to run the main notebook [optimization.ipynb](optimization.ipynb).