Difference between revisions of "BCU task-centric program list"

From Madagascar
Jump to navigation Jump to search
(links to wiki guides are put in man pages automatically now)
Line 6: Line 6:
  
 
== ASCII, binary file ==
 
== ASCII, binary file ==
* Convert the binary file of a RSF dataset between different formats (binary, ASCII): [[Guide_to_madagascar_programs#sfdd | dd guide]], [http://reproducibility.org/RSF/sfdd.html dd]
+
* Convert the binary file of a RSF dataset between different formats (binary, ASCII): [http://reproducibility.org/RSF/sfdd.html dd]
  
 
==SEG-Y file==
 
==SEG-Y file==
* Convert SEG-Y files to RSF: [[Guide_to_madagascar_programs#sfsegyread | segyread guide]], [http://reproducibility.org/RSF/sfsegyread.html segyread]
+
* Convert SEG-Y files to RSF: [http://reproducibility.org/RSF/sfsegyread.html segyread]
* Convert RSF to SEG-Y or SU: [[Guide_to_madagascar_programs#sfsegywrite | segywrite guide]], [http://reproducibility.org/RSF/sfsegywrite.html segywrite]
+
* Convert RSF to SEG-Y or SU: [http://reproducibility.org/RSF/sfsegywrite.html segywrite]
* Make a trace header file for segywrite: [[Guide_to_madagascar_programs#sfsegyheader | segyheader guide]], [http://reproducibility.org/RSF/segyheader.html segyheader]
+
* Make a trace header file for segywrite: [http://reproducibility.org/RSF/segyheader.html segyheader]
  
 
==SU file==
 
==SU file==
 
* Convert SU files to RSF: [http://reproducibility.org/RSF/sfsegyread.html suread]
 
* Convert SU files to RSF: [http://reproducibility.org/RSF/sfsegyread.html suread]
* Convert RSF to SU: [[Guide_to_madagascar_programs#sfsegywrite | segywrite guide]], [http://reproducibility.org/RSF/sfsegywrite.html segywrite]
+
* Convert RSF to SU: [http://reproducibility.org/RSF/sfsegywrite.html segywrite]
  
 
=File operations=
 
=File operations=
Line 21: Line 21:
  
 
== Basic operations ==
 
== Basic operations ==
* Display basic information about RSF files: [[Guide_to_madagascar_programs#sfin in guide]], [http://reproducibility.org/RSF/sfin.html in]
+
* Display basic information about RSF files: [http://reproducibility.org/RSF/sfin.html in]
* Copy a dataset: [[Guide_to_madagascar_programs#sfcp | cp guide]], [http://reproducibility.org/RSF/sfcp.html cp]
+
* Copy a dataset: [http://reproducibility.org/RSF/sfcp.html cp]
* Move a dataset: [[Guide_to_madagascar_programs#sfmv | mv guide]], [http://reproducibility.org/RSF/sfcp.html mv]
+
* Move a dataset: [http://reproducibility.org/RSF/sfcp.html mv]
* Remove RSF files together with their data: [[Guide_to_madagascar_programs#sfrm | rm guide]], [http://reproducibility.org/RSF/sfrm.html rm]
+
* Remove RSF files together with their data: [http://reproducibility.org/RSF/sfrm.html rm]
* Print out data values: [[Guide_to_madagascar_programs#sfdisfil | disfil guide]], [http://reproducibility.org/RSF/sfdisfil.html disfil]
+
* Print out data values: [http://reproducibility.org/RSF/sfdisfil.html disfil]
  
 
== Operation on file content ==
 
== Operation on file content ==
  
* Window a portion of the dataset: [[Guide_to_madagascar_programs#sfwindow | window guide]], [http://reproducibility.org/RSF/sfwindow.html window]
+
* Window a portion of the dataset: [http://reproducibility.org/RSF/sfwindow.html window]
* Transpose two axes in a dataset: [[Guide_to_madagascar_programs#sftransp | transp guide]], [http://reproducibility.org/RSF/sftransp.html transp]
+
* Transpose two axes in a dataset: [http://reproducibility.org/RSF/sftransp.html transp]
* Concatenate datasets: [[Guide_to_madagascar_programs#sfcat | cat guide]], [http://reproducibility.org/RSF/sfcat.html cat] or [[Guide_to_madagascar_programs#sfmerge | merge guide]], [http://reproducibility.org/RSF/sfcat.html merge]
+
* Concatenate datasets: [http://reproducibility.org/RSF/sfcat.html cat] or [http://reproducibility.org/RSF/sfcat.html merge]
* Convert real data to complex (by adding zero imaginary part): [[Guide_to_madagascar_programs#sfrtoc | rtoc guide]], [http://reproducibility.org/RSF/sfrtoc.html rtoc]
+
* Convert real data to complex (by adding zero imaginary part): [http://reproducibility.org/RSF/sfrtoc.html rtoc]
* Extract real part of a complex dataset: [[Guide_to_madagascar_programs#sfreal | real guide]], [http://reproducibility.org/RSF/sfreal.html real]
+
* Extract real part of a complex dataset: [http://reproducibility.org/RSF/sfreal.html real]
 
* Extract imaginary part of a complex dataset: [http://reproducibility.org/RSF/sfreal.html imag]
 
* Extract imaginary part of a complex dataset: [http://reproducibility.org/RSF/sfreal.html imag]
* Create a complex dataset from its real and imaginary parts: [[Guide_to_madagascar_programs#sfcomplex | complex guide]], [http://reproducibility.org/RSF/sfcmplx.html cmplx]
+
* Create a complex dataset from its real and imaginary parts: [http://reproducibility.org/RSF/sfcmplx.html cmplx]
* Rotate a portion of one or more axes in the data hypercube: [[Guide_to_madagascar_programs#sfrotate | rotate guide]], [http://reproducibility.org/RSF/sfrotate.html rotate]
+
* Rotate a portion of one or more axes in the data hypercube: [http://reproducibility.org/RSF/sfrotate.html rotate]
* Zero a portion of the dataset: [[Guide_to_madagascar_programs#sfcut | cut guide]], [http://reproducibility.org/RSF/sfcut.html cut]
+
* Zero a portion of the dataset: [http://reproducibility.org/RSF/sfcut.html cut]
* Pad a dataset with zeros: [[Guide_to_madagascar_programs#sfpad | pad guide]], [http://reproducibility.org/RSF/sfpad.html pad]
+
* Pad a dataset with zeros: [http://reproducibility.org/RSF/sfpad.html pad]
* Combine several datasets by interleaving: [[Guide_to_madagascar_programs#sfinterleave | interleave guide]], [http://reproducibility.org/RSF/sfinterleave.html interleave]
+
* Combine several datasets by interleaving: [http://reproducibility.org/RSF/sfinterleave.html interleave]
 
* Pad and interleave traces: [http://reproducibility.org/RSF/sflpad.html lpad]
 
* Pad and interleave traces: [http://reproducibility.org/RSF/sflpad.html lpad]
 
* Compute Ni+1 x Ni+2 x ...: [http://reproducibility.org/RSF/sfleftsize.html leftsize]
 
* Compute Ni+1 x Ni+2 x ...: [http://reproducibility.org/RSF/sfleftsize.html leftsize]
* Reverse one or more axes in the data hypercube: [[Guide_to_madagascar_programs#sfreverse | reverse guide]], [http://reproducibility.org/RSF/sfreverse.html reverse]
+
* Reverse one or more axes in the data hypercube: [http://reproducibility.org/RSF/sfreverse.html reverse]
  
 
==Header operations==
 
==Header operations==
  
* Input parameters into a header: [[Guide_to_madagascar_programs#sfput | put guide]], [http://reproducibility.org/RSF/sfput.html put]
+
* Input parameters into a header: [http://reproducibility.org/RSF/sfput.html put]
* Output parameters from the header: [[Guide_to_madagascar_programs#sfget | get guide]], [http://reproducibility.org/RSF/sfget.html get]
+
* Output parameters from the header: [http://reproducibility.org/RSF/sfget.html get]
* Display the content of a header file: [[Guide_to_madagascar_programs#sfheaderattr | headerattr guide]], [http://reproducibility.org/RSF/sfheaderattr.html headerattr]
+
* Display the content of a header file: [http://reproducibility.org/RSF/sfheaderattr.html headerattr]
* Zero a portion of a dataset based on a header mask: [[Guide_to_madagascar_programs#sfheadercut | headercut guide]], [http://reproducibility.org/RSF/sfheadercut.html headercut]
+
* Zero a portion of a dataset based on a header mask: [http://reproducibility.org/RSF/sfheadercut.html headercut]
* Mathematical operations, possibly on header keys: [[Guide_to_madagascar_programs#sfheadermath | headermath guide]], [http://reproducibility.org/RSF/sfheadermath.html headermath]
+
* Mathematical operations, possibly on header keys: [http://reproducibility.org/RSF/sfheadermath.html headermath]
* Sort a dataset according to a header key: [[Guide_to_madagascar_programs#sfheadersort | headersort guide]], [http://reproducibility.org/RSF/sfheadersort.html headersort]
+
* Sort a dataset according to a header key: [http://reproducibility.org/RSF/sfheadersort.html headersort]
* Window a dataset based on a header mask: [[Guide_to_madagascar_programs#sfheaderwindow | headerwindow guide]],  [http://reproducibility.org/RSF/sfheaderwindow.html headerwindow]
+
* Window a dataset based on a header mask: [http://reproducibility.org/RSF/sfheaderwindow.html headerwindow]
  
 
= Graph, plots, displays =
 
= Graph, plots, displays =
Line 58: Line 58:
 
== Display ==
 
== Display ==
  
* Generate raster plot: [[Guide_to_madagascar_programs#sfgrey | grey guide]], [http://reproducibility.org/RSF/sfgrey.html grey] (sfbyte is the same)
+
* Generate raster plot: [http://reproducibility.org/RSF/sfgrey.html grey] (sfbyte is the same)
  
* Draw a balloon-style label: [[Guide_to_madagascar_programs#sfbox | box guide]], [http://reproducibility.org/RSF/sfbox.html box]
+
* Draw a balloon-style label: [http://reproducibility.org/RSF/sfbox.html box]
  
* Contour plot: [[Guide_to_madagascar_programs#sfcontour | contour guide]], [http://reproducibility.org/RSF/sfcontour.html contour]
+
* Contour plot: [http://reproducibility.org/RSF/sfcontour.html contour]
  
 
* Generate 3-D contour plot: [http://reproducibility.org/RSF/sfcontour3.html contour3]
 
* Generate 3-D contour plot: [http://reproducibility.org/RSF/sfcontour3.html contour3]
  
* Plot signal with lollipops: [[Guide_to_madagascar_programs#sfdots | dots guide]], [http://reproducibility.org/RSF/sfdots.html dots]
+
* Plot signal with lollipops: [http://reproducibility.org/RSF/sfdots.html dots]
  
* Generate 3-D cube plot for surfaces: [[Guide_to_madagascar_programs#sfgraph3 | graph3 guide]], [http://reproducibility.org/RSF/sfgraph3.html graph3]
+
* Generate 3-D cube plot for surfaces: [http://reproducibility.org/RSF/sfgraph3.html graph3]
  
* Graph plot: [[Guide_to_madagascar_programs#sfgraph | graph guide]], [http://reproducibility.org/RSF/sfgraph.html graph]
+
* Graph plot: [http://reproducibility.org/RSF/sfgraph.html graph]
  
* Generate 3-D cube plot: [[Guide_to_madagascar_programs#sfgrey3 | grey3 guide]], [http://reproducibility.org/RSF/sfgrey3.html grey3] (sfcubeplot is the same)
+
* Generate 3-D cube plot: [http://reproducibility.org/RSF/sfgrey3.html grey3] (sfcubeplot is the same)
  
* Plot rays: [[Guide_to_madagascar_programs#sfplotrays | plotrays guide]], [http://reproducibility.org/RSF/sfplotrays.html plotrays]
+
* Plot rays: [http://reproducibility.org/RSF/sfplotrays.html plotrays]
  
* Hidden-line surface plot: [[Guide_to_madagascar_programs#sfthplot | thplot guide]], [http://reproducibility.org/RSF/sfthplot.html thplot]
+
* Hidden-line surface plot: [http://reproducibility.org/RSF/sfthplot.html thplot]
  
* Plot data with wiggly traces: [[Guide_to_madagascar_programs#sfwiggle | wiggle guide]], [http://reproducibility.org/RSF/sfwiggle.html wiggle]
+
* Plot data with wiggly traces: [http://reproducibility.org/RSF/sfwiggle.html wiggle]
  
* Resamples a 2-D dataset to the desired picture resolution, with antialias: [[Guide_to_madagascar_programs#sfprep4plot | prep4plot guide]], [http://reproducibility.org/RSF/sfprep4plot.html prep4plot]
+
* Resamples a 2-D dataset to the desired picture resolution, with antialias: [http://reproducibility.org/RSF/sfprep4plot.html prep4plot]
  
 
* Setting up frames for a generic plot: [http://reproducibility.org/RSF/sfstdplot.html stdplot]
 
* Setting up frames for a generic plot: [http://reproducibility.org/RSF/sfstdplot.html stdplot]
Line 86: Line 86:
 
== Plot format ==
 
== Plot format ==
  
* Plot Assembler - convert ascii to vplot: [[Guide_to_madagascar_programs#sfplas | plas guide]], [http://reproducibility.org/RSF/sfplas.html plas]
+
* Plot Assembler - convert ascii to vplot: [http://reproducibility.org/RSF/sfplas.html plas]
  
* Plot Debugger - convert vplot to ascii: [[Guide_to_madagascar_programs#sfpldb | pldb guide]], [http://reproducibility.org/RSF/sfpldb.html pldb]
+
* Plot Debugger - convert vplot to ascii: [http://reproducibility.org/RSF/sfpldb.html pldb]
  
 
* Vplot filter for postscript: [http://reproducibility.org/RSF/sfpspen.html pspen]
 
* Vplot filter for postscript: [http://reproducibility.org/RSF/sfpspen.html pspen]
  
 
* Vplot filter for the virtual vplot device: [http://reproducibility.org/RSF/sfvppen.html vppen]
 
* Vplot filter for the virtual vplot device: [http://reproducibility.org/RSF/sfvppen.html vppen]

Revision as of 11:30, 10 January 2009

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

SEG-Y file

SU file

File operations

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

Basic operations

  • Display basic information about RSF files: in
  • 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
  • Plot signal with lollipops: dots
  • Generate 3-D cube plot for surfaces: graph3
  • Generate 3-D cube plot: grey3 (sfcubeplot is the same)
  • 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