quickrank::metric::ir::Map Class Reference

This class implements the average precision AP@k measure. More...

#include <map.h>

Inheritance diagram for quickrank::metric::ir::Map:

Public Member Functions
	Map (size_t k=NO_CUTOFF)
virtual	~Map ()
virtual std::string	name () const
	Returns the name of the metric. More...
virtual MetricScore	evaluate_result_list (const quickrank::data::QueryResults *rl, const Score *scores) const
	Measures the quality of the given results list according to the Metric. More...
virtual std::unique_ptr< Jacobian >	jacobian (std::shared_ptr< data::RankedResults > ranked) const
	Computes the Jacobian matrix. More...
Public Member Functions inherited from quickrank::metric::ir::Metric
	Metric (size_t k=NO_CUTOFF)
	Creates a new metric with the specified cut-off threshold. More...
virtual	~Metric ()
size_t	cutoff () const
	Returns the current cut-off of the Metric. More...
void	set_cutoff (size_t k)
	Updates the cut-off of the Metric. More...
virtual MetricScore	evaluate_dataset (const std::shared_ptr< data::Dataset > dataset, const Score *scores) const
virtual MetricScore	evaluate_dataset (const std::shared_ptr< data::VerticalDataset > dataset, const Score *scores) const

Static Public Attributes
static const std::string	NAME_ = "MAP"
Static Public Attributes inherited from quickrank::metric::ir::Metric
static const size_t	NO_CUTOFF = SIZE_MAX
	This should be used when no cut-off on the results list is required. More...

Private Member Functions
virtual std::ostream &	put (std::ostream &os) const
	Prints the short name of the Metric, e.g., "NDCG@K". More...

Friends
std::ostream &	operator<< (std::ostream &os, const Map &map)

Detailed Description

This class implements the average precision AP@k measure.

Todo:

TODO: test correctness

Constructor & Destructor Documentation

quickrank::metric::ir::Map::Map ( size_t  k = NO_CUTOFF )

inlineexplicit

virtual quickrank::metric::ir::Map::~Map ( )

inlinevirtual

Member Function Documentation

MetricScore quickrank::metric::ir::Map::evaluate_result_list ( const quickrank::data::QueryResults *  rl, const Score *  scores  ) const

virtual

Measures the quality of the given results list according to the Metric.

Parameters

rl	A results list.
scores	a list of scores

Returns

The quality score of the result list.

Implements quickrank::metric::ir::Metric.

std::unique_ptr< Jacobian > quickrank::metric::ir::Map::jacobian ( std::shared_ptr< data::RankedResults >  ranked ) const

virtual

Computes the Jacobian matrix.

This is a symmetric matrix storing the metric "decrease" when two documents scores are swapped.

Parameters

rl	A results list.

Returns

A smart-pointer to the Jacobian Matrix.

Todo:

TODO: provide def implementation

Reimplemented from quickrank::metric::ir::Metric.

virtual std::string quickrank::metric::ir::Map::name ( ) const

inlinevirtual

Returns the name of the metric.

Implements quickrank::metric::ir::Metric.

std::ostream & quickrank::metric::ir::Map::put ( std::ostream &  os ) const

privatevirtual

Prints the short name of the Metric, e.g., "NDCG@K".

Implements quickrank::metric::ir::Metric.

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  os, const Map &  map  )

friend

Member Data Documentation

const std::string quickrank::metric::ir::Map::NAME_ = "MAP"

static

---

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

• include/metric/ir/map.h
• src/metric/ir/map.cc