► Japanese

UDON
SUZAKU XIS Quick Look Usage

Contents

SUZAKU XIS Quick Look - Screen Shot
Introduction

Basic search page
Search form
Search result

Image generation page
Image generation form
Pseud-color image
Image data extraction
Result of image data extraction
Error in image data extraction

Introduction

What is UDON?

UDON (Universe via Darts ON-line) is the system to 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 Look?

SUZAKU XIS Quick Look is the web service to display pseudo-color X-ray images taken by SUZAKU XIS (X-ray Imaging Spectrometer).
Assigning Red, Green and Blue colors for soft, medium and hard energy images extracted from XIS event files, Suzaku UDON composites and displays the pseudo-color image.

UDON system to generate/display pseudo-color images from XIS event files
structure

How to generate and display XIS pseudo-color image?

XIS pseudo-color image can be generated/displayed on the image generation page. There are 2 ways to open this page,

  1. From the Suzaku public data list page
    Click the link button of QL UDON for each entry.
  2. From Basic retrieval screen  (Usage of Basic retrieval screen is here)
    Click the button of OBS ID section.

When you specify the Sequence Number/OBSID, you will find a pseudo-color image made with the default color map on your first screen (image generation page). After that, you may change the color-tone by specifying the new energy boundaries in the dialog boxes in the left-hand side column  (usage of image generation screen is here).

From Published data list page From Basic retrieval page
Published data list Basic search page
Click the link of QL UDON section Click the button of OBS ID section
down arrow   Image generation screen   down arrow
Image generation page

Back To the top of this page

Search page

Search page consists of the "Search form" frame (upper section) and the "Search result" frame (lower section).

Specify search conditions (OBSID, version, name) in the "Search form" frame, and click the "Search" button, then you can get all the observational data which satisfy the search conditions.

top
search form
search result


Back To the top of this page To the top of the Search page

Search form

Specify search conditions. You may specify OBS ID (Sequence Number), Processing Version and name of the targets.


Usage of the Search form
Entry box Explanation
Satellite
 Satellite Name

Specify the satellite name that you want. You can choose a single satellite from the list.

SUZAKU  Retrieve SUZAKU information
ASCA-SIS  Retrieve ASCA-SIS information
ASCA-GIS  Retrieve ASCA-GIS information
OBS ID
 Specify OBS ID (Sequence Number) you want.
You can retrieve a list of the observation sequences which match the input pattern.
You may use meta-characters below for pattern matching;

?  Match an arbitrary number.
%  Match arbitrary numbers.
[…]  Match one of the numbers designated by ‘…’, where a dot means a single numeric
[!…]  Match any numbers those excepts designated by ‘…’, where a dot means a single numeric
  It is possible to specify the conditions with numeric strings as ‘…’ like ‘135’, or to designate a range of the numbers with ‘-’ (like ‘0-4’).
Data processing Version

Specify the data processing version that you want. You can choose multiple versions from the list.

all  Display the data processed with all the Versions.
latest  If there are data processed with different versions, only the latest one will be displayed.
1, 2, …  Display only the data processed with the specified processing version.
-->
Name
 Target name

Specify the observation target name you want. Display the data whose target names registered in Suzaku Master match the specified pattern.

Case is ignored, and you may use the meta characters below;

?  Match an arbitrary character.
%  Match arbitrary characters (including blank columns).
[…]  Match one of the characters designated by ‘…’
[!…]  Match any characters expects those designated by ‘…’
  It is possible to specify the conditions with characters as ‘ABCXYZ’, or designate the range of characters by ‘-’ as ‘I-N’
button
 Query button
Query:  Search for observation data that meet the input conditions.

Back To the top of the page To the top of the explanation of each screens. To the top of Search form

Search result

