Next: BROWSE Graphics Up: HEASARC Users Guide Previous: Searching Databases

Subsections

BROWSE Display

Parameter Values

The dall command displays all of the parameter values associated with one or more entries. For example, to list all parameters and their values for the entry numbers 33 thru 34 use

CMA_SOURCES_COU 213> dall 33-34
 Entry no 33------------------------------------------------
NAME                            IIPEG
ID NUMBER                         674
CLASS                            8224
RA                            (1950) 23 52 30.4
DEC                           (1950) 28 21 17.4
LII                              108.2287953590978
BII                             -32.62365899332721
 
etc.

Not all the parameters contain useful information and these listings can be rather long and tedious. But this is a good method by which to export out the entire contents of a database. Another view of the database parameters is sometimes given using dpage. In this case, only pre-selected parameters are displayed. These pages are specially made for each database and show parameters of particular interest. Not all databases have these pages, and in these cases the same page seen with the dall command is displayed.

Line Summary

A subset of predefined parameter values can be displayed as a line summary for each entry. These are either system or user defined. A line summary provides a much more compact method for displaying parameter values. The system defined line summaries are designed to highlight the parameters of most interest in the table. The dsam (display sample) command gives a line summary display of all entries in a sample or subsample. For example,

CMA_SOURCES_COU > ds
 
       name       seq   off  expos   time    count filt   ra        dec   inst
   (field name)   (#)  (min) (sec) (yr.day)   rate      (1950)    (1950)
 
>  1 M82          433    1   68334  83.358  7.3E-04  7  9 51 41.5 +69 53 36 L1
   2 S50014+81   1192    1   66304  84.313  8.3E-04  7  0 14  9.4 +81 18 25 L1
   3 4U1624-49   1476    2   41179  85.084  9.4E-04  7 16 24 17.0 -49 05 20 L1
   4 M31           54    5   83215  83.207  9.5E-04  7  0 40 10.9 +40 58 18 L1
   5 M31           19    3   68770  83.182  9.7E-04  7  0 39 57.3 +41 00 06 L1
 
etc.

Typing dsam has displayed the standard line summary for the entire sample. The dsam command can be used in a similar way to display a subsample after a search has been made. To specify one or more entry numbers to be displayed as a line summary use

dsam [n-m] [p-q] [....

where n-m, p-q, etc. are the entry number ranges. If no subsample has been created, the entry number refers to that in the current sample. If a subsample has been created, then the entry number is that in the subsample. The default entry number is the first entry listed. The dline command works in a similar manner to the dsam command, except in this case it is required that a range of entry numbers be provided. Also dline can be used to reset the default coordinates. For example, dline 6 makes the default coordinates those of entry no 6 and moves > next to this entry number. The dcoord command gives a line summary of the following coordinate information:

the full RA and Dec
the galactic coordinates
the ecliptic coordinates

The RA and Dec will by default be given in hr min sec and deg min sec, but can be displayed in decimal degrees using the /degree qualifier. The galactic and ecliptic coordinates are always given in degrees. The object class can be displayed using the dclass command. The various classes are described in the Available databases guide, and can be listed using the class command.

User Line Summaries

The line summary displayed with the dline and dsam commands show only pre-selected parameters. The user can specify up to six parameters to display in a line summary format using the mat command, and then display them using dat. mat and dat stand for MAKE ASCII TABLES and DISPLAY ASCII TABLES respectively, names which reflect the fact that the output can be written to the log file in ASCII. For example,

CMA_SOURCES_COU 213> mat standard name seq ra dec lii bii

CMA_SOURCES_COU 213> mat
 Enter table name: standard
Enter parameter name or number #nn (ctrlz to end): name
Enter parameter name or number #nn (ctrlz to end): seq
Enter parameter name or number #nn (ctrlz to end): ra
Enter parameter name or number #nn (ctrlz to end): dec
Enter parameter name or number #nn (ctrlz to end): lii
Enter parameter name or number #nn (ctrlz to end): bii

and then to display them

CMA_SOURCES_COU 213> dat 1-5
      NAME         SEQUENCE N   RA           DEC          LII          BII
                   UMBER
   1  4U1746-37     1789.00      266.703     -37.0383      353.531     -5.01
   2  2S1254-690    775.000      193.585     -69.0193      303.481     -6.42
   3  HERX-1        623.000      254.006      35.4172      58.1479      37.5
   4  2A1219+305    1302.00      184.715      30.4549      186.354      82.7
   5  BD+371146     1440.00      79.3331      37.3889      170.040     0.273
 
CMA_SOURCES_COU 213>

The table which was created last is loaded as the default for subsequent dat commands. If another previously created table is required, the /table=name qualifier is used with the dat command as, for example, dat/tab=standard 1-** All existing ASCII tables can be listed using lat (list ASCII tables). An ASCII table can be erased using eat (erase ASCII table).

Statistics

The statistics [pname] command provides a statistical overview of a parameter for the current sample, or subsample. It lists the chi2 distribution, the average, the median, the variance, the skewness, and a few other useful statistical parameters. The chi2 is only given if the parameter has an associated error; this is a parameter with the same name, but ending ``ERROR".

Sort

For a subsample, the order of the display can be changed using the sort command. The qualifiers /ascending and /descending determine the order of the listing. For example, to reorder the listing in descending order on exposure time use sort/d expos.

Filters

The subsample can be filtered to remove from the display uninteresting entries based on a specified range of parameter values. The command

            sif [parm] [lower] [upper]

sets an inclusive filter for the specified parameter between the lower and upper limits, and

            sef [parm] [lower] [upper]

sets an exclusive filter. If in either case only a lower limit is specified, then the filter will include or exclude that value. RA and Dec coordinates are entered in hr min sec and deg min sec, respectively. Cone filtering is not allowed. Time is entered in yr.day format (such as 86.105). The following is an example of using filters, starting from the 3c382 subsample. First the subsample is filtered inclusively to display only the EXOSAT filter number 7 (thin lexan filter):

CMA_SOURCES_DEC 39> sif filter 7
 
  24 Entries accepted
CMA_SOURCES_DEC 39:24> ds
 
      name       seq   off  expos   time    count filt   ra        dec   inst
  (field name)   (#)  (min) (sec) (yr.day)   rate      (1950)    (1950)
 
  2 3C382        763    1    3866  84.130  7.0E-02  7 18 33 12.1 +32 39 14 L1
  4 IRAS1833+3  1698    2    8979  85.195  6.1E-02  7 18 33 11.9 +32 39 14 L1
  7 IRAS1833+3  1686    1    8499  85.187  8.2E-02  7 18 33 11.8 +32 39 15 L1
  8 3C382        158    1   18423  83.255  3.3E-02  7 18 33 11.9 +32 39 15 L1
  9 IRAS1833+3  1718    1    5625  85.204  3.7E-02  7 18 33 11.9 +32 39 16 L1
 11 IRAS1833+3  1796    2    7276  85.256  8.3E-02  7 18 33 12.3 +32 39 16 L1
 
etc.
 
CMA_SOURCES_DEC 39:24>

Note that only filter 7 entries are now displayed. The 39:24 in the prompt indicates that the subsample has been filtered. Next, the subsample is filtered on time to exclude all entries for observations made between 1983 and 1985:

CMA_SOURCES_DEC 39:24> sef time 83.001 84.365
 
  22 Entries accepted
CMA_SOURCES_DEC 39:24:22> ds
 
      name       seq   off  expos   time    count filt   ra        dec   inst
  (field name)   (#)  (min) (sec) (yr.day)   rate      (1950)    (1950)
 
  4 IRAS1833+3  1698    2    8979  85.195  6.1E-02  7 18 33 11.9 +32 39 14 L1
  7 IRAS1833+3  1686    1    8499  85.187  8.2E-02  7 18 33 11.8 +32 39 15 L1
  9 IRAS1833+3  1718    1    5625  85.204  3.7E-02  7 18 33 11.9 +32 39 16 L1
 11 IRAS1833+3  1796    2    7276  85.256  8.3E-02  7 18 33 12.3 +32 39 16 L1
 12 IRAS1833+3  1825    1    8769  85.273  7.8E-02  7 18 33 12.2 +32 39 16 L1
etc.
 
CMA_SOURCES_DEC 39:24:22>

The display can then be ordered on time using sort and displayed again using dsam as follows:

CMA_SOURCES_DEC 39:24:22> sort/a time
       39/       39
CMA_SOURCES_DEC 39:24:22> ds
 
      name       seq   off  expos   time    count filt   ra        dec   inst
  (field name)   (#)  (min) (sec) (yr.day)   rate      (1950)    (1950)
 
> 4 IRAS1833+3  1505    1    3524  85.101  2.9E-02  7 18 33 11.9 +32 39 16 L1
  5 IRAS1833+3  1506    2   18974  85.102  2.9E-02  7 18 33 11.5 +32 39 19 L1
  6 IRAS1833+3  1518    2    8935  85.109  3.6E-02  7 18 33 11.8 +32 39 21 L1
  7 IRAS1833+3  1519    1    3999  85.109  3.3E-02  7 18 33 11.7 +32 39 18 L1
  9 3C382       1537    2    2930  85.116  4.6E-02  7 18 33 12.3 +32 39 18 L1
 12 3C382       1538    1   17068  85.117  3.7E-02  7 18 33 11.7 +32 39 18 L1
 
etc.
CMA_SOURCES_DEC 39:24:22>

The filters can be removed one by one, in the reverse order to which they were applied, using rlf (reset last filter). In the following example, the filters are removed one by one:

CMA_SOURCES_DEC 39:24:22> rlf
 The effect of the TIME filter has been removed
CMA_SOURCES_DEC 39:24> rlf
 The effect of the FILTER filter has been removed
CMA_SOURCES_DEC 39>

All filters can be removed at once using raf (reset all filters). After a search has been made, there two ways to clear the subsample from memory:

issue another search command
use the rsam (reset sample) command

Saving Subsamples

Subsamples can be ``saved" for later retrieval during the current BROWSE session using the save command. Subsequent save commands will add to the ``saved subsample". The saved subsample is restored using the save/restore option. The ``saved subsample" can be cleared from memory using the save/zap command. Using the save command, it is possible to generate samples based on random lists of objects. The following example shows how to save subsamples for 3c382 and 3c390 and then restore them as one subsample:

CMA_SOURCES_DEC 39> save
 There are   39 entries in the saved subsample
CMA_SOURCES_DEC 39> sn 3c390
 
output follows...
 
CMA_SOURCES_NAM 7> sc/d
 
output follows...
 
CMA_SOURCES_DEC 13> save
 There are   52 entries in the saved sub-sample
CMA_SOURCES_DEC 13> save/res
    52 entries restored from the saved sub-sample
CMA_SOURCES_DEC 52>

Making Samples

Once a subsample has been created, it can be made into a sample and restored at a later date. This is done using the msam (make sample) command. In the following example the user makes the subsample into the sample objects:

CMA_SOURCES_DEC 52> msam
Sample name: objects
Making sample OBJECTS
Loading LE database sample OBJECTS indexed on DEC
CMA_OBJECTS_DEC >

BROWSE automatically loads the new sample as the current sample. The esam sample_name command erases the specified sample name and any associated indexes. This cannot be the current sample.

Next: BROWSE Graphics Up: HEASARC Users Guide Previous: Searching Databases

Michael Arida
1998-04-10