DOCUMENTATION

SYNOPSIS

  PROGRAM NAME: Gpdcreport
  AUTHOR:  Derek Goff
  DATE:  May 2 2015
  DESCRIPTION:  A package to use geopsy's gpdcreport function
		to extract information from report files
  VERSION: 0.1

Use

Notes

This Program derives from dinver in Geopsy
'_note' keeps track of actions for use in graphics
'_Step' keeps track of actions for execution in the system

Example

Gpdcreport Notes

Usage: gpdcreport [OPTIONS] [FILE] ...

Read .report file produced by inversion and extract to stdout ground models, dispersion curves, spac curves...
(see options)

Gpdcreport options: -n <MAX> Maximum number of models to output (default = no maximum) -m <MAX> Maximum misfit to output (default = 1e99) -best <N> Output only the N models with the minimum misfit (supported only for current .report format and without option '-index'. -index Select models by index in file. Indexes are passed through stdin. -pm Output parameters and misfit to stdout -checksum Output the parameterization checksum to stdout -count Output the number of models to stdout -gm Output ground models to stdout (default) -tgmVp Output Vp tilt ground models to stdout (used for refraction) -tgmVs Output Vs tilt ground models to stdout (used for refraction) -vp Output Vp profiles to stdout -vs Output Vs profiles to stdout -rho Output Density profiles to stdout -pitch Output Pitch profiles to stdout -pR <mode> Output mode Rayleigh Phase dispersion curves to stdout -gR <mode> Output mode Rayleigh Group dispersion curves to stdout -pL <mode> Output mode Love Phase dispersion curves to stdout -gL <mode> Output mode Love Group dispersion curves to stdout -e <mode> Output mode ellipticity curve to stdout -aV <mode> Output mode vertical autocorrelation curve to stdout -aR <mode> Output mode radial autocorrelation curve to stdout -aT <mode> Output mode transverse autocorrelation curve to stdout -refraVp <source> Output Vp travel time curve for source index to stdout -refraVs <source> Output Vs travel time curve for source index to stdout -ring <index> Add one ring to list of rings to output (default=nothing) -o <FILE> Export selected models to FILE with the current binary format for .report files. This option may be usefull to convert old .report files produced by na_viewer or first dinver releases. -compat <TYPE> Compatibility with previous versions of .report format. TYPE may take the following values: na_viewer old .report as output by the ancestor of dinver (before 2005). beta first release of the new .report format (not yet support for implicit mode guess specification). All releases from year 2006 and end of 2005. current .report produced by current releases of dinver. All releases since beginning of year 2007.Versioning implemented in this format should guarantee the future support for this format.

Generic options: -h, -help [<SECTION>] Shows help. SECTION may be empty or: all, html, latex, generic, debug, examples, gpdcreport -version Shows version information -app-version Shows short version information -j, -jobs <N> Allows a maximum of N simulteneous jobs for parallel computations (default=8).

Debug options: -nobugreport Does not generate bug reports in case of error. -reportbug Starts bug report dialog, information about bug is passed through stdin. This option is used internally to report bugs if option -nobugreport is not specified. -reportint Starts bug report dialog, information about interruption is passed through stdin. This option is used internally to report interruptions if option -nobugreport is not specified.

Examples:

       gpdcreport run_01.report

Output first 1000 ground models with a misfit less than 1.

       gpdcreport run_01.report | gpell -c

Re-compute ellipticity curves for the same set of models.

       gpdcreport run_01.report | gpell -p

Re-compute peak ellipticity frequencies for the same set of models.

       gpdcreport run_01.report -e 0

Output ellipticity curves for the same set of models (if any stored).

See also: More information at http://www.geopsy.org

Authors: Marc Wathelet Marc Wathelet (LGIT, Grenoble, France)

Description of Subroutines

Subroutine clear

Sets all variable strings to '' (nothing) 

Subroutine maxmod

Maximum number of models to output
default = no maximum

Subroutine maxmis

Maximum misfit to output
default = 1e99

Subroutine best

Output only N models with minimum misfit

Subroutine index

Select models by index in file
Indexes are passed through stdin

Subroutine pm

Output parameters and misfit to stdout

Subroutine gm

Output ground models to stdout (default)

Subroutine vp

Output Vp profiles to stdout

Subroutine vs

Output Vs profiles to stdout

Subroutine pR

Output mode Rayleigh Phase dispersion curves to stdout

Subroutine pL

Output mode Love hase dispersion curves to stdout

Subroutine file

Define Input file

Subroutine Step

Keeps track of actions for execution in the system

Subroutine note

Keeps track of actions for possible use in graphics

Warnings for programmers

packages must end with
1;