refactor: use Array API in tabulate math

Port the shared tabulation math helpers to Array API compatible operators,
allow PT/PT_EXPT tabulation to pick a torch backend for the math path,
and add regression tests that verify the helpers stay backend-agnostic.

Tested:
- . .venv/bin/activate && PYTHONPATH=. pytest -q source/tests/common/test_tabulate_math_array_api.py
- python3 -m py_compile deepmd/utils/tabulate_math.py deepmd/pt/utils/tabulate.py deepmd/pt_expt/utils/tabulate.py source/tests/common/test_tabulate_math_array_api.py

Refs #5352

Authored by OpenClaw (model: gpt-5.4)

Author: njzjz-bot

deepmd/pt/utils/tabulate.py

@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: LGPL-3.0-or-later
 """PyTorch-specific DPTabulate wrapper.
 
-Inherits the numpy math from ``deepmd.utils.tabulate_math.DPTabulate``
-and adds torch-specific ``_convert_numpy_to_tensor`` and
-``_get_descrpt_type`` (isinstance checks against PT descriptor classes).
+Inherits the shared Array API tabulation math from
+``deepmd.utils.tabulate_math.DPTabulate`` and adds torch-specific
+backend selection, tensor conversion, and descriptor type detection.
 """
 
 from typing import (
@@ -31,8 +31,8 @@
 class DPTabulate(DPTabulateBase):
     r"""PyTorch tabulation wrapper.
 
-    Accepts a PT ``ActivationFn`` module and delegates all math to the
-    numpy base class. Only overrides tensor conversion and descriptor
+    Accepts a PT ``ActivationFn`` module and delegates all shared math to the
+    base class. Overrides backend selection, tensor conversion, and descriptor
     type detection.
 
     Parameters
@@ -91,6 +91,10 @@ def _get_descrpt_type(self) -> str:
             return "T_TEBD"
         raise RuntimeError(f"Unsupported descriptor {self.descrpt}")
 
+    def _get_math_backend_sample(self) -> Any:
+        """Run shared tabulation math on the current torch device."""
+        return torch.empty((), dtype=torch.float64, device=env.DEVICE)
+
     def _convert_numpy_to_tensor(self) -> None:
         """Convert self.data from np.ndarray to torch.Tensor."""
         self._convert_numpy_float_to_int()

deepmd/pt_expt/utils/tabulate.py

@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: LGPL-3.0-or-later
 """DPTabulate for the pt_expt backend.
 
-Inherits the numpy math from ``deepmd.utils.tabulate_math.DPTabulate``
-and overrides ``_convert_numpy_to_tensor`` for torch tensor conversion
-and ``_get_descrpt_type`` for serialization-based type detection.
+Inherits the shared Array API tabulation math from
+``deepmd.utils.tabulate_math.DPTabulate`` and overrides backend
+selection, tensor conversion, and descriptor type detection.
 No dependency on the pt backend.
 """
 
@@ -70,6 +70,16 @@ def _get_descrpt_type(self) -> str:
             raise RuntimeError(f"Unsupported descriptor type: {type_str}")
         return descrpt_type
 
+    def _get_math_backend_sample(self) -> Any:
+        """Run shared tabulation math on the pt_expt torch device."""
+        import torch
+
+        from deepmd.pt_expt.utils.env import (
+            DEVICE,
+        )
+
+        return torch.empty((), dtype=torch.float64, device=DEVICE)
+
     def _convert_numpy_to_tensor(self) -> None:
         """Convert self.data from np.ndarray to torch.Tensor."""
         import torch