Teseo 2.0.8 user manual - Istituto Nazionale di Geofisica e
Contents
1. oela Figure 8 GIMP Path Tool Path order 6 Trace import export Teseo import and export several file formats as shown in figures 9 and 10 SVG Scalable Vector Graphics 2 DXF Drawing Interchange File Format 3 Trace Teseo proprietary ascii format It contains image reference and coordinate in pixels Only polylines ASCII plain text file that contains the coordinates x y sequence in millimeters Only polylines SAC Seismic Analysis Code 4 Evenly spaced binary SAC Only polylines SISMA plain text file Sismogrammi Storici software compliant Timemark plain text file that contains coordinates x y sequence identifying timemarks e B zier GIMP 1 0 B zier path format For downward compatibility e Examples binary format that contains information for neural networks learning Not available yet Up to now SVG export is possible only by GIMP Path tool DXF import is possible only on Teseo exported paths SAC import is not im plemented yet AAO N Teseo2 0 Filters Help Session x a Import gt I gt I9 gt A In w A Bezier GIMP 1 Figure 9 Teseo Path Import 7 Filters GIMP offers a variety of filters and instruments to manipulate images We strongly recommend to enhance the readability of your seismogram before vectorising For example you could increase the contrast of the image Warning if you want save the history of2. Teseo 2 0 8 user manual Revision 1 18 Date 2005 10 13 09 37 04 Stefano Pintore Matteo Quintiliani Istituto Nazionale di Geofisica e Vulcanologia Roma Italy Preamble This document contains the user manual of Teseo 2005 Teseo is a software tool for accurate digitisation of seismogram traces from raster files and it is distributed with open source license GPL Teseo is a plug in for GIMP The GIMP is the GNU Image Manip ulation Program It is a freely distributed piece of software for such tasks as photo retouching image composition and image authoring It works on many operating systems in many languages Teseo is part of Sismos project at Istituto Nazionale di Geofisica e Vul canologia Italy and his name is an acronym for Turns the Eldest Seis mogram in the Electronic Original One Official site at http sismos ingv it teseo and e mail to teseo ingv tt Contents 1 Install Teseo 2 2 Before starting with Teseo 2 3 Starting with Teseo 2 4 Vectorisation 5 5 Path manipulation 6 6 Trace import export 9 7 Filters 10 8 Before leaving Teseo 13 9 Credits 13 1 Install Teseo Before to install Teseo you need to install GIMP 2 2 because Teseo is a GIMP plug in Refer to GIMP installation at http www gimp org Teseo has never been tested on GIMP 2 0 Teseo is developed on Unix but it is available for several platforms such as Linux Windows and MAC OS X You can find source and binary distribution
3. an t change session file name When Teseo is starded on a image associated to more sessions the user can choose the preferred one TARA X example100 tsf Record Traces Path Notes Station data Name Azimuth Incidentangle Latitude Longitude Quote Exa 20 00 E 90 00 E 20 00 E 180 00 E E I Date Year Month Day Paper Speed mm sec 1 00 Image file home quintiliani cvswork teseo2 teseo distitese o 2 docs example xcf gz Resolution 1016 dpi Figure 2 Session window Record tab In figure 2 are shown the parameters associated to the seismic record e Station data following parameters will be saved in SAC files Name station code Azimuth component azimuth degrees clockwise from north Incident angle component incident angle degrees from vertical Latitude station latitude degrees north positive Longitude station longitude degrees east positive Quote station elevation meters e Date date of recording e Paper speed linear velocity of the paper mm sec e Image file name of the current image read only e Resolution image resolution read only TARA X example100 tsf Record Traces Path Notes Event first sample time Year Month Day Event pathname 19005 Efi El Hour Minute Second a a o Elfo l 0 Time mark first sample time Year Month Day _ Time mark pathname 1900 sf 1 Ifi El a el Hour Minute Sec
4. be transparent This works only on layer with alpha channel Horizontal Vertical check it to fill horizontal or vertical line Greater Less check it to fill lines longer or shorter than length 11 r 3 O X Teseo2 0 File Path Filters Help example xcf gz Parameters Base colour fo E New layer Threshold 128 S M Transparent Fill Colour 255 gl Horizontal Vertical greater Length is Ci than 20 a less Figure 11 Teseo Filter Clean e Length length of a single line on the image If you ve never used this filter you should try it on the example image contained in your Teseo distribution Follow these steps 1 Open example xcf gz 2 Select the Background layer inside the GIMP Layer Dialog and apply the filter using the following parameters e Base Colour 0 e Threshold 128 e Fill Colour 255 e New layer checked e Transparent uncheked e Vertical checked e Less checked e Length 9 3 A layer named Background copy will be created 4 Select the Background layer and apply the filter using the following parameters 12 e Base Colour 0 e Threshold 200 e Fill Colour 255 e New layer checked e Transparent uncheked e Horizontal checked e Greater checked e Length 28 5 A layer named Background copy 1 will be created 6 Select the layer named Background copy and set the layer parameter Mode to Multiply Nice I
5. ismologists and engineers In W Lee H Kanamori P Jennings and C Kisslinger editors International Handbook of Earth quake amp Engineering Seismology Part B pages 1613 1614 New York 2003 Academic Press 14 Index File formats ASCII 9 B zier 10 DXF 5 9 10 Examples 10 SAC 3 4 9 10 SISMA 9 SVG 9 10 Timemark 9 Trace 9 xcf 2 13 Filters Clean 11 clean 10 GIMP 1 2 5 13 GIMP tools Flip 5 Measure 11 Path 5 6 8 10 Greater 13 Greater Less 11 Horizontal 13 Horizontal Vertical 11 Image file 4 Incident angle 3 Latitude 3 Length 12 13 Less 12 Longitude 4 Mode 13 Name 3 New layer 11 13 Paper speed 4 Quote 4 Resampling step 5 Resolution 4 Return directly B zier path 4 Station data 3 Stop to the first guide 6 path 6 Threshold 11 13 orate aye Time mark first sample time 4 Trace colour 6 gar Aone 3 Trace thickness 6 Transparent 11 13 Menu Vertical 12 T 2 2 TN Teseo operations Parameters Align unlocked paths 8 Azimuth 3 Fit 4 6 Back 6 Force Polyline 8 Base Colour 12 13 Base colour 11 Constant abscissa ascendent 5 Date 4 Event first sample time 4 Export DXF path relocated in origin 5 Fill Colour 12 13 Fill colour 11 Forward 6 15 Link unlocked paths 8 Resample 5 6 Snap 8 Split 7 Timemark Add TMs from guides 8 Timemark Evaluate middle TMs 8
6. ng on the colour weighted mean button on the toolbar in figure 5 In future versions of Teseo more algorithms should be available neural network approach too and will be associate to other buttons beside this one The Arrows buttons on the main window becomes sensitive when user choose an algorithm to execute The arrow direction means the preferred direction in the execution of the previously choosen algorithm 5 Path manipulation Besides GIMP path manipulation Teseo adds some useful operations in seismogram vectorisation In figure 7 is shown the Teseo Path menu The operations are subdivided in three groups operations on the current path operations on all unlocked paths and operations on path that represent Timemark Some operations rely on GIMP vertical guides tool you can place a vertical guide clicking on the ruler on the left of the image window and dragging it onto the image at the desired place e Current path operations Resample resample path with parameter defined in figure 4 Fit fit path with a piecewise cubic B zier curve e66 X Teseo 2 0 File Path Filters Help example xcfgz Execution Steps Forward ju I r Stop to the a h E first guide Trace Properties Black trace F Thickness 10 White trace Figure 5 Teseo window General tab TARO X Teseo 2 0 File Path Filters Help example xcf gz Height 25 f Width 10 5 Figure 6 Teseo window Colour
7. ond o Fe o I 0 Figure 3 Session window Traces tab In figure 3 are shown the parameters associated to the traces e Event first sample time time of the first sample of the trace this value will be saved in SAC files e Time mark first sample time time of the first sample of the trace that represents the time mark In figure 4 are shown the parameters associated to the path manipula tion e Return directly B zier path if checked when you use automatic vec torisation methods Fit is executed after every group of iterations TARA X example100 tsf Record Traces Path Notes Resampling Resampling step pix 1 00 Constant abscissa ascendent Export Export DXF path relocated in origin Figure 4 Session window Path tab e Resampling step distance in pixel used by Resample operation e Constant abscissa ascendent if checked resampling returns abscissa ascendent else X values are evenly spaced regardless direction e Export DXF path relocated in origin if checked DXF export will trans late the path starting a the coordinate 0 0 This option should be checked only for Sismos procedures 4 Vectorisation Teseo trace vectorisation relies on GIMP Path tool see the GIMP help for basic usage Path tool permits to create piecewise cubic B zier curves and polygonals Warning Teseo does not support closed paths and paths that have two or more components Unfortunately
8. plug in developers haven t avail able procedures to handle the last ones at this time Warning Seismogram must be oriented from left to right and top to bottom If necessary you can use GIMP tools such as Flip or Rotate to modify the image User can manually vectorise the traces by GIMP Path tool she he can create several piecewise cubic B zier curves or polylines Moreover it is possible use the Teseo automatic path vectorisation tool Up to now this tool offers an algorithm based on a weighted mean of the colour trace For detailed information about this algorithm read 1 What effectively takes place is an iterative procedure whereby at each single iteration step the next point is found by submitting to an algorithm a rectangular portion of the image centred at the current point and the information regarding the closest previous points In figure 5 are shown main parameters of the Teseo automatic path vectorisation tool e Forward algorithm stop condition maximum iteration number e Back number of points to delete from the current path e Stop to the first guide alternative stop condition the iterations stop when the abscissa is greater than first vertical guide position e Trace colour base trace colour black or white e Trace thickness thickness average in pixels The colour weighted mean algorithm takes rectangle dimension in pixels from the tab shown in figure 6 This algorithm is enabled to operate clicki
9. s at the Sismos project web site http sismos ingv it teseo Follow instructions in the INSTALL file from the distribution of your choice 2 Before starting with Teseo Teseo works on greyscale images saved in xcf format the GIMP propri etary format that supports gzip or bzip2 compression To start Teseo start GIMP open your zcf seismogram image and select Teseo 2 from Teseo menu Beate 1 Alternatively you can use the context menu on the image right clicking or define a shortcut see GIMP help for howto Tana X example xcf gz 1 0 grayscale 1 layer 700x449 a File Edit Select View Image Layer Tools Dialogs Filters ScriptFu Teseo S m m jac o 0 J30 g dal E 100 v Background 3 04 MB Canc J Figure 1 Teseo menu 3 Starting with Teseo 2 Teseo associates to the working image some information related to seismo gram paper seismic event station data and vectorisation parameters All these information are saved in a Session and it has to be referred to a single seismic event First time Teseo starts on a image it requires to create a new session Fill the fields shown in the figures 2 3 4 and press on the OK button Session properties can be modified at any time selecting File Session Properties Ctrl P in Teseo context New sessions related to other events in the same image can be created selecting File Session New Ctrl N Teseo use a fixed session naming convention so the user c
10. sn t it 8 Before leaving Teseo Before to close GIMP is a very good practice to do 2 1 Save session Ctrl S in Teseo context 2 Close Teseo 3 Save xcf image it contains all your paths and layers xcfis your friend and gzip or bzip2 too 4 Close GIMP 9 Credits In Teseo sources have been integrated other works that are distributed respecting their copyright or license e NEWUOA NEWUOA is a software developed by M J D Powell for unconstrained optimization without derivatives Author M J D Powell mjdp cam ac uk e cfortran h cfortran h is an easy to use powerful bridge between C and FORTRAN It provides a transparent machine independent in terface between C and FORTRAN routines and global data Author Burkhard Burow burowQ desy de http www zeus desy de burow c fortran 13 References 1 Stefano Pintore Matteo Quintiliani and Diego Franceschi Teseo a vectorizer of historical seismograms Computers amp Geosciences 31 10 1277 1285 December 2005 2 SVG Working Group Scalable Vector Graphics SVG 1 1 Specifica tion January 2003 URL http www w3 org TR 2003 REC SVG11 20030114 3 Autodesk AutoCAD Release 12 DXF Format Adobe Systems Incor porated 1585 Charleston Road P O Box 7900 Mountain View CA 94039 7900 1992 Drawing Interchange and File Formats Release 12 4 P Goldstein D Dodge and M Firpo SAC2000 Signal processing and analysis tools for se
11. weighted mean tab Split split path at points defined by intersection beetwen path and GIMP vertical guides Force Polyline transform a path in a polyline All the control points will be ignored Snap for each point compute a colour weighted mean in a thick ness width square figure 5 e Unlocked only paths operations Align unlocked paths align paths overlapping the first point of the next path to the last of the previous one If the event was recorded over the paper boundary this operation is used before trace export Link unlocked paths link paths with a straight line from last point of the previous path to first point of the next one Useful to join several path of the same event e Timemark Timemark Evaluate middle TMs evaluate missing middle timemark of the current path and return vertical guides where they should be Timemark Add TMs from guides add points where the guides intersect the current path A000 X Teseo 2 0 MEg Filters Help Resample Fit o Split l Force Polyline Snap Stop to the first guide Align unlocked paths E Link unlocked paths Figure 7 Teseo window Path menu Warning order in operations on multiple paths respects order of the GIMP Path tool that is from bottom to top For example executing a link on paths shown in figure 8 results a new path concatenating paths a b and c respectively TARO X Paths gt U
12. your image modifies you could apply the filters on copies of the Background Layer Rember that all operations usually work on the current layer and not necessarily this is the visible one At the moment Teseo provides a graphical filter useful to clean a seismogram What do we intend to clean a seismogram Often before to vectorise a record it could be advantageous to remove horizontal traces that cross it but leaving the crossings where they are The main idea is to fill contiguous horizontal or vertical lines with the background colour of 10 A000 X Teseo 2 0 Path Filters Help Session ASCII SAC Timemark Height Width SVG Examples Figure 10 Teseo Path Export the seismogram Warning good results are obtained when the noisy lines are horizontal You can estimate required rotation using GIMP Measure tool and then using GIMP Rotate trasformation tool to rotate effectively See GIMP help In figure 11 is possible to see the parameters related to the Clean filter Base colour is the base colour of the trace Value from 0 black to 255 white Threshold is the maximum value of tolerance on base colour Fill colour is the colour used to fill contiguous lines belonging to the colour condition New layer if checked the current layer will be copied and the filters will be run on the copy Transparent if checked only the filled lines will be displayed rest of the image will
Download Pdf Manuals
Related Search