Opusmodus Update 3.0.29191

 To streamline the process of importing SPEAR spectral data into the Opusmodus Library, the three-step procedure has been consolidated into a singular operation. Consequently, the IMPORT-SPECTRAL-SPEAR function has been deprecated and superseded by the newly introduced SPEAR-DATA-TO-LIBRARY function. This enhancement simplifies the importation of SPEAR data in the form of .txt files into Opusmodus, making it more straightforward.

SPEAR-DATA-TO-LIBRARY &key data name section index note

This function processes and imports spectral data from the SPEAR (Sinusoidal Partial Editing Analysis and Resynthesis) application, developed by Michael Klingbeil. SPEAR is a sophisticated tool for audio analysis, editing, and synthesis, based on the McAulay-Quatieri technique. It represents sounds using sinusoidal tracks or 'partials', each track depicting a sinusoidal wave with time-varying frequency and amplitude.

The resynthesis process in SPEAR, which involves computing and summing all sinusoidal waves, can closely approximate the original sound. The sinusoidal model used in SPEAR provides extensive analytical detail about time-varying frequency content and allows for significant flexibility in sound editing and manipulation. SPEAR supports real-time synthesis of numerous partials, extensive editing features like cut, paste, undo/redo, and handles various standard file formats for data import/export.

SPEAR, available at http://www.klingbeil.com/spear/, is free software. It exports two types of spectral data: two-point data (frequency and amplitude, referred to as 'frames') and three-point data (time, frequency, and amplitude, referred to as 'partials').

The initial step in using this function is to place the SPEAR-generated data file in the ~/Opusmodus/Spectrum Data/Data/ directory. SPEAR-DATA-TO-LIBRARY will locate the data file in this directory, convert it, and save a new file in the ~/Opusmodus/Spectrum Data/Partials/ folder. Ultimately, the resultant ‘library’ file will be stored in the ~/Opusmodus/User Source/Libraries/Def-Library/ directory.

Examples:

Generate a library with frames (two-point data):

(spear-data-to-library
 :data "mar-frames"    ; Original SPEAR file name (.txt).
 :name 'mar-frames     ; Name for the generated library.
 :section 'frames      ; Name of the library section.
 :index 'p             ; Index name for each partial.
 )

The structure of the frames library file is envisioned as follows:

(in-package :Opusmodus)
;;; -----------------------------------------------------------
;;; Library | Opusmodus Version 3.0.29183 | 2024-01-31 13:00:37
;;; -----------------------------------------------------------

(def-library mar-frames
(:section frames

  p0 '(13.312057 0.007893 77.37494 0.003534 118.87299 0.027961 . . .

Generate a library with partials (three-point data):

(spear-data-to-library
 :data "mar-partials" ; Original SPEAR file name (.txt).
 :name 'mar-partials  ; Name for the generated library.
 :section 'partials   ; Name of the library section.
 :index 'p            ; Index name for each partial.
 )

The structure of the partials library file is envisioned as follows:

(in-package :Opusmodus)
;;; -----------------------------------------------------------
;;; Library | Opusmodus Version 3.0.29183 | 2024-01-31 13:02:10
;;; -----------------------------------------------------------

(def-library mar-partials
(:section partials

  p0 '(0.0 15731.577 3.0E-4 0.012495 15730.756 2.9E-4 0.024989 . . .

Best wishes,

Janusz