Repository files navigation

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 theEldestSeismograms into theElectronicOriginalOnes.

Teseo2 is a plug-in forGIMP -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 nativeXCF 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.

• 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).

• Docker (Linux, Mac OS X, Windows)
  • https://docs.docker.com/install/
• X11 server
  • Mac OS X: Xquartz -https://www.xquartz.org/
  • Important note for XQuartz: inXQuartz Preferences, within"Security" tab, you have to check the option"Allow connections from network clients".
• git
  • Mac OS X: Xcode -xcode-select --install
• make
  • Mac OS X: Xcode -xcode-select --install

• ssh client
  • ssh client is only required for running Teseo Docker Image bymake -f Makefile.Docker run_ssh_xhost (see below the option based onssh andxhost).

git clone https://github.com/INGV/teseo2.gitcd teseo2

Edit the fileMakefile.Docker.env and set properly the following custom variables:

####################################### Custom variables#######################################DockerfileDOCKERBASEIMAGE=alpineDOCKERFILE=Dockerfile.$(DOCKERBASEIMAGE)# Custom SSH port used to access to docker containerSSH_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 directoryBASEMOUNTDIR =`pwd`/DockerMount# X11 Server Hostname or IP# Try to catch docker host IP when running run_xhostMYIP =`ifconfig| grep -w inet| egrep -v -w"127.0.0.1"| awk'{print $$2}'| head -n 1`# You can manually set# MYIP = X11_server_hostname_or_IP# Set path where searching xhost commandXHOST_PATH = /usr/X11R6/bin:/usr/bin/X11:/opt/X11/bin

Then run:

make -f Makefile.Docker 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 following option:

WARNING: It works only on Linux. It does not work on Mac OS X!

make -f Makefile.Docker run_xlocal

WARNING: Not when the machine is offline.

It is not possible running in this mode when you are offline (that is when your Docker host does not have any visible IP from docker container).

When you run this mode, you have to disable the access control to your X11 server, clients can connect from any host. Runxhost + ormake -f Makefile.Docker xhost_disable_control.

Run:

# OPTIONAL:#    xhost +#    make -f Makefile.Docker xhost_disable_controlmake -f Makefile.Docker run_xhost

NOTE: This is the general solution.

This solution should work on all cases:

• it is more general than previous based onxhost
• it is safer because enable access control only to the localhost machine. Runxhost +localhost ormake -f Makefile.Docker xhost_add_localhost
• and you can run also when your machine is offline.

Before you start, you have to run the docker container as an SSH server service by:

# OPTIONAL:#    xhost +localhost#    make -f Makefile.Docker xhost_add_localhostmake -f Makefile.Docker start

Then run:

make -f Makefile.Docker run_ssh_xhost

Note: when you finished to use the docker container remember to stop it by:

make -f Makefile.Docker stop

To update your Teseo Docker Image pull the changes fromgit repository and rebuild bymake.

cd teseo2git pull

Rebuild

make -f Makefile.Docker 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.