Teseo2 is a software tool for quick and accurate digitization/vectorization of seismogram traces from raster files.
It has been developed in the framework of the Sismos project [Michelini and the Sismos Team, 2005] at Istituto Nazionale di Geofisica e Vulcanologia (Italy). This name was inspired by the myth of Theseus and it is also an acronym for
Turn the Eldest Seismograms into the Electronic Original Ones.
Teseo2 is a plug-in for GIMP - GNU Image Manipulation Program - that extends its functionalities for seismological studies. The GIMP is a multiplatform photo manipulation tool freely distributed. It works on many operating systems, in many languages.
Teseo2 allows primarily for:
- additional operations on the vectorized trace (i.e. resampling and alignment)
- supervised vectorization algorithms (colour weighted mean)
- analysis after trace vectorization, such as curvature correction and time realignment
- trace import/export in several formats (such as SAC, SVG, DXF, ASCII, Timemarks distances).
In order to keep track of the stages and parameters of a seismogram vectorization, Teseo2 is able to write this information into the image saved into GIMP's native XCF file type.
Teseo2 is developed following the "Open-Source" philosophy and it is freely distributed under GPL license. It is cross-platform and the sources, the binaries for Linux, Windows and Mac OS X, are periodically updated on the Sismos web site.
- GitHub website: https://github.com/INGV/teseo2
- Website: http://teseo.rm.ingv.it/
- Developer e-mail: teseo [at] ingv.it
- User mailing list: teseo-user [at] yahoogroups.com
- Mailing list archive: http://groups.yahoo.com/group/teseo-user/
- GIMP: https://www.gimp.org/
- Teseo User Manual: TeseoUserManual.md
- Teseo and Seismogram Digitization Workflow: http://teseo.rm.ingv.it/docs/posters/poster_ssa.pdf
- Teseo for Dummies: http://teseo.rm.ingv.it/pub/teseo/doc/teseo2_for_dummies.pdf
We recommend to run Teseo by Docker in a Unix-like environment (Linux or Mac OS X).
We tested the new docker installation on Linux and Mac OS X. We have not had a chance to test the docker installation on Windows as well. But with an X server, an ssh client and a few other little tweaks it should work.
-
Docker (Linux, Mac OS X, Windows)
-
X11 server
- Mac OS X: Xquartz - https://www.xquartz.org/
- Important note for XQuartz: in XQuartz Preferences, within "Security" tab, you have to check the option "Allow connections from network clients".
-
git
- Mac OS X: Xcode -
xcode-select --install
- Mac OS X: Xcode -
-
make
- Mac OS X: Xcode -
xcode-select --install
- Mac OS X: Xcode -
-
ssh client
- ssh client is required for running Teseo Docker Image by
make run_ssh
(see below the option based on ssh and X11).
- ssh client is required for running Teseo Docker Image by
git clone https://github.com/INGV/teseo2.git
cd teseo2
Edit the file Makefile.env
and set properly the following custom variables:
######################################
# Custom variables
######################################
#Dockerfile
DOCKERBASEIMAGE=alpine
DOCKERFILE=Dockerfile.$(DOCKERBASEIMAGE)
# Custom SSH port used to access to docker container
SSH_CONTAINER_PORT = 10022
# User ID and Group ID for teseo user and group.
# WARNING: On Linux, if you run docker image by different UID or GID
# you could not able to write in docker mount data directory.
# If you want always add new teseo user and group set ENV_UID and ENV_GID to zero.
ENV_UID=`id -u`
ENV_GID=`id -g`
# ENV_UID=0
# ENV_GID=0
# Default docker mount data directory
BASEMOUNTDIR = `pwd`/DockerMount
Then run:
make build
Teseo Docker Image is based on X11 environment. You need to set up an X11 server on your computer.
You can run Teseo Docker Image by one of the two following options:
NOTE: This is the general solution based on docker SSH server service.
This solution should work on all cases.
You have to run the docker container as a SSH service by:
make up
Then run teseo2:
make run_ssh
When you finished to use the docker container remember to stop it by:
make down
WARNING: It works only on Linux. It does not work on Mac OS X!
make run_xlocal
To update your Teseo Docker Image pull the changes from git
repository and rebuild by make
.
cd teseo2
git pull
Rebuild
make build
- gimp-2.2.9 up to gimp-2.10.x
The configure scripts might fail asking you the dependency libraries you have to install or to specify into PKG_CONFIG_PATH.
$ tar xzvf teseo*.tar.gz
$ cd teseo2/
$ cd gtk-addons
$ ./configure && make && sudo make install
$ cd ../newuoa
$ ./configure F77=<fortran-path> && make && sudo make install
$ cd ../teseo-2
$ ./configure && make && sudo make install
Details in file ./teseo-2/INSTALL
Stefano Pintore and Matteo Quintiliani.
Diego Franceschi, Antoine Schlupp, Daniel Amorese.
Michelini, A. and the Sismos Team (2005). Collection, digitization and distribution of historical seismological data at INGV. EOS, 86(28).
Pintore S., Quintiliani M., Franceschi D. (2005) Teseo: a vectoriser of historical seismograms. Computers & Geosciences, Volume 31, Issue 10, 2005, Pages 1277-1285, ISSN 0098-3004, http://dx.doi.org/10.1016/j.cageo.2005.04.001
Schlupp, Antoine & Cisternas, Armando. (2007). Source history of the 1905 great Mongolian earthquakes (Tsetserleg, Bolnay). Geophysical Journal International. 169. 1115 - 1131. 10.1111/j.1365-246X.2007.03323.x.
Cadek, O. (1987). Studying earthquake ground motion in prague from wiechert seismograph records. Gerl. Beitr. Geoph., 96:438-447.