Generalized Morse Wavelets

[OverLordGoldDragon]

FEATURES (major):

• Added Generalized Morse Wavelets (gmw, morsewave in _gmw.py)
• Added signal testing suite, _test_signals.py, and examples
• Added configs.ini, used to control function defaults globally
• Added higher-order CWT (via GMWs); _cwt.cwt_higher_order
• Improved default scales to not over-represent low frequencies

FEATURES (other):

• visuals: added wavelet_filterbank, viz_cwt_higher_order, viz_gmw_orders (first callable as wavelet.viz('filterbank'))
• visuals.wavelet_tf: autopicks scale for scale=None to give a nice visual for any wavelet
• ssq_cwt & ssq_stft: added arg preserve_transform to (see docstrings)
• padsignal: 2D input support, of form (n_signals, signal_length) (i.e. will pad every row vector).
• cwt: support for padtype=None
• maprange: tuple of floats now supported (help(_ssq_cwt.ssq_cwt))
• Wavelet.info() and @propertys of Wavelet revamped for generality; added @propertys: wc_ct, scalec_ct.
• wavelets.center_frequency: added kind='peak-ct'
• utils.find_max_scale now simpler and more effective, guaranteeing complete spectral coverage for low frequencies

BREAKING:

• utils.py -> utils/*: common.py, cwt_utils.py, stft_utils.py
• The default wavelet has been changed from 'morlet' to 'gmw'
• Changed Morlet's default parameters to closely match GMW's defaults per time & frequency resolution
• ssq_cwt(mapkind=) default change: 'maximal' to 'peak'
• scales default change: implicit preset from 'maximal' to 'minimal' for low scales, 'maximal' for high
• ssq_cwt return order change: Tx, ssq_freqs, Wx, scales, w to Tx, Wx, ssq_freqs, scales, w, dWx (additionally returning dWx)
• ssq_stft return order change: Tx, ssq_freqs, Sx, Sfs, dSx, w to Tx, Sx, ssq_freqs, Sfs, w, dSx
• ssqueezing & ssq_cwt: renamed mapkind to maprange
• difftype: 'direct' -> 'trig'
• _infer_scaletype -> infer_scaletype
• _integrate_analytic -> integrate_analytic
• find_max_scale -> find_max_scale_alt, but find_max_scale is still (but a different) function

MISC:

• phase_cwt: takes abs(w) instead of zeroing negatives
• wavelet in icwt and issq_cwt now defaults to the default wavelet
• cwt: added args order, average
• stft & ssq_stft: added t argument
• stft default window increased frequency resolution
• visuals.imshow(): cmap now defaults to 'jet' instead of 'bone' for abs=True
• Added Examples to README, adjusted Minimal Example
• Added ssqueezepy/README.md, test/test_signals_test.py, examples/scales_selection.py

FIXES:

• visuals.wavelet_heatmap: string scales now functional
• visuals: w overreached into negative frequencies for odd N in wavelet_tf, wavelet_tf_anim, & wavelet_heatmap
• icwt: padtype now functional

TODO: update CHANGELOG TODO: higher-order CWT example TODO: "Contributors" in README TODO: file authorship format TODO: numeric maprange TODO: rename mapkind -> maprange? TODO: test stft vs librosa TODO: change scales defaults, low frequencies over-represented TODO: fix echirp