*********************** Tape Archiving Subdirectory ************************ >>>>>> File last modified on 02 Jan 1996 by Don Luttermoser, GSFC/ARC. This subdirectory contains procedures for reading and writing archival tapes for SOHO Coronal Diagnostic Spectrometer (CDS) data. In 1992, the SOHO Scientific Operations Working Group selected two standards for storing scientific data: the Standard Formatted Data Unit (SFDU) and the Flexible Image Transport System (FITS). FITS is a standard for formatting data into files in a computer-independent, self-describing fashion. Meanwhile, SFDU is a standard for documenting the contents and format of a data file, and for outlining the interdependencies of collections of files. There are two goals for developing the tape format for SOHO/CDS data: First, the tape must be written to associate SFDU labels and descriptors with the data files, and at the same time, allow the tape to be read in with standard FITS readers. Second, document the contents of the tape at the front of the tape, so that the specific data desired can be more rapidly retrieved. The procedures of this subdirectory handle both of these goals. The table below summarizes all of the procedures and supplementary data files needed for a tape archiving session. Run the IDL procedure DOC_LIBRARY to gain future information of each IDL procedure. If a procedure is identified as being called by XWINTAPE, then it is used only for the widget control program xwintape.pro. magtape.pro : The main tape driver procedure. sfdu_2fhd.pro : Extract the FITS header from the SFDU. Called by XWINTAPE. sfdu_bytes.pro : Set various byte size parameters used for SFDU tape I/O. Called by MAGTAPE. sfdu_fitshd.pro : Retrieve all primary FITS headers from disk files. Called by XWINTAPE. sfdu_fsize.pro : Ascertain the total bytes in the FITS files for tape I/O. Called by MAGTAPE. sfdu_getreg.pro : Get the filenames of the latest SFDU registration files. Called by MAGTAPE. sfdu_getreg.dat : Data file called by sfdu_getreg and contains the directory name where the registration files are kept. sfdu_help.pro : Return a detailed description of tape archiving. Called by XWINTAPE. sfdu_make.pro : Generate an SFDU header from the passed filenames. Called by MAGTAPE. sfdu_os.pro : Load the operating system information into variables. Called by both MAGTAPE and XWINTAPE. sfdu_qwidg.pro : Make XWINTAPE widgets sensitive or insensitive. Called by XWINTAPE. sfdu_read.pro : Read the SFDU file off of the tape and return the filenames found. Called by both MAGTAPE and XWINTAPE. sfdu_volhd.pro : Create a string array that contains the volume header text for an archive SFDU. Called by MAGTAPE. sfdu_write.pro : Write the SFDU file onto the tape. Called by MAGTAPE. soho_cds.logo : ASCII text file containing the SOHO/CDS logo used in the "untitled" upper text widget. Used by XWINTAPE. soho_lglogo.gif : GIF file containing the official SOHO logo and used in the "untitled" draw widget on DEC machines. Used by XWINTAPE. soho_smlogo.gif : GIF file containing the official SOHO logo and used in the "untitled" draw widget on Sun machines. Used by XWINTAPE. tapearch.tex : LaTeX file containing CDS Software Note #28: Tape Archiving Procedures for the SOHO/CDS. tapearch.ps : Postscript file of the above LaTeX file. unixdd.pro : FITS tape I/O using the Unix "dd" and "mt" commands. Called by MAGTAPE. xwinpic.pro : A procedure for making "hardcopies" of the XWINTAPE widget. xwinpic.ps : Postscript file containing the main XWINTAPE widget. xwinpic.eps : Encapsulated file containing the main XWINTAPE widget. xwintape.pro : Widget procedure that drives MAGTAPE. Beside these specific archiving procedures, MAGTAPE also makes use of the standard FITS I/O routines. These routines are located in the util/fits subdirectory and are summarized in the following table. fxtaperead.pro : Copy FITS files from tape to disk. fxtpio_read.pro : Copy FITS files from tape to disk -- internal routine for FXTAPEREAD. fxtapewrite.pro : Copy FITS files from disk to tape. fxtpio_write.pro : Copy FITS files from disk to tape -- internal routine for FXTAPEWRITE. These routines are in util/util: num2let.pro : Returns letters 'a', 'b', 'c', etc. from an input integer, i.e., 1, 2, 3, etc. This is needed for MAGTAPE when creating "short" filenames. rotpic.pro : Rotate a picture whose coordinates are described by separate x and y vectors. Called by REGISTER. These routines are in sci/data_handling/i_o/fits/cds: checkcdsfits.pro: Check to make sure that the FITS file is a valid cds FITS file -- checks the FITS header keywords against the SFDU registration files, array sizes, and array types (called by magtape.pro). Please note that magtape will not crash if if checkcdsfits does find an invalid CDS FITS file. It will warn you and ask if you would like to continue. validcdshead.pro: Checks that the FITS header is consistent with the SFDU registration files. Called by CHECKCDSFITS. validcdstype.pro: Creates a structure that contains information regarding the valid TYPES of columns in a CDS binary table FITS file. This information is then used in checkcdsfits. Called by CHECKCDSFITS. The following files have been added to (along with the SFDU registration files) directory data/sfdu. Note that thre encapsulated postscript files are needed for CDS Software Note #28: register.pro: Make the flow chart "View of the SOHO-CDS SFDU Registration Packets". register.cds: Data file required for the CDS version of the register.pro flow chart. register.ps: Postscript file generated from register.pro. register.eps: Encapsulated postscript file generated from register.pro. sfdu_info.tex: LaTeX file containing a description of the SFDU registration files (note that this text is also in CDS Software Note #28). sfdu_info.ps: The postscript file of the above LaTeX file. template.pro: Make the flow chart "View of the SOHO-CDS SFDU Product Template and Descriptions". template.cds: Data file required for the CDS version of the template.pro flow chart. template.ps: Postscript file generated from template.pro. template.eps: Encapsulated postscript file generated from template.pro.