Changes between Version 6 and Version 7 of DataParallel/Library


Ignore:
Timestamp:
Aug 30, 2011 9:45:44 AM (4 years ago)
Author:
benl
Comment:

Update description of dph packages

Legend:

Unmodified
Added
Removed
Modified
  • DataParallel/Library

    v6 v7  
    55== What packages there are == 
    66 
    7 DPH comes with the following blobs of source code: 
     7DPH is split into the following packages: 
    88 
    9   * `dph/dph-prim-seq` implements the DPH Primitive Interface for sequential machines.  Compiling it yields package `dph-prim-seq`.  It depends on the packages `vector` and `primitive`. 
     9  * `dph-base`[[br]] Contains shared debugging and tracing functions. Particularly, options for enabling extended sanity checking are hard-codede in the `Config.hs` module. 
    1010 
    11   * `dph/dph-prim-par` implements the DPH Primitive Interface for parallel machines.  Compiling it yields package `dph-prim-seq`. 
     11  * `dph-prim-seq`[[br]] Flat arrays, and sequential operators on them. Most sequential operators that we used are supplied by `Data.Vector`, but `dph-prim-seq` adds segmented operators that are only useful in the context of nested data parallelism. This package also defines the segment descriptor types, that are also used to implement nested arrays. Flat arrays are also referred to as "unlifted arrays", so this library is also called the "unlifted primitive library". 
    1212 
    13   * `dph/dph-base` implements the DPH User Interface, by importing the DPH Primitive Interface. The same source code can be compiled in two ways:  
    14      * Importing `dph-prim-seq`, generating package `dph-base-seq` 
    15      * Importing `dph-prim-seq`, generating package `dph-base-seq` 
     13  * `dph-prim-par`[[br]] Flat arrays, and parallel operators on them. This package exports exactly the same types and functions as `dph-prim-seq`, except that they run in parallel.  
    1614 
    17 '''SLPJ: what is dph-common?''' 
     15  * `dph-prim-interface`[[br]] Defines the common interface exposed by `dph-prim-seq` and `dph-prim-par`. The interface is defined by the `DPH_Header.h` and `DPH_Interface.h` header files, which provide the module signature and type sigs respectively. These header files are `#include`d into `dph-prim-seq` and `dph-prim-par` to ensure they really do have the same interface. 
    1816 
    19 The DPH libraries (in particular `dph-base`) use Template Haskell, so they can only be compiled with a stage2 compiler. 
     17  * `dph-common`[[br]]  Nested parallel arrays. This module defines the `PArray` type, and the functions used by vectorised code. The code in this package uses the interface defined by `dph-prim-interface`. This means it can be compiled against either the `dph-prim-seq` or `dph-prim-par` packages. Doing this results in the `dph-seq` and `dph-par` packages. 
     18 
     19 * `dph-seq` and `dph-par`[[br]] These packages are produced by compiling `dph-common` against either the `dph-prim-seq` or `dph-prim-par` packages. 
     20 
     21 * `dph-common-vseg`[[br]] Nested parallel arrays with virtual segment descriptors. This is a new version of `dph-common` currently under development. It extends the old library with a new form of segment descriptor. The new segment descriptor allows us to avoid physically replicating data in vectorised code. 
     22 
     23 * `dph-test`[[br]] Quick check properties for the other dph packages. 
     24 
     25 * `dph-examples`[[br]] Example programs using Data Parallel Haskell. 
     26 
     27The DPH libraries use Template Haskell, so they can only be compiled with a stage2 compiler. 
    2028 
    2129== How the DPH packages are coupled to GHC ==