feat: using dpf instead of reader in "results" module

.ci/collect_mapdl_logs_locals.sh

@@ -27,6 +27,7 @@ echo "Copying the log files..."
 mv ./*.log ./"$LOG_NAMES"/ || echo "No log files could be found"
 mv ./*apdl.out ./"$LOG_NAMES"/ || echo "No APDL log files could be found"
 mv ./*pymapdl.apdl ./"$LOG_NAMES"/ || echo "No PYMAPDL APDL log files could be found"
+mv /home/mapdl/dpf_logs ./"$LOG_NAMES"/ || echo "No DPF log files could be found"
 
 echo "Copying the profiling files..."
 mkdir -p ./"$LOG_NAMES"/prof

.ci/collect_mapdl_logs_remote.sh

@@ -25,6 +25,7 @@ echo "Collecting MAPDL logs..."
 (docker exec "$MAPDL_INSTANCE" /bin/bash -c "if compgen -G '$FILE*.log' > /dev/null ;then mv -f /file*.log /mapdl_logs && echo 'Successfully moved log files.'; fi") || echo "Failed to move the 'log' files into a local file"
 (docker exec "$MAPDL_INSTANCE" /bin/bash -c "if compgen -G '$WDIR*.crash' > /dev/null ;then mv -f $WDIR*.crash /mapdl_logs && echo 'Successfully moved crash files.'; fi") || echo "Failed to move the 'crash' files into a local file"
 
+docker cp "$MAPDL_INSTANCE":/home/mapdl/dpf_logs ./"$LOG_NAMES"/ || echo "Failed to copy the 'dpf_logs' files into a local directory"
 docker cp "$MAPDL_INSTANCE":/mapdl_logs/. ./"$LOG_NAMES"/. || echo "Failed to copy the 'log-build-docs' files into a local directory"
 
 ####

.ci/entrypoint.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+export OMPI_ALLOW_RUN_AS_ROOT=1
+export OMPI_ALLOW_RUN_AS_ROOT_CONFIRM=1
+
+if [ -z "${VERSION}" ]; then
+    echo "VERSION environment variable is not set. Please set it to the desired Ansys version."
+    exit 1
+fi
+
+RUN_DPF_SERVER=${RUN_DPF_SERVER:-false}
+
+if [ -n "${ANSYS_DPF_ACCEPT_LA}" ]; then
+    if [ "${ANSYS_DPF_ACCEPT_LA}" == "Y" ]; then
+        RUN_DPF_SERVER=true
+    fi
+fi
+
+echo "RUN_DPF_SERVER: $RUN_DPF_SERVER"
+
+if [ "$RUN_DPF_SERVER" == "true" ]; then
+    echo "Starting DPF server..."
+    "/ansys_inc/v${VERSION}/aisol/bin/linx64/Ans.Dpf.Grpc.sh" --port "${DPF_PORT_INTERNAL}" > log_dpf.log &
+    echo "DPF server started."
+fi
+
+echo "Starting MAPDL..."
+echo "Using executable path: ${EXEC_PATH}"
+
+$EXEC_PATH -grpc -dir /jobs -"${DISTRIBUTED_MODE}" -np 2 -db -6000 -m -6000 -

.ci/start_mapdl.sh

@@ -65,14 +65,24 @@ fi;
 
 if [[ $MAPDL_VERSION == *"cicd"* ]] ; then
     echo "It is a CICD version, binding DPF port too"
-    export DPF_ARG="-p ${DPF_PORT}:50055"
+    if [ "$RUN_DPF_SERVER" == "true" ]; then
+        echo "RUN_DPF_SERVER is set to true, starting DPF server"
+        export DPF_ON="-e ANSYS_DPF_ACCEPT_LA=Y"
+    fi
+
+    export DPF_PORT_INTERNAL=50055
+    export DPF_PORT_ARG="-p ${DPF_PORT}:${DPF_PORT_INTERNAL}"
     export DB_INT_PORT=50056
 
-    echo "DPF_ARG: $DPF_ARG"
+    echo "DPF_PORT_ARG: $DPF_PORT_ARG"
     echo "DB_INT_PORT: $DB_INT_PORT"
+
+    echo "Overriding DISTRIBUTED_MODE to 'dmp' for CICD version"
+    export DISTRIBUTED_MODE="dmp"
 else
-    export DPF_ARG=""
+    export DPF_PORT_ARG=""
     export DB_INT_PORT=50055
+    export DPF_ON=""
 fi;
 
 echo "EXEC_PATH: $EXEC_PATH"
@@ -90,17 +100,23 @@ run \
   --health-start-period=10s \
   -e ANSYSLMD_LICENSE_FILE=1055@${LICENSE_SERVER} \
   -e ANSYS_LOCK="OFF" \
+  ${DPF_ON} \
   -p ${PYMAPDL_PORT}:50052 \
   -p ${PYMAPDL_DB_PORT}:${DB_INT_PORT} \
-  ${DPF_ARG} \
+  ${DPF_PORT_ARG} \
+  -e VERSION=${VERSION} \
+  -e DPF_PORT_INTERNAL=${DPF_PORT_INTERNAL} \
+  -e EXEC_PATH=${EXEC_PATH} \
+  -e DISTRIBUTED_MODE=${DISTRIBUTED_MODE} \
   --shm-size=2gb \
   -e I_MPI_SHM_LMT=shm \
-  -e P_SCHEMA="$P_SCHEMA" \
+  -e P_SCHEMA=${P_SCHEMA} \
   -w /jobs \
   -u=0:0 \
   --memory=6656MB \
   --memory-swap=16896MB \
-  ${MAPDL_IMAGE} ${EXEC_PATH} -grpc -dir /jobs -${DISTRIBUTED_MODE} -np 2 -db -5000 -m -5000 -
+  --mount type=bind,src=${PWD}/.ci/entrypoint.sh,dst=/entrypoint.sh \
+  ${MAPDL_IMAGE} /entrypoint.sh
 _EOT_
 )
 

.github/workflows/test-local.yml

@@ -123,6 +123,7 @@ jobs:
       PYTEST_ARGUMENTS: '-vvv -ra --color=yes --durations=30 --random-order --random-order-bucket=class --maxfail=10 --reruns 3 --reruns-delay 4 --cov=ansys.mapdl.core --cov-report=html --timeout=180 --profile-svg --profile --report-log-exclude-logs-on-passed-tests --strict-markers'
       OMPI_ALLOW_RUN_AS_ROOT: 1
       OMPI_ALLOW_RUN_AS_ROOT_CONFIRM: 1
+      DATAPROCESSING_DEBUG: /home/mapdl/dpf_logs
 
     container:
       image: "${{ inputs.package-registry }}:${{ inputs.mapdl-version }}"

.github/workflows/test-remote.yml

@@ -63,11 +63,12 @@ jobs:
       PYMAPDL_DB_PORT2: 21003  # default won't work on GitHub runners
       DPF_DOCKER_IMAGE: ghcr.io/ansys/mapdl:v25.2-rocky-dpf-standalone
       DPF_PORT: 21014
+      DPF_PORT_INTERNAL: 50055 # Internal port for DPF server
       DPF_PORT2: 21015
       DPF_START_SERVER: False
       HAS_DPF: True
       TEST_DPF_BACKEND: false
-      PYTEST_ARGUMENTS: '-vvv -ra --color=yes --durations=30 --random-order --random-order-bucket=class --maxfail=5 --reruns 3 --reruns-delay 4 --cov=ansys.mapdl.core --cov-report=html --timeout=180 --profile-svg --profile --report-log-exclude-logs-on-passed-tests --strict-markers'
+      PYTEST_ARGUMENTS: '-vvv -ra --color=yes --durations=30 --random-order --random-order-bucket=class --maxfail=10 --reruns 3 --reruns-delay 4 --cov=ansys.mapdl.core --cov-report=html --timeout=180 --profile-svg --profile --report-log-exclude-logs-on-passed-tests --strict-markers --random-order-seed=650199'
       MAPDL_PACKAGE: ghcr.io/ansys/mapdl
 
     steps:
@@ -149,13 +150,16 @@ jobs:
           MAPDL_VERSION: ${{ inputs.mapdl-version }}
           DISTRIBUTED_MODE: ${{ steps.distributed_mode.outputs.distributed_mode }}
           MAPDL_PACKAGE: ${{ env.MAPDL_PACKAGE }}
+          DPF_PORT_INTERNAL: ${{ env.DPF_PORT_INTERNAL }}
         shell: bash
         run: |
           echo "Launching first MAPDL instance..."
           export INSTANCE_NAME=MAPDL_0
+          export RUN_DPF_SERVER=true
           .ci/start_mapdl.sh &> mapdl_launch_0.log & export DOCKER_PID_0=$!
 
           echo "Launching a second instance for MAPDL pool testing..."
+          export RUN_DPF_SERVER=false
           export PYMAPDL_PORT=${{ env.PYMAPDL_PORT2 }}
           export PYMAPDL_DB_PORT=${{ env.PYMAPDL_DB_PORT2 }}
           export INSTANCE_NAME=MAPDL_1
@@ -222,17 +226,6 @@ jobs:
         run: |
           python -m pip install .[tests]
 
-      - name: "Start DPF server on same container as MAPDL"
-        if: ${{ steps.ubuntu_check.outputs.ON_SAME_CONTAINER == 'true' }}
-        shell: bash
-        env:
-          MAPDL_INSTANCE: "MAPDL_0"
-          DPF_PORT: "${{ env.DPF_PORT }}"
-        run: |
-          docker ps
-          echo "Starting DPF server on same MAPDL container: ${MAPDL_INSTANCE}"
-          docker exec ${MAPDL_INSTANCE} /bin/bash -c "/ansys_inc/v252/aisol/bin/linx64/Ans.Dpf.Grpc.sh --port 50055 &" > log_dpf.log &
-
       - name: "Waiting for the services to be up"
         shell: bash
         env:
@@ -265,14 +258,14 @@ jobs:
             --log-file-level="DEBUG"
 
       - name: "Print amount of restarts"
+        if: always()
         run: |
           N_RESTART=$(docker inspect --format '{{ .RestartCount }}'  MAPDL_0)
-          echo "Number of restarts in MAPDL_0 container: $N_RESTART"
+          echo "Number of restarts in the MAPDL_0 container: $N_RESTART"
           N_RESTART=$(docker inspect --format '{{ .RestartCount }}'  MAPDL_1)
-          echo "Number of restarts in MAPDL_1 container: $N_RESTART"
+          echo "Number of restarts in the MAPDL_1 container: $N_RESTART"
 
       - name: "Upload pytest reports to GitHub"
-        if: always()
         uses: actions/upload-artifact@v4.6.2
         with:
           name: "reports-${{ inputs.file-name }}"

doc/changelog.d/1300.maintenance.md

@@ -0,0 +1 @@
+Feat: using dpf instead of reader in "results" module

doc/changelog.d/4098.miscellaneous.md

@@ -0,0 +1 @@
+Feat: using entrypoint to start mapdl

src/ansys/mapdl/core/__init__.py

@@ -66,13 +66,14 @@
 # Import related globals
 _HAS_ATP: bool = is_installed("ansys.tools.path")
 _HAS_CLICK: bool = is_installed("click")
-_HAS_PIM: bool = is_installed("ansys.platform.instancemanagement")
+_HAS_DPF: bool = is_installed("ansys.dpf.core")
+_HAS_MATPLOTLIB: bool = is_installed("matplotlib")
 _HAS_PANDAS: bool = is_installed("pandas")
+_HAS_PIM: bool = is_installed("ansys.platform.instancemanagement")
 _HAS_PYANSYS_REPORT: bool = is_installed("ansys.tools.report")
 _HAS_PYVISTA: bool = is_installed("pyvista")
 _HAS_REQUESTS: bool = is_installed("requests")
 _HAS_TQDM: bool = is_installed("tqdm")
-_HAS_MATPLOTLIB: bool = is_installed("matplotlib")
 _HAS_VISUALIZER: bool = (
     is_installed("ansys.tools.visualization_interface") and _HAS_MATPLOTLIB
 )

src/ansys/mapdl/core/launcher.py

@@ -148,6 +148,7 @@ def version_from_path(*args: Any, **kwargs: Any) -> int | None:
     "just_launch",
     "on_pool",
     "graphics_backend",
+    "use_reader_backend",
 ]
 
 ON_WSL = os.name == "posix" and (

src/ansys/mapdl/core/mapdl_core.py

@@ -43,7 +43,7 @@
 
 from ansys.mapdl import core as pymapdl
 from ansys.mapdl.core import LOG as logger
-from ansys.mapdl.core import _HAS_VISUALIZER
+from ansys.mapdl.core import _HAS_DPF, _HAS_VISUALIZER
 from ansys.mapdl.core.commands import (
     CMD_BC_LISTING,
     CMD_LISTING,
@@ -88,6 +88,9 @@
     from ansys.mapdl.core.solution import Solution
     from ansys.mapdl.core.xpl import ansXpl
 
+    if _HAS_DPF:
+        from ansys.mapdl.core.reader import DPFResult
+
 from ansys.mapdl.core.post import PostProcessing
 
 MAX_PARAM_CHARS = 32
@@ -211,6 +214,7 @@
     "start_instance",
     "start_timeout",
     "timeout",
+    "use_reader_backend",
 ]
 
 
@@ -264,7 +268,7 @@
         local: bool = True,
         print_com: bool = False,
         file_type_for_plots: VALID_FILE_TYPE_FOR_PLOT_LITERAL = "PNG",
-        **start_parm,
+        **start_parm: dict[str, Any],
     ):
         """Initialize connection with MAPDL."""
         self._show_matplotlib_figures = True  # for testing
@@ -285,6 +289,7 @@
         self._version = None  # cached version
         self._mute = False
         self._save_selection_obj = None
+        self._use_reader_backend: bool = start_parm.pop("use_reader_backend", True)
 
         if _HAS_VISUALIZER:
             if graphics_backend is not None:  # pragma: no cover
@@ -362,6 +367,9 @@
 
         self._info = Information(self)
 
+        # DPF
+        self._dpf_result: "DPFResult | None" = None
+
     def _after_run(self, _command: str) -> None:
         pass
 
@@ -1072,7 +1080,11 @@
     @property
     @requires_package("ansys.mapdl.reader", softerror=True)
     def result(self):
-        """Binary interface to the result file using :class:`ansys.mapdl.reader.rst.Result`.
+        """Binary interface to the result file using ``ansys-dpf-core`` or
+        ``ansys-mapdl-reader``.
+
+        If `ansys-dpf-core` is not installed, then a :class:`ansys.mapdl.reader.rst.Result`
+        object is returned.
 
         Returns
         -------
@@ -1106,12 +1118,21 @@
         NSL : Nodal displacements
         RF  : Nodal reaction forces
         """
+        if _HAS_DPF and not self._use_reader_backend:
+            from ansys.mapdl.core.reader import DPFResult
+
+            if self._dpf_result is None:
+                # create a DPFResult object
+                self._dpf_result = DPFResult(None, mapdl=self, logger=self._log)
+
+            return self._dpf_result
+
         from ansys.mapdl.reader import read_binary
         from ansys.mapdl.reader.rst import Result
 
         if not self._local:
             # download to temporary directory
-            save_path = os.path.join(tempfile.gettempdir())
+            save_path = tempfile.mkdtemp(suffix=f"ansys_tmp_{random_string()}")
             result_path = self.download_result(save_path)
         else:
             if self._distributed_result_file and self._result_file:
@@ -1141,10 +1162,12 @@
             else:
                 result_path = self._result_file
 
-        if result_path is None:
-            raise FileNotFoundError("No result file(s) at %s" % self.directory)
-        if not os.path.isfile(result_path):
-            raise FileNotFoundError("No results found at %s" % result_path)
+        if result_path is None or not os.path.isfile(result_path):
+            raise FileNotFoundError(
+                f"No result file(s) at {self.directory or result_path}. "
+                "Check that there is at least one RST file in the working directory "
+                f"'{self.directory}, or solve an MAPDL model to generate one."
+            )
 
         return read_binary(result_path)
 
@@ -1299,7 +1322,7 @@
                 if os.path.isfile(filename):
                     return filename
         else:
-            return f"{filename}.{ext}"
+            return self.directory / f"{filename}.{ext}"
 
     def _wrap_listing_functions(self):
         # Wrapping LISTING FUNCTIONS.

src/ansys/mapdl/core/misc.py

@@ -106,6 +106,24 @@
         return False
 
 
+def get_local_ip():
+    """Get the local IP address of this machine.
+
+    It uses a socket to determine the local IP address, if fails, it returns local IP.
+    """
+    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    s.settimeout(0)
+    try:
+        # doesn't even have to be reachable
+        s.connect(("10.254.254.254", 1))
+        ip = s.getsockname()[0]
+    except Exception:
+        ip = "127.0.0.1"
+    finally:
+        s.close()
+    return ip
+
+
 def random_string(stringLength: int = 10, letters: str = string.ascii_lowercase) -> str:
     """Generate a random string of fixed length"""
     import secrets

src/ansys/mapdl/core/reader/__init__.py

@@ -0,0 +1,23 @@
+# Copyright (C) 2016 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+from .result import DPFResult