Browse Browse Help Help
Latest Version
New/Updated Tables

Main sections of this help document:

Some step-by-step examples

Introduction to Browse

Browse provides access to the catalogs and astronomical archives of the High Energy Astrophysics Science Archive Research Center (HEASARC) over the World-Wide Web. Catalogs include data from all astronomical regimes, but the emphasis of the archive is data from high energy astrophysics satellites. These satellites, launched by NASA and other space agencies, observe X rays and gamma rays from astronomical objects including stars, galaxies, supernova remnants, clusters of galaxies and active galactic nuclei. This document gives a brief description of how to use Browse.

There are four different Browse interfaces:

  • Main Interface
    This interface is the main web interface to the archive. You can choose the missions and tables you want to query. You can also set up complex parameter queries or do name/coordinate searches in various coordinate systems/equinoxes and plot query results. Cross-correlations can be performed based on the results of a query.
  • Catalog Index Interface
    Lists all mission catalogs with links to appropriate HEASARC resources.
  • Batch Interface
    This is a set of Perl scripts that you can execute on remote Unix workstations to do multiple batch Object Name/Coordinates searches without having to use a Web browser.
  • Cross-correlation Interface
    This interface allows you to cross-correlate full tables on radius or time.
  • Quick Search Form
    This interface, accessed from the HEASARC Archive Page, allows you to enter minimal information to quickly display data from popular missions.
  • Keyword Search Form
    This interface, accessed from the HEASARC Archive Page, allows you to search using keywords as you would with current internet search engines

Main Interface


VizieR logoIn addition to offering access to the catalogs and tables at the HEASARC, the Browse main interface supports transparent access to thousands of catalogs in VizieR maintained by the CDS in Strasbourg, France and mirrored at sites around the world. When VizieR tables are queried, links are provided wherever possible so that the user can switch to the VizieR query interface.

Quick Start

The HEASARC Browse comprises several layers of Web pages starting from the launch page and providing successively more detailed access to the information resources of the HEASARC. A typical search for archival information looks something like the following:

  • Select the interface to use.
    Most users will use the main Browse interface. This interface allows you to choose missions and/or catalogs and search by coordinates, object name, or any other parameter in the table. The other interfaces will be discussed later in this document.
  • Select missions or catalogs to search.
    Each mission or catalog set contains a number of database tables. The database tables list different types of information (including proposed observations, scheduled observation, completed observations)
  • Initiate the search:
    You can choose to search directly from here, or choose More Options if you'd like to query on parameters other than position or date, or if you'd like to choose the tables to query within the missions you've selected.
    Search from here or More options
  • Enter an object name or coordinates, and/or enter a date/time, and click the Start Search button.
  • OR
  • Optionally enter an object name or coordinates, and/or enter a date/time, and click the More Options button.
  • Select one or more tables.
  • Click Submit Search, or Specify Additional Parameters. Submit Search will search the tables around the position and/or date you specify. By clicking Specify Additional Parameters you can query any field in the table.
  • Select data records to be examined in more detail.
    You can choose to retrieve or view lists of data associated with a given catalog entry, look at all the fields in the row (including those that were not initially displayed), plot your results, or cross-correlate your results with other tables.

  • Select data products (images, spectra, events lists, proposal abstracts, etc.) to be downloaded to your computer. This page is only shown if you chose to View data products from the query results page.
    Archival products are not available for all catalogs.

Limitations of starting the search from the first page:


Detailed help

The Main Browse interface comprises a series of forms: the Missions selection form, the optional Catalog Selection form, the optional Parameter Search form, the Query Results form, the Data Products form, and the Data Retrieval form. Typically, you will descend through these forms until the data desired is found. The last two forms are used only if archival data is to be retrieved. You may use the features of your Web browser to back up to previous forms, make a change to the selection at that level, and then go forward.

Mission Selection page

The first form is the Missions selection form. You may enter one or more object names or coordinates, and/or observation dates. If you are planning to query tables on parameters other than position or dates, ignore this section.

Select one or more missions/observatories, groups of catalogs, or individual catalogs by checking the checkboxes. Links will display help in a new window. The Multiwavelength Catalogs section on this first page lists a few special "pseudo-missions". Typically, these catalogs do not have associated archival data. The Master catalog contains catalogs which have been generated by combining smaller catalogs.

There is a set of checkboxes where you can choose the types of information queried - checking these will have a filter effect on the missions and catalogs you select. For example, checking Proposal Information and ROSAT and ASCA means you are only selecting those ROSAT and ASCA tables which contain proposal information. Using these table types, you can more accurately select what types of tables you search.

  • Archive and Observations - tables which contain observation pointings.
  • Object Catalogs - compiled catalogs which contain objects found during a mission or survey.
  • Proposal Information - catalogs of proposals, abstracts, and schedules.
  • CDS VizieR - This special 'type' queries CDS's VizieR service for tables that are relevant to the missions and catalogs selected. (For example, selecting Stars and ROSAT and VizieR selects those resources VizieR holds that are star catalogs or have ROSAT data.)
  • There is a 'hidden' type - Physics - which is always on, and only applies to the Atomic Data catalogs.

Finally, you can choose to modify the defaults for the output display. You may change the number of results returned for each table, change the output format, and choose to show all fields in the results rather than the default fields.

