https://github.com/mkaudio-company/bilinear_tf

Cohen's class of time-frequency distributions in Rust.
https://github.com/mkaudio-company/bilinear_tf

audio audio-processing signal-processing time-frequency time-frequency-analysis time-frequency-distribution

Last synced: about 1 year ago
JSON representation

Cohen's class of time-frequency distributions in Rust.

• Host: GitHub
• URL: https://github.com/mkaudio-company/bilinear_tf
• Owner: mkaudio-company
• License: apache-2.0
• Created: 2024-05-20T03:15:00.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-05-20T08:10:25.000Z (about 2 years ago)
• Last Synced: 2025-03-01T04:49:08.340Z (over 1 year ago)
• Topics: audio, audio-processing, signal-processing, time-frequency, time-frequency-analysis, time-frequency-distribution
• Language: Rust
• Homepage: https://crates.io/crates/bilinear_tf
• Size: 17.6 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.MD
  • License: LICENSE-Apache

Awesome Lists containing this project

README

          
# bilinear_tf

[![](https://img.shields.io/crates/v/bilinear_tf.svg)](https://crates.io/crates/bilinear_tf)

[![](https://img.shields.io/crates/l/bilinear_tf.svg)](https://crates.io/crates/bilinear_tf)

[![](https://docs.rs/bilinear_tf/badge.svg)](https://docs.rs/bilinear_tf/)

This crate implements Cohen's class of time-frequency distributions in Rust. It allows computation of the time-frequency distribution of a signal with a chosen kernel function applied in the ambiguity domain.

## Overview

Cohen's class distributions provide a general framework for time-frequency analysis of signals. They are defined in terms of a bilinear transformation of the signal's ambiguity function, allowing for flexible and adaptive time-frequency representations.

## Features

- Compute the ambiguity function of a signal.

- Apply a kernel function to the ambiguity function.

- Transform the modified ambiguity function back to the time-frequency domain.

- Use different kernel functions (e.g., Wigner, Choi-Williams, Rihaczek, and Zhao-Atlas-Marks).

## Usage

```rust

use bilinear_tf::*;

use rand::prelude::*;

use rayon::prelude::*;

let mut input = vec![0.0;48000];

input.par_iter_mut().for_each(|element| { *element = thread_rng().gen_range(-1.0..1.0); });

let result = bilinear_tf_distribution(&input, cone_shape, 0.001);

```

## Changelog

* 0.2.1 - Added document.

* 0.2.0 - Used rayon for multithreading.

* 0.1.0 - 0.1.1 - Initial release.

# Citation

Cohen, Leon. Time-Frequency Analysis. Prentice Hall, 1995.

Choi, H., & Williams, W. J. "Improved time-frequency representation of multicomponent signals using exponential kernels." IEEE Transactions on Acoustics, Speech, and Signal Processing, vol. 37, no. 6, June 1989, pp. 862–871.

Rihaczek, Jan. "Waveforms Correlated with Quadratic Forms of Themselves." IRE Transactions on Information Theory, vol. 12, no. 3, 1966, pp. 225-231. doi:10.1109/TIT.1966.1053887.

Zhao, Y., Atlas, L. E., & Marks, R. J. "The use of cone-shape kernels for generalized time-frequency representations of nonstationary signals." IEEE Transactions on Acoustics, Speech, and Signal Processing, vol. 38, no. 7, July 1990, pp. 1084–1091.