QUICK HELP FOR YKGraph

Updated for version 3.01

See below shortcomings of different browsers.


Index

General
Windows
New graph
Green wave drawing
Adjust green wave by dragging timings with mouse
Adjust green wave using the junction window
Minimum green and intergreen
Signal control
Tram mode
Bicycle mode
Acceleration and deceleration
Routing
Run time measurements
Scales
View the graph
File operations
Toolbox (icons)
Menu
Settings
Browser shortcomings


General

DIMENSIONS

- Max 30 Junctions
- Max 13 Movements
- Max 8 Timing plans

MAJOR SHORTCOMINGS

- YKGraph is an advanced graphical green wave planning tool. It doesn't, however, include any signal timings optimization or calculation functions.
- Junction movement labels are fixed (from 0 to 12)
- Intergreens are fixed in each junction; not between conflicting movements as normally
- Tram line in westbound direction is missing - coming in future versions
- Waiting time at tram stops has no distribution - coming in future versions

KNOWN ERRORS

- Tram and bicycle run lines may be drawn over borders
- Complex phasing including right turning movements doesn't work properly
- If 'Junction Map' is moved, 'Color Picker' and 'Phasing Map' may be opened in an incorrect position on the screen
- Minor layout bug of the intergreen table for movements WBL and WBR
- Wave drag by minor street movement box (drag mode group) doesn't work

TRAM, BUS AND BICYCLE DRIVING DYNAMICS

- Trams run along a separate lane ("tram lane") on a constant speed. Tram waiting times at tram stops is constant (distributions are available on future versions). Other traffic has no influence on tram driving.

- Bicycles run along a separate bicycle path or lane on a constant speed. Other traffic or pedestrians have no influence on bicycle driving.

- Buses run along a common lane with other traffic or on a bus lane with minor other traffic. Bus must queue at junctions with other vehicles. Note: Buses are not available in current version.


Windows

JUNCTION WINDOW

Open by clicking on the small junction image below the graph. Close it by clicking the image again, on the other junction image or use the button 'Close'.

MOVEMENT WINDOW

Open by clicking on the button 'Edit' on the Junction Window.

Select movements you want to use in the graph. Accept clicking on the button OK.

PHASING WINDOW

Open by clicking on the button 'Phasing' on Junction Window.

Click on the arrows representing movements of the sequence you want to change. Accept pressing the button OK.

COLOUR WINDOW

Open by clicking on the button 'Colours' on Junction Window.

First click the movement which colour you want to change and then click any colour of the colour box. The movement colour changes in Junction Window and also in the graph.

'Reset' button reverts the route colour settings. 'Set all' button set the colour for all same type movements of the route. Press this button after you have click the colour box.

EDIT WINDOWS

Open Edit windows using menu EDIT and continue by selecting the item you want to edit.

You can open a specific edit window by clicking Route name or Plan name and even figures as link length, link speed, junction name or the tram stop image at the bottom line of the graph.

Values of each junction, link and tram stop may be specified also separately:

Open Edit Junction by clicking the junction name and Edit Link by clicking the link length or link speed. You may also open these edit windows by clicking the titles above the graph.

Open Edit Tram stop by clicking the stop figure between two junctions. Add a new tram stop by clicking the link length figure in Tram Mode.

PLAN WINDOW

Open Edit Plans using menu EDIT > PLANS. You may edit each plan timings, update, copy and add a new plan and also delete an old plan. Clicking on the right side button Table you can show the timings as a table format instead of the default map format.

New graph

Start the new graph using menu File > New. Either you can draw the whole graph all in once or gradually junctions one by one. After this adjust the timings according your plan.

Otherwise you can add a blank plan opening the menu Edit > Plan. Then input your movement timings for each junction. Finally press the button Update.

Green wave drawing

YKGraph draws green waves (bands) of coordinated traffic signals using given speeds: default wave speed, route speed or link speed. The wave is drawn individually on each link (street section between two junctions).

