(SP) Loudness:
The SignalProcessingLoudness node is designed to measure the loudness of an audio signal, providing a quantitative assessment of how loud the audio is perceived. This node is particularly useful in audio processing tasks where understanding the loudness level is crucial, such as in audio mastering, broadcasting, or any application where maintaining consistent audio levels is important. By leveraging advanced algorithms, the node calculates the loudness in LUFS (Loudness Units relative to Full Scale), which is a standardized measure of loudness that accounts for human hearing sensitivity. This ensures that the loudness measurement is not just based on raw amplitude but also considers how the audio will be perceived by listeners. The node's primary goal is to offer a reliable and accurate loudness measurement, enabling you to make informed decisions about audio adjustments and processing.
(SP) Loudness Input Parameters:
audio_input
The audio_input parameter is the primary input for the node, accepting audio data in the form of a PyTorch tensor. This parameter represents the audio signal that you wish to analyze for loudness. The input should be structured as a dictionary containing the waveform data and the sample rate, which are essential for accurate loudness calculation. The waveform is a tensor that holds the audio samples, while the sample rate indicates how many samples per second are present in the audio. This parameter does not have specific minimum or maximum values, but it is crucial that the audio data is correctly formatted and that the sample rate accurately reflects the audio's characteristics to ensure precise loudness measurement.
(SP) Loudness Output Parameters:
loudness
The loudness output parameter provides the calculated loudness of the input audio signal in LUFS. This output is a floating-point number that represents the integrated loudness level, offering a standardized measure of how loud the audio is perceived. The LUFS value is crucial for understanding the overall loudness of the audio, allowing you to compare it against industry standards or target loudness levels. A lower LUFS value indicates quieter audio, while a higher value suggests louder audio. This output is essential for tasks that require precise loudness control, such as ensuring consistent audio levels across different media or platforms.
(SP) Loudness Usage Tips:
- Ensure that the audio input is correctly formatted as a PyTorch tensor with an accurate sample rate to achieve precise loudness measurements.
- Use the loudness output to adjust audio levels in post-processing, ensuring that your audio meets desired loudness standards or targets.
(SP) Loudness Common Errors and Solutions:
Invalid audio input format
- Explanation: This error occurs when the audio input is not provided in the expected format, such as a PyTorch tensor with the correct structure.
- Solution: Verify that the audio input is a dictionary containing a waveform tensor and a sample rate. Ensure that the tensor is correctly formatted and that the sample rate accurately reflects the audio's characteristics.
PyTorch tensor conversion error
- Explanation: This error may arise if there is an issue converting the audio data to a PyTorch tensor, possibly due to incompatible data types or structures.
- Solution: Check that the audio data is compatible with PyTorch tensor operations. Ensure that any necessary conversions or preprocessing steps are performed before passing the audio to the node.
