Calculate the Bjonteegard-Delta metric with different interpolation methods
Project description
Bjøntegaard-Delta Interpolation
Introduction
The Bjøntegaard-Delta (BD) metrics (delta bit rate and delta PSNR) described in [1] are well known metrics to measure the average differences between two rate-distortion (RD) curves. They are based on cubic-spline interpolation (CSI) of the RD curves and Matlab as well as Python implementations are available on the internet.
However, this way of interpolation using a third-order polynomial leads to problems for certain RD curve constellations and causes very misleading results. This has also been experienced during the standardization of HEVC. Consequently, the so-called piecewise cubic hermite interpolation (PCHIP) has been implemented in the JCT-VC Common Test Conditions (CTC) Excel sheet [2] for performance evaluation. Nevertheless, only this Excel sheet, but no Python implementation is available yet. Thus, a Python implementation is provided here. In [3], the Excel sheet for the state-of-the-art video codec VVC is given. In our tests, the implementation of PCHIP returns the same value as the Excel-Implementation with an accuracy of at least 10 decimal positions. The BD can also be calculated for more than four RD points (not yet cross-checked with respective Excel implementations).
In a further study [4], it was found that Akima interpolation returns even more accurate results. An example for corresponding interpolated curves is shown below.
Install
bjontegaard
is best installed via pip: pip install bjontegaard
.
Usage
Basic example with test data measured using ffmpeg (libx265 with different preset settings) and Akima interpolation:
# Import the package
import bjontegaard as bd
# Test data
rate_anchor = [9487.76, 4593.60, 2486.44, 1358.24]
psnr_anchor = [ 40.037, 38.615, 36.845, 34.851]
rate_test = [9787.80, 4469.00, 2451.52, 1356.24]
psnr_test = [ 40.121, 38.651, 36.970, 34.987]
# Use the package
bd_rate = bd.bd_rate(rate_anchor, psnr_anchor, rate_test, psnr_test, method='akima')
bd_psnr = bd.bd_psnr(rate_anchor, psnr_anchor, rate_test, psnr_test, method='akima')
print(f"BD-Rate: {bd_rate:.4f} %")
print(f"BD-PSNR: {bd_psnr:.4f} dB")
This package provides two main functions for BD metric calculation:
bd_rate(rate_anchor, dist_anchor, rate_test, dist_test, method='pchip', require_matching_points=True, interpolators=False)
bd_psnr(rate_anchor, dist_anchor, rate_test, dist_test, method='pchip', require_matching_points=True, interpolators=False)
The parameters rate_anchor
and dist_anchor
describe the rate-distortion points of the anchor, rate_test
and dist_test
describe the rate-distortion points of the test codec.
Available interpolation methods:
'cubic'
: Cubic spline interpolation'pchip'
: Piecewise cubic hermite interpolation (default, used in standardizations [2], [3])'akima'
: Akima interpolation [4]
If require_matching_points=True
(default), the number of rate-distortion points for anchor and test must match.
If interpolators=True
is given, the functions additionally return the internal interpolation objects that can be used to check the behaviour of the value interpolation.
Comparison behind the scenes
The function compare_methods
generates a plot that compares the internal interpolation behaviour of the three variants.
The parameters rate_label
, distortion_label
, and figure_label
control the figure and axis labels of the plot.
If filepath
is given, the final figure is saved to this file.
import bjontegaard as bd
# Test data
rate_anchor = [9487.76, 4593.60, 2486.44, 1358.24]
psnr_anchor = [ 40.037, 38.615, 36.845, 34.851]
rate_test = [9787.80, 4469.00, 2451.52, 1356.24]
psnr_test = [ 40.121, 38.651, 36.970, 34.987]
# Compare the internal behaviour of the three variants
bd.compare_methods(rate_anchor, psnr_anchor, rate_test, psnr_test, rate_label="Rate", distortion_label="PSNR", figure_label="Test 1", filepath=None)
Furthermore, a comparison between the interpolated curves and intermediate, true rate-distortion points between the supporting points is shown in the plot below. For this example, the quality is represented by the SSIM value. Note that the example was chosen because cubic interpolation fails. Apparently, the curve interpolated by the Akima interpolator is closest to the intermediate points.
References
[1] G. Bjontegaard, "Calculation of average PSNR differences between RD-curves", VCEG-M33, Austin, TX, USA, April 2001.
[2] F. Bossen, "Common HM test conditions and software reference configurations", JCTVC-L1100, Geneva, Switzerland, April 2013.
[3] F. Bossen, "VTM common test conditions and software reference configurations for SDR video", JVET-T2020, Teleconference, October 2020.
[4] C. Herglotz, M. Kränzler, R. Mons, A. Kaup, "Beyond Bjontegaard: Limits of Video Compression Performance Comparisons", submitted to ICIP 2022, preprint available.
License
BSD 3-Clause. For details, see LICENSE.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file bjontegaard-1.0.1.tar.gz
.
File metadata
- Download URL: bjontegaard-1.0.1.tar.gz
- Upload date:
- Size: 11.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 48b997c3b25231b79927d369f1b5fc28a680276e7180654cfcbaf2d1ff1ebe1b |
|
MD5 | e83680687b7f0241f90101ecddff4e02 |
|
BLAKE2b-256 | 99fd97ad489c8ba010afa274709e78f80243eebd4869e6b5480f375a1bc10276 |
File details
Details for the file bjontegaard-1.0.1-py3-none-any.whl
.
File metadata
- Download URL: bjontegaard-1.0.1-py3-none-any.whl
- Upload date:
- Size: 15.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b50f8be8f7b0b3953cdaf2d3c783abbdd5a453d881caeda29afa1597e07fddfb |
|
MD5 | 52925d7d9073ecfde5cf76da195f4492 |
|
BLAKE2b-256 | d0f8b555145c50d62dd554f5aa346f19882114182075d106a6288322e277d029 |