BCU task-centric program list

List of Basic Cube Utilities (BCU) in Madagascar. Operations listed here can throw away data or fill in with zeros, but should not create new values or alter existing ones -- those belong to the Numerical Methods program list.

All program names below should be prefixed with "sf".

I/O and file format conversions

ASCII, binary file

• Convert the binary file of a RSF dataset between different formats (binary, ASCII): dd guide, dd

SEG-Y file

• Convert SEG-Y files to RSF: segyread guide, segyread
• Convert RSF to SEG-Y or SU: segywrite guide, segywrite
• Make a trace header file for segywrite: segyheader guide, segyheader

SU file

• Convert SU files to RSF: suread
• Convert RSF to SU: segywrite guide, segywrite

File operations

This section contains physics-agnostic methods for slicing, dicing, adding together files, etc:

Basic operations

• Display basic information about RSF files: Guide_to_madagascar_programs#sfin in guide, in
• Copy a dataset: cp guide, cp
• Move a dataset: mv guide, mv
• Remove RSF files together with their data: rm guide, rm
• Print out data values: disfil guide, disfil

Operation on file content

• Window a portion of the dataset: window guide, window
• Transpose two axes in a dataset: transp guide, transp
• Concatenate datasets: cat guide, cat or merge guide, merge
• Convert real data to complex (by adding zero imaginary part): rtoc guide, rtoc
• Extract real part of a complex dataset: real guide, real
• Extract imaginary part of a complex dataset: imag
• Create a complex dataset from its real and imaginary parts: complex guide, cmplx
• Rotate a portion of one or more axes in the data hypercube: rotate guide, rotate
• Zero a portion of the dataset: cut guide, cut
• Pad a dataset with zeros: pad guide, pad
• Combine several datasets by interleaving: interleave guide, interleave
• Pad and interleave traces: lpad
• Compute Ni+1 x Ni+2 x ...: leftsize
• Reverse one or more axes in the data hypercube: reverse guide, reverse

Header operations

• Input parameters into a header: put guide, put
• Output parameters from the header: get guide, get
• Display the content of a header file: headerattr guide, headerattr
• Zero a portion of a dataset based on a header mask: headercut guide, headercut
• Mathematical operations, possibly on header keys: headermath guide, headermath
• Sort a dataset according to a header key: headersort guide, headersort
• Window a dataset based on a header mask: headerwindow guide, headerwindow

Graph, plots, displays

Display

• Generate raster plot: grey guide, grey (sfbyte is the same)

• Draw a balloon-style label: box guide, box

• Contour plot: contour guide, contour

• Generate 3-D contour plot: contour3

• Plot signal with lollipops: dots guide, dots

• Generate 3-D cube plot for surfaces: graph3 guide, graph3

• Graph plot: graph guide, graph

• Generate 3-D cube plot: grey3 guide, grey3 (sfcubeplot is the same)

• Plot rays: plotrays guide, plotrays

• Hidden-line surface plot: thplot guide, thplot

• Plot data with wiggly traces: wiggle guide, wiggle

• Resamples a 2-D dataset to the desired picture resolution, with antialias: prep4plot guide, prep4plot

• Setting up frames for a generic plot: stdplot

Plot format

• Plot Assembler - convert ascii to vplot: plas guide, plas

• Plot Debugger - convert vplot to ascii: pldb guide, pldb

• Vplot filter for postscript: pspen

• Vplot filter for the virtual vplot device: vppen