Click Start Search if you're ready to search, or More Options if you'd like to choose the tables to query within each mission, or if you want to query tables on parameters other than position or observation date.

Selecting the Catalogs to Query

NOTE: If you have initiated the search from the first page, this page will not be displayed.

The top of the Catalog Selections page contains links to the selected missions. Each of these mission links will take you to a page which displays some description of all the catalogs available for the mission.

This page displays the catalogs available for the selected missions. Each row in the tables tells you the catalog name, description, whether the catalog contains archive data, the default search radius, the name of the mission to which the table belongs, and the type of information contained in the table (Object catalog, observation catalog, proposal information, etc). When this page first comes up, the catalogs are ordered by priority so that more important tables appear first. You can sort these tables by other parameters by clicking on the up and down arrows beside each column name.

This page requires you to check the catalogs you want to query and then click on Submit Search or Specify Additional Parameters buttons. The Submit Search button will run a search on the position or date you specify. Clicking on Specify Additional Parameters will allow you to search on other parameters.

Object Name/Coordinates Search

Topics:

Explanation of Name/Coordinates Input Formats

We have tried to include as many formats as possible.

Example coordinate inputs:
  • 12 00 00, 4 12 6
  • 180., 4.21
  • 12 14.2 -4 12 6.48
  • 0., 0.
  • 70.30, 18.95
  • 16H10M15.06S, 7D05M30.10S
  • 7H34:12.05, 67:18:04.50
  • 70° 54 13.16, -18.00
Example name inputs:
  • Cygnus X-1
  • Eta Car
  • Ar Lac
  • A2156
  • Sco X-1

By default, the coordinates you input are assumed to be J2000 equatorial coordinates. You may change this by choosing a different coordinate system or equinox.

The object name or position may be entered in a number of different formats. If an object name (i.e., any entry containing characters other than decimal digits, spaces, and '.', '-', or '+') is entered, then the name will be resolved to coordinates using one of the supported name resolving services.

Object names should conform to the established IAU specifications for designating astronomical radiation sources. There is a nomenclature dictionary for celestial objects that can be searched if you are unsure of the object name that you should be using.

Coordinates may be separated by a comma or by either a plus or minus sign to remove ambiguity. If a coordinate consists of a single number which contains a decimal point, then that coordinate is taken to be given in decimal degrees; otherwise, the sexagesimal format is assumed and the coordinate is parsed accordingly. Galactic coordinates are always assumed to be in degrees, whether in sexagesimal or decimal format. If equatorial coordinates are entered in sexagesimal format, right ascension values are assumed to be in hours/minutes/seconds, and declination values are assumed to be in degrees/minutes/seconds. Spaces should be used to separate hours/degrees from minutes and minutes from seconds in sexagesimal format. Seconds values are optional in sexagesimal format, so if you only want to specify hours/minutes and/or degrees/minutes that is allowed. The minutes can even be decimal minutes if so desired. Since it is impossible to determine whether a lone integer right ascension value is in hours or degrees and to prevent confusion, typing a lone integer coordinate value is considered invalid. This means, for example, if you want to do a search for objects near 0 hours right ascension and 0 degrees declination, then you should enter either "0.,0." (the decimal points flag the input as decimal degrees) or "00 00 00, 00 00 00" (if sexagesimal input is preferred). Entering simply "0,0" is considered an error.

Note that when using names in positional searches one should always increase the search radius size when dealing with extended objects: a good rule of thumb would be to make the search radius no smaller than the angular size of the object in question.

Searching for Multiple Objects and/or Coordinate Pairs

Browse can perform name/coordinate cone searches on multiple object names and/or coordinate pairs in a single query submission. Separate each entry with a semicolon.

Example of multiple name/coordinate inputs:

  • Cyg X-1; Cyg X-2; Cyg X-3
  • 3c273; 12.235, 15.345; 3c279; 18 12 5.29, 4 18 3.4
The only limit on the number of name/coordinates that you can search for in this manner is determined by your browser. Depending upon your browser, the limit on the size of the name/coordinates entry string can be on the order of hundreds of characters or even thousands.

Uploading a Local File of Objects and/or Coordinate Pairs for Your Search

Browse can perform name/coordinate cone searches on multiple object names and/or coordinate pairs that are read from a file on the user's system. The file should contain object names and coordinate pairs one or more per line. If more than one per line, names and/or coodinate pairs should be separated by a semicolon.

Files created by clicking the Save all Targets to File button on the Results page can also be used for the file upload option. This option saves all objects in all tables to a local file on the user's system. The format of this file is the same as the Pure Text Format under the Redisplay option.

Choosing a Name Resolver

If you enter an object name, that object name is resolved into a pair of coordinates. When specifying particular tables to search, and/or additional parameters to query, you can select to use the SIMBAD or NED or the GRB (Gamma Ray Burst) name resolving services. In general, SIMBAD is preferred for galactic sources. The default behavior of Browse is to query the GRB name resolver first, and if the object name is not resolved, then SIMBAD is queried, then NED.

Examples of valid GRB names: GRB 060501, GRB 050820A, GRB060204B

Specifying Observation Dates

