Download - Revision history

Sfomel: /* Current development version */

2024-10-07T23:32:49Z

Current development version

← Older revision		Revision as of 23:32, 7 October 2024
Line 15:		Line 15:

	You can access the most recent Madagascar source code at the [https://github.com/ahay/src GitHub repository]		You can access the most recent Madagascar source code at the [https://github.com/ahay/src GitHub repository]

	~~===Cloning with Git===~~

	To download the source repository using [https://git-scm.com/ Git], run		To download the source repository using [https://git-scm.com/ Git], run

Sfomel: obsolete subversion

2024-10-07T23:31:55Z

obsolete subversion

← Older revision		Revision as of 23:31, 7 October 2024
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 – 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

Sfomel: /* Reproducible figures */

2015-07-27T23:52:44Z

Reproducible figures

← Older revision		Revision as of 23:52, 27 July 2015
Line 61:		Line 61:
	There are two other packages that might be useful in conjunction with Madagascar:		There are two other packages that might be useful in conjunction with Madagascar:
	===Reproducible figures===		===Reproducible figures===

			Using Git, run
			<pre>git clone <nowiki>https://github.com/ahay/figs</nowiki> $RSFROOT/share/madagascar/figs </pre>

	~~Using~~ Subversion, run		Alternatively, using Subversion, run
	<pre>svn co ~~http~~://~~svn~~.~~code.sf.net~~/p/~~rsf~~/~~code~~/~~figs~~ $RSFROOT/share/madagascar/figs </pre>		<pre>svn co <nowiki>https://github.com/ahay/figs/trunk</nowiki> $RSFROOT/share/madagascar/figs </pre>
	This installs a wide collection of ~~more than 5~~,000 reproducible figures. It may take a long time to download and ~~more than 6~~ Gb of disk space.
			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.		The figures are preserved with the purpose of regression testing whenever the software or the environment change.

Sfomel: /* Other packages */

2015-07-26T22:46:40Z

Other packages

← Older revision		Revision as of 22:46, 26 July 2015
Line 59:		Line 59:

	==Other packages==		==Other packages==
	There are two other packages that might be useful in conjunction with ~~RSF~~:		There are two other packages that might be useful in conjunction with Madagascar:
	===Reproducible figures===		===Reproducible figures===

Line 72:		Line 72:
	===LaTeX package===		===LaTeX package===

	[[SEGTeX]] is a LaTeX package for geophysical publications. It can be used with ~~madagascar~~ for writing [[Reproducible Documents\|reproducible papers]].		[[SEGTeX]] is a LaTeX package for geophysical publications. It can be used with Madagascar for writing [[Reproducible Documents\|reproducible papers]].

Sfomel: /* Current development version */

2015-07-26T21:55:51Z

Current development version

← Older revision		Revision as of 21:55, 26 July 2015
Line 22:		Line 22:
	git clone <nowiki>https://github.com/ahay/src</nowiki> RSFSRC		git clone <nowiki>https://github.com/ahay/src</nowiki> RSFSRC
	</pre>		</pre>

			Replace <tt>RSFSRC</tt> with the path where you want to put the Madagascar source code.

			Next, follow [[Installation\|Installation instructions]] to install.

	===Checking out with Subversion===		===Checking out with Subversion===
Line 34:		Line 38:
	svn update		svn update
	</pre>		</pre>

	~~Replace <tt>RSFSRC</tt> with the path where you want to put the Madagascar source code.~~

	~~Next, follow [[Installation\|Installation instructions]] to install.~~

	===SVN Troubleshooting===		===SVN Troubleshooting===

Sfomel: /* Current development version */

2015-07-26T21:54:58Z

Current development version

← Older revision		Revision as of 21:54, 26 July 2015
Line 14:		Line 14:
	==Current development version==		==Current development version==

	~~To download~~ the most recent Madagascar source code~~, you need to have a~~ [~~http~~://~~subversion~~.~~apache.org~~/ ~~Subversion client~~] ~~(<tt>svn<~~/~~tt>) installed~~. ~~If you want to download it read-only~~, run ~~the following command:~~		You can access the most recent Madagascar source code at the [https://github.com/ahay/src GitHub repository]

			===Cloning with Git===

			To download the source repository using [https://git-scm.com/ Git], run
	<pre>		<pre>
	~~svn co~~ <nowiki>~~http~~://~~svn~~.~~code.sf.net/p/rsf~~/~~code~~/~~trunk~~</nowiki> RSFSRC		git clone <nowiki>https://github.com/ahay/src</nowiki> RSFSRC
	</pre>		</pre>
	~~Replace <tt>RSFSRC</tt>~~ with the ~~path where you want to put the Madagascar~~ source ~~code~~.
	~~If you are a Madagascar project contributor and you want to download it in read-write mode~~, ~~use~~		===Checking out with Subversion===

			To download the source repository using [http://subversion.apache.org/ Subversion], run
	<pre>		<pre>
	svn co \		svn co <nowiki>https://github.com/ahay/src/trunk</nowiki> RSFSRC
	~~--username=<your_sourceforge_username> \~~
	<nowiki>https://~~svn~~.~~code.sf.net/p~~/~~rsf~~/~~code~~/trunk</nowiki> RSFSRC
	</pre>		</pre>

	~~Next~~, ~~follow [[Installation\|Installation instructions]] to install.~~		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

	~~You~~ can ~~also [http://sourceforge.net/p/rsf/code/HEAD/tree/trunk browse the Subversion repository].~~

	~~===Updating===~~

	To 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>		<pre>
	svn update		svn update
	</pre>		</pre>

	===Troubleshooting===		Replace <tt>RSFSRC</tt> with the path where you want to put the Madagascar source code.

			Next, follow [[Installation\|Installation instructions]] to install.

			===SVN Troubleshooting===

	*If, after running the <tt>svn ~~co...~~</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 – 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:		*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 – 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		<pre>http-proxy-host = www-proxy.yourcompany.com
	http-proxy-port = 80		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.		</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 get a "is already a working copy for a different URL" error, this means you have an existing directory downloaded from another server. Run <tt>svn switch --relocate</tt> 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 (<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 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.

R-swindeman: /* LATEX package */

2014-03-28T21:38:43Z

LATEX package

← Older revision		Revision as of 21:38, 28 March 2014
Line 70:		Line 70:
	<pre>sfbooklist command="scons lock" book</pre>		<pre>sfbooklist command="scons lock" book</pre>

	===~~L<sup>A</sup>TEX~~ package===		===LaTeX package===

	[[SEGTeX]] is a LaTeX package for geophysical publications. It can be used with madagascar for writing [[Reproducible Documents\|reproducible papers]].		[[SEGTeX]] is a LaTeX package for geophysical publications. It can be used with madagascar for writing [[Reproducible Documents\|reproducible papers]].

Sfomel: /* Current development version */

2012-10-14T21:11:11Z

Current development version

← Older revision		Revision as of 21:11, 14 October 2012
Line 22:		Line 22:
	<pre>		<pre>
	svn co \		svn co \
	--username=<your_sourceforge_username> <nowiki>https://svn.code.sf.net/p/rsf/code/trunk</nowiki> RSFSRC		--username=<your_sourceforge_username> \
			<nowiki>https://svn.code.sf.net/p/rsf/code/trunk</nowiki> RSFSRC
	</pre>		</pre>

Sfomel: /* Current development version */ new repository

2012-10-14T21:10:31Z

Current development version: new repository

← Older revision		Revision as of 21:10, 14 October 2012
Line 22:		Line 22:
	<pre>		<pre>
	svn co \		svn co \
	--username=<your_sourceforge_username> \		--username=<your_sourceforge_username> <nowiki>https://svn.code.sf.net/p/rsf/code/trunk</nowiki> RSFSRC
	~~svn+ssh~~://~~<your_sourceforge_username>@~~svn.code.sf.net/p/rsf/code/trunk \
	RSFSRC
	</pre>		</pre>

	Next, follow [[Installation\|Installation instructions]] to install.		Next, follow [[Installation\|Installation instructions]] to install.

	You can also [http://~~rsf.svn.~~sourceforge.net/~~viewvc~~/rsf/trunk/ browse the Subversion repository].		You can also [http://sourceforge.net/p/rsf/code/HEAD/tree/trunk browse the Subversion repository].

	===Updating===		===Updating===

Nick: /* Current development version */ new download procedure for developers

2012-10-07T20:36:17Z

Current development version: new download procedure for developers

← Older revision		Revision as of 20:36, 7 October 2012
Line 14:		Line 14:
	==Current development version==		==Current development version==

	~~You~~ need to have a [http://subversion.apache.org/ Subversion client] (<tt>svn</tt>) installed. To download ~~the directory with the Madagascar source code~~, run the following command:		To download the most recent Madagascar source code, you need to have a [http://subversion.apache.org/ Subversion client] (<tt>svn</tt>) installed. If you want to download it read-only, run the following command:
	<pre>		<pre>
	svn co <nowiki>http://svn.code.sf.net/p/rsf/code/trunk</nowiki> RSFSRC		svn co <nowiki>http://svn.code.sf.net/p/rsf/code/trunk</nowiki> RSFSRC
	</pre>		</pre>
	Replace <tt>RSFSRC</tt> with the path where you want to put the Madagascar source code.		Replace <tt>RSFSRC</tt> with the path where you want to put the Madagascar source code.
			If you are a Madagascar project contributor and you want to download it in read-write mode, use
			<pre>
			svn co \
			--username=<your_sourceforge_username> \
			svn+ssh://<your_sourceforge_username>@svn.code.sf.net/p/rsf/code/trunk \
			RSFSRC
			</pre>

	Next, follow [[Installation\|Installation instructions]] to install.		Next, follow [[Installation\|Installation instructions]] to install.