Changes in / [59994557:bba9361] in sasmodels


Ignore:
Location:
doc/ref/gpu
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • doc/ref/gpu/gpu_computations.rst

    r711f17e r066f296  
    88 
    99To run on the GPU, your computer must have OpenCL drivers installed. 
    10 For information about OpenCL installation see this 
    11 :ref:`opencl-installation` guidance. 
     10For information about OpenCL installation see the 
     11:ref:`opencl-installation` documentation 
    1212 
    1313Where the model is evaluated is a little bit complicated. 
     
    1616on the CPU.  If the OpenCL driver is not available for the CPU then 
    1717it will run as a normal program on the CPU. 
    18  
    1918For models with a large number of parameters or with a lot of code, 
    2019the GPU may be too small to run the program effectively. 
    2120In this case, you should try simplifying the model, maybe breaking it 
    22 into several different modules so that you don't need *IF* statements in your code. 
     21into several different models so that you don't need if statements in your code. 
    2322If it is still too big, you can set *opencl=False* in the model file and 
    2423the model will only run as a normal program on the CPU. 
    2524This will not usually be necessary. 
    2625 
    27 Device Selection 
    28 ................ 
    2926If you have multiple GPU devices you can tell SasView which device to use. 
    3027By default, SasView looks for one GPU and one CPU device 
    3128from available OpenCL platforms. 
    3229 
    33 SasView prefers AMD or NVIDIA drivers for GPU, and prefers Intel or 
    34 Apple drivers for CPU. Both GPU and CPU are included on the assumption that CPU  
    35 is always available and supports double precision. 
     30It prefers AMD or NVIDIA drivers for GPU, and prefers Intel or 
     31Apple drivers for CPU. 
     32Both GPU and CPU are included on the assumption that CPU is always available 
     33and supports double precision. 
    3634 
    3735The device order is important: GPU is checked before CPU on the assumption that 
    3836it will be faster. By examining ~/sasview.log you can see which device SasView 
    3937chose to run the model. 
    40  
    4138If you don't want to use OpenCL, you can set *SAS_OPENCL=None* 
    4239in the environment, and it will only use normal programs. 
    43  
    4440If you want to use one of the other devices, you can run the following 
    4541from the python console in SasView:: 
     
    5248Use that value as the value of *SAS_OPENCL*. 
    5349 
    54 Compiler Selection 
    55 .................. 
    5650For models run as normal programs, you may need to specify a compiler. 
    5751This is done using the SAS_COMPILER environment variable. 
     
    6054TinyCC is provided with SasView so that is the default. 
    6155If you want one of the other compilers, be sure to have it available 
    62 in your *PATH* so SasView can find it! 
    63  
    64  
    65 .. note:: 
    66     This help document was last changed by Steve King, 08Oct2016 
     56on the path so SasView can find it. 
  • doc/ref/gpu/opencl_installation.rst

    rec8b9a3 r6ae7957  
    44OpenCL Installation 
    55******************* 
    6 *Warning! GPU devices do not in general offer the same level of memory protection as CPU devices. If your code attempts to write outside allocated memory buffers unpredicatable behaviour may result (eg, your video display may freeze, or your system may crash, etc). Do not install OpenCL drivers without first checking for known issues (eg, some computer manufacturers install modified graphics drivers so replacing these may not be a good idea!). If in doubt, seek advice from an IT professional before proceeding further.* 
    76 
    871. Check if you have OpenCL already installed 
     
    109 
    1110Windows 
    12 ....... 
     11========= 
    1312    The following instructions are based on 
    1413    http://web.engr.oregonstate.edu/~mjb/cs475/DoIHaveOpenCL.pdf 
    1514 
    16     * Go to: Start -> Control Panel -> System & Security -> Administrative Tools 
     15    * Go to: Start -> Control Panel -> Administrative Tools 
    1716    * Double Click on Computer Managment 
    1817    * Click on Device Manager 
     
    2423 
    2524Mac OSX 
    26 ....... 
    27     For OS X operating systems higher than 10.6 OpenCL is shipped along with the system. 
    28  
    29     However, OpenCL has had a rocky history on Macs. Apple provide a useful compatibility table at https://support.apple.com/en-us/HT202823 
     25========= 
     26    For OSXs higher than 10.6 OpenCL is shipped along with the system. 
    3027 
    3128 
     
    3431 
    3532Windows 
    36 ....... 
    37     Depending on the graphic card in your system, drivers 
     33========= 
     34    Depeneding on the graphic card on your system, drivers 
    3835    can be obtained from different sources: 
    3936 
    40     * NVIDIA: https://developer.nvidia.com/opencl 
     37    * Nvidia: https://developer.nvidia.com/opencl 
    4138    * AMD: http://developer.amd.com/tools-and-sdks/opencl-zone/ 
    4239 
    4340Mac OSX 
    44 ....... 
     41========= 
    4542    N/A 
    46          
    47         You cannot download OpenCL driver updates for your Mac. They are packaged with the normal quarterly OS X updates from Apple.  
    4843 
    4944 
    5045.. note:: 
    51     Intel provides OpenCL drivers for Intel processors at     https://software.intel.com/en-us/articles/opencl-drivers  
    52     These can sometimes make use of special vector instructions across multiple 
     46    Note that Intel provides an OpenCL drivers for Intel processors: 
     47    https://software.intel.com/en-us/articles/opencl-drivers 
     48    This can sometimes make use of special vector instructions across multiple 
    5349    processors, so it is worth installing if the GPU does not support double 
    5450    precision. You can install this driver alongside the GPU driver for NVIDIA 
    5551    or AMD. 
    56  
    57          
    58 .. note:: 
    59     This help document was last changed by Steve King, 08Oct2016 
Note: See TracChangeset for help on using the changeset viewer.