Page History

OVERVIEW: A command-line tool to interpolate numerical data from text at
fixed intervals.

This tool reads in rows of text from a file or standard in and
interpolates one or more columns using a selection of interpolation
methods. Results are printed to STDOUT.
Currently only linear, step-wise interpolation is implemented.
A (default) option is provided to integrate interpolation values between
interpolation steps.

There are various options to:
  - select the column for the abscissa ('x'-axis)
  - select the column for the ordinate ('y'-axis), or use 'all' columns
  - set filter to restrict abscissa range to begin/end
  - set first line for start of data (skipping headers)
  - specify interpolation step or use calculated median ∆abscissa
  - provide format string for output

USAGE: interpolate [<options>] [<file-path>]

ARGUMENTS:
  <file-path>             The filepath for data to be interpolated. '-' for
                          stdin. 

OPTIONS:
  --step <step>           Interpolation step (floating point, or 'median').
                          (default: median)
  -x, --abscissa <abscissa>
                          Column to use as independent (e.g. time/depth).
                          (default: 1)
  -y, --ordinate <ordinate>
                          Choose between single ordinate column number,
                           or string 'all' for all (non-abscissa) columns
                          (default: single(2))
  -b, --range-start <range-start>
                          Restrict range (low). (default: inferred)
  -e, --range-end <range-end>
                          Restrict range (high). (default: inferred)
  -m, --interpolation-mode <interpolation-mode>
                          Interpolation Mode (linear, …)
                          /*cubicSpline, staircase not yet implemented*/.
                          (default: linear)
  -i, --integration-mode <integration-mode>
                          Use integration during interpolation. (default:
                          integrate)
  --disable-extrapolation Disable extrapolation beyond start or end point(s). 
  -l, --headerLine <headerLine>
                          Use this line number for column labels. 
  -d, --data-first-line <data-first-line>
                          First line with data values. (default: 1)
  -s, --column-separator <column-separator>
                          Separator to be used to split columns instead of
                          default tab. (default: 	)
  --output-separator <output-separator>
                          Separator to be used on output instead of default
                          tab. (default: 	)
  -n, --ignore-line-marker <ignore-line-marker>
                          Ignore lines starting with this character or any of
                          these characters.
                           (default: <CFCharacterSet Items(U+0021 U+0023 U+0025
                          U+002F)>)
  --replace-dwith-e <replace-dwith-e>
                          Replace Fortran style doubles D to E. (default: true)
  -f, --format-string <format-string>
                          Output format string. (default: %f)
  --licenses              Show license for this project, and licenses of
                          projects used. 
  --versions              Show version for this tool. 
  -v, --verbosity         Verbose output. Multiple counts increase verbosity. 
  --version               Show the version.
  -h, --help              Show help information.