Editing Octave for Debian systems

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
* ''This article addresses the [[:Category:Installation|installation]] and [[Building]] of GNU Octave on Debian, and Debian-based distributions such as Ubuntu.''
+
For Debian, and Debian based distributions such as Ubuntu, specific solutions.  
  
Binary packages for GNU 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.  To install them, run:
+
== Pre-compiled binaries ==
  
sudo apt-get install octave
+
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.
 +
 
 +
Octave is often split over multiple packages to cover the different parts of it. Aside the {{codeline|octave}} package that installs GNU Octave, there is also {{codeline|octave-doc}}, {{codeline|octave-info}}, and {{codeline|octave-htmldoc}} for the documentation, {{codeline|liboctave-dev}} for the octave development library (required to install most packages), and {{codeline|octave-dbg}} for the debugging symbols.
 +
 
 +
=== Troubleshooting ===
 +
 
 +
When installing Octave 3.2 in Ubuntu, broken packages install may cause an <span color="red">error: `pkg' undefined</span> error, previously reported as [https://bugs.launchpad.net/ubuntu/+source/octave3.2/+bug/465005 bug 465005]:
  
In Debian and Ubuntu the "complete" GNU Octave software is split over multiple packages. To obtain the complete features of Octave, install additionally
+
...
 +
Setting up octave3.2 (3.2.2-2build1) ...
 +
error: `pkg' undefined near line 0 column 1
 +
 +
dpkg: error processing octave3.2 (--configure):
 +
  subprocess installed post-installation script returned error exit status 1
 +
Processing triggers for libc-bin ...
 +
ldconfig deferred processing now taking place
 +
Processing triggers for menu ...
 +
Errors were encountered while processing:
 +
  octave3.2
 +
E: Sub-process /usr/bin/dpkg returned an error code (1)
  
* {{codeline|octave-doc}}, {{codeline|octave-info}}, and {{codeline|octave-htmldoc}} for the documentation;
+
Fix this by complete reinstall:
* {{codeline|liboctave-dev}} for the octave development header files and mkoctfile (required to install Octave Forge packages); and
 
* {{codeline|octave-dbg}} for the debugging symbols.
 
  
Many Octave packages are also distributed by Debian and UbuntuThese are tested to work the best with the respective Octave versionInstall them via:
+
sudo apt-get --purge remove octave3.2
 +
  sudo apt-get --purge remove octave3.2-common
 +
  sudo apt-get install octave3.2
  
sudo apt-get install octave-control octave-image octave-io octave-optim octave-signal octave-statistics
+
== Octave's Personal Package Archive (PPA) ==
  
