Struct 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<SVM>, range: &impl MatTraitConst, ) -> 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: &impl 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: &impl ToInputArray, features: &mut impl 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_: &impl FileNodeTraitConst) -> 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 impl FileStorageTrait) -> Result<()>

Stores algorithm parameters in a file storage

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

Stores algorithm parameters in a file storage

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

@deprecated

fn write_with_name_def(&self, fs: &Ptr<FileStorage>) -> Result<()>

👎Deprecated:

Note

Deprecated: ## Note This alternative version of AlgorithmTraitConst::write_with_name function uses the following default values for its arguments:

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: <QualityBRISQUE as OpenCVFromExtern>::ExternReceive, ) -> Self

Wrap the specified raw pointer

fn into_raw( self, ) -> <QualityBRISQUE as OpenCVTypeExternContainer>::ExternSendMut

Return the underlying raw pointer while consuming this wrapper.

fn as_raw(&self) -> <QualityBRISQUE as OpenCVTypeExternContainer>::ExternSend

Return the underlying raw pointer.

fn as_raw_mut( &mut self, ) -> <QualityBRISQUE as OpenCVTypeExternContainer>::ExternSendMut

Return the underlying mutable raw pointer

impl Debug for QualityBRISQUE

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

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 From<QualityBRISQUE> for QualityBase

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: &impl ToInputArray) -> Result<Scalar>

Computes BRISQUE quality score for input image

impl QualityBRISQUETraitConst for QualityBRISQUE

fn as_raw_QualityBRISQUE(&self) -> *const c_void

impl QualityBaseTrait for QualityBRISQUE

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

fn compute(&mut self, img: &impl 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 QualityBaseTraitConst for QualityBRISQUE

fn as_raw_QualityBase(&self) -> *const c_void

fn get_quality_map(&self, dst: &mut impl 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 TryFrom<QualityBase> for QualityBRISQUE

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: QualityBase) -> Result<Self>

Performs the conversion.

impl Send for QualityBRISQUE