MXE

From Octave
Jump to navigation Jump to search

MXE-Octave was forked 2012 from the MXE project and is useful for building Octave in the following scenarios[1]:

  1. Cross-compilation for MS Windows (see also Windows Installer) and other platforms.
  2. Building Octave on outdated Linux systems (e.g. only an old GCC version is available).
  3. Building Octave without root permission.
Warning icon.svg
MXE-Octave is not the best choice for building Octave, if your system already provides recent versions of GCC and other required build dependencies. See Category:Installation for other install options.

Example of compiling MXE-Octave[edit]

Preparation[edit]

  1. Install all requirements of MXE Octave.
  2. Decide for an installation directory (e.g. ~/mxe-octave).
  3. cd ~
  4. hg clone https://hg.octave.org/mxe-octave mxe-octave
  5. cd mxe-octave
  6. ./bootstrap

Configuration[edit]

For a comprehensive list of configuration options with a short explanation, type ./configure --help. See also the known issues below.

./configure \
    --prefix=$HOME/mxe-octave \
    --enable-native-build \
    --enable-octave=release \
    --enable-64 \
    --enable-binary-packages \
    --enable-devel-tools \
    --enable-fortran-int64 \
    --enable-lib64-directory \
    --enable-openblas \
    --enable-pic-flag \
    --disable-system-fontconfig \
    --disable-system-gcc \
    --disable-system-opengl \
    --disable-system-x11-libs \
    --with-ccache \
    gnu-linux

Build[edit]

make -j3 JOBS=2 all openblas Adapt the values of the variables -j (parallel package builds) and JOBS (parallel build jobs) to your needs.

Replace reference BLAS by OpenBLAS[edit]

In general using the OpenBLAS library results in faster matrix-vector operations compared to the reference BLAS library.

  1. cd ~/mxe-octave/usr/lib
  2. mv libblas.so libblas.so.reference
  3. ln -s libopenblas.so libblas.so

Run[edit]

  1. MXE-Octave will exist in ~/mxe-octave/usr/bin
  2. Add the command octave as alias to your .bashrc file: alias octave=~/mxe-octave/usr/bin/octave
  3. Start MXE-Octave by typing octave.

Known issues[edit]

gnuplot[edit]

The gnuplot built by MXE-Octave does not support cairo based terminals and lua/tikz terminals. If you want uses those features, prepare gnuplot with those features and type in the Octave command prompt

 >> gnuplot_binary /usr/bin/gnuplot

Build errors on older systems[edit]

On some older systems, it might be useful to consider adding the configuration options

  • --disable-docs
  • --disable-java

in case of building errors.


References[edit]