Robot_positionName - English
========================

.. toctree::
   :hidden:

   index_j


Introduction
============


For a full list of classes and functions, see the `API documentation`_.

.. _`API Documentation`:
   doxygen/html/index.html

Requirements
============

Robot_position uses the `CMake build system`. You will need at least version
2.8 to be able to build the component.

.. _`CMAke build system`:
   http://www.cmake.org


Installation
============

Binary
------

Users of Windows can install the component using the binary installer. This
will install the component and all its necessary dependencies. It is the
recommended method of installation in Windows.

- Download the installer from the website.
- Double-click the executable file to begin installation.
- Follow the instructions to install the component.
- You may need to restart your computer for environment variable changes
  to take effect before using the component.

The component can be launched by double-clicking the
``Robot_positionComp`` executable. The ``Robot_position`` library
is available for loading into a manager, using the initialisation function
``Robot_positionInit``.

From source
-----------

Follow these steps to install Robot_position from source in any operating
system:

- Download the source, either from the repository or a source archive,
  and extract it somewhere::

    tar -xvzf Robot_position-1.0.0.tar.gz

- Change to the directory containing the extracted source::

    cd Robot_position-1.0.0

- Create a directory called ``build``::

    mkdir build

- Change to that directory::

    cd build

- Run cmake or cmake-gui::

    cmake ../

- If no errors occurred, run make::

    make

- Finally, install the component. Ensure the necessary permissions to
  install into the chosen prefix are available::

    make install

- The install destination can be changed by executing ccmake and changing
  the variable ``CMAKE_INSTALL_PREFIX``::

    ccmake ../

The component is now ready for use. See the next section for instructions on
configuring the component.

Robot_position can be launched in stand-alone mode by executing the
``Robot_positionComp`` executable (installed into ``${prefix}/components/bin``).
Alternatively, ``libRobot_position.so`` can be loaded into a manager, using the
initialisation function ``Robot_positionInit``. This shared object can be found in
``${prefix}/components/lib`` or ``${prefix}/components/lib64``.


Configuration
=============

The available configuration parameters are described below:

================ ================== ================ ======
Parameter        Data type          Default Value    Effect
================ ================== ================ ======
LRFdata_min      int                84               
LRFdata_mid      int                347              
LRFdata_max      int                610              
right_corner     int                271              
left_corner      int                423              
LRF_total_steps  int                1024             
LRFdata_theta    int                360              
robot_width      int                50               
field_width      int                1000             
field_depth      int                2000             
environment      int                4000             
================ ================== ================ ======

Ports
=====

The ports provided by the component are described below:

=============== =========== ============================== =======
Name            Type        Data type                      Purpose
=============== =========== ============================== =======
range_data      InPort      RTC::RangeData                 
position_X      OutPort     RTC::TimedLong                 
position_Y      OutPort     RTC::TimedLong                 
direction       OutPort     RTC::TimedDouble               
=============== =========== ============================== =======

Examples
========

An example configuration file is provided in the
``${prefix}/components/share/Robot_position/examples/conf/`` directory.

Changelog
=========



License
=======

This software is developed at the National Institute of Advanced
Industrial Science and Technology. Approval number H23PRO-????. This
software is licensed under the Lesser General Public License. See
COPYING.LESSER.

