Tutorials

Learn Madagascar by completing the tutorial series below. The tutorials are aimed at a few types of individuals:

1 - Users - Individuals who want to know how to use Madagascar immediately for data processing.

2 - Developers - Individuals who are already Users, who want to write their own programs and/or contribute to Madagascar.

3 - Authors - Individuals interested in creating reproducible documents using Madagascar.

Additionally, we have a series of tutorials that show users how to perform common tasks, such as SEG-Y read/write, and conversion to and from SU formats.

All tutorials are documented by examples in the Madagascar release. You can work alongside the examples!

Tutorials are organized into levels. Higher level courses in a section require the lower level courses to be completed first.

Users

The user tutorials are focused on getting a new user running Madagascar from the ground up. These tutorials cover everything from: the command line interface, to advanced SCons functionality. By the end of these tutorials, you should be able to process large datasets using Madagascar very quickly, and write powerful Python scripts that are reproducible.

Name	Level	Description
RSF file format	0	An introduction to Madagascar and the RSF file format
Command line interface	1	Using the command line interface
Plotting	2	Creating and viewing vplot files
Intro to SCons	3	Creating simple SCons scripts for build control
Advanced SCons	4	Creating advanced SCons scripts
Advanced SCons II	5	Abusing SCons
Python	6	Loops, flow control, functions
Advanced visualization	6	3D visualization using the Mines JTK and VTK

Developers

The developer tutorials are targeted to people who are already familiar with processing data in Madagascar. You should have completed the User tutorial series before beginning this tutorial series. This tutorial set covers: designing and developing simple programs in Madagascar, using the various language APIs, and parallel programming. Following completion of this tutorial series, you should be able to write advanced programs in Madagascar that can be contributed back to the community for others to use!

Name	Level	Description
Intro to Development	0	Learn how to write simple C programs using Madagascar
Advanced development	1	Learn how to link against other libraries	-	API development	1	Learn how to write a program in another API (Java, Python, Matlab, Fortran)	-	Parallel computing	2	Write a program that uses MPI or OpenMP	-	High performance Madagascar	3	Maximize your program's performance in Madagascar

Authors

The author tutorials are targeted at those who want to create reproducible documents using Madagascar. You should have completed the User tutorial before attempting these tutorials. This tutorial covers: combining Latex and Madagascar in a reproducible fashion, adding your own Latex style-sheets and macros, and building an SEG expanded abstract.

Tasks

These tutorials are side tutorials that show how to perform specific tasks. You should have completed the Users tutorials before using these tutorials.