4.3 Keyboard Map: RAPT User Manual RAPT User Manual
4.3 Keyboard Map: RAPT User Manual RAPT User Manual
view.
4.3 Keyboard Map
Select the previous tree node when the grid
For users who prefer to use keyboard instead of mouse, RAPT provides keyboard commands to do most of the
operations. Please note that the keyboard commands work only on the window that has input focus. Previous View Ctrl + Page Up view is in focus and open up the previous
grid view.
Grid keyboard commands
Output view keyboard commands
Command Keys Description
Repeat current cell value. A confirmation Command Keys Description
Repeat Ctrl + D box will popup if the repeat operation is If the current view is an individual text or
going to overwrite existing data. graphics output view, this command will
Repeat current cell value without user Next Checked Output open up the view for the next checked
Repeat without confirm Ctrl + R Ctrl + Page Down output item.
confirmation. Item
If the current view is the report view, this command
Right-click key or
Show the right-click menu (context menu) will jump to the next output item in the report view.
Context Menu Key
in a grid. The key looks like this:
(located close to If the current view is an individual text or
Show right-click menu the right Ctrl key in graphics output view, this command will
a Windows open up the view for the previous checked
compatible Previous Checked output item.
Ctrl + Page Up
keyboard) Report Item
If the current view is the report view, this command
Change cell to edit Change the current grid cell mode to edit will jump to the previous output item in the report
F2 view.
mode and select the contents of the current cell.
Exit edit mode Esc Exit edit mode, retaining previous data
Tree keyboard commands
Deselect cells Esc Deselect highlighted cells
Undo user input when data error occurs in Command Keys Description
Rollback error cell Esc
cell Gain focus Ctrl + Tab Switch focus from grid to tree
Accept cell value change and move to the Select the next tree node when the tree is in
Move to next cell Tab / Enter Next Node Down Arrow
next available cell. focus.
Highlight cells Shift + (any) Arrow Highlight a group of cells Select the previous tree node when the tree
Previous Node Up Arrow
Accept cell value change and move to the is in focus.
next cell to the left. In Edit mode, move one Expand the current node's sub-tree when
Move to left Left Arrow character to left. If at left end of data in cell, Expand Sub-tree Right Arrow
the tree is in focus.
accept cell value change and move to the
next cell to the left. Collapse the current node's sub-tree when
Collapse Sub-tree Left Arrow
the tree is in focus.
Accept cell value change and move to the
next cell to the right. In Edit mode, move Toggle check box Space Check/Uncheck a tree node's check box.
Move to right Right Arrow one character to right. If at right end of Show/Hide tree Ctrl + T Show/Hide all the trees.
data in cell, accept cell value change and
move to the next cell to the right. Graphic view keyboard commands
Accept cell value change and move to cell
Move up Up Arrow Command Keys Description
above.
Show Next Item Ctrl + Right Arrow Move to next item (span)
Accept cell value change and move to cell
Move down Down Arrow Show Previous Item Ctrl + Left Arrow Move to previous item (span)
below.
Accept cell value change and move to the Show Next Point Shift + Right Arrow Move to next point
Move to left most Home
left most cell Show Previous Point Shift + Left Arrow Move to previous point
Accept cell value change and move to the Show/Hide Info Dialog Ctrl + I Show/Hide information dialog
Move to right most End
right most cell
Toggle Zoom Ctrl + M Zoom in/Zoom out of the graphic view
Dropdown dropdown Dropdown the list of current cell in a
Space
list dropdown list cell Menu / Toolbar keyboard commands
Select next control row Ctrl + Down Arrow Select next control row while in child grid
Command Keys Description
Select previous control Select previous control row while in child
Ctrl + Up Arrow New file Ctrl + N Create a new RAPT file
row grid
Open file Ctrl + O Open a RAPT file
Select the next tree node when the grid
Next View Ctrl + Page Down Save file Ctrl + S Save the current RAPT file
view is in focus and open up the next grid
4.3 User Interface: Keyboard Map 1 4.3 User Interface: Keyboard Map 2
RAPT User Manual Copyright PCDC RAPT User Manual Copyright PCDC
Boolean Cell ( y / n )
Boolean cells accept only a Yes/No answer. No characters are allowed to be input. Values can be changed by clicking
with the left mouse button or by pressing the Space Bar.
4.3 User Interface: Keyboard Map 3 4.4 User Interface: Data Entry 1
RAPT User Manual Copyright PCDC RAPT User Manual Copyright PCDC
If the user only wants to move the current cell to a Boolean cell without modifying the cell value, use keyboard
4.4.2 Cell Editing and Navigation movement keys instead of mouse click.
When the data in a cell is modified, RAPT will check to see whether this modification will affect other data in this data
file and will make modifications as it thinks appropriate these changes will be 4.4.7 coloured blue in the data to
indicate to the user which data has been changed automatically. If the same value is entered into a cell as was there
before the edit was commenced, RAPT will not accept this as a data modification and no checking or modification of
the data will be done.
1. Left Mouse Click on the cell. The cell will go into Overtype Mode.
2. Double Left Mouse Click on the cell. If the mouse pointer is within the length of the data in the cell, eg
, the cell will immediately go into Edit Mode and place the cursor at that point in the data string. If
the mouse click is to the left of the data by more than 1 character, eg , the cell will go into Overtype
Mode.
3. the Arrow keys - move in the arrow direction and wrap around on same row/column of data at ends of grid.
The cell is selected in Overtype Mode.
4. the Tab key - accept modifications to the data in the current cell and move focus to the next cell to right and
wrap around at right end to first column in next row. The cell is selected in Overtype Mode.
5. the Enter/Return key - accept modifications to the data in the current cell and move focus to the next to
right and wrap around at right end to first column in next row. The cell is selected in Overtype Mode.
Note:-
1 When using the keyboard, the user has to make sure the grid has input focus first before keystrokes will be
effective in that grid. If the grid is not in focus, click the grid window area once to gain input focus.
2 A range of cell content can be deleted by pressing the Del key after the range has been 4.4.3 selected. Selecting a
whole row or column by selecting the header cell and pressing Del won't delete the whole row or column, nor will it
delete the row or column content. Nothing will happen to the selected data. The user has to use the relevant toolbar
buttons or right-click pop-up menus to delete rows/columns of data that have been added. Sometimes, row/column
insertion or deletion cannot be done until the user specifically selects the row/column (see specific Input Screen
chapters).
If the user only wants to move the current cell to a Dropdown list cell without causing the list to dropdown, use the
keyboard movement keys to move the current cell.
4.4.2 User Interface: Cell Editing and Navigation 1 4.4.2 User Interface: Cell Editing and Navigation 2
RAPT User Manual Copyright PCDC RAPT User Manual Copyright PCDC
To select a continuous area, the user can left click a cell and move to another cell while holding the left mouse button.
Using the keyboard, this can be done by holding the Shift key and pressing one of the arrow keys. The Cell Selection
will not work if the first cell is in Edit Mode (press Esc to change the cell mode from Edit mode to Select mode). To 1. pressing button in the toolbar
select non-continuous areas, hold the Ctrl key while clicking different cells or dragging through cells. 2. clicking Tools->Repeat menu or press Ctrl + D key
3. clicking Tools->Repeat without confirm menu or press Ctrl + R key
4. clicking the right mouse button in the data cell containing the source data to repeat and select Repeat Cell
Data
Repeating can only be done with cells of the same type (for example: Length Cells).
Cell repeating works in different ways depending on the user requirements. These are
The user can change the current cell within the selected range by pressing one of the arrow keys. Just make sure the
current cell does not go beyond the current selection, otherwise, the selection will be cancelled. Using a movement key If method 1 ( ), 2 (Ctrl + D) or 4 above is used RAPT will ask for confirmation whether to replace the
at the end of its row/column forcing a wrap-around to the other end of the row/column is equivalent to going outside value in that cell or not (see below). The user can select to skip the over-write of data in that cell (Cancel),
the selected area and the cell Selection will be lost even if all cells in the row/column are selected. over-write the data in the cell with the new value (Yes) or over-write the data in all further cells with the new
To select Dropdown list cells, it is recommended to use the keyboard as this will not drop down the list of options after value (Yes to All).
selection (press Esc to hide the list). It is also recommended to use the keyboard to select Boolean cells (y/n) as
clicking a Boolean cell will immediately inverse its value. 2. If method 3 above (Ctrl + R) is used, no confirmation will be asked for.
If a cell that is to be replaced does not contain a value (zero), in some special cases in various input screens a logical
copy is performed from associated data already input e.g. column height below would be set to column height above.
See the description in the help for each individual input screen for the special cases where this applies.
Dropdown list cells and Boolean cells can also be repeated. The tips of selecting a range of Dropdown list cells or
Booleans cells can be found in 4.4.3 Cell Selection.
If a validation error occurs at a cell, the repeat process will stop at that cell with an Error Coloured Cell (Red
background) and all selected cells after this cell will not be modified. It is then up to the user to fix the data in the
error cell until it is acceptable and then select any other cells that are to be changed and repeat the data into them as
above.
4.4.3 User Interface: Cell Selection 1 4.4.4 User Interface: Cell Repeating 1
RAPT User Manual Copyright PCDC RAPT User Manual Copyright PCDC
OK, 38.1 mm (which is 1 1/2 COS(X) This function returns the cosine of X in radians.
1 1/2 OK, 1 1/2 inches OK, 1 1/2 inches
inches) DEGREES(X) Returns the value in degrees. X: radian value
OK, 38.1 mm (which is 1 1/2 Returns e raised to the power specified by the argument, where e is the
1 1/2" OK, 1 1/2 inches OK, 1 1/2 inches EXP(X)
inches) base of the natural log 2.71828183.
Wrong, missing foot Wrong, missing foot Returns the log base e of X, where e is the base of the natural log
1-1/2" Wrong, missing foot symbol LN(X)
symbol symbol 2.71828183.
OK, 317.5 mm (which is 1'-
1'-1/2" OK, 1 foot and half inch OK, 12 and a half inches LOG(X) Returns the log base 10 of X.
1/2")
1' 1 LOG2(X) Returns the log base 2 of X.
OK, 1'-1 1/2" OK, 13 inches and a half OK, 342.9 mm
1/2" RADIANS(X) Returns the value in radians where X is the degree value.
1 1 1/2 OK, 1'-1 1/2" OK, 13 inches and a half OK, 342.9 mm
Returns X rounded to the number of decimal places specified by N (when N
ROUND(X, N)
is positive); it returns X rounded to a whole number when N is negative.
SIN(X) This function returns the sine X in radians.
SQRT(X) Returns the positive square root of X.
TAN(X) This function returns the tangent of X in radians.
X^Y Returns X to the power of Y
X**Y Returns X to the power of Y
Examples:
4.4.5 User Interface: Imperial Length 1 4.4.6 User Interface: Cell Formula Input 1
RAPT User Manual Copyright PCDC RAPT User Manual Copyright PCDC
Formula Restrictions:
1. Formulae do not accept reference cell values. For example, adding cell value from row1, column2 and 4.4.7 Cell Colours
row2, column2 together into row3, column 2 is not possible.
2. Formulae are not remembered by each cell. Only the calculated result is remembered. The grid cells are sometimes given different background colours to indicate their different states.
3. Although the user can use foot-inch format in a formula in any Length cell, sometimes they cannot be
Data changed automatically by RAPT:
distinguished from the other numbers and operators. It is recommended not to omit the foot and inch
symbols in formulae and to put brackets around feet-inches values.
Sometimes editing one cell value or inserting data will cause RAPT to automatically change other dependant values in
other cells in the grid or in other grids. The values changed by RAPT will be shown in light blue background like this
. Any previous blue marked cells will be shown in a darker blue background like this . The
corresponding tree node will change to blue as well. The blue cell colours are to indicate to the user that automatic
changes have been made in the background. Sometimes the calculation of these changes will have required
interpretation by RAPT and the solution it chooses may not be the one preferred by the user. The user should check all
changes made by RAPT to make sure they are acceptable.
To remove the blue colour from a cell (the tree colours will automatically clear when the associated grids are clear),
1 Modify the data in a cell. This indicates to RAPT that the user has looked at the cell and that cell colour is cleared.
2 Use the Right mouse button in the coloured cell or select the Clear Cell Colours Toolbar Button
. Various options will be presented for clearing cell colours in both cases. These are
Remember that these colours have been added to show you what has been changed in the background in your data.
Make sure you check the changes before clearing all of the cell colours.
Error value:
When a cell input is invalid, the cell background will be changed to red like this . The corresponding tree node
will change to red as well. To clear the colour, the user must input an acceptable value, or press Esc to return to the
previous value in the cell. No other cells can be edited until this error is cleared. This type of error checking is only
done in cases where an incorrect value will cause problems in the background input calculations or in the drawing of
the graphics. All other checking is only done on user request or when the calculations are requested.
4.4.6 User Interface: Cell Formula Input 2 4.4.7 User Interface: Cell Colours 1
RAPT User Manual Copyright PCDC RAPT User Manual Copyright PCDC
Current Control Row:
In situations where two views have parent-child relationship, the content of the child view depends on the current 4.5 Screen Layout
control row of the parent view. A high-light colour is used to indicate the current control row. The current
control row in a grid automatically moves to the row containing a selected cell so changing rows with the mouse or
arrow keys will make the new row the current control row. The only time a new control row will not be selected is
4.5.1 General Screen Layout Principles
when a group of rows is selected with the mouse.
In the above case, Prestress row number 3 (with row header 2 C) in the top data grid is the control row for Drape
Locations in the centre grid: so the drape locations data shown is for tendon 2 column strip (row 3). Drape Locations
row number 2 is the control row for prestress graphics so the coloured span in the graphics is for span 2 (row 2) of
tendon 2 column strip.
We will use the Load Cases screen to give an overview of the general screen layout principles used in RAPT. Most of
the concepts used are standard Windows interface concepts and we will not go into detailed explanation on how these
work.
The overall RAPT screen is divided into several windows with different functionality as explained below. The size and
shape of the various windows can be adjusted by moving the mouse cursor over the boundary between two windows
until the cursor changes to one of the following symbols . Then depress the left mouse button and drag the
window border in the direction of the arrows in the cursor to the location desired on the screen. In some cases e.g.
frame shape graphics with section views, the section view windows will automatically adjust in size when the frame
shape window is adjusted.
A window with a gripper at one edge can be moved to different positions on the screen to suit the user and can be
undocked from the current position either by double clicking on the gripper or by selecting and dragging the gripper to
another location. Double clicking on an undocked window will re-dock it in its previous position. Moving it by selecting
and dragging the gripper will also re-dock the window at an edge when the mouse reaches the edge of the RAPT
screen space.
Menu Bar
RAPT uses a standard Windows style menu bar that users can use to access specific functionality of RAPT. This can be
accessed with the left mouse button of Alt + Letter from the keyboard.
Status Bar
RAPT uses a standard Status bar. Tool Tip information is repeated on the left of the status bar and is often more
detailed that the Tool Tip information.
4.4.7 User Interface: Cell Colours 2 4.5 User Interface: Screen Layout 1
RAPT User Manual Copyright PCDC
Toolbars
RAPT does not use a single toolbar which is available at all times. Instead, each window has it's own toolbar for
operations within that window only. This saves users from the situation of having enormous toolbars which waste a
large amount of screen area and are difficult to navigate. A General Toolbar is provided at the left of the toolbar row
which controls the standard functionality common to all windows such as edit, view, printing etc. As well, where
needed, extra toolbars will be added to the right of the general toolbar. In the case shown above, with computer focus
in the Frame Graphics Window, the Frame Graphics Window Toolbar is available for operations in the graphics
window. If focus was in the Control Grid Window, the Control Grid Toolbar would be available, etc.
To make the toolbar for a window available, move focus to that window by clicking the left or right mouse button
somewhere within that window area.
See discussion on each area of data for information on specific toolbars.
Control Tree
Access to different areas of data is controlled from the Control Tree. In the case shown above, the tree has 3 Control
Tree Tabs which give access to different types of data,
1. Input data,
2. Materials data
3. Output Results data.
Within each Tab, the user can select different areas (pages) of data to view.
The Tree is a branch structure of data contained in Folders, Sub-Folders etc to the bottom level which are Pages.
Folders are represented by when they are closed. When clicked on, they open, shown thus , to admit access to
Sub-Folders and eventually to Pages represented by which simply contain data (or may perform an operation e.g.
Report in Output). A folder normally will simply allow access to sub-folders or pages within it but, in special
cases, may open a window with it's own data which is related to the data in the Sub-Folders and pages it contains,
e.g. Materials->Prestress Strand contains the strand size data and the sub-folders and pages have tendon and
anchorage data for each strand size.
A folder may be opened or closed by left mouse click on the + or - to the left of the folder or by double clicking on the
folder name or by using the Right Arrow key (open) or Left Arrow key (close).
A page may be opened by a single left mouse click on the name or by using the Enter key. Program focus will
immediately move from the Tree to the Data Window that has been opened.
The tree can be traversed using the Up Arrow, Down Arrow, Page Up and Page Down keys. Also, the first character of
a Folder or Page name can be used. Pressing the same character a second time will move to the next instance of that
character starting a name.
If program focus is in a Data or Graphics Window, Ctrl + Tab can be used to move focus to the tree where the normal
key strokes can then be used to move to and select a new page of data to view.
Data Windows
Data is presented in Grids which are in separate windows on the screen.
In the simplest form, a tree page will open one data window with a single grid of data in it. In this form there is only
one set of the data, e.g. 7.2.3.1 Spans Data where there is a single grid of data for all of the spans in the frame.
As the data becomes more complex, there is often a requirement for multiple sets of the same type of data which
cannot be placed in a single grid of data. The Load Cases Data shown above is a good example of this. For each load
case, the user can define the loading in different ways e.g. as a series of applied loads or as a set of bending moment
and shear diagrams. Also, for each load case defined as a series of applied loads, different types of loads can be
defined e.g. line loads, panel loads, point loads etc.
To handle this type of situation, RAPT has introduced the concept of Control (or Parent) Data Windows and Child
Data Windows. The Control Data nominates the number of instances of the Child Data that exist and also any
general data that applies for that instance of the Child Data. In the Load Cases data shown above, the Control Data
contains a grid of data that provides an individual row for each load case, Self Weight, Live load etc. This includes data
about the load case including the load case type, load definition type and a description of the load case. For each row
in the control grid (for each load case) there is a set of data defining the loads in that load case. This data is shown in
the Child Data Window. Only one Child Data Window can be viewed at one time, for the currently selected Load Case
in the Control Grid. This Child Window can have as many loads as the user wishes to define to make up the complete
load case.
To change focus to the other window and it's current cell, simply click the left or right mouse button inside the
boundary of the that window. The current cell for editing will immediately change and the toolbar for that window will
replace the previous toolbar.
One row in the Control Grid must always be selected and this is the Control Row. The background of the Control
Row for which the data is being shown in the Child Window is coloured yellow. Different control rows can be selected
using the mouse of the cursor keys when the control grid is in focus.
Grid Tabs
In cases where multiple data types are associated with a single Control Row, RAPT uses Grid Tabs to provide several
screens of data in the one window. This is shown in the Child Data above where there are separate sets of data for
each load type of applied load, Line Load, Panel Load, Area Load, Point Load, Point Moment. Select a tab with the
mouse to view the data in the grid for that load type and also to gain access to the toolbar associated with that data.
In this case, the number of applied loads defined in load a type is also printed in the Tab associated with that load type
along with the name.