Skip to main content

No-reference quality assessment for neurally synthesized scenes

Project description

NVS-SQA

Official implementation of "NVS-SQA: Exploring Self-Supervised Quality Representation Learning for Neurally Synthesized Scenes without References" arxiv).

Generating No-Reference Quality Representations with the Pretrained Model

Installation

You can install the package directly from PyPI:

pip install nvs-sqa

Usage

The package can be used programmatically. You can download the examples folder here. The quality scores are in format of JOD score, mostly negative values (offset by reference quality), with higher scores indicating better quality. Here's an example of how to generate quality features and scores:

import nvs_sqa

# Initialize the QualityAssessor
qa = nvs_sqa.QualityAssessor()

# Define the evaluation folder path containing NSS directories
eval_folder = "./examples"

# Generate quality features
all_feats, save_path = qa.generate_quality_features(eval_folder, verbose=True)

# Compute quality scores
quality_scores = qa.generate_quality_scores(all_feats, verbose=True)

print(f"Features saved to: {save_path}")

About the Output

  1. Feature Generation and Saving: The generate_quality_features method processes each NSS folder in the evaluation directory, generates quality features for each, and saves these features in a .npz file. The output is in the format of {<nss_name>: 384-dim rep., ...}. You can use np.load() to load it.

  2. Quality Scores: The generate_quality_scores method calculates quality scores based on the generated features by applying a ridge linear regression model trained on the Fieldwork, Lab, and LLFF datasets.

  3. Example NSS: You can find example NSS data in the repository's examples folder, which includes scenes generated by GNT-Cross-scene and Plenoxel.

Important Notes:

  • JOD Scoring Format: The JOD score, which is the adopted scoring format, features primarily negative values (offset by reference quality), with higher scores indicating better quality.
  • Relevance of JOD Scores: According to the dataset authors for Fieldwork and Lab, JOD scores are more meaningful within the same scene, suggesting that cross-scene comparisons of JOD scores may not provide meaningful insights.

To Cite

@article{qu2025nvs,
  title={NVS-SQA: Exploring Self-Supervised Quality Representation Learning for Neurally Synthesized Scenes without References},
  author={Qu, Qiang and Shen, Yiran and Chung, Yuk Ying and Cai, Weidong and Chen, Xiaoming and Liu, Tongliang},
  journal={arXiv preprint arXiv:2501.06488},
  year={2025}
}

@article{qu2024nerf,
  title={NeRF-NQA: No-Reference Quality Assessment for Scenes Generated by NeRF and Neural View Synthesis Methods},
  author={Qu, Qiang and Liang, Hanxue and Chen, Xiaoming and Chung, Yuk Ying and Shen, Yiran},
  journal={IEEE Transactions on Visualization and Computer Graphics},
  year={2024},
  publisher={IEEE}
}

@inproceedings{liang2024perceptual,
  title={Perceptual Quality Assessment of NeRF and Neural View Synthesis Methods for Front-Facing Views},
  author={Liang, Hanxue and Wu, Tianhao and Hanji, Param and Banterle, Francesco and Gao, Hongyun and Mantiuk, Rafal and {\"O}ztireli, Cengiz},
  booktitle={Computer Graphics Forum},
  volume={43},
  number={2},
  pages={e15036},
  year={2024},
  organization={Wiley Online Library}
}

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

nvs_sqa-0.1.1.tar.gz (17.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nvs_sqa-0.1.1-py3-none-any.whl (17.6 MB view details)

Uploaded Python 3

File details

Details for the file nvs_sqa-0.1.1.tar.gz.

File metadata

  • Download URL: nvs_sqa-0.1.1.tar.gz
  • Upload date:
  • Size: 17.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.8.3 requests/2.27.1 setuptools/41.2.0 requests-toolbelt/1.0.0 tqdm/4.64.1 CPython/2.7.18

File hashes

Hashes for nvs_sqa-0.1.1.tar.gz
Algorithm Hash digest
SHA256 15a529eeeb300e6e7ac20313bb6c9b456013dacba42ad4d054045fea9b2d318e
MD5 1d1cf17009ad68dfaf7652f7b3a886c2
BLAKE2b-256 1a5a530b59cc6a5e7d22ecbbfff9cc96ae3eb0d3e0e8ec614f5a3b9ab35905d2

See more details on using hashes here.

File details

Details for the file nvs_sqa-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: nvs_sqa-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 17.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.8.3 requests/2.27.1 setuptools/41.2.0 requests-toolbelt/1.0.0 tqdm/4.64.1 CPython/2.7.18

File hashes

Hashes for nvs_sqa-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 67a02dfb5111a8680ae10ad104679daaf3d3d2501a2763377408778c1052a336
MD5 0f6a7ac253001b525a2f890f2113b34a
BLAKE2b-256 25e47242cf4ac9789506858207e5d1e3670357c5bdcdff2246787cd8ae54af34

See more details on using hashes here.

Supported by

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