Added ExecutionPlacementError

Author: oleksandr-pavlyk

dpctl/utils/__init__.py

@@ -19,6 +19,7 @@
 """
 
 from ._compute_follows_data import (
+    ExecutionPlacementError,
     get_coerced_usm_type,
     get_execution_queue,
     validate_usm_type,
@@ -30,4 +31,5 @@
     "get_coerced_usm_type",
     "validate_usm_type",
     "onetrace_enabled",
+    "ExecutionPlacementError",
 ]

dpctl/utils/_compute_follows_data.pyx

@@ -28,7 +28,18 @@ import dpctl
 
 from .._sycl_queue cimport SyclQueue
 
-__all__ = ["get_execution_queue", "get_coerced_usm_type"]
+__all__ = ["get_execution_queue", "get_coerced_usm_type", "ExecutionPlacementError"]
+
+
+class ExecutionPlacementError(Exception):
+    """Exception raised when execution placement target can be determined
+    from input arrays.
+
+    Make sure that input arrays are associated with the same SyclQueue,
+    or migrate data to the same SyclQueue using usm_ndarray.to_device
+    method.
+    """
+    pass
 
 
 cdef bint queue_equiv(SyclQueue q1, SyclQueue q2):