This Toolbox was ported from http://tftb.nongnu.org
It implements various kinds of time-frequency analysis with a special emphasis
on quadratic energy distributions of the Cohen and affine classes, along with
their version enhanced by the reassignment method. Signals generation,
processing / post-processing routines (with display utilities) and demos are
also included.
Tutorial: https://atoms.scilab.org/toolboxes/stftb/2.0.2/files/tutorial.pdf
PDF manual: https://atoms.scilab.org/toolboxes/stftb/2.0.3/files/stftb_2.0_user_manual.pdf
Comments: https://atoms.scilab.org/toolboxes/stftb/2.0.5#leave_a_comment
Report bugs @ https://gitlab.com/scilab/forge/stftb/-/issues
INSTALLATION WARNING
--------------------
If on Windows as a not-full-admin you encounter the bug 16961 [1]
|Installation failed !|
|atomsInstall: Error while creating the directory '..dir path..'.|
then installing the module in user mode will work:
--> atomsInstall("stftb", "user")
[1]
https://gitlab.com/scilab/scilab/-/issues/16961
https://gitlab.com/scilab/scilab/-/merge_requests/295#note_1653385985
CONTENTS
--------
TF = Time-Frequency
Ambiguity plane functions
Caf2tfr — From ambiguity plane to TF plane
Cambifunb — Ambiguity function
Ctfrker — Time frequency representation kernel
Miscellaneous functions
Chtl — Hough transform for detection of lines in images
Ctfrdist — TF distance
Ctfrreas — TF Representation reassignment
Cwindow — Creates a window of length N with a given shape
Time-Frequency representations
Ctfrbj — Born-Jordan TF distribution
Ctfrbud — Butterworth TF distribution
Ctfrcw — Choi-Williams TF distribution
Ctfrgrd — Generalized rectangular TF distribution
Ctfrmh — Margenau-Hill TF distribution
Ctfrmhs — Margenau-Hill-Spectrogram TF distribution
Ctfrmmce — Minimum mean cross-entropy combination of spectrograms
Ctfrpage — Page TF distribution
Ctfrpmh — Pseudo Margenau-Hill TF distribution
Ctfrppage — Pseudo Page TF distribution
Ctfrpwv — Pseudo Wigner-Ville TF distribution
Ctfrri — Rihaczek TF distribution
Ctfrridb — Reduced Interference Distribution with Bessel kernel
Ctfrridbn — Reduced Interference Distribution with binomial kernel
Ctfrridh — Reduced Interference Distribution with Hanning kernel
Ctfrridt — Reduced Interference Distribution with Triangular kernel
Ctfrrsp — Reassigned Spectrogram
Ctfrsp — Spectrogram Time Frequency distribution of a signal X
Ctfrspwv — Smoothed Pseudo Wigner-Ville TF distribution
Ctfrstft — Short time Fourier transform
Ctfrwv — Wigner-Ville TF distribution
Ctfrzam — Zao-Atlas-Marks TF distribution
Ambiguity Functions
ambifunb — Narrow-band ambiguity function
ambifuwb — Wide-band ambiguity function
Choice of the Instantaneous Amplitude
amexpo1s — Generate one-sided exponential amplitude modulation
amexpo2s — Generate bilateral exponential amplitude modulation
amgauss — Generate gaussian amplitude modulation
amrect — Generate rectangular amplitude modulation
amtriang — Generate triangular amplitude modulation
Bilinear Time-Frequency Processing in the Affine Class
istfraff — is it an affine TF representation
lambdak — Evaluate lambda function for Affine Wigner distribution
tfrbert — Unitary Bertrand TF distribution
tfrdfla — D-Flandrin TF distribution
tfrscalo — Scalogram, for Morlet or Mexican hat wavelet
tfrspaw — Smoothed Pseudo Affine Wigner TF distributions
tfrunter — Unterberger TF distribution
Bilinear Time-Frequency Processing in the Cohen's Class
tfrbj — Born-Jordan TF distribution
tfrbud — Butterworth TF distribution
tfrcw — Choi-Williams TF distribution
tfrgrd — Generalized rectangular TF distribution
tfrmh — Margenau-Hill TF distribution
tfrmhs — Margenau-Hill-Spectrogram TF distribution
tfrmmce — Minimum mean cross-entropy combination of spectrograms
tfrpage — Page TF distribution
tfrpmh — Pseudo Margenau-Hill TF distribution
tfrppage — Pseudo Page TF distribution
tfrpwv — Pseudo Wigner-Ville TF distribution
tfrri — Rihaczek TF distribution
tfrridb — Reduced Interference Distribution with Bessel kernel
tfrridbn — Reduced Interference Distribution with a binomial kernel
tfrridh — Reduced Interference Distribution with Hanning kernel
tfrridt — Reduced Interference Distribution with triangular kernel
tfrsp — Spectrogram TF distribution
tfrspbk — Smoothed Pseudo K-Bertrand TF distribution
tfrspwv — Smoothed Pseudo Wigner-Ville TF distribution
tfrwv — Wigner-Ville TF distribution
tfrzam — Zao-Atlas-Marks TF distribution
Frequency-Domain Processing
ffmt — Fast Fourier Mellin Transform
frpowerspec — Compute the energy spectrum of the signal
frspec — Compute the spectrum of the signal
iffmt — Inverse fast Mellin transform
locfreq — Frequency localization caracteristics
parafrep — parametric frequency representation of a signal
sgrpdlay — Group delay estimation of a signal
tftb_fft — matlab compatible fft
tftb_ifft — matlab compatible ifft
Choice of the Instantaneous Frequency
fmconst — Signal with constant frequency modulation
fmhyp — Signal with hyperbolic frequency modulation
fmlin — Signal with linear frequency modulation
fmodany — Signal with arbitrary frequency modulation
fmpar — Parabolic frequency modulated signal
fmpower — Signal with power-law frequency modulation
fmsin — Signal with sinusoidal frequency modulation
gdpower — Signal with power-law group delay
if2phase — Generate the phase from the instantaneous frequency
Linear Time-Frequency Processing
tffilter — Time frequency filtering of a signal
tfrgabor — Gabor representation of a signal
tfristft — Inverse Short time Fourier transform
tfrstft — Short time Fourier transform
tfrsurf — extract the biggest energy dots
Modification
scale — Scale a signal using the Mellin transform
sigmerge — Add two signals with given energy ratio in dB
Noise Realizations
noisecg — Analytic complex gaussian noise
noisecu — Analytic complex uniform white noise
Other
contwtgn — compute a continuous wavelet transform
contwtgnmir — Continuous wavelet transform of mirrored 1-D signals
correlmx — correlation matrix of a signal
d2statio — Distance to stationarity
disprog — Display progression of a loop
divider — Find dividers of an integer
dwindow — Derive a window
fzero — solves the scalar nonlinear equation such that F(X) == 0
gaussn — generate the order n derivative of the gaussian window
imextrac — imextrac(Image) extract and isolate dots in a binary image
integ — Approximate 1D integral of a discrete signal
integ2d — Approximate 2-D integral
istfr1 — is a TF representation of type 1 (freq>0 or <0)
istfr2 — is a TF representation of type 2 (only freq>0)
izak — Inverse Zak transform
kaytth — Kay-Tretter filter computation
odd — Round towards nearest odd value
rem — Return the remainder of the division x/y
rot90 — rotate the given 2-D array by 90 degrees
umaxbert — Get the maximum value of u for Bertrand distribution
umaxdfla — Get the maximum value of u for D-Flandrin distribution
umaxunte — Get the maximum value of u for Unterberger distribution
vecmodulo — Congruence of a vector
zak — Zak transform
Post-Processing or Help to the Interpretation
friedman — FRIEDMAN Instantaneous frequency density
holder — Estimate the Holder exponent through an affine TFR
htl — Hough transform for detection of lines in images
margtfr — Marginals and energy of a TF representation
midpoint — Mid-point construction used in the interference diagram
momftfr — Frequency moments of a TF representation
momttfr — Time moments of a TF representation
plotsid — Schematic interference diagram of FM signals
renyi — Measure Renyi information
ridges — Extraction of ridges
tfrideal — Ideal TFR for given instantaneous frequency laws
Reassigned Time-Frequency Processing
tfrrgab — Reassigned Gabor spectrogram TF distribution
tfrrmsc — Reassigned Morlet Scalogram TF distribution
tfrrpmh — Reassigned pseudo Margenau-Hill TF distribution
tfrrppag — Reassigned pseudo Page TF distribution
tfrrpwv — Reassigned pseudo Wigner-Ville distribution
tfrrsp — Reassigned Spectrogram
tfrrspwv — Reassigned smoothed pseudo Wigner-Ville distribution
tfrrstan — Reassigned Stankovic distribution
Choice of Particular Signals
altes — Altes signal in time domain
anaask — Amplitude Shift Keying (ASK) signal
anabpsk — Binary Phase Shift Keying (BPSK) signal
anafsk — Frequency Shift Keying (FSK) signal
anapulse — Analytic projection of unit amplitude impulse signal
anaqpsk — Quaternary Phase Shift Keying (QPSK) signal
anasing — Lipschitz singularity
anastep — Analytic projection of unit step signal
atoms — Linear combination of elementary Gaussian atoms
chirp — Evaluate a chirp signal at time t
dopnoise — Complex noisy doppler signal
doppler — Complex Doppler signal
griffitc — Test signal example C of Griffiths' paper
klauder — Klauder wavelet in time domain
mexhat — Mexican hat wavelet in time domain
pulstran — Pulse
sawtooth — Sawtooth wave
tftb_window — Window generation
Time-Domain Processing
ifestar2 — Instantaneous frequency estimation using AR2 model.
instfreq — Instantaneous frequency estimation
loctime — Time localization caracteristics
Visualization and backup
plotifl — Plot normalized instantaneous frequency laws
tfrparam — parametric TF representation
tfrqview — Quick visualization of TF representations
tfrsave — Save the parameters of a TF representation
tfrview — Visualization of TF representations
