Installation

Next Tutorial: C++ Get Started

Overview

This tutorial describes how to install Ignition Math on Linux, Mac OS X and Windows via either a binary distribution or from source.

Install

• Binary Install
• Source Install
  • Prerequisites
  • Building from Source

Install

We recommend following the Binary Install instructions to get up and running as quickly and painlessly as possible.

The Source Install instructions should be used if you need the very latest software improvements, you need to modify the code, or you plan to make a contribution.

Binary Install

Ubuntu Linux

Setup your computer to accept software from packages.osrfoundation.org:

sudo sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list'

Setup keys:

wget http://packages.osrfoundation.org/gazebo.key -O - | sudo apt-key add -

Install Ignition Math:

sudo apt install libignition-math<#>-dev

Be sure to replace <#> with a number value, such as 1 or 2, depending on which version you need.

Source Install

Source installation can be performed in UNIX systems by first installing the necessary prerequisites followed by building from source.

Prerequisites

The optional Eigen component of Ignition Math requires:

• Eigen. Refer to the Eigen Documentation for installation instructions. On Ubuntu systems, apt-get can be used to install Eigen:

  ``` sudo apt-get install libeigen3-dev ```

The optional Ruby tests of Ignition Math require:

• Ruby. Refer to the Ruby Documentation for installation instructions. On Ubuntu systems apt-get can be used to install Ubuntu Package ruby-dev:

  ``` sudo apt-get install ruby-dev ```

  • Swig. Refer to the Swig Documentation for installation instructions. On Ubuntu systems apt-get can be used to install Swig:

    ``` sudo apt-get install swig ```

Building from source

1. Clone the repository

   ``` git clone https://github.com/ignitionrobotics/ign-math -b ign-math<#> `` Be sure to replace<#>` with a number value, such as 1 or 2, depending on which version you need.

2. Install dependencies

   ``` export SYSTEM_VERSION=bionic sudo apt -y install \ $(sort -u $(find . -iname 'packages-'$SYSTEM_VERSION'.apt' -o -iname 'packages.apt') | tr '
   ' ' ') ```

3. Configure and build

   ``` cd ign-math; mkdir build; cd build; cmake ..; make ```

4. Optionally, install Ignition Math

   ``` sudo make install ```