IRAF help page for package dataio, program t2d

from NOAO t2d -- copy files from tape to disk quicklyUSAGEPARAMETERSDESCRIPTIONEXAMPLESSEE ALSO

t2d -- copy files from tape to disk quickly


USAGE

t2d input ofroot


PARAMETERS

input

Tape file or device name, e.g. "mta1600[1]" or "mta"

files

List of tape file numbers or ranges delimited by commas, e.g. "1-3,5-8". `Files' is requested only if no file number is given in `input'. Files will be read in ascending order, regardless of the order of the list. Reading will terminate if EOT is reached, thus a list such as "1-999" may be used to read all the files on the tape.

ofroot

Root name to give output files. A three digit sequence number will be appended to this root name for each file written if a file list is used. If the file number is specifically given in the 'input' parameter, the output file will be named this root without an appended sequence number.

verbose = yes

Flag to signal program that it should produce verbose output. This means progress reports.

errignore = yes

Flag to signal program that tape records that give read errors should be considered to have zero length. If set to 'no', error records are considered to be the same length as all the other records on the tape.


DESCRIPTION

T2d reads files from tape and puts them into disk files. No formating is performed so the bits and bytes are in the same order on disk as they were on tape. The program uses double buffering and asynchronous i/o to speed things up as much as possible.

When read errors are encountered one of two things can happen. Depending on the value of the parameter 'errignore', the error record is either thrown out or considered valid data. If 'errignore' is 'no' when an error is found, the input buffer is validated to the most recent 'good record' length and written to disk. If 'errignore' is 'yes' when an error is found, the the input buffer is disposed of for that record.


EXAMPLES

1. To read the second image from mta at 1600 bpi, store the image into "image" and see verbose output the command would be:

	cl> t2d mta1600[2] image

2. To read all the files on mtb at the default speed of 1600 bpi and put the disk files in root001, root002, root003, etc. and turn off verbose output, the command would be:

	cl> t2d mtb root v-

The program will prompt the user and ask for the list of files to be read to which the response would be "1-999".


SEE ALSO

reblock,


This page automatically generated from the iraf .hlp file. If you would like your local iraf package .hlp files converted into HTML please contact Dave Mills at NOAO.

dmills@noao.edu