Struct opencv::quality::QualityBRISQUE

pub struct QualityBRISQUE { /* private fields */ }

BRISQUE (Blind/Referenceless Image Spatial Quality Evaluator) is a No Reference Image Quality Assessment (NR-IQA) algorithm.

BRISQUE computes a score based on extracting Natural Scene Statistics (https://en.wikipedia.org/wiki/Scene_statistics) and calculating feature vectors. See Mittal et al. Mittal2 for original paper and original implementation Mittal2_software .

A trained model is provided in the /samples/ directory and is trained on the LIVE-R2 database Sheikh as in the original implementation. When evaluated against the TID2008 database Ponomarenko , the SROCC is -0.8424 versus the SROCC of -0.8354 in the original implementation. C++ code for the BRISQUE LIVE-R2 trainer and TID2008 evaluator are also provided in the /samples/ directory.

Implementations

impl QualityBRISQUE

pub fn create(
    model_file_path: &str,
    range_file_path: &str
) -> Result<Ptr<QualityBRISQUE>>

Create an object which calculates quality

Parameters

• model_file_path: cv::String which contains a path to the BRISQUE model data, eg. /path/to/brisque_model_live.yml
• range_file_path: cv::String which contains a path to the BRISQUE range data, eg. /path/to/brisque_range_live.yml

pub fn create_1(model: &Ptr<dyn SVM>, range: &Mat) -> Result<Ptr<QualityBRISQUE>>

Create an object which calculates quality

Parameters

• model: cv::Ptrcv::ml::SVM which contains a loaded BRISQUE model
• range: cv::Mat which contains BRISQUE range data

pub fn compute(
    img: &dyn ToInputArray,
    model_file_path: &str,
    range_file_path: &str
) -> Result<Scalar>

static method for computing quality

Parameters

• img: image for which to compute quality
• model_file_path: cv::String which contains a path to the BRISQUE model data, eg. /path/to/brisque_model_live.yml
• range_file_path: cv::String which contains a path to the BRISQUE range data, eg. /path/to/brisque_range_live.yml

Returns

cv::Scalar with the score in the first element. The score ranges from 0 (best quality) to 100 (worst quality)

pub fn compute_features(
    img: &dyn ToInputArray,
    features: &mut dyn ToOutputArray
) -> Result<()>

static method for computing image features used by the BRISQUE algorithm

Parameters

• img: image (BGR(A) or grayscale) for which to compute features
• features: output row vector of features to cv::Mat or cv::UMat

Trait Implementations

impl AlgorithmTrait for QualityBRISQUE

fn as_raw_mut_Algorithm(&mut self) -> *mut c_void

fn clear(&mut self) -> Result<()>

Clears the algorithm state

fn read(&mut self, fn_: &FileNode) -> Result<()>

Reads algorithm parameters from a file storage

impl AlgorithmTraitConst for QualityBRISQUE

fn as_raw_Algorithm(&self) -> *const c_void

fn write(&self, fs: &mut FileStorage) -> Result<()>

Stores algorithm parameters in a file storage

fn write_1(&self, fs: &mut FileStorage, name: &str) -> Result<()>

Stores algorithm parameters in a file storage

fn write_with_name(&self, fs: &Ptr<FileStorage>, name: &str) -> Result<()>

@deprecated

fn empty(&self) -> Result<bool>

Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read

fn save(&self, filename: &str) -> Result<()>

Saves the algorithm to a file. In order to make this method work, the derived class must implement Algorithm::write(FileStorage& fs).

fn get_default_name(&self) -> Result<String>

Returns the algorithm string identifier. This string is used as top level xml/yml node tag when the object is saved to a file or string.

impl Boxed for QualityBRISQUE

unsafe fn from_raw(ptr: *mut c_void) -> Self

Wrap the specified raw pointer

fn into_raw(self) -> *mut c_void

Return an the underlying raw pointer while consuming this wrapper.

fn as_raw(&self) -> *const c_void

Return the underlying raw pointer.

fn as_raw_mut(&mut self) -> *mut c_void

Return the underlying mutable raw pointer

impl Drop for QualityBRISQUE

fn drop(&mut self)

Executes the destructor for this type.

impl From<QualityBRISQUE> for Algorithm

fn from(s: QualityBRISQUE) -> Self

Converts to this type from the input type.

impl QualityBRISQUETrait for QualityBRISQUE

fn as_raw_mut_QualityBRISQUE(&mut self) -> *mut c_void

fn compute(&mut self, img: &dyn ToInputArray) -> Result<Scalar>

Computes BRISQUE quality score for input image

impl QualityBRISQUETraitConst for QualityBRISQUE

fn as_raw_QualityBRISQUE(&self) -> *const c_void

impl QualityBase for QualityBRISQUE

fn as_raw_mut_QualityBase(&mut self) -> *mut c_void

fn compute(&mut self, img: &dyn ToInputArray) -> Result<Scalar>

Compute quality score per channel with the per-channel score in each element of the resulting cv::Scalar. See specific algorithm for interpreting result scores

fn clear(&mut self) -> Result<()>

Implements Algorithm::clear()

impl QualityBaseConst for QualityBRISQUE

fn as_raw_QualityBase(&self) -> *const c_void

fn get_quality_map(&self, dst: &mut dyn ToOutputArray) -> Result<()>

Returns output quality map that was generated during computation, if supported by the algorithm

fn empty(&self) -> Result<bool>

Implements Algorithm::empty()

impl Send for QualityBRISQUE