LEDAS  
Leicester Database and Archive Service
 
Mission
    Description
Products
    Databases
Raw Data
    Archive
Analysis Software
    Archive
Ginga Information
Ginga Gallery
Related Sites
Databases
GINGALAC
GINGABGD
GINGAFRF
GINGALOG
GINGAMODE
GINGARAW
View Ginga DBs
Line
Footer
e-mail

The program hyper

The program hyper rebins a selected range of elements of any Ginga data cube, time series or spectral file along any one of its dimensions. It can therefore be used to:

  1. Rebin a time series or spectral file.

    qcl>hyper
    
    ** HYPER Version 1.2 Fri Aug  8 21:16:51 1997 **
     
    HYP_DATIN data file name =mkn335_91a.sub_corr
    HYP_DATOUT new data file name = mkn335_91a.sub_corr_sq =
     
          Shape :    393 x    48 x     2   =    37728
                  TIME    PHA     IDENT   
     
          IDENT masks
           1  0101010101010101
           2  1010101010101010
     
    HYP_OPTION TIME, PHA, or IDENT dim. =time
     
          TSTART       0.00      TSTOP   50304.00
          TDELTA   128.0000
     
    HYP_TMIN new start time = 0.0 =
    HYP_TMAX new stop time = 50304.0 =
    HYP_TBIN new time bin size = 128.000 =1024
     
          Time bin range      1     400
          Time range       0.00    51200.00
          No.of output bins     50
          Effective TBIN    1024.00
     
          Squished file 
     
          Shape :     50 x    48 x     2   =     4800
                  TIME    PHA     IDENT   
     
    qcl>

    The start and stop times as well as the new time bin size are given in seconds. The start time is specified with respect to the start time used in the program sortac (see section 2.4) and the default stop time is the total duration of the input data cube.

  2. Sum detector identification. The program sortac can compress the detector idents during the sorting of the data (see section 2.4); therefore it is comparatively rare to need to perform this task.

    Consider the case of a MPC2 dataset. It has the following raw detector channels:

    qcl>hds_node=gx339_88a.cube
    qcl>list id_mask
     id_mask(2)           _CHAR*16       
        1111111100000000
        0000000011111111
    qcl>

    Both idents contain a mixture of data from the top- and mid-layers, so there is normally no purpose in keeping them separate. Indeed, the universal background subtraction method described earlier will not work if they are (see section 3.4). The following use of hyper will compress the cube to a single detector channel.

    qcl>hyper
    
    ** HYPER Version 1.2 Fri Aug  8 21:33:08 1997 **
     
    HYP_DATIN data file name =gx339_88a.cube 
    HYP_DATOUT new data file name = gx339_88a.cube_sq =
     
          Shape :  82201 x    48 x     2   =  7891296
                  TIME    PHA     IDENT   
     
          IDENT masks
           1  1111111100000000
           2  0000000011111111
     
    HYP_OPTION TIME, PHA, or IDENT dim. =ident
     
    HYP_NCHOUT no.of output ident chans = 1 =1
    HYP_COMB001 chan combination = 1-2 =1-2
     
          New ID channel  1 : ID chans 1-2                 
     
          Squished file 
     
          Shape :  82201 x    48 x     1   =  3945648
                  TIME    PHA     IDENT   
     
    qcl>

    Detector combinations can be expressed as 1,2 or 1-2 in response to the parameter HYP_COMB001. In addition, the responses EVEN*8 and ODD*8 can be specified; these translate to 2,4,6,8,10,12,14,16 (or the top-layer) and 1,3,5,7,9,11,13,15 (or the mid-layer) respectively.

  3. Create a spectral file of an entire cube, or a selected time period.

    qcl>hyper
    
    ** HYPER Version 1.2 Fri Aug  8 21:48:02 1997 **
     
    HYP_DATIN data file name =mkn335_91a.sub_corr
    HYP_DATOUT new data file name = mkn335_91a.sub_corr_sq =
     
          Shape :    393 x    48 x     2   =    37728
                  TIME    PHA     IDENT   
     
          IDENT masks
           1  0101010101010101
           2  1010101010101010
     
    HYP_OPTION TIME, PHA, or IDENT dim. =time
     
          TSTART       0.00      TSTOP   50304.00
          TDELTA   128.0000
     
    HYP_TMIN new start time = 0.0 =
    HYP_TMAX new stop time = 50304.0 =
    HYP_TBIN new time bin size = 128.000 =50304.0
     
          Time bin range      1     393
          Time range       0.00    50304.00
          No.of output bins      1
          Effective TBIN   50304.00
     
          Squished file 
     
          Shape :      1 x    48 x     2   =       96
                  TIME    PHA     IDENT   
     
    qcl>

    The start and stop times as well as the new time bin size are given in seconds. The start time is specified with respect to the start time used in the program sortac (see section 2.4) and the default stop time is the total duration of the input data cube.

  4. Create a time series covering a specified range(s) of spectral channels.

    qcl>hyper
    
    ** HYPER Version 1.2 Fri Aug  8 21:50:56 1997 **
     
    HYP_DATIN data file name =mkn335_91a.sub_corr
    HYP_DATOUT new data file name = mkn335_91a.sub_corr_sq =
     
          Shape :    393 x    48 x     2   =    37728
                  TIME    PHA     IDENT   
     
          IDENT masks
           1  0101010101010101
           2  1010101010101010
     
    HYP_OPTION TIME, PHA, or IDENT dim. =pha
     
          File has 48 PH data channels
          spanning intrinsic PHA  channels  0 to 63
     
    HYP_NPHOUT no. of output PH chans = 1 =
    HYP_PHR001 PH data chan range = 1-48 =
     
          New PH channel  1 : PH data chans  1 - 48
     
          Squished file 
     
          Shape :    393 x     1 x     2   =      786
                  TIME    PHA     IDENT   
     
    qcl>

    Spectral channels can be specified as 1,2,3,4 or 1-4 in response to the parameter HYP_PHR001, but only contiguous ranges are permitted.


[] [Back to Data Manipulation]
 
HOME
SEARCH
SERVICES INFO SOFTWARE ViZieR BLASTA DSS
ARCHIVES ASCA CHANDRA GINGA ROSAT ARNIE