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

From GeopsyWiki
Jump to navigation Jump to search
 
(42 intermediate revisions by 4 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]]
  
 
Through this tab, the user is able to 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
+
This tab is divided in three sections:
  
* ''Frequency sampling'' section: where the user can fix the parameters on frequency limits and more
+
* ''Frequency sampling'' section: where the user can fix the parameters on frequency limits and more.
  
* ''Appearance section'' section: where the user can fix automatic output graphics appearance parameters
+
* ''Appearance'' section: where the user can fix automatic output graphics appearance parameters.
  
* ''Output section'' 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|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:
  
[[Image:HV_SPEC_toolb_output_frequency.png|200px]]
+
* The frequency lower (From) and upper (to) bounds of the frequency range of interest.
  
In this section, it is possible to fix the upper and lower limits for computing.
+
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)
  
* The '''lower limit''' should be fixed in two different ways :
+
* Step: define how the sampling of the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]] will be distributed. Two possibilities are available:
** The first possibility is to fix the lower frequency limit equal to the natural frequency of your sensor.
+
Lin: the samples are linearly distributed.
** From SESAME output <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 your 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 used sensor is 0.2 Hz, the lower frequency limit is 0.2 Hz (giving a maximum window length of 50 s.)<br/>Example 3, if the natural frequency of the used sensor is 0.2 Hz and the [[Geopsy:_Window_Length|window length]] has been fixed to 25 s., the higher frequency should be used. In this case: 0.4 sec.
 
  
 +
Log: the samples are logarithmically distributed.
 +
* Number of samples: number of samples used to process the [[Geopsy:_Fast_Fourier_Transform|Fourier transform]].
  
[[Wikipedia:Nyquist_frequency|(Nyquist frequency)]]
 
  
There are two options to be specified, namely Step and Number of Samples. For the Step parameter, there are two options to be selected from a drop box: Log or Linear. You might have guessed the meaning right away. When choosing Linear then the frequency axis is sampled linearly between the given limits and exactly Number of Samples will be distributed along the axis. Choosing Log accordingly samples the frequency axis logarithmically, i.e. frequency bands are close spaced at lower frequencies
 
  
 
== Appearance section ==
 
== Appearance section ==
 +
It is possible to customize the output graphics appearance, which may then be automatically applied on both single and summary output graphics.
 +
 +
 +
[[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.
 +
 +
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"/>
  
automatic output graphics appearance parameters [[Image:HV_SPEC_toolb_output_appearance.png|200px]]
 
  
 
== Output section ==
 
== Output section ==
  
where to save data [[Image:HV_SPEC_toolb_output_output.png|200px]]
+
[[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 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 H/V and Spectrum output files are different:
 +
 
 +
* 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]]).
 +
 
 +
 
 +
* 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"/>
 +
 
 +
If the output files already exist, a pop-up warning window is displayed.
 +
 
 +
[[Image: File .log already exists HV.png||thumb|left|300px|H/V pop-up warning window]]
 +
 
 +
[[Image: File .log already exists Spec.png||thumb|left|400px|Spectrum pop-up warning window]]
  
== References ==
+
<br style="clear: both"/>
<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