The wave head (downer) line is always drawn according the given speed.

The wave tail (upper) line is drawn depending on the wave type, either using the given speed or using the speed calculated from the offset between the end of green of the two junctions.

WAVE TYPES

Six different wave section types (read in Finnish) are used in YKGraph.

Besides two special cases are shown:

Examples of wave types are available using menu: View > Wave types.

You can show or hide wave descriptions using menu: Graphics > Wave description.

SPEED LIMIT AND SPEEDING

If Speed limit and Speeding are in use, wave tail line can be faster than the given wave speed.

If the tail wave speed is higher than the wave speed but doesn't exceed Speed limit, then the tail speed figure is shown in purple colour. If it is greater, instead, the wave tail line and the speed figure are both red.

The tail wave speed, however, can never exceed the value Speed limit + Speeding.

NOTE: The wave speed can't be higher than the Speed limit.

Adjust green wave by dragging timings with mouse

SINGLE JUNCTION

First go to the Junction mode by clicking the junction number until it turns black (default). Then drag any box of the junction up or down. Timings of all movements change.

SINGLE MOVEMENT

First go to the Movement mode by clicking the junction number until it turns red. Then drag the movement box up or down by touching it...
- in the middle. Movement green begin and green end change.
- at the bottom. Only movement green begin changes.
- at the top. Only movement green end changes.

GROUP OF JUNCTIONS

First go to the Group mode by clicking the junction numbers of selected junctions until each of them turns blue. Then drag any box of the selected junctions up or down. Timings of all selected junctions change.

WAVE IN ONE DIRECTION

First set all the junctions, where the wave should be adjusted to the Group mode. Then set one of these junctions to Movement mode. Now you are ready to adjust the wave in either main street direction.

Drag the main street movement box of the junction in Movement mode up or down by touching it...
- in the middle. Whole wave changes.
- at the bottom. Only wave tail changes.
- at the top. Only wave head changes.

WAVES IN BOTH DIRECTIONS

THIS OPTION IS NOT AVAILABLE IN THE CURRENT VERSION

First do just the same as adjusting wave in one direction (above).

Then drag any minor street movement box of the junction in Movement mode up or down. Either the wave heads or wave tails in both direction may change depending of the position of the minor street movement box you are dragging.

Adjust green wave using the junction window

OPEN AND CLOSE THE JUNCTION WINDOW

Open the junction window by clicking on the small junction image below the graph. To close the window click it again, click on the other junction image or use the button 'Close' in the Junction window.

MOUSE BUTTONS

The mouse left button moves the box upwards (timings increase) and the mouse right button downwards (timings decrease).

STEP LENGTH

Select step length using radio buttons. Note that the step 2.5 s means a step first 2 seconds and then 3 seconds.

SINGLE MOVEMENT

Click on the movement box...
- in the middle. Movement green begin and green end change.
- on the left/upper side. Only movement green begin changes.
- at the right/downer side. Only movement green end changes.

WHOLE JUNCTION

Click on the name of the junction on top of the window.

Minimum green and intergreen

Note: In current version the length of minimum green and intergreens are fixed in each junction. Special intergreen values between movements are not available.

MINIMUM GREEN

When the movement box size is reduced to the minimum green, the box colour turns to its complementary colour. The box size can't be reduced under the minimum green.

You can adjust the minimum green (eg. 8 secs) of each junction using the junction edit window.

INTERGREEN

When dragging the movement box, red intergreen lines are visible. If any intergreen line touches the conflict movement, the conflict movement box size will decrease.

You can adjust the intergreen (eg. 6 secs) of each junction using the junction edit window.

Special intergreens between movement pairs EBT & WBT, EBL & WBL, NBT & SBT and NBL & SBL can be set in Movement Window.

Signal control

Open Junction Window by clicking on the small junction image below the graph.

