xapian-core  1.4.25
Public Member Functions | Public Attributes | List of all members
CheckStatsWeight Class Reference
+ Inheritance diagram for CheckStatsWeight:
+ Collaboration diagram for CheckStatsWeight:

Public Member Functions

 CheckStatsWeight (const Xapian::Database &db_, const string &term1_, const string &term2_, Xapian::termcount &sum_, Xapian::termcount &sum_squares_)
 
 CheckStatsWeight (const Xapian::Database &db_, const string &term_, Xapian::termcount &sum_, Xapian::termcount &sum_squares_)
 
void init (double factor_)
 Allow the subclass to perform any initialisation it needs to. More...
 
Weightclone () const
 Clone this object. More...
 
double get_sumpart (Xapian::termcount wdf, Xapian::termcount doclen, Xapian::termcount uniqueterms) const
 Calculate the weight contribution for this object's term to a document. More...
 
double get_maxpart () const
 Return an upper bound on what get_sumpart() can return for any document. More...
 
double get_sumextra (Xapian::termcount doclen, Xapian::termcount) const
 Calculate the term-independent weight component for a document. More...
 
double get_maxextra () const
 Return an upper bound on what get_sumextra() can return for any document. More...
 
- Public Member Functions inherited from Xapian::Weight
 Weight ()
 Default constructor, needed by subclass constructors. More...
 
virtual ~Weight ()
 Virtual destructor, because we have virtual methods. More...
 
virtual std::string name () const
 Return the name of this weighting scheme. More...
 
virtual std::string serialise () const
 Return this object's parameters serialised as a single string. More...
 
virtual Weightunserialise (const std::string &serialised) const
 Unserialise parameters. More...
 

Public Attributes

double factor
 
Xapian::Database db
 
string term1
 
string term2
 
Xapian::termcountsum
 
Xapian::termcountsum_squares
 
Xapian::termcount len_upper
 
Xapian::termcount len_lower
 
Xapian::termcount wdf_upper
 

Additional Inherited Members

- Public Types inherited from Xapian::Weight
enum  type_smoothing {
  TWO_STAGE_SMOOTHING = 1, DIRICHLET_SMOOTHING = 2, ABSOLUTE_DISCOUNT_SMOOTHING = 3, JELINEK_MERCER_SMOOTHING = 4,
  DIRICHLET_PLUS_SMOOTHING = 5
}
 Type of smoothing to use with the Language Model Weighting scheme. More...
 
- Protected Types inherited from Xapian::Weight
enum  stat_flags {
  COLLECTION_SIZE = 1, RSET_SIZE = 2, AVERAGE_LENGTH = 4, TERMFREQ = 8,
  RELTERMFREQ = 16, QUERY_LENGTH = 32, WQF = 64, WDF = 128,
  DOC_LENGTH = 256, DOC_LENGTH_MIN = 512, DOC_LENGTH_MAX = 1024, WDF_MAX = 2048,
  COLLECTION_FREQ = 4096, UNIQUE_TERMS = 8192, TOTAL_LENGTH = COLLECTION_SIZE | AVERAGE_LENGTH
}
 Stats which the weighting scheme can use (see need_stat()). More...
 
- Protected Member Functions inherited from Xapian::Weight
void need_stat (stat_flags flag)
 Tell Xapian that your subclass will want a particular statistic. More...
 
 Weight (const Weight &)
 Don't allow copying. More...
 
Xapian::doccount get_collection_size () const
 The number of documents in the collection. More...
 
Xapian::doccount get_rset_size () const
 The number of documents marked as relevant. More...
 
Xapian::doclength get_average_length () const
 The average length of a document in the collection. More...
 
Xapian::doccount get_termfreq () const
 The number of documents which this term indexes. More...
 
Xapian::doccount get_reltermfreq () const
 The number of relevant documents which this term indexes. More...
 
Xapian::termcount get_collection_freq () const
 The collection frequency of the term. More...
 
Xapian::termcount get_query_length () const
 The length of the query. More...
 
Xapian::termcount get_wqf () const
 The within-query-frequency of this term. More...
 
Xapian::termcount get_doclength_upper_bound () const
 An upper bound on the maximum length of any document in the database. More...
 
Xapian::termcount get_doclength_lower_bound () const
 A lower bound on the minimum length of any document in the database. More...
 
Xapian::termcount get_wdf_upper_bound () const
 An upper bound on the wdf of this term. More...
 
Xapian::totallength get_total_length () const
 Total length of all documents in the collection. More...
 

Detailed Description

Definition at line 936 of file api_weight.cc.

Constructor & Destructor Documentation

◆ CheckStatsWeight() [1/2]

CheckStatsWeight::CheckStatsWeight ( const Xapian::Database db_,
const string &  term1_,
const string &  term2_,
Xapian::termcount sum_,
Xapian::termcount sum_squares_ 
)
inline

