Search:

[Advanced Search]



CALET Archive: Getting started

General

The CALET science data are organized in directories named after the instrument cgbm/ for the CALET Gamma-ray Burst Monitoring (CGBM) and ccal/ for the CALET CALorimeter. 

 
                                            data/
                                 cgbm/                 ccal/
CALET Gamma-ray Burst Monitoring The cgbm/ is organized in the obs/ directory, which contains the monitoring and event data with the following directory structure: 
 
   
                           obs/                                       
                            |                                        
              2015/        2016/ .... YYYY/                                  
                            |                                    
              20160101/  20160102/ ... 20161231/                  
                            |
                auxil/ monitoring/ event/
The CALET data archive in the obs/ directory are divided in years subdirectories which each contains the CALET data divided in observation of one day in lenght. Each day of data nominally contains:
  • 7 files in the auxil/ directory: CGBM attitude (.att), (.dt), good time intervals (.gti), housekeeping (.hk), ISS attitude (.iat), orbital data (.orb), and (.tim).
  • 12 files in the monitor/ directory. There is a file for each of the three instruments, in each of two possible gain settings, and with TH and PH data for each.
  • If there was event data, 3 files (one for each of the HXM1, HXM2, and SGM instruments) for each event. Most days have no event files, but as many as five events in a single day has been observed: there is no specific limit on the number of possible events in a single calendar day.

CALET Calorimeter

The ccal/ is organized in the chd/ calsp/ directories. 
 
                     chd/                                  calsp/                                                                          
                      |                                      |  
       2015/        2016/ .... YYYY/                  file1 file2 .....
                     |                       
              file1 ... fileN
The CALET data archive in the chd/ directory are divided in years subdirectories each containing the rates files obtained with the Charge particle detector (CHD) top layer of the Calorimeter. The CALET data archive in the calsp/ directory contains the spectra of the different species measured by the CHD.

Archive access : Web, wget, download script and special maxi download script

At the HEASARC the CALET archive can be accessed using the web interfaces Browse , the wget protocol, and the download script

  • Access via Web : The archive access via the Web makes use of database tables to search for the science data. The database tables are for : the CGBM data, calbgmmstr, and for the Charge particle detector, calchdmstr . These tables record high-level information for each observation (calgbmmstr) or temporal rates (calchdmstr). They can be searched for time and other parameters and from the result page it is possible to select and retrieve the data files.

  • Wget : If you have wget installed, and the observation id is already known, the data can be retrieved via 'wget'. For example using the https protocol, if the user wants to retrieve the GBM data for the '20160212' observed on Feb 12 2016, she/he can retrive the entire sequence (see Example 1) or data for a single file for the CHD detector (see Example 2) 
    Example 1
 wget -q -nH --cut-dirs=6 -r -l0 -c -N -np -R 'index*' -erobots=off --retr-symlinks https://heasarc.gsfc.nasa.gov/FTP/calet/data/cgbm/obs/2016/20160212/ 

Example 2
  wget -q -nH --cut-dirs=7 -r -l0 -c -N -np -R 'index*' -erobots=off --retr-symlinks https://heasarc.gsfc.nasa.gov/FTP/calet/data/ccal/chd/2020/ccal_20200113_chd.lc.gz
  • download_wget : donwload_wget is a PERL script that uses the wget protocol, similarly to the example above, but simplify the command and allow for more flexility. Download the download_wget and place it in your local machine 
     
Example: To download a specific sequence type: 
     
  > download_wget.pl https://heasarc.gsfc.nasa.gov/FTP/calet/data/cgbm/2016/20160212 


To get help type :  > download_wget.pl help