DigitSeis: Documentation |
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.