(SP) Enhance Harmonics:
The SignalProcessingHarmonicsEnhancer is a powerful tool designed to enhance the harmonic content of audio signals, making it particularly useful for audio processing tasks where clarity and richness of sound are desired. This node is capable of detecting and boosting specific harmonic frequencies within an audio signal, thereby enriching the audio's tonal quality. By leveraging advanced pitch detection and equalization techniques, it can automatically identify the fundamental frequency of an audio signal and apply precise equalization to enhance selected harmonics. This process can significantly improve the perceived quality of audio by adding warmth and depth, making it ideal for music production, sound design, and other audio-related applications. The node's ability to automatically detect the base frequency or use a specified one provides flexibility, allowing users to tailor the harmonic enhancement to their specific needs.
(SP) Enhance Harmonics Input Parameters:
audio_input
This parameter represents the input audio signal, which should be provided as a dictionary containing a torch.Tensor for the waveform and an integer for the sample rate. The audio signal is the primary data that will undergo harmonic enhancement. The waveform should be a 1D or 2D tensor, and the sample rate should be a positive integer representing the number of samples per second.
harmonics
This parameter specifies the harmonic multipliers to enhance within the audio signal. It is a string of comma-separated integers, such as "1,3,5,7,9", which represent the harmonic frequencies to be boosted. The default value is "1,3,5,7,9". These harmonics are multiples of the base frequency and are crucial for defining the tonal characteristics of the audio.
mode
This parameter determines the method used to identify the base frequency for harmonic enhancement. It can be set to either "detect base frequency" or "use base frequency". The "detect base frequency" mode automatically estimates the fundamental frequency of the audio, while the "use base frequency" mode uses a user-specified frequency. This flexibility allows users to choose between automatic detection and manual specification based on their needs.
base_frequency
This parameter is used when the mode is set to "use base frequency". It is an integer representing the fundamental frequency in Hertz. The default value is 440 Hz, which corresponds to the musical note A4. This parameter allows users to manually specify the base frequency if they have a specific frequency in mind for harmonic enhancement.
gain_db
This parameter defines the gain in decibels to apply to each harmonic frequency. It is a float with a default value of 5 dB. The gain determines the amount of boost applied to the selected harmonics, affecting the overall loudness and presence of these frequencies in the audio signal.
Q
This parameter represents the quality factor for the equalization bands applied to the harmonics. It is a float with a default value of 0.707. The Q factor controls the bandwidth of the equalization, with lower values resulting in wider bands and higher values resulting in narrower bands. This parameter allows for precise control over the frequency enhancement process.
(SP) Enhance Harmonics Output Parameters:
audio_output
The output parameter is a dictionary containing the processed audio signal as a torch.Tensor and the sample rate as an integer. The processed audio signal has enhanced harmonic content, resulting in a richer and more vibrant sound. This output can be used for further audio processing or directly in audio playback applications.
(SP) Enhance Harmonics Usage Tips:
- To achieve a natural-sounding enhancement, start with the default harmonics and gain settings, and adjust the gain_db parameter incrementally to find the desired level of enhancement.
- When working with audio that has a known fundamental frequency, use the "use base frequency" mode to specify the base_frequency parameter for more precise control over the harmonic enhancement.
(SP) Enhance Harmonics Common Errors and Solutions:
Invalid Harmonics Format. Please delimit integers by a comma ',' like this 1,,3,5,7,9
- Explanation: This error occurs when the harmonics parameter is not formatted correctly, such as having missing or extra commas.
- Solution: Ensure that the harmonics string is a properly formatted list of integers separated by commas, with no extra or missing commas.
Base frequency detection failed, using default 440 Hz
- Explanation: This message indicates that the automatic detection of the base frequency was unsuccessful, and the default frequency of 440 Hz is being used.
- Solution: If the detected base frequency is not suitable, consider using the "use base frequency" mode to manually specify the base frequency.
