Cube Update

User Interface
Components in Cube 6
2013 China User Conference
June 19 - 23
Heejoo Ham, Ph.D
Director of Technical Support
User Interface Components in Cube 6








Highway Network
Transit Network
Catalog & Scenario
Other Components
User Templates
Cube Geodatabase
Connecting Cube Models to Geodatabase
Editing Model Data in the GIS Window
Cube User Interface Components
- Highway Network
3
The Network Window



Displays a network and
other layers
− Transit
− Boundary
− Line shape
− Point Shape
− Drawing
− Image
Menu commands and
toolbar buttons
configure display
Settings are stored in a
VPR file
(Visual Project)
Network Toolbar & Core Function

Pointer (Shift+F7) – to select entities on the screen and pick menu
commands







Undo Last Edit Change (Shift+Z)
Zoom in / zoom out – draw a rectangle and re-size the view to match
bounds
Zoom all – resize to full extent
Previous view – step back through history
Pan – click and drag view to move while maintaining the same extent
Resize Plot page – to set a window view that matches the printed view
Center on Nodes – change view based upon user-specified nodes
− If a list of nodes, re-sizes and re-centers
− If a single node, prompts for new window width or magnification scaling
factor

Refresh Current View – refreshes the current window
Navigating the View








Legend – browse list of available map legends
Layer Control – opens the Layer Control dialog box
Select Top Layer – lists defined layers. Select a layer to move it to the
top and make it the current layer
Display Layer Information – providing information about the top layer
Browse Link Table – browse all link records in a spreadsheet-like
display
Browse Node Table – browse all node records in a spreadsheet-like
display
Bookmarks - Bookmarks allow you to save and restore network window
views for easy recall.
More Buttons – add or remove buttons
Layer Control

Overlay other data
above / below the
model network

Arrow buttons change
draw order

Top layer is focus of
display / edit tasks

Layer Properties:
detailed settings
Layer Parameters (Properties)





Base point and scale
relate layer to global
coordinates
Display = Scale * ((x,y) +
Base Point)
Default link and node
posting, color settings
Apply visibility / posting
by map scale
Link selection: only
display if an attribute
query is true
Display Layer Information
 Provides summary
statistics about
layer attributes (e.g.
nodes and links)
 Helpful for getting a
quick summary of a
variable’s range
 Copy to Clipboard
function can be
used with to paste
into a spreasheet
File > Options > NET/GIS > Network Window
 Distance calculation
 Search and display
sizes
 Default color and style
 Options/parameters
Layer Parameters > Link Posting






Post > All Links… or
Single Link…
Up to four labels can
be posted
Labels either take link
or fixed color
Round to nearest
(decimal precision)
Selection criteria
= < > ( ) | & ! ; etc.
(Voyager syntax)
− Tip: right-click for
attribute name list
16 named VPR sets
Changing Font Size for Link Post




Select ‘Customize Quick Access
Toolbar’
Click ‘Change the current
window’s font’
Select font size
Or, use ‘File > Options >General > Font’
Node Posting




Post > All Nodes… or
Single Node…
Very similar to link
posting selection
Useful for posting
zone numbers and
checking link edits
_ZONES = system
attribute giving highest
zone #
Link Color Specification







A stack of possibly
overlapping criteria
and style settings
Lower lines override
settings above
Insert, append, delete,
move lines
Use ; for comments
Fill from palette
Centerline offset
option (in pixels)
16 named VPR sets
Node Color Specification





Very similar to link
color specification
Useful to highlight
nodes by type
_CENTROID system
attribute = 1 if N <=
_ZONES
_JUNCTDATA system
attribute > 0 if
intersection is coded
at junction
16 named VPR sets
Boundary Layer Settings
2
3
1




Select zonal boundary layer
The “node color” button as an “area fill color”
tool for boundary files
Simple expressions can be combined to
create useful thematic maps
“Links” are equivalent to polygon shape border
lines for boundary layers
Log Files (1/2)
 Creating a new Log File
− Open Highway Network, select a link and split it (right click) or use Ribbon (below)
1
2
5
3
4
 Save your actions by using ‘Save Edit Log’ in Ribbon
Log Files (2/2)
 Save your actions using ‘Save Edit Log’
 Perform the saved actions for future scenarios using ‘Play Edit Log’
