Mac OS X

Much of the previous generic Unix/Linux installation section applies also to OS X. Therefore this section deals mainly with the specifics of OS X installation, some of the steps listed here are explained in more detail in the generic Unix section.

Beside building everything on your own (good luck), at this time there are two ways to install Gwyddion:

Preparation

To install and run Gwyddion you need the Xcode Tools and X (SDK and App) installed. They where located on your CDs/DVDs. The Xcode Tools where located on the first DVD as XcodeTools.mpkg below Xcode Tools, the X11SDK is located as X11SDK.pkg below the Packages Folder within Xcode Tools. X11 is localed as X11User.pkg below System/Installation/Packages even on the first DVD. If you have an CD Set the Discs may differ. The people from MacPorts recommending using the newest version of XCode. For further information look at the MacPorts Install Page. Also you should have some experience using Terminal.app. All the commands in the the rest of this section are to be entered and run in Terminal.app.

See installation dependencies section for an overview of required and optional packages to install prior to Gwyddion installation. The following table summarises how they are called in the two software collections:

PackageFinkMacPorts
Gtk+gtk+2gtk2
GtkGLExtgtkglext1gtkglext
FFTW3fftw3fftw-3
LibXML2libxml2libxml2

MacPorts

MacPorts is a Port based System for porting and installing Open Source/GNU software to OS X. It's based on using installation files called Portfiles which are describing the steps to compile and install an application. So it's far easy to port software to OS X using MacPorts but every computer has to compile the application. Get and install MacPorts. After you installed MacPorts, run

sudo port selfupdate

to update MacPorts to the latest version.

Usually installing ports with MacPorts is easy. But since X11 is not the native Desktop for OS X, things went a little worse. So it is recommended to install an alternative X11 before installing Gwyddion. The recommended alternatives are XQuartz on Leopard and the Port xorg-server on Tiger. After installing the suggested X11-System, Gwyddion can be then build and installed simply by

sudo port install gwyddion

To install xorg-server (Tiger) simply type

sudo port install xorg-server

this is needed for the 3D view on Tiger. After everything is done, you will find the StartUp-Icon below /Applications/MacPorts.

Fink

Get and install Fink. After you installed Fink run

apt-get update

to update the database of available packages and install Gwyddion with

apt-get install gwyddion

To install Gwyddion from source code, for instance if you want to install a development version, you need to install the required packages listed in the above table and then follow the generic Unix installation section instructions.

Running

On MacPorts you simply click on the StartUp-Icon and wait until Gwyddion appears. Using Fink or a self-compiled version you should follow the steps below: Start X11.app and type in Terminal.app

export DISPLAY=":0"

Then run Gwyddion from the folder it was installed to. This is typically /usr/local/bin for Fink. So for example for Fink run:

/usr/local/bin/gwyddion

You can also configure X11.app to run Gwyddion via: Locate X11.app in your dock, open the menu, choose Applications, choose Customize from the next menu. Here you can choose add and enter the name (Gwyddion for example) as Menu Name and the complete path to Gwyddion (e.g. /usr/local/bin/gwyddion) as Command. After this you can choose Gwyddion from the X11 menu.