Installation

GoLearn is a Go library that's relatively standard apart from a few optional C dependencies. To install it, you'll need to install Go 1.2 or later first.

Installation

System dependencies

GoLearn uses Gonum's BLAS wrapper, which requires OpenBLAS or similar to be installed.

Installing a BLAS implementation

Installing OpenBLAS on Ubuntu

sudo apt-get install libopenblas-dev

Installation on Mac OS X

     This takes a very long time

A BLAS implementation can be installed via Homebrew. After installation, check that it's up-to-date via brew update. Next, issue brew install liblas.

Completing the installation of Gonum's BLAS wrapper

After installing a BLAS implementation, type the following commands

go get github.com/gonum/blas
cd $GOPATH/src/github.com/gonum/blas
go install ./...

Installing GoLearn's internal dependencies

After installing go and the system dependencies, type

go get -t -u -v github.com/sjwhitworth/golearn
cd $GOPATH/src/github.com/sjwhitworth/golearn/ext
go run make.go

You'll then need to add $GOPATH/src/github.com/sjwhitworth/golearn/ext/lib to an appropriate variable.

Bash (Linux)

Add the following to your ~/.bashrc file:

export LD_LIBRARY_PATH=$GOPATH/src/github.com/sjwhitworth/golearn/ext/lib:$LD_LIBRARY_PATH

Make sure to run source ~/.bashrc or restart the bash shell before continuing.

Bash (Mac OS X)

Add the following to your ~/.bashrc file:

export DYLD_LIBRARY_PATH=$GOPATH/src/github.com/sjwhitworth/golearn/ext/lib:$DYLD_LIBRARY_PATH

Make sure to run source ~/.bashrc or restart the bash shell before continuing.

Completing the installation

Run the following to complete installation.

cd $GOPATH/src/github.com/sjwhitworth/golearn
go get ./...

Common problems

On Linux and Mac OS X, you can verify that Go is installed correctly via your terminal. Try compiling the example program to verify that your installation is working correctly.

Your go directory must exist in your home directory and be writeable. If it isn't, type cd && mkdir go to create it.

Your GOPATH and PATH variables must be set correctly.

• To verify, type echo $GOROOT and echo $GOPATH.
• Your $GOPATH variable should include your $GOROOT, plus a bin/ directory. For example, if $GOROOT is set to /home/sen/go, $GOPATH should be set to /home/sen/go/bin
• To make sure that these variables are setup correctly, add export GOROOT=$HOME/go and export PATH=$PATH:$GOROOT/bin to your Bash configuration file.

Support status

Operating Systems	Mac OS X 10.8 Ubuntu 14.04
Go version	1.2
GoLearn version	0.1
Support status	Current
Next revision	On version upgrade

Mac OS X 10.8

• BLAS installation via HomeBrew has not been confirmed working.