Display all the observation data that meet the search conditions specified in the previous Search form.

  1. If there are data that meet the input conditions:
    You can browse the the search results as follows; If you click the button in the OBS ID section, you can browse the Image generation page of the corresponding data, where a pseudo-color image is displayed.

    search result
  2. If there are no matching, you will find the following message;

    no information is available

  3. If there are any input errors on the Search form,
    you will get the error message as follows;
    Please revise the input conditions on the search form in reference to following list and retry search.

    If there is any errors in OBS ID section.
    Sample error message Explanation
    OBS ID: invalid character: 123r
    		 Input non-number or non-meta-character.
    Sample correction)   “123r” ==> “1234”
    OBS ID: missing "]": 123[024
    		 Bracket method ([…], [!…]) has not been completed.
    Sample correction)   “123[024” ==> “123[024]”
    OBS ID: invalid range end: 123[0-
    OBS ID: invalid range end: 123[0-]
    		 The range expression of bracket method ([m-n], [!m-n]) has not been completed.
    Sample correction)   “123[0-”, “123[0-]” ==> “123[0-4]”
    OBS ID: invalid range end: 123[9-5]
    		 The range expression of bracket method ([m-n], [!m-n]) is not correct.
    m, n should be in the correct order in the character code, so they should be m <= n
    Sample correction)   “123[9-5]” ==> “123[5-9]”

    Name If there is any input error in this section,
    Sample of error message Explanation
    Name: missing "]": *x-[0-9
    		 Bracket method ([…], [!…]) has not completed yet.
    Sample correction)   “*x-[0-9” ==> “*x-[0-9]”
    Name: invalid range end: *x-[9-0]
    		 The range expression of bracket method ([m-n], [!m-n]) is not correct.
    m, n should be in the correct order in the character code, so they should be m <= n .
    Sample correction)   “*x-[9-0]” ==> “*x-[0-9]”

Back To the top of this page To the top of the explanation of the screens To the top of the Search Result

Image generation screen

Image generation screen consists three frames; "Image generation form" frame (upper-left panel), "Pseudo-color image" frame (upper-right panel), "Image extraction" frame (lower panel).

You may specify the color-pattern of the pseudo-color image on the "Image generation form" frame, and the new image will appear on the "Pseudo-color image" frame by clicking the "Show image" button. Also, the operation result will be appeared on the "Image extraction" frame.

There are 4 different forms for specifying the energy boundaries (color patterns), in the "Image generation form". To switch the form, click "Prev. Form" button or "Next Form" button.

top
imaging formpseudo color image
image data extraction


Back To the top of the page To the top of the explanation of the screen

Image generation form

Specify the extraction method of image data and the color pattern for pseudo-color image.

Usage of Image generation form
No. Image generation form Usage
1
OBS ID: 100009010 (ver 2.0)
Energy boundaries
Boundary Energy
Color
E0: keV
} red
} green
} blue
E1: keV
E2: keV
E3: keV
Image generation form: No.1
Divide the energy range from E0 to E3 into 3 energy ranges, as E0 to E1 is Red, E1 to E2 is Green, E2 to E3 is Blue.

This form uses the pre-made images created for fixed energy boundaries.

If E0 <= E1 <= E2 <= E3, the extract operation will terminate with error.

red, green, blue
Use red, green, blue

red, blue
Not use green

Reset  Reset the input value.
Show Image  Extract the image data, and the Pseudo-color image will be displayed.
Prev. Form  Switch to No.4.
Next Form  Switch to No.2.
2
OBS ID: 100009010 (ver 2.0)
Energy boundaries
Range Lower Upper
Color
B0: keV red
B1: keV green
B2: keV blue







Image generation form: No.2
You may specify the lower and upper energy boundaries for Red, Green and Blue images independently.

This form uses the pre-made image data at fixed energy boundaries.

Allocate Energy range as B0 is Red, B1 is Green, B2 is Blue.

if Lower <= Upper, then the operation will terminate with error.

red, green, blue
Use red, green blue

red, blue
Change the color pattern of red and blue

Reset  Reset the input value.
Show Image  Extract the image data, and the Pseudo-color image will be displayed.
Prev. Form  Switch to No.1.
Next Form  Switch to No.3.
3
OBS ID: 100009010 (ver 2.0)
Energy boundaries
Boundary Energy
Color
E0: keV
} red
} green
} blue
E1: keV
E2: keV
E3: keV
Image generation form: No.3
You may specify the arbitrary energy boundaries, but Red, Green, and Blue images have to be contiguous. Images are extracted from the XIS event files (thus take longer than the form No. 1 and No. 2).

Energy range from E0 to E3 is divided into 3 energy ranges, as E0 to E1 is Red, E1 to E2 is Green, E2 to E3 is Blue.

If not E0 <= E1 <= E2 <= E3 , the processing will terminate with error.

red, green, blue
Use red, green, blue

red, blue
Use without green

Reset  Reset the input value.
Show Image  Images are extracted from the event files, and the Pseudo-color image will be displayed.
Prev. Form  Switch to No.2
Next Form  Switch to No.4.
4
OBS ID: 100009010 (ver 2.0)
Energy boundaries
Range Lower Upper
Color
B0: keV red
B1: keV green
B2: keV blue







Image generation form: No.4
You may specify the arbitrary energy boundaries, and the Red, Green, and Blue image boundaries do not have to be contiguous. Images are extracted from the XIS event files (thus take longer than the form No. 1 and No. 2).

Allocate Energy range as B0 is Red, B1 is Green, and B2 is Blue.

