|
Help Page for ESO Data Product Query Forms
|
||||||||||||||
|
This web page provides some help on how to
use and what to enter for the various query parameters offered in the
ESO Phase 3 Data Products query forms.
Access is supplied through the WDB interface. |
|||||||||||||||
| Programme | Allows to constrain your search to data products resulting from a particular programme. The list of programmes to select from includes data from all the ESO public surveys, and from other ESO observing programmes. The full list is available via the page hosting all the available Phase 3 release descriptions. |
| Collection | In the course of the Phase 3 process, the PI of an ESO programme organises the data products according to appropriate high-level criteria into self-consistent groups, called "data collections", which, subsequently, the archive user can browse and access. Later on the PI may issue further data releases to add more data or to update already released data products. |
| Release version | The data collection consists of a series of *data releases* tagged by incremental numbers starting from one, each of which may be considered one particular version of the data collection. Leave this field empty to operate in default mode, i.e. to always obtain the most recent data release for any collection. If you want to request the data of a specific release, enter an integer number (1, 2, ..) to obtain the data of a specific release, usually a previous version of the selected data collection. |
Phase3 user | Name of the person who delivered the datasets to ESO through the Phase 3 process. |
| EPS_REG | ESO public survey region name. |
| Run/Program ID | Read the documentation on the ESO programme identification code. |
| Telescope | Name of the ESO telescope. For more information, please check ESO telescope web page.. |
| Instrument | Name of the instrument. For more information on ESO instrumentation, please check ESO instrumentation web page. |
| OBSTECH | Technique used during the observation.
|
| Target Name |
Target name for SIMBAD, NED or OBJECT name in FITS header, depending on the setting of the selector.
|
| Object | The object name as specified by the principal investigator. In the result page, the object value links (follow its URL) to all other data products in the same data release that have the same object name. For spectroscopic public surveys, the object name serves as unique survey source identifier. |
| Input Target List (aka Uploaded Targets) |
Suppose you have a list of targets and you would like to query the ESO Archive for each target in that list.
Instead of having to re-type the target name or coordinates and run a new search for each target in the list,
you may query the ESO Archive using an input file of targets.
Click on the 'Browse' button to locate and upload the file from your local directories.
The file must contain no more than one target per line. The target can be
If so wished, a comment can be provided on each line, following a '#' character Coordinates can be provided as decimal degrees (both RA and DEC) or as sexagesimal hours (RA) and sexagesimal degrees (DEC). Valid sexagesimal separators are both the blank and the colon, as in: 01:23:45.678, 01 23 45.678. Example of input target list:
15: +08: # sexagesimal, sign separated
15 +08 # decimal, sign separated -> degrees!
BD +8 4236 # name which will be resolved using the chosen name resolver (default SIMBAD)
15:30 +08:23 # sexagesimal, sign separated
15:30:41.1 +08:23:38.1 # sexagesimal, sign separated
15 30 41.1 08 23 38.2 # sexagesimal, tab separated
15:30:41.1 +08:23:38.3 # sexagesimal, tab separated
15:30:41.1 -08 23 38.4 # sexagesimal, sign separated
15 30 41.1 -08:23:38.5 # sexagesimal, sign separated
eta car # name which will be resolved using the chosen name resolver (default SIMBAD)
232.67208333 8.393916666 # decimal, tab separated
232.67208333+8.393916666 # decimal, sign separated
b212 # name which can be matched against an existing Phase 3 target name
# by setting the Phase3 Target Name as name resolver (see NAME).
Example of an erroneous input target list:
15 30 41.2 08 23 38.4 # no separator 15 30 41 08 23 38 # no separator 15 30 08 23 # no separatorThe name resolver used can be either SIMBAD (deafult), or NED; if the "Phase 3 target name" option is chosen (see Target Name), then the input is used to match against the OBJECT FITS keyword value in the Phase 3 archive, |
| Target RA or galactic longitude | The right ascension of the target in hours or degrees, depending on the selected format. The values can be expressed as decimal (e.g., 8.2) or sexagesimal values where minutes and seconds are blank or colon separated (e.g., 8 12 or 8:12). If a Search Box is specified, the search will be in a box around the given coordinates. Ranges can be specified with " .. " in which case the box size will not be used. Examples:
The galactic longitude of the target in decimal degrees. Examples:
|
| Target DEC or galactic latitude | The declination of the target in degrees. The values can be expressed as decimal (e.g., 8.2) or sexagesimal values where minutes and seconds are blank or colon separated (e.g., 8 12 or 8:12). If a Search Box is specified, the search will be in a box around the given coordinates. Ranges can be specified with " .. " in which case the box size will not be used. Examples:
The galactic latitude of the target in decimal degrees. Examples:
|
| TL_RA | Survey tile RA in decimal degrees. |
| TL_DEC | Survey tile Declination in decimal degrees. |
| TL_OFFAN |
Tile rotator offset angle as defined using the Survey Area
Definition Tool (in degrees). |
| Coordinate system | Selects Equatorial(FK5) or Galactic coordinates as input. |
| Equatorial Output Format | Choose here the output format for coordinates: either sexagesimal hours or decimal degrees. |
| Search Box |
If you search by coordinates or target name to be resolved by SIMBAD/NED, enter here the size
of the search box around the target.
|
| DATE OBS | Enter the UT of interests in YYYY-MM-DDTHH:MM:SS.S format and the system returns all products that potentially cover this UT, i.e. the selected products have start of observation before and end of observation after the given UT. |
| STOP_TIME | The stop time of a product can be displayed on the tabular output by selecting (highlighting) it in the Extra Columns section at the bottom of the query form. It specifies the end of the observation, or the end of the last observation if the product resulted from the combination of multiple observations. |
| MJD OBS | Same as "Date OBS" but using the Modified Julian Date (MJD) instead. |
| EXPTIME |
Total integration time per pixel (in seconds).
|
| TEXPTIME |
Total integration time per product (in seconds).
|
| MULTI EPOCH | Flag to indicate that the data product includes observations obtained in more than one epoch. The exact definition of an epoch, particularly the associated time scale, depends on the scientific goals and is at the discretion of the programme P.I. The VISTA public survey programmes UltraVISTA, VIDEO and VVV are expected to deliver multi-epoch data products. |
| OB ID | You can identify data products originating from a specific Observation Block ID or a list of OB ID vlues separated with commas, without any blank spaces. |
| MULTI OB | Users can request or exclude data products obtained by combining observations from several Observing Blocks. |
| Wavelength coverage [nm] | The wavelength coverage of any Phase 3 1D spectrum is characterised by 2 parameters: its minimum and maximum wavelengths in nanometers (from the WAVELMIN and WAVELMAX FITS keywords)(1). Using those two parameters an overlap criterion (for 1D spectra only) is implemented, as if gaps were not present in the data:
|
| R [=λ/δλ] | The spectral resolving power (unitless). |
| Spectral bin size [nm] | The spectral bin size, that is, the wavelength sampling size in units of nanometers. |
| SNR | The signal-to-noise ratio of the spectrum (unitless). |
| Flux Calibration | It characterises the quality of the flux calibration in terms of two possible values: ‘ABSOLUTE’ or ‘UNCALIBRATED’. For imaging data, it certifies the validity of PHOTZP if set to ‘ABSOLUTE’, otherwise ‘UNCALIBRATED’. For spectroscopic data, it represents the type of flux calibration, whether ‘ABSOLUTE’ or ‘UNCALIBRATED’ e.g. when normalised to the continuum. |
| Aperture | The slit width or the fiber diameter expressed in arcsec. |
| Dispersive element | The name of the dispersive element. |
| Extended Object | A flag set to T (true) if the spectrum refers to an extended object, F (false) if it is point-like. |
| Normalised | A flag set to T (true) if the spectrum is normalised to the continuum, F (false) otherwise. |
| Total Flux | T (true) indicates that the flux data represent the total source flux if, for instance, observations were obtained under photometric conditions and measures were taken to capture the total source flux e.g. by choosing a slit sufficiently wide with respect to the seeing. It applies to spectroscopic data having FLUXCAL = ‘ABSOLUTE’. |
| DIT | Detector Integration Time. Any query by DIT (detector integration time) includes all data product that have keyword DIT properly defined in the primary HDU. |
| NDIT | Number of sub-integration. |
| NJITTER | Number of jitter positions per observation. |
| NOFFSETS | Number of offset positions per observation. |
| Field of View | The field of view on the sky sampled by the image in the largest dimension in units of degree. |
| Sky Coverage | The sky coverage in units of square degrees. |
| PIXELSCALE | The image product's typical pixel size in units of arcsec. |
| PSF_FWHM | The image product's typical resolution or FWHM of the PSF including the effect of atmospheric blurring if applicable (in units of arcsec). |
| Ellipticity | Average ellipticity of point sources defined as (1-b/a) with a and b denoting major and minor axes of the source profile, resp. |
| Filter | Filter name (imaging only). |
| PRODCATG | The ESO archive is directly searchable for science data products. This field allows to constrain the search to one specific data product format:
The Data Product Format is specified by the Phase 3 FITS keyword PRODCATG='SCIENCE.*'. |
| VISTA data product type | See the VISTA/VIRCAM paragraph of the Phase3 user documentation "ESO Science Data Products Standard" for the list of VISTA product types. |
| IMATYPE | Type of imaging product: TILE, PAWPRINT, VSTRIPES as defined in the keyword IMATYPE. |
| ISAMP | Flag to indicate if DP represents a contiguous area of the sky or a sampling thereof (depends on type of product). |
| ABMAGLIM | Typical 5-sigma limiting depth for point-sources (AB mag, total flux, approximately, that is +-0.1 mag). |
| ABMAGSAT | AB mag of point sources that appear to be saturated on the image. |
| NCOMBINE | Number of raw science data files that were combined in the data product. |
| NUSTEP | Number of micro step positions per observation. |
| Data product origin | The value of the P3ORIG FITS keyword of the product, which describes the origin of a Phase 3 data product. Can either be:
|
| Release Date | It is the date before which the product is under a proprietary period (and downloadable only by the PI or delegates), and after which the product is publicly available. |
| Publication Date | The date when the product became available through the Phase 3 system. |
| ORIGFILE | The Original file name is given by the PI and corresponds to the FITS keyword ORIGFILE. |
| ARCFILE | The Dataset ID is the name under which the data product is stored in the ESO Archive. The Dataset ID corresponds to the FITS keyword ARCFILE, without the extension. |
| REFERENC | Bibliographic reference to the primary scientific publication associated to the data product describing content, coverage, process of creation and scientific quality, when defined (in the REFERENC FITS keyword of the product). |
| VOTable Output Format | The VOTable format is a Virtual Observatory XML standard for tabular data.
More about the VOTable description is available at
http://www.ivoa.net/Documents/latest/VOT.html.
|
|
|