Skip to main content

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}
}

Metadata

Release files for nvs-sqa 0.1.1

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

Source distribution (sdist)

Source distribution for nvs-sqa 0.1.1
File Size Uploaded Provenance Actions
nvs_sqa-0.1.1.tar.gz 17.6 MB Without provenance Details for nvs_sqa-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nvs-sqa 0.1.1
File Interpreter ABI Platform Actions
nvs_sqa-0.1.1-py3-none-any.whl Python 3 none any Details for nvs_sqa-0.1.1-py3-none-any.whl

Total release size: 35.2 MB

Release files / nvs_sqa-0.1.1.tar.gz

Download URL nvs_sqa-0.1.1.tar.gz
Size 17.6 MB
Tags Source
SHA-256 checksum
How to use checksums
15a529eeeb300e6e7ac20313bb6c9b456013dacba42ad4d054045fea9b2d318e
BLAKE2b-256 checksum
How to use checksums
1a5a530b59cc6a5e7d22ecbbfff9cc96ae3eb0d3e0e8ec614f5a3b9ab35905d2
Upload date
Uploaded using Trusted Publishing?
What is 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

Release files / nvs_sqa-0.1.1-py3-none-any.whl

Download URL nvs_sqa-0.1.1-py3-none-any.whl
Size 17.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
67a02dfb5111a8680ae10ad104679daaf3d3d2501a2763377408778c1052a336
BLAKE2b-256 checksum
How to use checksums
25e47242cf4ac9789506858207e5d1e3670357c5bdcdff2246787cd8ae54af34
Upload date
Uploaded using Trusted Publishing?
What is 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

Security for nvs-sqa 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

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