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

#include <opencv2/quality/qualitybrisque.hpp>

Inheritance diagram for cv::quality::QualityBRISQUE:

Public Member Functions
cv::Scalar	compute (InputArray img) CV_OVERRIDE
	Computes BRISQUE quality score for input image.

Public Member Functions inherited from cv::quality::QualityBase
virtual	~QualityBase ()=default
	Destructor.

void	clear () CV_OVERRIDE
	Implements Algorithm::clear()

virtual cv::Scalar	compute (InputArray img)=0
	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.

bool	empty () const CV_OVERRIDE
	Implements Algorithm::empty()

virtual void	getQualityMap (OutputArray dst) const
	Returns output quality map that was generated during computation, if supported by the algorithm

Public Member Functions inherited from cv::Algorithm
	Algorithm ()

virtual	~Algorithm ()

virtual void	clear ()
	Clears the algorithm state.

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

virtual String	getDefaultName () const

virtual void	read (const FileNode &fn)
	Reads algorithm parameters from a file storage.

virtual void	save (const String &filename) const

void	write (const Ptr< FileStorage > &fs, const String &name=String()) const

virtual void	write (FileStorage &fs) const
	Stores algorithm parameters in a file storage.

void	write (FileStorage &fs, const String &name) const

Static Public Member Functions
static cv::Scalar	compute (InputArray img, const cv::String &model_file_path, const cv::String &range_file_path)
	static method for computing quality

static void	computeFeatures (InputArray img, OutputArray features)
	static method for computing image features used by the BRISQUE algorithm

static Ptr< QualityBRISQUE >	create (const cv::Ptr< cv::ml::SVM > &model, const cv::Mat &range)
	Create an object which calculates quality.

static Ptr< QualityBRISQUE >	create (const cv::String &model_file_path, const cv::String &range_file_path)
	Create an object which calculates quality.

Static Public Member Functions inherited from cv::Algorithm
template<typename _Tp >
static Ptr< _Tp >	load (const String &filename, const String &objname=String())
	Loads algorithm from the file.

template<typename _Tp >
static Ptr< _Tp >	loadFromString (const String &strModel, const String &objname=String())
	Loads algorithm from a String.

template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	Reads algorithm from the file node.

Protected Member Functions
	QualityBRISQUE (const cv::Ptr< cv::ml::SVM > &model, const cv::Mat &range)
	Internal constructor.

	QualityBRISQUE (const cv::String &model_file_path, const cv::String &range_file_path)
	Internal constructor.

Protected Member Functions inherited from cv::Algorithm
void	writeFormat (FileStorage &fs) const

Protected Attributes
cv::Ptr< cv::ml::SVM >	_model = nullptr

cv::Mat	_range

Protected Attributes inherited from cv::quality::QualityBase
_mat_type	_qualityMap
	Output quality maps if generated by algorithm.

Additional Inherited Members
Protected Types inherited from cv::quality::QualityBase
using	_mat_type = cv::UMat
	internal mat type default

Detailed Description

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.

Constructor & Destructor Documentation

◆ QualityBRISQUE() [1/2]

cv::quality::QualityBRISQUE::QualityBRISQUE	(	const cv::String &	model_file_path,
		const cv::String &	range_file_path
	)

protected

Internal constructor.

◆ QualityBRISQUE() [2/2]

cv::quality::QualityBRISQUE::QualityBRISQUE	(	const cv::Ptr< cv::ml::SVM > &	model,
		const cv::Mat &	range
	)

inlineprotected

Internal constructor.

Member Function Documentation

◆ compute() [1/2]

cv::Scalar cv::quality::QualityBRISQUE::compute ( InputArray img )

virtual

Computes BRISQUE quality score for input image.

Parameters

img	Image for which to compute quality

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

Implements cv::quality::QualityBase.

◆ compute() [2/2]

static cv::Scalar cv::quality::QualityBRISQUE::compute	(	InputArray	img,
		const cv::String &	model_file_path,
		const cv::String &	range_file_path
	)

static

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)

◆ computeFeatures()

static void cv::quality::QualityBRISQUE::computeFeatures	(	InputArray	img,
		OutputArray	features
	)

static

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

◆ create() [1/2]

static Ptr< QualityBRISQUE > cv::quality::QualityBRISQUE::create	(	const cv::Ptr< cv::ml::SVM > &	model,
		const cv::Mat &	range
	)

static

Create an object which calculates quality.

Parameters

model	cv::Ptr<cv::ml::SVM> which contains a loaded BRISQUE model
range	cv::Mat which contains BRISQUE range data

◆ create() [2/2]

static Ptr< QualityBRISQUE > cv::quality::QualityBRISQUE::create	(	const cv::String &	model_file_path,
		const cv::String &	range_file_path
	)

static

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

Member Data Documentation

◆ _model

cv::Ptr<cv::ml::SVM> cv::quality::QualityBRISQUE::_model = nullptr

protected

◆ _range

cv::Mat cv::quality::QualityBRISQUE::_range

protected

The documentation for this class was generated from the following file:

opencv2/quality/qualitybrisque.hpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QualityBRISQUE() [1/2]

◆ QualityBRISQUE() [2/2]

Member Function Documentation

◆ compute() [1/2]

◆ compute() [2/2]

◆ computeFeatures()

◆ create() [1/2]

◆ create() [2/2]

Member Data Documentation

◆ _model

◆ _range