Changes in sasmodels/kernelcuda.py [fa26e78:f872fd1] in sasmodels

File:

• sasmodels/kernelcuda.py (modified) (26 diffs)

sasmodels/kernelcuda.py

@@ -63 +63 @@
 import time
 import re
-import atexit
 
 import numpy as np  # type: ignore
 
 
-# Attempt to setup CUDA. This may fail if the pycuda package is not
+# Attempt to setup cuda. This may fail if the pycuda package is not
 # installed or if it is installed but there are no devices available.
 try:
@@ -108 +107 @@
 MAX_LOOPS = 2048
 
-
 def use_cuda():
-    sas_opencl = os.environ.get("SAS_OPENCL", "CUDA").lower()
-    return HAVE_CUDA and sas_opencl.startswith("cuda")
-
+    env = os.environ.get("SAS_OPENCL", "").lower()
+    return HAVE_CUDA and (env == "" or env.startswith("cuda"))
 
 ENV = None
@@ -124 +121 @@
         ENV.release()
     ENV = GpuEnvironment() if use_cuda() else None
-
 
 def environment():
@@ -142 +138 @@
     return ENV
 
-
-# PyTest is not freeing ENV, so make sure it gets freed.
-atexit.register(lambda: ENV.release() if ENV is not None else None)
-
-
 def has_type(dtype):
     # type: (np.dtype) -> bool
@@ -152 +143 @@
     Return true if device supports the requested precision.
     """
-    # Assume the NVIDIA card supports 32-bit and 64-bit floats.
-    # TODO: Check if pycuda support F16.
+    # Assume the nvidia card supports 32-bit and 64-bit floats.
+    # TODO: check if pycuda support F16
     return dtype in (generate.F32, generate.F64)
 
 
 FUNCTION_PATTERN = re.compile(r"""^
