Download TOTEM Project: User Guide - TOolbox for Traffic Engineering Methods

- 9 A STANDARD XML FORMAT FOR A SCENARIO REPRESENTATION
Page 49 of 86
which aggregation level to use in the display (perLink, perCT and perPrio.
The event prints reservation information on the standard output stream such as link capacity
(maximum reservable bandwidth), reserved bandwidth, reservable bandwidth and utilisation (1 −
reserved_bandwidth/capacity ∗ 100). If linkId is given, information about only one link
is shown, else reservation is shown for all links of the network. In this case, if perLink is
true information is given for each link separately, else aggregate information is shown instead
(max, mean, standard deviation, percentile values). Information can also be shown for a specific
classType by specifying the classType attribute or for a specific priority value by specifying
both the classType and the preemptionLevel attribute. Aggregation can also be controlled
by the perCT and perPrio boolean values.
9.6 Charts Events
It is now possible (since version 2.0) to generate some charts from the data in the toolbox. The
chart creation uses the JFreeChart10 library. An interface has been created to output charts in
graphics files from the scenario XML.
Examples of scenario that use charts can be found in
• example/abilene/Scenario/charts1.xml
• example/abilene/Scenario/charts2.xml
• example/abilene/Scenario/SPF-load-chart.xml
The chart creation process is divided into three parts : selecting the data to collect, collecting
the data and outputting the chart.
Each of these steps refers to a specific scenario event detailed hereunder.
9.6.1 chartCreation
This is the first event to use when willing to create a chart. This event takes one mandatory
attribute id which is the referring name of the chart and has only one mandatory sub-event
(collector). The latter specifies the type of data to collect before the chart can be built. The
attribute name refers to the name of the java class that is used to collect the data. Specifics
parameters can be passed to the collector via an unbounded number of param sub-elements.
For now, there are only two types of chart data collectors : LinksLoadDataCollector and
LinksReservedBWDataCollector. The first one collects the load of each link computed
via a shortest path algorithm and the second one collects the reserved bandwidth of each link. The
parameters that can be passed are the domain on which to collect the data (via the parameter asId)
and whether the load should be taken as relative or not (via the absoluteLoad parameter which
can be true or false). If they are not set, the default domain is taken and relative load is used,
i.e. absoluteload/capacity. Note that both collectors uses the same parameters set.
9.6.2 chartAddSeries
At the moment when this event is executed, data are added to the currently under construction chart. The chart to which to add the data is specified by the chartId attribute. The
seriesName attribute is used to identify the data series. It must have an unique value in a single
chart. It might be used by the plotter as the legend name of the data series. Again, parameters can
10
http://www.jfree.org/jfreechart/
Copyright 2004, 2008 - ULg, UCL