Building Paths using Path File (1/2)
 Open highway network
 Select ‘Network Tools >
Analysis > Add Path File’
 Open highway path file (*.pth)
Building Paths using Path File (2/2)
 Click ‘Display’ button
 Click ‘Save Path to File’
to save the searched
shortest paths
Select Link Analysis using Path File (1/2)
 Open highway network
 Select ‘Network Tools >
Analysis > Add Path File’
 Open highway path file (*.pth)
 Select ‘Selected Links’ in ‘Mode’
Select Link Analysis using Path File (2/2)
 Type selected links
 Click ‘Display’ button
 Click ‘Save Selected Matrix’ to save
it into the matrix
 Click ‘Save’ button
 Click ‘Save Selected Matrix to a
File’
Cube User Interface Components
- Transit Network
23
Transit Line Manager
 Open transit network
 Select ‘Network Tools > Post Transit
> Line Manager’
Transit Display Lines
Transit Stops/Non-Stops
Show Stop/Non-Stop Nodes
Transit Display Settings
Color
Color Palette
Transit Buffers – Stop
Transit Buffers – Link
Transit On/Off Bar
 Open loaded transit network
 Select ‘Home > Display
Line(s)’
 Select one transit line
 Select ‘Network Tools >
Transit > View Transit >
Transit On/Off Bars’
Transit Line Profile
 Open loaded transit network
 Select ‘Home > Display
Line(s)’
 Select one transit line
 Select ‘Network Tools >
Transit > View Transit >
Transit Line Profile’
Building Paths using Transit Route File (1/2)
 Open transit output
network
 Top layer should be
transit network
 Select ‘Network Tools
> Analysis > Add Path
File’
 Open transit route file
(*.rte)
Building Paths using Transit Route File (2/2)
 Click ‘Display’ button
Cube User Interface Components
- Catalog & Scenario
34
Scenario Manager

Merge – to allow data from one catalog to be merged into another.

Refresh – to update the catalog to reflect all changes made in text editors

Properties – to configure the catalog

Run – to open a dialog that allows you to review and modify the key values




for that scenario
Run Multiple – to launch a dialog to run a set of scenarios
Run Script – to run *.s script file
See Run Report – to allow you to review the results of the entire run
Add child – to add a child scenario to the Base scenario
Merging Catalogs (1/2)


To perform a merge, open the master catalog and select Merge from the
Scenario ribbon tab.
Select an appropriate catalog file.
Merging Catalogs (2/2)

The dialog allows specification of the applications, keys, and scenarios to
import via three tabs:
Catalog Properties


Click Properties on the Scenario ribbon tab
Or, choose File > Options > Catalogs tab > Catalog Properties
Scenario Manager Settings


Click the caption button for the Scenarios ribbon group, on the Scenario
ribbon tab
Or, choose File > Options > Catalogs tab > Scenario Settings
Changing Font Size for Docking Windows



Click ‘File > Options > Catalogs’
Click ‘Font’ button
Select font size
Cube User Interface Components
- Application
41
Application Information

Application Tools > Application
Options > Application Information
Application View

Screen Font - Selects a font to be
used for display and print respectively

Printer Font - The fonts displayed in
the font list are the fonts available on
the currently active printer

Show Legend - This command turns
on/off display of the legend

Hide Unused Files - Hides unused
files from the screen for all programs
Application Boxes

Color - This option produces a dialog for updating the default box color for input data,
output data, program, and group boxes.

Sizes - You can change the size of the program and file boxes manually.

File Names - Selecting this option displays the actual file nameson disk, instead of the
descriptive names shown in the file boxes.

Description and File Names - Displays both the descriptive (for example, “Network
File”) file names and the DOS file name (for example, “TENET00A.NET”).

Edited File Descriptions - Use this option to toggle the display of any edited file
descriptions on/off.

Control File Title - Displays the control data file title record above the control file box.
Application Tools (Home ribbon tab)

Process Templates - a hierarchical list of process templates available with core
Voyager programs

Auto Name Files - Creates file names based on the Project Group information

Create External Files - Copies external (public) files in currently opened project
group to new files. Application Manager will just create new empty output files.

