- 1 From 30.000 feet
- 2 Usage Description
- 3 Elements
- 3.1 Net elements
- 3.2 Additional elements
- 3.2.1 Move and references
- 3.2.2 Parameters
- 3.2.3 Additional sets
- 3.2.4 Help dialogs
- 3.2.5 Additional types
- 3.3 Route elements
- 4 Popup-Menu Functions
- 5 Usage Examples
From 30.000 feet
NETEDIT is a graphical network editor.
- Purpose: create and modify SUMO networks
- System: portable (Linux/Windows is tested); opens a window
- Input (optional): road network definitions to import
- Output: A generated SUMO-road network; optionally also other outputs
- Programming Language: c++
NETEDIT is a visual network editor. It can be used to create networks from scratch and to modify all aspects of existing networks. With a powerful selection and highlighting interface it can also be used to debug network attributes. NETEDIT is built on top of NETCONVERT. As a general rule of thumb, anything NETCONVERT can do, NETEDIT can do as well. NETEDIT has unlimited undo/redo capabilities and thus allows editing mistakes to be quickly corrected. Editing commands are generally issued with a left-click (according to the current edit mode. The user interface closely follows that of SUMO-GUI. Additional keyboard hotkeys are documented in the Help menu.
NETEDIT is a GUI-Application and inputs are chosen via menus. The following input formats are supported:
- SUMO-net files
- NETCONVERT-configuration files
- SUMO-net files
- plain-xml files
- <Button-Left>: Execute mode specific action
- <Button-Right>: Open context-menu
- <Button-Right-Drag>: Change zoom
- <Button-Left-Drag>: Move the view around (panning)
- in 'Move'-mode pointing at an edge: move or create geometry points
- in 'Move'-mode pointing at a node: move node
- in 'Move'-mode pointing at a selected object: move all selected nodes and edges including geometry. If both nodes of an edge are selected, move the whole geometry. Otherwise, move only the geometry near the cursor
- in 'Create Edge'-mode: clear the currently selected source junction
- in 'Select'-mode: clear the currently selection; cancel rectangle selection
- in 'Connect'-mode: deselect current lane and cancel all changes
- in 'Traffic Light'-mode: revert changes to current traffic light
- when editing a junction shape: abort editing the current junction shape
- <DELETE>: delete all currently selected items
- <SHIFT>: in 'Select'-mode: hold <SHIFT> and drag the mouse for rectangle selection
- <CTRL>: in 'Create Edge'-mode, allow moving the view without defining junctions
- in 'Inspect'-mode: confirm attribute changes
- in 'Connect'-mode: deselect current lane and save all changes
- in 'Traffic Light'-mode: save changes to current traffic light
- when editing a junction shape: save the current junction shape
Every edit mode can be selected with a hotkey. That hotkey is shown in front of the mode name. i.e. (i) Inspect has the hotkey i Pressing the hotkey for a mode when already in that mode toggles back to the previous mode.
In addition to these hotkeys, all hotkeys for moving and zooming in SUMO-GUI are supported.
Hint: Most menu commands are accessible via hotkey. The hotkey is shown right beside the command name.";
NETEDIT is controlled via various editing modes. This serves to reduce the number of clicks. For example, in delete mode a click on any object deletes it.
Inspect and modify attributes of edges, lanes and nodes. Modifications have to be confirmed by hitting <Enter>.
When inspecting an element that is selected along with multiple elements of the same type this move behaves differently:
- Only non-unique attributes are listed (i.e. lane-width but not lane-ID)
- If the elements differ in their attributes, the whole range of occurring values is shown
- All selected elements of the same type are modified at the same time when setting a new value
Create edges (and implicitly nodes)
Delete nodes (and all adjoining edges), single edges or geometry points.
Move nodes by dragging with the left mouse button. Dragging edges creates or moves geometry points. Dragging a node on top of another node joins them into a single node.
Modify lane-to-lane connections. The first click selects the source lane and following clicks toggle the status of target lanes.
Select network objects according to various criteria. Selected objects can be moved or deleted together. It is also possible to set attributes for all selected nodes (or all edges) at the same time using inspect mode.
The selection status of objects is toggled by left-clicking. When the select edges check-box is unset, lanes, ratherr than edges will be selected/deselected.
The Modification Mode changes how a loaded selection is applied to the current selection. It can either be added, replaced, subtracted or intersected.
The 'Match Attribute' controls allow to specify a set of objects by matching their attributes agains a given expression. When combining this set with the current selection, the Modificatiton Mode is also applied.
- Select an object type from the first input box
- Select an attribute from the second input box
- Enter a 'match expression' in the third input box and press <return>
- The empty expression matches all objects
- For numerical attributes the match expression must consist of a comparison operator ('<', '>', '=') and a number.
- the attribute matches if the comparison between its attribute and the given number by the given operator evaluates to 'true'
- For string attributes the match expression must consist of a comparison operator (, '=', '!', '^') and a string.
- (no operator) matches if string is a substring of that object'ts attribute.
- '=' matches if string is an exact match.
- '!' matches if string is not a substring.
- '^' matches if string is not an exact match.
- junction; id; 'foo' -> match all junctions that have 'foo' in their id
- edge; speed; '>10' -> match all edges with a speed above 10;
Set nodes to be controlled or uncontrolled by a traffic light. Edit all aspects of static signal plans. Visualizes a signal phase by coloring the controlled lane-to-lane connections according to the signal state. Editing signal states can be accomplished in either of the following ways:
- right-clicking one any controlled lane and picking a new state (color).
- right-clicking on any of the incoming lanes to change all controlled connections from that edge
- If the lane is currently selected, all connections from selected lanes incoming to the traffic light will be changed as well
- If the edge is currently selected, all connections from selected edges incoming to the traffic light will be changed as well
- If the check-box apply change to all phases is activated, all phases of the current plan will be affected
You can also change the state by editing the phase table directly.
Add additional elements to the net. Additionals can be placed over a lane or in a empty place of the map. See section "Additional elements" for more information.
Processing Menu Options
- Compute Junctions: recomputes the geometry and logic of all junctions. This is triggered automatically when entering nodes which require this information (Connect, Traffic Lights).
- Join Selected Junctions: joins the selected junctions into a single junction (See joining Nodes).
- Options: inspect and set all options. These are the same options that NETCONVERT accepts on the commandline or in a configuration.
Description of every element of netEdit
Additional are elements which not belong to the network, but they have influence on the simulation. Additionals are defined in a *.add.xml file, and can be loaded in netEdit. For create additional manually must be selected the netEdit mode Additionals (shortcut key: a). Once this mode is selected, the first step is to select in the comboBox "additional elmenet" what kind of additional will be created. Once selected and if required, the parameters of the additional should be changed. Finally, with a click over a Lane/node/edge (If the additional should be set over an element of net), or over an empty area (if the item is independent of the network) additional will be created.
Move and references
Additionals can be moved, but freedom of movement depends of their relation with the net. Additionals that must be located over a lane can only move along the lane, and additionals that are located on map can be move in any direction. The movement also depends if the item is locked or not (symbolized by a lock icon on the item). The movement can be blocked during the creation of the element, or changing the corresponding parameter with the inspector mode. Certain additionals haven a length contingent to the length of the lane. During creation can be selected three types of references for the length. If user want to create in a lane of length 100 a bus stop of lenght 20, and for that clicks over the position 50 of lane:
- Reference left: new busStop will be created from 30 to 50.
- Reference right: new busStop will be created from 50 to 70
- Reference center: new bus stop will be created from 40 to 60
There are two types of parameters for each additional: Own parameters and netEditparameters. Own parameters can be of type int, float, bool string, or list, and each has a default value. In the case of type list, user can add or remove values using the add or remove row buttons. In the case of the characteristic parameters of netEdit, these are the option to block the movement of an element, and in the case of the elements having a length, change the length and reference.
Additional sets are additionals that comprise or contain another additionals (Called childs) (For example, detectorE3 contains a list of detEntry and detExit). AdditionalSet are inserted in the same way as a Additional, but insertion of an additional child is different. Before insertion of an additional child in the map the id of the additionalSet parent must be selected in the list of Ids placed on the left frame. In these list appear only the Ids of additional sets which can be parents of the additional child (For example, if the user want to insert a detEntry, in the left list will appear only Ids of detectorE3). AdditionalSets and their childs are graphically connected by a yellow line.
With the help buttons placed in the left frame users can obtain information about additional and editor parameters (Full name, type and description).
Stopping places are sections of lanes, in which vehicles can stop during a certain time defined by user.
Bus stops are positions of lane in which vehicles ("busses") stop for a pre-given time. Bus stop haven a unique ID assigned automatically by netEdit, and a lenght and list of bus lines defined by user. See []
Surface defined over an lane in which the vehicles equipped with a battery are charged. Charging station own an unique-ID generated by netEdit, a length, a charging power defined in W, a charging efficiency, a switch for enable or disable charge in transit, and a charge delay. See []
Detectors are additionals wich save information about vehicles that passed over a certain position of lane.
Induction Loops Detectors (E1)
Own a ID parameter generated by netEdit, a position over certain lane, a freq attribute which describes the period over which collected values shall be aggregated and a file attribute which tells the simulation to which file the detector shall write his results into.
Lanearea Detectors (E2)
Most of the attributes have the same meaning as for induction loops, including automatic ID and position over certain lane. As an areal detector has a certain length, "length" must be supplied as a further parameter. It may be a negative number which lets the detector be extended upstream to the given beginning position. The optional parameter "cont" let's the detector continue over the current lane onto this lane's predecessors when the detector's length plus his position is larger than the place available on the lane. In constrast to the inductionLoop (E1-Detector), the E2-Detector covers an area instead of a cross section. The outputs are tailored for measuring queues of standing/jammed vehicles. However, there is less temporal precision in regard to entering/leaving (E1 has sub-second interpolation). The other parameters are timeThreshold, the time-based threshold that describes how much time has to pass until a vehicle is recognized as halting, speedThreshold, the speed-based threshold that describes how slow a vehicle has to be to be recognized as halting, and jamThreshold, the minimum distance to the next standing vehicle in order to make this vehicle count as a participant to the jam.
Multi-Entry Multi-Exit Detectors (E3)
An AdditionalSet with the same attributes as Induction Loop Detector E1. Detectors E3 haven as childs the Entry/Exit detectors.
Childs of AdditionalSet Multi-Entry Multi-Exit Detectors E3. This additionals only have the attributes ID of lane in which is placed and position over lane.
Edge and Lane
- Split edge here: Split an edge into two differentes edges connected with a junction.
- Split edge in both directions here: Is similar to Split edge here, but generate splitted edges in both directions.
- Reverse edge: Reverse the direction of an edge. If the ID of the start and end junctions of edge are respectively A and B, afer this operation start and end junction will be B and A.
- Add reverse direction: If don't exist, add a revere edge between two junctions
- Set geometry endpoint here: Create an geometry end point. It's usefull to mark the start and the end of an road
- Restore geometry endpoint: Restore a geometry endpoint to a normal edge
- Straighten edge: Allow to restore the visual shape of an edge
- Duplicate lane: duplicate a lane of an edge
- Set custom shape: Allows drawing a custom junction shape via a #Modifiable Poly (see below).
- Set custom shape: Apply this shape to the current junction
- Discard custom shape: Abort editing the current junction shape
- Simplify shape: Replace the current shape by a rectangle
- Remove geometry point: Remove the closest geometry point from the shape
The green polygon outline allows adding and moving geometry points by left-clicking anywhere on the outline and dragging.
Reducing the extent of the network
- switch to selection mode
- enable the auto-select nodes checkbox in the top menu bar
- select the portion of the network you wish to keep (i.e. by holding <SHIFT> and performing a rectangle-selection)
- invert the selection with the Invert button
- delete the inverted selection using the <DELETE> key
Specifying the complete geometry of an edge including endpoints
- switch to move mode
- create/move geometry points for that edge
- create new geometry points where the endpoints of the edge should be
- right-click on the new endpoints and select Set geometry endpoint here