h2. 5.6.5 Marker Line

These markers draw a line on particular axis area. There are two types of MarkerLine - Horizontal and Vertical. HorizontalMarkerLine is displayed in parallels with x-axis, whilst VerticalMarkerLine is displayed in parallels with y-axis. Thus, levels of these MarkerLine should be set in such way, that mappers would be able to map them. For instance, there is y-axis with MathAxisMapper and x-axis with DateAxisMapper. When setting level for VerticalMarkerLine level should be set from range of MathAxisMapper, and HorizontalMarkerLine - from range of DateAxisMapper.

Setting markers:

// calculates mean value of data model
double val1 = Statistics.mean(data1, DataColumnType.VALUE);
 
// creates a new HorizontalMarkerLine object named m
HorizontalMarkerLine m = new HorizontalMarkerLine(new PlaneMapper2D(),yMapper);
 
// sets place where marker should stand
m.setLevel(val1);
// sets label
m.setLabel("Mean: AMD Athlon 64");
// sets marker's text font
m.getTextStyle().setFont((new Font ("Arial", Font.BOLD, 9)));
// sets marker's line color
m.getPaintStyle().setForeground(new Color(251, 178, 47).darker());

MarkerLine Demonstration

Figure 5.6.5.1 MarkerLine Demonstration

View Source

Figure 5.6.5.1: MarkerLine Demonstration

import java.awt.*;
 
import javax.swing.JFrame;
 
import lt.monarch.chart.chart2D.*;
import lt.monarch.chart.chart2D.axis.*;
import lt.monarch.chart.chart2D.engine.PlaneMapper2D;
import lt.monarch.chart.chart2D.series.*;
import lt.monarch.chart.engine.*;
import lt.monarch.chart.legend.Legend;
import lt.monarch.chart.mapper.*;
import lt.monarch.chart.models.*;
import lt.monarch.chart.style.enums.Alignment;
import lt.monarch.chart.swing.JChartPanel;
import lt.monarch.chart.view.LabeledChart;
import lt.monarch.math.Statistics;
 
public class HorizontalMarker extends JFrame {
 
	private transient JChartPanel m_chartPanel;
 
	public HorizontalMarker() {
		setLayout(new BorderLayout());
		initChart();
		add(m_chartPanel, BorderLayout.CENTER);
	}
 
