a project to process sac files with a graphical interface
SACGUI 1.1 User Guide By: Jiang Yiran Email: yiranj@pku.edu.cn
-
Introduction: So far, many MATLAB code have been written to process earthquake waveform data, like filtering, decimating and so on. Visual interface is important for some processes, for example phase picking. We are trying to provide users with a program which has a visual interface. Considering many of the users have used SAC before, we are imitating it in some operations. As we know, both the visual mode and command mode have its own advantages, we want to combine their advantages. It means you can do part of the works by commands lines. It will be convenient for batch processing. To achieve all operations are compatible with the visualization and command line mode is very difficult. We just make the most important operations compatible with both ones. It may be difficult to handle all the things by ourselves. It's lucky that we can get many written codes from the website to do part of the work. We sincerely thank these writers. With their works, we can focus on more important things. It is why we choose MATLAB to build our program in. If you're interested in our work, welcome to join us. You can contact to us via Email.
-
Installation First unpack SACGUI.zip and open the unpacked folder in your MATLAB. You should then add the folder and its subfolder into the MATLAB's path. The temp_sacfile folder contains some sac files as samples. Now your can simply run main.m to start.
-
Visual Mode There is a visualization interface. You can press the buttons to do some operations. We will show you how to use this buttons.
(1) browse and add: by pressing the 'browser & add 'button, you can select multiple files at once, or add new files after the selected files. The files you select will show in the sacfile list box.
(2) readsac: after selecting files, you can press the 'readsac' button to read them into memory. If this operation have been done, the program will add a 'read in' line in the 'state' box. If there is no file selected, the line will be 'no file in list'.
(3) plotsac: press the 'plotsac' button to plot the waveform data in the axes. If 'relative' checkbox is selected, the waveform data is plotted with reference to the kztime.
(4) zoom in: press 'x' on keyboard, then select(left-click) two points in axes; press 'o' to zoom out back.
(5) plot next and previous waveform: press 'n' or 'b' on keyboard.
(6) pick phase: press 'p', 's', or 'f' on the keyboard and then select(left-click) one point in axes.
(7) '+' and '-': press the '+ ' or '-' button to change the number of axes. You can also press '+' or '-' on the keyboard.
(8) clear boxes or axes: select one box or axes, then press 'c' on the keyboard to reset it.
(9) plot spectrum: press 'plot spec' to plot the spectrum
you can choose to plot the amplitude, phase, real part or image part of the spectrum.
you can also choose whether to use the loglog axes.
(10) filter: press 'filter' to do data filtering.
there are two filter. The Bessel is a low pass filter. Only the right frequency will work if you choose Bessel.
and you should input the frequencies by yourself.
we have a no delay filter way for you.
(11) save files: press 'w' on the keyboard to save the changed sac files. if 'overwrite' check is on, the saved files will directly overwrite the source files, otherwise the file in accordance with the 'original file name _ temp' in the form of preservation in the working directory.
(12) quit: press 'q' on the keyboard to quit.
- Command Line Mode to be continued