Update documentation and naming

Author: ekatralis

xobjects/sparse/_sparse.py

@@ -109,7 +109,7 @@ def factorized_sparse_solver(A: Union[scipy.sparse.csr_matrix,
         * `"scipySLU"` : Use `scipy.sparse.linalg.splu` (CPU).
         * `"PyKLU"`    : Use the `PyKLU.Klu` solver (CPU).
         * `"cuDSS"`    : Use CUDA/cuDSS-based `DirectSolverSuperLU` (GPU).
-        * `"CachedSLU"`: Use CUDA cached SuperLU (`luLU`) (GPU).
+        * `"CachedSLU"`: Use CUDA cached spsm SuperLU (`luLU`) (GPU).
         * `"cupySLU"`  : Use `cupyx.scipy.sparse.linalg.splu` (GPU).
 
         Using a solver that does not match the current `context` will result
@@ -153,8 +153,20 @@ def factorized_sparse_solver(A: Union[scipy.sparse.csr_matrix,
               - `PyKLU.Klu` (for `"PyKLU"`).
           * CUDA/CuPy:
               - `DirectSolverSuperLU` (cuDSS),
-              - `luLU` (cached SuperLU),
+              - `luLU` (cached spsm SuperLU),
               - `cupyx.scipy.sparse.linalg.SuperLU` (for `"cupySLU"`).
+        
+        All returned solver objects implement a `solve(b)` method.
+        For **optimal performance across all backends**, the right-hand
+        side `b` should be passed as a **Fortran-contiguous (column-major)**
+        array:
+
+        * For a single RHS: shape ``(n,)`` or ``(n, 1)`` (Fortran contiguous).
+        * For multiple RHSs: shape ``(n, nrhs)`` with **Fortran layout**.
+
+        If `b` is not Fortran-contiguous, the solver will internally copy or
+        transform it, which can incur extra overhead—especially on CUDA/GPU
+        backends and in batched-solve scenarios.
 
     Raises
     ------

xobjects/sparse/solvers/CPU/__init__.py

@@ -1,12 +1,11 @@
-from scipy.sparse.linalg import splu as scipySuperLU
-from ....context import ModuleNotAvailableError
-
+from scipy.sparse.linalg import splu as scipysplu
 try:
-    from PyKLU import Klu as KLUSuperLU
+    from PyKLU import Klu as KLU
 except (ModuleNotFoundError,ImportError) as e:
-    def KLUSuperLU(*args, _import_err=e, **kwargs):
+    def KLU(*args, _import_err=e, **kwargs):
+        from ....context import ModuleNotAvailableError
         raise ModuleNotAvailableError(
-            "KLUSuperLU is not available. Could not import required backend."
+            "KLU is not available. Could not import required backend."
             ) from _import_err
 
-__all__ = ["scipySuperLU", "KLUSuperLU"]
+__all__ = ["scipysplu", "KLU"]

xobjects/sparse/solvers/CUDA/__init__.py

@@ -1,24 +1,26 @@
-from ....context import ModuleNotAvailableError
 try:
-    from ._cuDSSLU import DirectSolverSuperLU as cuDSSSuperLU
+    from ._cuDSSLU import DirectSolverSuperLU as cuDSS
 except (ModuleNotFoundError,ImportError) as e:
-    def cuDSSSuperLU(*args, _import_err=e, **kwargs):
+    def cuDSS(*args, _import_err=e, **kwargs):
+        from ....context import ModuleNotAvailableError
         raise ModuleNotAvailableError(
-            "cuDSSSuperLU is not available. Could not import required backend."
+            "cuDSS is not available. Could not import required backend."
             ) from _import_err
 try:
-    from ._luLU import luLU as CachedSuperLU
+    from ._luLU import luLU as cachedSpSM
 except (ModuleNotFoundError,ImportError) as e:
-    def CachedSuperLU(*args, _import_err=e, **kwargs):
+    def cachedSpSM(*args, _import_err=e, **kwargs):
+        from ....context import ModuleNotAvailableError
         raise ModuleNotAvailableError(
-            "CachedSuperLU is not available. Could not import required backend."
+            "cachedSpSM is not available. Could not import required backend."
             ) from _import_err
 try:
-    from cupyx.scipy.sparse.linalg import splu as CupySuperLU
+    from cupyx.scipy.sparse.linalg import splu as cupysplu
 except (ModuleNotFoundError,ImportError) as e:
-    def CupySuperLU(*args, _import_err=e, **kwargs):
+    def cupysplu(*args, _import_err=e, **kwargs):
+        from ....context import ModuleNotAvailableError
         raise ModuleNotAvailableError(
-            "CupySuperLU is not available. Could not import required backend."
+            "cupysplu is not available. Could not import required backend."
             ) from _import_err
 
-__all__ = ["cuDSSSuperLU", "CachedSuperLU", "CupySuperLU"]
+__all__ = ["cuDSS", "cachedSpSM", "cupysplu"]