Difference between revisions of "Geopsy: H/V and Spectrum Toolboxes: Output Tab"

From GeopsyWiki
Jump to navigation Jump to search
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
== Use ==
 
[[Image:HV_SPEC_toolb_output.png|thumb|right|300px|''Output'' tab where the user can fix the parameters to display and save the results]]
 
[[Image:HV_SPEC_toolb_output.png|thumb|right|300px|''Output'' tab where the user can fix the parameters to display and save the results]]
  
Line 11: Line 12:
 
* ''Output'' section: where the user can fix where to save data.
 
* ''Output'' section: where the user can fix where to save data.
  
 +
<br style="clear: both"/>
 +
== Frequency sampling section ==
 +
 +
[[Image:HV_SPEC_toolb_output_frequency.png|thumb|left|300px|''Frequency sampling'' section used to define the parameters for frequency computing and displaying ]]
 +
 +
<br style="clear: both"/>
 +
Used to define the frequency processing and displaying parameters:
 +
 +
* The frequency lower (From) and upper (to) bounds of the frequency range of interest.
  
−
== Frequency sampling section ==
+
The maximum upper bound frequency is determined by the [[Wikipedia:Nyquist_frequency|Nyquist frequency]], which corresponds to the half of the frequency data recording sampling (sps), above which no data are available.
 +
If the T10 limit has been checked in the [[Geopsy: Preferences#Tool plugins preferences|''Preferences'']], the reliable frequency range for the computation. Frequencies lower than the minimum reliable frequency are hatched in red. The minimum reliable frequency Fmin is estimated from the window length : Fmin= 10/(window length)
  
−
[[Image:HV_SPEC_toolb_output_frequency.png|thumb|right|300px|''Frequency sampling'' section where the user can fix the parameters on frequency limits and more]]
+
* Step: define how the sampling of the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]] will be distributed. Two possibilities are available:
 +
Lin: the samples are linearly distributed.
  
−
In this section describes how to fix the upper and lower limits (in the frequency domain) for computing. This part is strongly linked to the properties of the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]].
+
Log: the samples are logarithmically distributed.
 +
* Number of samples: number of samples used to process the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]].
  
−
* The '''lower limit''' should be fixed in two different ways :
 
−
** The first possibility is to fix the lower frequency limit equal to the natural frequency of the sensor.
 
−
** From SESAME guidelines <ref>Guidelines for the implementation of the H/V spectral ratio technique on ambient vibrations measurements, processing and interpretation, [http://SESAME-FP5.obs.ujf-grenoble.fr], 62 pages, April 2005</ref>, the other possibility is to define the lower frequency limit from the window length, taking into account the following formula <math>\frac{10}{w_l}>f_{seismometer}</math>. Where <math>{w_l}</math> is the window length and <math>f_{seismometer}</math> the natural frequency of the sensor.<br/>Example 1, if the windows have been fixed to exactly 25 seconds, the lower frequency limit is 0.4 Hz.<br/>Example 2, if the natural frequency of the sensor is 0.2 Hz, the lower frequency limit is 0.2 Hz (giving a maximum window length of 50 seconds).<br/>Example 3, if the natural frequency of the sensor is 0.2 Hz and the [[Geopsy:_Window_Length|window length]] has been fixed to 25 seconds, the higher frequency should be used. In this case: 0.4 seconds<br/><br/> Of course, it is always possible to pass over this limitation by computing and viewing at lower frequency, but in this case, the user shoud keep in mind that the data below the "theorical" limit are useless. Moreover, in the graphics of [[H/V_spectral_ratio|H/V]] or [[Spectral_amplitudes|Spectrum]] a red dashed area will appear in the frequencies below the <math>\frac{10}{w_l}</math> frequency as a reminder.
 
  
−
* The maximum '''upper limit''' is fixed by the [[Wikipedia:Nyquist_frequency|Nyquist frequency]], which corresponds to the half of the digitization frequency sampling. If the signal has a 100 Hz sampling frequency, the [[Wikipedia:Nyquist_frequency|Nyquist frequency]] will be 50 Hz.<br/>Above [[Wikipedia:Nyquist_frequency|Nyquist frequency]], due to the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]] in itself, no data are available. So there is no need to go above the [[Wikipedia:Nyquist_frequency|Nyquist frequency]].<br/>Below [[Wikipedia:Nyquist_frequency|Nyquist frequency]], there is no lower limit to the '''upper limit''', except the '''lower limit''' frequency.<br/>In general, the '''upper limit''' is fixed in-between a 10-50 Hz frequency range.
 
−
*Two options have to be fixed
 
−
** Step: option to define how the sampling of the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]] (along the given limits, '''lower limit''' and '''upper limit''') will be distributed. A drop box proposes two possibilities for the sampling:
 
−
*** ''Lin'', for linear sampling. In this case, the samples are linearely distributed in the frequency domain.
 
