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=value
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.
@filename
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.
-f
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)
-d
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.)
-h
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)
-k
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)
-l
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.
-m
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)
-n
Write to a new file, instead of overwriting the file. Make the name
of the new file by adding an e before the extension.
-rletter
If keywords being set are already present in the header, rename them
by prefixing letter.
(Added in version 2.4)
-sletter
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.
[WCSTools]
[WCSTools programs]