You may query by observation dates. Not every table is queryable by date, for example the object catalogs do not have dates. In the tables of results that are returned, the observation date column may have different names - typical labels include 'start date', 'start time', 'time', 'begin date', etc.

The general format for the observation date is YYYY-MM-DD hh:mm:ss, where the hh:mm:ss is optional. MJD is also accepted. Multiple dates are allowed - separate each date with a semicolon. Ranges can be specified using the '..' syntax shown below. If a range is not given, the range is assumed to be +/- 1 day around the date given.

Example of date/time inputs:

  • 2001-01-20 06:00:00
  • 2001-01-20
  • 51929
  • 2001-01-20 .. 2001-02-15
  • 1992-12-31; 48980.5; 1995-01-15 12:00:00; 1997-03-20 .. 2000-10-18

Other Search Options

You may optionally choose the coordinate system/equinox that you wish to use in the search. The search results are displayed in the coordinate system and equinox that you choose.

You can also choose the radius for the database search. Each catalog has a default radius which is displayed in units of arcminutes in the list of catalogs. If you wish to override these defaults, then use the Search Radius menu to select the value you want. In this case the same radius will be used for all selected catalogs.

You may limit the number of displayed results by choosing the result limit from the menu.

You can choose to display the output using Tabbed Display format (the default), as HTML tables, as plain text tables (displays faster, includes most advanced features, and can be imported more easily into other programs), as FITS tables (can be analyzed using standard FITS tools like FTOOLS), or in astrores XML format (contains both the data and the metadata, useful for reading by other applications). The Tabbed Display uses navigation tabs to reduce the amount of scrolling that is necessary for table navigation in the HTML format. Each results table has its own tab for easy display.

Internet Explorer Users: The Tabbed Display is not fully functional using the Internet Explorer browser. Navigation tabs will not work until all query tables are loaded and the Processing Query tab is no longer displayed. It is recommended that another browser or a different Browse display format (HTML, Text) be used.

Normally the results of a query have only the most significant columns displayed. If you want to see every column in the results, check the Show all Fields box.

Cone Search Offset Calculation

Browse will calculate the distance from the center of the search cone specified by the Object Name/Coordinates Search criterion to the coordinates of each observation in the Query Results output. Browse places these calculated values in a pseudo-column with the name 'Offset' in the query results. These values have units of arc-minutes. The Haversine formula is used to compute the offsets.

Search Using Previously Saved Query

A previously stored query can be used for a Browse search. When results are displayed after a Browse search. a Save Query To File button may appear on the Results page. Clicking on this button will store the query in an encoded form in a file on your system. When you are ready to reload the stored query click on the Query File And Session Uploads button on the Main Search Page. Enter the File name or Click the Browse button and the click the Load Query button. Query results will then be displayed.

Search by Parameter

A more general search on table(s) can be made by choosing Specify Additional Parameters from the Catalogs Selection page. After doing this, you will see the page that allows you to set parameter criteria.

Building a Parameter Search Query

You can build a Parameter Search query consisting of multiple criteria. The form displays all parameters present in a catalog. It also allows you to see the minimum and maximum values for each parameter. You have the option to set several criteria in order to form your own query:

  • View: The checkboxes under View allow you to chose the parameters you want displayed. The defaults are selected when you first come to this page. (If you are querying multiple tables, this column is not displayed.)

  • Sort: The radio buttons under Sort allow you to select the parameter to sort results on. You may only sort on one parameter at a time.

  • Parameter: The Parameter heading displays the parameter name. Each link will take you to catalog help on the parameter.

  • Query Terms: The Query Terms column contains an entry box for each parameter. Enter constraints on your query in these boxes. The min, max, and type columns for each row will help you determine how to compose your query terms. Constraints on a parameter can also be expressions involving combinations of other parameters.
    • Operators for all fields: You can use the operators: '=', '<','>','<=', '>=', '..' (range operator), and can negate any of these by prefixing it with '!', for example '!..'. You can 'OR' query terms for the same parameter using ';', 'or', or '|' between terms. For example, '<=5 or 10; 20 .. 40'.
    • Nulls: You can search for null values (useful when you are looking for all rows where a flag is not set, for example) by typing 'null' (or '!=null') in the query terms box.
    • date fields: Any of the date formats previously specified can be used.
    • position fields: Any of the position formats previously defined can be used.
    • numeric fields: No special instructions.
    • string fields:
      • Wildcards: In string fields, you can use '*' or '%' (they are treated identically) as a wildcard to take the place of multiple characters: ie '3c*' will match 3c273, 3c279, etc.
      • String searches are generally case insensitive. Your entries will be uppercased before being sent to the database. The exception is the case of long text fields, such as abstracts. Those are stored in the database in mixed case, and your min/max values are not uppercased before searching.
      • Internal spaces are significant: searching for '3c 279' will not find '3c279'. Use wildcards ('3c*') if there is a possibility of internal spaces.
    • Multi-parameter constraints: Suppose a table has 4 parameters par1, par2, par3, and par4, then the following are examples of possible query terms for par1:
      '!=(par2)'
      '> (3 * par2)'
      '= (par2 + par3) OR par4 > 100'
      '< (par2/par3) AND par3 < 2 * par4'
      '< (par2) AND (par3="somestring")'
      (Notice that the second constraints in the last three examples do not (need to) involve the parameter par1).

