GDX data conventions for charts

Top  Previous  Next

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

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)