accelerate-examples: Examples using the Accelerate library

[ accelerate, bsd3, library ] [ Propose Tags ]

This package demonstrates a number of computation kernels and applications showcasing the Accelerate language and associated backend implementations. It is also used for performance and regression testing.

Refer to the main Accelerate package for more information: http://hackage.haskell.org/package/accelerate


[Skip to Readme]
Versions [RSS] [faq] 0.2.0.0, 0.2.0.1, 0.12.0.0, 0.12.1.0, 0.13.0.0, 0.14.0.0, 0.15.0.0, 0.15.1.0, 1.0.0.0, 1.1.0.0, 1.2.0.0, 1.2.0.1, 1.3.0.0
Dependencies accelerate (==1.1.*), accelerate-examples, accelerate-fft (>=1.0 && <1.2), accelerate-io (==1.0.*), accelerate-llvm-native (==1.1.*), accelerate-llvm-ptx (==1.1.*), aeson (>=0.8), ansi-wl-pprint (>=0.6), array (>=0.3), base (>=4.7 && <4.11), binary (>=0.7), bmp (>=1.2), bytestring (>=0.9), bytestring-lexing (>=0.5), cereal (>=0.3), colour-accelerate (>=0.1), containers (>=0.5), criterion (>=1.0 && <1.3), directory (>=1.1), fclabels (>=2.0), filepath (>=1.0), gloss (>=1.7), gloss-accelerate (>=2.0), gloss-raster-accelerate (>=2.0), gloss-rendering (>=1.9), HTTP (>=4000.2), http-types (>=0.8), HUnit (>=1.2), lens-accelerate (>=0.1), linear (>=1.1), linear-accelerate (>=0.3), matrix-market-attoparsec (>=0.1), mwc-random (>=0.8), network (>=2.5), normaldistribution, pipes (>=4.1.6), process (>=1.0), QuickCheck (>=2.7), random, repa (>=3.1), repa-io (>=3.1), scientific (>=0.3), statistics (>=0.13), template-haskell (>=2.2), test-framework (>=0.5), test-framework-hunit (>=0.3), test-framework-quickcheck2 (>=0.2), text (>=0.11), time (>=1.4), vector (>=0.7), vector-algorithms (>=0.4) [details]
License BSD-3-Clause
Author The Accelerate Team
Maintainer Trevor L. McDonell <tmcdonell@cse.unsw.edu.au>
Revised Revision 3 made by TrevorMcDonell at 2018-03-17T05:57:31Z
Category Compilers/Interpreters, Concurrency, Data, Parallelism
Home page https://github.com/AccelerateHS/accelerate-examples
Bug tracker https://github.com/AccelerateHS/accelerate/issues
Source repo head: git clone https://github.com/AccelerateHS/accelerate-examples
this: git clone https://github.com/AccelerateHS/accelerate-examples(tag 1.1.0.0)
Uploaded by TrevorMcDonell at 2017-09-21T10:33:11Z
Distributions NixOS:1.3.0.0
Executables accelerate-kmeans, accelerate-ray, accelerate-pagerank, accelerate-fft, accelerate-hashcat, accelerate-smoothlife, accelerate-nbody, accelerate-fluid, accelerate-mandelbrot, accelerate-canny, accelerate-tunnel, accelerate-crystal, accelerate-smvm, accelerate-nofib
Downloads 10837 total (71 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
All reported builds failed as of 2017-09-21 [all 3 reports]

Modules

  • Data
    • Array
      • Accelerate
        • Examples
          • Data.Array.Accelerate.Examples.Internal

Manual Flags

NameDescriptionDefault
Automatic Flags
NameDescriptionDefault
gui

Enable gloss-based GUIs, where applicable. If not enabled, the application always runs in benchmark mode.

Enabled
ekg

Enable EKG remote monitoring server at http://localhost:8000

Enabled
codespeed

Enable upload of results to benchmark server

Disabled
llvm-cpu

Enable the LLVM backend for multicore CPUs

Enabled
llvm-ptx

Enable the LLVM PTX backend for NVIDIA GPUs

Enabled
nofib

Regression test suite

Enabled
smvm

Sparse-matrix vector multiplication benchmark

Enabled
crystal

A visualisation of a sum of waves in a plane

Enabled
tunnel

The slit-scan effect creating a Doctor Who time vortex

Enabled
canny

Canny edge detection benchmark

Enabled
mandelbrot

A Mandelbrot fractal benchmark

Enabled
fluid

An interactive particle-based fluid simulation

Enabled
nbody

Simulation of gravitational attraction between solid particles

Enabled
smoothlife

A cellular automata simulation

Enabled
hashcat

A "password recovery" application for MD5 cracking

Enabled
fft

Simple FFT-based high/low-pass image filtering

Enabled
pagerank

Implementation of the PageRank algorithm

Enabled
ray

A simple real-time ray tracer

Enabled
kmeans

An implementation of k-means clustering in a plane

Enabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

For package maintainers and hackage trustees

Candidates


Readme for accelerate-examples-1.1.0.0

[back to package description]

Examples programs using Accelerate

Build Status Hackage Docker Automated build Docker status

Example programs using the Accelerate library. If you add new features to the base library or find a bug, please add a test case. The aim is for this program to evolve and be useful for both performance and regression testing.

If you have found a bug, please report it to: https://github.com/AccelerateHS/accelerate/issues

Installation

External dependencies

Installation of accelerate-examples and its dependencies requires several external packages. You may need to adjust the package names or versions slightly for your system.

  • Ubuntu/Debian (apt-get):

    • llvm-4.0-dev
    • freeglut3-dev
    • libfftw3-dev
  • Mac OS (homebrew)

    • fftw
    • libffi
    • llvm-hs/homebrew-llvm/llvm-4.0

If you want to use the CUDA GPU enabled backend accelerate-llvm-ptx, you will also need to install the CUDA toolkit for your system. You can find an installer on NVIDIA's website here:

  • https://developer.nvidia.com/cuda-downloads

stack

For development, the recommend build method is via the stack tool. This will simplify pulling in dependencies not yet on Hackage. For example, to build using ghc-8.0:

ln -s stack-8.0.yaml stack.yaml     # only once
stack build                         # or, 'stack install' to install the executables globally

Before building, you may want to edit the stack.yaml file to change the build configuration. In particular, the flags section at the bottom can be used to enable or disable individual example programs and accelerate backends, as well as features such as monitoring and debug output.

Adding new backends

Adding support for new Accelerate backends should require only a few minor additions to the cabal file and the module 'Data.Array.Accelerate.Examples.Internal.Backend'.