Open danstowell opened 9 months ago
I am happy to stick with Hz for consistency.
It might also be worth discussing whether we use filterLP for easier matching to GUANO or filterLowPass for clarity - AC is relatively verbose with term names. I'm not particularly persuaded either way, filterLP will be understandable to those who regularly deal with audio.
On reflection, I agree that the term list should not be full of cryptic initialisms, so the more self-explanatory/verbose term names would be a good idea: filterLowPass and filterHighPass.
I wonder if a GUANO maintainer such as @riggsd might have a comment
Greetings TDWG!
The GUANO top-level fields Filter HP
and Filter LP
are defined as a float
value in kHz, so Filter HP: 17.5
would represent a high-pass filter at 17500 Hz. While the GUANO spec was designed to target ultrasonic bat recordings, you could represent an audible-range recorder set to remove low-frequency wind noise, for example, with Filter HP: 0.5
for 500 Hz.
I'm not familiar with your TDWG metadata, so I can't say whether you'd have any issues with unit conversion or whether it matters.
Personally, I agree that cryptic abbreviated terms do a disservice to users. However, in the case of GUANO, the metadata itself is intended to be human readable, so we felt fine with some domain-specific terminology and opted not to be overly verbose. In the context of audio processing, a "filter" is commonly known to be of type "HP", "LP", or "BP".
We didn't feel it necessary to overcomplicate by specifying more detail about the filter design, eg. slope 12 "dB/oct" or class "Butterworth", assuming it to be either unimportant, or - if important - implementation specific to the particular hardware or software which could document it with namespaced values. For example, Sonobat doesn't specify its digital filter implementation details to end users, but does persist its specific filter information in a way meaningful to that software: SB|Filter: 20kHz Anti-Katydid
(its "anti-katydid" HPF variant uses a steep slope, but not as steep as its "cutoff" HPF variant).
Term Name: ac:filterLowPass Term Name: ac:filterHighPass
Type: rdf:Property
Label: Low-pass filter frequency Label: High-pass filter frequency
Required: No
Repeatable: No
Definition: Low-pass filter frequency used in the recording/preprocessing of the multimedia item. Definition: High-pass filter frequency used in the recording/preprocessing of the multimedia item.
Usage: Numeric value in hertz (Hz)
Justification for the term addition: High-pass and low-pass filtering is common in the recording and/or preprocessing of sound recordings, and these filter settings can be important information relevant to which phenomena might be represented in a given media item, e.g. searching for ultrasonic signals. In search queries, it can be desirable to target (or exclude) animal sounds that occur within specific frequency ranges. The current proposal intends to adopt the terms "Filter HP" and "Filter LP" terms from GUANO (originally discussed in #247), which currently have no corresponding terms in avcore.
Note: filterLowPass and filterHighPass can be used independently or together.
Note: GUANO uses kHz as units, whereas Audiovisual Core uses Hz in ac:freqLow and ac:freqHigh. Hz is proposed here for self-consistency, though it would make the mapping to GUANO slightly more complex than a pure identity mapping.
Note: This is proposed as a new term rather than an import because GUANO is not a namespaced standard. The correspondence is expressed textually in the definition.
Proposed by myself and @edwbaker