ARNL, SONARNL and MOGS

From MobileRobots Research and Academic Customer Support

(Redirected from ARNL)
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 laser rangefinder and map to perform precise localization
  • Sonar Localization -- SONARNL -- uses the built in sonar sensors for approximate localization
  • GPS Localization -- MOGS -- uses a GPS receiver to position the robot 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 5.0 or later with GCC 4 (32-bit)

Built for 32-bit Debian 5.0 (lenny) or later with GCC 4:

Image:Download_icon_bw.png Base ARNL Library 1.7.5.2 - Debian GNU/Linux 5 (lenny) and later (32-bit architecture) (arnl-base_1.7.5.2+debian5.0+gcc4.3_i386.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - Debian GNU/Linux 5 (lenny) and later (32-bit architecture) (libarnl_1.7.5.1+debian5.0+gcc4.3_i386.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - Debian GNU/Linux 5 (lenny) and later (32-bit architecture) (libsonarnl_1.7.5.1+debian5.0+gcc4.3_i386.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - Debian GNU/Linux 5 (lenny) and later (32-bit architecture) (libmogs_1.7.5.1+debian5.0+gcc4.3_i386.deb)

  • Install with dpkg -i


Debian Linux 5.0 or later with GCC 4 (64-bit)

Built for 64-bit Debian 5.0 (lenny) or later with GCC 4:

Image:Download_icon_bw.png Base ARNL Library 1.7.5.2 - Debian GNU/Linux 5 (lenny) and later (64-bit architecture) (arnl-base_1.7.5.2+debian5.0+gcc4.3_amd64.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - Debian GNU/Linux 5 (lenny) and later (64-bit architecture) (libarnl_1.7.5.1+debian5.0+gcc4.3_amd64.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - Debian GNU/Linux 5 (lenny) and later (64-bit architecture) (libsonarnl_1.7.5.1+debian5.0+gcc4.3_amd64.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - Debian GNU/Linux 5 (lenny) and later (64-bit architecture) (libmogs_1.7.5.1+debian5.0+gcc4.3_amd64.deb)

  • Install with dpkg -i



Old 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.5.2 - old Debian GNU/Linux 3.1 (sarge) (arnl-base_1.7.5.2+debian3.1+gcc3.4_i386.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - old Debian GNU/Linux 3.1 (sarge) (libarnl_1.7.5.1+debian3.1+gcc3.4_i386.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - old Debian GNU/Linux 3.1 (sarge) (libsonarnl_1.7.5.1+debian3.1+gcc3.4_i386.deb)

  • Install with dpkg -i

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - old Debian GNU/Linux 3.1 (sarge) (libmogs_1.7.5.1+debian3.1+gcc3.4_i386.deb)

  • Install with dpkg -i



Windows

Image:Download_icon_bw.png Base ARNL Library 1.7.5.2 - Windows (32-bit) (BaseArnl-1.7.5.2.exe)

  • Run installer program to install

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - Windows (32-bit) (ARNL-1.7.5.1.exe)

  • Run installer program to install

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - Windows (32-bit) (SONARNL-1.7.5.1.exe)

  • Run installer program to install

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - Windows (32-bit) (MOGS-1.7.5.1.exe)

  • Run installer program to install



Windows 64-bit

Notes: Java and Python wrappers are not available yet in the Windows 64-bit packages. The libraries included for 64-bit Windowsmay only be used with Visual C++ 2010 at this time.

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - Windows 64-bit (ARNL-1.7.5.1_64bit.exe)

  • Run installer program to install

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - Windows 64-bit (SONARNL-1.7.5.1_64bit.exe)

  • Run installer program to install

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - Windows 64-bit (MOGS-1.7.5.1_64bit.exe)

  • Run installer program to install



Generic Linux TAR Archive

Built for use with GCC 4.x on a 32-bit system:

Image:Download_icon_bw.png Base ARNL Library 1.7.5.2 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (BaseArnl-1.7.5.2+gcc4.3.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (Arnl-1.7.5.1+gcc4.3.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (SonArnl-1.7.5.1+gcc4.3.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (MOGS-1.7.5.1+gcc4.3.tgz)

  • Unpack and follow installation instructions inside


Built for use with GCC 4.x on a 64-bit system:

Image:Download_icon_bw.png Base ARNL Library 1.7.5.2 - Other 64-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (BaseArnl-1.7.5.2+x86_64+gcc4.3.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - Other 64-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (Arnl-1.7.5.1+x86_64+gcc4.3.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - Other 64-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (SonArnl-1.7.5.1+x86_64+gcc4.3.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - Other 64-bit Linux systems (Generic compressed TAR archive) with GCC 4.x (MOGS-1.7.5.1+x86_64+gcc4.3.tgz)

  • Unpack and follow installation instructions inside


Built for use with GCC 3.4 on a 32-bit system:

Image:Download_icon_bw.png Base ARNL Library 1.7.5.2 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 3.4 (BaseArnl-1.7.5.2+gcc3.4.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png ARNL Laser Localization Library 1.7.5.1 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 3.4 (Arnl-1.7.5.1+gcc3.4.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png SONARNL Sonar Localization Library 1.7.5.1 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 3.4 (SonArnl-1.7.5.1+gcc3.4.tgz)

  • Unpack and follow installation instructions inside

Image:Download_icon_bw.png MOGS GPS Localization Library 1.7.5.1 - Other 32-bit Linux systems (Generic compressed TAR archive) with GCC 3.4 (MOGS-1.7.5.1+gcc3.4.tgz)

  • Unpack and follow installation instructions inside

Documentation

Previous Versions

Note, before version 1.7.0, only 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,_SONARNL_and_MOGS"
Personal tools