Navigatorgui
The Carmen Navigator GUI
The CARMEN Navigator GUI is a graphic user interface which allows a user to
- set goal locations for the robot
- monitor the location of the robot
- monitor some of what the robot senses
- monitor some of the program belief states.
Starting navigatorgui is described on the Running Carmen page. This page is presented to further explain the functions of the program.
Once started properly, the user interface appears as below.
In the status box, the robot position is indicated in meters from the lower left corner of the map, (horizontal, vertical) and then degrees from 3 O'Clock facing, counterclockwise being positive. (The standard, right-handed co-ordinate system.)
The current robot goal is also indicated this way, but without facing component.
The computer cursor position (for the computer you are displaying on) is measured in grid cells from the lower left of the map.
Value indicates the likelihood that the grid cell under the cursor is occupied, according to the map file. A value of 1.00 indicates that cell is sure to be occupied. Negative values indicate unmapped regions (no data).
Clicking the "Autonomous" bar will cause the robot to move toward its goal, or stop it if it is already moving. Clicking on the map display will set a new goal, overiding any old goal, only of "Autonomous" is inactive (the robot is not moving).
It is possible to gove the robot a goal it cannot reach. Should you do that, no indicated path will appear between the robot and the goal, as below.
The "Zoom" slider at the bottom of the display allows users to zoom in or out on the map for more detail or more area. The slider bars to the right of and below the map allow users to shift the section of the map being displayed.
The menus "Start Location" and "Goals" allow you to select starting locations for the robot or robot goals that are built into map files. Adding or deleting locations is described in the Using the Map Editor page. Another way to place the robot is to right-click on a position in the display. This will change the robot's perceived location; any paths planned by Navigator will be based on this position, not the actual position of the real or simulated robot. Another way to set a goal is to left-click a place on the map.
The "File" menu option allows you to save a display image to a .png file. this will only save what is between the slide bars, it will not save the whole map (unless the display is fully zoomed out), nore will it save the status box. The file will appear in the directory from which navigatorgui is running, with a filename [mapfile].map#.png, where [mapfile] is the name of the mapfile in use, and # is the number of times previously a screen has been saved.
The "Show" and "Robot Display" menus are described below. Note that under the "Show" menu, the options of "Map", "Utility" and "Cost" are mutually exclusive; the display can only show one of these options at a time.
The "Show" Menu
Option Image Function Description People Clicking "People" will indicate umapped objects which the people tracker thinks are people on the map as green dots. Map "Map" is the default starting display; it shows the robot location in red, goal location in yellow, planned path as a blue line with subgoals as x's along that line, open space as white regions, occupied space as black regions, and unmapped space as blue regions. Grey areas are uncertain regions, darker areas indicate regions that are more likely to be occupied than lighter regions. Utility Selecting "Utility" shows a grey level which gets whiter closer to the indicated goal. "Utility" is the value function of the dynamic program inversely proportional to the time the robot can expect to take to reach a goal from a given point. Dark areas indicate low utility, light areas indicate higher utility, and the robot should always attempt to move from dark to light. Utility does not update with a new goal, because sending the utility across the net can be a high bandwidth operation. To update the utility display, re-select "Utility" from the menu. Costs Selecting "Costs" shows darker regions near occupied spaces and lighter regions in empty space. "Cost" is an arbitrary value relating to the maximum speed which the robot can use to safely transverse a region. Darker areas indicate high cost, indicating the robot must move slowly. The planner will move the robot through the lowest cumulative cost path to reach the goal.
The Robot Display Menu
Option Image Function Description Track Robot If the display is zoomed in, the GUI will try and keep the robot centered in the display when track robot is checked. Otherwise, the robot may end up off the screen. Show Particles Rather than monitor a single location for the robot (which may be wrong), localize maintains a probability distribution over the robot's position. Selecting "Show Particles" replaces the red robot indicator with dots (particles) drawn from that distribution. Dense areas (with many particles) are regions of high probability. Show Gaussians Selecting "Show Gaussians" indicates the same probability described above as a gaussian (normal probability distribution) in x and y. Show Laser Data Selecting "Show Laser Data" plots laser data relative to the robots indicated (most probable) location. Blue data points indicate data that correlates with objects on the map, red data points indicate discrepancies: unmapped objects, erronious readings, or mismatch between likely and actual location. Show Simulator True Position Selecting "Show Simulator True Position" displays the simulated robot's "true" positon in blue, only if the simulator is in use.
