Mudanças entre as edições de "Editing and creating"

De LCAD
Ir para: navegação, pesquisa
(New page: Introduction The Carmen Map Editor allows for manually modifying the maps created with Vasco, or draw entirely new maps. It will enable you to add or remove place names or mark areas as o...)
 
 
(2 revisões intermediárias por um outro usuário não estão sendo mostradas)
Linha 1: Linha 1:
Introduction
+
[[category:Carmen]]
 +
==Introduction==
  
 
The Carmen Map Editor allows for manually modifying the maps created with Vasco, or draw entirely new maps. It will enable you to add or remove place names or mark areas as off limits to the robot in addition to modifying the objects, walls, and free space within the map.
 
The Carmen Map Editor allows for manually modifying the maps created with Vasco, or draw entirely new maps. It will enable you to add or remove place names or mark areas as off limits to the robot in addition to modifying the objects, walls, and free space within the map.
Linha 5: Linha 6:
 
Using the map editor is similar to using many standard graphics and drawing programs, except that the colors represent probabilities that a particular point is occupied. White implies low probability of ocupation, as it shifts through grey to black, it implies greater probability of a grid cell being occupied. Blue areas are unknown; there is no data available to assign a probability. Red areas represent "off limits" areas, where the robot should not go, whether or not it *can* go there. (This can be very important for keeping the robot away from stairwells and other dangers it cannot detect.)
 
Using the map editor is similar to using many standard graphics and drawing programs, except that the colors represent probabilities that a particular point is occupied. White implies low probability of ocupation, as it shifts through grey to black, it implies greater probability of a grid cell being occupied. Blue areas are unknown; there is no data available to assign a probability. Red areas represent "off limits" areas, where the robot should not go, whether or not it *can* go there. (This can be very important for keeping the robot away from stairwells and other dangers it cannot detect.)
  
Editor Controls
+
==Editor Controls==
  
 
On opening the map_editor program, you see a control panel like this:
 
On opening the map_editor program, you see a control panel like this:
  
Menus
+
[[imagem:map_editor1.gif]]
  
File Menu
+
===Menus===
 +
 
 +
====File Menu====
 
New Map (also CNTL-N) allows you to create a new map. Choosing this will cause a dialog box to appear, asking for the map size and resolution.
 
New Map (also CNTL-N) allows you to create a new map. Choosing this will cause a dialog box to appear, asking for the map size and resolution.
 +
 +
[[imagem:map_editor2.gif]]
  
 
Width and Height are in "grid cells," and Resolution is the size (in meters) of each cell. Since the brush and line size is in grid cells, resolution here can be very important.
 
Width and Height are in "grid cells," and Resolution is the size (in meters) of each cell. Since the brush and line size is in grid cells, resolution here can be very important.
  
 +
[[imagem:map_editor3.gif]]
  
 
Open Map (also CNTL-O -or- as a command option when starting: "./map_editor mapname.map") will open a previously generated map.
 
Open Map (also CNTL-O -or- as a command option when starting: "./map_editor mapname.map") will open a previously generated map.
 +
 +
[[imagem:map_editor4.gif]]
  
 
Save Map (also CNTL-S) will save a previously saved map under the same name.
 
Save Map (also CNTL-S) will save a previously saved map under the same name.
Linha 23: Linha 31:
 
Export is not implemented with this release.
 
Export is not implemented with this release.
 
Quit (also CNTL-Q) will exit the program.
 
Quit (also CNTL-Q) will exit the program.
Edit Menu
+
====Edit Menu====
 
Undo (also CNTL-Z) will undo only the most recent action.
 
Undo (also CNTL-Z) will undo only the most recent action.
 
Add Placename is not implemented in this version. To add a placename, run the map_add_place program as follows:
 
Add Placename is not implemented in this version. To add a placename, run the map_add_place program as follows:
./map_add_place mapfilename placename [place params]
+
  ./map_add_place mapfilename placename [place params]
  
 
2, 3, or 6 place parameters can be given.
 
2, 3, or 6 place parameters can be given.
Linha 37: Linha 45:
  
 
Delete Placename will remove a placename from the map. Simply click on the placename dot after selecting Delete Placename from the menu.
 
Delete Placename will remove a placename from the map. Simply click on the placename dot after selecting Delete Placename from the menu.
View Menu
+
====View Menu====
 
