railOscope by trafIT solutions

Topo Editor


  • Dragging the surface changes the displayed area.
  • Use the mouse-wheel to zoom in or out at a certain location.
  • Press to show all elements.
  • Double-clicking the surface zooms to that location.
  • Double-clicking with shift pressed zooms out.
  • Press alt++ to zoom in, alt+- to zoom out and alt+0 to show all.
Undo / Redo / Save
  • Press ctrl+z to undo the last change.
  • Press ctrl+y to redo a previously undone change.
  • Press ctrl+s to save the current state to the server.
  • An asterisk symbol next to the model title shows that there are unsaved modifications.
  • Saving is allowed only for the latest version and if the user has enough access rights.
  • When trying to leave the page with unsaved changes, a warning is shown.
  • The cloud in the upper right corner shows the connection status: ☁︎ connected, ☁︎ offline.
  • If disconnected, the application tries to reconnect automatically.
  • If disconnected, work can continue normally. However changes can only be saved again when a connection is re-established.
  • If connected, changes by other users to the same model are reflected immediately.
  • However, concurrent work can be dangerous (e.g. one user deletes an element the other user just built upon). Please use concurrency with care.
Layers, Renderers
  • Hitting T displays the topology and kilometration info.
  • Hitting L shows the lengths layer.
  • Hitting M shows the mileage layer.
  • Each element type has its own layer. These layers can be made (in-)visible in the Layers-Dropdown-Menu.
  • An option to hide or show all layers is available.
  • The rendering of the topology can be changed with the Display-Dropdown-Menu.
  • The Standard renderer is optimised for editing the model.
  • The other renderers are optimised for their respective use cases. For example, they contain more detailed signal symbols depending on their ruleCode.
  • Clicking the Standard (current layers)-Item will switch to the standard-view (rendering) without changing the activated layers.
  • The area of all selected stations is shown with a yellow background.
Grid, Drawing Size
  • The drawing has no strict border, it can be extended on all sides.
  • All elements with screen coordinates (OCP, EdgePoint) are rounded to the grid (10 internal units)
  • Other elements are interpolated.
  • If the data was imported from another tool, it can be rounded to the grid with
  • We recommend a distance of 30 internal units (3 grid points) between parallel tracks for good results.
Drawing Topology
  • To draw edges, switch to the Topo-Mode ( or press F11)
  • Clicking at an empty location starts a new edge. Move the mouse to the intended end and click again to finish the edge.
  • While moving the mouse, the angle, the current coordinates and the pos value (on an edge) are displayed.
  • Hit Escape to end the edge sequence.
  • A new edge can be started on an existing edge creating a switch.
  • Crossings can have as many edges as desired.
  • Drivability is determined by the angle between the two edges.
  • To create indirect connections, select both topoPoints that you want to connect, and connect them in the inspector
  • To delete indirect connections, select it and change the indirect value to false. It will then become a direct (ordinary) connection.
Selecting and Moving
  • To switch to selection mode, hit or press F10.
  • Elements are selected by clicking them.
  • Clicking in an empty area clears the selection.
  • Clicking with ctrl adds to / removes from the selection (toggle).
  • When clicking with ctrl in an empty area, a capture rectangle is opened for selecting elements within. Elements of inactive layers are selected, too. Routes, trackSections and areas are included in this selection, if all of their signals/borders are selected.
  • Hitting delete deletes the selected elements.
  • Press ctrl+a to select all elements (even those of unselected layers).
  • If one or more edges are selected, hitting toggles selection of elements on the edge(s).
  • The selection (also several elements) can be dragged by mouse to a new location.
  • Selected track elements can be moved along the edge using the cursor-up and cursor-down key.
  • Selected edges and OCPs can be moved using the cursor-up, cursor-down, cursor-left and cursor-right keys. The step is 1 grid unit.
  • Additionally, hit shift, ctrl or alt key for small, large, huge steps.
  • If two elements are selected, the shortest path between them is highlighted in orange. Average speed(s) and gradient is calculated and indicated in the Inspector.
  • EdgePoints can be dragged away from their TopoElement or dragged onto other elements.
  • TopoElements can be dragged, moving all of their EdgePoints with them.
  • TopoElements can only be deleted if they have at most two edges. Remove EdgePoints first in order to delete the TopoElement.
  • If a TopoElement with two edges is deleted, the edges are merged. This may cause the elements to jump if the scales on the edges have not been the same.
Copy and paste
  • Press ctrl+c to copy the selection to the clipboard.
  • Press ctrl+x to cut the selection to the clipboard.
  • Press ctrl+v to paste the clipboard.
    • If an edge is selected during paste: all track elements are pasted on that edge
    • Otherwise all OCPs and Edges (with their elements) are pasted on the surface
    • The kilometration is not copied to allow an easy relocation
    • When copying signals or border-elements of a trackSection / area, their routes or trackSections / areas are copied as well. They might be broken afterwards if referenced objects are not copied as well.
  • Press ctrl+Insert to paste the last copied clipboard of any other model in another browser window. (References to objects outside the clipboard are removed.)
  • During cut or copy, the mouse location is stored as reference point.
  • Place the mouse cursor to where the elements should be inserted. They are inserted relative to the mouse location.
  • EdgePoints' colors show whether they have kilometration (white) or not (orange, "kinks").
  • TopoElements are colored according to the kilometration of the EdgePoints: none, one, partial, multiple.
  • Edges for which the length does not correspond to the kilometration of their EdgePoints, are colored in orange.
  • Select an EdgePoint of an inconsistent edge and hit km → len or len → km to make the edge consistent again.
  • Pos-values have one position after decimal point, km-values have none (they are defined in meters).
  • Kinks can be created by inserting an edgePoint onto an edge.
  • If a new edge is drawn from a kink, it is converted to a switch.
  • Kinks have no attributes, as their only purpose is to fix the drawn course of a track.
  • An edgePoint can be manually converted to a kink (and vice-versa) by clicking the TK-button in the Inspector.
  • If one or more elements are selected, the inspector is opened.
  • The common attributes of the selection can be edited at once.
  • If one track element is selected, the gradient and speed at that location in direction of the element are shown.
  • If two track elements are selected, the distance, average gradient and average speed between them is shown.
  • If several elements are selected, the elements are listed in the inspector. Clicking on a x removes an object from the selection. Clicking on an object selects this object only.
  • If elements of different types are selected, the elements are grouped by their type. The elements of each type are listed but the list might be collapsed in. Click on a x to deselect all elements of a certain type.
  • Press OK to save the changes, or Cancel to discard the changes.
  • The Expert Mode shows additional information and attributes. It can be toggled on/off with the Expert Button.