STScI Logo

stfhistory stsdas.toolbox.headers


NAME · USAGE · DESCRIPTION · PARAMETERS · EXAMPLES · BUGS · SEE_ALSO

NAME

stfhistory -- Read history information from a text file and add it to an image header.

USAGE

stfhistory input histtext

DESCRIPTION

The task reads text from a file (or from the keyboard, i.e., STDIN) and appends this text as HISTORY records to the image header specified by the input parameter. Each HISTORY record is made up of as many as 54 characters. Characters beyond the 54th are written to additional HISTORY records.

PARAMETERS

input [file name]
The input image to which HISTORY records are to be added.
histtext [string]
String to add as a history card. If the string begins with "@", then the rest of the string is taken as a file name which contains the text to be added. To read from standard input, you would specify "@STDIN".

EXAMPLES

1. Append the text in texthistory to the header file imagein.hhh as HISTORY records. If lines in texthistory exceed 54 characters, multiple HISTORY records will be created.

  to> stfhistory imagein.hhh @texthistory

2. Record the parameters from task rfindx in the header of the image file resim.hhh.

  to> lpar rfindx | stfhistory resim.hhh @STDIN

BUGS

SEE ALSO


Source Code · Package Help · Search Form · STSDAS