Up : MAXI Data Analysis Previous : Data Analysis

Tips, Tricks, and Traps

This page describes what's happening when MAXI ftools are running, and what users should be careful to obtain confident results.

Contents


The MAXI team
Please send questions, comments, and bug reports to : maxihelp@ml.ac.jaxa.jp

1. What's mxproduct?

mxproduct is a perl script running the MAXI ftools to generate images, light curves, spectra, and response files, calling the general FTOOLS and the following new MAXI ftools : EXAMPLE
 % mxdownload 83.633083 22.0145  2010-02-01 2010-02-05    (downloads data)

 % mxproduct --object=crab 83.633083 22.0145 2010-02-01 2010-02-05 

   > mxextract gsc @gsc.list 1  crab crab crab 83.633083 22.0145 0 8 200 200 0.1 trend/attlist.fits

   > mxscancur GSC crab_g_low_scancur.fits 83.633083 22.0145 55228 55233 1  5  trend/attlist.fits \
     /data/opt/maxi/mxsoft_20170303/refdata  trend/isalist.fits  trend/isplist.fits 0 \
     trend/stdgti/gsc_low/mx_gsc0.gti.gz  trend/stdgti/gsc_low/mx_gsc1.gti.gz trend/stdgti/gsc_low/mx_gsc2.gti.gz \
     trend/stdgti/gsc_low/mx_gsc3.gti.gz  trend/stdgti/gsc_low/mx_gsc4.gti.gz trend/stdgti/gsc_low/mx_gsc5.gti.gz \
     trend/stdgti/gsc_low/mx_gsc6.gti.gz  trend/stdgti/gsc_low/mx_gsc7.gti.gz trend/stdgti/gsc_low/mx_gsc8.gti.gz \
     trend/stdgti/gsc_low/mx_gsc9.gti.gz  trend/stdgti/gsc_low/mx_gsca.gti.gz  trend/stdgti/gsc_low/mx_gscb.gti.gz

   > mxgscandat products/crab_g_low_scancur.fits crab_g_low_scandat.fits gsc_pi_ch.list products/crab_g_low.evt \
     products/crab_g_low.evt NONE NONE -1 55228 55233 2.1 0.35 1.7 1.5 1.5 4.5 38.2 0 1 products/crab_g0_low_gti.fits \
     NONE NONE products/crab_g3_low_gti.fits NONE NONE NONE NONE NONE NONE NONE NONE

   > mxlcscan products/crab_g_low_scandat.fits crab_g_low.lc 1 36.2 1 1 20 1 1 03 0

   > mxgtiwmap products/crab_g_low_scancur.fits crab_g_low_wmap.fits products/crab_g_low_gti.fits 55228 55233

   > mxgrmfgen products/crab_g_low_wmap.fits products/crab_g_low_src.pi products/crab_g_low_bgd.pi crab_g_low.rsp 03 0 0

2. What's mxproduct doing?

Outline Flowchart of mxproduct with default settings (GSC).

3. What mxproduct has created during the process?

mxproduct creates science products (see the Data Analysis page for details).
Output files for GSC with --object=crab                  

products/- crab_g_low.evt
         - crab_g_low.img
         - crab_g_low_wmap_src.img
         - crab_g_low_wmap_bgd.img
         - crab_g_low_src.pi
         - crab_g_low_bgd.pi
         - crab_g_low.rsp
         - crab_g_low.lc
         - crab_g_low_scancur.fits
         - crab_g_low_commands.log
Output files for SSC with --object=crab --skip-ssc=0(default:1, skip)

products/- crab_s_med.evt
         - crab_s_med.img
         - crab_s_med_wmap_bgd.img
         - crab_s_med_wmap_src.img
         - crab_s_med_src.pi
         - crab_s_med_bgd.pi
         - crab_s_med.rsp
         - crab_s_med.lc
         - crab_s_med_scancur.fits
         - crab_s_med_commands.log
mxproduct also creates the following intermediate files for the use of the processings and calculations, which are deleted at the end of the process. Users can leave them by running mxproduct with an option, --no-cleanup=1.

Intermediate files for GSC with --no-cleanup=1(default:0) 

products/- crab_g_low_scandat.fits
         - crab_g_low_wmap.fits
         - crab_g[0-b]_low_[1550:1650]v_[src:bgd].pi
         - crab_g[0-b]_low_[1550:1650]v_[src:bgd].evt
         - crab_g[0-b]_low.evt

         - crab_g_low_gti.fits
         - crab_user_gti.fits 
         - crab_g[0-b]_low_[1550:1650]v_hvgti.fits
         - crab_g[0-b]_low_fovgti.fits
         - crab_g[0-b]_low_fovgti_[src:bgd].fits
         - crab_g[0-b]_low_[1550:1650]v_gti.fits
         - crab_g[0-b]_low_[1550:1650]v_gti_[src:bgd].fits
         - crab_g[0-b]_low_gti.fits
         - crab_g[0-b]_low_gti_[src:bgd].fits
         - gsc.list
         - gsccamera.list
         - gsc_pi_ch.list
Intermediate files for SSC with -no-cleanup=1(default:0) 

products/- crab_s_med_scandat.fits
         - crab_s_med_wmap.fits
         - crab_s[h:z]_med_[src:bgd].pi
         - crab_s[h:z]_med_[src:bgd].evt
         - crab_s[h:z]_med.evt
         - crab_s[h:z]_med.rsp (SSC only)
         - crab_s[h:z]_med.img (SSC only)

         - crab_s_med_gti.fits
         - crab_user_gti.fits
         - crab_s[h:z]_med_fovgti_[src:bgd].fits
         - crab_s[h:z]_med_gti.fits
         - crab_s[h:z]_med_gti_[src:bgd].fits
         - ssc.list
         - ssch.list
         - sscz.list
         - ssc_pi_ch.list

4. What's written in command.log?

Commands which mxproduct is actually running, and comments on what mxproduct is doing. Users can refer the commands, and re-create science files as you like. For particular analysis, which users sometimes want to do, we will summarize how-tos in the Thread page.

5. Caveats