lire::timegroup(3pm) [debian man page]
Timegroup(3pm) LogReport's Lire Documentation Timegroup(3pm) NAME
Lire::Timegroup - Base class for implementation of the timegroup aggregator SYNOPSIS
use Lire::Timegroup; DESCRIPTION
This module is the base class for implementation of the timegroup aggregator. This aggregator will split the DLF records based on a time period controlled throught the period attribute. For example, using 1d as the period value, this aggregator will group all records in the same day period together. CONSTRUCTOR
new( %params ) Creates a new instance of a timegroup aggregator. In addition to the normal report operator parameters, the timegroup aggregator can take several parameters: field This optional parameter contains the DLF field which contains the time value used to group the DLF records together. See the field() method for more information. period This mandatory parameter should contains the period's length that will be used to group the records. See the period() method for more information. METHODS
field( [$new_field] ) Returns the DLF field's name that is used to group the DLF records. This should be a valid timestamp DLF field in the current schema. By default, the default timestamp field of the DLF schema is used. You can change the field by passing a $new_field parameter. period( [$new_period]) Returns the period's length in which the records are grouped. This can either be a duration value or the name of a report specification's parameter containing a duration value. The period's length can be changed by using the $new_period parameter. SEE ALSO
Lire::ReportSpec(3pm), Lire::Group(3pm), Lire::ReportOperator(3pm), Lire::Timeslot(3pm) AUTHORS
Francis J. Lacoste <flacoste@logreport.org> Wolfgang Sourdeau <Wolfgang.Sourdeau@Contre.COM> VERSION
$Id: Timegroup.pm,v 1.33 2006/07/23 13:16:30 vanbaal Exp $ COPYRIGHT
Copyright (C) 2001-2004 Stichting LogReport Foundation LogReport@LogReport.org This file is part of Lire. Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html. Lire 2.1.1 2006-07-23 Timegroup(3pm)
Check Out this Related Man Page
Rangegroup(3pm) LogReport's Lire Documentation Rangegroup(3pm) NAME
Lire::Group - Base class for implementation of the rangegroup aggregator SYNOPSIS
use Lire::Rangegroup; DESCRIPTION
This module is the base class for implementation of the rangegroup aggregator. This aggregator will split the DLF records based on a numerical field. The so-called range groups creates numerical classes (e.g. 1-10, 11-20, etc.) and the DLF record will be grouped with other records which are in the same class. CONSTRUCTOR
new( %params ) Creates a new instance of a group aggregator. In addition to the normal report operator parameters, the rangegroup aggregator can take several parameters: field This parameter is mandatory. It should be the name of the DLF field which will be used as key for this aggregator. range-size This parameter is mandatory. This will be used as the size of each range group. range-start The number at which the first range group starts. Defauls to 0. min-value Value lower than this number will be sorted in the first range group. max-value Value higher than this number will be sorted in the last range group. size-scale This parameter can be used to create a logarithmic scale. In this case, each new range group will be size-scale bigger than the one that comes before it. For example, setting range-size=5 and size-scale=2 will create ranges like [0-5>, [5-15>, [15-35>, ... METHODS
field( [$new_field] ) Returns the name of the DLF field which is used as grouping key. If the $new_field parameter is set, it changes the grouping field. This must be the name of a quantity type field in the report specifications DLF schema. range_start( [$new_start] ) Returns the number which is the starting bound of the first range group. If the $new_start parameter is set, it changes the starting bound of the first range group. This should either be a positive integer or the name of one of the report specification's parameter. range_size( [$new_size] ) Returns the width of each range group. If the $new_size parameter is set, it changes the width of each range group. This should either be a positive integer or the name of one of the report specification's parameter. min_value( [$new_min] ) Returns the number below which no new range groups will be created. If the $new_min is set, it changes the lower bound below which no new groups will be created. This should either be a number or the name of one of the report specification's parameter. max_value( [$new_max] ) Returns the number above which no new range groups will be created. If the $new_max is set, it changes the upper bound above which no new groups will be created. This should either be a number or the name of one of the report specification's parameter. size_scale( [$new_size_scale] ) Returns the multiplier that will be apply to each of the range group's width after the first one. When this attribute is greater than 1, it creates a logarithmic scale where each new ranges is $size_scale wider than the precedent one. If the $new_size_scale parameter is used, it changes the attribute to this new value. It should be a positive interger or can also be a parameter reference. SEE ALSO
Lire::ReportSpec(3pm), Lire::Group(3pm), Lire::ReportOperator(3pm), Lire::Aggregator(3pm) AUTHORS
Francis J. Lacoste <flacoste@logreport.org> Wolfgang Sourdeau <wsourdeau@logreport.org> VERSION
$Id: Rangegroup.pm,v 1.25 2006/07/30 10:50:17 vanbaal Exp $ COPYRIGHT
Copyright (C) 2001-2004 Stichting LogReport Foundation LogReport@LogReport.org This file is part of Lire. Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html. Lire 2.1.1 2006-07-30 Rangegroup(3pm)