-  (?P<space>\s*)                       # Initial space.
-  (?P<qualifiers>^(?:\s*\b\w+\b\s*)+)  # One or more qualifiers before function.
-  (?P<function>\s*\b\w+\b\s*[(])       # Function name plus open parens.
+  (?P<space>\s*)                   # initial space
+  (?P<qualifiers>^(?:\s*\b\w+\b\s*)+) # one or more qualifiers before function
+  (?P<function>\s*\b\w+\b\s*[(])      # function name plus open parens
   """, re.VERBOSE|re.MULTILINE)
 
@@ -167 +158 @@
   """, re.VERBOSE|re.MULTILINE)
 
-
 def _add_device_tag(match):
     # type: (None) -> str
-    # Note: Should be re.Match, but that isn't a simple type.
+    # Note: should be re.Match, but that isn't a simple type
     """
     replace qualifiers with __device__ qualifiers if needed
@@ -183 +173 @@
         return "".join((space, "__device__ ", qualifiers, function))
 
-
 def mark_device_functions(source):
     # type: (str) -> str
@@ -190 +179 @@
     """
     return FUNCTION_PATTERN.sub(_add_device_tag, source)
-
 
 def show_device_functions(source):
@@ -200 +188 @@
         print(match.group('qualifiers').replace('\n',r'\n'), match.group('function'), '(')
     return source
-
 
 def compile_model(source, dtype, fast=False):
@@ -225 +212 @@
     #options = ['--verbose', '-E']
     options = ['--use_fast_math'] if fast else None
-    program = SourceModule(source, no_extern_c=True, options=options) #, include_dirs=[...])
+    program = SourceModule(source, no_extern_c=True, options=options) # include_dirs=[...]
 
     #print("done with "+program)
@@ -231 +218 @@
 
 
-# For now, this returns one device in the context.
-# TODO: Create a context that contains all devices on all platforms.
+# for now, this returns one device in the context
+# TODO: create a context that contains all devices on all platforms
 class GpuEnvironment(object):
     """
-    GPU context for CUDA.
+    GPU context, with possibly many devices, and one queue per device.
     """
     context = None # type: cuda.Context
     def __init__(self, devnum=None):
         # type: (int) -> None
+        # Byte boundary for data alignment
+        #self.data_boundary = max(d.min_data_type_align_size
+        #                         for d in self.context.devices)
+        self.compiled = {}
         env = os.environ.get("SAS_OPENCL", "").lower()
         if devnum is None and env.startswith("cuda:"):
             devnum = int(env[5:])
-
         # Set the global context to the particular device number if one is
         # given, otherwise use the default context.  Perhaps this will be set
@@ -252 +242 @@
             self.context = make_default_context()
 
-        ## Byte boundary for data alignment.
-        #self.data_boundary = max(d.min_data_type_align_size
-        #                         for d in self.context.devices)
-
-        # Cache for compiled programs, and for items in context.
-        self.compiled = {}
-
     def release(self):
         if self.context is not None:
@@ -279 +262 @@
         Compile the program for the device in the given context.
         """
-        # Note: PyCuda (probably) caches but I'll do so as well just to
-        # save some data munging time.
+        # Note: PyOpenCL caches based on md5 hash of source, options and device
+        # so we don't really need to cache things for ourselves.  I'll do so
+        # anyway just to save some data munging time.
         tag = generate.tag_source(source)
         key = "%s-%s-%s%s"%(name, dtype, tag, ("-fast" if fast else ""))
-        # Check timestamp on program.
+        # Check timestamp on program
         program, program_timestamp = self.compiled.get(key, (None, np.inf))
         if program_timestamp < timestamp:
@@ -293 +277 @@
         return program
 
-
 class GpuModel(KernelModel):
     """
@@ -309 +292 @@
     that the compiler is allowed to take shortcuts.
     """
-    info = None  # type: ModelInfo
-    source = ""  # type: str
-    dtype = None  # type: np.dtype
-    fast = False  # type: bool
-    _program = None  # type: SourceModule
-    _kernels = None  # type: Dict[str, cuda.Function]
+    info = None # type: ModelInfo
+    source = "" # type: str
+    dtype = None # type: np.dtype
+    fast = False # type: bool
+    program = None # type: SourceModule
+    _kernels = None # type: List[cuda.Function]
 
     def __init__(self, source, model_info, dtype=generate.F32, fast=False):
@@ -322 +305 @@
         self.dtype = dtype
         self.fast = fast
+        self.program = None # delay program creation
+        self._kernels = None
 
     def __getstate__(self):
@@ -330 +315 @@
         # type: (Tuple[ModelInfo, str, np.dtype, bool]) -> None
         self.info, self.source, self.dtype, self.fast = state
-        self._program = self._kernels = None
+        self.program = None
 
     def make_kernel(self, q_vectors):
         # type: (List[np.ndarray]) -> "GpuKernel"
-        return GpuKernel(self, q_vectors)
-
-    def get_function(self, name):
-        # type: (str) -> cuda.Function
-        """
-        Fetch the kernel from the environment by name, compiling it if it
-        does not already exist.
-        """
-        if self._program is None:
-            self._prepare_program()
-        return self._kernels[name]
-
-    def _prepare_program(self):
-        # type: (str) -> None
-        env = environment()
-        timestamp = generate.ocl_timestamp(self.info)
-        program = env.compile_program(
-            self.info.name,
-            self.source['opencl'],
-            self.dtype,
-            self.fast,
-            timestamp)
-        variants = ['Iq', 'Iqxy', 'Imagnetic']
-        names = [generate.kernel_name(self.info, k) for k in variants]
-        functions = [program.get_function(k) for k in names]
-        self._kernels = {k: v for k, v in zip(variants, functions)}
-        # Keep a handle to program so GC doesn't collect.
-        self._program = program
-
-
-# TODO: Check that we don't need a destructor for buffers which go out of scope.
+        if self.program is None:
+            compile_program = environment().compile_program
+            timestamp = generate.ocl_timestamp(self.info)
+            self.program = compile_program(
+                self.info.name,
+                self.source['opencl'],
+                self.dtype,
+                self.fast,
+                timestamp)
+            variants = ['Iq', 'Iqxy', 'Imagnetic']
+            names = [generate.kernel_name(self.info, k) for k in variants]
+            kernels = [self.program.get_function(k) for k in names]
+            self._kernels = dict((k, v) for k, v in zip(variants, kernels))
+        is_2d = len(q_vectors) == 2
+        if is_2d:
+            kernel = [self._kernels['Iqxy'], self._kernels['Imagnetic']]
+        else:
+            kernel = [self._kernels['Iq']]*2
+        return GpuKernel(kernel, self.dtype, self.info, q_vectors)
+
+    def release(self):
+        # type: () -> None
+        """
+        Free the resources associated with the model.
+        """
+        if self.program is not None:
+            self.program = None
+
+    def __del__(self):
+        # type: () -> None
+        self.release()
+
+# TODO: check that we don't need a destructor for buffers which go out of scope
 class GpuInput(object):
     """
@@ -386 +373 @@
     def __init__(self, q_vectors, dtype=generate.F32):
         # type: (List[np.ndarray], np.dtype) -> None
-        # TODO: Do we ever need double precision q?
+        # TODO: do we ever need double precision q?
         self.nq = q_vectors[0].size
         self.dtype = np.dtype(dtype)
         self.is_2d = (len(q_vectors) == 2)
-        # TODO: Stretch input based on get_warp().
-        # Not doing it now since warp depends on kernel, which is not known
+        # TODO: stretch input based on get_warp()
+        # not doing it now since warp depends on kernel, which is not known
         # at this point, so instead using 32, which is good on the set of
         # architectures tested so far.
         if self.is_2d:
-            width = ((self.nq+15)//16)*16
+            # Note: 16 rather than 15 because result is 1 longer than input.
+            width = ((self.nq+16)//16)*16
             self.q = np.empty((width, 2), dtype=dtype)
             self.q[:self.nq, 0] = q_vectors[0]
             self.q[:self.nq, 1] = q_vectors[1]
         else:
-            width = ((self.nq+31)//32)*32
+            # Note: 32 rather than 31 because result is 1 longer than input.
+            width = ((self.nq+32)//32)*32
             self.q = np.empty(width, dtype=dtype)
             self.q[:self.nq] = q_vectors[0]
         self.global_size = [self.q.shape[0]]
         #print("creating inputs of size", self.global_size)
-
-        # Transfer input value to GPU.
         self.q_b = cuda.to_device(self.q)
 
@@ -412 +399 @@
         # type: () -> None
         """
-        Free the buffer associated with the q value.
+        Free the memory.
         """
         if self.q_b is not None:
@@ -422 +409 @@
         self.release()
 
-
 class GpuKernel(Kernel):
     """
     Callable SAS kernel.
 
-    *model* is the GpuModel object to call
-
-    The kernel is derived from :class:`Kernel`, providing the
-    :meth:`call_kernel` method to evaluate the kernel for a given set of
-    parameters.  Because of the need to move the q values to the GPU before
-    evaluation, the kernel is instantiated for a particular set of q vectors,
-    and can be called many times without transfering q each time.
+    *kernel* is the GpuKernel object to call
+
+    *model_info* is the module information
+
+    *q_vectors* is the q vectors at which the kernel should be evaluated
+
+    *dtype* is the kernel precision
+
+    The resulting call method takes the *pars*, a list of values for
+    the fixed parameters to the kernel, and *pd_pars*, a list of (value,weight)
+    vectors for the polydisperse parameters.  *cutoff* determines the
+    integration limits: any points with combined weight less than *cutoff*
+    will not be calculated.
 
     Call :meth:`release` when done with the kernel instance.
     """
-    #: SAS model information structure.
-    info = None  # type: ModelInfo
-    #: Kernel precision.
-    dtype = None  # type: np.dtype
-    #: Kernel dimensions (1d or 2d).
-    dim = ""  # type: str
-    #: Calculation results, updated after each call to :meth:`_call_kernel`.
-    result = None  # type: np.ndarray
-
-    def __init__(self, model, q_vectors):
-        # type: (GpuModel, List[np.ndarray]) -> None
-        dtype = model.dtype
+    def __init__(self, kernel, dtype, model_info, q_vectors):
+        # type: (cl.Kernel, np.dtype, ModelInfo, List[np.ndarray]) -> None
         self.q_input = GpuInput(q_vectors, dtype)
-        self._model = model
-
-        # Attributes accessed from the outside.
+        self.kernel = kernel
+        # F16 isn't sufficient, so don't support it
+        self._as_dtype = np.float64 if dtype == generate.F64 else np.float32
+
+        # attributes accessed from the outside
         self.dim = '2d' if self.q_input.is_2d else '1d'
-        self.info = model.info
+        self.info = model_info
         self.dtype = dtype
 
-        # Converter to translate input to target type.
-        self._as_dtype = np.float64 if dtype == generate.F64 else np.float32
-
-        # Holding place for the returned value.
+        # holding place for the returned value
         nout = 2 if self.info.have_Fq and self.dim == '1d' else 1
-        extra_q = 4  # Total weight, form volume, shell volume and R_eff.
-        self.result = np.empty(self.q_input.nq*nout + extra_q, dtype)
-
-        # Allocate result value on GPU.
+        extra_q = 4  # total weight, form volume, shell volume and R_eff
+        self.result = np.empty(self.q_input.nq*nout+extra_q, dtype)
+
+        # Inputs and outputs for each kernel call
+        # Note: res may be shorter than res_b if global_size != nq
         width = ((self.result.size+31)//32)*32 * self.dtype.itemsize
-        self._result_b = cuda.mem_alloc(width)
-
-    def _call_kernel(self, call_details, values, cutoff, magnetic,
-                     effective_radius_type):
-        # type: (CallDetails, np.ndarray, float, bool, int) -> np.ndarray
-
-        # Arrange data transfer to card.
+        self.result_b = cuda.mem_alloc(width)
+        self._need_release = [self.result_b]
+
+    def _call_kernel(self, call_details, values, cutoff, magnetic, effective_radius_type):
+        # type: (CallDetails, np.ndarray, np.ndarray, float, bool) -> np.ndarray
+        # Arrange data transfer to card
         details_b = cuda.to_device(call_details.buffer)
         values_b = cuda.to_device(values)
 
-        # Setup kernel function and arguments.
-        name = 'Iq' if self.dim == '1d' else 'Imagnetic' if magnetic else 'Iqxy'
-        kernel = self._model.get_function(name)
-        kernel_args = [
-            np.uint32(self.q_input.nq),  # Number of inputs.
-            None,  # Placeholder for pd_start.
-            None,  # Placeholder for pd_stop.
-            details_b,  # Problem definition.
-            values_b,  # Parameter values.
-            self.q_input.q_b,  # Q values.
-            self._result_b,   # Result storage.
-            self._as_dtype(cutoff),  # Probability cutoff.
-            np.uint32(effective_radius_type),  # R_eff mode.
+        kernel = self.kernel[1 if magnetic else 0]
+        args = [
+            np.uint32(self.q_input.nq), None, None,
+            details_b, values_b, self.q_input.q_b, self.result_b,
+            self._as_dtype(cutoff),
+            np.uint32(effective_radius_type),
         ]
         grid = partition(self.q_input.nq)
-
-        # Call kernel and retrieve results.
-        #print("Calling CUDA")
+        #print("Calling OpenCL")
         #call_details.show(values)
+        # Call kernel and retrieve results
         last_nap = time.clock()
         step = 100000000//self.q_input.nq + 1
@@ -502 +475 @@
             stop = min(start + step, call_details.num_eval)
             #print("queuing",start,stop)
-            kernel_args[1:3] = [np.int32(start), np.int32(stop)]
-            kernel(*kernel_args, **grid)
+            args[1:3] = [np.int32(start), np.int32(stop)]
+            kernel(*args, **grid)
             if stop < call_details.num_eval:
                 sync()
-                # Allow other processes to run.
+                # Allow other processes to run
                 current_time = time.clock()
                 if current_time - last_nap > 0.5:
@@ -512 +485 @@
                     last_nap = current_time
         sync()
-        cuda.memcpy_dtoh(self.result, self._result_b)
+        cuda.memcpy_dtoh(self.result, self.result_b)
         #print("result", self.result)
 
@@ -523 +496 @@
         Release resources associated with the kernel.
         """
-        self.q_input.release()
-        if self._result_b is not None:
-            self._result_b.free()
-            self._result_b = None
+        for p in self._need_release:
+            p.free()
+        self._need_release = []
 
     def __del__(self):
@@ -540 +512 @@
     Note: Maybe context.synchronize() is sufficient.
     """
-    # Create an event with which to synchronize.
+    #return # The following works in C++; don't know what pycuda is doing
+    # Create an event with which to synchronize
     done = cuda.Event()
 
@@ -546 +519 @@
     done.record()
 
-    # Make sure we don't hog resource while waiting to sync.
+    #line added to not hog resources
     while not done.query():
         time.sleep(0.01)
@@ -552 +525 @@
     # Block until the GPU executes the kernel.
     done.synchronize()
-
     # Clean up the event; I don't think they can be reused.
     del done