TRES Spectrograph
Archive Search Software
Jessica Mink, 2013-Aug-26

[Observation] [Quicklook)] [IDL Pipeline)] [Reduction (Software) [Archive]

Only authorized users have access to the full archives of both raw and reduced data from the TRES spectrograph. Knowledge of how to see those results is embedded in the tresearch script, which can be used to list results, as well as full paths to the spectra, raw images, and Postscript reduction summaries.

All searches are carried out using sky position, right ascension and declination, and it is assumed to be J2000. If you search for an object by name, tresearch looks for that name within the TRES database and uses the position of the first match. If it is not found, an attempt is made to match the object name using the SIMBAD name resolver. Moving objects which start with AST, named solar system objects, and SKY's are searched by name and ignored in position searches.

$ tresearch
tresearch: Find entries for objects in the TRES database
          Version 1.2 by Jessica Mink, SAO-TDC, August 7, 2013
          Usage: tresearch [-v][-f][-r][-c catalog] object1 object2 ...
                 tresearch [-v][-f][-r][-c catalog]
                 @object.name.list.file
                 tresearch [-v][-f][-r][-c catalog] hh:mm:ss.ss
                 dd:mm:ss.ss
                 -c Catalog: Read from this catalog of reduced spectra
                 [/data/tres/reduced/tres.db]
                 -f: list object File names only
                 -n: No column headers
                 -p: search for plotted results
                 -r: search for Raw data
                 -s: set search radius in degrees (default is 0.01)
                 -v: list object names as they are checked

Example 1. Search for results including spectrum and best template

$ tresearch vega | head -5
object  	hjd          	ra        	dec      	rv      	s/n  	exp  	prog	pi    	ver	filepath                                    	template                            
--------	-------------	----------	---------	--------	-----	-----	----	------	---	--------------------------------------------	-------------------------------------
HD172167	2454995.98744	18:36:56.34	+38:47:01.3	 -13.010	805.5	  18.0	22	All	2.4	/home/tres/tred/2009-06-12/HD172167_2009-06-13_11h37m19s_cb.spec.fits	t09750g40p00ap00k2v025z1i00.fits
alpLyr	2455143.54168	18:36:56.19	+38:46:58.8	 -12.994	1219.3	  30.0	0	All	2.4	/home/tres/tred/2009-11-07/alpLyr_2009-11-08_01h01m27s_cb.spec.fits	t09750g45p00ap00k2v025z1i00.fits
alpLyr	2455143.55484	18:36:56.19	+38:46:58.8	 -13.090	311.4	   2.0	0	All	2.4	/home/tres/tred/2009-11-07/alpLyr_2009-11-08_01h20m20s_cb.spec.fits	t09750g40p00ap00k2v025z1i00.fits

where

Column	Content
`object`	the object used for this observation
`hjd`	the heliocentric Julian Date for the middle of this observation
`ra`	the right ascension of the object in J2000 coordinates.
`dec`	declination of the object in J2000 coordinates.
`rv`	the radial velocity in kilometers per second
`s/n`	the signal-to-noise of the order used for the radial velocity
`exp`	the total exposure time for this spectrum in seconds
`prog`	the TRES program number from this list
`pi`	the principal investigator for this program.
`ver`	the version of the IDL pipeline used to reduce this data
`filepath`	the full path to the file containing this reduced spectrum
`template`	the name of the template file which cross-correlated best with this spectrum

Example 2. Search for results listing only object spectra

$ tresearch -f vega | head -5
/home/tres/tred/2009-06-12/HD172167_2009-06-13_11h37m19s_cb.spec.fits
/home/tres/tred/2009-11-07/alpLyr_2009-11-08_01h01m27s_cb.spec.fits
/home/tres/tred/2009-11-07/alpLyr_2009-11-08_01h20m20s_cb.spec.fits
/home/tres/tred/2009-11-09/alpLyr_2009-11-10_01h04m46s_cb.spec.fits
/home/tres/tred/2009-12-02/HD172167.A0V_2009-12-03_00h38m55s_cb.spec.fits

Example 3. Search for results listing only Postscript summary files

$ tresearch -p vega | head -5
/data/tres/reduced/mink/2009-06-12/classifications/HD172167.classify.TR.54995.98744.ps
/data/tres/reduced/mink/2009-11-07/classifications/alpLyr.classify.TR.55143.54168.ps
/data/tres/reduced/mink/2009-11-07/classifications/alpLyr.classify.TR.55143.55484.ps
/data/tres/reduced/mink/2009-11-09/classifications/alpLyr.classify.TR.55145.54373.ps
/data/tres/reduced/mink/2009-12-02/classifications/HD172167.A0V.classify.TR.55168.52502.ps

Example 4. Search for rawdata files

$ tresearch -r vega | head -7
catalog	TRES observed object spectra
rasort	no
id          	ra        	dec        	mjd         	exp	size	bin	prog	object    	filename
-------------	----------	-----------	------------	------	----	---	------	----------	----------------------------------
20090612.0198	18:36:56.34	+38:47:01.3	54995.484248	5.0	2.3	2	22	HD172167	/data/tres2/TRES/rawdata//2009.0612/0198.HD172167.fits
20090612.0199	18:36:56.34	+38:47:01.3	54995.484514	5.0	2.3	2	22	HD172167	/data/tres2/TRES/rawdata//2009.0612/0199.HD172167.fits
20090612.0200	18:36:56.34	+38:47:01.3	54995.48478	5.0	2.3	2	22	HD172167	/data/tres2/TRES/rawdata//2009.0612/0200.HD172167.fits

where

Column	Content
`id`	the reduced file number as yyyymmdd.ssss
`ra`	the right ascension of the object in J2000 coordinates.
`dec`	declination of the object in J2000 coordinates.
`hjd`	the Modified Julian Date for the middle of this observation
`exp`	the exposure time for this observation in seconds
`size`	the aperture size in arcseconds
`bin`	the number of rows from the chip per row in this image
`prog`	the TRES program number from this list
`object`	the object name used for this observation
`filename`	the full path to the file containing this raw spectrum image

Example 5. Search for results including spectrum with blaze function removed and best template

Note the subtle change in pathname; these spectra are in the b/ sub directory.

$ tresearch -b vega | head -5 
object  	hjd          	ra        	dec      	rv      	s/n  	exp  	prog    pi    	ver	filepath                                    	template
--------	-------------	----------	---------	--------	-----	-----	----	------	---	--------------------------------------------	-------------------------------------
HD172167        2454995.98744   18:36:56.34     +38:47:01.3     -13.01  805.5   18.0    22      All     2.4	/home/tres/tred/2009-06-12/b/HD172167_2009-06-13_11h37m19s_cb.spec.fits    t09750g40p00ap00k2v025z1i00.fits
alpLyr  2455143.54168   18:36:56.19     +38:46:58.8     -12.994 1219.3  30.0    0       All     2.4	/home/tres/tred/2009-11-07/b/alpLyr_2009-11-08_01h01m27s_cb.spec.fits   t09750g45p00ap00k2v025z1i00.fits
alpLyr  2455143.55484   18:36:56.19     +38:46:58.8     -13.09  311.4   2.0     0       All     2.4	/home/tres/tred/2009-11-07/b/alpLyr_2009-11-08_01h20m20s_cb.spec.fits   t09750g40p00ap00k2v025z1i00.fits

Example 6. Search for results listing only object spectra with blaze function divided out