Basic FAQ

From The Player Project

Jump to: navigation, search
m
(removed very old and misleading items (from Stage 1.3))
Line 185: Line 185:
=Stage=
=Stage=
 +
==What is Stage?==
==What is Stage?==
-
Stage is a scaleable multiple robot simulator; it simulates a population of mobile robots moving in and sensing a two-dimensional bitmapped environment, controlled through Player. Stage provides virtual Player robots which interact with simulated rather than physical devices. Various sensor models are provided, including sonar, scanning laser rangefinder, pan-tilt-zoom camera with color blob detection and odometry.  
+
Stage is a scaleable multiple robot simulator; it simulates a population of mobile robots moving in and sensing a two-dimensional bitmapped environment. When used as a Player plugin, Stage provides virtual Player robots which interact with simulated rather than physical devices. Stage can also be used as link library to create custom simulations. Various sensor models are provided, including sonar, scanning laser rangefinder, pan-tilt-zoom camera with color blob detection and odometry.  
More information on the [[Stage]] page.
More information on the [[Stage]] page.
-
==How is Stage different from other robot simulators?==
 
-
==Where does Stage run?==
 
==How do I get/build/install Stage?==
==How do I get/build/install Stage?==
See the [[Download]] page.
See the [[Download]] page.
-
==How can I make movies of my Stage simulations?==
+
== When configuring Stage, Player is not found, but I just installed Player OK. What's up? ==
-
For Stage 1.6 and up, use the File:Export menu in the GUI to dump screenshots, then see "How can I make movies from screenshots?" question above.
+
Stage uses pkgconfig to find Player, so the problem probably lies with your pkg-config setup.
 +
First, make sure you have pkg-config installed. Then run it from the command line to make sure it finds Player.
-
For Stage 1.3.x see [http://playerstage.sourceforge.net/index.php?src=faq#top old FAQ].
+
Here's a successful manual run of pkg-config:
-
==What does it mean when Stage says "error executing player"?==
+
  $ pkg-config --cflags playercore
-
This usually means that Stage was unable to execute the Player server because it's not in your PATH. You must have the path to the server binary player (e.g., $HOME/player-1.3/bin) in your PATH.  
+
  -I/Users/vaughan/PS-2.0/include/player-2.0
-
==Stage is running but there's no GUI! ==
+
Here's an unsuccessful run, which produces a hint on how to fix it:
-
Well that's not actually a question, but the problem is likely that you didn't compile any GUI support into Stage. That's an installation problem, read again the installation instructions for Stage.
+
-
==How do I add an object to Stage 1.3 and later?==
+
  $ pkg-config --cflags playercore
-
(contributed by Alex Makarenko)
+
  Package playercore was not found in the pkg-config search path.
-
TODO: Is this outdated??
+
  Perhaps you should add the directory containing `playercore.pc'
-
#write the code: myobject.hh/cc
+
  to the PKG_CONFIG_PATH environment variable
-
##see a comment in file src/library.hh
+
  No package 'playercore' found
-
##start with an existing object, e.g. src/models/puck.hh/cc
+
-
#add two lines in file src/library.cc
+
-
## #include models/mydevice.hh
+
-
## add an item to libitem_t library_items[] = {...}
+
-
#add files to the project and compile
+
-
##copy myobject.hh/cc to src/models directory  
+
-
##add them to libstgmodels_a_SOURCES list in file src/models/Makefile.am
+
-
##make sure the files are actually added to the project, this may require some coercing, such as:
+
-
+
-
run autoconf (or possibly autoreconf ?)
+
-
run automake
+
So you need to add the path to Player's installed pkg-config metadata (*.pc) files. These 
 +
are in $(prefix)/lib/pkgconfig. $(prefix) defaults to /usr/local/ 
 +
unless you specified it differently on your configure command line. 
 +
So here's the fix for a default install:
-
run ./configure
+
  $ export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
 +
  $ pkg-config --cflags playercore
 +
  -I/Users/vaughan/PS-2.0/include/player-2.0
-
*compile
+
==How can I make movies of my Stage simulations?==
 +
 
 +
For Stage 1.6 and up, use the File:Export menu in the GUI to dump screenshots, then see "How can I make movies from screenshots?" question above.
==Where is the "sonar" model in Stage?==  
==Where is the "sonar" model in Stage?==  
-
Stage does not have a "sonar" model, but it does have a "ranger" model. This model can be used to simulate any sensor which consists of a group of individual range-sensing models. Stage's "ranger" only simulates a single "beam", however, instead of (the potentially computentially expensize) cone shape of most sonar sensors.
+
 
 +
Stage does not have a "sonar" model, but it does have a "ranger" model that does a reasonable job of modeling sonar and IR rangefinders, or similar arrays of simple rangefinders. The ranger models a sonar or IR cone by raytracing a  configurable number of thin diverging beams.
=Gazebo=
=Gazebo=

Revision as of 17:42, 15 August 2006

Personal tools