Graph::Timeline - Render timeline data
This document refers to verion 1.5 of Graph::Timeline, released September 29, 2009
This class takes a list of events and processes them so that they can be rendered in various graphical formats by subclasses of this class.
The purpose of this class is to organise the data that will be used to render a timeline. Events fall into two types. Intervals, which has a start and an end. For example Albert Einstein was born on 1879/03/14 and died on 1955/04/18, this would be stored as an interval. His works were publicly burned by the Nazi's on 1933/05/10 for being 'of un-German spirit', I guess being Jewish didn't help either. So this event would be marked as a point.
You feed events into the class using add_interval( ) and add_point( ), then use window( ) to select which events you want to render and then call data( ) to get the relevant events. This last bit will be done in the subclass.
The constructor takes no arguments and just initialises a few basic variables.
Inserts an event that has a start and an end point into the list at the corrct position. The hash contains the following keys, some of which are required.
The start date for the interval in the for 'YYYY/MM/DD' or the word 'present' which will be converted into todays date. Dates in the format YYYY will be taken to span YYYY/01/01 until YYYY/12/31 and dates of the format YYYY/MM will span YYYY/MM/01 until YYYY/MM/xx where xx is the last day of MM in YYYY.
The start end for the interval in the for 'YYYY/MM/DD' or the word 'present' which will be converted into todays date. Dates in the format YYYY will be taken to span YYYY/01/01 until YYYY/12/31 and dates of the format YYYY/MM will span YYYY/MM/01 until YYYY/MM/xx where xx is the last day of MM in YYYY.
The text string that will be displayed when the event is rendered
A unique id for the render, Graph::Timeline does not validate this field for uniqueness
A string is used to group related events together, Graph::Timeline does not validate this field
The same as add_interval( ) except that the event occurs on just one day and therefore does not require an end date. Interval and point events are rendered differently.
Set up the data to be selected from the event pool. To reset the defaults just call without any parameters.
Select only record that start on or after this date. Takes a valid date or the word 'present' which is translated to the current date.
Select only record that end on or before this date. Takes a valid date or the word 'present' which is translated to the current date.
If end is set then include records that start before the end date but ends after the end date.
If start is set then include records that start before the start date but end after the start date.
If start and end are both set then additionally report events that start before the start date and end after the end date.
A code reference to provide additionaly custom filtering. The callback will be passed a hash reference with the following keys: start, end, label, group, id and type ('interval' and 'point').
This returns a list of the events from the pool that got passed the parameters from the window( ) method.
Used to add the event into the pool which is sorted by start date
Validate that the keys supplied in the hash are valid
Validate a date
Check that the required keys have been supplied in the hash
Lowercase the keys in a hash
Return todays date for use with the 'present' word
Set the xxx_start and xxx_end values from the xxx data
None
When the constructor is initialised it requires no arguments. This message is given if some arguments were supplied.
The parameter is a hash describing an event
To define 'span' then you must also define 'start' and 'end'
You must pass a code reference for the callback
When the method is called it requires no arguments. This message is given if some arguments were supplied.
The only valid keys are 'start', 'end', 'label', 'group' and 'id'. Something else was supplied.
The date supplied for '...' is invalid
The values for 'start' and 'end' are in the wrong order
A required key was not supplied. Required keys are 'start', 'end' and 'label'
The only valid keys are 'start', 'label', 'group' and 'id'. Something else was supplied.
A required key was not supplied. Required keys are 'start' and 'label'
The only valid keys are 'start', 'end', 'start_in', 'end_in', 'span' and 'callback'. Something else was supplied.
See the Timeline.t file in the test directory
Graph::Timeline::GD - Use GD to render the timeline
Peter Hickman (peterhi@ntlworld.com)
Copyright (c) 2003, Peter Hickman. All rights reserved.
This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.
To install Graph::Timeline, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Graph::Timeline
CPAN shell
perl -MCPAN -e shell install Graph::Timeline
For more information on module installation, please visit the detailed CPAN module installation guide.