Installing MacOS X Bundle

Revision as of 23:27, 5 April 2012 by Bpabbott (talk | contribs) (add "chmod 755 ...")

These install instructions are verified to work for the October 04, 2011 binary for Octave 3.4.0, hosted on sourceforge.

Download the DMG

The latest MacOS X binary (DMG) available is for Octave-3.4.0. Click on this link to download.

Once it has been downloaded, double-click on the dmg to mount the disk image. It is recomended that gnuplot is installed prior to Octave.

Install gnuplot & Aquaterm

NOTE: The following instructions are for the gnuplot in the 'Extras' folder, which DOES NOT WORK, due to some library version issues. Instead you could install a gnuplot binary from http://www.miscdebris.net/upload/gnuplot-4.2.5-i386.dmg. Or you could try using MacPorts to install gnuplot.

Look in the 'Extras' folder and find the gnuplot-4.4.3-aqua-i386.dmg disc image. Double-click this dmg to mount the gnuplot disk image.

On this disk is the OS X binary for gnuplot. The gnuplot package includes and relies on Aquaterm for displaying plots using Apple's Quartz graphics layer. Alternatively, X11 can be used. However, the pleasant anti-aliasing features of Quartz will are not included with X11 on MacOS X. It is unclear how to tell gnuplot whether to use X11 or Aquaterm.

Move the 'gnuplot' icon to your Applications folder. For purpose of this discussion - this is assumed to be /Applications. If you are using a local Applications folder (/~/Applications) appropriate modification of the paths specified below will be necessary.

This gnuplot application includes Aquaterm. It is located at /Applications/gnuplot.app/Contents/Resources/lib/Aquaterm.app If you need it for some other application, this is the path that will find it. But don't move it to the upper level of the Applications folder, or else gnuplot will not know where to find it.

Install Octave

Move the 'Octave' icon from the first .dmg to the Applications folder (/Applications).

Now you have everything you need to run Octave, gnuplot, and Aquaterm. You can put the Octave and gnuplot icons in the dock and either will open in a terminal window with a simple 'click'. To test Octave, click its icon, and the Octave prompt should appear in a new terminal window along with some splash screen information. Then type 'sombrero(24)' at the Octave prompt and after a while aquaterm will open and the multicolor sombrero plot should appear.

Running Octave and gnuplot from a Terminal

These instructions assume you have already placed Octave and Gnuplot into the Applications folder.

Starting Octave from the command line requires one further step to inform bash (your shell) where the Octave binary is located. This is accomplished through the bash initialization file ~/.bashrc (the leading "." means it's normally invisible in the finder). To run Octave and gnuplot from a terminal, symbolic links will be used.

  • Open a new terminal window, and enter the commands below.
    • sudo touch /usr/local/bin/gnuplot
    • sudo ln -s /Applications/gnuplot.app/Contents/Resources/bin/gnuplot /usr/local/bin/gnuplot
    • sudo chmod 755 /usr/local/bin/gnuplot
    • sudo touch /usr/local/bin/octave
    • sudo ln -s /Applications/Octave.app/Contents/Resources/bin/octave /usr/local/bin/octave
    • sudo chmod 755 /usr/local/bin/octave
  • Test that everything is ok.
    • In a Terminal window type the command below.
      • octave
    • Octave should now be running. To test gnuplot / Aquaterm, try a plot.
      • sombrero ()

If Octave did not run, check to ensure that your PATH includes /usr/local/bin.

  • From the Terminal prompt, type,
    • env
  • If the PATH does not include /usr/local/bin, type the commands below.
    • Open ~/.bashrc in an editor
      • touch ~/.bashrc
      • open ~/.bashrc
    • Add the line below to the contents of ~/.bashrc
      • export PATH=$PATH:/usr/local/bin
    • Save ~/.bashrc and exit
  • If the PATH does include /usr/local/bin, help may be requested by posting to Octave's email list. Please provide a detailed description of what you've tried and what the results were.