Editing Revisiting SEP tour with Madagascar and SCons (section)

==Getting started==
Madagascar programs can be piped and executed from the
command line, for example:
<pre>
bash&#36; sfspike n1=1000 k1=300 title="\s200 Welcome to \c2 RSF" | \
sfbandpass fhi=2 phase=1 | sfwiggle | sfpen
</pre>
If you are already familiar with SEPlib, you can find most of the familiar
programs with the names prepended by "sf".
Typing a command without arguments, should produce a concise
self-documentation. 
<pre>
bash&#36; sfbandpass
</pre>
The recommended way of using RSF, however, is not with the command line but
with SCons and "SConstruct" files.
===Setting up===
Open a file named "SConstruct" in your favorite editor, start it with a
line 
<syntaxhighlight lang="python">
from rsf.proj import *
</syntaxhighlight>
and end it with a line
<syntaxhighlight lang="python">
End()
</syntaxhighlight>

The first line tells Python to load the RSF project module.

===Obtaining the test data===
Add a Fetch command as follows:
<syntaxhighlight lang="python">
Fetch('Txx.HH','septour')
</syntaxhighlight>

Now, by running 
<pre>
bash&#36; scons Txx.HH
</pre>
you can instruct SCons to connect to an anonymous data server and extract
(fetch) the data file "Txx.HH" from the "septour" directory.

===Displaying the data===

Add the following line to the <tt>SConstruct</tt> file:
<syntaxhighlight lang="python">
Result('wiggle0','Txx.HH','wiggle')
</syntaxhighlight>


Note that it does not matter if this line appears before or after the
"Fetch" line. You are simply instructing SCons how to create a
result plot from the input.
Run
<pre>
bash&#36; scons wiggle0.view
</pre>
If everything is setup correctly in your environment, you should see 
something like the following output in your terminal:
<pre>
bash&#36; scons wiggle0.view
scons: Reading SConscript files ...
scons: done reading SConscript files.
scons: Building targets ...
retrieve(["Txx.HH"], [])
< Txx.HH /path/to/RSF/bin/sfwiggle > Fig/wiggle0.vpl
/path/to/RSF/bin/sfpen Fig/wiggle0.vpl
</pre>
and the following figure appearing on your screen.
[[Image:wiggle0.png|frame|center|To see this figure on your screen, run <tt>scons~wiggle0.view</tt>]]