GDX data conventions for charts

We have seen already that the number of dimensions shown in the data section of the GDX viewer determines what charts we can create. For a given dimension, the number of elements in the last dimension also determines what kind of chart we can create. For example, a 2D scatter chart requires a point (x0,y0) and a 2D vector chart requires a line (x0, y0) (x1, y1).

The table that follows summarizes the GDX file conventions for the various chart formats. It also includes the names used in the chart files for the TYPE parameter.

Note that the label names for the columns, like x0, y0 etc are arbitrary. The sequence of the labels is important however and this can be seen in the GDX data viewer.

GDX data convention for 2D vector

Dim	TYPE	Dim1	Dim2	Dim3	Value(s)
1	line	Label X			Y
	area	Label X			Y
	bar	Label X			Y
	horizbar	Label Y			X
	pie	Label segment			Segment
2	function	Place holder	Place Holder		X, Y
	parametric	Place holder	Place Holder		X, Y
	multi-line	Label X axis	Label line		Y
	multi-area	Label X axis	Label area
	multi-bar	Label X axis	Label bar		Y
	horz-bars	Label Y axis	Label bar		X
	multi-pie	Label segment	Label pie		Segment
	scatter2d	Place holder			X, Y
	scatter3d	Place holder			X, Y, Z
	vector2d	Place holder			X0, Y0, X1, Y1
	vector3d	Place holder			X0, Y0, Z0, X1, Y1, Z1
	grid	Label X axis	Label Y axis		Color
	surface	Label X axis	Label Z axis		Y and Color
	fanhisto	Label time	Label scenario		Y (see note)
	fanvalues	Label time	Label scenario		Y (see note)
	fanprob	Label time	Label scenario		Y (see note)
	shaperect	Place holder			X0, Y0, X1, Y1, Legend, Color (see note)
	shapeellipse	Place holder			X0, Y0, X1, Y1, Legend, Color (see note)
3	multi-linex	Place holder	Label line	Place holder	X, Y
	mult-barx	Place holder	Label bar	Place holder	X, Y
	multi-areax	Place holder	Label area	Place holder	X, Y
	horz-barsy	Place holder	Label bar	Place holder	X, Y
	gantt	Label resource	Label task	Place holder	Start, Length

Note: Fan charts assume that the first time slot contains the probability for the scenarios. Probabilities have to be positive and their sum should equal one.

For shapes, rectangle and ellipse, the legend and color are optional value. A non-zero value for the legend will draw the string of the place holder in the center of the shape. Color is codes as an RGB value. Reds in the range 0..255, Green in the range 256 * (0..255) and Blue 256 * 256 * (0..255)