Octave for Debian systems: Difference between revisions
Carandraug (talk | contribs) m (→Octave's Personal Package Archive (PPA) for Ubuntu: fix link for Mike Miller) |
Carandraug (talk | contribs) (→Compiling from source: make it more obvious when build-dep is probably not what people want) |
||
| Line 27: | Line 27: | ||
== Compiling from source == | == Compiling from source == | ||
The only ''tricky | The ''only'' tricky part is to install the dependencies. Once that is solved, installing from source should be as easy as {{Codeline|./configure && make && make install}}. See the manual for the [http://www.gnu.org/software/octave/doc/interpreter/Running-Configure-and-Make.html configure options]. | ||
=== Install dependencies === | === Install dependencies === | ||
| Line 33: | Line 33: | ||
Note that different Debian and Ubuntu versions may have slightly different package names but their differences should be pretty small, mostly limited to version numbers. | Note that different Debian and Ubuntu versions may have slightly different package names but their differences should be pretty small, mostly limited to version numbers. | ||
==== The easy way (but | ==== The easy way (but likely incorrect) ==== | ||
This approach is ''only'' suitable if you are building from source the ''same'' version that your Linux distribution already has packaged. | |||
The easy way to install ''most'' of the necessary dependencies is to {{Codeline|sudo apt-get build-dep octave}}. This will install all packages necessary to build and prepare a Debian package for the octave version available on your system repositories. However: | The easy way to install ''most'' of the necessary dependencies is to {{Codeline|sudo apt-get build-dep octave}}. This will install all packages necessary to build and prepare a Debian package for the octave version available on your system repositories. However: | ||
| Line 46: | Line 48: | ||
==== The right way ==== | ==== The right way ==== | ||
The | The right way is to select and install all the dependencies as listed in the {{Path|INSTALL.OCTAVE}} file. The following are their package names in Debian repositories (they will have their own dependencies which your package manager will solve automatically). If you are building development versions, you'll require some more packages as listed on {{Path|etc/HACKING}} and {{Path|INSTALL}}. Many of them will already be installed on your system. Install the dependencies by typing | ||
sudo apt-get install | sudo apt-get install | ||
Revision as of 11:13, 24 July 2015
For Debian, and Debian based distributions such as Ubuntu, specific solutions.
Pre-compiled binaries
Binary packages for Octave and many Octave-Forge packages are provided by all versions of Debian and Ubuntu. These are the most well-tested binaries available and should work best for most users.
sudo apt-get install octave
Aside the octave package that installs GNU Octave, other pieces of it are split over multiple packages. These are octave-doc, octave-info, and octave-htmldoc for the documentation; liboctave-dev for the octave development header files and mkoctfile (required to install Octave Forge packages); and octave-dbg for the debugging symbols.
For Debian stable users, there may also be newer packages available in backports, so don't forget to check there.
Octave packages
Many Octave packages are also distributed by your Linux distribution. These are tested to work the best with your Octave version. For example:
sudo apt-get install octave-control octave-image octave-io octave-optim octave-signal octave-statistics
Octave's Personal Package Archive (PPA) for Ubuntu
For some Ubuntu releases the octave packages are too old (Ubuntu 12.04 only has Octave version 3.2). The GNU Octave Team on Launchpad maintains a PPA providing more up to date packages of Octave for all versions of Ubuntu. These are backported from Debian unstable (the Ubuntu Octave Team needs help testing and preparing the packages so if you can help with this, contact Mike Miller). To set up your system to install these packages:
sudo apt-add-repository ppa:octave/stable sudo apt-get update sudo apt-get install octave
Compiling from source
The only tricky part is to install the dependencies. Once that is solved, installing from source should be as easy as ./configure && make && make install. See the manual for the configure options.
Install dependencies
Note that different Debian and Ubuntu versions may have slightly different package names but their differences should be pretty small, mostly limited to version numbers.
The easy way (but likely incorrect)
This approach is only suitable if you are building from source the same version that your Linux distribution already has packaged.
The easy way to install most of the necessary dependencies is to sudo apt-get build-dep octave. This will install all packages necessary to build and prepare a Debian package for the octave version available on your system repositories. However:
- will install unnecessary packages related to the building of a Debian package;
- may miss some new dependencies;
- may install packages that are no longer octave dependencies.
The even easier way
The MXE-octave package provides a way to compile Octave for different platforms. Dependencies and certain flags are handled automatically.
The right way
The right way is to select and install all the dependencies as listed in the INSTALL.OCTAVE file. The following are their package names in Debian repositories (they will have their own dependencies which your package manager will solve automatically). If you are building development versions, you'll require some more packages as listed on etc/HACKING and INSTALL. Many of them will already be installed on your system. Install the dependencies by typing
sudo apt-get install
followed by the package names of the table below.
Packages marked with * in the table above are virtual packages (you'll have to pick one of the displayed versions).
- The Debian repositoriy has several libraries for dealing with HDF data files. The recommended is
libhdf5-serial-dev. However, the msh package requires gmsh which is incompatible with it. - The GraphicsMagick++ library (libgraphicsmagick++-dev) on the Debian repositories was compiled with quantum 8 which limits reading images to 8 bit. The solution is to recompile GraphicsMagick with quantum 16 or 32 before building Octave.
Configuration
HDF5 issue
With current Debian versions you may get the following when building from source:
HDF5 library not found. Octave will not be able to save or load HDF5 data files.
The problem is that there are multiple versions of the hdf5 package. Octave was written with the serial version in mind but it is likely to work with the others (OpenMPI and Mpich). Due to the naming scheme done in Debian, it is required to specify the location of the libraries. See bug #38928 for details but basically, use the following when running configure:
./configure CPPFLAGS=-I/usr/include/hdf5/serial LDFLAGS=-L/usr/lib/$(dpkg-architecture -qDEB_HOST_MULTIARCH)/hdf5/serial