Beruflich Dokumente
Kultur Dokumente
Abstract
Ambient vibrations are nowadays considerably used worldwide for numerous types of
engineering applications and scientific research. Geopsy and its companion tools are
part of that landscape. Since the first release of the program package in 2005, as out-
come of the European Union project Site Effects aSsessment from AMbient noisE,
Geopsy has become a mature multiplatform open-source package (released under
GNU Public License version 3) that has already been recognized as a reference tool
for analyzing ambient vibration data in the context of site characterization studies.
The community of users has grown from a core group of researchers up to thousands
of seismologists and engineers on every career level and on all continents. The versa-
tility of geopsy allows for the processing of all kinds of data needed in site characteri-
zation studies, that is, from single station single trace to three-component array
recordings. In all of the aforementioned cases, the steps from field acquisition to
the production of publication-ready figures are covered and supported by user-friendly Cite this article as Wathelet, M., J.-
L. Chatelain, C. Cornou, G. D. Giulio,
graphical user interfaces or corresponding command-line tools for the automation of B. Guillier, M. Ohrnberger, and A. Savvaidis
the complete processing chain. To avoid black-box usage, a number of lower-level tools (2020). Geopsy: A User-Friendly Open-
Source Tool Set for Ambient Vibration
guarantee maximum flexibility in accessing and controlling processing results at any Processing, Seismol. Res. Lett. XX, 1–12,
stage of the analysis. doi: 10.1785/0220190360.
(c) (e)
dropping them to one of the four destination viewers described Figure 1. Geopsy graphical interface showing (a) the list of
in the following (table, graphic, map, and chronogram; Fig. 1) imported files, (b) the list of groups and the four ways of viewing
creates a temporary association. Sources can be the list of signals: (c) table, (d) graphic, (e) map, and (f) chronogram. The
topmost menu bar provides access to all actions that can be
imported files, the list of permanent associations (groups), or performed on signals: input/output actions, editing signal
an existing viewer, which represents a temporary association properties, creating new viewers, waveform operations, and
of signals. At any time, it can be saved to become a permanent plugin tools. Just below, the icon tool bar contains a selection of
association (group). A group is defined by a name, a list of sig- the most important actions organized in three sections: input/
nals, and a parent group. Folders can be created to help organize output actions, creation of new viewers, and the list of plugin
tools. Data are taken from two ambient vibration arrays (circular
groups. For example, a group can keep together the signals from
arrays from 5 to 15 m and from 15 to 45 m) recorded in
a target site or signals with the same components. Associated Mirandola, Italy, during the InterPACIFIC project (Garofalo, Foti,
signals can be processed with any of the implemented basic sig- Hollender, Bard, Cornou, Cox, Ohrnberger, et al., 2016).
nal-processing tools, such as mean or trend removal, subtract,
multiply, filter, whiten, clip, phase shift, over-sample, decima-
tion, taper, cut, merge, three-component rotations, correlations, available and are implemented in separated plugins (see the
convolution, and instrumental response removal. All processes Plugin Tools section).
are logged as a sequence of JavaScript statements, which can be A table shows all properties of the signals with a tabular
executed on another signal association. For example, the follow- format, one row per signal and one column per property.
ing code cuts and exports 30 s windows starting at 2:30 a.m. on 1 The order and the list of the columns can be freely customized.
January 2000 from a list of three-component signals: The various ways of editing property values are described in
the next section. The rows of a table support complex selec-
n=signalCount(); tions with SHIFT and CTRL keys (Fig. 1b). Moreover, signals
for (i=0; i<n; i++) { can be sorted with multiple sort keys so as to ease the selection.
restoreStep (“original”); Once selected, signals can be dragged and dropped into a new
selectSignals (i, i); viewer or into an existing one.
cut (“[abs 20000101023000; delta 30s]”); A graphic displays signal data vectors with an absolute or rel-
name=header (0, “Name”); ative time axis. There is no limit to the number of signals to be
name+=“_”+header (0, “Component”); plotted. However, the length of a single signal cannot exceed the
exportFile (name+”.sac”); limit of the physical memory. If the size required by all signals is
} larger than a certain limit (by default, 80% of the physical
memory), the Geopsy internal swap mechanism prevents the
More examples and details can be found in Wathelet et al. use of the operating system swap. The latter often alters the
(2010). Other more sophisticated processing tools are also computer performances and challenges the user patience.
H/V
way all properties contained in
4 4 a .max file: dispersion, elliptic-
ity, noise, azimuth, and power
2 2 curves. An example is shown in
Figure 6 for a three-component
0 0 FK analysis. Once dispersion
0.5 1 5 10 0.5 1 5 10 curves and eventually elliptic-
Frequency (Hz) Frequency (Hz) ity curves are isolated for all
available modes, average
(c) curves with their standard
20 deviation can be computed by
gphistogram. They can be pro-
vided as targets to dinver, an
application implementing a
0.84
neighborhood algorithm
(b) (c)
Figure 5. Three-component frequency–wavenumber (FK) by a black circle; its velocity value can be changed in the
processing example for an array of 15 three-component stations. underneath controls (251 m/s in this example). The gray dots are
(a) Waveforms for the first five stations. The green rectangles located at the nodes of the starting grid used for searching
delineate the time blocks calculated for a frequency of 4.09 Hz automatically the FK maxima. (c) Processing parameters form
that can be adjusted in the parameter toolbox shown in (c). The divided into four tabs. Only the content of Processing tab is
red rectangles are the 60 blocks (block averaging count factor in shown. Time tab describes how time blocks are defined: starting
(c) times 15 stations) used for computing the FK map shown in and ending time to process, length of blocks, and so on.
(b). (b) Rayleigh three-component beamforming (RTBF) FK map Processing tab specifies the frequency range of interest and how
of the highlighted red blocks in (a). The colors represent the the cross-spectrum matrix is computed. Grid search tab provides
maximum RTBF power obtained after varying the ellipticity for ways to control the grid search of FK maxima. Status tab shows
each wavenumber point. Maxima are distributed over two circles, the processing progress over all parallel threads after pressing the
corresponding to two propagation modes. The slowest is marked Start button.
40
100 0
Velocity (m/s)
Ellipticity
0
500
–40
5 10 5 10
Frequency (Hz) Frequency (Hz)
(c) (d)
1 × 10–1
300
5 × 10–2
Azimuth (degrees)
200
Power 1 × 10–2
5 × 10–3
100
1 × 10–3
5 × 10–4
0
5 10 5 10
(e) Frequency (Hz) Frequency (Hz)
5 × 101
Incoherent noise
0 1 10 100 1000
1 × 101 Normalized probability density
5 10
Frequency (Hz)
(SESAME, an FP5 Project Number EVG1-CT-2000-00026, 2001– Figure 6. Example of results obtained with gpviewmax for a three-
2004), Sismovalp Intereg 3B project (2005), by the participants component FK processing. All plots show the probability density of
to the first site characterization workshops in Grenoble (2005) property values measured at the peaks of the FK maps. (a) Dispersion
and Berlin (2006), by NEtwork of Research Infrastructures for curve. Two modes are visible in this case. The black lines are located
European Seismology project (NERIES-JRA4, an FP6 I3 Project at the resolution limits kmin/2 and kmin (Wathelet et al., 2008).
(b) Ellipticity curves corresponding to the two modes visible in (a).
Number RII3-CT-2006-026130, 2006–2010), by Institut de Recherche
(c) Propagation azimuth distribution. (d) FK power. (e) Incoherent
pour le Développement (IRD) since 2008, and by European Plate
noise estimations as defined by Wathelet et al. (2018).
Observing System-Implementation phase (EPOS-IP). The authors
also thank all institutions that hosted the site characterization work-
shops; a list is available at http://www.geopsy.org. Geopsy website is
hosted at Observatoire des Sciences de l'Univers de Grenoble (OSUG), References
Université Grenoble Alpes, France. Finally, the insightful comments Aki, K. (1957). Space and time spectra of stationary stochastic waves,
of two anonymous reviewers helped raise the quality of the original with special reference to microtremors, Bull. Earthq. Res. Inst. 35,
article. 415–457.