Tutorial 5. Manipulating Axes, Legend, and Titles
In this tutorial, we will learn about manipulating graph axes, legend, and
titles. It is
recommended that you read the topics Graph Document, Property
Grid, and Series before continue.
Series Axis Association
Open the file ExamplesSample GraphsLines.dts under the DataScene
installation folder (which can be opened by selecting the Help: Demo Projects
menu command). Select the Line graph
document. Change its view dimension to 3D in the View
Double click the blue line (line1 as shown in the Series
Editor or J0(x) as shown in the
legend) in the Line graph document to open the Series
Editor. In the editor, select the Axes property in the property grid and
open the Series Axes dialog box by clicking
in the value cell. In the Series Axes dialog box, select Bottom and Top in the Horizontal
Axis combo-box. Close the popup information window. Close the Series Axes dialog box
by clicking its OK button.
Select line2 (the red line, or J1(x) as shown in the
legend) in the Series
Editor to make it the active series. Follow the same steps as shown
above to change the axis association for line2 as: Right
for the Vertical Axis, and Bottom for the Horizontal Axis
(unchanged). Close the Series Axes dialog
box and then
Editor. The Left, Right, Top, and Bottom axes are
now all drawn in the Line graph
(as shown in Fig. 1.) because all of them are now associated with series in the
Fig. 1. The Left, Right, Top, and Bottom axes are associated with series
in the graph.
Select line3 (the green line, or J2(x) as shown in the
legend) in the Active Series
combo-box. Switch to the Graph tab-page of the Navigator
and uncheck the checkbox before line1 to hide it from the graph document.
Note that the Top axis is also hidden as line1 is hidden. This is because the
axis is associated only with line1 but not with the
other series in the graph. Uncheck the checkbox before line2 to
hide it from the graph document. You will see that the Right axis is also hidden
for the same reason. Now re-check both line1 and line2 so that
they are re-drawn in the graph document.
Axis properties are mainly changed with the Axis
Editor that can be opened by double clicking on the axis or by
selecting the Axes menu command on the Graph menu. Few properties can also be changed with certain tools
on the Graph
Tools tab of the ToolBox (e.g the axis
range can be changed with the Magnifier, Pan Tool, and Auto
Double click the Right axis of the graph in the Line graph document to
open the Axis Editor.
Switch to the Scales tab-page of the editor, uncheck the Automatic
check box and input the following
values: 0.3 in the Desired Increment text box, 0.6 in the Maximum Value
textbox, and -0.6 in the Minimum Value textbox. On the Labels:
Style tab-page, input 45 in the Angle textbox.
Fig. 2. Customizing the Right axis with the Axis Editor.
Now, select Left Axis in the Axes list box so that we can
customize the Left axis of the graph. On the Ticks tab-page, click the Major
Grid button to open the Pen Editor.
In the editor, uncheck the Visible
check box to hide the major grids of the Left axis. Close the Pen
Editor by clicking its OK button. Switch to the Labels: Format
tab-page, select 0.00E-0 in the Values Format combo-box and check
the Exponential check box. The value 0.00E-0 is a Value
Format Code that dictates the use of the scientific notation with two
digits after the decimal point.
Checking the Exponential check box makes DataScene use "´10"
rather than "E" to represent the base and use superscript for the
exponent. Close the Axis
Editor and the Line graph document should look like that shown
in Fig. 3.
Fig. 3. The Line graph document with customized Left and Right axes.
Click the Magnifier tool on the ToolBox.
Move the mouse pointer into the graph and drag to draw a
rectangle while keeping the left mouse button pressed.
DataScene changes the range settings of the axes to zoom in the drawn
rectangle. Click the Auto Scale tool to restore all axes to
the auto-scale mode.
You may want to experiment with more properties in the Axis
Editor or the Panel Tool on the ToolBox. After you are done, close the project without
saving the changes made to it.
Use the data in the file ExamplesDataLines.txt under the DataScene
installation folder to plot three 3D Line series
in the same graph: 3DLine1 using Column 1 and Column 2, 3DLine2
using Column 1 and Column 3, and 3DLine3 using Column 1 and
Column 4. In all cases, Column 1 is associated with the Position
component and the other column with the value component. DataScene names the graph document Lines.txt. You may want to refer to Tutorial
3 for details of creating multiple series in the same graph.
The newly created graph should look like that in Fig. 4.
Fig. 4. Three 3D Line series created with data in Lines.txt.
Open the Legend Editor for the Lines.txt graph
document by double clicking on the legend or by selecting the Legend
menu command on the Graph menu. Switch to the Position
tab-page of the Legend Editor, check
different radio buttons in the Position group box to change the legend
position style (i.e. Left, Top, Right, or Bottom). You may also
use the Margin
and Position Offset properties to fine tune the legend position.
Now check the Custom check box to make the legend a custom legend. A
custom legend can be drawn inside the graph cube and can be
dragged by the mouse - which cannot be done with a non-custom legend. Change the options in
the Position group box and you will see that a Left-
or Right-style custom legend lists its legend items from top to bottom while a Top- or
Bottom-style custom legend lists its legend items from left to right. Click the OK
button to close the Legend Editor. Drag
the legend with the left mouse button to a desired position.
Open the Legend Editor again and
switch to the Labels tab-page. Make sure that 3DLine1 is selected
in the Series combo-box. In the rich text editor on the bottom of this
tab-page, erase the text "3DLine1" and type "J0(x)".
Note that the "0" is made subscript by selecting it in the editor and
then apply the subscript style by clicking the
button on the editor toolbar. This changes the legend label string for the 3DLine1
series to be "J0(x)". Note that the Name property of
the 3DLine1 series is still the plain text "3DLine1" which can be changed
with the Series
Select 3DLine2 in the Series combo-box and change its label to
"J1(x)". Do the same for 3DLine3 and change its
label to "J2(x)". Close the Legend
Editor by clicking its OK button. The graph should like similar
to that of Fig.
Fig. 5. Three 3D Line series with a customized legend.
Open the Title Editor for the Lines.txt
graph document by double clicking on the "Lines.txt" header text on
the top of the graph or by selecting the Titles menu command on the Graph
menu. Make sure that Header is selected in the Title
combo-box and then select the Text tab-page. In the rich text editor of this tab-page, erase
the text "Lines.txt" and type "Bessel Functions of the First
Kind". Apply the Bold style by selecting the text and then clicking
Switch to the Frame tab-page of the Title
Editor and uncheck the Transparent
check box. Click the Brush button to open the Brush
Editor. Select the white color in the Brush
Editor and then close it by clicking its OK button. Close the Title
Editor button by clicking its OK button. The graph now should look like
that shown in Fig. 6.
Fig. 6. Three 3D Line series with customized legend and header.
You may want to experiment more options in the Legend
Editor and/or Title Editor. Close
all opened projects without saving any changes.