Skip to main content

Calculate the Bjonteegard-Delta metric with different interpolation methods

Project description

License GitHub top language GitHub stars PyPI - Python Version PyPI

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, require_matching_points=True, interpolators=False)
  • bd_psnr(rate_anchor, dist_anchor, rate_test, dist_test, method, 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 (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.

Measured data

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

bjontegaard-1.1.0.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

bjontegaard-1.1.0-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

Details for the file bjontegaard-1.1.0.tar.gz.

File metadata

  • Download URL: bjontegaard-1.1.0.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

Hashes for bjontegaard-1.1.0.tar.gz
Algorithm Hash digest
SHA256 e98944e6bc233c39d8d885346ebe2f3dd0f3ad984ddb6a3f760c0ba464615075
MD5 81e7f7239d9df46a3cbdfde9d177b037
BLAKE2b-256 0e028e304e09ef52763c014694f98e9a76f991b92abb12f7961ed97426535529

See more details on using hashes here.

File details

Details for the file bjontegaard-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: bjontegaard-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for bjontegaard-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 13ebdfae12abe5ab56509fef6fb634398783ba35859e2b0ffc6f13fc708081cb
MD5 9d639698bd97a782d005b82df10e019c
BLAKE2b-256 fa7651a3988ce141e4c96c0b18a394ea3a89ff8dd17b58dfe602ed6858b50c9b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page