Geopsy: Tools

Tools menu

Geopsy software provides powerful tools for advanced signal processings, for instance ambient vibration array processings or H/V spectral ratio. A plugin mechanism allows you to install only selected tools corresponding to your need. Through the menu Preferences it is possible to add (or remove) new tools without upgrading the main Geopsy frame.

The advanced signal processings tools are available under the menu Tools or directly by clicking on the icons in the toolbar. The following tools are available:

Advanced signal processing tools

• F-K : conventional frequency wavenumber technique
• High resolution F-K : high resolution frequency wavenumber technique
• MSPAC : modified spatial autocorrelation technique
• Linear F-K for active experiments : multichannel analysis of surface waves
• Linear F-K for passive experiments : multichannel analysis of surface waves for ambient vibrations
• Damping : computation of damping factor for soil or structure
• Spectrum : Fourier amplitude spectra
• Spectrum Rotate : Fourier amplitude spectra in the horizontal space
• H/V spectral ratio : Horizontal-to-Vertical spectral ratio
• H/V Rotate : Horizontal-to-Vertical rotate spectral ratio
• Noise reduction
• Particle motion
• Refraction with NA: obsolete
• Time frequency analysis
• Structure spectrum

Use plugins with command line interface

The advanced signal processing tools belong to three plugins:

• geopsyhv (H/V ratio, )
• geopsyarray
• structureratio

Some advanced signal processing tools can be run from command line interface

-tool <TOOL>               // Use plugin with tag TOOL

TOOL refers to one plugin, namely geopshy,

Spectrum (tag=geopsyhv, slot=0) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log
 -taper <PERC>             Set taper length (% of total window)
 -autowin                  Calculate windows automatically
 -loadwin <FILE.log>       Set windows from FILE.log
 -clearpeaks [<RES>]       Remove all existing peaks
 -addpeak <[RES,]MIN,MAX>  Add a peak between MIN and MAX frequency
 -peaks [<RES>]            Output frequency peaks
 -save <DIR>               Save all results in directory DIR
 -curves                   Output spectral curves for all windows
 -average                  Output average spectral curve

H/V (tag=geopsyhv, slot=1) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log
 -taper <PERC>             Set taper length (% of total window)
 -autowin                  Calculate windows automatically
 -loadwin <FILE.log>       Set windows from FILE.log
 -clearpeaks [<RES>]       Remove all existing peaks
 -addpeak <[RES,]MIN,MAX>  Add a peak between MIN and MAX frequency
 -peaks [<RES>]            Output frequency peaks
 -save <DIR>               Save all results in directory DIR
 -curves                   Output H/V curves for all windows
 -average                  Output H/V average curve

Spectrum Rotate (tag=geopsyhv, slot=2) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log
 -taper <PERC>             Set taper length (% of total window)
 -autowin                  Calculate windows automatically
 -loadwin <FILE.log>       Set windows from FILE.log
 -clearpeaks [<RES>]       Remove all existing peaks
 -addpeak <[RES,]MIN,MAX>  Add a peak between MIN and MAX frequency
 -peaks [<RES>]            Output frequency peaks
 -save <DIR>               Save all results in directory DIR

H/V Rotate (tag=geopsyhv, slot=3) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log
 -taper <PERC>             Set taper length (% of total window)
 -autowin                  Calculate windows automatically
 -loadwin <FILE.log>       Set windows from FILE.log
 -clearpeaks [<RES>]       Remove all existing peaks
 -addpeak <[RES,]MIN,MAX>  Add a peak between MIN and MAX frequency
 -peaks [<RES>]            Output frequency peaks
 -save <DIR>               Save all results in directory DIR

FK (tag=geopsyarray, slot=0) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log
 -export-grids             Export all FK grids for all frequency bands and
                           time windows to files fkgrid_fxxx_twxxx (be
                           careful, need a lot of disk space)

High resolution FK (tag=geopsyarray, slot=1) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log

SPAC (tag=geopsyarray, slot=2) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log
 -rings <FILE.rings>       Load ring file FILE.rings (mandatory option)

Linear FK Active (tag=geopsyarray, slot=3) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log

Linear FK Passive (tag=geopsyarray, slot=4) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log

Structure Ratios (tag=structureratio, slot=0) options:

 -param <FILE.log>         Set processing parameters as specified in FILE.log
 -taper <PERC>             Set taper length (% of total window)
 -autowin                  Calculate windows automatically
 -loadwin <FILE.log>       Set windows from FILE.log
 -clearpeaks <RES>         Remove all existing peaks.
 -addpeak <RES,MIN,MAX>    Add a peak between MIN and MAX frequency.
 -peaks <RES>              Output frequency peaks.
 -save <DIR>               Save all results in directory DIR
 -curves <RES>             Output spectral curves for all windows.
 -average <RES>            Output average spectral curve.
                           
                           RES is a number between 0 and 2:
                              0: (c2-c1)/c1
                              1: (c2-c1)/c2
                              2: c1/c2

Example

 geopsy -db /home/user/MyDatabase.gpy -tool geopsyhv -slot 1
        -group "MyGroup" -param tmp.log -autowin -peaks
        -clearpeaks -addpeak "4,6" -peaks

Open the database "MyDatabase.gpy" and start H/V processing on group of signals named "MyGroup"'. Automatic windowing is used. Parameters are defined by "tmp.log". The default peaks are printed. Then, the list of peaks is cleared and a new one is added between 4 and 6 Hz.

Tools debug option

As said previously the plug-in tools can be managed in the menu Preferences. Additionaly, options for tool debugs are also available from command line interface :

 -debug-stream             // Debug mode (redirect all logs to stdout)
 -clear-tools              // Reset to default tool list
 -debug-tools              // Test available tools and exit
 -add-tool-path <PATH>     // Add PATH to the list of paths to search for tools