Editing Installing MacOS X Bundle

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 publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{Warning|This page is outdated (October 2019). For more information, see [[Octave for macOS]].}}
These install instructions are verified to work for 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.
 
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 =
= 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.
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.
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 =
= 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.
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.
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. If your entire data set is easily visible and you do not need to zoom in, you may prefer the pleasant anti-aliasing features of Quartz and Aquaterm. On the other hand, if your data set is too large or complicated to be easily visible, you may prefer to use X11, which allows you to zoom in and out of regions, set crosshairs at points, and other more advanced features.  Aquaterm is the default, but you can change the default to X11 by creating a file called .bash_profile in your home directory (note the period at the beginning of the file name) and adding the line "export GNUTERM=x11" (without the quotes).
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.
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.
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 =
= Install Octave =
Line 27: Line 24:
Move the 'Octave' icon from the first .dmg to the Applications folder (/Applications).
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.   
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 =
= Running Octave and gnuplot from a Terminal =


These instructions assume you have already placed Octave and Gnuplot into the Applications folder.
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.
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.
* 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 touch /usr/local/bin/gnuplot}}
** {{Codeline|sudo ln -sf /Applications/Octave.app/Contents/Resources/bin/octave /usr/local/bin/octave}}
** {{Codeline|sudo ln -s /Applications/gnuplot.app/Contents/Resources/bin/gnuplot /usr/local/bin/gnuplot}}
** {{Codeline|sudo chmod 755 /usr/local/bin/gnuplot}}
** {{Codeline|sudo touch /usr/local/bin/octave}}
** {{Codeline|sudo ln -s /Applications/Octave.app/Contents/Resources/bin/octave /usr/local/bin/octave}}
** {{Codeline|sudo chmod 755 /usr/local/bin/octave}}
* Test that everything is ok.
* Test that everything is ok.
** In a Terminal window type the command below.
** In a Terminal window type the command below.
*** {{Codeline|octave}}
*** {{Codeline|octave}}
** Octave should now be running. To test Gnuplot / Aquaterm, try a plot.
** Octave should now be running. To test gnuplot / Aquaterm, try a plot.
*** {{Codeline|sombrero ()}}
*** {{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.
If Octave did not run, check to ensure that your PATH includes /usr/local/bin.


* From the Terminal prompt, type,
* From the Terminal prompt, type,
Line 56: Line 57:
** Save ~/.bashrc and exit
** 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.
* 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]]
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)

Templates used on this page: