► Japanese

UDON
SUZAKU XIS Quick Plot - Usage

Contents

SUZAKU XIS Quick Plot - Screen Shot SUZAKU XIS Quick Plot - Screen Shot
Introduction

Screen guide
Image of data extraction region
Spectrum
Light curve


Introduction

What is UDON?

UDON (Universe via Darts ON-line) is the system to quickly analyze science satellite data archived in DARTS (Data Archives and Transmission System) via Internet (HTTP).
With UDON, you can analyze DARTS archival data using your browser without downloading data from DARTS!



What is SUZAKU XIS Quick Plot?

SUZAKU XIS Quick Plot is the web service to display pseudo-color X-ray images taken by SUZAKU XIS(X-ray Imaging Spectrometer), and to extract light curves and spectra for specified regions on the image.


How to display XIS pseudo-color image, extract light curves and spectra ?

First, specify the data range to create spectrum and light curve on the XIS Quick Look image.

  1. Access SUZAKU XIS Quick Look to generate pseudo-color image.
    Steps to generate the pseudo-color image are here.
  2. Specify the region to generate spectrum and light curve.
    Steps to specify the extract region are here.
  3. Click the [Submit] button to display the spectrum and light curve.
    It may take several minutes to extract a spectrum and light curve for bright sources. Please be patient...

You can re-generate spectrum/light curve changing the extraction region.

Region Pseudo color image Submit button UDON SUZAKU XIS Quick Look UDON SUZAKU XIS Quick Plot
Mechanism of generating spectrum/light curve
structure
Back To the top of this page

Screen guide

The initial screen is to display the spectrum . The screen can be switched with the Light curve button and Spectrum button .
On the initial screen, you can see the spectrum in the logarithmic scale.
On this screen you may re-display the spectrum/light curve by changing the scale, but you cannot specify the data extraction region.
If needed, please specify the data extraction region again on the image generation screen of UDON SUZAKU XIS Quick Look.

Spectrum
Spectrum
Screen
right arrow
can be switched

 left arrow
by clicking these buttons.
Light curve
Light Curve


Back The top of this page To the top of the screen guide

Image of the data extraction region

QuickLook Image
observation information
Image of the extraction region is displayed at the upper-left on the screen.
Click the image, then results of the data extraction process (extractor command-line and screen output) are displayed.
Clicking the string under the image, "observation information" will display some information about the observation (taken from the FITS Primary Header).
To go back to the previous page, please use the [Back] button of your browser, or the [Back] button on the upper-right corner of the page.


Back To the top of this page To the top of screen guide To the top of this topic

Spectrum

Display the extracted energy spectrum. You can re-draw the graph if you change the scale or range.

Drawing spectrum

Rescale Parameters
Rescale Parameters
Spectrum 
X :Energy Log
Lower Upper Unit      
keV
Y :Counts Log
Lower Upper Unit      
count

Specify the graph scale and/or display range, and click [Rescale] button to re-draw the spectrum. Or click [Light Curve] button to switch from spectrum to light curve.



Details
Input box Explanation
X :Energy Log
Lower Upper Unit      
keV

Set X-axis scale and range.

Log  Check to display in the logarithmic scale.
Lower  Set lower-limit value of the display range.
Upper  Set upper-limit value of the display range.

Please set the values as   0 <= Lower < Upper.

Y :Counts Log
Lower Upper Unit      
count

Set Y-axis scale and range.

Log  Check to display in the logarithmic scale.
Lower  Set lower-limit value of the display range.
Upper  Set upper-limit value of the display range.

Please set the value as   0 <= Lower < Upper

Reset  Reset the input values.
Rescale  Re-display the graph with the specified scale and range.

Switch the screen to light curve.


Displaying the Spectrum

The original FITS and QDP files are here.
Spectrum
Please understand that in some cases, the graph may not appear if there is no data within the region which you specified.

It is available to download the extracted spectrum data ( tar.gz file ) from " The original FITS and QDP files are here. " the link at upper side of the graph.


Reduced size graph.


Data download

Save extracted spectrum data (FITS file and QDP file) as tar.gz file. After downloading the files, you can display them by fplot ftool or qdp command.

Example of commands to extract spectrum FITS file and QDP file 
$ tar -ztvf 100009010v2_0-xissp.tar.gz
-rw-r--r-- apache/apache 182421 2008-07-28 15:26 100009010v2_0-xissp.fits.gz	# FITS file 
-rw-r--r-- apache/apache    135 2008-07-28 15:26 100009010v2_0-xissp-pi.pco	# PI Channel
-rw-r--r-- apache/apache  27080 2008-07-28 15:26 100009010v2_0-xissp-pi.qdp	# PI Channel
-rw-r--r-- apache/apache    131 2008-07-28 15:26 100009010v2_0-xissp-ev.pco	# keV
-rw-r--r-- apache/apache  36225 2008-07-28 15:26 100009010v2_0-xissp-ev.qdp	# keV
$

