![]() |
|
![]() |
INFO functions mostly give information on files, and normally operate outside Soundshaper's Patchgrid: either producing an immediate report in the Report Window or generating a text file which can be viewed in the Report Window. The Soundfiles category includes some general functions which operate on various CDP file types. The Unit Conversions are available independently of any file.
(SOUND)FILE INFORMATION
A range of functions giving general information about soundfiles (esp. FileInfo and SfProps), as well as specific aspects such as gated onsets and process-specific aspects such as peak times and grain times.
GENERAL
- FileInfo: display information about soundfiles and other system files. (Displays file-type, samples, sample-rate, chans, sample-type, peak data.)
- SfProps: display (multi-channel) soundfile properties.(Displays: format, sample-rate, channels, sample-frames, sample-type, duration, peak data.)
- SfLength: report length of (sound)file. (Length in secs. is already displayed in Soundshaper's Main page; this function also gives sample-type and no. of samples.)
- Maxsamp: Find highest level in soundfile and show where it occurs and max. possible gain.
- Maxrange: as Maxsamp, but finds maximum level within time-range. (Either set start and end of range on parameter page, or enter in markers box.)
- RMSInfo: reports RMS and average power level across time-range.
- FindHole: find maximum segment below given threshold level, if level falls and stays below the threshold.
- ZCross: displays proportion of zero-crossings.
- Onsets: Extracts gated onset times (to text file); parameters include gate and threshold-level.
- Peakfind: find times of peaks in a soundfile. (Reports to peaktimes.txt, used in RHYTHM functions.)
- R-FindDurns: find longest and shortest silence-separated event. (Used in RHYTHM functions.)
- Findstart: find first non-zero sample in sound.
COMPARATIVE
- Loudest: find loudest sound in list.
- SFLengths: List durations of several soundfiles.
- SumLen: Sum the durations of several soundfiles.
- Levels: List levels of several soundfiles.
- SFDiff: Compare 2 soundfiles (or other CDP types).
- TimeDiff: Compare lengths of two soundfiles
- Chandiff: Compare channels in a stereo soundfile.
- Loudchan: Find loudest channel in a stereo soundfile.
VIEW / PRINT
- Envview: View envelope as pseudo-soundfile. (Soundshaper can also extract and display envelope in Graph-Edit.)
- SFPrint: Print soundfile data to textfile (time and amp values).
- SFList: List sound and other system files in selected folder. (Wildcards are permitted.)
PROCESS-SPECIFIC
- CycCount: count pseudo-wavecycles (DISTORT functions).
- GrnAssess: Assess best gate value to find maximum grains (GRAIN functions).
- GrnCount: Count grains found for given gate value (GRAIN functions).
- GrnFind: Find grains in a grainy sound (outputs text file of grain times for GRAIN functions).
- FindPan: Find pan position in stereo soundfile, at given time. (Reports and compares levels at this time to determine pan position.)
- CalcStretch (CDP: stretcha): calculates stretch factor for TIMESTRETCH, or the number of beats for a given stretch. (Requires soundfile input; see also counterpart in Unit Conversions sub-menu below.)
SPECTRAL FILE INFORMATION
Various functions give basic information about frequency analysis files; several functions analyse these files in details, especially to find spectral peaks.
- FileInfo: for spectral files and derivatives (pitch and formant), this displays file-type, samples, sample-rate (of freq. analysis), original sample-rate (of source soundfile), spectral channels, analysis rate, window-length, and the decimation factor.
- SfLength: report length of spectral file. (Length in secs. is already displayed in Soundshaper's Main page; this function also gives sample-type and no. of samples.)
- FrqToChan: get PVOC channel number for given frequency.
- ChanToFrq: get frequency of given PVOC channel number.
- Windows: number of windows in spectral file (frequency analysis file).
- Octvu: textfile report of relative spectral amplitude in octave bands (based on given fundamental freq. and a chosen time-step for a new report line).
- PeakAmp (CDP: specinfo peak): reports the time-varying peak energy band (the low and high freq. of the band having the maximum energy in each time-window, or a specified time-window).
- PeakFrq (CDP: specinfo report) gives the frequencies of the most prominent peaks, in a time-varying manner.
- PeakFreqs (CDP: newmorph 2) extracts the frequencies (only) of the most prominent peaks (averaged over the whole file), in order of amplitude.
- PeakExtract extracts spectral peaks from freq. analysis file (textfile out).
- GetHmcs (CDP: get_partials hmc): reports the frequencies and amplitudes of the harmonics of a given fundamental. (Useful for analysing a single note if you already know its fundamental frequency).
- LevelVu: shows the time-varying level of a spectral file as a pseudo-soundfile, displayed in CDP's VIEWSF. The file should NOT be played.
- SpecPrint: outputs a complete listing of the amplitude and frequency data for each channel, window by window, to a textfile. Use with care: more than a few windows will generate a huge textfile.
- SeeFmts: shows a binary formant file (.for) as a pseudo-soundfile, displayed in CDP's VIEWSF. The file should NOT be played.
- GetSeeFmts: extracts formants and displays them as a pseudo-soundfile in CDP's VIEWSF. The file should NOT be played.
PITCH FILE INFORMATION
A number of functions which give information about pitch files (.frq):
- FileInfo: for pitch files this displays file-type, samples, sample-rate (of freq. analysis), original sample-rate (of source soundfile), spectral channels, analysis rate, window-length, and the decimation factor.
- PchInfo reports the maximum, minimum and mean pitches found: in hertz and MIDI pitch values, and when thy occur.
- PchZeros reports whether there are or are not unpitched windows found in the file. This could be of use before running one of the Pitch Support functions which interpolates pitch across unpitched windows.
- PchHear allows you to hear the extracted pitch as a basic spectral file that can be played by PVPLAY.
- PchSee shows a binary pitch file (.for) as a pseudo-soundfile, displayed in CDP's VIEWSF. The file should NOT be played.
- TranSee shows a binary transposition file (.trn) as a pseudo-soundfile, displayed in CDP's VIEWSF. The file should NOT be played.
UNTI CONVERSIONS
This section converts a number of musical and audio units and reports to the report window. The first three groups do not need an input file. The conversions are:
- PitchConv: MIDI (pitch) to Hertz (freq.)
- PitchConv: Hz. to MIDI
- PitchConv: Interval as ratio to semitones
- PitchConv: Semitones to ratio
- SpeedConv: freq. ratio to time (if sound speeded up or slowed down by SPEED)
- SpeedConv: time to freq. ratio
- SpeedConv: semitones to time
- SpeedConv: time to semitones
- GainConv: dB (<0) to Gain (0-1)
- GainConv: Gain to dB
- TimeSamps: sample-count to time (secs.)
- TimeSamps: time to sample-count
- FreqToChan: find PVOC channel number for given frequency
- ChanToFreq: find frequency for given PVOC channel number
- CalcStretch (CDP: stretcha) calculates timestretch information for use with spectral TIMESTRETCH: stretch factor to achieve new given tempo or duration, or both; number of beats at new tempo from current duration or beats/tempo. (No input file needed.)
RETURN to top of page |