MadagascarInstallation
Sergey FomelUniversity of Texas at Austin
August 30, 2006Vancouver, BC
August 30, 2006 Vancouver School & Workshop 2 of 20
This Presentation
Introductory remarks• History
• Goals
• Design principles
Installation and compilation• Downloading
• Software construction with SCons
• File structure
August 30, 2006 Vancouver School & Workshop 3 of 20
Madagascar Story
Started in 2003 Publicly open in June 2006 Open-source http://rsf.sourceforge.net Standing on SEPlib/SU shoulders RSF (regularly sampled format)
August 30, 2006 Vancouver School & Workshop 4 of 20
Cumulative Downloads
0
50
100
150
200
250
300
1-Jul 8-Jul 15-Jul 22-Jul 29-Jul 5-Aug 12-Aug 19-Aug 26-Aug
Vancouver School announced
Registered at freshmeat.net
August 30, 2006 Vancouver School & Workshop 5 of 20
August 30, 2006 Vancouver School & Workshop 6 of 20
Source Referral (August 2006)
677
222
134
63
49
49
49
36 75
direct
beg.utexas.edu
google.com
seg.org
cseg.ca
sourceforge.net
freshmeat.net
sepwww.stanford.edu
other
August 30, 2006 Vancouver School & Workshop 7 of 20
Goal
To make our research* productive To make technology transfer efficient
*computational experiments
August 30, 2006 Vancouver School & Workshop 8 of 20
Monday Get an idea
Tuesday Implement it
Wednesday Test it
Thursday Communicate it
Friday Commercialize it
One Week Technology Transfer
a
b
c
August 30, 2006 Vancouver School & Workshop 9 of 20
Madagascar Design Principles
Document computational experiments Old experiments are regression tests New experiments become unit tests
August 30, 2006 Vancouver School & Workshop 10 of 20
This Presentation
Introductory remarksHistory
Goal
Design principles
Installation and compilation• Downloading
• Compiling with SCons
• File structure
August 30, 2006 Vancouver School & Workshop 11 of 20
Downloading Madagascar
Stable version • madagascar-0.9.3
• SourceForge Unstable (development) version
• svn co https://svn.sourceforge.net/svnroot/rsf/trunk rsf
• Update with svn update
• Commit with svn commit (developers)
• Browse at http://svn.sourceforge.net/viewvc/rsf/
• Subversion facilitates collaboration and version control
August 30, 2006 Vancouver School & Workshop 12 of 20
Cumulative Subversion Access
0
200
400
600
800
1000
1200
1400
1600
1-J
ul
8-J
ul
15
-Ju
l
22
-Ju
l
29
-Ju
l
5-A
ug
12
-Au
g
19
-Au
g
26
-Au
g
Write
Read
August 30, 2006 Vancouver School & Workshop 13 of 20
SCons is an easier, more reliable and faster way to build software.
SCons (Software Construction)
“make” replacement Built-in “autoconf/automake” functionality Written in Open-source http://www.scons.org Used for compiling Madagascar Used for managing processing flows
August 30, 2006 Vancouver School & Workshop 14 of 20
Fro
m T
im O
’Rei
lly’s
blo
g “O
’Rei
lly R
adar
”
August 30, 2006 Vancouver School & Workshop 15 of 20
Installing from Source
Unpack• tar xvzf madagascar-0.9.3.tgz
Prerequisites• Install Python and SCons if necessary
• Set environmental variables
Build• scons config (generates config.py)
• scons install
http://rsf.sf.net/wiki/index.php/Installation
$RSFROOTroot of installation
$PYTHONPATHadd $RSFROOT/lib
$DATAPATHhome for binary files
August 30, 2006 Vancouver School & Workshop 16 of 20
Open Source madagascar-0.9.3/
• Sconstruct
• config.py
• api/
• book/
• filt/
• user/
• pens/
• plot/
• python/ convenience Python scripts
• scons/ SCons sources
$RSFROOT/• bin/
• lib/
• include/
• doc/
• figs/
created by scons install
August 30, 2006 Vancouver School & Workshop 17 of 20
Look Inside I madagascar-0.9.3/
• Sconstruct top software construction
• config.py created by scons configENV = {'PATH': '/usr/local/bin:/bin:/usr/bin'}AR = 'ar'JPEG = 'jpeg'PPM = NoneCC = 'gcc'CCFLAGS = '-O2 -std=gnu99 -Wall -pedantic -DNO_COMPLEX'CPPPATH = []LIBPATH = []LIBS = ['m', 'rpc']XLIBPATH = ['/usr/X11R6/lib']XLIBS = ['Xaw', 'Xt', 'X11']XINC = ['/usr/X11R6/include']CXX = 'g++'
August 30, 2006 Vancouver School & Workshop 18 of 20
Look Inside II api/ API tests
C++/Fortran/MATLAB… book/ reproducible research tests
• gee/ book• ajt/ chapter/paper
• SConstruct• paper.tex (LaTeX)• causint/ project
• SConstruct• conv/• …
• hlx/• …
• bei/• geo391/• …
from rsfproj import *
Flow('data1',None,'spike n1=30 k1=15 label1=')Flow('data2','data1','causint')Flow('data3','data1','causint adj=y')
Flow('data4',None, 'spike n1=30 nsp=2 k1=10,15 mag=1,-1 label1= ')Flow('data5','data4','causint')Flow('data6','data4','causint adj=y')Flow('data7','data5','causint')
August 30, 2006 Vancouver School & Workshop 19 of 20
Look Inside III filt/ program sources arranged by subject
• lib/ sources for rsf.h, librsf.a and API bindings• SConstruct• alloc.c• …
• main/ most common data manipulation programs• SConstruct• add.c• …
• proc/ “processing”• imag/ “imaging”
user/ program sources arranged by author• fomels/• slim/• … easily extensible
August 30, 2006 Vancouver School & Workshop 20 of 20
Look Inside IV plot/ sources for Vplot generation
• lib/ sources for rsfplot.h, librsfplot.a• SConstruct• axis.c• …
• main/ RSF to Vplot• SConstruct• contour.c• …
• test/ Vplot from source pens/ sources for Vplot manipulation
• main/• SConstruct• pspen.c Vplot to PostScript • …
• …
August 30, 2006 Vancouver School & Workshop 21 of 20
Lessons
Madagascar goal• To make our research productive
• To make technology transfer efficient
Multiple levels• (Tuesday) implement – main modules, C
• (Wednesday) test – projects, SCons/Python
• (Thursday) communicate – papers, LaTeX
If you don’t like it, please voice your concerns.Wiki | Blog | Mailing list | Forums | Bug tracking | Feature requests
