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:

Free mac photo editing software download. The Mac OS version can be built using Xcode, and some pre-built binaries are available. Apple Darwin, or OpenDarwin is the only major platform Gwyddion has not been thoroughly tested on. Gwyddion program could also be ported to other branches of the BSD operating system. Gwyddion is Free and Open Source software, covered by GNU General Public License, and available for Linux, Mac, PC and more.

• using MacPorts (formerly Darwinports) and building from a Portfile.
• using Fink and installing Gwyddion using apt-get.
• using Homebrew and build Gwyddion using the brew formula.

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:

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

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

To install xorg-server (Tiger) simply type

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

Get and install Fink. After you installed Fink run

to update the database of available packages and install Gwyddion with

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.

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

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

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.

Gwyddion is a modular program for SPM (scanning probe microscopy) datavisualization and analysis. Primarily it is intended for the analysis of heightfields obtained by scanning probe microscopy techniques (AFM, MFM, STM,SNOM/NSOM) and it supportsa lot of SPM data formats.However, it can be used for general height field and (greyscale) imageprocessing, for instance for the analysis of profilometry data or thicknessmaps from imaging spectrophotometry.

Gwyddion provides a large number ofdata processing functions, includingall the standard statistical characterization, levelling and data correction,filtering or grain marking functions. And since the developers are activeSPM users, the program also contains a number of specific, uncommon, odd andexperimental data processing methods they found useful – and you may find themuseful too.

Gwyddion is Free and Open Source software, covered byGNU General Public License.It aims to provide a modular program for 2D data processing andanalysis that can be easily extended by third-party modules and scripts.Moreover, thanks to being free software, it provides the source code todevelopers and users, which makes easier both verification of its dataprocessing algorithms and further program improvements.

Gwyddion works on GNU/Linux, Microsoft Windows, Mac OS Xand FreeBSD operating systems on common architectures. All systems can beused also for development. It has a modern graphical user interface basedon the widely portable Gtk+ toolkit, consistentacross all the supported systems.

News

2020-09-17:Several new functions added to Gwyddion in the last two releases implement ideas described in our recent papers.Image terrace fittingand Graph terrace fittingimplement algorithms described in the Si step evaluation paper.The new Correlation length toolwas a repeatedly requested feature. However, it also helps with checking ifimage dimensions are sufficiently larger than the autocorrelation length forroughness measurement – as discussed in a couple of papers,one more technicaland one more high-level.

2020-07-29:To get working Gwyddion packages in Ubuntu you can use theGwyddion-SPM PPAinstead of the broken distro packages(bug 1882441). The PPA also provides more current versions of Gwyddion.

2020-07-12:Gwyddion package in Ubuntu 20.04 (possibly other versions?) is broken, failingto load any modules at startup due to linking issue. Seebug 1882441in Launchpad. At present there is no known workaround aside for compilationfrom source code (as dscribed in the bug report).

2020-06-30:Version 2.56 “Semiscale” was released. The main improvements are in fileformat support, but there is also a new tool for autocorrelation lengthestimation and the usual bunch of bugfixes and smaller improvements. See thedetailed news which contain the complete list ofchanges.

2020-06-08:Version 1.4 oflibgwyfilewas released. This is mainly a bugfix release, which also adds a couple offunctions for object and item copying.

2020-06-02:Version 1.3 oflibgwyfilewas released. The main addition is an interface for GWY files in memorybuffers. The library was also updated to handle new data types introduced inGwyddion 2.53.

2019

2019-11-04:Version 2.55 “Zzz…” was released. It is mainly a bugfix release bringing backZIP support in file import modules. However, there are also a few new volumedata modules or a number of file format support improvements. See thedetailed news for the complete list.

2019-09-22:Version 2.54 was, unfortunately, relased without ZIP support, meaning thata bunch of file formats cannot be loaded: APE DAX, OpenGPS, JPK force data,NanoObserver, NanoScanTech, Olympus POIR, Sensofar PLUx and SPMx. Thisaffects not just MS Windows executables, but ZIP support is silently disabledalso when you compile from source code. We will be releasing 2.55 in severalweeks with a fix. Please use version 2.53 or development snapshots meanwhileif you need to read some of the affected file formats.

2019-09-04:Version 2.54 added twosynthetic datamodules, one directly inspired by an old Yeti'sGIMP plug-in.We updated the replacementinformation to illustrate all the recently added data generators.

