Editing Installing MacOS X Bundle

{{Warning|This page is outdated (October 2019). For more information, see [[Octave for macOS]].}}

These install instructions are verified to allow the [http://sourceforge.net/projects/octave/files/Octave%20MacOSX%20Binary/2011-04-21%20binary%20of%20Octave%203.4.0/ October 04, 2011 binary for Octave 3.4.0 (hosted on sourceforge)] to run on MacOS 10.7.  They do not work for MacOS 10.8.

= Download the DMG =

There is an experimental dmg for Octave 4.0.0. See the bottom of [http://octave.1599824.n4.nabble.com/Mac-OS-Binary-td4673521.html#a4673576 this mailing list discussion]. Testers are very welcome.

The latest MacOS X binary (DMG) available is for Octave-3.4.0. Click on this [http://sourceforge.net/projects/octave/files/Octave%20MacOSX%20Binary/2011-04-21%20binary%20of%20Octave%203.4.0/ link] to download.

Once it has been downloaded, double-click on the dmg to mount the disk image. It is recommended 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 [http://en.wikipedia.org/wiki/Quartz_(graphics_layer) 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.  The symbolic links will be placed in /usr/local/bin. It is a good idea to verify that neither /usr/local/bin/gnuplot or /usr/local/bin/octave already exist there, as they will be replaced.

* Open a new terminal window, and enter the commands below.
** {{Codeline|sudo ln -sf /Applications/gnuplot.app/Contents/Resources/bin/gnuplot /usr/local/bin/gnuplot}}
** {{Codeline|sudo ln -sf /Applications/Octave.app/Contents/Resources/bin/octave /usr/local/bin/octave}}
* Test that everything is ok.
** In a Terminal window type the command below.
*** {{Codeline|octave}}
** Octave should now be running. To test Gnuplot / Aquaterm, try a plot.
*** {{Codeline|sombrero ()}}

If Octave did not run ''(or if octave is running but the sombrero() command doesn't appear to do anything)'', check to ensure that your PATH includes /usr/local/bin.

* From the Terminal prompt, type,
** {{Codeline|env}}
* If the PATH does not include /usr/local/bin, type the commands below.
** Open ~/.bashrc in an editor
*** {{Codeline|touch ~/.bashrc}}
*** {{Codeline|open ~/.bashrc}}
** Add the line below to the contents of ~/.bashrc
*** {{Codeline|<nowiki>export PATH=$PATH:/usr/local/bin</nowiki>}}
** Save ~/.bashrc and exit
* If the PATH does include /usr/local/bin, help may be requested by posting to [https://mailman.cae.wisc.edu/listinfo/help-octave Octave's email list]. Please provide a detailed description of what you've tried and what the results were.

[[Category:Outdated pages]]