Project

convolver

0.01
No commit activity in last 3 years
No release in over 3 years
Convolution for NArray
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.3
>= 0.6.7
>= 1.9.1
>= 2.13.0
>= 0.8.7.2

Runtime

>= 0.3
>= 0.6.0.8
 Project Readme

Convolver

Gem Version Build Status Coverage Status Code Climate

Calculates discrete convolution between two multi-dimensional arrays of floats. See http://en.wikipedia.org/wiki/Convolution

Installation

Dependency: FFTW3

Before you install convolver, you should install the FFTW3 library on your system. See http://www.fftw.org/ for details.

Installing the gem

Add this line to your application's Gemfile:

gem 'convolver'

And then execute:

$ bundle

Or install it yourself as:

$ gem install convolver

Usage

Basic convolution:

a = NArray[0.3,0.4,0.5]
b = NArray[1.3, -0.5]
c = Convolver.convolve( a, b )
=> NArray.float(2): [ 0.19, 0.27 ]
  • Convolver only works on single-precision floats internally. It will cast NArray types to this, if possible, prior to calculating. For best speed, use NArray.sfloat arrays.

  • The output is smaller than the input, it only contains fully-calculated values. The output size is the original size, minus the kernel size, plus 1, in each dimension.

  • Convolver expects input a and kernel b to have the same rank, and for the kernel to be same size or smaller in all dimensions as the input.

  • Convolver.convolve will try to choose the faster of two approaches it has coded. In general, small convolutions are processed directly by multiplying out all combinations and summing them, and large convolutions are processed using FFTW3 to convert to frequency space where convolution is simpler and faster to calculate, then convert back.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Contributors

  • Dima Ermilov contributed fix to support compiling under Windows.