FAST Spectrograph TDC home page

FAST Spectrograph

Data Directories
Jessica Mink, 2023-May-9

 FAST Spectrum
[TDC Home] [TDC Search] [OIR Home]

[Observation] [Quicklook)] [IRAF Pipeline] [Archive]

FAST Data Processing

Not every FAST spectrum is in all of these directories

(All directories are relative to the FAST home directory)

FAST 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. frll lists the contents of this directory.
frcd makes this the working directory.
flog makes a local log file.
fsort sorts raw data by configuration into ared/[yyyy/yyyy.mmdd]/.
ared/
Working reduction directory with 2-D database 		Contains reduced data in year directories from 2005 to the present, which include the FAST 2-D archive, and the FAST 2-D database ared/fast2d.tab for wavelength-aligned reduced object 2-D unextracted spectra. cdw makes this the working directory. fastsearch -2 reads from the 2-d spectrum database.
ared/[yyyy]/[yyyy.mmdd]
Working reduction directory for one night 		Contains links to all FITS file in configuration subdirectories: raw, 2-D, and extracted.
fwll lists the contents of this directory.
fwcd makes this the working directory.
fsort sorts raw data by configuration from araw/[yyyy.mmdd]/.
ared/[yyyy]/[yyyy.mmdd]/B[binning]D[dispersion]T[tilt]A[aperture]
Working reduction directory for one configuration on one night 		Data files are transferred here for processing. Observation parameters cn be checked by fasthead and modified using sethead -x 0 [files] [keyword]=[newvalue] Bad data files can be manually transferred to the Bad data directory. IRAF CL tasks fastpack.roadrunner and fastpack.beepbeep (or fastpack.beepstar) do all of the calibration, extraction, and redshift analysis in this directory. fsort copies raw data from transfer directory.
fasthead lists parameters of FITS files in directory
sethead -x 0 sets header parameters if they need to be changed
roadrunner ;gt;amp road.log creates wavelength aligned 2-D FITS files
wroadlog follows log file written by roadrunner
beepbeep extracts, cross-correlates, qplots, and archives spectra
ared/[yyyy]/[yyyy.mmdd]/B[binning]D[dispersion]T[tilt]A[aperture]/Bad
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.
arch/
1-D spectra archive directory with 1-D database 		This is where reduced 1-D FAST spectra are archived. Subdirectories for each night of data and entries for the archive database are created by fastarc after spectra are extracted, cross-correlated, and checked using beepbeep or beepstar cda makes this the working directory
arch/[yyyy/[yyyy.mmdd]/
1-D Archive directory for one night 		One FITS file per specrum for one night, linked to spectra in configuration subdirectories for each configuration observed that night. fastarc moves 1-D spectra from the working configuration directory and links them from this directory
fall lists contents of one night's archive directory
facd makes this the working directory
arch/[yyyy]/[yyyy.mmdd]/B[binning]D[dispersion]T[tilt]A[aperture] Data files are transferred here for processing. Observation parameters fastarc moves 1-D spectra from the working configuration directory and to appropriate archive configuration directory
fbll lists contents of archive configuration directories for one night
dist/fast1d/Prog[program]/[yyyy.mmdd]
Distribution directory for night of program of 1-D data 		Files for distribution for one observing program number for one night moved from arch/yyyy/yyyy.mmdd by fastdist. fastdist copies 1-D reduced *.ms.fits FITS from the arch/yyyy/yyyy.mmdd archive directory into each appropriate program directory and makes commands to run the appropriate distribution script.
dist/fast2d/Prog[program]/[yyyy.mmdd]
Distribution directory for program and night of 2-D data 		Files for distribution for one observing program number for one night moved from arch/yyyy/yyyy.mmdd by fastdist. fastdist copies 2-D reduced *TF.fits FITS files from the ared/yyyy/yyyy.mmdd archive directory into each appropriate program directory and makes commands to run the appropriate distribution script.
Comments
  • The f[a|r|w]** commands above assume last night if no argument
  • All of the f[a|r|w]** 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.
  • f[a|r|w|c|b|g|l]** help briefly describes the command and arguments.