SET FLASHING MODE

Set the signals to the flashing mode by clicking the button Hide. Set back to the three colour mode using again the button Show.

You may also use the shortcut: press down CTRL button and click the junction name.

H or F added to the Junction Number (eg. 123F) in data file set the junction to the flashing mode when opening the file.

ADD AND REMOVE MOVEMENTS

Open the Movement Window by clicking the Junction Window button Edit. Then select movements you want to show in the graph.

CHANGE JUNCTION PHASE SEQUENCE

Open the Phasing Window by clicking on the Junction Window button Phasing. Then click on the movement arrow to change the sequence of the movements in the same row.

Tram mode

Turn Tram mode on by clicking on the tram icon or use menu 'Modes > Tram'

TRAM STOP

Create a new tram stop by clicking the link length figure when Tram mode is on. Tram stop edit window opens. Change defaults if needed and press the button 'New tram stop'.

Edit tram stop properties by clicking on the retangular orange box between junctions.

TRAM LINK

Create specific tram link properties by clicking on the link speed figure between junctions on tram mode. Tram link window opens. Add tram speed and press the button 'Update'.

Edit tram link properties by clicking on the orange tram speed figure between junctions.

Bicycle mode

Turn Bicycle mode on by clicking on the bicycle icon or use menu 'Modes > Bicycle'

BICYCLE LINK

Create specific bicycle link properties by clicking on the link speed figure between junctions on bicycle mode. Bicycle link window opens. Add bicycle speed and press the button 'Update'.

Edit bicycle link properties by clicking on the purple bicycle speed figure between junctions.

Acceleration and deceleration

Tram acceleration and deceleration settings are specified separately for junctions and for tram stops. These can be edited in Edit Tram Window (in future versions)

Routing

The default tram and bicycle route is from the first to the last junction. The in-route and out-route junctions are shown by the orange or purple arrows on the junction map.

You may specify in-route and out-route junctions and movements by clicking the arrow on the small junction image to open the Route window.

NOTE: You can specify option 'no control', "permanent green' and 'RTOR' for in-route and out-route junctions by the movement figure 99'.

Run time measurements

Results of tram and bicycle run times are on the right upper corner. These are based on the next assumptions

Measurement options will be updated in future versions.

Scales

Distance (horizontal) scale is specified for the width of a landscape A4 sheet.

The natural scale is one pixel for one meter. It depends on the screen width property.

The scale of one screen shows the whole wave graph in one screen. Scales two screens and three screens accordingly.

Too small and too big scales are replaced with minimum and maximum scale values.

Time (vertical) scale is not adjustable. It is always one pixel for one second.

View the graph

ZOOM

- Zoom all the graph using the mouse wheel. You can reset zooming using the toolbox icon 'Reset zoom'

MOVE

- Graph move is not available in current version. Use the basic window scrolling elements instead.

File operations

GRAPH FILE OPEN

- Use the button 'File select' on top of the graph. The file name is shown on the upper right corner depending of the option selected).

GRAPH FILE SAVE

- Use top row buttons, first press Load data for save and then continue on the button Save. NOTE: The name of the file saved is not shown on the screen.

Toolbox

New

- Start a new graph.

Open

- Open the graph file by pressing the top row button File select.

Save

- Save the file by pressing first the top row button Load the graph data for save and then the next right button Save.

SVG output

- Save the graph as a Scalable Vector Graphic file. Look more File > SVG output.

View

- View the current timings as a text data in a new window. Look more File > View.

Reset zoom

- Reset all graph zooming to the 100% level

Reload

- Reload the last saved or opened file.

Undo Redo

- Reverts the last timing change / reverts the effects of the last undo action. Can't undo or redo settings, cycle length or titles, only timing changes.

Intergreens ON Intergreens OFF

- Change intergreen monitoring mode. Look more in menu Options>Intergreens.

Wave eastbound (-->) Wave westbound (<--)

