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

From GeopsyWiki
Jump to navigation Jump to search
 
(16 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 ==
 
== Frequency sampling section ==
  
−
[[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]]
+
[[Image:HV_SPEC_toolb_output_frequency.png|thumb|left|300px|''Frequency sampling'' section used to define the parameters for frequency computing and displaying ]]
  
−
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]].
+
<br style="clear: both"/>
 +
Used to define the frequency processing and displaying parameters:
  
−
* The '''lower limit''' should be fixed in two different ways :
+
* The frequency lower (From) and upper (to) bounds of the frequency range of interest.
−
** 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.
+
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.  
−
*Two options have to be fixed
+
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)
−
** 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 ==
+
* Step: define how the sampling of the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]] will be distributed. Two possibilities are available:
−
It is possible to customize the output graphics appearance, which may then be automatically applied.
+
Lin: the samples are linearly distributed.
  
−
[[Image:HV_SPEC_toolb_output_appearance.png|300px]]
+
Log: the samples are logarithmically distributed.
 +
* Number of samples: number of samples used to process the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]].
  
−
== Output section ==
 
  
−
[[Image:HV_SPEC_toolb_output_output.png||thumb|right|300px|Unactivated ''Output'' section. The user is unable to save the data.]][[Image:HV_SPEC_toolb_output_output_activated.png||thumb|right|300px|Activated ''Output'' section displaying where (on the hard drive) the user is saving the data.]]
 
−
[[Image:HV_SPEC_toolb_output_output_browser.png||thumb|right|300px|Browser allowing the user to choose the folder to save the results. In this browser, the user can also create folder.]]
 
  
 +
== Appearance section ==
 +
It is possible to customize the output graphics appearance, which may then be automatically applied on both single and summary output graphics.
  
  
−
The user can define where the processing results will be saved in his hard drive. To do this, first check the ''Output'' box and then click on the neighborhing cursor [[Image:SPEC_cursor.png]] to open a browser to find the folder where to save the result files. This option must be chosen before processing data.
+
[[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.
  
−
The [[H/V_spectral_ratio|H/V]] and [[Spectral_amplitudes|Spectrum]] output files are different:
+
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"/>
  
−
* [[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.
 
−
** the ''.log'' file contains the H/V parameters and the windowing ([[Geopsy: H/V_parameter_file|Example]]).
 
−
** the ''.hv'' file contains the H/V curve ([[Geopsy: H/V_output_file|Example]]).
 
  
 +
== Output section ==
  
−
* [[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.
+
[[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.]]
−
** the ''.log'' files contain the Spectrum parameters and the windowing ([[Geopsy: Spectrum_parameter_file|Example]]).
+
[[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.]]
−
** the ''.spec'' files contains the Fourier spectra curves ([[Geopsy: Spectrum_output_file|Example]]).
 
−
<br style="clear: both"/>
 
  
−
If the output files already exist, a pop-up warning window is displayed.
+
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.
  
−
[[Image: File .log already exists HV.png||thumb|left|300px|H/V pop-up warning window]]
+
<u>Note</u>: the output box must be checked and the destination folder selected '''before''' processing data, otherwise output files are not created.
  
−
[[Image: File .log already exists Spec.png||thumb|left|400px|Spectrum pop-up warning window]]
 
  
−
<br style="clear: both"/>
+
The H/V and Spectrum output files are different:
  
−
Note: the output box must be checked and the destination folder selected ''before'' processing data, otherwise output files are not created.
+
* 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 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]]).
  
−
== 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]]
+
* 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 processing parameters and the windowing ([[Geopsy: Spectrum_parameter_file|Example]]).
 +
** the ''.spec'' files contains the Fourier spectra curves ([[Geopsy: Spectrum_output_file|Example]]).
 
<br style="clear: both"/>
 
<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]]).
+
If the output files already exist, a pop-up warning window is displayed.
  
−
* Press the ''Start'' button to start H/V or Spectrum processing.
+
[[Image: File .log already exists HV.png||thumb|left|300px|H/V pop-up warning window]]
  
−
If no window selection has been performed, a pup-up window appears.
+
[[Image: File .log already exists Spec.png||thumb|left|400px|Spectrum pop-up warning window]]
  
−
[[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"/>
 
<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"