Show Placenames selects whether or not to show placenames on the display.
 
Show Placenames selects whether or not to show placenames on the display.
 
Show Offlimits selects whether or not to show off limits areas on the display.
 
Show Offlimits selects whether or not to show off limits areas on the display.
Help Menu
+
====Help Menu====
 
About will open a window which provides information about using the program.
 
About will open a window which provides information about using the program.
  
Tools and Settings
+
[[imagem:me-help.gif]]
 +
 
 +
===Tools and Settings===
  
Tools
+
====Tools====
 
Brush draws squares (of width and height equal to "brush size" setting) of probability equal to the "ink" setting onto the map. The brush is activated by clicking the left mouse button and dragging the cursor across the screen.
 
Brush draws squares (of width and height equal to "brush size" setting) of probability equal to the "ink" setting onto the map. The brush is activated by clicking the left mouse button and dragging the cursor across the screen.
 
Rectangle draws a rectangle of probability "ink", filled or not, with edgesof width equal to the "line size" setting onto the map. The regtangle is activated by clicking the left mouse button, dragging the cursor across the screen, and releasing the button.
 
Rectangle draws a rectangle of probability "ink", filled or not, with edgesof width equal to the "line size" setting onto the map. The regtangle is activated by clicking the left mouse button, dragging the cursor across the screen, and releasing the button.
Linha 53: Linha 63:
 
Eye Dropper changes the current "ink" setting to the probability of the grid cell clicked upon with the left mouse button.
 
Eye Dropper changes the current "ink" setting to the probability of the grid cell clicked upon with the left mouse button.
 
Zoom allows you to zoom in or out on the map display. Zoom in by clicking the left mouse button on the center of the area you want to look at, or zoom out by clicking the right mouse button on the desired center point.
 
Zoom allows you to zoom in or out on the map display. Zoom in by clicking the left mouse button on the center of the area you want to look at, or zoom out by clicking the right mouse button on the desired center point.
Settings
+
====Settings====
 
Ink (Probability) sets the likelyhood that a grid cell is occupied. It is represented by the darkness of the color.
 
Ink (Probability) sets the likelyhood that a grid cell is occupied. It is represented by the darkness of the color.
 
Unknown sets the ink to represent areas of no data, signified by blue color in the map.
 
Unknown sets the ink to represent areas of no data, signified by blue color in the map.
Linha 61: Linha 71:
 
Line Size sets the width of lines and width of edges of unfilled rectangles. The units are equivalent to the resolution of the map.
 
Line Size sets the width of lines and width of edges of unfilled rectangles. The units are equivalent to the resolution of the map.
 
Shape Fill sets whether or not rectangles are filled.
 
Shape Fill sets whether or not rectangles are filled.
Terms
+
===Terms===
  
 
Fuzziness: The half-range of points effected by "Fuzzy Fill." For example, if you have fuzziness set to 0.100 and you attempt to Fuzzy Fill a region by clicking on a point whose ocupation probability is 0.300, then all contiguous points whose porobability is between 0.200 and 0.400 will be changed to the value of "Ink."
 
Fuzziness: The half-range of points effected by "Fuzzy Fill." For example, if you have fuzziness set to 0.100 and you attempt to Fuzzy Fill a region by clicking on a point whose ocupation probability is 0.300, then all contiguous points whose porobability is between 0.200 and 0.400 will be changed to the value of "Ink."
 
Grid Cell: The smallest possible unit in the map.
 
Grid Cell: The smallest possible unit in the map.
 
Probability: The likelihood that a grid cell is occupied. In the map editor, "ink" is often substituted for "probability."
 
Probability: The likelihood that a grid cell is occupied. In the map editor, "ink" is often substituted for "probability."

Edição atual tal como às 16h14min de 14 de setembro de 2012

Introduction

The Carmen Map Editor allows for manually modifying the maps created with Vasco, or draw entirely new maps. It will enable you to add or remove place names or mark areas as off limits to the robot in addition to modifying the objects, walls, and free space within the map.

Using the map editor is similar to using many standard graphics and drawing programs, except that the colors represent probabilities that a particular point is occupied. White implies low probability of ocupation, as it shifts through grey to black, it implies greater probability of a grid cell being occupied. Blue areas are unknown; there is no data available to assign a probability. Red areas represent "off limits" areas, where the robot should not go, whether or not it *can* go there. (This can be very important for keeping the robot away from stairwells and other dangers it cannot detect.)