- Show wave for the eastbound or westbound traffic or in both directions.

Show wave lines Show wave bands

- During the wave dragging wave lines or wave bands are drawn between the previous and the next junction. Look more Menu > Show > Wave band.

Wave tail speed

- Show or hide wave tail speed figures. Look more Menu > Show > Speed figures

Timing figures

- Show or hide timing figures. Look more Menu > Show > Timing figures

Wave type descriptions

- Show or hide wave type descriptions.

Wave edge

- Show or hide wave edge width.

Tram mode

- Draw tram run trajectories through all junctions.

Bus mode

- Available in future versions

Bicycle mode

- Draw bicycle run trajectories through all junctions.

Quick help

- Open YKGraph Quick Help window (this window)

Web site

- Open YKGraph web site

Menu

 FILE 

New - Prepare a new graph data set either

- junction by junction. You can set specific settings to each junction and each link.

- all junctions at once. All junctions and links will have the same settings.

A new tram stop is added to the route by clicking in Tram Mode on the link length figure between two junctions.

Open - Open the graph file by pressing the top row button File select.

Save - Press first the top row button Load the graph data for save and then the next right button Save. NOTE: Use browser settings (in Chrome): Ask, where to save the file.

SVG output - Save the graph as a Scalable Vector Graphic file. This file is opened using any web browser and can be easily converted to the pdf file

Reload - Reload the last saved or opened file.

Undo - Reverts the last timing change

Redo - Reverts the effects of the last undo action

Refresh - Refresh the graph

Exit - Exit YKGraph by closing the current tab window.

 VIEW 

Data file - View the current data in a new window. Data is shown on the same format as in YKGraph data file.

Intergreens - View the conflict tables (e.g. matrix with X on each conflicting movement pair) of each junction.

Samples - Load one of four sample files: Basic model, Wave types, Vihdintie (Helsinki) and Ratapihankatu (Turku)

 PLANS 

Select the current plan for the graph.

 EDIT 

Route data - Edit current routes, also tram and bicycle routes.

Speeds - Edit speed settings

Junctions - Edit junction settings

Trams - Edit tram settings

Bicycles - Edit bicycle settings

Plans - Edit, add and remove plans using plan or table modes

When you change the cycle length, all timings will be changed in the same proportion as the cycle length. Check the intergreens before saving the file.

Scales - Edit distance scale

Information - Edit the user, date and other information.

Graphics - Edit graphic settings

Colors - Edit movement colours common to all junctions. The single junction colour is editable using Junction Window.

 SELECT 

Junctions - Black junction number. Timings of the single junction are draggable.

Groups - Blue junction number. Timings of the junction group are draggable.

Movements - Red junction number. Timings of each movement are draggable separately.

 MODES 

Intergreens - Use or skip intergreen monitoring. If the intergreen monitoring is off, you can move movement boxes without any intergreen restrictions. Skipping intergreen monitoring helps you to draft the green wave

When you set the monitoring again in use, YKGraph checks if any intergreen violence exists. If violations are found, junctions are set to Movement mode, otherwise to Junction mode.

Tram mode - Switch Tram mode on or off. In Tram Mode tram runs (trajectories) with even headways are plotted in the graph. Trams stop at each tram stop.

Bus mode - Coming to the future versions

Bicycle mode - Switch Bicycle mode on or off. Bicycle mode is similar as Tram Mode, but there are no stops.

 TOOLS 

Runs Visualize each tram or bicycle run (trajectory) through all the junctions. Use buttons 0...9 to show each run.

Analyses Reserved for future versions

 GRAPHICS 

Wave directions - Show the wave in both directions, only in Eastbound direction (from left to right) or in Westbound direction (from right to left).

Wave lines / band - Show wave band (2), only band border lines (1) or no band at all (0) during wave dragging.

Wave edges - Show or hide wave edge. To get a broad wave edge use Menu > Misc. > Draw broad edge.