2019-08-27:Version 2.54 “A Small Step” was released. It fixes a large number of bugs,but also brings a dozen new modules – data process, file, graph – and varioussmaller improvements. See thedetailed news for the complete list.

2019-06-05:Gwyddion is now available as Flatpak app,a cross-distro way of installing stable bundled applications. See thedownload page for more. In relatednews, the Fedora 30 repository should be finally working.

2019-05-09:We added a paperdescribing some recently added MFM data processing methods to thepublication list.

2019-03-06:Apatchfor version 2.53 was published, fixing Gwyddion being unable to find icons andsimilar data on a Mac.See also Patches.

2019-02-28:Apatchfor version 2.53 was published, fixing a compilation error with GCC 9. Itbreaks compilation with other GCC versions, so only apply it when necessary.See also Patches.

2019-02-28:Version 2.53 “OMGOMP” was released. It adds OpenMP parallelisation for a bunchof data processing operations. There are also improvements in basic tools,a few new modules and some bug fixes as usual. See thedetailed news for the complete list.

2018

2018-11-21:We would like to invite you to the next biannualSPM workshopwhich will take place in Lednice (Czech Republic), 27–29 March 2019.Registration will open in November (or December).

2018-11-15:Apatchfor version 2.52 was published, fixing a build failure on macOS.See also Patches.

2018-11-14:Version 2.52 “Thoroughly Transferred” was released. It brings a few new fileimport modules, some improvements mainly in MFM and volume data processing andquite a few bug fixes. See the detailed news forthe complete list.

2018-10-17:Since Debian is – unfortunately – is going to terminate GTK+2 support, notethat it will become rather difficult to install and use Gwyddion in Debian.Not much can be done except the recommendation to use a Linux distributionwhich values backward compatibility instead.

Gwyddion Roughness

2018-06-26:Version 2.51 “Astronomical Almanac” was released. It brings over a dozen newmodules, many of them MFM and volume data processing-related. See thedetailed news for the complete list ofimprovements and bug fixes.

Gwyddion Tutorial

2018-04-11:Code revisions 20955–20958 were lost due to a SF.net outage. The code itselfhas been recommitted, however, the new revision history is not identical. Ifyou have a working copy updated to the lost revisions, you may be getting errormessages from svn. Please assume your working copy is toast and check outa fresh one if it happens.

2018-03-16:We are happy to announce the publication of the second edition of the bookQuantitative Data Processing in Scanning Probe Microscopyby Elsevier. It includes descriptions of many ideas in (and behind) Gwyddion,as well as basics of different physical quantities measurements andinterpretation using Scanning Probe Microscopy. It is accompaniedwith a set of freely available sample data coveringvarious types of SPM measurements.

2018-02-02:Version 2.50 “Triangular Trap” was finally released. See thedetailed news for the complete list ofnew modules, file format support improvements and other changes.

2017

2017-09-17:Yeti's talk Gwyddion – Open source software for SPM data analysiswas added to presentations.

2017-08-28:Apatchfor version 2.49 was published, fixing build problems when sed is BSD sed,i.e. on Mac OS X and BSD systems.See also Patches.

2017-08-15:Version 2.49 “Window to the West” was released. As usual, it brings a bundleof new modules and various improvements – and also module bundles. The mostnoticeable changes are, nevertheless, a new much nicer icon set by Felix Klingand a better widget for adjusting the bazillion parameters of variousalgorithms. See the detailed newsfor the complete list of changes.

2017-08-12:Petr's talk Gwyscan – library for smart scanning paths aboutgwyscanwas added to presentations. See also therelated paper.

2017-08-11:There seems to be still some interest inGIMPimage generation plug-ins Yeti wrote 15 years ago – and abandoned essentiallywhen Gwyddion development started. Although resurrection is unlikely, the goodnews is that their ideas have found their way into Gwyddion synthetic datamodules. We added some information aboutthe correspondence betweenthem.

2017-08-07:A Fedora 26 repository was added.

2017-05-11:A list of Gwyddion-related publications wasadded – more specifically, publications describing Gwyddion architecture andalgorithms or otherwise related to the software in a fundamental manner.

2017-04-29:Version 2.48 “Magnetic Monastery” was released. It brings a bunch ofMFM-related modules as well as the usual collection of new and improved fileimport modules and bugfixes. There is also a new translation, BrazilianPortugese. See the detailed newsfor the complete list of changes.

Thanks

Gwyddion Afm

Gwyddion development is supported byDepartment of Nanometrology, Czech Metrology Institute.