Lire::Average(3pm)

Lire::Average3pm

Lire class that implements the avg operator

Usage

 use Lire::Average

Overview

Class that implements the avg operator. This operator will compute the average value of a DLF field in a group of DLF records.

If the field used by average isn't a numeric fields, the number of different values in that field will be used as the numerator.

It's possible to compute a weighted average by specifying a weighting field.

By default, the average is a by record average. It's possible to compute a by different values average. The list of fields that's used to determine the different values if speficied in the by-fields attribute.

Methods

new( %params )

Creates a new Lire::Average object. In addition to the values supported by its parents, the by-fields and weight attributes will be initialized to the values specified in the %params argument.

by_fields( [$new_by_fields] )

Returns the fields that are going to be used to count the different values which will made up the by part of the average.

This a reference to an array of DLF field names.

If the $new_by_fields parameter is set, it will be used as the new $by_fields value. It must be an array reference and should only contains valid field names for the current report specification's schema.

weigth( [$new_weight] )

Returns the DLF field's name by which the values will be multiplied before being summed.

You can change the weight field by specifying a new name as the $new_weight parameter. Use undef to remove the use of a weighting field.

Version

$Id: Average.pm,v 1.17 2008/03/09 19:27:30 vanbaal Exp $

Releases

6 releases since Debian 3.1 (Sarge); the text changed 5 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. Arch

Authors

 Francis J. Lacoste <[email protected]>
 Wolfgang Sourdeau <[email protected]>

From lire 2.1.1-8 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.