Up to 2018, the [https://launchpad.net/~octave GNU Octave Team] on Launchpad actively maintained a PPA providing more up to date packages of Octave.  These are backported from Debian unstable and are still useful for older Ubuntu installations. To set up your system to install these packages, run:
+
However, for some Ubuntu releases the octave packages are old.  The [https://launchpad.net/~octave GNU Octave Team] on Launchpad maintain a PPA providing a binary packages of the latest stable and unstable versions of Octave for all versions of Ubuntu. To set up your system to install these packages
  
 
  sudo apt-add-repository ppa:octave/stable
 
  sudo apt-add-repository ppa:octave/stable
 +
sudo apt-add-repository ppa:octave/unstable
 
  sudo apt-get update
 
  sudo apt-get update
 
  sudo apt-get install octave
 
  sudo apt-get install octave
  
== Building 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 {{Codeline|./configure && make && make install}}. See the manual for the [http://www.gnu.org/software/octave/doc/interpreter/Running-Configure-and-Make.html#Running-Configure-and-Make configure options].
: ''For general build instructions, see [[Building]].''
 
 
 
The ''only'' tricky part is to install the Octave build dependencies. Once that is solved, one can easily follow the [[Building|general build instructions]]. See [[#Configuration|below]] for some Debian and Ubuntu specific configuration 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.
 
  
 +
=== Dependencies ===
 +
{{Note|different Debian versions may have slightly different package names but their differences should be pretty small, mostly limited to version numbers.}}
 +
==== The easy way ====
 
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:
* will install unnecessary packages related to the building of a Debian package;
+
* will install unecessary packages related to the building of a Debian package;
 
* may miss some new dependencies;
 
* may miss some new dependencies;
 
* may install packages that are no longer octave dependencies.
 
* may install packages that are no longer octave dependencies.
  
 
==== The right way ====
 
==== The right way ====
 +
The best 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 maintainer will solve automatically).
  
The right way is to install all the dependencies listed on the [[Building#Dependencies|Building]] wiki page.  One can either search for the respective packages manually on
+
{{Warning|Debian repositories has several libraries for dealing with HDF data files. The recommended is {{Codeline|libhdf5-serial-dev}}. However, the {{Forge|msh|msh package}} requires [http://www.geuz.org/gmsh/ gmsh] which is incompatible with it.}}
 
+
{{Warning|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  
* https://packages.debian.org
+
32.}}
* https://packages.ubuntu.com
+
{{Note|if only the native graphics toolkit will be used, gnuplot will not be necessary.}}
 
 
or, for the sake of convenience, use some "one-liner" to install them:
 
 
 
* '''Ubuntu 19.10'''
 
 
 
:<pre>sudo apt-get install gcc g++ gfortran make libblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev fig2dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-qt4-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev libsundials-dev</pre>
 
 
 
* '''Ubuntu 18.04 (LTS)'''
 
 
 
:<pre>sudo apt-get install gcc g++ gfortran make libblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libsuitesparse-dev texlive texlive-generic-recommended libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev</pre>
 
 
 
* '''Ubuntu 16.04 (LTS)'''
 
 
 
:<pre>sudo apt-get install gcc g++ gfortran make libblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar</pre>
 
 
 
* '''Debian 9'''
 
 
 
:<pre>sudo apt-get install gcc g++ gfortran make libblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libjack-jackd2-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar</pre>
 
 
 
* '''Debian 8'''
 
 
 
:<pre>sudo apt-get install gcc g++ gfortran make libblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-7-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar</pre>
 
 
 
 
 
{{Warning|<ul><li>The Debian repositoriy has several libraries for dealing with HDF data files. The recommended is {{Codeline|libhdf5-serial-dev}}. However, the {{Forge|msh|msh package}} requires [http://www.geuz.org/gmsh/ gmsh] which is incompatible with it.</li>
 
<li>The GraphicsMagick++ library (libgraphicsmagick++1-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.</li>
 
<li>For debian9 using openjdk-9-jdk (even providing  {{Codeline|JAVA_HOME}}) could *not* be used for the java interface! Use openjdk-8-jdk instead.</li>
 
<li>When configure decides to use QT5 instead of QT4, make might fail because lrelease is missing (see [https://savannah.gnu.org/bugs/?50580 bug 50580]).  It can be fixed by installing {{Codeline|qttools5-dev-tools}}</li>
 
</ul>}}
 
 
 
=== Configuration ===
 
 
 
Some Debian and Ubuntu specific configure tweaks are listed below:
 
 
 
==== Java ====
 
 
 
Autodetection for Java should work well on Debian-based systems. A specific Java version can be specified by passing {{codeline|JAVA_HOME}} to configure, for example
 
 
 
./configure JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
 
 
 
==== HDF5 ====
 
 
 
On older versions of Debian and Ubuntu, you may get the following warning when building an older version of Octave 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 may be required to specify the location of the libraries.  See bug {{bug|38928}} for details (starting with comment #19) but basically, use the following when running configure:
 
 
 
./configure --with-hdf5-includedir=/usr/include/hdf5/serial --with-hdf5-libdir=/usr/lib/x86_64-linux-gnu/hdf5/serial
 
 
 
On older versions of Debian and Ubuntu, where only one flavor of the HDF5 library could be installed at a time, you may need to build Octave against one of the MPI-enabled flavors. On these older systems, configuring Octave like this may work:
 
 
 
./configure CPPFLAGS="-I/usr/include/mpi -DMPICH_SKIP_MPICXX -DOMPI_SKIP_MPICXX"
 
 
 
==== Sundials ====
 
  
On recent Debian and Ubuntu releases whose Sundials version (in {{codeline|libsundials-dev}}) is 3.1, a configure flag needs to be passed for {{codeline|ode15i}} and {{codeline|ode15s}} to be compiled with support for sparse Jacobians (bug {{bug|55937}}), as follows:
+
* build tools
 +
:<pre>g++ gcc gfortran make</pre>
 +
* external packages
 +
:<pre>libblas-dev liblapack-dev libpcre3-dev</pre>
 +
* optional but ''strongly'' recommended. Check the [http://www.gnu.org/software/octave/doc/interpreter/External-Packages.html Octave manual] for more information on them. Packages marked with * are virtual packages (you'll have to pick one of the displayed versions).
 +
:{| class="wikitable"
 +
|-
 +
! Dependency        !! Debian Squeeze          !! Ubuntu X
 +
|-
 +
| ARPACK            || libarpack2-dev          ||
 +
|-
 +
| cURL              || libcurl4-gnutls-dev      ||
 +
|-
 +
| FFTW3            || libfftw3-dev            ||
 +
|-
 +
| FLTK              || libfltk-dev *            ||
 +
|-
 +
| fontconfig        || libfontconfig1-dev      ||
 +
|-
 +
| FreeType          || libfreetype6-dev        ||
 +
|-
 +
| GLPK              || libglpk-dev              ||
 +
|-
 +
| GNU Readline      || libreadline-dev          ||
 +
|-
 +
| gnuplot          || gnuplot                  ||
 +
|-
 +
| GraphicsMagick++  || libgraphicsmagick++-dev  ||
 +
|-
 +
| HDF5              || libhdf5-serial-dev      ||
 +
|-
 +
| OpenGL            || libgl-dev *              ||
 +
|-
 +
| Qhull            || libqhull-dev            ||
 +
|-
 +
| QRUPDATE          || libqrupdate-dev          ||
 +
|-
 +
| SuiteSparse      || libsuitesparse-dev      ||
 +
|-
 +
| makeinfo          || texinfo                  ||
 +
|-
 +
| zlib              || zlib1g-dev               ||  
 +
|-
 +
|}
  
./configure CPPFLAGS="-I/usr/include/suitesparse"
+
==== Building development version ====
 +
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.
  
== See also ==
+
Note that the current development release you shuld run {{Codeline|./bootstrap}} instead of the old {{Codeline|./autogen}}
  
* [[MXE]] -- a more customized Octave build including many self-compiled tools.
+
* development tools
 +
:<pre>autoconf automake bison flex gperf gzip libtool make perl rsync tar</pre>
 +
* dependencies for the development release
 +
:{| class="wikitable"
 +
|-
 +
! Dependency  !! Debian Squeeze      !! Ubuntu X
 +
|-
 +
| GTK theme?  || gtk2-engines-pixbuf  ||
 +
|-
 +
| Java JDK    || openjdk-7-jdk        ||
 +
|-
 +
| LLVM        || libfftw3-dev        ||
 +
|-
 +
| QScintilla  || libqscintilla2-8    ||
 +
|-
 +
| Qt          || libqtcore4 libqtwebkit4 libqt4-network libqtgui4 ||
 +
|-
 +
|}
  
[[Category:Building]]
 
 
[[Category:Installation]]
 
[[Category:Installation]]
[[Category:GNU/Linux]]
 

Please note that all contributions to Octave may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see Octave:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)