−
*** ''Log'', for logarithmic sampling. In this case, the samples are logarithmically distributed in the frequency domain.
 
−
** Number of Samples. This spin box allows the user to define the number of samples needed to process the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]].
 
  
 
== Appearance section ==
 
== Appearance section ==
Line 33: Line 37:
  
  
−
[[Image:HV_SPEC_toolb_output_appearance.png|300px]]
+
[[Image:HV_SPEC_toolb_output_appearance.png||thumb|left|300px|''Appearance'' section.]]
−
 
 
  
 
First check the ''Results make-up'' and/or the ''Summary make-up'' box. Then open the browser by clicking on the neighborhing cursor [[Image:SPEC_cursor.png]] and choose the appropriate [[SciFigs: Make-up|make-up]] to apply to the output graphics so as to change its appearance.
 
First check the ''Results make-up'' and/or the ''Summary make-up'' box. Then open the browser by clicking on the neighborhing cursor [[Image:SPEC_cursor.png]] and choose the appropriate [[SciFigs: Make-up|make-up]] to apply to the output graphics so as to change its appearance.
  
 
When processing several files at the same time, single graphics output are displayed on the same page. The number of individual graphics to be displayed per line may be determined with the ''Plots per line'' spin box, and the page heigth adjusted with the ''Page heigth'' spin box.
 
When processing several files at the same time, single graphics output are displayed on the same page. The number of individual graphics to be displayed per line may be determined with the ''Plots per line'' spin box, and the page heigth adjusted with the ''Page heigth'' spin box.
 +
<br style="clear: both"/>
 +
  
 
== Output section ==
 
== Output section ==
  
−
[[Image:HV_SPEC_toolb_output_output.png||thumb|right|300px|Unactivated ''Output'' section. Data is not saved.]][[Image:HV_SPEC_toolb_output_output_activated.png||thumb|right|300px|Activated ''Output'' section displaying where (on the hard drive) data is saved.]]
+
[[Image:HV_SPEC_toolb_output_output.png||thumb|right|300px|Unactivated ''Output'' section. Data is not saved.]][[Image:HV_SPEC_toolb_output_output_activated.png||thumb|right|300px|Activated ''Output'' section displaying in wich directory data will be saved.]]
−
[[Image:HV_SPEC_toolb_output_output_browser.png||thumb|right|300px|Browser to choose the folder to save the results. It is possible to create a folder.]]
+
[[Image:HV_SPEC_toolb_output_output_browser.png||thumb|right|300px|Browser to choose the folder to save the results. It is possible to create a new folder.]]
  
 +
Results and processing parameters can be saved automatically while processing or after viewing the results. First check the ''Output'' box. Then open the file browser by clicking on the ''browse'' button [[Image:SPEC_cursor.png]] and select the folder where to save the output files.
  
 +
<u>Note</u>: the output box must be checked and the destination folder selected '''before''' processing data, otherwise output files are not created.
  
−
The place where processing results will be saved on hard drive should be chosen before processing data. First check the ''Output'' box. Then open the browser by clicking on the neighborhing cursor [[Image:SPEC_cursor.png]] to indicate the folder where to save the result files.
 
  
−
The [[H/V_spectral_ratio|H/V]] and [[Spectral_amplitudes|Spectrum]] output files are different:
+
The H/V and Spectrum output files are different:
  
−
* [[H/V_spectral_ratio|H/V processing]]<br/>For each three component group (Z, N, E) results are saved in two files: [[Geopsy: H/V_parameter_file|name.log]] and [[Geopsy: H/V_output_file|name.hv]], where "name" stands for the station name.
+
* H/V processing<br/>For each H/V curve two output files are created: a parameter file, ''name.log'', and a result file, ''name.hv'', where "''name''" stands for the station name.
−
** the ''.log'' file contains the H/V parameters and the windowing ([[Geopsy: H/V_parameter_file|Example]]).
+
** the ''.log'' file contains the H/V processing parameters and the windowing ([[Geopsy: H/V_parameter_file|Example]]).
 
** the ''.hv'' file contains the H/V curve ([[Geopsy: H/V_output_file|Example]]).
 
** the ''.hv'' file contains the H/V curve ([[Geopsy: H/V_output_file|Example]]).
  
  
−
* [[Spectral_amplitudes|Spectrum processing]]<br/>For each component (Z, N, and E) the results are saved in two types of files: [[Geopsy: Spectrum_parameter_file|name_Z.log, name_N.log, name_E.log]] files and [[Geopsy: Spectrum_output_file|name_Z.spec, name_N.spec, name_E.spec)]], where "name" stands for the station name.
+
* Spectrum processing<br/>For each component (Z, N, and E) two output files are created: a parameter file, ''name_component.log'', and a result file, ''name_component.spec'', where "name" stands for the station name.
−
** the ''.log'' files contain the Spectrum parameters and the windowing ([[Geopsy: Spectrum_parameter_file|Example]]).
+
** the ''.log'' files contain the Spectrum processing parameters and the windowing ([[Geopsy: Spectrum_parameter_file|Example]]).
 
