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.

An overview of all task-centric pages can be found in the main Task-centric 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

SEG-Y file

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

SU file

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

File operations

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

Basic operations

• Display basic information about RSF files: in
• Display the size of RSF data forks: sizes
• Copy a dataset: cp
• Move a dataset: mv
• Remove RSF files together with their data: rm
• Print out data values: disfil

Operation on file content

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

Header operations

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

Graph, plots, displays

Display

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

• Draw a balloon-style label: box

• Contour plot: contour

• Generate 3-D contour plot: contour3

• Plot signal with lollipops: dots

• Generate 3-D cube plot for surfaces: graph3

• Graph plot: graph

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

• Plot rays: plotrays

• Hidden-line surface plot: thplot

• Plot data with wiggly traces: wiggle

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

• Setting up frames for a generic plot: stdplot

Plot format

• Plot Assembler - convert ascii to vplot: plas

• Plot Debugger - convert vplot to ascii: pldb

• Vplot filter for postscript: pspen

• Vplot filter for the virtual vplot device: vppen