Download
You can choose to download either the latest stable release, or the current development version (frequently updated).
Stable release
Precompiled binary packages
A Mac OS X precompiled binary package of the latest Madagascar stable release is available for download from Sourceforge. Download a disk image file appropriate for your hardware: madagascar-*.macosx.ppc.dmg for a PowerPC Mac or madagascar-*.macosx.i386.dmg for an Intel Mac. Mount the disk image if it does not mount automatically, launch the installer package inside the disk image, and follow the instructions. Additional instructions can be found in the ReadMe file.
The Mac OS X Madagascar package installs the main programs, documentation files, includes files, and libraries in /usr/local/rsf. You will be asked for an administrator password. The collection of Madagascar examples included with the source code release is not yet included with this package, but that may change so check back here occasionally for updates.
Source code distribution
Download the source code distribution securely from Sourceforge, then unpack the directory with
gunzip < madagascar-*.tar.gz | tar xvf -
or
bunzip2 < madagascar-*.tar.bz2 | tar xvf -
The bz2 file is a bit smaller, but takes longer to unpack.
Next, follow Installation instructions to install.
Current development version
You need to have a Subversion client (svn) installed. To download the directory with the Madagascar source code, run the following command:
svn co https://rsf.svn.sourceforge.net/svnroot/rsf/trunk RSFSRC
Replace RSFSRC with the path where you want to put the Madagascar source code.
Next, follow Installation instructions to install.
You can also browse the Subversion repository.
Updating
To update the Madagascar source code on your computer with the changes made by developers, cd to the directory where you placed the sources and run
svn update
Troubleshooting
- If, after running the svn co... command, nothing happens, no message, no return to the command line: you may be behind a proxy. This is especially likely if your computer is on a corporate Intranet. To get past a proxy, you need to tell Subversion: (1) The IP number or URL of the proxy and (2) the port that will allow svn through – most likely 80, the standard HTTP port. Open your ~/.subversion/servers file in a text editor. If this file does not exist, running any svn command (even an unsuccessful one, like the one above) will automatically create the file. In the [global] section, add the following lines, with your own proxy URL and port names instead of the dummy ones below:
http-proxy-host = www-proxy.yourcompany.com http-proxy-port = 80
Now your svn commands should work. You can find more details at http://subversion.tigris.org/faq.html#proxy.
- If you get a "is already a working copy for a different URL" error, this means you have an existing directory downloaded from another server. Run svn switch --relocate to switch servers.
- If you are using an old Linux distribution (e.g. RedHat 9), the version of Subversion included with your distribution may need to be updated to handle the secure URL (https://). If svn complains about an "unrecognized URL scheme" (and you've given it the correctly formatted URL), then you need to update it.
Other packages
There are two other packages that might be useful in conjunction with RSF:
Reproducible figures
- Using Subversion, run
svn co https://rsf.svn.sourceforge.net/svnroot/rsf/figs $RSFROOT/figs
This installs a wide collection of about 900 reproducible figures. It may take a long time to download and more than 4 Gb of disk space. The figures are preserved with the purpose of regression testing whenever the software or the environment change.
You can reproduce the figures by running scons lock in individual project directories or by going to RSF/book and running
sftour sftour sftour scons lock
LATEX package
SEGTeX is a LaTeX package for geophysical publications. It can be used with madagascar for writing reproducible papers.