Definition at line 957 of file api_weight.cc.

◆ CheckStatsWeight() [2/2]

CheckStatsWeight::CheckStatsWeight ( const Xapian::Database db_,
const string &  term_,
Xapian::termcount sum_,
Xapian::termcount sum_squares_ 
)
inline

Definition at line 983 of file api_weight.cc.

Member Function Documentation

◆ clone()

Weight* CheckStatsWeight::clone ( ) const
inlinevirtual

Clone this object.

This method allocates and returns a copy of the object it is called on.

If your subclass is called FooWeight and has parameters a and b, then you would implement FooWeight::clone() like so:

FooWeight * FooWeight::clone() const { return new FooWeight(a, b); }

Note that the returned object will be deallocated by Xapian after use with "delete". If you want to handle the deletion in a special way (for example when wrapping the Xapian API for use from another language) then you can define a static operator delete method in your subclass as shown here: https://trac.xapian.org/ticket/554#comment:1

Implements Xapian::Weight.

Definition at line 993 of file api_weight.cc.

◆ get_maxextra()

double CheckStatsWeight::get_maxextra ( ) const
inlinevirtual

Return an upper bound on what get_sumextra() can return for any document.

This information is used by the matcher to perform various optimisations, so strive to make the bound as tight as possible.

Implements Xapian::Weight.

Definition at line 1091 of file api_weight.cc.

◆ get_maxpart()

double CheckStatsWeight::get_maxpart ( ) const
inlinevirtual

Return an upper bound on what get_sumpart() can return for any document.

This information is used by the matcher to perform various optimisations, so strive to make the bound as tight as possible.

Implements Xapian::Weight.

Definition at line 1078 of file api_weight.cc.

◆ get_sumextra()

double CheckStatsWeight::get_sumextra ( Xapian::termcount  doclen,
Xapian::termcount  uniqterms 
) const
inlinevirtual

Calculate the term-independent weight component for a document.

The parameter gives information about the document which may be used in the calculations:

Parameters
doclenThe document's length (unnormalised).
uniqtermsThe number of unique terms in the document.

Implements Xapian::Weight.

Definition at line 1087 of file api_weight.cc.

◆ get_sumpart()

double CheckStatsWeight::get_sumpart ( Xapian::termcount  wdf,
Xapian::termcount  doclen,
Xapian::termcount  uniqterms 
) const
inlinevirtual

Calculate the weight contribution for this object's term to a document.

The parameters give information about the document which may be used in the calculations:

Parameters
wdfThe within document frequency of the term in the document.
doclenThe document's length (unnormalised).
uniqtermsNumber of unique terms in the document (used for absolute smoothing).

Implements Xapian::Weight.

Definition at line 1008 of file api_weight.cc.

References Xapian::Database::allterms_begin(), Xapian::Database::allterms_end(), Xapian::Database::get_avlength(), Xapian::Database::get_collection_freq(), Xapian::Database::get_doccount(), Xapian::Database::get_termfreq(), Xapian::Database::get_total_length(), TEST_EQUAL, TEST_REL, and tout.

◆ init()

void CheckStatsWeight::init ( double  factor)
inlinevirtual

Allow the subclass to perform any initialisation it needs to.

Parameters
factorAny scaling factor (e.g. from OP_SCALE_WEIGHT). If the Weight object is for the term-independent weight supplied by get_sumextra()/get_maxextra(), then init(0.0) is called (starting from Xapian 1.2.11 and 1.3.1 - earlier versions failed to call init() for such Weight objects).

Implements Xapian::Weight.

Definition at line 989 of file api_weight.cc.

Member Data Documentation

◆ db

Xapian::Database CheckStatsWeight::db

Definition at line 940 of file api_weight.cc.

◆ factor

double CheckStatsWeight::factor

Definition at line 938 of file api_weight.cc.

◆ len_lower

Xapian::termcount CheckStatsWeight::len_lower
mutable

Definition at line 954 of file api_weight.cc.

◆ len_upper

Xapian::termcount CheckStatsWeight::len_upper
mutable

Definition at line 953 of file api_weight.cc.

◆ sum

Xapian::termcount& CheckStatsWeight::sum

Definition at line 950 of file api_weight.cc.

◆ sum_squares

Xapian::termcount& CheckStatsWeight::sum_squares

Definition at line 951 of file api_weight.cc.

◆ term1

string CheckStatsWeight::term1

Definition at line 942 of file api_weight.cc.

◆ term2

string CheckStatsWeight::term2
mutable

Definition at line 948 of file api_weight.cc.

◆ wdf_upper

Xapian::termcount CheckStatsWeight::wdf_upper
mutable

Definition at line 955 of file api_weight.cc.


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