NAME

OP::Series - Consolidated series data

DESCRIPTION

Generate consolidated, interpolated series data from an array of objects.

SYNOPSIS

  use OP::Series;

  my $series = OP::Series->new();

INSTANCE METHODS

Axis Options

• setXKey($xKey), setYKey($yKey)

  Define which object keys to use for X and Y axis:

    $series->setXKey("timestamp");
    $series->setYKey("value");

X Axis Options

• setXMin($xMin), setXMax($xMax)

  Confine the received data to a range specified by xMin and xMax.

  Set X axis opts (time opts, in this case):

    $series->setXMin(1218508949);
    $series->setXMax(1218508969);

• setXTickSize($size)

  Specify the desired step interval between datapoints on the X axis.

  The unit of measurement would be the same as the value being used for the axis (so, seconds if plotting seconds, widgets if plotting widgets).

    $series->setXTickSize(1); # 1 Second

• setXMajorTickSize($size)

  Apply a "moving average" to the data after expanding base ticks. (Optional/Experimental)

    $series->setXMajorTickSize(60); # 1 Minute

• setXConsolidator($const)

  Specify a function to use for consolidation of overlapping values.

  See OP::Enum::Consol.

  This is an optional argument, and defaults to Average.

    $series->setXConsolidator(
      OP::Enum::Consol::Median
    );

Y Axis Options

• setYInterpolate($const)

  Optional, set interpolation type.

  See OP::Enum::Inter.

  Defaults to Linear.

    $series->setYInterpolate(OP::Enum::Inter::Spline);

• setYRpn($rpnStr)

  Optional, supply an RPN expression

    $series->setYRpn("-1,*"); # Inverted axis

• setYType($const)

  Optional, supply statistic type.

  See OP::Enum::StatType.

  Defaults to Gauge.

    $series->setYType(OP::Enum::StatType::Counter);

Processing Data

• addObject($object)

  Add an object to the raw data set. The objects don't need to be blessed, they just need to contain similar attributes:

    $series->addObject({
      timestamp => 1218508949,
      value => 99.1
    });
  
    $series->addObject({
      timestamp => 1218508969,
      value => 99.8
    });
  
    ...

• cooked()

  Generate an OP::Hash object, containing consolidated, interpolated, unsorted associative rows:

    ...
  
    for ( @objects ) {
      $series->addObject($_);
    }
  
    my $data = $series->cooked(); # Returns an OP::Hash
  
    # { X => Y, ... }
    #
    # This example has been dealing with time series data
    # (X is time) and the hash will look like:
    #
    # { 
    #   timestamp => value,
    #   timestamp => value,
    #   ...
    # }
  
    #
    # Access the processed series data as a normal Perl hashref,
    # or with any OP::Hash instance method:
    #
    $data->each( sub{
      print "at unix time $_, value was $data->{$_}\n";
    } );

• clearHash()

  Resets all internal data structures to a pre-cooked state.

    ...
  
    my $set1 = $series->cooked();
  
    $series->clearHash();
  
    ...
  
    my $set2 = $series->cooked();

SEE ALSO

Parse::RPN, Math::Spline, Math::VecStat

OP::Class, OP::Array, OP::Hash

OP::Enum::Consol, OP::Enum::Inter, OP::Enum::StatType

Inspired by Tie::Hash::Interpolate

This file is part of OP.