Differences

This shows you the differences between two versions of the page.

--- ged_docs [2023/10/10 12:03] – created admin
+++ ged_docs [2023/10/11 13:49] (current) – admin
@@ Line 1: / Line 1: @@
-=== GED ===
+===== GED =====
 GED (Get Erne Data) is a set of IDL programs and auxiliary files for reading and manipulating ERNE //level-2// and //level-3// science data. In addition, **ged** is also the name of the main function of the system.
@@ Line 12: / Line 11: @@
   * [[ged_examples|Examples]]
+==== Quick Refence ====
+The **Data stucture** entries link to pages with information on the names and types of the fields of the corresponding structures. From the **GED reader** pages the user can check e.g., the set of available keywords. These keywords are acknowledged when making a ged request for the corresponding type of ERNE data.
+===Level-2 ===
+<hidden onHidden="[+]" onVisible="[-]">
+All the level-2 data is read by the same reader function: [[ged_l2_a]]. The data types and the associated data structures are listed in the table below.
+^**Level-2**||||||||
+^**Data type**^**f10**^**f30**^**f40**^**f50**^**Data structure**^**Description**^**Note**|
+|counters           |  x  |     |     |     |[[TscCounters_a]]         | ESU science counters              | |
+|         "         |     |  x  |     |     |[[TscCounters_b]]         | ESU science counters              | |
+|         "         |     |     |  x  |     |[[TscCounters_c]]         | ESU science counters              | |
+|         "         |     |     |     |  x  |[[TscCounters_d]]         | ESU science counters              | |
+|10s_spectra        |  x  |     |     |     |[[Tsc10sCntrs_a]]         | LED+HED 10 second spectra         | |
+|pn_spectra         |  x  |     |     |     |[[TscEcntrs_a]]           | LED+HED on-board spectra          | |
+|led_spectra        |     |  x  |  x  |  x  |[[TledEcntrs_b]]          | LED on-board spectra              | |
+|hed_spectra        |     |  x  |  x  |  x  |[[ThedEcntrs_b]]          | HED on-board spectra              | |
+|led_pha            |  x  |  x  |  x  |  x  |[[TscHeader_a]]           | LED pulse height data (file input)|  a  |
+|         "         |  x  |  x  |  x  |  x  |[[TledPHAevent_a]]        | LED pulse height data (file input)|  a  |
+|         "         |  x  |  x  |  x  |  x  |[[TledPHArecord_a]]       | LED pulse height data (output)    |  b  |
+|hed_pha            |  x  |  x  |  x  |  x  |[[TscHeader_a]]           | HED pulse height data (file input)|  a  |
+|         "         |  x  |  x  |  x  |  x  |[[ThedPHAevent_a]]        | HED pulse height data (file input)|  a  |
+|         "         |  x  |  x  |  x  |  x  |[[ThedPHArecord_a]]       | HED pulse height data (output)    |  b  |
+|hed_electrons      |  x  |     |     |     |[[ThedElectronCntrs_a]]   | HED "electrons"                   | |
+|hed_relat          |     |  x  |  x  |  x  |[[ThedElectronCntrs_b]]   | HED "electrons"                   | |
+|hed_anisotropy_AN  |  x  |     |     |     |[[ThedDirCntrs_a]]        | HED dx-dy-profiles: 0-5           |  c  |
+|hed_anisotropy_BN  |  x  |     |     |     |[[ThedDirCntrs_b]]        | HED phi-theta tables: 0-5         |  c  |
+|hed_dirdistrN      |     |  x  |  x  |  x  |[[ThedDirCntrs_c]]        | HED phi-theta tables: 0-5         |  c  |
+<typo fs:smaller; ff:courier>
+(nbsp)(nbsp)(nbsp)(nbsp)(bcircle)(nbsp)a: INPUT, from a lev-2 file. For each measurement period ('minute'): Science Header\\
+(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)followed by two bytes (fillMode and nEvents) and then nEvents number of PHA event\\
+(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)structures for the period.\\
+(nbsp)(nbsp)(nbsp)(nbsp)(bcircle)(nbsp)b: OUTPUT, function result: array of records of the indicated type.\\
+(nbsp)(nbsp)(nbsp)(nbsp)(bcircle)(nbsp)c: N = anisotropy (direction distribution) channel number (0..5).
+</typo>
+</hidden>
+=== Level-3 ===
+<hidden onHidden="[+]" onVisible="[-]">
+For level-3 there are different ged-functions depending on the data type and telemetry format. The indicated data structure is the one used in the corresponding disk file record. The actual reader output might differ depending on the selected filtering.
+^**Level-3**||||||||
+^**Data type** ^**f10**^**f40**^**f50**^**Data structure**^**GED reader**^**Description**^**Note**|
+|corr          |  x    |  x    |  x    |[[Tcorr_a]]          |[[ged_l3_corr]]         |Counters used in data normalization| |
+|pHe_spectra   |  x    |       |       |[[TobSpectra_a]]     |[[ged_l3_spectra]]      |proton and He onboard spectra      | |
+|spectra       |       |  x    |  x    |[[TobSpectra_b]]     |             "          |p, He3 and He4 onboard spectra     | |
+|led_pha       |  x    |  x    |  x    |[[TledPartData_a]]   |[[ged_l3_pha]]          |LED pulse height data              | |
+|hed_pha       |  x    |  x    |  x    |[[ThedPartData_a]]   |             "          |HED pulse height data              | |
+|hed_pha_calib |  x    |  x    |  x    |[[ThedPartData_c]]   |             "          |HED pulse height calibration data  |  a  |
+|led_dirspectra|       |  x    |  x    |[[TledDirSpectra_a]] |[[ged_l3_leddirspectra]]|LED direction spectra              |  b  |
+<typo fs:smaller; ff:courier>
+(nbsp)(nbsp)(nbsp)(nbsp)(bcircle)(nbsp)a: Calibration data is available for selected periods only.\\
+(nbsp)(nbsp)(nbsp)(nbsp)(bcircle)(nbsp)b: Disk file structure indicated. The nominal reader output will have the lower\\
+(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)(nbsp)energy channels, which are covered only by the LED-I (thin D1 detectors), discarded.
+</typo>
+</hidden>