Contents
Next
Top of page
1. Introduction
This manual documents how to use Geopsy as well as the tools developed for ambient vibration processing. It
corresponds to version 2.0.0.
1. Introduction
1. Introduction
Database
Various common signal file formats can be loaded. These formats are automatically recognised to simplify the
access to the measured signals. Reading the original file format is usually better than using conversion tools
where data losses are likely to occurs (e.g. correction factors).
There is virtually no limit to the number of signals that can be loaded at the same time. Once loaded, the
signals can be grouped in ordered lists (groups) and supplementary information can be added to each trace
(signal name, X Y Z coordinates, picks, ...). These data cannot be stored in all types of file headers due to the
heterogeneities of the signal file formats.
For this reason, a database is generated to gather in an independent and handy way all information. A database
is stored under a .sdb file that lists all signal files corresponding to a particular project or site. Hence, the
signals are not duplicated when creating a database, keeping links to the original signal files and saving disk
space. One interest of databases is to reload all signal files of a project with a simple click. Each database is
affected a directory containing the .sdb file plus other secondary files.
New files are automatically added to the database when a trace is modified (Processing) and saved inside the
database directory with a quick access format (binary). The original signals are still present in the database.
Viewers
They are three ways of viewing the signals in Geopsy: Table, Graphic and Map. Each viewer is a floating
window in the main Geopsy frame that contains a sub list of signals currently loaded (with or without a
database created). According to each viewer, it is possible make a selection of signals and to create another
viewer containing only the selected signals (drag and drop mechanism).
The table shows textual information about each signal (one per row). The number of columns and the data
displayed is entirely configurable. Each field can be directly edited. For long signals (millions of samples), it
is handy to select signals with a table because only the header information is loaded into memory, the whole
traces are not loaded from files. The contents of tables can be exported and imported to ASCII files.
The graphic shows the signal themselves with a time scale. Various options are available for plotting traces
(e.g. variable black area, normalisation, colour scale, ...). All signals are stored as time series. However, they
can be plotted as frequency spectra after Fourier transforms. A zooming facility has been implemented to ease
data inspection. Signals cannot be selected inside a graphic viewer, they are all selected by default.
Database
Processing
Geopsy proposes two kinds of signal processing tools:
1. Basic processing (menu "Waveform"): filters, Fourier transform, taper, cut , DC removal, merge,
subtract, multiply, ... These transformations directly affect the signals and the results are automatically
updated on the screen. Reverting to the original is always possible. On saving a database, the
modified signals are saved with a raw binary format (best I/O performances) into the database's
directory. Both the original and the modified signals remain accessible in the database.
2. Advanced processing (menu "Tools"): these are tools developed for special purposes. A plugin
mechanism allows you to add new tools without upgrading the main Geopsy frame. Originally, the
available tools were dedicated to the analysis of ambient vibrations. The development of new
specialised tools are pretty welcome (developers).
Scripting
In certain cases, the graphical user interface may not be useful especially for repetitive tasks. Thanks to Qt
Script for Application (QSA from Trolltech), it has been possible to propose a versatile scripting language to
execute any of the functions available with mouse clicks. These scripts can be launched from the command
line allowing its inclusion into complex bash scripts, for instance.
The available functions within a script currently do not cover the whole functionalities of Geopsy. The users
are particularly encouraged to give their feedback on this topic to accelerate the development on the most
popular tools ().
Viewers
2. Installation
The next beta release is installed from distribution packages. This step is still under development. Developer:
CVS basic commands and registration at www.geopsy.org
2. Installation
3. Tutorials
The following tutorials are documented in this chapter:
3.1. Creating a database
3.2. Refraction survey
3.3. H/V measurements
3.4. Noise array measurements
Tutorials 3.3 and 3.4 are both built around a demo database which is build with the tutorial 3.1. You can skip
the database construction by downloading the finalised database. When opening it for the first time, you will
probably receive a warning complaining about a missing signal file. Click "No" and specify the path to the
required file (usually in "geopsy_tutorials/raw_signals"). Save the database at least once to save the modified
paths.
3. Tutorials
3. Launch geopsy
For Linux or Mac users, it is interesting to start geopsy from the terminal at least once to be familiar with the
output messages or warnings. Otherwise, go to the platform specific menu to start new applications: KDE or
Gnome menus, 'Startup' for Windows,... The exact name of the shortcut depends upon your installation
parameters.
Starting Geopsy's main frame
mwathele@Canucks:~$ geopsy&
Check your configuration, specified in the installation manual, if geopsy fails to start. If it is the first time you
execute geopsy, you should see a splash screen and a first dialog box entitled "Preferences". At this stage,
click on "OK" to accept the default settings.
10
Figure 2: Dialog box that lets you modify the information displayed in tables.
In the left column, you have the names of the internal variables. On the right, you have the associated title in
the table. Replace one the useless fields (in this tutorial, e.g. "ID"), by the name of the file ("FILE_NAME").
Make sure (for the next steps) that the fields "NAME", "COMPONENT", "REC_X", "REC_Y", and "REC_Z"
are in the list. Click on "OK" to apply the changes to the current table. The complete names of each signal
should appear in the table.
Figure 3: Dialog box that lets you modify header information of each signal contained in the current viewer.
11
Figure 4: Dialog box that lets you sort the signal in a viewer.
Click on "OK" to apply the equation to the signals of the current table. Sort the signals by "name" to group the
same components together. Click on menu "Edit" and select "Sort" item. A dialog box as shown in figure 4
lets you reorder signals in the current viewer according a series of userdefined criteria. Select a "Signal
name" in the bottom list, click on "Add". If the list of criteria was not empty, first remove all items by clicking
on "Remove". The position within the list is important, the first item is the main sort key. Click on "OK" to
reorder the signals in the current table.
Select all the signals with the name equal to "2.sac". Drag and drop these signals to the table icon ( ). Click
on menu "Edit" and select "Set headers" item to modify the "COMPONENT" field for the signals of the
newly created table. Enter the following equation or load the file setnorth.formulas:
Equation to set component as North
component = & North
Once the components are changed, close the current table and go back to the first table containing all the
signals. The same job must be done for "3.sac" (corresponding to East components). Enter the following
equation or load the file seteast.formulas:
Equation to set component as East
component = & East
The content of the main table is not refreshed after any changes performed in another table. To check the
result, close the main table and create a new one as described here above.
12
13
14
15
16
17
18
4. Database
This chapter explains how to work with a Geopsy Database. Creating a database on the disk is not a
mandatory step. You can use Geopsy to view and to process signals on single file basis. However, you would
miss a number of interesting features such as grouping of signals and automatic storage of modified signals.
This chapter contains the following sections:
4.1. Load signal files
4.2. Create, Open, Close and Save
4.3. Groups of signals
4.4. Preferences
4.5. File structure
Type
Description
COMPONENT
string
COUNT2VOLT
double
DELTAT
4. Database
19
DUPLICATE_RAYS_AVERAGEn double
DUPLICATE_RAYS_ID
integer
double
double
Time elapsed between the first and the last sample of the
signal (in seconds). This parameter is not saved in the
structure but calculated from DELTAT and NSAMPLES.
This parameter is readonly.
END_TIME
double
Time elapsed between the first and the last sample of the
signal (in seconds). This parameter is not saved in the
structure but calculated from DURATION and T0. This
parameter is readonly.
FILE_NAME
string
FILE_NUMBER
ID
integer
string
MAXAMPLITUDE
double
NAME
string
DUPLICATE_RAYS_STDERRn
DURATION
ISORIGINALFILE
20
NSAMPLES
NUMBER_IN_FILE
double
PICK_IDn
integer
REC_X,Y,Z
double
SAMPFREQUENCY
SIGNALPTR
PICKn
SRC_X,Y,Z
double
T0
TIME_REF
string
21
TYPE
char
Notes: "double" means double floating point real numbers coded on 64 bits, "integer" means a positive or
negative integer, "string" means any string of characters, and "char" is a single character. The fields marked in
bold represent the most important parameters that must be correctly defined to allow a visualisation of the
signal.
When a new signal file is loaded into the database, a new memory structure is allocated for the signal and the
fields listed above are filled in from the information contained in the file header. The information extracted
from the file header depends upon the file format (see Load signal files).
The signal samples are never directly read on opening a file which greatly speeds up the signal handling for
the user comfort. According to the user actions (e.g. visualisation of traces), it might be necessary to load the
samples into memory. In Geopsy core engine (library geopsycore), a special mechanism has been developed
to cache the signal vectors (keep signals in memory as long as possible until no space is left, then purge
rationally according to space needed). From the user point of view, it might be noticed that the first time a
signal is visualised, it may be slower than for any later access.
Any subset of the total ensemble of signals can be created. The information is never duplicated because subset
are defined by pointers to the original signal structures. The subsets are visualised through tables, graphics and
maps detailed in other sections.
22
23
24
25
Automatic recognition
The table here below gives the criteria used to recognise the file formats. The conditions are processed in
order from the first to the last row. At the first match, the format is considered to be recognised.
26
File formats
SU big endian. Currently, no automatic detection of the byte order has been
implemented for SU format. For SU little endian, the manual file format
selection is necessary.
Sismalp format, a ".sis" or ".ndx" (and viceversa) must also exists in the
same directory.
Wave PCM sound file, just for fun to analyse your favourite music albums.
GSE2 format, test by default for multiple signals in the file. This option may
take some time for long signals. If there are only one signal per file, select
manually "GSE2 Single Signal".
City shark 2 file. No distinction between format 1 and 2, both are accepted.
Wave PCM sound file, just for fun to analyse your favourite music albums.
Database signals
It is the format used by Geopsy to automatically save modified signals. Usually you never import original
signals written under this format. This new format has been introduced in Geopsy because it is the closer to
internal memory vectors, hence I/O access are optimised.
Geopsy database signal format
Automatic recognition
27
10
10
Version, current is 1
14
18
22
4*n
22+4*n
8*n
22+12*n
nsamp[i]
For each signal (0<=i<n), the samples coded on 64 bits floating point
numbers.
Binary SEG2
This file format is described in ...???(text of the norm). It is the usual format acquired with Geometrics
instruments.
Seismic Unix
Arrival times
RD3 RAMAC
NiSismo
SAC
Radan GSSI
GSE
CityShark
ASCII Multi column
SESAME SAF
Sismalp
Database signals
28
Wave PCM
Formats not supported
SEGY and other instrument specific formats should be implemented as soon as possible.
Removing a file
To remove a file from the database or from the "Files" list, select "Remove" from the context menu in "Files"
list. Multiple and complex selections (SHIFT and CTRL) can be used to remove several files at the same time.
If the removed files are original files, the signal file is unaffected, only the information stored in the database
is irreversibly lost. In the other case (modified files), the signal is removed from the database directory and the
information about these signals is also lost.
Wave PCM
29
30
Closing a database
Right click in "Files" list, the context menu shown in figure 2 will appear. Select "Clear all". You will be
prompted for closing all active viewers. This is normal because viewers have references to signals that will be
removed by this action. If header information or signals were modified, you will be asked to save the database
first.
31
32
Selecting signals
As detailed in section Signal viewers, they are three ways of viewing signals: tables, graphics and maps. Each
viewer is associated with a sub set of signals. Here, we use the "table" viewer to explain the "drag and drop"
mechanism. The specificities of the "drag and drop" for each viewer are explained in section Signal viewers.
You can select the signals on a file basis with the "Files" list, or on a group basis with the "Groups" list. In
both cases, press SHIFT or CTRL key to create complex selections. "All files" and "All groups" represent all
signals (except the temporary signals, see Basic signal processing) and the union of all groups, respectively.
Press the mouse left button on the selection and move the pointer towards a viewer icon in the tool bar (e.g.
the table icon is
). Release the mouse button, a table will be created containing the selected signals.
In a table, you can select various signals with SHIFT and CTRL keys. Press the mouse left button on a
selected row and move the pointer again to the table icon. A new table is created with the restricted selection.
A signal may appear several times in a single viewer. You can drop signals into an existing table, the new
signals will be added at the end.
Sorting signals
To select signals, it may be interesting to sort the list of signals. For instance, if you want to select all the
signals measured on the vertical component, first create a table with all signals. Sort the signals by component
and select the block of signals with the vertical component.
33
Figure 1: Dialog box that lets you sort the signal in a viewer.
Sorting can be done in the active viewer by selecting item "Sort" in menu "Edit". The "Edit" menu always
apply to all signals of the active viewer. A dialog box as shown in figure 1 will be displayed.
The selected keys are listed in the twocolumn table (Key and Order). Available keys are listed in the combo
box at the bottom. Check or uncheck the "Descending order" checkbox as necessary and click on "Add"
button to add a key to the sort. To use "Delete" or "Insert", you must select one row of the table. "Insert" will
insert the new key right before the selected key. Hit "Delete" several times to remove all keys. After clicking
on "OK", the list of keys are stored and the signals of the active viewer are sorted.
Though multiple keys of the same kind are possible, it is totally useless. Moreover, using multiple keys has an
effect only when there are equal values in the first keys.
Viewing groups
Groups are manipulated in the same way as files with the drag and drop mechanism described here above.
Renaming a group
Select only one group (not the first one "All groups"). Click on the right mouse button. In the context menu
select "Rename". Type the new name in the simple dialog box and hit "OK". The ".group" file corresponding
to the group is directly renamed, but the ".grouplist" file is not affected. Do not forget to save the database to
Sorting signals
34
Modifying a group
Create a viewer (e.g. a table) with the group. Modify its content (sorting, adding new signals, ...). Select "New
group" in menu "Edit" and enter the name of the existing group. The original group will be overwritten.
Saving the database in this case is not necessary but strongly advised to avoid confusions with the other
actions.
Deleting groups
Select one of more groups and choose "Remove" from the context menu (after a right click in the "Groups"
list"). ".group" files are directly removed from the database directory, hence this action cannot be cancelled.
Saving the database is mandatory if you do not want to pollute the "Groups" list with empty defunct groups.
Renaming a group
35
4.4 Preferences
This section explains how to configure geopsy. Various settings can be adjusted within the graphical user
interface. This section also explains how to deal with directory paths that are automatically saved during your
work. For advanced users, the way the options are saved and how to change them are detailed.
Loading files
4.4 Preferences
36
Loading files
37
Memory
Time reference
38
Memory
39
Table
40
To save the current configuration, copy these lines to another text file for backup. Modify the configuration
with the Preferences dialog box. To restore the old settings, close all instances of geopsy, open the setting file
again and replace the lines "ids=..." and "titles=..." by the lines you saved. The reason for closing geopsy
before writing to the setting file is that the file is updated by geopsy on closing and it may overwrite your
changes.
Tools
Tools
41
H/V
42
Directory paths
Each time you select a file to open or to save, geopsy automatically stores the path of the selected file. The
next time you will open or save the same type of file, the dialog box will start on this directory avoiding
fastidious clicks to move from your home or your "My Documents" directory to your working directory.
Furthermore, every visited directory for this type of files is stored in the combobox at the top of the dialog box
(figure 6). You can them quickly jump to a frequently used directory.
Figure 6: Quickly jumping to frequently used directories in the file dialog box.
Within the context shown in figure 6, if the current project you are working on is located in
"/data/belgium_march02/baviere", all paths to load or save files (database, signals, formulas, ...) will begin
with "/data/belgium_march02/baviere". If you want to switch to another project located, for instance, in
"/data/M2/", you can modify the stored paths in a single click by using projectpath utility.
Directory paths
43
Storage of settings
The default values appearing in dialog boxes displayed by geopsy are always equal to the preceding values set
by the user for these items. These values are stored in the same file (for Linux users) as fields of tables,
"$HOME/.qt/geopsyrc", under the label "[DialogOptions]". If you want to remove all user settings and return
to the original default, close all instances of geopsy and remove all entries under "[DialogOptions]".
Removing the file "$HOME/.qt/geopsyrc" has the same effect but also resets other stored settings. Under
Windows, the same reset can be done by removing key entries in the registry (with regedt32, key
"CURRENT_USER/Softwares/geopsy").
Storage of settings
44
".sdb" file
This is a text file containing one value per line, with the following syntax.
Syntax of lines for the ".sdb" file
KEYWORD=VALUE
KEYWORD is case sensitive and it cannot contain any '=' sign. Blanks are not accepted before the
KEYWORD and around the '=' sign. The VALUE on the right can contain any characters including blanks.
The order of KEYWORDs is strict. The first line of the file is the version of the format. Currently, version is
2. The file contains a list of signals grouped by file. The general structure is:
General structure of ".sdb" file
version 2
FILE=/absolute/file/path/and/file/name/of/first/signal/file
FORMAT=7
ISORIGINALFILE=1
ID=1
... specific information about first signal
ID=2
... specific information about second signal
...
ID=n
... specific information about signal n
FILE=/absolute/file/path/and/file/name/of/second/signal/file
FORMAT=8
ISORIGINALFILE=1
ID=n+1
... specific information about first signal
45
The information about each signal contains the following keywords (the order is strict):
Information about each signal
ID=1
NAME=R01A
COMPONENT=0
T0=0
TIME REF=01/01/2003 00:00:00
DELTA T=0.00875
TYPE=0
PICK 1=102.688
PICK 2=298.102
PICK 3=0
PICK 4=0
PICK 5=0
PICK 6=0
PICK 7=0
PICK 8=0
PICK 9=0
PICK 10=0
PICK ID 1=1
PICK ID 2=0
PICK ID 3=0
PICK ID 4=0
PICK ID 5=0
PICK ID 6=0
PICK ID 7=0
PICK ID 8=0
PICK ID 9=0
PICK ID 10=0
RECEIVER=1988 2002 0
SOURCE=0 0 0
The number of signals in each file specified in "db.sdb" must be equal to the real number of signals stored in
the signal file. On opening a database, the signal files are not checked. Though a database may be created
outside geopsy, this method is not advised and may lead to unstable behaviours. However, the original files
are never modified and the ".sdb" is written only when choosing "Save database" from menu "File", hence
there is absolutely no risk to corrupt the original information.
".grouplist" file
There is only one ".grouplist" file per database. It contains the list of groups referenced by their names. Each
characters is coded on 16 bits which forbid its modification with any text editor. Under Linux, you can
visualise this file with bvi or with kwrite (set encoding to UTF16). The binary format depends upon the export
format of QStringList. The first 32 bits is the number of groups. Then, each name is stored with a first 32 bits
for the string length and the characters coded on 16 bits.
".group" files
This is a binary file that contains the list signal IDs belonging to the group. The format is very simple: a list of
integers (32 bits). The base name of these files is the group's name. Under Linux, you can visualise this file
with bvi.
".sdb" file
46
".sig" files
When geopsy is running low on memory space, it may be forced to swap signal vectors to the disk. If the
current user have sufficient permissions in the database directory, temporary files are written in this directory.
When no instance of geopsy is running, none of these files must exist. In case of crash, it may be possible that
some of these file were not correctly cleared. You can remove all of them without any consequences assuming
that no database is currently running.
"_n" files
When saving a database, the modified signals are automatically saved to the database directory. These files
have the same names as their original files with a suffix "_n", n being a unique number. Do not remove these
files manually. You can remove these files by removing their entries in the database.
".sig" files
47
5. Viewers
Any subset of the total ensemble of opened signals can be created with the "drag and drop" mechanism
explained in section Selecting signals. The subsets are visualised through tables, graphics and maps detailed in
this chapter:
5.1. Table
5.2. Graphic
5.3. Map
The various actions that can be performed with a subset of signals (either a table, a graphic or a map) are
described here after.
File export
Select item "Export" from menu "File". You will be prompted to select the file format. Various formats are
currently proposed:
SEG2
SAC: little or big endian
SU: little or big endian
ASCII: one or multi columns
Surf: surfacewave inversion from R. Herrmann
SAF: Sesame ASCII file format
WAV: PCM sound file, to create sound from seismic signals (generally requires a strong modification
of the sampling frequency: 44 kHz for usual music records).
Not all these formats support multiple signals in a single file. If those case you will be prompted to select an
export directory or to enter the names manually.
Waveform
Basic signal processing can be performed on all the signals of the active viewer. These processing are
gathered in menu "Waveform". For details, refers to chapter Basic signal processing.
5. Viewers
48
Tools
Tools are developed as plugins and provide specific signal processing (menu "Tools"). As for basic signal
processing, the selected tool is applied to the signals of the active viewer. For details, refers to chapter
Specific processing tools.
"Edit" menu
All menu items in "Edit" menu apply to all signals contained in the active viewer.
Sorting signals
This feature is explained in section Sorting signals.
Editing headers
This feature helps you modify the header information by the means of generic formulas.
Editing receivers
This feature helps you modify the coordinates of receivers. The signal names are considered as names of
stations to which corresponds only one unique set of coordinates.
Tools
49
5.1. Table
Basically, a table allows you to view and to edit the header information about signals. Each row represents a
signal and each column is an information field. The order and the list of displayed fields is specified by the
table preferences for all newly created table. You can also change the displayed information for the active
table only by selecting item "Set data fields" from menu "View". Columns and rows can be resized (press
mouse at the limit between two columns or cells). However, automatic resizing is usually correct.
Signal selection
Signals are selected with the mouse left button. If the SHIFT key is also pressed the selection is extended from
the current row to the selected row. If the CTRL key is pressed at the same time as the mouse left button, the
selected row is added to the selection and become the current row. The current row contains the active cell.
Pressing the mouse left button on any selected row and moving the pointer initialise the drag and drop
mechanism marked by a modified mouse cursor. A circle crossed by a line means that the signals cannot be
dropped at this place. When it changes to a plus sign, the mouse left button can be released to drop the signals
to the destination (an existing viewer or the icons of viewers:
).
Cell editing
To edit the contents of a cell, doubleclick on it and modify the value. The signal internal structure is
automatically modified. However, if other tables are opened and if they also contains the modified signal, the
changes are not updated automatically. To update them, select one of them and choose "Refresh now" from
menu "View", or alternatively type CTRL+r.
You can edit any cells, but some of them are linked to readonly fields (e.g. NSAMPLES, the number of
samples). Error messages are displayed in those cases and the edition has no consequences.
Export
Copy and paste action are not possible like in common tabular softwares. However, it is possible to export the
information contained in a table to a text file (column separated by TABs) which can be in turn loaded in any
usually tabular software. The file can be edited and imported in the table to apply the changes. The same
restrictions as when editing readonly cells individually apply.
To export a table, select "Export" from menu "File". A combobox lets you select the export format. Select the
last one ("Table"). The resampling parameter is ignored. Enter the file name to export. A default extension
5.1. Table
50
This file contains all the variables that were listed in Geopsy's Table
You can edit this file as you want. The names of columns appear here only
for readability. All columns must be separated by only one tabulation.
Lines starting with "%" are always ignored when importing. The first line
starting without "%" must contains the ID of each variable. Those IDs are
listed below: (variables marked with * could not be changed by the user)
ID_VAR_ID*
= 0
ID_VAR_T0
= 1
ID_VAR_DELTAT*
= 2
ID_VAR_NSAMPLE*
= 3
ID_VAR_REC_X
= 4
ID_VAR_REC_Y
= 5
ID_VAR_REC_Z
= 6
ID_VAR_SRC_X
= 7
ID_VAR_SRC_Y
= 8
ID_VAR_SRC_Z
= 9
ID_VAR_NAME
= 10
ID_VAR_TYPE*
= 11
ID_VAR_PICK1
= 12
ID_VAR_PICK2
= 13
ID_VAR_PICK3
= 14
ID_VAR_PICK4
= 15
ID_VAR_PICK5
= 16
ID_VAR_PICK6
= 17
ID_VAR_PICK7
= 18
ID_VAR_PICK8
= 19
ID_VAR_PICK9
= 20
ID_VAR_PICK10
= 21
ID_VAR_PICK_ID1
= 22
ID_VAR_PICK_ID2
= 23
ID_VAR_PICK_ID3
= 24
ID_VAR_PICK_ID4
= 25
ID_VAR_PICK_ID5
= 26
ID_VAR_PICK_ID6
= 27
ID_VAR_PICK_ID7
= 28
ID_VAR_PICK_ID8
= 29
ID_VAR_PICK_ID9
= 30
ID_VAR_PICK_ID10
= 31
ID_VAR_FILE_NUMBER*
= 32
ID_VAR_NUMBER_IN_FILE*
= 33
ID_VAR_DUPLICATE_RAYS_ID*
= 34
ID_VAR_DUPLICATE_RAYS_AVERAGE1* = 35
ID_VAR_DUPLICATE_RAYS_AVERAGE2* = 36
ID_VAR_DUPLICATE_RAYS_AVERAGE3* = 37
ID_VAR_DUPLICATE_RAYS_AVERAGE4* = 38
ID_VAR_DUPLICATE_RAYS_AVERAGE5* = 39
ID_VAR_DUPLICATE_RAYS_AVERAGE6* = 40
ID_VAR_DUPLICATE_RAYS_AVERAGE7* = 41
ID_VAR_DUPLICATE_RAYS_AVERAGE8* = 42
ID_VAR_DUPLICATE_RAYS_AVERAGE9* = 43
ID_VAR_DUPLICATE_RAYS_AVERAGE10* = 44
ID_VAR_DUPLICATE_RAYS_STDERR1*
= 45
ID_VAR_DUPLICATE_RAYS_STDERR2*
= 46
ID_VAR_DUPLICATE_RAYS_STDERR3*
= 47
ID_VAR_DUPLICATE_RAYS_STDERR4*
= 48
Export
51
dt
N samples D
46330
46330
46330
46330
00:06:45.
00:06:45.
00:06:45.
00:06:45.
46330
46330
46330
46330
00:06:45.
00:06:45.
00:06:45.
00:06:45.
...
62
63
65
66
R09C
R09C
R10A
R10A
North
East
North
East
01/01/2003
01/01/2003
01/01/2003
01/01/2003
00:00:00
00:00:00
00:00:00
00:00:00
0.0000
0.0000
0.0000
0.0000
s
s
s
s
00:06:45.3875
00:06:45.3875
00:06:45.3875
00:06:45.3875
114.286
114.286
114.286
114.286
0.00875
0.00875
0.00875
0.00875
Import
Select "Import table" from menu "File". The first uncommented line must contains the list of fields to modify
specified with IDs separated by TABs (see Export). The first signal of the active table is modified according
to the second uncommented line of the imported file. The second signal with the third uncommented line and
so on until reaching either the last signal or the last line of the file.
To avoid errors when importing files, it is better to leave the exported table active while modifying the
exported file and to reimport the modified file with the same active table, to be sure that the order and the
number of signals is exactly the same. In this case, never remove lines from the exported file. To limit the
number of potential errors, you can remove all columns except the ones you really want to change. This
method for modifying the fields of a table must be used with care and should be used only when there is no
other choice.
Import
52
5.2. Graphic
A graphic is an XY plot where one or more signals are represented as a function of time or frequency. When
only one signal is represented, the Y scale is the signal amplitude (count or volts). When various signals are
shown (see figure 1), the Y scale ranges from 0.5 to n+0.5 where n is the number of signals. The axis label are
generally replaced by the names of signals suffixed by the signal's component. The baseline (reference line
with a null amplitude) of each signal is located at y=1, 2,..., n. The signals are drawn around their baseline.
The maximum amplitude around this baseline is adjusted by the normalisation parameters described hereafter.
53
5.2. Graphic
54
55
56
57
Signal selection
Contrary to tables, it is not possible to select particular signals in a graphic viewer. The drag and drop
mechanism works in a similar way but all the signals are considered rather than a selection. Graphic viewers
also accept drops of signals that are added at the end.
58
5.3. Map
A map is a twodimensional representation of the receiver coordinates in the XY plane. Like the graphic
viewer, it makes use of a general XY plot object from the scifigs library. More information about it can be
found in the scifigs documentation. The area of a map is partitioned in the same way as a graphic viewer. The
main layer is a XYNamePlot which means that signals (or stations) are represented by configurable symbols
(shape, size, colour, ...) and by their names the relative positions of which can be adjusted (top, left, right,
bottom, distance). To create plots suitable for publication, you can save the layer to a ".layer" file, edit the
structured text file to customise your presentation (see scifigs documentation), and restore the modified layer
into figue.
Map scale
Scales of maps are intrinsic properties of XY plot objects (see scifigs documentation for details). Some tips
are given here.
Both X and Y axis have by default the same scale. The scale is automatically adjusted so that all the receiver
coordinates of the signals contained in the viewer remain visible. Resizing the viewer has no effect on the
scale, it changes only the axis minimum and maximum values. To change the scale, edit the axis properties
doubleclick or context menus, "Properties"), tab "Geometry". Modify the scale (e.g. 400, for 1cm = 4m).
Make sure the scales are the same for X and Y axis to avoid distortions. Alternatively, you can resize the map
viewer (this saves the size to the user settings). Then create a new viewer with the drag and drop mechanism
(or redo the what you did to create the present one):
Select all signals (see hereafter);
Leave the editing mode;
Press the mouse left button and move the pointer to the map icon (
Release the mouse button.
5.3. Map
);
59
Signal selection
Apart from the visualisation, maps offer the advantage over tables that you can select station according to
their localisations. In the graphic's contents, click on the mouse right button to activate the context menu,
select "Edit". The object switch to the editing mode marked by "Editing ..." in red in the lower left corner (see
figure 1). When you press and move the mouse in this mode, a dotted rectangle is displayed. When releasing
the mouse, all coordinates that fall within this rectangle are selected (marked as bold and red), others are
unselected. To add selected signals (without unselecting signals outside the rectangle), press SHIFT when
releasing the mouse. To leave the the "Editing" mode hit CTRL+SHIFT+e or select "Edit" again. If several
signals have the same coordinates they are indistinctively selected together.
The drag and drop mechanism is deactivated when the "Zooming" or the "Editing" mode is switched on. To
move the selected signals to another viewer, first leave these modes and drag and drop as usual.
Map scale
60
Modified signals
On opening a database, all signals (either orignal or not) belong to one unique file. The amplitude vectors are
stored on disks and a copy is made into memory on request (e.g. calculating MAXAMPLITUDE in a table,
viewing signals in a graphic). When a process modifies the signal (e.g. a filter), only the amplitude vector in
memory is affected. The original file remains unchanged. The signal is marked as modified.
For those signals, it is possible to erase the changes and to reload the amplitude vector stored in the disk file.
Select "Revert to saved" from menu "Waveform". The signal is then marked as untouched.
On closing a database, if there are still marked signals, a warning will be issued to remind you to save the
changes. When the database is saved, the modified signals are saved in the database directory with a binary
format. Those signals become individual new signals in the database (not specifically linked to the original
signals). They are just stored in a file name closed to the original file name (decorated by "_n", n being
unique).
61
Temporary signals
Some processing create new temporary signals (e.g. cut). These signals have no storage on the disk to revert
from. They are totally lost, without warning, on closing database, nor they are saved when you save a
database. Temporary signals are easily recognized in a table which displays the FILE_NAME. The file name
is set to "### Temporary signal ###".
If you want to check if there are temporary signals in your opened database, Drag "All signals" from "Files"
list to a table. Look at the FILE_NAME field.
To export those files to a disk file, create a viewer with them gathered and select "Export ..." for menu "File".
Select the appropriate format in the list. If you want to include them permanently in the database, "SAC"
format is a good choice. Load the generated file(s) into the database and save the database. Note: the exported
files must not be in a temporary location, create them in a permanent directory (e.g. the database directory).
Temporary signals
62
6.1. DC removal
Time Domain
6.1. DC removal
63
Butterworth
Time Domain
Butterworth: this is a causal filter of adjustable order. The lowest order is the best (shortest) in the time
domain, and the higher orders being better in the frequency domain. More information about such filters can
be found for instance at sepwww.stanford.edu. Causality is an option of the filter. Causal filters are outphasing
and viceversa.
64
65
66
67