# ANSYS

This document describes generic information of how to load and run ANSYS software in the Merlin cluster

## ANSYS software in Pmodules

The ANSYS software can be loaded through **[PModules](../how-to-use-merlin/using-modules.md)**.

The default ANSYS versions are loaded from the central PModules repository.
However, there are some known problems that can pop up when using some specific ANSYS packages in advanced mode.
Due to this, and also to improve the interactive experience of the user, ANSYS has been also installed in the
Merlin high performance storage and we have made it available from Pmodules.

### Loading Merlin6 ANSYS

For loading the Merlin6 ANSYS software, one needs to run Pmodules v1.1.4 or newer, and then use a specific repository
(called **`merlin`**) which is ***only available from the Merlin cluster***:

```bash
module use unstable
module load Pmodules/2.0.4
module use merlin
module load ANSYS/2024R2
```

Once `merlin` is invoked, it will disable central ANSYS installations with the same version, which will be replaced
by the local ones in Merlin. Releases from the central Pmodules repository which have not a local installation will remain
visible. For each ANSYS release, one can identify where it is installed by searching ANSYS in PModules with the `--verbose`
option. This will show the location of the different ANSYS releases as follows:

* For ANSYS releases installed in the central repositories, the path starts with `/opt/psi`
* For ANSYS releases installed in the Merlin6 repository (and/or overwritting the central ones), the path starts with `/data/software/pmodules`

??? note "[Example] Loading ANSYS from the Merlin6 PModules repository"
    ```console
    (base) ❄ [caubet_m@merlin-l-001:/data/user/caubet_m]# module use unstable
    (base) ❄ [caubet_m@merlin-l-001:/data/user/caubet_m]# module load Pmodules/2.0.4
    (base) ❄ [caubet_m@merlin-l-001:/data/user/caubet_m]# module use merlin

    (base) ❄ [caubet_m@merlin-l-001:/data/user/caubet_m]# module search ANSYS

    Module       Rel.stage  Group        Overlay      Requires
    --------------------------------------------------------------------------------
    ANSYS/2022R1 stable     Tools        merlin
    ANSYS/2022R2 stable     Tools        merlin
    ANSYS/2023R2 unstable   Tools        merlin
    ANSYS/2024R1 unstable   Tools        merlin
    ANSYS/2024R2 unstable   Tools        merlin
    (base) ❄ [caubet_m@merlin-l-001:/data/user/caubet_m]# module search ANSYS --verbose
    ANSYS/2022R1:
      release stage: stable
      group:         Tools
      overlay:       merlin
      modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2022R1
      dependencies:  (none)
    ANSYS/2022R2:
      release stage: stable
      group:         Tools
      overlay:       merlin
      modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2022R2
      dependencies:  (none)
    ANSYS/2023R2:
      release stage: unstable
      group:         Tools
      overlay:       merlin
      modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2023R2
      dependencies:  (none)
    ANSYS/2024R1:
      release stage: unstable
      group:         Tools
      overlay:       merlin
      modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2024R1
      dependencies:  (none)
    ANSYS/2024R2:
      release stage: unstable
      group:         Tools
      overlay:       merlin
      modulefile:    /data/software/pmodules/Tools/modulefiles/ANSYS/2024R2
      dependencies:  (none)
    ```

!!! tip
    Please *only use Merlin6 ANSYS installations from `merlin`* in the Merlin cluster.

## ANSYS Documentation by product

### ANSYS RSM

**ANSYS Remote Solve Manager (RSM)** is used by ANSYS Workbench to submit computational jobs to HPC clusters directly from Workbench on your desktop.

Therefore, PSI workstations with direct access to Merlin can submit jobs by using RSM.

For further information, please visit the **[ANSYS RSM](ansys-rsm.md)** section.

### ANSYS Fluent

For further information, please visit the **[ANSYS Fluent](ansys-fluent.md)** section.

### ANSYS CFX

For further information, please visit the **[ANSYS CFX](ansys-cfx.md)** section.

### ANSYS MAPDL

For further information, please visit the **[ANSYS MAPDL](ansys-mapdl.md)** section.