replacekey(1)

1replacekey(1)               General Commands Manual              replacekey(1)
2
3
4

NAME

6       replacekey - replace keywords in a FITS header
7

SYNOPSIS

9       replacekey [options] <in>
10

DESCRIPTION

12       replacekey  is  aimed  at replacing keywords in a FITS file's header by
13       new keywords provided by the user on the command-line.
14

ALGORITHM

16       The user can provide a new_keyword, an old_keyword, a value and a  com‐
17       ment.   first  searchs  for old_keyword if provided. If it finds it, it
18       replaces the associated card by  the  new  one  (new_keyword=value/com‐
19       ment).   If old_keyword is either not found or not provided, associated
20       card by the new one (new_keyword=value/comment).  new_keyword has to be
21       provided.
22
23       Examples:  You  want  to  change  the  value  of VALUE from 32 to 16 in
24       myfile.fits: % replacekey -k "VALUE" -v "16" myfile.fits
25
26       If you want to replace the card with the keyword OLD by "NEW =  3.14  /
27       This  is a usefull key" in myfile.fits: % replacekey -k "NEW" -v "3.14"
28       -c "This is a usefull key" -K "OLD" myfile.fits
29
30       If your do not care about the HISTORY cards you have in the header, and
31       want to replace the first one by VALUE=32, you would do:
32       % replacekey -k "VALUE" -v "32" -K "HISTORY" myfile.fits
33

OPTIONS

35       -k or --key key
36              To provide the new keyword.
37
38       -K or --old key
39              To provide the old keyword.
40
41       -v or --val val
42              To provide the new value.
43
44       -c or --com com
45              To provide the new comment.
46

FILES

51       Files shall all comply with FITS format
52

BUGS

54       Modifications  are  so far only possible in the main header, not in the
55       extensions.
56
57
58
59                                  28 Oct 1999                    replacekey(1)