$ mkdir PSR1509-58
$ tar -zxvf 100009010v2_0-xissp.tar.gz -C PSR1509-58
100009010v2_0-xissp.fits.gz
100009010v2_0-xissp-pi.pco
100009010v2_0-xissp-pi.qdp
100009010v2_0-xissp-ev.pco
100009010v2_0-xissp-ev.qdp
$
100009010v2_0-xissp.fits.gz   FITS file
100009010v2_0-xissp-pi.pco QDP command file  X-axis scale: PI Channel
100009010v2_0-xissp-pi.qdp QDP File  X-axis scale: PI Channel
100009010v2_0-xissp-ev.pco QDP command file  X-axis scale: keV
100009010v2_0-xissp-ev.qdp QDP file  X-axis scale: keV

Errors in drawing figure

If there are any invalid input values when drawing the figure, error messages are displayed.
Please input revised values, and draw the spectrum again.

Input errors in the drawing figure
Sample error messages Explanation
Energy: Upper: -1.0: Specify a non-negative value.
Counts: Lower: 1.o: Specify a non-negative value.
 You must input only positive value numerical values both for Lower and Upper.
Energy: Upper: 0.200 is less than or equal to Lower: 1.000.
Counts: Upper: 100 is less than or equal to Lower: 100.
 There is input failure that Lower limit = Upper limit, or Lower limit > Upper limit.
The values should be always Lower < Upper.


Back To the top of this page To the top of the screen guide To the top of the topics

Light curve

You can re-draw the graph by changing the scale and/or range.

Drawing light curve

Rescale parameters
Rescale Parameters
Light Curve 
X :Time Log
Lower Upper Unit      
sec.
Y :Rate Log
Lower Upper Unit      
count/s

Specify the graph scale and/or display range, and click [Rescale] button to re-draw the spectrum. Or click [Spectrum] button to switch from light curve to spectrum.



Details
Input box Explanation
X :Time Log
Lower Upper Unit      
sec.

Set X-axis scale and range.

Log  Check if display n the logarithmic scale.
Lower  Set the lower limit of the display range.
Upper  Set the upper-limit value of the display range.

Please set the values as   0 <= Lower < Upper .

Y :Rate Log
Lower Upper Unit      
count/s

Set Y-axis scale and range.

Log  Check to display int the logarithmic scale.
Lower  Set the lower-limit value of display range.
Upper  Set the upper limit value of the display range.

Please set the values as   0 <= Lower < Upper .

Reset  Reset the input value.
Rescale  Re-display the graph with the specified scale and range.

Switch the screen to spectrum.


Light curve

The original FITS and QDP files are here.
Light Curve

Please note that the graph will not appear if there is no data within the specified region.

The light curve data files may be downloaded from the link " tar.gz The original FITS and QDP files are here. " at upper side of the graph.





Down load the data

Save the light curve data (FITS file and QDP file) generated by data extraction as tar.gz . The FITS file and QDP file can be displayed by fplot ftool and qdp command, respectively.

Extract of the commands to extract the light curve FITS file and QDP file. 
$ tar -ztvf 100009010v2_0-xislc.tar.gz
-rw-r--r-- apache/apache 26919 2008-07-28 15:26 100009010v2_0-xislc.fits.gz	# FITS file
-rw-r--r-- apache/apache   163 2008-07-28 15:26 100009010v2_0-xislc.pco		# QDP Command
-rw-r--r-- apache/apache 91490 2008-07-28 15:26 100009010v2_0-xislc.qdp		# QDP File
$ 

$ mkdir PSR1509-58
$ tar -zxvf 100009010v2_0-xislc.tar.gz -C PSR1509-58
100009010v2_0-xislc.fits.gz
100009010v2_0-xislc.pco
100009010v2_0-xislc.qdp
$
100009010v2_0-xislc.fits.gz   FITS file
100009010v2_0-xislc.pco QDP command file
100009010v2_0-xislc.qdp QDP file



If there are input errors when drawing figure.

Display error message if there are any input errors when drawing the figure.
Please correct the input values to re-display the figure.

Input errors when drawing the figure.
Error message sample Explanation
Time: Lower: -9000: Specify a non-negative value.
Rate: Upper: 1,0000: Specify a non-negative value.
 Both Lower and Upper should be positive values.
Time: Upper: 12000 is less than or equal to Lower: 70000.
Rate: Upper: 15 is less than or equal to Lower: 20.
 Lower = Upper or Lower > Upper. (Lower >= Upper)

Upper should be always greater than Lower (Lower < Upper).


Back To the top of this page To the top of the screen guide To the top of the topic