]> Shamusworld >> Repos - ardour-manual/blob - include/loudness-analyzer.html
Added the Loudness Analyzer and Normalizer
[ardour-manual] / include / loudness-analyzer.html
1 <p>
2   The Loudness Analyzer &amp; Normalizer is a tool that is useful at the
3   end of the mixing process to make the final audio file comply with
4   different specs regarding loudness.
5 </p>
6
7 <p>
8   It is enabled by checking
9   <kbd class="option">Enable master-bus output gain control</kbd> in the 
10   <a href="@@preferences#preferences-mixer">Preferences</a>.
11   The <a href="@@master-bus-strip">Master Bus strip</a> then shows a <kbd class="menu">LAN</kbd>
12   button to start the analysis, and a volume slider that is the global gain
13   that can be set either manually or by the loudness normalizer.
14 </p>
15 <p>
16   The LAN can also be started from the <kbd class="menu">Session &gt; Loudness
17   assistant&hellip;</kbd> menu. If the option above is not enabled, Ardour
18   will link to the relevant page of the Preferences.
19 </p>
20
21 <p>Either method show the following window:</p>
22
23 <figure>
24   <img src="/images/pre_loudness.png" alt="The Loudness Analyzer realtime selector">
25   <figcaption>
26     The Loudness Analyzer realtime selector
27   </figcaption>
28 </figure>
29
30 <p>
31         This window allows to start the loudness analysis. A choice is offered
32         between freewheeling (i.e. Ardour renders the session as fast as possible
33         to measure the loudness), by default, or Realtime, for cases where freewheeling would
34         not accurately render the session, e.g. if a hardware or JACK effect
35         is used in the session, by clicking on the <kbd class="menu">Realtime</kbd>
36         toggle button.
37 </p>
38
39 <p>
40         After the analysis is over, the Loudness Analyzer and Normalizer is shown:
41 </p>
42
43 <figure>
44   <img src="/images/loudness_analyzer.png" alt="The Loudness Analyzer and Normalizer">
45   <figcaption>
46     The Loudness Analyzer and Normalizer
47   </figcaption>
48 </figure>
49
50 <p>
51         As loudness is a perceived sonic energy, and depends on the level, frequency,
52         duration and nature of the sound, this window allows to base the calculation
53         of the loudness normalization on different parameters : 
54 </p>
55 <ul>
56         <li><dfn>Peak :</dfn> is the highest signal level value</li>
57         <li><dfn>True Peak :</dfn> is the highest signal level value where the
58                 signal has been oversampled to figure out more in-between values
59                 between the samples (interpolation)</li>
60         <li><dfn>Integrated Loudness :</dfn> is the loudness computed from the
61                 whole session or range</li>
62         <li><dfn>Max Short Loudness :</dfn> is the maximum loudness computed
63                 on short time ranges (3 seconds)</li>
64         <li><dfn>Max Momentary Loudness :</dfn> is the maximum momentary loudness</li>
65 </ul>
66 <p>
67         Any combination of these parameters can be taken into account when determining 
68         the gain normalization, by checking its momentary button, and setting a 
69         <em>Target</em> value.
70 </p>
71 <p>
72         Ardour shows both the <em>Measured</em> value of the parameters, and the
73         <em>Delta</em> value, i.e. the difference between the <em>Target</em>
74         and <em>Measured</em> values, hence the gain correction.
75 </p>
76 <p>
77         The maximum <em>Delta</em> value is the Gain correction to apply to fit
78         all the Target values.
79 </p>
80 <p>
81         Ardour shows, under the parameters, a summary of the calculation :
82 </p>
83 <ul>
84         <li><dfn>Gain to normalize:</dfn> is the max <em>Delta</em> value</li>
85         <li><dfn>Previous output gain:</dfn> is the current Master track gain</li>
86         <li><dfn>Total Gain:</dfn> is the difference between these two values,
87                 hence the correction to apply</li>
88 </ul>
89
90 <p>
91         At the top of the window, a <kbd>Show Graphical Analysis</kbd> button
92         allows to visually represent the analysis with a graph in a very similar
93         window to the one in the Post-<a href="@@export-dialog">Export</a> analysis.
94 </p>
95
96 <p>
97         A selection of presets is offered to simplify the normalization. These
98         presets apply the relevant parameters and their target values. Below
99         is a table of these presets:
100 </p>
101 <table>
102         <thead>
103                 <tr><th>Parameter name: </th><th>dbFS </th><th>dBTP </th><th>LUFS </th><th>short</th><th>mom. </th><th>FS</th><th>TP  </th><th>int</th><th>sht </th><th>mom</th><th>maxIntg</th><th>notes</th></tr>
104         </thead>
105         <tbody>
106                 <tr><th>-Analysis Only- </th><td>false</td><td>false</td><td>false</td><td>false</td><td>false</td><td> 0</td><td> 0.0</td><td>  0</td><td>  0</td><td>  0</td><td>  0.0</td><td>-200.0</td></tr>
107                 <tr><th>EBU R128                </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-23</td><td>  0</td><td>  0</td><td>-22.5</td><td> -23.5</td></tr>
108                 <tr><th>EBU R128 S1             </th><td>false</td><td> true</td><td> true</td><td> true</td><td>false</td><td> 0</td><td>-1.0</td><td>-23</td><td>-18</td><td>  0</td><td>-22.5</td><td> -23.5</td></tr>
109                 <tr><th>ATSC A/85               </th><td>false</td><td> true</td><td> true</td><td> true</td><td>false</td><td> 0</td><td>-2.0</td><td>-24</td><td>  0</td><td>  0</td><td>-22.0</td><td> -26.0</td></tr>
110                 <tr><th>AES Streaming   </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-18</td><td>  0</td><td>  0</td><td>-16.0</td><td> -20.0</td></tr>
111                 <tr><th>ASWG-R001 HOME  </th><td>false</td><td> true</td><td> true</td><td> true</td><td>false</td><td> 0</td><td>-1.0</td><td>-24</td><td>  0</td><td>  0</td><td>-22.0</td><td> -26.0</td></tr>
112                 <tr><th>Digital Peak    </th><td> true</td><td>false</td><td>false</td><td>false</td><td>false</td><td> 0</td><td> 0.0</td><td>  0</td><td>  0</td><td>  0</td><td>  0.0</td><td>-200.0</td></tr>
113                 <tr><th>CD                              </th><td> true</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-0.1</td><td> -9</td><td>  0</td><td>  0</td><td>  0.0</td><td>-200.0</td></tr>
114
115                 <tr><th>Amazon Music    </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-2.0</td><td>-14</td><td>  0</td><td>  0</td><td> -9.0</td><td> -19.0</td></tr>
116                 <tr><th>Apple Music             </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-16</td><td>  0</td><td>  0</td><td>-15.0</td><td> -17.0</td></tr>
117                 <tr><th>Deezer                  </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-15</td><td>  0</td><td>  0</td><td>-14.0</td><td> -16.0</td></tr>
118                 <tr><th>Soundcloud              </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-10</td><td>  0</td><td>  0</td><td> -8.0</td><td> -13.0</td></tr>
119                 <tr><th>Spotify                 </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-14</td><td>  0</td><td>  0</td><td> -8.0</td><td> -20.0</td></tr>
120                 <tr><th>Spotify Loud    </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-2.0</td><td>-11</td><td>  0</td><td>  0</td><td> -5.0</td><td> -17.0</td></tr>
121                 <tr><th>Youtube                 </th><td>false</td><td> true</td><td> true</td><td>false</td><td>false</td><td> 0</td><td>-1.0</td><td>-14</td><td>  0</td><td>  0</td><td>-13.0</td><td> -15.0</td></tr>
122         </tbody>
123 </table>
124
125 <p>
126         At the lower end of the window is a <em>Conformity Analysis</em> folding
127         info panel that is opened by clicking its title, and indicating, for each
128         of the presets above, if the corrected gain would fit the required values:
129 </p>
130 <ul>
131         <li><span style="color:red;">&#10006;</span>: the signal is too loud</li>
132         <li><span style="color:orange;">&#10004;</span>: the signal is too quiet, but satisfies the max. loudness spec</li>
133         <li><span style="color:green;">&#10004;</span>: signal loudness is within the spec.</li>
134 </ul>
135
136 <p>
137         Lastly, the gain correction is, by default, applied after all the processors
138         of the master bus. This can also be changed, either by checking the 
139         <kbd>Custom Amplifier Position</kbd> temporaty button in this window, or in the Master
140         strip, by <kbd class="mouse">Right</kbd>-clicking the gain slider and
141         checking <kbd class="option">Custom LAN Amp Position</kbd>. The gain
142         normalizer then becomes a processor in the processors box of the Master
143         strip, that can be moved as needed like any processor/effect.
144 </p>
145