ARNL, SONARNL and MOGS

From MobileRobots Research and Academic Customer Support

Jump to: navigation, search

ARNL is a set of software packages built on top of ARIA for intelligent navigation and localization. "Localization" allows the program to keep track of where the robot is and "navigation" allows the robot to get to a given destination. The libraries run and coordinates these two tasks, with the localization task automatically correcting robot pose, and the navigation task driving the robot to a goal you specify either in your control program via the programming interface, or from a remote control client such as MobileEyes via the ArNetworking protocol.

The libraries provide a native C++ API, as well as Python and Java APIs through a wrapper interface layers. The packages include the shared libraries/DLLs, header files, API reference manuals, and example programs with source code.

Three seperate localization techniques are available, implemented in three separate libraries:

  • Laser Localization -- ARNL -- uses a SICK laser to perform precise localization
  • Sonar Localization -- SONARNL -- uses the built in sonar sensors for approximate localization
  • GPS Localization -- MOGS -- uses a GPS unit to localize within a map

Laser and GPS localization are only available to customers who have purchased the laser mapping and navigation or outdoor navigation options. SONARNL sonar localization is available to all customers.

I addition to the localization libraries, the BaseArnl library contains the navigation component, base utilities used by the localization libraries, and ARIA and ArNetworking are used by these libraries as well (the BaseArnl installation package includes the ARIA and ArNetworking libraries required.)


Contents

Download

Important note for users upgrading from ARNL 1.5 and prior: to upgrade, you must first uninstall the currently installed ARNL or SONARNL, then install BaseArnl in addition to either ARNL or SONARNL. Also, guiServer has been renamed to arnlServer and guiServerSonar has been renamed to sonarnlServer.


Debian Linux 3.1 with GCC 3.4

Built for use with the MobileRobots-customized Debian 3 release with GCC 3.4:

Image:Download_icon_bw.png Base ARNL Library 1.7.2 for Debian GNU/Linux 3.1 (sarge) and later

  • Install with dpkg -i

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.0 for Debian GNU/Linux 3.1 (sarge) and later

  • Install with dpkg -i

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.0 for Debian GNU/Linux 3.1 (sarge) and later

  • Install with dpkg -i

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.0 for Debian GNU/Linux 3.1 (sarge) and later

  • Install with dpkg -i


Debian Linux 4.1 or later with GCC 4

Built for Debian 4.1 (etch) or later with GCC 4:

Image:Download_icon_bw.png Base ARNL Library 1.7.2 for Debian GNU/Linux 4.0 (etch) and later with GCC 4.1

  • Install with dpkg -i

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.0 for Debian GNU/Linux 4.0 (etch) and later with GCC 4.1

  • Install with dpkg -i

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.0 for Debian GNU/Linux 4.0 (etch) and later with GCC 4.1

  • Install with dpkg -i

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.0 for Debian GNU/Linux 4.0 (etch) and later with GCC 4.1

  • Install with dpkg -i


Windows

Image:Download_icon_bw.png Base ARNL Library 1.7.2 for Windows

  • Run installer program to install

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.0 for Windows

  • Run installer program to install

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.0 for Windows

  • Run installer program to install

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.0 for Windows

  • Run installer program to install


Generic Linux TAR Archive

Built for use with GCC 3.4:

Image:Download_icon_bw.png Base ARNL Library 1.7.2 for other Linux systems (Generic compressed TAR archive) with GCC 3.4

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.0 for other Linux systems (Generic compressed TAR archive) with GCC 3.4

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.0 for other Linux systems (Generic compressed TAR archive) with GCC 3.4

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.0 for other Linux systems (Generic compressed TAR archive) with GCC 3.4

  • Unpack and follow installation instructions inside

Built for use with GCC 4.x:

Image:Download_icon_bw.png Base ARNL Library 1.7.2 for other Linux systems (Generic compressed TAR archive) with GCC 4.1

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.0 for other Linux systems (Generic compressed TAR archive) with GCC 4.1

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.0 for other Linux systems (Generic compressed TAR archive) with GCC 4.1

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.0 for other Linux systems (Generic compressed TAR archive) with GCC 4.1

  • Unpack and follow installation instructions inside


RedHat Linux 7

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.0-0 for RedHat Linux 7.1 (Legacy support)

  • Install with rpm -i or rpm -U to upgrade

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.0-0 for RedHat Linux 7.1 (Legacy support)

  • Install with rpm -i or rpm -U to upgrade

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.0-0 for RedHat Linux 7.1 (Legacy support)

  • Install with rpm -i or rpm -U to upgrade

Note: to install BaseArnl 1.7.1 with ARNL, SONARNL or MOGS 1.7.0, you must use the --nodeps option


Documentation

Image:Doc_icon_bw.png Change History for ARNL libraries

Image:Doc_icon_bw.png Change History for ARIA 2.7.2

Image:Doc_icon_bw.pngARNL and SICK Laser User's Manual

Image:Doc_icon_bw.pngSONARNL User's Manual

Previous Versions

Note, before 1.7, only independent ARNL and SONARNL packages were released.

Image:Folder_icon_bw.pngArchived versions of ARNL

Image:Folder_icon_bw.pngArchived versions of SONARNL

Image:Folder_icon_bw.pngArchived versions of BaseArnl

Image:Folder_icon_bw.pngArchived versions of MOGS

Recommended Additional Downloads

Mapper3 or Mapper3Basic
To work with ARNL you will also need to download the Mapper3 application so that you can make maps for ARNL to navigate and localize in. Mapper3 will take laser scan log files (.2d) (generated by arnlServer or sickLogger) and transform them into maps (.map files) for use with ARNL and then let you edit them, including placing goals and forbidden lines and moving the robots home position. Mapper3Basic can also be used to edit maps, but cannot process laser scans. It is, however, available to all customers.
MobileEyes
You will also want to download the MobileEyes application so that you can have a GUI to watch what the robot is doing. MobileEyes connects to servers run from an ARNL program across a network, letting you view the robot's movements and environment without slowing them down.
ARIA
While not required (ARNL is self contained), ARIA may also be used for its examples and source code
MobileSim
While it is not required, it is recommended that you also download MobileSim so that you can use the simulator for developing, debugging, and simulating your code.
Retrieved from "http://robots.mobilerobots.com/wiki/ARNL%2C_SONARNL_and_MOGS"
Personal tools