[ADC Logo]
TOOLS
HELP
Viewer
browse
CatsEye
plot
IMPReSS
observations
What's New
Tutorial Feedback

ADC External Query (AEQ)

The ADC External Query (AEQ, pronounced "ache") allows subsetting of ADC catalogs directly via a single URL submission (or by any simple Get mechanism). This mimics the ADC Viewer functionality without its interactivity.

You access AEQ by simply directly typing in the request as a URL in your browser, or by generating the link with your own script. To use AEQ, you must have the correct metadata set for each catalog you're interested in. This information is available online in the ADC Holdings documentation. Machine readable documentation can be acquired for most holdings by contacting a representative listed below. AEQ is meant primarily for large-scale, non-interactive purposes, such as inter-data-center queries.

An AEQ query is of the form (also, see the example below):

http://adc.astro.umd.edu/cgi-bin/viewer/cull.pl?catalog=CatName&file=FileName&fields=FieldNames&...&user=AEQ

AEQ outputs a pipe ( | ) delimited table of this format: No sorting is performed, so the data order follows the order in the archived catalog. The end-of-line marker is $.

An example query to AEQ (try it):

http://adc.astro.umd.edu/cgi-bin/viewer/cull.pl?catalog=7004A&file=zwicky.dat&fields=RA|DE|SGLON|SGLAT|ClusRad|Pop&RAMin=01+00&RAMax=03+20&DEMin=10+00&DEMax=35+00&PopMin=1500&user=AEQ

This request outputs:

# This file contains the metadata and data for an AEQ table.
# The header containing metadata ends at "EOH"; the data follows.
# All metadata and data are pipe-delimited: " | "
# All data lines end with "$"
# The table metadata format is as follows:
#   catalog | catalog long name
#   file | file description
#   field names
#   units
#   FORTRAN formats, separated by commas
#   Values denoting blank entries
#   equinox values for any coordinates
#   Number of records
#
7004A | Abell and Zwicky Clusters of Galaxies (Abell+ 1974) $
zwicky.dat | Zwicky Clusters (Zwicky et al., 1961-68) $
RA | DE | SGLON | SGLAT | ClusRad | Pop $
h min | deg arcmin | deg | deg | deg | ct/deg2 $
A7 | A6 | F6.2 | F6.2 | F4.2 | I5 $
 |  |  |  |  |  $
1950.0 | 1950.0 |  |  |  |  $
Right Ascension (Eq: 1950.0) | Declination (Eq: 1950.0) | Supergalactic longitude, de Vaucouleur's system | Supergalactic latitude | Cluster radius: 0.09326 * Diam | Mean apparent population (galaxies/sq.deg) $
29 $
#
# Data starts after EOH below
#
EOH # End Of Header
01 01.0 | +26 48 | 323.14 |   5.20 | 0.08 |  2665 $
01 12.8 | +25 05 | 322.20 |   2.19 | 0.07 |  1944 $
01 15.1 | +10 47 | 308.62 |  -2.38 | 0.07 |  3211 $
01 19.8 | +10 39 | 308.83 |  -3.53 | 0.10 |  1723 $
01 23.5 | +10 21 | 308.81 |  -4.49 | 0.13 |  1960 $
01 24.5 | +31 47 | 329.35 |   1.66 | 0.11 |  1905 $
01 29.5 | +27 31 | 325.62 |  -0.67 | 0.08 |  1807 $
01 29.7 | +31 27 | 329.37 |   0.51 | 0.05 |  5123 $
01 30.6 | +32 15 | 330.20 |   0.57 | 0.08 |  2078 $
01 38.1 | +18 39 | 317.81 |  -5.34 | 0.09 |  2708 $
01 38.6 | +27 40 | 326.41 |  -2.54 | 0.09 |  2451 $
01 40.9 | +25 51 | 324.86 |  -3.62 | 0.06 |  4269 $
01 45.0 | +19 48 | 319.44 |  -6.51 | 0.06 |  4574 $
01 47.9 | +20 09 | 320.00 |  -7.04 | 0.07 |  2344 $
01 48.9 | +18 55 | 318.91 |  -7.67 | 0.06 |  3557 $
01 49.8 | +29 25 | 328.89 |  -4.25 | 0.07 |  4107 $
01 59.1 | +18 12 | 319.06 | -10.19 | 0.10 |  2117 $
02 02.5 | +17 41 | 318.85 | -11.13 | 0.10 |  1602 $
02 09.1 | +23 17 | 324.74 | -10.52 | 0.12 |  1515 $
02 13.9 | +17 34 | 319.74 | -13.71 | 0.10 |  1784 $
02 20.0 | +12 55 | 315.81 | -16.76 | 0.07 |  2573 $
02 25.7 | +17 06 | 320.40 | -16.49 | 0.05 |  6587 $
02 27.5 | +18 53 | 322.28 | -16.19 | 0.08 |  2936 $
02 33.5 | +18 33 | 322.55 | -17.62 | 0.07 |  2763 $
02 37.2 | +25 14 | 329.25 | -15.57 | 0.05 |  6587 $
02 39.3 | +25 50 | 330.02 | -15.72 | 0.09 |  2525 $
02 39.4 | +14 02 | 318.77 | -20.72 | 0.14 |  1951 $
02 39.9 | +21 47 | 326.29 | -17.63 | 0.07 |  4406 $
02 42.2 | +33 23 | 337.23 | -12.77 | 0.07 |  2573 $

Nearly all ADC catalogs are currently available for access.

Near future enhancements:

  • A fieldBlank parameter to handle blanks in range selection.
  • c.radius parameter that allows a search around c.ra and c.dec.
  • The equinox parameter and precession calculation.


    Authors: Vincent Kargatis, Ed Shaya
    Last modified: 2005/03/5