TRES spectra

TRES Spectrograph Data Directories
Jessica Mink, 2023-April-24
Telescope Data Center

TRES ThAr Image
[TDC Home] [TDC Search] [OIR Home]

[Observation] [Quicklook)] [IDL Pipeline] [Archive]

[TRES Data Processing] [Raw Data Keywords] [Reduced Data Keywords]

Not every TRES spectrum is in all of these directories

(All directories are relative to the TRES home directory)

TRES Data Directory

Data in Directory

Commands

araw/[yyyy.mmdd]/
Raw transfer directory from telescope for one night 		Directory into which data files are transferred from one night at the telescope. The data is synced to the mountain, but it is never changed at the Cambridge end because changes will be lost when the directories are next synced to Mt. Hopkins. tsync copies contents of /tres/[yyyy.mmdd]>/ from flw60 to CfA.
tall lists the contents of this directory.
tacd makes this the working directory.
traw/
Raw working directory with raw databases 		Contains raw data in year directories from 2009 to the present and databases traw/tresraw.tab for all raw data and traw/tresrawobj.tab raw object data. Information here is created by trcp after raw data files for a night are copied, but new year directories must be created by hand. cdr makes this the working directory. tresearch -r reads from the raw data databases.
traw/[yyyy]/[yyyy.mmdd]/
Raw fixed directory for one night 		Data files are transferred here before processing. Observation parameters can be modified using sethead -x 0 [files] [keyword]=[newvalue] telescope. RFN keywords are added so reduced spectra include raw source information. Bad data files are transferred to the Bad data directory. trcp copies raw data from transfer directory.
trll lists the contents of this directory.
trcd makes this the working directory.
traw/[yyyy]/Bad/[yyyy.mmdd]/
Unusable raw data from one night 		Data files containing spectra of unknown stars or which are bad for other reasons are moved to this directory so they are not processed by the pipeline.
tred/
Working reduction directory 		This is were TRES spectra are reduced and archived. A subdirectory for each night of data is created by treduce. Classifications are updated after spectra are checked with tplot1 and tplotn by reclass. Databases for spectra (tred/tres.db) and Postscript results (tred/tresps.db are updated by trecue and reclass. cdw makes this the working directory
tred/[yyyy-mm-dd]/
Working reduction directory for one night 		51 orders of spectra per FITS file and results in a classifications/ subdirectory for each night of data are created by treduce. Classifications are updated after spectra are checked with tplot1 and tplotn by reclass.a Databases for spectra (tred/tres.db) and Postscript results (tred/tresps.db are updated by treduce and reclass. This directory serves as the archive for final versions of the object spectra for one night, plus tables of files and results. treduce reduces TRES specra from 2-D image to stacked 1-D spectra.
treclass reclassifies spectra after repairs
twll lists the contents of this directory.
twcd makes this the working directory.
tws lists the resulting FITS files by observation sequence number.
twf lists the resulting FITS files alphabetically by object name.
tred/[yyyy-mm-dd]/b
Working Directory spectra with blaze removed. 		Processing pipeline blaze-removed final versions of the object spectra FITS files created by treduce [yyyy-mm-dd] and updated by treclass [yyyy-mm-dd]. tresearch -b returns files from this directory.
tred/[yyyy-mm-dd]/classifications
Working directory classification results 		Processing pipeline classification process (.log), result (.txt), and Postscript (.ps), created by treduce
The files in this directory are replaced when treclass is run. 		twp lists the classification Postscript results by object name.
tcp lists the classification Postscript results by time.
tccd makes this the working directory.
tred/Back/[yyyy-mm-dd]back
Backup analysis results directory 		Backup copy of processing pipeline results with object spectra and tables before large cosmic rays and detector defects are removed. treduce copies the entire contents of the date's working directory to this one after reduction is complete.
tbll lists the contents of this directory.
/data/tfop/tres_lsd_reduced/[yyyy-mm-dd] Results from TRES lsdanalysis Results from the TRES lsdanalysis program for one night created by tlsd [yyyy-mm-dd]. Up to 10 spectra are analyzed at a time in separate threads at, and on our current fastest computer, this takes a bit over an hour. tlll lists the contents of this directory.
tlcd makes this the working directory.
tred/[yyyy-mm-dd]/LSD
Archived results from one night of lsdanalysis 		Archived results from one night's TRES lsdanalysis Python progam with a separate file summarizing results for TESS objects. tlsd creates and fills this directory after it is done with analysis
/data/tres/python/forAllyson/results/
Results from TRES supermulti analysis 		All results from TRES supermulti multiple-order analysis of red stars tsm puts PDF results for each spectrum in inone_pdfs/ subdirectory and tabulates results in to_uploads.txt subdirectory
tred/[yyyy-mm-dd]/SM
Archived results from one night of supermulti analysis
Archived results from one night's spectra analyzed TRES supermulti Python progam including graphed and tabulated data. tsm copies results for one night from results/ directory above.
Comments
  • The t[a|r|w|c|b|l]** commands above assume last night if no argument
  • All of the t[a|r|w|c|b|l]** commands above can be run for a specific date with a date argument as yyyy-mm-dd or yyyy.mmdd even though the format of the date in the target directory may be either.
  • t[a|r|w|c|b|l]** help briefly describes the command and arguments. 
> tacd
/home/tres/araw/2023.0503
> trcd
/home/tres/traw/2023/2023.0503
> twcd
/home/tres/tred/2023-05-03
> tccd
/home/tres/tred/2023-05-03/classifications
> tbcd
/home/tres/tred/Back
> 
> tlcd
/data/tfop/tres_lsd_reduced/2023-05-03