Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tribusonz-2/ruby-ooura_fft
Ooura FFT front-end for Ruby
https://github.com/tribusonz-2/ruby-ooura_fft
c c-extension cruby front-end ooura-fft ruby
Last synced: about 1 month ago
JSON representation
Ooura FFT front-end for Ruby
- Host: GitHub
- URL: https://github.com/tribusonz-2/ruby-ooura_fft
- Owner: tribusonz-2
- License: mit
- Created: 2024-04-29T12:03:53.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-10-24T14:13:21.000Z (3 months ago)
- Last Synced: 2024-10-24T14:19:10.234Z (3 months ago)
- Topics: c, c-extension, cruby, front-end, ooura-fft, ruby
- Language: C
- Homepage:
- Size: 87.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# ooura_fft (Ruby gem)
This is a Ruby's front end that allows to use [FFT software of Professor Ooura (Kyoto University)](https://www.kurims.kyoto-u.ac.jp/~ooura/index-j.html).
## Installation
The software is included in this library. Professor Ooura does not have an installer.
Install the gem and add to the application's Gemfile by executing:
```bash
bundle add ooura_fft
```
If bundler is not being used to manage dependencies, install the gem by executing:
```bash
gem install ooura_fft
```
## Usage
Now, there are a total of 6 FFT routines, which are as follows:
```
cdft: Complex Discrete Fourier Transform
rdft: Real Discrete Fourier Transform
ddct: Discrete Cosine Transform
ddst: Discrete Sine Transform
dfct: Cosine Transform of RDFT (Real Symmetric DFT)
dfst: Sine Transform of RDFT (Real Anti-symmetric DFT)
```
These routines are owned by the OouraFFT module.
Since the software's using is a discrete type, the ABI makes use of arrays.
In Ruby, it is communicated with the Array class. The Array class is used as an argument, and the FFT computed Array class is the return value.
The design is unified as follows:
```Ruby
OouraFFT.xxxx(*nusec, inversion: bool)
```
This `*nusec` is the Array class. Internally, it is treated as a numeric sequence.
It also supports inverse FFT, and works by applying `true` to the keyword argument `inversion`. The default value is `false`.
```Ruby
def sinewave(amp, f0, fs, n)
amp * Math.sin(2 * Math::PI * f0 * n / fs)
end
OouraFFT.ddct(Array.new(8){|n| sinewave(0.25, 250.0, 8000, n)})
#=> [0.6284174365157309,
#=> -0.6284174365157309,
#=> 0.18707572033318604,
#=> -0.18707572033318612,
#=> 0.08352232973991239,
#=> -0.08352232973991236,
#=> 0.02486404592245728,
#=> -0.024864045922457167]
OouraFFT.ddst(Array.new(8){|n| sinewave(0.25, 250.0, 8000, n)})
#=> [0.875,
#=> 0.12500000000000003,
#=> -0.12499999999999997,
#=> 0.125,
#=> -0.125,
#=> 0.12500000000000006,
#=> -0.12499999999999994,
#=> 0.12499999999999994]
```
For more information on how to the fourier transform, please refer to the technical book.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/tribusonz-2/ooura_fft. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/tribusonz-2/ruby-ooura_fft/blob/master/CODE_OF_CONDUCT.md).
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
## Code of Conduct
Everyone interacting in the OouraFft project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/tribusonz-2/ooura_fft/blob/master/CODE_OF_CONDUCT.md).
## Provided as a C API
In the future, we plan to provide APIs for gems that are written in C.
In the case of OouraFFT, it is as follows:
```CXX
RUBY_EXT_EXTERN VALUE rb_mOouraFFT;
VALUE rb_oourafft_cdft(VALUE, int);
VALUE rb_oourafft_rdft(VALUE, int);
VALUE rb_oourafft_ddct(VALUE, int);
VALUE rb_oourafft_ddst(VALUE, int);
VALUE rb_oourafft_dfct(VALUE, int);
VALUE rb_oourafft_dfst(VALUE, int);
```
When install a gem, a directory is created in the installation location along with the .so file. Here is the header file in C.
In general, there is `globals.h` which declares the object variables that are entities, and `api.h` which declares the API functions that can be used in C. There is also a header called `ext_extern.h`. This is to let the C side know that object variables are treated as global variables at the C level.
To invoke them, include:
```CXX
#include
#include
```