Skip to content

Add PSNR (Y/U/V) for outbound-rtp #794

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
guidou merged 9 commits into from
Jul 10, 2025
Merged

Add PSNR (Y/U/V) for outbound-rtp #794

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
a3f7c6a
Add PSNR (Y/U/V) for outbound-rtp
fippo Jan 23, 2025
cece6f4
record of doubles
fippo Jan 27, 2025
33b4159
make reference informative
fippo Jan 29, 2025
85afc36
statistical analysis, implementation-defined
fippo Mar 3, 2025
7140c3f
move frequency out of the note
fippo Apr 8, 2025
42d593a
move note to metrics from number of measurements
fippo Apr 8, 2025
810d67d
neutral
fippo Apr 10, 2025
2e31240
gate on hw
fippo Apr 21, 2025
18f34e5
Add guidance note
jan-ivar Jul 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 47 additions & 0 deletions webrtc-stats.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1966,6 +1966,8 @@ <h3>
unsigned long framesEncoded;
unsigned long keyFramesEncoded;
unsigned long long qpSum;
record&lt;DOMString, double&gt; psnrSum;
unsigned long long psnrMeasurements;
double totalEncodeTime;
double totalPacketSendDelay;
RTCQualityLimitationReason qualityLimitationReason;
Expand Down Expand Up @@ -2218,6 +2220,51 @@ <h2>
formats have ways to vary the quantizer value within the frame.
</p>
</dd>
<dt>
<dfn>psnrSum</dfn> of type <span class="idlMemberType">
record&lt;DOMString, double&gt;</span>
</dt>
<dd>
<p class="fingerprint">
MUST NOT [= map/exist =] unless [= exposing hardware is allowed =].
</p>
<p>
MUST NOT [= map/exist =] for audio.
The cumulative sum of the PSNR values of frames encoded by this sender.
The record includes values for the "y", "u" and "v" components.
The count of measurements is in {{psnrMeasurements}}.
</p>
<p>
PSNR is defined in [[ISO-29170-1:2017]].
</p>
<p class="note">
PSNR metrics are intended for statistical analysis rather
than representing absolute truth on a per-frame basis.
</p>
</dd>
<dt>
<dfn>psnrMeasurements</dfn> of type <span class="idlMemberType">unsigned long long
</span>
</dt>
<dd>
<p class="fingerprint">
MUST NOT [= map/exist =] unless [= exposing hardware is allowed =].
</p>
<p>
MUST NOT [= map/exist =] for audio.
The number of times PSNR was measured. The components of {{psnrSum}} are
aggregated with this measurement.
</p>
<p>
The PSNR is defined in [[ISO-29170-1:2017]].
The frequency of PSNR measurements is [=implementation-defined=].
Comment thread
jan-ivar marked this conversation as resolved.
</p>
<p class="note">
User agents are encouraged to measure PSNR at a fixed frequency
for each encoder implementation, and as frequently as possible as
long as it does not introduce a noticeable performance penalty.
</p>
</dd>
<dt>
<dfn>totalEncodeTime</dfn> of type <span class=
"idlMemberType">double</span>
Expand Down
5 changes: 5 additions & 0 deletions webrtc-stats.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,11 @@ var respecConfig = {
status: "Internet Draft",
publisher: "IETF"
},
"ISO-29170-1:2017": {
title: "Information technology — Advanced image coding and evaluation",
href: "https://www.iso.org/standard/63637.html",
publisher: "ISO",
},
},
postProcess: [
function generateStatsHierarchy(config, doc) {
Expand Down