DigitSeis: Documentation


Back to DigitSeis Page

Installing DigitSeis
Loading and Preparing Images
Classifying Objects
Digitizing and Correcting Traces
Setting Time
Extracting Files


Unless otherwise noted, all videos feature the example seismogram included with DigitSeis packages and available for individual download on the DigitSeis Page. Additionally, with the exception of the tutorial on installation for Windows, all videos feature DigitSeis as it appears with a Mac operating system.



Installing DigitSeis

Mac OS X

Tutorial on installing the DigitSeis package for Mac OS X. The standalone nature of the package requires installation of MATLAB runtimes before DigitSeis itself can be run. Note that items should not be moved from the DigitSeis folder; the Resources directory contains files DigitSeis must reference to properly function.


Windows

Tutorial on installing the DigitSeis package for Windows. In general, the installer wizard manages the entire process. Keep in mind that running DigitSeis for Windows requires a user with administrator privileges on the machine used.

Note that using the installer as displayed above requires an internet connection throughout. A significantly larger installer which does not require an internet connection while installing is included below:
DigitSeis v1.5 Installer for Windows Users without stable internet (exe file, 890 MB)




Loading and Preparing Images

Tutorial on loading an image, cropping out excess space and data, and measuring and inputting time mark dimensions. Only one time mark was shown measured in the tutorial, but it is advisable to sample a few throughout the image to get an accurate average measurement. Also note that proper cropping is essential to effiencient use of DigitSeis, and must be done before any other steps, to avoid losses in progress.




Classifying Objects

Classification is important for effective digitization. In addition to the basic tools available in the classification window, there are two features which open smaller windows: Small Region Analysis and Overlap Analysis. There are separate tutorials available for use of tools in each of these classification windows.


Basic Classification

Tutorial on basic tools available in the Classification window. When Classify Objects in the left sidebar of the main DigitSeis window is selected, the Classification window opens and the main DigitSeis window closes. This tutorial encompasses use of the simple tools available in the toolbar: Remove Pixels (both in a line and in a drawn region), Combine Objects, Classify Objects, and Show Time Marks.


Small Region Analysis

Tutorial on tools available in the Small Region Analysis window. This video assumes user proficiency with tools available in the general classifcation window. In particular, it displays the effect of modifying the binary threshold in the Small Region Analysis window. This feature is unique to Small Region Analysis.

This video features a seismogram recorded at HRV from March, 1937, available below:
Overlapped Traces Image (JPEG file, right-click to download, 57 MB)


Overlap Analysis

Tutorial on tools available in the Overlap Analysis window. This tutorial assumes user proficiency with both the general Classification window and the Small Region Analysis window. The Overlap Analysis tool is helpful for quick separation of connected objects, and also is necessary for resolution of overlapping traces.

This video features a seismogram recorded at HRV from March, 1937, available below:
Overlapped Traces Image (JPEG file, right-click to download, 57 MB)




Digitizing and Correcting Traces

DigitSeis's automatic digitization relies on accurate and thorough classification. However, gaps may arise in the automatically digitized traces. Fixable gaps can be resolved with the Correct Trace tool. Most of these gaps only require use of basic tools, which resemble those in the classification step, however, some high-amplitude traces require use of pinpointing tools to manually create a digitized trace.


Digitization and Basic Trace Correction

Tutorial on digitization and use of basic tools within Correct Trace to resolve gaps. This video assumes user proficiency with tools from the classification step, which are made available in the Correct Trace window to reclassify objects for accurate digitization. Note that not all gaps need be resolved — gaps in the original image itself are inherent to the seismogram and can be left alone.


Correcting Traces with Pinpointing Tools

Tutorial on correcting a trace using pinpointing tools to manually generate a line. This strategy only need be used when the traces are too thin, too dark, or overlap too many others to be effectively digitized by reclassification. Users should be careful to only create lines that reflect data existing in the original image — the pinpointing tools should not be used to manufacture data. Note that once an object is created with points, it cannot be separated into multiple objects.

This video features a seismogram recorded at HRV from September, 1937, available below:
Severe Amplitude Image (JPEG file, right-click to download, 54 MB)




Setting Time

Tutorial on calculating time, setting an absolute time, and updating time for the image to reflect absolute time(s) set. Note that DigitSeis calculates updated time per trace, so setting an absolute time extrapolates from that set time to apply times to the trace it is on, and also any traces without absolute time below (the topmost absolute time applies to traces above). Adding absolute time to time bars on traces with offset time is a simple and effective solution for small time errors such as missing time marks.




Extracting SAC or TXT Files

Tutorial on extracting digitized trace and time information from completed analyses as either SAC files or TXT files. Note that location data and other presets can be modified in these files after extraction, so small inaccuracies when inputting label data are simple to fix. It is recommended that complete analyses also be saved as .mat files in the case the traces need be further corrected.




Back to other research projects.

Department of Earth and Planetary Sciences / Harvard University / 20 Oxford Street / Cambridge / MA 02138 / U.S.A. / Telephone: +1 617 495 2350 / Fax: +1 617 496 1907 / Email: reilly@eps.harvard.edu