EVLA, VLA, VLBA Archive Search Parameters <
Parameter Example Default URL Parm Comments
General Search Parameters
Program ID AB973 All PROJECT_CODE Observing Program Name (Project Code)
Project Segment A All SEGMENT Note 1.
Observer Name Benson All OBSERVER Name : Last, First
Archive File Name vla2007-10-12.dat All ARCHIVE_VOLUME Note 2
Observe Start Time 2007-Oct-12 12:0:0 All TIMERANGE1 Note 3
Observe Stop Time 2007-Oct-12 18:0:0 All TIMERANGE2 Note 3
Object Search Field:
Object Name 3C120 All SOURCE_ID Target source name
Search Type NED Resolver SIMBAD then NED SRC_SEARCH_TYPE Note 4
Calibrator Src. Type All Srcs CALIB_TYPE All Srcs
Directed Search Field:
RA or Longitude 13:31:23.54 All CENTER_RA Note 5
DEC or Latitude 21:13:34.56 All CENTER_DEC Note 5
Coord Frame Ecliptic Equatorial FRAME Equatorial, Ecliptic or Galactic
Equinox B1950 J2000 EQUINOX J2000 or B1950
Search Radius 0.0 1.0 SRAD Note 6
Sensitivity and Resolution:
Min. Exposure 600.0 All MIN_EXPOSURE Time on source/freq/project (secs)
Image Sensitivity 10.0 All SENS Image rms (mJy/beam)
Image Resolution 0.1 All RESOL Restoring beam minor axis (arcsec)
Observing Configurations:
Telescope VLA All TELESCOPE VLA, VLBA, GBT (trace amounts)
Telescope Config. A, AB, BnA All TELESCOPE_CONFIG VLA array configurations
Telescope Subarrays 1,2 All SUBARRAY VLA, VLBA subarray id numbers
Observing Bands X,K,Q All OBS_BANDS Note 7
Observing Mode Line All OBS_MODE All, line or continuum
Correlator Mode 2AB All CORR_MODE VLA Correlator Mode
Polarization RR,LL pair All OBS_POLAR Note 8
Freq. Range Min. 1665.0 All OBSFREQ1 Frequency (MHz)
Freq. Range Max. 1668.0 All OBSFREQ2 Frequency (MHz)
BandWD Range Min. 12.5 All OBSBW1 Frequency (MHz)
BandWD Range Max. 50.0 All OBSBW2 Frequency (MHz)
Output Control Parameters
Query Return Type Obs. Scans Archive Files QUERYTYPE Note 9
Archive Data Type Raw Data All DATATYPE Note 10
Output Tbl Format VOTable HTML PROTOCOL HTML, VOTable, Text
Max Output Rows 1000 No Limit MAX_ROWS
Sort Order Col.1 Time On Src Starttime SORT_ORDER Note 11
Sort Order Col.2 Project Code Starttime SORT_ORDER2 Note 11

Notes

Reference Note
Note 1 Program Segment : Character code in range of A to ZZ. Program observing sessions separated by 12 hours have distinct segment codes.
Note 2 Archive File Name : The archive system is presented with many different file types from telescopes and processes. The file names are generated before the files are available to the archive, so the physical file names do not follow a unified convention. In order to the make the file names more understandable, we have created a logical file name : telescope/container/physical_filename. For files that were transfered from archive tapes, the container is the tape volume name and the file name is file_1, file_2..etc. For the past several years, the VLA has delivered daily raw data files to a staging area in the AOC. These files are logically named like : VLA/2007-10/vla2007-10-12.dat, where the container is a subdirectory for data from that month. Data files from AIPS processing are generally FITS files, and have unpredictable file names. The Archive File Name query element will resolve archive files by partial string matches. So for example, the VLA data file for Oct 12, 2007 may be found using a string segment like this : '2007-10-12'.
Note 3 Observe Start or Stop Times : Query parameters which return data, images or information that are entirely or partly within the specified time range. Dates and times currently must be entered in one format. Dates like : yyyy-mmm-dd (2007-Oct-10), times like : hh:mm:ss (10:45:30). The start/stop time parameters MUST contain a date, a time is optional. Test versions of the archive system now also support MJD.day_fraction (54385.44792).
Note 4 Search Type : You may request the query tool to search for a partial string match of object names in the archive, or let the system send the object name to the SIMBAD or NED Name Resolvers. The Search Type parameter offer several options : SIMBAD if no results followed by NED, NED if no results followed by SIMBAD, SIMBAD only, NED only. SIMBAD and NED return a RA, Dec (J2000) pair. In this case a cone search is initiated centered on the SIMBAD/NED position with a search radius using the Search Radius parameter.
Note 5 Search Longitude, Latitude : A search field on the sky may be explicitly specified. The query tool will return a list of images or observing scans whose reference position is inside the search field. The center of a search field is specified by longitude and latitude angles : RA, Dec in B1950 or J2000 frame (ecliptic longitude and latitude, or galactic or super-galactic latitudes and longitudes - Not Yet Implemented). The search radius may be set by specifying the radius parameter.

The entry format for RA, Dec, lontitude, latitude may be hours-mins-secs (12h30m25.5s, 12:30:25.5, 12 30 25.5), degrees-arcmins-arcsecs (21d35'18.5", 21:35:18.5, 21 35 18.5), or decimal degrees.

Note 6 Search Radius : The radius on the sky about a specified field center position in which all cataloged observations will be returned.

The entry format can be anyone of the following angle formats: 2d30'20.5" or simply 2 (degrees) or the default value 1.0' (arcminutes). An entry without units defaults to degrees. The maximum search radius is 45.0 degrees.

Automatically scalable search radius: A search radius on the sky whose radius is equal the the half-power angular radius of a VLA antenna primary beam. This radius is scalable with the inverse of the observing frequency. Archive data within this radius surrounding the observed sky position is considered usable.

The scaled search radii for the VLA are (freq_band/search_rad in arcmins) : 4/700.0, P/150.0, L/30.0, C/9.0, X/5.4, U/3.0, K/2.0, Q/1.0
For all VLBA observations, the scalable search radius is set to one arc-min.

Note 7 Observing Bands : The VLA and VLBA observing bands are : 4, P, L, S, C, X, U, K, Q
Note 8 Polarization search options :
RR, LL, RL, LR
RR, LL pair
RR or LL
RR only
LL only
All
Note 9 Query Return Types : Archive users and processes may select a type of tabular results
List of Downloadable Archive Data Files
List of Individual Observing Scans
Observing Scans Summary - Single rows of summed scans per project/source/frequency/subarray
List of Archive Image Files
List of Observing Projects
List of Observing Project Segments
Note 10 Archive Data Type(s) : All, Raw Data, Calibrated Data
Note 11 Output Sort Order : starttime, source_id, project_code, subarray_id, Stoptime, obs_bands, telescope_config, arch_file_name, vlba_job_number, time_on_source. The sort order may be ascending or descending.

-- JohnBenson - 16 Oct 2007

This topic: Main > TWikiUsers > JohnBenson > EVLAArchiveSearchParameters
History: r4 - 26 Jul 2007 - 19:44 - JohnBenson
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding NRAO? Send feedback