Delete Output Files - Clears the contents of all output data files in current project
group and in all subgroups of current project group.

Add to Catalog Data - For applications that are part of a catalog, the selected file is
added to the data pane of the Scenario Manager pan.

Interactive Order Check - Toggles the interactive execution order checks on or off.

Redraw - Redraws the window.
How to add application group from the
other catalog (1/2)


Open an application in the other catalog
Select ‘Home > Group > Copy Group’ and then click ‘OK’


Choose directory
Click ‘Yes’ for ‘Copy data files as well?’
How to add application group from the
other catalog (2/2)




Open the current catalog
Go to any designated application to add new application
Select ‘Home > Group > Insert > Application Group’
Select the application copied from the other catalog and click ‘Open’
Cube User Interface Components
- Others
48
Node Charts
 Display node attributes on the map as pie/bar/stacked charts
 Network Tools > Analysis > Node/Point Chart
1
2
3
Sample Node Chart
Desire Lines (1/2)
 Open Highway Network and the desired Matrix file
 Link the Matrix file to the highway network (Network Tools > Analysis)
1
 Desire Lines option
gets enabled
2
3
4
Desire Lines (2/2)
5
 Enter the inputs as follows:
− Matrix Table (right click and select the type of
table from matrix table, e.g., Work Trips)
− Scale (Width of the desire lines)
6
− Origin – the origin zone
− Destination – set of all destination zones
 Select Display
Desired Lines from zone 1 to all the other
zones displayed
Coding Turn Penalty (1/2)
 Select a node, and click the ‘Turn Penalty File’ under ‘Network Tools
> Intersections > Turn Penalty File’
 Select an existing penalty file, or
create a new *.pen file
 Turn Penalties in Edit
Intersections gets
enabled. Click it.
Coding Turn Penalty (2/2)
 Turn Penalty in Cube is coded as:
− FromNode > ThroughNode > ToNode > Penalty Set

To Code penalties:
−
−
−

Right click to code ThroughNode to ToNode
Left click to code FromNode to ThroughNode
Or, click the appropriate box on right
Specify the values in the appropriate boxes
−
30 secs = 0.5; prohibited = -1
Penalty in Cost
Prohibited
Intersection View – Input Data (1/3)
 Open highway network
 Select ‘Network Tools >
Intersection Files > Input Data
File’
 Open input intersection data file
(*.ind)
Intersection View – Input Data (2/3)
 Click ‘Network Tools > Intersection
Settings > Post Intersections’
 Or, click ‘Home> Post Link > Post File >
Post Intersections’
Intersection View – Input Data (3/3)
 Select any junction node from highway network
 Click ‘Show Input Intersection Data’ button in ‘Highway Nodes’ panel
Intersection View – Output Data (1/3)
 Open highway network
 Select ‘Network Tools >
Intersection Files > Output File’
 Open output intersection data file
(*.int)
Intersection View – Output Data (2/3)
 Click ‘Network Tools > Intersection
Settings > Post Intersections’
 Or, click ‘Home> Post Link > Post File >
Post Intersections’
Intersection View – Output Data (3/3)
 Select any junction node from highway network
 Click ‘Show Output Intersection Data’ button in ‘Highway Nodes’ panel
True Shape Display
 Access from - Network Tools > GIS Tools > True Shape Display
Before
After
True Shape Display ON
Drawing / Screenline Layer




Contains view annotation
elements
− Symbol (e.g. shield)
− Line (simple)
− Polyline
− Polygon
− Image
− Screenline
Drawing > New Object…
to create
Use pointing mode to
position & resize
Save file when done
Create Highway Shield
1.
2.
3. Drawing/Screenline > New Object > Symbol
Legend Setup
File > Print > Page Setup
Print, Page and Legend Setup
1.
2.
3.
4. File > Print > Print Preview
User Templates
65
Creating User Templates
1. Open your user template script file in Cube base


Should contain ;;<<Process Template>>;;
Should contain ;;<<End Parameters>>;;
2. Go to File>>Tools>>User Templates…
3. Select ‘*** Add New Template ***’
4. Enter new template name
The new template file contents will be saved in the ‘user.tpl’ file. If you
already have an updated list of user templates in your current version of
Cube, please make a copy of this file available from
C:\Program Files (x86)\Citilabs\Cube (or)
C:\Program Files\ Citilabs\Cube
Install the new cube version and copy back the ‘user.tpl’ file to the original
location.
Running Module Templates
Module Templates can be accessed by the following means
 File>>Tools>>Process Templates…
 In Application Manager window
 In Text editor window
