Installing MacOS X Bundle: Difference between revisions

From Octave
Jump to navigation Jump to search
(No part of "gnuplot" is capitalised.)
Line 5: Line 5:
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 recomended 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 =


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. However, the pleasant anti-aliasing features of Quartz will are not included with X11 on MacOS X.
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.
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.


NOTE: The GnuPlot in the 'Extras' folder 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.
NOTE: The gnuplot in the 'Extras' folder 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.


= Install Octave =
= Install Octave =
Line 24: 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 =


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.
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 touch /usr/local/bin/gnuplot}}
** {{Codeline|sudo touch /usr/local/bin/gnuplot}}
** {{Codeline|sudo ln -s /Applications/Gnuplot.app/Contents/Resources/bin/gnuplot /usr/local/bin/gnuplot}}
** {{Codeline|sudo ln -s /Applications/gnuplot.app/Contents/Resources/bin/gnuplot /usr/local/bin/gnuplot}}
** {{Codeline|sudo touch /usr/local/bin/octave}}
** {{Codeline|sudo touch /usr/local/bin/octave}}
** {{Codeline|sudo ln -s /Applications/Octave.app/Contents/Resources/bin/octave /usr/local/bin/octave}}
** {{Codeline|sudo ln -s /Applications/Octave.app/Contents/Resources/bin/octave /usr/local/bin/octave}}
Line 38: Line 38:
** 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 ()}}



Revision as of 20:02, 25 March 2012

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

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.

NOTE: The gnuplot in the 'Extras' folder 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.

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

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 touch /usr/local/bin/octave
    • sudo ln -s /Applications/Octave.app/Contents/Resources/bin/octave /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.