Editor Controls

On opening the map_editor program, you see a control panel like this:

Map editor1.gif

Menus

File Menu

New Map (also CNTL-N) allows you to create a new map. Choosing this will cause a dialog box to appear, asking for the map size and resolution.

Map editor2.gif

Width and Height are in "grid cells," and Resolution is the size (in meters) of each cell. Since the brush and line size is in grid cells, resolution here can be very important.

Map editor3.gif

Open Map (also CNTL-O -or- as a command option when starting: "./map_editor mapname.map") will open a previously generated map.

Map editor4.gif

Save Map (also CNTL-S) will save a previously saved map under the same name. Save Map As (also CNTL-A) will save a map under a new name. Export is not implemented with this release. Quit (also CNTL-Q) will exit the program.

Edit Menu

Undo (also CNTL-Z) will undo only the most recent action. Add Placename is not implemented in this version. To add a placename, run the map_add_place program as follows:

 ./map_add_place mapfilename placename [place params]

2, 3, or 6 place parameters can be given. 2 parameters - named position (x, y) 3 parameters - named pose (x, y, theta) 6 parameters - initialization position (x, y, theta, std_x, std_y, std_theta) The "std" parameters are for the standard deviation in a robot start position. Remember: The x/y/std_x/std_y co-ordinates are in METRES, not ingrid cells, and theta is in DEGREES. It will print out the conversion to radians automatically for you. To get the x and y coordinates you want, use map_editor: the coordinates of the mouse pointer are displayed in the upper right, under the "Help" menu.

Delete Placename will remove a placename from the map. Simply click on the placename dot after selecting Delete Placename from the menu.

View Menu

Show Placenames selects whether or not to show placenames on the display. Show Offlimits selects whether or not to show off limits areas on the display.

Help Menu

About will open a window which provides information about using the program.

Me-help.gif

Tools and Settings

Tools

Brush draws squares (of width and height equal to "brush size" setting) of probability equal to the "ink" setting onto the map. The brush is activated by clicking the left mouse button and dragging the cursor across the screen. Rectangle draws a rectangle of probability "ink", filled or not, with edgesof width equal to the "line size" setting onto the map. The regtangle is activated by clicking the left mouse button, dragging the cursor across the screen, and releasing the button. Line draws a line of probability "ink" onto the map with a thickness of approximately the "line size" setting. The line is activated by clicking the left mouse button, dragging the cursor across the screen, and releasing the button. Fill changes a contiguous area of the same probability to have the probability of the "ink" setting. The fill tool is activated by clicking the left mouse button on any location in the area you want to fill. Fuzzy Fill is just like fill, except that it allows for variations in the probabilities in the region to be filled. Instead of all filled cells having the same probability, they can vary by plus or minus the "fuzziness" setting. Eye Dropper changes the current "ink" setting to the probability of the grid cell clicked upon with the left mouse button. Zoom allows you to zoom in or out on the map display. Zoom in by clicking the left mouse button on the center of the area you want to look at, or zoom out by clicking the right mouse button on the desired center point.

Settings

Ink (Probability) sets the likelyhood that a grid cell is occupied. It is represented by the darkness of the color. Unknown sets the ink to represent areas of no data, signified by blue color in the map. Off Limits sets the ink to represent areas that the robot should not travel to, represented by red color in the map if "show offlimits" is selected in the view memu. Fuzziness sets the half-range of the probabilities effected by the "fuzzy fill" tool. Brush Size sets the length of a side on a square brush. The units are equivalent to the resolution of the map. Line Size sets the width of lines and width of edges of unfilled rectangles. The units are equivalent to the resolution of the map. Shape Fill sets whether or not rectangles are filled.

Terms

Fuzziness: The half-range of points effected by "Fuzzy Fill." For example, if you have fuzziness set to 0.100 and you attempt to Fuzzy Fill a region by clicking on a point whose ocupation probability is 0.300, then all contiguous points whose porobability is between 0.200 and 0.400 will be changed to the value of "Ink." Grid Cell: The smallest possible unit in the map. Probability: The likelihood that a grid cell is occupied. In the map editor, "ink" is often substituted for "probability."