[{"data":1,"prerenderedAt":35},["ShallowReactive",2],{"analysis-playbook-ginga-lac-analysis-guide":3},{"@context":4,"@type":5,"name":6,"description":7,"proficiencyLevel":8,"dependencies":9,"programmingLanguage":12,"keywords":13,"citation":16,"about":30,"articleBody":34},"https:\u002F\u002Fschema.org","TechArticle","Ginga LAC Data Analysis","","intermediate",[10,11],"Ginga tools","HEASoft","Fortran",[14,15,11],"GINGA","data analysis",[17,21,24,28],{"@type":18,"url":19,"name":20},"CreativeWork","https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002FGINGA-LAC-1.0\u002Fdoc\u002FlacManual.pdf","ABC Guide to the Ginga Data Analysis",{"@type":18,"url":22,"name":23},"https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002FGINGA-LAC-1.0\u002Fdoc\u002Freport_ksc_v1.pdf","Accuracy of Ginga Time Assignment",{"@type":25,"url":26,"name":27},"SoftwareApplication","https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002Fsoftware\u002FGINGA-LAC_tools_ver1.1\u002FINSTALL","Ginga tools (v1.1)",{"@type":25,"url":29,"name":11},"https:\u002F\u002Fheasarc.gsfc.nasa.gov\u002Fdocs\u002Fsoftware\u002Flheasoft",[31],{"@type":32,"name":33},"Dataset","darts:ginga-lac-data","## Ginga LAC Data Analysis\n\n### Overview\nCurrently, users can carry out (1) spectral analysis and (2) timing analysis of LAC data from ```pointing-mode observations```. Detailed analysis of LAC ```scan-mode``` data (such as fitting of the scan profile) is not supported at present.\n\nLAC data analysis starts with selection of good time intervals (GTIs) defined by source visibility and background level. A tool (make_sf_list.pl) is supplied to calculate the GTIs.\n\nReferring to the GTIs, spectral files (ASCII format) and timing files (FITS format) are calculated from the FRFs. In this procedure, background can be subtracted using several different methods. \n\nBecause the ASCII format of the LAC spectral files is specific, we support a tool (lac2xspec) to convert it to the standard XSPEC FITS format. The tool also produces an appropriate response matrix to the spectral file in the FITS format. Model fitting will be done with general purpose tools, e.g., XSPEC.\n\nSome of the timing analysis may be done with the timing files using general tools, e.g., [FTOOLS](https:\u002F\u002Fheasarc.gsfc.nasa.gov\u002Fdocs\u002Fsoftware\u002Fftools\u002F). However, we also supply some tools for the timing analysis, because the dead-time correction is mission dependent.\n\n\n### Install Analysis Software\nA package containing analysis software for Ginga data analysis (the \"Ginga tools\"), calibration files, and other sample files is provided by the ISAS Ginga archives team. The Ginga tools, written in Fortran 77, are transplanted to the UNIX system from the original software developed on the ISAS main frame computers. Thus, the estabished calibration made by the Japanese X-ray astronomy group is reflected in these tools.\n\n\n#### Updated on 2019\u002F11\u002F19\nNow, Ginga tool (v1.1) is complied with gfortran. It was tested on Mac OS10, Ubuntu 18 and Cent OS 7.\n\nPlease  download the  package containing source codes from https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002Fsoftware\u002FGINGA-LAC_tools_ver1.1\u002Fginga_tools_src_v1.1.tar.gz, and build the tools on your own system. The [FTOOLS](https:\u002F\u002Fheasarc.gsfc.nasa.gov\u002Fdocs\u002Fsoftware\u002Fftools\u002F) must be installed before building the Ginga tools. Please follow steps according to [INSTALL](https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002Fsoftware\u002FGINGA-LAC_tools_ver1.1\u002FINSTALL) instruction included in the package. \n\nThe above package also contains calibration files (in the subdirectory \"cal\u002F\"), template input\u002Foutput files (\"sample\u002F\"), test telemetry data (\"frf\u002F\"), and a test script (\"run_test\"). With these files users can follow the same steps as explained in the [ABC manual](https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002FGINGA-LAC-1.0\u002Fdoc\u002FlacManual.pdf).\n\n\n### Get Telemetry Data\na. Users can search for telemetry data and LACDUMP files of specific observations upon their interests using the [DARTS\u002FAstro Query system](https:\u002F\u002Flegacy.darts.isas.jaxa.jp\u002Fapp\u002Fquery\u002Fastroquery\u002Fbasic.php?satelites=ginga).\n\nb. Or users can download all the telemetry data and LACDUMP files from the GINGA archive directly https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002FGINGA-LAC-1.0\u002F.\n\n\n### Analyze Data\nTo run the Ginga tools, the directory of LAC calibration files (included in the Ginga tools packages) must be pointed by the environment variable GINGA_CALDIR. The directory where the telemetry data are located must be pointed by the environment variable GINGA_FRFDIR. For example, type\n```\n> setenv GINGA_CALDIR \u002Fhome\u002Fueda\u002Fginga_tools\u002Fv1.1\u002Fcal\n> setenv GINGA_FRFDIR \u002Fhome\u002Fueda\u002Fginga_tools\u002Fv1.1\u002Ffrf\n```\n\n\nA step-by-step guide of Ginga LAC data analysis is given in the [ABC manual](https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002FGINGA-LAC-1.0\u002Fdoc\u002FlacManual.pdf). Analysis after data reduction using the Ginga tools can be made by standard tools in [XANADU (xspec, xronos)](https:\u002F\u002Fheasarc.gsfc.nasa.gov\u002Fdocs\u002Fxanadu\u002Fxanadu.html), included in the [HEAsoft](https:\u002F\u002Fheasarc.gsfc.nasa.gov\u002Fdocs\u002Fsoftware\u002Flheasoft\u002F) package.\n\n\n### Caveat\n\n1. Time Accuracy\n\n  There still remain some systematic uncertainties in the absolute time assignment in the telemetry files. Users are advised to read a [note](https:\u002F\u002Fdarts.isas.jaxa.jp\u002Fmissions\u002Fginga\u002FTIMEACCURACY.html) for details.\n\n2. Telemetry Overflow\n\n  For observations of bright targets you need to care about telemetry overflow of the LAC. If the number of data events in a channel exceed 255 between successive readouts, the telemetry word overflows and the true number of events is lost. As a result, artificial structures (uncontinuous drops at certain bins) could appear in the energy spectrum. The limit of a source intensity causing overflow depends on the bit rate, the telemetry mode, and the setting of the coarse gain of the LAC, as summarized below (taken from Table 5 of Turner et al. 1989, PASJ, 41, 345).\n\n\n#### Source intensity causing overflow\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd rowspan=\"2\" align=\"center\">Mode\u003C\u002Ftd>\n\u003Ctd rowspan=\"2\" align=\"center\">Coarse gain\u003C\u002Ftd>\n\u003Ctd colspan=\"6\" align=\"center\">Bit rate\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd colspan=\"2\" align=\"center\">High\u003C\u002Ftd>\n\u003Ctd colspan=\"2\" align=\"center\">Medium\u003C\u002Ftd>\n\u003Ctd colspan=\"2\" align=\"center\">Low\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>MPC1\u003C\u002Ftd>\n\u003Ctd align=\"center\">H\u003C\u002Ftd>\n\u003Ctd align=\"right\">12\u003C\u002Ftd>\n\u003Ctd>Crab\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.8\u003C\u002Ftd>\n\u003Ctd>Crab\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.2\u003C\u002Ftd>\n\u003Ctd>Crab\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"center\">L\u003C\u002Ftd>\n\u003Ctd align=\"right\">5\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.4\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.1\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>MPC2\u003C\u002Ftd>\n\u003Ctd align=\"center\">H\u003C\u002Ftd>\n\u003Ctd align=\"right\">24\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">1.6\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.4\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"center\">L\u003C\u002Ftd>\n\u003Ctd align=\"right\">10\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.8\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.2\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>MPC3\u003C\u002Ftd>\n\u003Ctd align=\"center\">H\u003C\u002Ftd>\n\u003Ctd align=\"right\">24\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">1.6\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.4\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"center\">L\u003C\u002Ftd>\n\u003Ctd align=\"right\">10\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.8\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.2\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>PC\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003C\u002Ftd>\n\u003Ctd align=\"right\">4\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.5\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003Ctd align=\"right\">0.1\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\n### Operataion Reports\n\nYou can see the daily reports of Ginga operations [here](https:\u002F\u002Fdata.darts.isas.jaxa.jp\u002Fpub\u002Fginga\u002FDOC\u002Foperation_reports\u002F) for reference.\n\n\n",1783661442259]