If not Lower <= Upper, the operation will terminate with error.

red, green, blue
Use red, green and blue

red, blue
Change the color pattern of red and blue

Reset  Reset the input value
Show Image  Images are extracted from the event files, and the Pseudo-color image will be displayed.
Prev. Form  Switch to No.3.
Next Form  Switch to No.1.

Back To the top of this page To the top of usage of the screen To the top of Image generation form

Pseudo-color image

When Image data extraction is completed, a pseudo-color image will be displayed.

The generated pseudo-color image will be displayed. You may interactively specify the extraction region on the image to extract the light curve and the spectrum.

pseudo color image
magnification drag white box click view point '-' button '+' button slider knob slider selection: circle region: circle selection: ellipse region: ellipse selection: box region: box list box reset botton submit button
Operation
Change shape of the defined area
Select the shape from the list box.

Reset the defined area
Click "Reset" button.

Extract the light curve and the spectrum of defined area
Click "Submit" button.

If the operation terminate with error, the image will not appear.
Back To the top of this page To the top of Image generation screen Top of Pseudo-color image

Image data extraction

Display the result of image extraction (using the "extractor" FTOOL) from the XIS event files with the Energy boundaries values defined in the Image generation screen.

Image generation form: If use the image extraction form No.1 or No.2, you are using the pre-extracted images, and new images are not extracted.

Results of image data extraction

  1. Image generation form: The sample of operation No.1.
    You will find only then Energy boundaries values that you specified in the image generation form.

    Image generation form: The sample of operation No.1
    OBS ID: 100009010 (ver 2.0)
    Energy boundaries
    Boundary Energy
    E0: 0.200 keV
    E1: 1.000 keV
    E2: 3.000 keV
    E3: 10.000 keV

    Back To the top of the page To the top of the explanation of the screen To the top of the Image Extraction

  2. Image generation form: The sample of operation No.2.
    You will find only the Energy boundaries values that you specified in the image generation form.

    Image generation form: The sample of operation No.2
    OBS ID: 100009010 (ver 2.0)
    Energy boundaries
    Range   Lower   Upper
    B0: 0.200 1.000 keV
    B1: 1.000 3.000 keV
    B2: 3.000 10.000 keV

    Back To the top of this page To the top of the explanation of the screen To the top of the Image Extraction

  3. Image generation form: The sample of operation No.3.
    Display the result of image data extraction (with the "extractor" FTOOL), as well as the Energy boundaries values.

    Image generation form:The sample of operation No.3
    OBS ID: 100009010 (ver 2.0)
    Energy boundaries
    Boundary Energy
    E0: 0.316 keV
    E1: 1.000 keV
    E2: 3.162 keV
    E3: 10.000 keV

    Back To the top of this page To the top of the explanation of the screen To the top of the Image Extraction

  4. Image generation form: The sample of operation No.4.
    Display the result of image data extraction (using the "extractor" FTOOL), as well as the Energy boundaries.

    Image generation form:The sample of operation No.4
    OBS ID: 100009010 (ver 2.0)
    Energy boundaries
    Range   Lower   Upper
    B0: 0.316 1.000 keV
    B1: 1.000 3.162 keV
    B2: 3.162 10.000 keV


    Back To the top of this page To the top of explanation of screen To the top of the Image Extraction

Errors in Image data extraction

If there are any errors in the Energy boundaries on the Image generation form, you will see the following get the error message.
Please confirm the error, revise the values and submit again Energy boundaries .

Sample: Errors in Energy boundaries (1)
Sample error message Explanation
E2: 0.200 is less than E1: 1.000.
 E1 > E2 .
Please input values such that E0 <= E1 <= E2 <= E3 .

error:upside-down
E1 > E2
Specify coloring.
 Correct color pattern is not selected. The input values are
E0 = E1 = E2 = E3 .
E0 is blank.
 The entry field is blank.
Please input a positive value.
E0: -0.316: Specify a positive value.
 The input value is negative.
Please input positive values.

Sample: Errors in Energy boundaries (2)
Sample error message Explanation
B1: Upper: 3.000 is less than Lower: 5.000.
 In the input values for B1: Lower > Upper .
Please input values so that Lower <= Upper .

error:upside-down
Lower > Upper
Specify coloring.
 Correct color pattern is not selected.
The values are either of the following: B0: Lower=Upper, B1: Lower=Upper, B2: Lower=Upper.
B0: Upper is blank.
 The entry field is blank.
Please input positive values.
B0: Lower: -0.316: Specify a positive value.
 The input value is negative.
Please input positive values.

Back To the top of this page To the top of screen explanation To the top of Image data extraction