Column Overlay Graph View

From Planimate Knowledge Base
Revision as of 16:12, 3 October 2008 by Tony.Griffith (talk | contribs) (First Cut)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Column Overlay Graph View

A Column Overlay Graph View is useful when you are recording values into a table and using separate columns to store values from different sets of data. Each column of your table is effectively a data series that can be an overlay in this view. You can add and remove columns from the overlays listing.

If your table is set to Act as Mapper, then Planimate® assumes column 1 is the X axis values, and displays them accordingly on the View. This ability to show the X axis like this is a very powerful feature of Planimate® Graphical Views.

Click on the Title of the View to access the menu to configure the display.


Column Overlay Graph View Options

Option Description

  • Show X Scales / Show Y Scales Hide/Show the scale values in the View.
  • Show X Major Grid / Show Y Major Grid Shows a Major Grid line for the Scale, when the scale parameters are set appropriately.
  • Show X Minor Grid / Show Y Minor Grid Shows a Minor Grid line for the Scale, when the scale parameters are set appropriately.
  • Auto X Scale / Auto Y Scale The relevant scale will be automatically adjusted to make the most use of the graph scale area provided on the screen in the View.
  • Y Scale Includes Zero Guarantees that the Graph View’s Y scale includes a zero point.
  • Enable Scroll Provides the Time Interval Zoomer Scroller to allow you to zoom in on a Time interval and move this window across the graph’s full x value range. (On by default).
  • Don’t Plot 0's Any values equalling zero will not be included in the plot. This can be useful when rendering a series of overlays by appending new values to the bottom of the table, and you don’t want to do code to maintain the current values of all other columns simultaneously.
  • Show points Displays the x/y point values with little markers.
  • In Place Edit Allows Points in a single overlay ONLY of the Graph View to be edited or added by clicking on them and dragging to a new value. Alternatively, clicking twice on a point offers a dialog to edit the values.
  • No Title Hides the Title of the Table in the View
  • Extra X Scale margin / Extra Y Scale Margin Adds a little extra margin to the maximum values in the Y or X scale, to allow for the display of a nice round number in the scale values.


Column Overlay Graph Properties

The Properties Flyout provides access to a number of aspects of the View.

Property Description

  • Graphics Displays the Graphics Configuration Dialog which enables you to Set Border Style; Border Colour; Background Colour; Text Colour.
  • Position Use this option to reposition the View. Alternatively just drag it around.
  • Initial X Width Acts as a width limit for the X axis of a View. You can still stretch the scroller past this but it will revert to the limit when the data is changed by the model.
  • Min Update By default, a Graph View is updated each time the table is changed. Sometimes you may wish to have your graphs update at a lesser rate than these events. This will specify the time between updates of the graph, regardless of the number of events that have occurred in between.
  • Show Legend Temporarily shows the Legend for the Column Overlays. If you want to see a Legend permanently, select it to be visible in the View Options.
  • Save Template Saves the configuration of this graphical overlay to a Template file.. not really useful within a model any more, copy and paste of the view takes care of this for you. It may be of use of you are copying display configurations between Models.
  • Load Template Load the configuration of this graphical overlay from a Template file.. not really useful within a model any more, copy and paste of the view takes care of this for you. It may be of use of you are copying display configurations between Models.


Column Overlay Graph Mode

Graph Mode provides access to the style of rendering the graphical data in the View,.

Mode Description

  • No Lines Only Points will be Shown (if selected in View’s Options).
  • Smooth Straight line between points.
  • Stepped Horizontal Line between points at the level of the prior point, then at the X value of the later point, a vertical line drawn to the new Y value.
  • Horz. Bar Horizontal Line only between points at the level of the prior point. A kind of Gantt?
  • Histogram Vertical Lines only at each X point, drawn from Zero up to the Y value.
  • Area Area below a smooth line plot is filled in. Careful with overlay ordering here - can cause you to obscure other overlay plots.
  • Labelled Bar Gantt View recommended for these sorts of displays. Each column (overlay) is interpreted as one row in a Gantt chart. The row is determined by the new Y-Offset value. A cell's value no longer determines the y-position of the bar. Instead, it is printed inside the bar. If the column is label-formatted, the string is printed inside the bar. The bar is drawn only when there is a value greater than zero in the Cell. A value of 0 causes no bar to be drawn.
  • Centred Label Gantt View recommended for these sorts of displays.


Column Overlay Graph Overlays

When you Add a Column Overlay Graph View, either column 1 or column 2 is provided as the initial Overlay display column in the Graph. The column used depends on whether the Table is set to Act as a Mapper (Col 2 is shown if it is).

You can click on the Overlay Menu Option to Add Overlays, or configure the Display properties of existing Overlays.

Clicking the Add New button displays a list of the columns available in that table. Double click to add one to the overlay list.

Double Click on the column you wish to configure in the Overlay selection. This displays a menu of options for you to select and configure the display characteristics of the one overlay.

Y-Offset enables a given overlay to be offset relative to the other lines in the overlay.

Label Colour and Time colour will be used if you are using the Labelled Bars Graph Mode.


Column Overlay Graph Scale Parameters

There are many details you can choose to enhance the look of your View. Certain scale parameters are available here.

Check whether a parameter is in fact visible by reviewing the Options for this View.


Column Overlay Graph View Broadcasts

Certain Model User interactions with Views can have Broadcasts associated with them. You can associate the Broadcast of your choice for the following.

All View broadcasts are transmitted from the Scope of the Table, rather than the scope of the View itself.

Broadcast Name Description of Event

  • Click Broadcast Transmitted when the user clicks on the graph.
  • Scroll Broadcast Transmitted when the user scrolls the View of the Graph.


Visibility Control

The Run-Time visibility of an Attribute View can be managed by setting up conditions in the condition editor.

You can make references to the values of a range of other attributes.

Generally, you will need to enforce a refresh of the Screen display via a “Force Repaint” routine operation in a change object before a hidden attribute view that should now become visible will be seen.


Edit Original

This is the option that displays the Table Editor Window.

Alternatively, double click on the Title of the Table View to display this window.


Copy

Copies the View of this table and enables you to paste another View, with all the same settings, on another panel.


View Order

The view order of Attributes can be altered, but only in relation to other Attribute Views, not to Paint Objects or Planimate® Objects.