Gantt View

From Planimate Knowledge Base
Jump to: navigation, search

The Gantt View display is a type where overlays are interpreted as “horizontal bars” in a Gantt chart. Gantt view.jpg

Gantt View Required Columns

Special Column Names are required for a Gantt View to Display correctly.

Each block is defined with two rows in the table. The first entry describing the start while the second defines the end point.

_time, _position & _state are required to get a display, other columns are optional

Column Name Description
_time Determines x axis, (must be ascending)
_position Determines Gantt row number ( as a Y scale offset)
_label Shown in the bar if that option selected
_state Sets the colour of a Bar.

0 = inactive, 1..15 etc map to system colours.

A value of 0 causes no bar to be drawn – and this is therefore how you end a bar.

_color The color of the Bar.

If a _color column is present, the colour as specified in it will be used, in place of _State.

If not, the original colour mapping algorithm is used, which maps _state to colours but avoids the background colour.

_width Width of the Border around the gantt (if drawn)
_borderstyle Specifies a value from the "_border styles" label list and determines the style of border the gantt block is drawn with.
_bordercolor Specifies a colour and determines the colour of the border used when drawing the gantt block (note: indent/shadow borders do not use this color.
_nodeid Individual identification of a Node, which is one or another end of a Bar.

_nodeid enables an identifier for a gantt block to be specified. A block further in time can be linked back to that previous block by setting its _link_nodeid to the same value as the previous block. Many blocks can use the same _nodeid, PL will always search for the most recent block (not including the current).

Hence to connect a series of blocks together, setting their _nodeid and _link_nodeid values to a common value (eg: consist #) will display a line linking the blocks together.

_link_nodeid See above
_link_color Colour of Node Link line.
_link_width Width of Node Link line.

The Label colour can be set for a Gantt, separately to the bar colour.

A label list can be assigned as the left hand side titles of the Gantt rows.

Clicking on the bar in the Gantt pops up a window with details of the values in other cells.

Table columns have an option item to flag inclusion in this popup. Start/end times of event are shown in the popup by default, but can be suppressed.

Gantt View Options

Option Description
Show Bar Labels Display the _Label content inside the Bars.
Show bar Times Display the Time values at each end of a bar.
Draw From Top Draw the bars with the offsets beginning off the top of the chart rather than the bottom.
Vertical Scrollbar If there are more bars than can fit in the display, a vertical scrollbar will be provided.
Show links at Front Link Lines are drawn in front of the Gantt Bars.
Align Row Labels at Left Line up Bar Labels along Y axis of chart.
Hide Time scroller Hides the Time interval zoom scroller.
No Times in Bar popups Suppress the display of Times in the popup that is displayed when you click on a gantt bar.

Gantt View Parameters

These options adjust how a gantt graph is displayed.

Bar Thickness %
sets the height of the gantt bars, as a proportion of the total row area. The default is 80%.
Bar Offset %
sets the y offset in the bar, as a proportion of the total row area. A positive or negative percentage can be specified.
Text Offset %
sets the y offset for text displayed in the bar, as a proportion of the total row area. A positive or negative percentage can be specified.

Gantt View 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.
# of rows
Row Offset
Row Labels
Label Text Colour
Label Time Colour

Gantt View Scale Parameters

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

Gantt View Scale Options

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

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.

Gantt 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 Gantt.

Gantt View Table Column Check

Use this dialog to find out whether you have included all the columns that a gantt needs to respond and display properly. It indicates which labels are required, and which of those are missing.

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.

Connecting Gantt Graph blocks with lines

Modellers have the option to place lines which connect the blocks in a gantt graph display. These can be used to indicate flow or relationships between the blocks.


This feature is under review and may change


To use this feature, the gantt table needs a couple of new columns:


_link_ganttrow


This specifies the row index to which a link should be formed.


Planimate will link to the most recent block on that row (which must appear
earlier in the table).


_link_color


This sets the colour of the link line, default (if column not present) is
black.


_link_thickness


This sets the thickness of the line, default (if the column is not present) is 1.