Note: Constraints in more than one parameter query box are ANDed not ORed, i.e., the results of the query will be those entries for which all of the constraints have been satisfied.

Query Results

Once you have submitted a search, the database is queried to find the data which satisfy the conditions you have imposed. A Query Results form is returned with one line for each matching row in the database. If you have used the defaults and retrieved only the standard parameters then there will typically be between five and ten parameters including information such as name, observer, date of observation, position and exposure. If you selected all parameters there may dozens of parameters on a very wide form. The exact parameters will vary depending upon the catalog chosen. There is no field which is included in all catalogs, although right ascension ("ra") and declination ("dec") are usually present. To get information about a parameter click on the column headings in the form.

If you requested data from more than one catalog, you will see separate listings for each catalog you chose.

Coordinate Conversion Error

Any coordinates shown in the results table have been converted to the same format as your input coordinates. If there is an error in computing the conversion, you will see the unaltered coordinates as given in the table, and the flag "!!" which is a link to this help section. One common reason for this error is that dummy coordinates (ie '-999') may have been entered in the table to indicate that an observation was not a true data observation.

Sort Results

You can resort the query results for a table by clicking on the up and down arrows beside each column name. (VizieR tables can only be searched in one direction and will only have one arrow for each column.)

Show all columns

Clicking on the magnifying glass icon at the start of each row will show you all the parameters for that row, including any that don't show up by default. For the results from VizieR queries, the icons are split - white on top and red on the bottom. Clicking on the white section will show the columns in the HEASARC format, while clicking on the red section will show the columns as VizieR formats them.

Data Products

To see what archival data products are associated with any given observation, click on the checkbox next to the entry, and then (if the option is available) choose whether you want to download a data products set (Retrieve), get a listing of individual data products that are available for download (Preview and Retrieve), or get a list of commands that can be used to download individual files (Create Download Script). All the data sets are checked by default, if you don't want to download or list all those data sets, uncheck the ones you don't want.

The products list will show the file sizes for all the products, which may influence your decision to download them. Any GIFs included in the data sets will be shown in miniature. Click on them to get a full size image. This allows you to preview the data set before downloading.