Example of User Templates (1/5)
 Creating user template script
Example of User Templates (2/5)
 Go to File>>Tools>>User Templates…
 Select ‘*** Add New Template ***’
 Enter new template name
Example of User Templates (3/5)
 Add Matrix module from Voyager ribbon
 Select newly added user template
Example of User Templates (4/5)
 Setting all input/output files and keys
 Or, modify the sets manually by clicking ‘Go To Editor’
Example of User Templates (5/5)
 Checking ‘User.Tpl’ file
Cube Geodatabase
73
New Data Manager Interface in 6.0



Manages Connections to Multiple
Geodatabases
Supports File and SDE Geodatabases
Supports Drag and Drop Management and
Manipulation
Anatomy of the Data Manager


Toolbar buttons – provide access to
commonly performed functions:
− Add Data – to add a geodatabase or
file folder to the workspace.
− Create Geodatabase – to create a new
file or personal geodatabase
− Refresh Workspaces – Refresh all
files and data currently shown in
Data Manager
− Import/Export Data – to import or
export data to or from a geodatabase
− Build Network From Shape – to build
a Cube network from a feature class
− Help — this help file
Workspace – lists established
connections to personal, file, and SDE
geodatabases & their contents
Auto Hide Button
Toolbar
Workspace
Workspace
Geodatabase Command Menu








New Dataset – Choose to add a new
feature data set to a geodatabase
New Feature Class – Create a new
feature class
New Table – Create a new table
Compact – Compacting a Personal or
File geodatabase
Build Network from Shape – Create a
new network feature data set from a
line shape file
Import, Export – Allow for the
conversion of all supported input data
types
Remove – Remove the currently
selected data
Validate Cube Geodatabase – Convert a
standard geodatabase to a Cubecompliant geodatabase
Feature Data Set Command Menu








Open Data – Display the map of the
feature data set
New Feature Class – Create a new
feature class
Import, Export – Allow for the
conversion of all supported input data
types
Copy – Copy the selected feature
dataset or network to the clipboard
Delete – Deletes the content from the
geodatabase
Rename – Change the name of the
feature dataset or network
Update Maximum Zones (#) – Opens a
dialog box for modifying the maximum
number of TAZ
Spatial Reference – Display the
spatial reference of the feature data
set
Open the Data Manager
Create a new geodatabase
1
3
2
Import data
Import Highway Network with True Shape
Import Transit Lines
Import Zonal Layer (TAZ.shp)
Import Junction Tables
Import dBase Table
Connecting Cube Models to
Geodatabase
•Integrating Geodatabases and GIS with Cube 6
87
Geodatabases in Model Catalogs



Cube provides two complementary ways to organize and store model
information:
− The Model Catalog
− The Geodatabase
The Model Catalog is a file that tracks the location and model function of other
files within the main (root level) model folder.
The Geodatabase is a file that acts as a container for any geographic data
that are used within the model and related maps.
− Inputs e.g. networks, zonal data, etc…
− Outputs e.g. networks, zonal data
− Map data e.g. roads, water features, boundaries
Link input networks
Output network with restored geometery
2
1
4
5
3
Make GDB outputs scenario-specific
1
3
2
Output transit assignment to GDB
FILEO LINEO = ...,
BASEGDBNETWORK
=
"Highway"
Editing Model Data
in the GIS Window
93
GIS Window Components
GIS
Toolbar
View
Switcher
Editing
Toolbar
Graphics
Toolbar
Table of
Contents
Data
View
Tips &
Messages
GIS Toolbar (1/2)
GIS Toolbar (2/2)
Graphics Toolbar (1/3)
Graphics Toolbar (2/3)
Graphics Toolbar (3/3)
Floating Toolbars – GIS Editor Sub-Toolbar
Floating Toolbars – GIS Layout Sub-Toolbar
Layout Toolbar
Thank you!
Any Questions?
Heejoo Ham – Citilabs
[email protected]