Skip to main content

Harmonics Radius Index

Harmonics Radius Index is a performance index for evaluating the quality of super-resolution images. It is based on the harmonic mean of the radii of the circles that contain the same amount of energy in the Fourier domain of the true and predicted images.

Please refer to the following paper for more details:

The paper is under review. Please check back later.

Installation & Usage

First run for hr95 program may take a while, however, it will be faster in the following runs.

pip install harmonicsradius
hri95 -t <true_image_path> -p <predicted_image_path>

API

The harmonicsradius package provides an API for calculating the Harmonics Radius Index and other image quality metrics. The API is designed to be simple and easy to use. The following metrics are available:

  • Harmonics Radius Index
  • Mean Squared Error
  • Structural Similarity Index
  • Peak Signal to Noise Ratio

The API is designed to be simple and easy to use. The following example demonstrates how to use the API to calculate the Harmonics Radius Index and other image quality metrics.

from harmonicsradius.metrics import (
    MeanSquaredError,
    HarmonicsRadius,
    StructuralSimilarityIndex,
    PeakSignalToNoiseRatio
)

from harmonicsradius.image import Image
from harmonicsradius.sr_analyzer import SRAnalyzer

# Read the images.
true_image = Image(TRUE_IMAGE_PATH, name="true_image")
predicted_image = Image(PRED_IMAGE_PATH, name="predicted_image")

# Create the analyzer.
analyzer = SRAnalyzer()

# Add metrics.
analyzer.add_metric(HarmonicsRadius())
analyzer.add_metric(MeanSquaredError())
analyzer.add_metric(StructuralSimilarityIndex())
analyzer.add_metric(PeakSignalToNoiseRatio())

# Add images.
analyzer.add_reference_image(true_image)
analyzer.add_image(predicted_image)

# Calculate the metrics.
results = analyzer.calculate()
print("\nImage Quality Metrics\n")
print("True Image: ", images['true'])
print("Predicted Image: ", images['predicted'])
for result in results:
    print(result)

Metadata

Release files for harmonicsradius 2024.5.22

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for harmonicsradius 2024.5.22
File Size Uploaded
harmonicsradius-2024.5.22.tar.gz 49.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for harmonicsradius 2024.5.22
File Interpreter ABI Platform
harmonicsradius-2024.5.22-py3-none-any.whl Python 3 none any Details

Total release size: 87.3 kB

Release files / harmonicsradius-2024.5.22.tar.gz

Download URL harmonicsradius-2024.5.22.tar.gz
Size 49.6 kB
Tags Source
SHA-256 checksum
How to use checksums
9c8ba20c3eed086d85bd3b4cb7c3436e8f984741a438560044b0ae86d7a3a399
BLAKE2b-256 checksum
How to use checksums
86a853256f26f0a05d64e2a025dd479b04ab253fa2fc19bf199742d4e0d1f154
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / harmonicsradius-2024.5.22-py3-none-any.whl

Download URL harmonicsradius-2024.5.22-py3-none-any.whl
Size 37.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3554ddd822742806fba98a30a24f1ad1411e019a23ddefbd608eb5aa1a35c7cd
BLAKE2b-256 checksum
How to use checksums
bee8dbaebac4b2548694e76cf4d257d307ea9d9f6ebd4a8f13604c2b5649b161
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

2024.5.22 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page