You can also limit the types of data products displayed or downloaded by using the Unix shell wild-card * in the File Name Filter box. The filter is applied to the full path name. For example, the filter */bat/*.hk* would limit data products to those that are under the directory bat and contain '.hk' in a subdirectory or file name. A file such as /FTP/swift/data/obs/2005_04/00035014004/bat/hk/sw00035014004bdp.hk.gz would be included. Multiple contraints separated by a semicolon (;) will be treated as boolean OR. So, *fits*;*gif* will result in products with names containing 'fits' or 'gif'.

Related Links

This column is populated with links to rows in other Browse tables that are related typically via a shared table field or positional query to the current row.

Other Web-based Services

We provide access to other web-based services in two different places on the results page. The services we think may be requested most often can be accessed by (typically single-letter) links on each line in the query result tables. These services are:
  • R : ROSAT All-Sky Survey image through SkyView, based on the coordinates on the current line.
  • N : NED near-position query, based on the coordinates on the current line.
  • S : SIMBAD position query, based on the coordinates on the current line.
  • D : Get Data products from Browse for this observation.
  • B : Get bibliography links from ADS related to this observation.
  • H : Analyze data products for this row using Hera. Requires Fv software. More information can be found on the Hera page
The second method of accessing services is the select menu below each result table. The frequently-requested services, as well as many other services are available here. Use the checkboxes at the beginning of each result row to select rows of interest, select as many services in the select menu as you want, and click GO. A new page will be created with just the result rows of interest, with links to the services requested.

Cross-Correlation of Query Results

You may also cross correlate on query results from here. Click on the Cross-correlate button (there will be one for each table in the results). You will then see a form that sets up a cross-correlation query. Skip to the instructions for the Cross-Correlation Interface

Plotting Query Results with Java

  • When you are viewing the results of a query, you can plot any numerical column against any other numerical column by clicking on the "Plot" button at the bottom of the table of results. (For this to work, the user needs a Java 1.2 (or higher version) capable browser). Notice that all rows displayed by the user's query are included in the plot - checking or unchecking the checkboxes in a row has no effect.
  • A new page will display with a plot form once the Java applet is loaded.
  • The default mode in this plot form is a scatter plot of ra vs dec; other options include (i) scatter or line plots of all parameters listed in the pull-down x and y parameter menus in either linear or logarithmic scales, (ii) histogram and cumulative histogram plots of the selected x-parameter in either linear or logarithmic scales, and (iii) an Aitoff Projection in Galactic coordinates of the rows. The scatter and line plots and Aitoff Projection options can be used on selected samples of the rows by checking the `Sample data by parameter' checkbox, and selecting a parameter and the desired range of values and/or intervals, e.g., `2 , 4 .. 10' would plot only rows for which the selected parameter had a value of either 2 or in the range from 4 to 10 (notice that the points for the various selection criteria will be plotted in different colors). While non-numerical parameters cannot, of course, be plotted in scatter plots, they can be used as criteria for sample selection, e.g., picking the parameter `status' and entering `Public' in the intervals/value box, would result in a plot not of all the rows but only of that sample of the rows which have a public status.
  • Click "Plot" to plot the selected criteria. To make a hard copy, click the print icon to the right of the plot. Click on "Plot Options Panel" and "Plot Panel" to switch between the plot form and the plot.
  • Plot values can be displayed and downloaded to a local file by clicking the Display/Save Plot Values button.
  • For more sophisticated plotting and/or fitting options than the Browse plotting package can provide, the users should, when making a query, use the `Output Format' option on the `Parameter Search' page to select an appropriate output format for the query results, e.g., choose the `FITS' output format if you intend to use the ftools fv interface, `Excel-compatible' if you plan to use Microsoft Excel, `Pure text' if you plan to use QDP/PLT (this last option will require some text editing of the query results), `VOtable' if you plan to use software that recognizes the Virtual Observatory table format, etc., etc. These output formats can also be selected on the query results page.

Getting Data Products

If you chose to Preview and Retrieve data products from the Query Results form, you will be presented with the Data Products form which repeats the query result information from the previous page for the entries you selected and follows it with a list consisting of brief descriptions of each of the data products available for the selected database table entries (if any). Click on the checkbox next to the data products you wish to download, and then click on the Retrieve or Create Download Script button. If Retrieve is selected products are combined into a single TAR file. The Data Retrieval page summarizes the contents of this resulting file and allows you to retrieve it directly to your system via your Web browser. The data may also be retrieved via anonymous FTP. If Create Download Script is selected commands that can be used to download each file will be displayed and an option to download the commands to a local file will be available.

If you chose Retrieve on the Query Results page, you will instead go directly to the Data Retrieval page where a TAR file will be created for you to download. This option (and the View option) will only be presented if at least one of the catalogs you queried has data products sets defined. Most of the more important and new catalogs have defined data products sets, but many of the older catalogs have not yet implemented this sets feature.

Almost all astronomical data files are stored in the standard FITS file format. Most astronomical analysis packages (for example, FTOOLS) can easily read FITS file and an extensive suite of software tools for the analysis of HEASARC and other astronomical data is available.


Browse Catalog Index Interface

Topics:


Getting Started

The Catalog Index Interface provides links to resources for each catalog in a mission. You can use it as a reference to find information on a particular catalog.

Mission Links

Each mission name links to the FTP area for that mission. If you want to read about a mission, you can click on the description link next to the mission name. Below the mission name line, you will see links to the various catalogs in that mission.

Catalog Links

The first link for each catalog contains its full name. If you want to search this catalog, click on this link and it will take you to a Browse Query Page.

The second link is a short name for that catalog. It links to a help page describing the catalog and its parameters.

The third link displays the number of parameters in the catalog.

The fourth link displays the number of row entries in the catalog. This link will take you to the catalog's Transportable Database Aggregate Table (TDAT) file. This file contains parameter information, metabase information and all the data contents of a particular catalog.


Browse Batch Interface

Topics:


Software Installation

Please note that only Object Name/Coordinates Searches can be executed using the the batch interface. Also, in order to use the batch facility, you will need access to a Unix workstation with Perl 5.x or Perl 4.x compiled and installed on it.

You will need to download two Perl scripts:

  1. browse_extract.pl
  2. webquery.pl (Perl 5.x) OR webquery.pl (Perl 4.x)
from the HEASARC's anonymous FTP server. Once you've downloaded these files, make sure they have executable permissions and place them in your executable path. These scripts assume your system has the Perl command installed in /usr1/local/bin. If Perl has been installed elsewhere on your machine, you should edit the first line of each script to change:
#!/usr1/local/bin/perl to the correct location.

Note: These scripts are in the public domain. Please feel free to copy and modify them to use however you wish. However, we can only support the versions of the scripts that we have made available.

Usage

To use the Batch Interface, simply type browse_extract.pl at your shell prompt. Many options are available, but you are only required to specify the table to be searched and the astronomical position(s) of interest.

The syntax of the command is:

browse_extract.pl table=table name

optional arguments:
position=object name or position
coordinates=EQUATORIAL or GALACTIC
equinox=year
radius=numerical value in units of arc-minutes
fields=STANDARD or ALL
name_resolver=NED or SIMBAD
infile=input filename
outfile=output filename
All arguments are case insensitive.

Explanation of command line arguments:

table
This is the abbreviated or short table name as used in Browse, e.g., ABELL, XTEOBS, ROSPUBLIC. You can find these table names in the Catalog Index Interface.
position
This is either the name of an object or a set of coordinates to search around. If a name is given it will be resolved using the service given in the name_resolver argument or SIMBAD by default. The syntax for coordinates is the same as those supported in the Browse Web service. If the coordinates string contains embedded spaces (e.g., 12 2 3.3, -13 8 1), then this argument should be enclosed in quotes.
coordinates
This should be either "Equatorial" or "Galactic". The default is Equatorial.
equinox
This defines the equinox year for both your input and and the resulting coordinates in the output. It defaults to 2000.
radius
This gives the radius in arcminutes for which a match should be made. This defaults to 1 degree. Note that this is different from the interactive Browse system where the default differs from table to table.
parameters
indicates which parameters are to be retrieved from the table. The default, "Standard", indicates that only a preselected set of the most critical parameters will be retrieved. "All" will retrieve all parameters from the table.
name_resolver
may be used to select the system used to convert names into coordinates. The currently supported services are NED and SIMBAD. The default is SIMBAD.
infile
specifies a file containing positions to be searched.
outfile
specifies a file to contain the table of returned results. If not specified the results will be printed on standard out.

You may specify the target positions using the position argument, using a predefined file specified with infile, or from the standard input. In the latter two cases each line until an EOF will be used as a position.

Examples

Are there any public ROSAT observations of 3C273?

% browse_extract.pl table=rospublic position=3c273 name_resolver=ned

should print to standard output a table like the following:


seq_id     |instrument|exposure|ra(2000)  |dec(2000)  |name              |public_date(ISO)|
RP600242   |PSPC      |    3078|12 27 43.2|+01 36 00.0|GIOVANELLI-HAYNES |      1994-03-22|
RP600242A01|PSPC      |   24830|12 27 43.2|+01 36 00.0|GIOVANELLI-HAYNES |      1994-03-22|
RH120001   |HRI       |       0|12 29 04.8|+02 03 00.0|XRT/HRI NORTH DUMM|      1995-08-01|
WP141509N00|PSPC      |    3332|12 29 04.8|+02 03 00.0|3C273             |      1994-09-28|
RP120000N00|PSPC      |     916|12 29 04.8|+02 03 00.0|XRT/PSPC NORTH DUM|      1995-01-31|
WF700191   |PSPC      |    3291|12 29 04.8|+02 03 00.0|3C273             |      1996-02-07|
WP700191   |PSPC      |    6243|12 29 04.8|+02 03 00.0|3C273             |      1996-02-07|
RP141520N00|PSPC      |     485|12 29 04.8|+02 03 00.0|3C273             |      1995-09-27|
WH700234   |HRI       |   17174|12 29 07.2|+02 03 00.0|3C 273            |      1993-07-20|
...
Search of table ROSPUBLIC around '3c273' with a radius 60' returns 25 rows

I might first do a query of all WGACAT sources within 80' of the galactic center using:

% browse_extract.pl table=wgacat radius=80 coordinates=galactic position='0.,0.' outfile=wgacat_gc.list

The results of that query can be edited (manually or by a simple script) to produce at file like:

359.386118, 1.149945
359.510470, 1.223261
359.274779, 0.933392
359.279818, 0.934399
359.383583, 0.977861
359.389096, 0.979161
359.392070, 0.972419
359.292038, 0.907242
359.389873, 0.967603
359.390891, 0.967811
359.393223, 0.969269
...
plus 340 more lines.

If this result is stored as wgacat_galcen.dat, we can find nearby HST Guide Star Catalog positions with:

browse_extract.pl table=gsc coordinates=galactic infile=wgacat_galcen.dat outfile=wgacat_galcen_guidestars.dat
It will take a while to process 350 targets...

If you have questions concerning the installation or usage of these scripts please contact the HEASARC.


Browse Cross-Correlations Interface

Topics:

Getting Started

This interface can give you information such as which ASCA and XTE observations were made within one week of each other and within 10' radius of each other.

Cross-Correlations Query

First select which two tables to cross-correlate. Select the primary table from the first menu, and the secondary table from the second menu. A flag after each table name indicates the type of correlation that each table supports. For example, if a table contains a 'R' flag, it can be correlated by specifying radius. A 'T' flag indicates that the table can be correlated by time. A 'RT' indicates that the table can be correlated using radius and/or time.

By default, the radius cross-correlation is selected, using the default radius. Correlation by time is also available, and you can change the correlation default delta in radius and time if you wish.

xoffset

If you chose to correlate on position, a column labeled xoffset reports the distance between the two positions on each row of the cross-correlation results. These values have units of arc-minutes. The Haversine formula is used to compute the offsets.

tdelta

If you chose to correlate on time, a column labeled tdelta reports the time difference between the two observations on each row of the cross-correlation results. These time deltas have units of days.

Quick Search Form

The Browse Quick Search Form appears on the HEASARC Archive page and can be used to perform a simple query consisting of
  • object names and/or coordinate pairs
  • search radius
  • observation dates
  • one or more of a set of selected missions.
To view a summary table of results for all missions enter an object or coordinate pair and/or Observation Dates and click the Start Query button. A summary of Browse table names and the number of rows that satisfy the search criteria will then be displayed. Users can then select one or more tables to see results.

Alternately one or more missions can be selected on the Quick Search Form to display specific mission results.

For any query from the Quick Search Form there must be at least one object name/coordinate entry or observation date entry.

If you need more information on object names or coordinated formats see Explanation of Name/Coordinates Input Formats section.

By default, the coordinates you input are assumed to be J2000 equatorial coordinates. You may change this by choosing a different equinox from the pulldown menu.

Each mission has a default radius which will be used in the query unless a different radius (in arcminutes) is specified.

If you need more information on observation dates see the Specifying Observation Dates section.

The More Search Options link can be used to access the Browse Main Interface which provides all Browse mission, catalog and search options.


Keyword Search Form

Overview

The Keyword Search Form appears on the HEASARC Archive page and the HEASARC home page. It allows querying by entering parameters in a very simple form.

The simple form has a lot of power. Although there is only a single entry box you can query any Browse or Vizier table, search by time or position and do selections on any parameter. Almost all of the capabilities available through the other Browse interfaces are available here -- and you can do a lot of things here that you can't really duplicate elsewhere. In a fashion similar to Google and other search engines, you just enter strings describing the tables you are interested in, positions, times or other qualifications and Browse goes off and gets the data that matches your needs.

Parameters you enter are analyzed locally before being sent as a query to the Browse Web service. Mission names, authors, regimes, ... are used to select the tables to be searched. Objects or positions, times, and explicit constraints control how selected tables are queried. A few special parameters control how the query is processed.

Generally though you shouldn't need to worry about all these details. Start with the examples (below or in the search form) and modify them to fit your needs. In a couple of minutes you'll be using this form for sophisticated queries.

Query Feedback

If you are entering your query from the Keyword Search Form the boxes on the top right of the page (Number of matching tables and Query Specs) give you feedback about how your parameters are being interpreted, and the number of matching tables that may be searched. These update automatically as you type in the form.

This interface makes extensive use of JavaScript and has been tested on most browsers/platforms. On Windows XP use Netscape, Mozilla, Firefox or Internet Explorer. On the Mac use Netscape, Safari, Mozilla, or Firefox and on Linux/Unix use Netscape, Mozilla and Firefox. If you have problems please let us know.

Search Details

The interface uses some simple rules for determining what the parameters mean. These rules usually work pretty well but sometimes don't give you the right results. If that happens you can override the default rules by specifying an appropriate prefix.

Parameters are normally delimited by white space. If spaces are important ("eta car", for example), then you can use quotes to enclose spaces. Take a look at the Query Specs box on the top right to see how things are being interpreted. When you are specifying coordinates or times, the interface can often understand them without your needing to enclose them in quotes even when fields are separated by spaces --- but it's always a good idea to check the specs box before submitting the query.

The number of tables that will be searched is indicated at the top right corner of the page. Note that by default only the top 10 tables will be searched. The tables are sorted by relevance so it is likely the tables you are interested in will be included. The number of tables searched can be changed using the table: prefix discussed below.

Clicking on List will give you a list of the matched tables. This list is in order of relevance to the keywords you have specified. Clicking on the name of a table in this list will show a description of the table, including a list of the table parameters (handy if you want to specify a search qualifier). To go back from the list of tables to the search form, use the Back or Forward link (and not the Back or Forward Browser buttons).

Query fields are interpreted as either keywords, positions, time, radius, coordinates, qualifiers, vizier, format. There are also special prefixes that force the interpretation of a parameter.

Keywords: Keywords limit the tables that are to be searched. By default simple alphabetic parameters are assumed to be keywords. The descriptions and metadata of each table to be searched are matched against the keywords and only the tables that match are searched. Normally tables must match each keyword (though you can use just the beginning of the words you want to match). You can do OR's by joining two keywords with a | or or. E.g., wgacat|ascamaster will match tables which refer to either the WGACAT or ASCAMASTER catalogs.

Positions: Positions indicate where the queried tables are to be searched. By default the interface assumes that any parameter which starts with a number, or which has embedded spaces or sequences of numbers, is a position. Positions may be specified as either target names or as coordinate strings. If a name has an embedded space it should be enclosed in quotes, but coordinate strings usually will be interpreted correctly without them. You can give coordinate positions in either sexagesimal (HH MM SS, +DD MM SS) or decimal formats. Clicking on the target name in the Query Specs box on the top right shows the position which corresponds to the name.

Time: Times are used for temporal searches. Times can be expressed in the ISO yyyy-mm-dd hh:mm:ss format or Modified Julian Days (MJD). By default, query parameters which are numbers larger than 10000 or strings in the ISO time format (yyyy-mm-dd hh:mm:ss) are interpreted as times. Either a single time or a time range separated by .. (eg., 1995-01-15 .. 1995-12-31 ) may be specified. Use decimal fractions to get better than one day resolution with in the MJD format.

Radius: This specifies the radius of the search around specified positions. Use a number followed by a single quote (') to specify arcminutes. Use double quotes (") to specify seconds. Non-integer values are fine. E.g., 2.5' is equivalent to 150". Browse uses a default search radius that varies by table if no search radius is specified.

Coordinates: Coordinates strings specify the input and output coordinate system. Recognized values are J2000, B1950, FK4, FK5, or galactic. J2000 is the default. FK5 and FK4 can be used as aliases for J2000 and B1950 respectively.

Qualifiers: Qualifiers specify a condition or constraint on the rows to be returned. For example, you can request a minium exposure using exposure>3000. A parameter is treated as a qualifier if it has an embedded =, > or < character. You can specify qualifiers even when some of the tables matching your keywords won't have that field you are querying on. Browse will note which tables don't have the required column and give you the results for the ones that do. Use the table documentation (available after clicking on the List link in the top right) to get the parameters available for a given table.

Vizier: Include the string vizier to ask to query matching Vizier tables as well as local HEASARC resources. The metadata for Vizier is matched against keywords just as local tables are. Since Vizier tables are hosted at the CDS (Centre de Donnees astronomiques de Strasbourg) and not at HEASARC, Vizier searches could be slow depending on the network connection.

Format: Specify the output format for the output tables by entering one of: table, text, fits, vo, excel, or pure. The last gives a pure text output with no hyperlinks.

Special Prefixes: There are a number of optional fields that affect the output of the search which can specified by using a prefix string followed by a ':'. Prefixes are also used to force the interpretation of a parameter as keywords or positions. Any abbreviation of the prefix can be used. These prefixes are:

  • rows: specifies the maximum numbers rows to display for each output table. E.g., r:30, ro:5, rows:1000

  • fields: sets the columns of the table that are to be displayed. The allowed value is all. The default is to display only the most "important" columns of the table in the output. E.g., fields:all

  • tables: sets the maximum number of tables (from the set of matching tables) to be queried. By default only the top 10 relevant tables will be queried. If you are including vizier tables, then this number refers to HEASARC and Vizier tables separately (i.e., by default you can get up to 10 HEASARC and 10 Vizier tables). This parameter can be set to t:all or t:0 (or t:99999) to display all tables.

  • position: forces the interpretation of the following word as a target/position. E.g., p:polaris. By default polaris would be treated as a table selection keyword rather than a target name.

  • keyword: forces the interpretation of the following word as a keyword. keyw:2mass would force the interpretation of 2mass as keyword and it would be used to search for matching tables. By default 2mass would be treated as a target name.

Examples

Look for all ROSAT data on NGC1205
rosat ngc1205

Look for all ASCA observations of within 10' of 3C273 with GIS exposures > 20000.
3c273 asca gis_exposure>20000 10'

Look for all X-ray observations of 3c273 and Eta Carinae in the 1990's. Limit results to 10 rows per table in the text format but try all tables, not just the best matches.
'eta car' 3c273 1990-1-1..2000-1-1 x-ray rows:10 text tables:all
Note the quotes around eta car. We could have shortened rows: and tables: to r: and t:.

Look for all ROSAT or XTE data near specified positions excluding the xteindex table
10 20 30.5, 40 15 12.2; 128.34 +4.83 ROSAT | XTE -xteindex

Look for objects near Polaris in surveys that mention 2MASS in their metadata. Include Vizier tables.
k:2MASS p:polaris vizier
Note the use of the k: and p: options to force 2MASS to be interpreted as a keyword and polaris as a position.

    Syntax  
Parameter Type Parameter Action Prefix
(optional)
Restricted Values
(only these values can be used)
Example Values
(if values not restricted)
Affects
Keywords Limits the tables searched to those where the word is found in the metadata or description of the table keyword:   rosat
chandra
x-ray
abstract
public
star
quicklook
keyword:survey
Selection of tables
Positions Indicates where the queried tables are to be searched position:   'Cyg X-1'
12 00 00, 4 12 6
p:ngc499
12.235, 15.345
Selection of rows within a table
Times Used for temporal searches of queried tables     1992-12-31
48980.5
1995-01-15 12:00:00
1997-03-20..2000-10-18
Selection of rows within a table
Radius Specifies the radius of the cone when searching around specified positions     600'
12"
Selection of rows within a table
Coordinates Specifies the coordinate system used for input and output coordinates   J2000
B1950
galactic
FK4
FK5
  Selection of rows within a table

Output

Qualifiers Specifies a particular condition or constraint on the rows to be returned. Values should contain <, =, or >     duration>116.4
exposure<300
flux=12.0
pi_lname=*white*
Selection of rows within a table
Vizier Includes Vizier tables in search for matching tables   vizier   Selection of tables
Format Specifies the format for the output tables   text
vo
table
fits
pure
excel
  Output

Parameters Specified With a Prefix
    Syntax  
Parameter Type Parameter Action Prefix
Restricted Values
(only these values can be used)
Example Values
(if values not restricted)
Affects
Rows Sets the maximum number of rows in any output table rows:   rows:120
r:0 [specifies all rows]
r:20 [default]
Output
Fields Sets the columns of the output table that are to be displayed fields: all   Output
Tables Sets the maximum number of tables [from the set of matching tables] to be queried and displayed tables:   t:40
tab:0 [all matching tables]
t:99999 [all matching tables]
t:10 [default]
Selection of tables

Output

Positions Forces the interpretation of the following word as a target/position. This is useful if target name contains no spaces or numbers and is interpreted as a keyword position:   pos:crab
position:polaris
Selection of rows within a table
Keywords Forces the interpretation of the following word as a keyword. This is useful if a keyword contains a number and is interpreted as a position keyword:   k:1-megasecond
keyword:2mass
Selection of tables


HEASARC Acknowledgment

Browse is provided by the Astrophysics Science Division at NASA/Goddard Space Flight Center. If using this service made a significant contribution to a research project, please make the following acknowledgment in any resulting publication:

"This research has made use of data obtained through the High Energy Astrophysics Science Archive Research Center Online Service, provided by the NASA/Goddard Space Flight Center."

Please send a preprint or reprint of the paper to:

	The HEASARC
	Code 660.2
	NASA/Goddard Space Flight Center
	Greenbelt, Maryland 20771
        USA

Page Author: Browse Software Development Team
Last Modified: Tuesday, 19-Oct-2021 16:09:17 EDT