Download: Difference between revisions

From Madagascar
Jump to navigation Jump to search
← Older editNewer edit →
Sfomel (talk | contribs)
Bureaucrats, Administrators, widgeteditor
1,611 edits
Sfomel (talk | contribs)
Bureaucrats, Administrators, widgeteditor
1,611 edits
obsolete subversion
Line 1: Line 1:
[[Image:Fotolia_2043821_XS.jpg|right|]]
[[Image:Fotolia_2043821_XS.jpg|right|]]
You can choose to download either the latest stable release, or the current development version (frequently updated).
You can choose to download either the latest stable release or the current development version (which is frequently updated).


==Stable release==
==Stable release==
Line 8: Line 8:
or  
or  
<pre>bunzip2 < madagascar-*.tar.bz2 | tar xvf -</pre>
<pre>bunzip2 < madagascar-*.tar.bz2 | tar xvf -</pre>
The <tt>bz2</tt> file is a bit smaller, but takes longer to unpack.  
The <tt>bz2</tt> file is smaller but takes longer to unpack.  


Next, follow [[Installation|Installation instructions]] to install.
Next, follow [[Installation|Installation instructions]] to install.
Line 27: Line 27:
Next, follow [[Installation|Installation instructions]] to install.
Next, follow [[Installation|Installation instructions]] to install.


===Checking out with Subversion===
==Other packages==


To download the source repository using [http://subversion.apache.org/ Subversion], run
Two other packages might be useful in conjunction with Madagascar:
<pre>
svn co <nowiki>https://github.com/ahay/src/trunk</nowiki> RSFSRC
</pre>


After the initial check out, you can update the Madagascar source code on your computer with the changes made by developers: <tt>cd</tt> to the directory where you placed the sources and run
<pre>
svn update
</pre>
===SVN Troubleshooting===
 
*If, after running the <tt>svn</tt> 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 <tt>svn</tt> through &ndash; most likely 80, the standard HTTP port. Open your <tt>~/.subversion/servers</tt> file in a text editor. If this file does not exist, running any <tt>svn</tt> command (even an unsuccessful one, like the one above) will automatically create the file. In the <tt>[global]</tt> section, add the following lines, with your own proxy URL and port names instead of the dummy ones below:
<pre>http-proxy-host = www-proxy.yourcompany.com
http-proxy-port = 80
</pre> Now your <tt>svn</tt> commands should work. You can find more details [http://subversion.tigris.org/faq.html#proxy in the Subversion documentation]. It would also be a good idea to set in your <tt>.bashrc</tt> or <tt>.cshrc</tt> the environment variable <tt>HTTP_PROXY</tt> to your adaptation of <pre>http://www-proxy.yourcompany.com:80</pre> so that input datasets for reproducible figures can be downloaded automatically when you need them.
*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 (<nowiki>https://</nowiki>).  If <tt>svn</tt> complains about an "unrecognized URL scheme" (and you've given it the correctly formatted URL), then you need to update it.
*If you are behind a firewall, you may need to set up more variables in your file <tt>~/.subversion/servers</tt> (check with your IT support for all the required variables to get past the proxy) as for example
<pre>
[global]
http-proxy-host = proxy-host-company.site.corp
http-proxy-port = 1111
http-proxy-username = Yourusernameforproxy
http-proxy-password = Yourpasswordforproxy
</pre>
It would be a good idea then to protect your file <tt>~/.subversion/servers</tt> from being read by others.
==Other packages==
There are two other packages that might be useful in conjunction with Madagascar:
===Reproducible figures===
===Reproducible figures===


Line 65: Line 36:
<pre>git clone <nowiki>https://github.com/ahay/figs</nowiki> $RSFROOT/share/madagascar/figs </pre>
<pre>git clone <nowiki>https://github.com/ahay/figs</nowiki> $RSFROOT/share/madagascar/figs </pre>
    
    
Alternatively, using Subversion, run
This installs a large coalition of thousands of reproducible figures. It may take a long time to download and about 20 GB of disk space.
<pre>svn co <nowiki>https://github.com/ahay/figs/trunk</nowiki> $RSFROOT/share/madagascar/figs </pre>
The figures are preserved for regression testing whenever the software or the environment changes.
 
This installs a wide collection of almost 8,000 reproducible figures. It may take a long time to download and about 15 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 (excluding those generated with proprietary data or additional software) by running <tt>scons lock</tt> in individual project directories or by going to <tt>RSFSRC</tt> and running  
You can reproduce the figures (excluding those generated with proprietary data or additional software) by running <tt>scons lock</tt> in individual project directories or by going to <tt>RSFSRC</tt> and running  

Revision as of 23:31, 7 October 2024

You can choose to download either the latest stable release or the current development version (which is frequently updated).

Stable release

Download the source code distribution from Sourceforge, then unpack the directory with 

gunzip < madagascar-*.tar.gz | tar xvf -

or 

bunzip2 < madagascar-*.tar.bz2 | tar xvf -

The bz2 file is smaller but takes longer to unpack.

Next, follow Installation instructions to install.

Current development version

You can access the most recent Madagascar source code at the GitHub repository

Cloning with Git

To download the source repository using Git, run 

git clone https://github.com/ahay/src RSFSRC

Replace RSFSRC with the path where you want to put the Madagascar source code.

Next, follow Installation instructions to install.

Other packages

Two other packages might be useful in conjunction with Madagascar:

Reproducible figures

Using Git, run 

git clone https://github.com/ahay/figs $RSFROOT/share/madagascar/figs

This installs a large coalition of thousands of reproducible figures. It may take a long time to download and about 20 GB of disk space. The figures are preserved for regression testing whenever the software or the environment changes.

You can reproduce the figures (excluding those generated with proprietary data or additional software) by running scons lock in individual project directories or by going to RSFSRC and running 

sfbooklist command="scons lock" book

LaTeX package

SEGTeX is a LaTeX package for geophysical publications. It can be used with Madagascar for writing reproducible papers.

Retrieved from "https://ahay.org/index.php?title=Download&oldid=4038"