** the ''.spec'' files contains the Fourier spectra curves ([[Geopsy: Spectrum_output_file|Example]]).
 
** the ''.spec'' files contains the Fourier spectra curves ([[Geopsy: Spectrum_output_file|Example]]).
 
<br style="clear: both"/>
 
<br style="clear: both"/>
Line 68: Line 74:
  
 
<br style="clear: both"/>
 
<br style="clear: both"/>
−
 
−
Note: the output box must be checked and the destination folder selected ''before'' processing data, otherwise output files are not created.
 
−
 
−
== Load parameters and Start section ==
 
−
The section at the bottom of the ''Time'' tab comprises two buttons.
 
−
 
−
[[Image: HV_SPEC_toolb_load_start.png|thumb|left|300px|Load parameters and Start section]]
 
−
<br style="clear: both"/>
 
−
 
−
* The ''Load parameters'' button is used to [[Geopsy: Load Toolbox Parameters|load parameters]] from previous H/V or spectrum processing stored in a ''name.log'' file ([[Geopsy: H/V parameter file|example]]).
 
−
 
−
* Press the ''Start'' button to start H/V or Spectrum processing.
 
−
 
−
If no window selection has been performed, a pup-up window appears.
 
−
 
−
[[Image:HV_toolbox_no_window_selected.png|thumb|left|300px|Pop-up window indicating that no window selection has been performed]]
 
−
<br style="clear: both"/>
 
−
 
−
Simply click on the ''Yes'' button and processing will follow its way with the current [[Geopsy: H/V and Spectrum Toolboxes| Toolbox]] parameters.
 
−
 
−
To perform user's windowing, click on the ''No'' button.
 
−
 
−
 
−
== References ==
 
−
<references/>
 

Latest revision as of 12:32, 10 January 2013

Use

Output tab where the user can fix the parameters to display and save the results

Through this tab, the user is able to fix the parameters to display and save the results.

This tab is divided in three sections:

  • Frequency sampling section: where the user can fix the parameters on frequency limits and more.
  • Appearance section: where the user can fix automatic output graphics appearance parameters.
  • Output section: where the user can fix where to save data.


Frequency sampling section

Frequency sampling section used to define the parameters for frequency computing and displaying


Used to define the frequency processing and displaying parameters:

  • The frequency lower (From) and upper (to) bounds of the frequency range of interest.

The maximum upper bound frequency is determined by the Nyquist frequency, which corresponds to the half of the frequency data recording sampling (sps), above which no data are available. If the T10 limit has been checked in the Preferences, the reliable frequency range for the computation. Frequencies lower than the minimum reliable frequency are hatched in red. The minimum reliable frequency Fmin is estimated from the window length : Fmin= 10/(window length)

  • Step: define how the sampling of the Fourier transform will be distributed. Two possibilities are available:

Lin: the samples are linearly distributed.

Log: the samples are logarithmically distributed.


Appearance section

It is possible to customize the output graphics appearance, which may then be automatically applied on both single and summary output graphics.


Appearance section.

First check the Results make-up and/or the Summary make-up box. Then open the browser by clicking on the neighborhing cursor SPEC cursor.png and choose the appropriate make-up to apply to the output graphics so as to change its appearance.

When processing several files at the same time, single graphics output are displayed on the same page. The number of individual graphics to be displayed per line may be determined with the Plots per line spin box, and the page heigth adjusted with the Page heigth spin box.


Output section

Unactivated Output section. Data is not saved.
Activated Output section displaying in wich directory data will be saved.
Browser to choose the folder to save the results. It is possible to create a new folder.

Results and processing parameters can be saved automatically while processing or after viewing the results. First check the Output box. Then open the file browser by clicking on the browse button SPEC cursor.png and select the folder where to save the output files.

Note: the output box must be checked and the destination folder selected before processing data, otherwise output files are not created.


The H/V and Spectrum output files are different:

  • H/V processing
    For each H/V curve two output files are created: a parameter file, name.log, and a result file, name.hv, where "name" stands for the station name.
    • the .log file contains the H/V processing parameters and the windowing (Example).
    • the .hv file contains the H/V curve (Example).


  • Spectrum processing
    For each component (Z, N, and E) two output files are created: a parameter file, name_component.log, and a result file, name_component.spec, where "name" stands for the station name.
    • the .log files contain the Spectrum processing parameters and the windowing (Example).
    • the .spec files contains the Fourier spectra curves (Example).


If the output files already exist, a pop-up warning window is displayed.

H/V pop-up warning window
Spectrum pop-up warning window


Retrieved from "https://www.geopsy.org/wiki/index.php?title=Geopsy:_H/V_and_Spectrum_Toolboxes:_Output_Tab&oldid=3328"