Windows installation via conda-forge

tutorials/installation.md

@@ -2,41 +2,27 @@
 
 Next Tutorial: \ref cppgetstarted
 
-# Overview
+These instructions are for installing only Ignition Math.
+If you're interested in using all the Ignition libraries, check out this [Ignition installation](https://ignitionrobotics.org/docs/latest/install).
 
-This tutorial describes how to install Ignition Math on Linux, Mac OS X and
-Windows via either a binary distribution or from source.
+We recommend following the Binary Installation instructions to get up and running as quickly and painlessly as possible.
 
-[Install](#install)
+The Source Installation 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](#binary-install)
+# Binary Installation
 
-* [Source Install](#source-install)
-
-    * [Prerequisites](#prerequisites)
-
-    * [Building from Source](#building-from-source)
-
-# Install
-
-We recommend following the [Binary Install](#binary-install) instructions to get up and running as quickly and painlessly as possible.
-
-The [Source Install](#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
+## Ubuntu Linux
 
 Setup your computer to accept software from
 *packages.osrfoundation.org*:
 
-```{.sh}
+```
 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:
 
-```{.sh}
+```
 wget http://packages.osrfoundation.org/gazebo.key -O - | sudo apt-key add -
 ```
 
@@ -49,61 +35,135 @@ 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
+## Windows
 
-Source installation can be performed in UNIX systems by first installing the
-necessary prerequisites followed by building from source.
+Install [Conda package management system](https://docs.conda.io/projects/conda/en/latest/user-guide/install/download.html).
+Miniconda suffices.
 
-### Prerequisites
+Create if necessary, and activate a Conda environment:
 
-The optional Eigen component of Ignition Math requires:
+```
+conda create -n ign-ws
+conda activate ign-ws
+```
 
-  * [Eigen](http://eigen.tuxfamily.org/index.php?title=Main_Page). Refer to the [Eigen Documentation](http://eigen.tuxfamily.org/index.php?title=Main_Page#Documentation) for installation instructions. On Ubuntu systems, `apt-get` can be used to install Eigen:
+Install:
+
+```
+conda install libignition-math<#> --channel conda-forge
+```
+
+Be sure to replace `<#>` with a number value, such as 1 or 2, depending on
+which version you need.
 
-    ```
-    sudo apt-get install libeigen3-dev
-    ```
+# Source Installation
+
+Source installation can be performed by first installing the necessary
+prerequisites followed by building from source.
+
+## Prerequisites
+
+Ignition Math requires:
+
+* [Ignition CMake](https://ignitionrobotics.org/libs/cmake)
+
+### Ubuntu Linux
+
+The optional Eigen component of Ignition Math requires:
+
+* [Eigen](http://eigen.tuxfamily.org/index.php?title=Main_Page). Refer to the [Eigen Documentation](http://eigen.tuxfamily.org/index.php?title=Main_Page#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](https://www.ruby-lang.org/). Refer to the [Ruby Documentation](https://www.ruby-lang.org/downloads/) for installation instructions. On Ubuntu systems `apt-get` can be used to install Ubuntu Package `ruby-dev`:
+* [Ruby](https://www.ruby-lang.org/). Refer to the [Ruby Documentation](https://www.ruby-lang.org/downloads/) for installation instructions. On Ubuntu systems `apt-get` can be used to install Ubuntu Package `ruby-dev`:
+  ```
+  sudo apt-get install ruby-dev
+  ```
 
-    ```
-    sudo apt-get install ruby-dev
-    ```
+* [Swig](http://www.swig.org/). Refer to the [Swig Documentation](http://www.swig.org/download.html) for installation instructions. On Ubuntu systems `apt-get` can be used to install Swig:
+  ```
+  sudo apt-get install swig
+  ```
 
-  * [Swig](http://www.swig.org/). Refer to the [Swig Documentation](http://www.swig.org/download.html) for installation instructions. On Ubuntu systems `apt-get` can be used to install Swig:
+### Windows 10
 
-    ```
-    sudo apt-get install swig
-    ```
+First, follow the [ign-cmake](https://github.com/ignitionrobotics/ign-cmake) tutorial for installing Conda, Visual Studio, CMake, and other prerequisites, and also for creating a Conda environment.
 
-### Building from source
+The optional Eigen component of Ignition Math requires:
 
-1. Clone the repository
+* [Eigen](http://eigen.tuxfamily.org/index.php?title=Main_Page). Refer to the [Eigen Documentation](http://eigen.tuxfamily.org/index.php?title=Main_Page#Documentation) for installation instructions. On Windows, we will use `conda` to install Eigen:
+  ```
+  conda install eigen --channel conda-forge
+  ```
 
-    ```
-    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.
+## Building from Source
 
-2. Install dependencies
+### Ubuntu
 
-    ```
-    export SYSTEM_VERSION=bionic
-    sudo apt -y install \
-      $(sort -u $(find . -iname 'packages-'$SYSTEM_VERSION'.apt' -o -iname 'packages.apt') | tr '\n' ' ')
-    ```
+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 '\n' ' ')
+  ```
 
 3. Configure and build
+  ```
+  cd ign-math; mkdir build; cd build; cmake ..; make
+  ```
+
+4. Optionally, install
+  ```
+  sudo make install
+  ```
 
-    ```
-    cd ign-math; mkdir build; cd build; cmake ..; make
-    ```
+### Windows
 
-4. Optionally, install Ignition Math
+1. Navigate to `condabin` if necessary to use the `conda` command (i.e., if Conda is not in your `PATH` environment variable. You can find the location of `condabin` in Anaconda Prompt, `where conda`).
+  Activate the Conda environment created in the prerequisites:
+  ```
+  conda activate ign-ws
+  ```
+
+2. Install dependencies
 
-    ```
-    sudo make install
-    ```
+  You can view available versions and their dependencies:
+  ```
+  conda search libignition-math* --channel conda-forge --info
+  ```
+  See the [Conda release repository](https://github.com/conda-forge/libignition-math4-feedstock) for more information.
+
+  Install dependencies, replacing `<#>` with the desired version:
+  ```
+  conda install libignition-cmake<#> --channel conda-forge
+  ```
+
+3. Navigate to where you would like to build the library, and clone the repository.
+  ```
+  # Optionally, append `-b ign-math#` (replace # with a number) to check out a specific version
+  git clone https://github.com/ignitionrobotics/ign-math.git
+  ```
+
+4. Configure and build
+  ```
+  cd ign-math
+  mkdir build
+  cd build
+  cmake .. -DBUILD_TESTING=OFF  # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install
+  cmake --build . --config Release
+  ```
+
+5. Optionally, install
+  ```
+  cmake --install . --config Release
+  ```