Movement boxes - Show or hide other than the main street movement boxes .

Speed figures - Show or hide wave tail speed figures.

Tail speed figures are shown only in those links, where the last vehicle using the given speed is able to drive throught the next junction. Otherwise the tail speed figures are not shown. Read more about tail speed figures (only in Finnish).

Timing figures - Show or hide movement timing figures.

Wave descriptions - Show or hide wave type descriptions. Read more about wave types (only in Finnish).

Tram stops - Show or hide tram stops. Note: white tram stops are out of operation. NOT YET AVAILABLE

 MISC. 

Show shortcuts - List shortcuts available (preliminary).

Toggle broad wave edge - Toggle the graph with the edge of 1 or 2 pixels.

Toggle default / user colours - Toggle the graph between the default colours and the user setting colours. More on the menu page Settings

Toggle help lines - Toggle horizontal timing help lines with 10 sec intervals.

Toggle deceleration lines - Toggle vertical lines over run deceleration start points.

Remove hidden movements - Removes all hidden movements from data. Note that hidden movements may have timings, but these have no effect on the visible movements. You can hide and make movements visible again using the button 'Edit' in the Junction Window

 SETTINGS  (USER SETTINGS)

Edit user settings Edit and save user settings. User settings are stored to your web store (html5). These are available when you next time open YKGraph.

Remove user settings Remove all user settings. This option can be used if you will reject user settings and use factory settings instead.

 HELP 

Quick help - User instructions of YKGraph (this file).

Handbook - ** Not yet available **

Other helpers - Some special helpers for YKGraph

Web site Eng - Link to the English web site of YKGraph.

Web site Fin - Link to the Finnish web site of YKGraph.

About - Very short information on YKGraph.

Settings

Overall settings specify the default properties of speeds, junctions, scales, info, etc. for the whole graph. These can be set at the beginning of the data file and edited in Overall Settings Windows (Menu > Edit).

Default overall settings are
- link length = 200 m (min:50, max:1600)
- wave speed = 45 km/h (min:10, max:80)
- speed limit = 50 km/h (min:10, max:80, not in use:0)
- speeding = 0 km/h (min:0, max:10)
- junction space = 20 m (min:10, max:60)
- minimum green = 10 sec (min:5, max:25)
- intergreen = 5 sec (min:4, max:25)
- cycle length = 100 sec (min:30, max:180)
- tram speed = 45 km/h (min:9, max:72)
- tram acceleration= 1 m/s2 (not editable yet)
- tram deceleration= 1 m/s2 (not editable yet)
- stop time medium = 15 sec (min:1, max:60)
- bicycle speed = 18 km/h (min:5 max:50)
- bicycle acceleration= 1 m/s2 (not editable yet)
- bicycle deceleration= 1 m/s2 (not editable yet)
- scale = 0 (available: 1:2000 - 1:10 000 and 0, 1, 2, 3 and half screen width)

Each junction, link and stop settings can be specified separately and edited in their own settings windows. Open these by clicking the junction number, link length and speed or tram stop flag.

Graphic settings define the visual effects of the wave graph as wave edges and the use of speed and timing figures and wave descriptions. You may edit these in Overall Settings Windows (Menu > Edit > Graphics).

Colour settings define the movement box colours common for all junctions. You may specify these at the end of the data file and edit in Overall Settings Windows (Menu > Edit > Colours). NOTE: Colour settings don't replace those colours separately specified for any movement in a single junction.


Browser shortcomings

- updated 1.7.2016

Chrome 51 works fine

Opera 36.0 seems to be OK

Firefox 43 is not suitable:
- doesn't close the menu
- doesn't drag movement green begin and green end
- doesn't change movement timings by steps in junction window

Safari 5.1.7 is not suitable:
- doesn't open and save the file

IE 11.0 doesn't work at all:
- does'n open and close the menu

.