	void initChart() {
		/*
		 * Creating mappers
		 */
 
		String keys[] = new String[] { "2800+", "3000+", "3200+", "3400+",
				"3700+", "4000+" };
 
		LabelAxisMapper xMapper = new LabelAxisMapper(keys);
 
		MathAxisMapper yMapper = new MathAxisMapper(350, 600);
		/*
		 * Creating Data Models
		 */
		ChartDataModel data1 = new ChartDataModel();
		data1.add(new Object[] { "2800+", 408 });
		data1.add(new Object[] { "3000+", 438 });
		data1.add(new Object[] { "3200+", 475 });
		data1.add(new Object[] { "3400+", 538 });
		data1.add(new Object[] { "3700+", 523 });
		data1.add(new Object[] { "4000+", 581 });
 
		ChartDataModel dataM = new ChartDataModel();
		dataM.add(new Object[] { "2800+", 409 });
		dataM.add(new Object[] { "3000+", 390 });
		dataM.add(new Object[] { "3200+", 501 });
		dataM.add(new Object[] { "3400+", 408 });
		dataM.add(new Object[] { "3700+", 425 });
		dataM.add(new Object[] { "4000+", 547 });
 
		ChartDataModel data1R = new ChartDataModel();
		data1R.add(new Object[] { "2800+", 844 });
		data1R.add(new Object[] { "3000+", 611 });
		data1R.add(new Object[] { "3200+", 589 });
		data1R.add(new Object[] { "3400+", 560 });
		data1R.add(new Object[] { "3700+", 566 });
		data1R.add(new Object[] { "4000+", 541 });
 
		/*
		 * Creating and setting axes
		 */
		Axis2DX xAxis = new Axis2DX(xMapper);
		Axis2DY yAxis = new Axis2DY(yMapper);
		yAxis.setTitle("Passmark CPU Mark");
 
		/*
		 * Creating and setting series
		 */
 
		LineSeries cpuM = new LineSeries(dataM, xMapper, yMapper);
		LineSeries cpu = new LineSeries(data1, xMapper, yMapper);
 
		// setting titles for series
		cpuM.setName("Mobile AMD Athlon 64");
		cpu.setName("AMD Athlon 64");
 
		// setting strategies
		cpuM.setStrategy(LineStrategies.DIRECT_LINE_STRATEGY);
		cpu.setStrategy(LineStrategies.DIRECT_LINE_STRATEGY);
 
		// setting colours
		cpuM.getPaintStyle().setForeground(new Color(49, 119, 31));
		cpuM.getPaintStyle().setStroke(new BasicStroke(2));
		cpu.getPaintStyle().setForeground(new Color(251, 178, 47));
		cpu.getPaintStyle().setStroke(new BasicStroke(3));
		cpuM.getPaintStyle().setStroke(new BasicStroke(3));
 
		/*
		 * Setting Horizontal Markers
		 */
		double val1 = Statistics.mean(data1, DataColumnType.VALUE);
		HorizontalMarkerLine m = new HorizontalMarkerLine(new PlaneMapper2D(),
				yMapper);
		m.setLevel(val1);
		m.setLabel("Mean: AMD Athlon 64");
		m.getTextStyle().setFont((new Font("Arial", Font.BOLD, 9)));
		m.getPaintStyle().setForeground(new Color(251, 178, 47).darker());
 
		double valM = Statistics.mean(dataM, DataColumnType.VALUE);
		HorizontalMarkerLine mM = new HorizontalMarkerLine(new PlaneMapper2D(),
				yMapper);
		mM.setLevel(valM);
		mM.setLabel("Mean: Mobile AMD Athlon 64");
		mM.getTextStyle().setFont((new Font("Arial", Font.BOLD, 9)));
		mM.setLabelPosition(0.65, Alignment.TOP);
		mM.getPaintStyle().setForeground(new Color(49, 119, 31).darker());
 
		/*
		 * Creating the grid
		 */
		Grid grid = new Grid(new PlaneMapper2D(), null, yMapper);
 
		/*
		 * Creating the chart
		 */
		Chart2D chart = new Chart2D();
		chart.setObjects(new ChartObject[] { grid, cpu, cpuM, m, mM });
		xAxis.setAxisPosition(yAxis, 0);
		chart.setXAxis(xAxis);
		chart.setYAxis(yAxis);
 
		/*
		 * Creating the title
		 */
		LabeledChart m_chart = new LabeledChart(chart);
		m_chart.setTitle("Single CPU Systems Benchmarks");
 
		/*
		 * Creating legend
		 */
		Legend legend = new Legend(chart);
		legend.setMaxColumns(2);
		m_chart.setBottomView(legend);
		m_chartPanel = new JChartPanel(m_chart);
		m_chartPanel.setHotSpotMap(new SimpleHotSpotMap());
	}
 
	public static void main(String[] args) {
		HorizontalMarker frame = new HorizontalMarker();
		frame.setSize(new Dimension(600, 400));
		frame.setDefaultCloseOperation(EXIT_ON_CLOSE);
		frame.setTitle("Single CPU Systems Benchmarks");
		frame.setVisible(true);
	}
}

Other MarkerLine Options

There are several methods that enable setting and changing properties of markerRange such as title, position and so on. Below is the code, illustrating markerLine settings. However, markerLine background, foreground colors and other options related to style such as stroke, can be set using getPaintStyle() and getTextStyle() methods.

Label

It is possible to set title for markerLine, which will appear on chart. This can be done using setLabel() method.

//sets marker title
m.setLabel("Mean: AMD Athlon 64");

MarkerLine label style can be set by using html tags.

//sets marker title style with html tags
m.setLabel("<html><body style=\"background-color:green\"/>"
  + "<font color=red size=+1>Mean: AMD Athlon 64</font>");

Also it is possible to set markerLine label's position using setLabelPosition() method.

First parameter can have values from interval [0..1], where 0 represents bottom of plot area and 1 - top of plot area.
Second parameter can be set using enumeration Alignment (bottom, top, left, right, center).

mM.setLabelPosition(0.65, Alignment.TOP);

Position

In order to set position where marker range line should appear, setLevel() method must be used. Parameter's value represents mapper's value where line should appear. However, when setting this value, mapper which was set for marker range must be able to map this value. That is, if we set markerLine with MathAxisMapper, then using this method parameter must be value which MathAxisMapper is able to map and from its range.

Setting MarkerLine object's position

double valM = Statistics.mean(dataM, DataColumnType.VALUE);
mM.setLevel(valM);