Command Line Arguments

Name of IRAF image header file or FITS file. At least one of these must be present for any values to be set. File names must have the extension .imh for either version 1 or version 2 IRAF files or be legal FITS files. If a wild card expands into more than the allowed maximum number of files, 1000 as distributed, a message is printed and excessive files are ignored. This limit can be changed using the -f command.
Keyword names may be entered in either upper or lower case; they will be automatically translated to upper case by the program. Each keyword should be followed by an equal sign and the value to which it is to be set, with no intervening spaces. Values which are all numeric are assumed to be numbers and are aligned as such within the header. If using the -d command, the =value portion should be omitted.
/ comment
Add this comment to the corresponding keyword, which may or may not have a value attached. Comments are matched to keywords sequentially; i.e. the first comment is added to the first specified keyword, so if you change some keyword values without adding comments, you have to put those after all of the keywords for which there are comments. With -s _, you can separate the words in the comment with _'s instead of putting quotes around them, a feature I added to make scripting cleaner.
Name of a file listing image file names (IRAF image header files and/or FITS files) or keyword assignments. If the first line of the list file is a FITS or IRAF image file, the list file is assumed to contain image file names, and any other file names on the command line will be ignored. If the first line is not an image file, this list file is assumed to contain keyword=value assignments, one per line. No more than two list files, one of images and one of keyword assignments, are allowed on a single sethead command line. Note that all keyword assignments in a file are applied to all images processed, whether they be from the command line or from a list file.
Reset the maximum number of files which can be read from the command line. This is useful if a wildcard is being used to change a directory or directories full of FITS or IRAF files and there are more than the default limit of 1000. If there are more than the limit, the program processes all of the files up to the limiting number, then skips the rest and prints an error message telling how many files it skipped. (Added in version 2.6, dropped in 2.6.4)
Replace keyword values which are date strings in the old FITS format, dd/mm/yy with their ISO 8601 (post-Y2K FITS standard, yyyy-mm-dd) equivalent. No action is taken if the keyword does not exist. (This was never needed as date-valued keywords are automatically recognized and updated to the ISO 8601 format if there is no new value specified. It was dropped entirely from the program in version 2.7.4.)
Add a HISTORY line to the header noting the version of sethead, the current date and time, and the keywords whose values are set. If there are too many keywords to fit on one line, extra HISTORY lines are added tothe header to acommodate them. (Added in version 2.4)
Add a SETHEAD keyword to the header with the value being a string noting the version of sethead, the current date and time, and the keywords whose values are set. If there are too many keywords to fit on one line, later keywords are omitted from the list. (Added in version 2.4)
List names of files which have been processed to STDERR. This is useful to keep track of progress if you are changing the same keywords in a lot of files using @filelist.
Reset the maximum number of keyword names which can be read from the command line. This is useful if the MAXKWD parameter in sethead.c is set to a small number and the values of more keyword need to be listed. (Added in version 2.6, dropped in 2.6.4)
Write to a new file, instead of overwriting the file. Make the name of the new file by adding an e before the extension.
-r letter
If keywords being set are already present in the header, rename them by prefixing letter. (Added in version 2.4)
-s letter
Replace letter in input strings with a space before inserting the string into the header as a keyword value or comment. This makes scripting value and comment and history strings much easier, because you don't have to worry about quotation marks getting passed to the shell.
Print more information about process.

Last updated 19 May 2014 by Jessica Mink

Telescope Data Center [WCSTools] [WCSTools programs]