fitshdr_edit(1)


 

NAME

fitshdr_edit - FITS-file headers interactive editor  

SYNOPSIS

fitshdr_edit [options] FITSfile_name  

DESCRIPTION

fitshdr_edit utility allows to modify FITS headers' lines interactively (FITS MultiExtentionsFiles included).
fitshdr_edit is just simple shell script around fitshdr utility. But this is more/less "traditional" interactive editor... with one significant limitation.
fitshdr_edit does not allow change size of existent header. If You are searching for such functionality, check fitshdr_expand man page.  

OPTIONS

--editor=EDITOR
Where EDITOR - alternative editor command. By default vi editor is used (see ENVIRONMENT below).
--help
Output a brief help message and exit.
--version
Print the version number of fitshdr_edit to standard output and exit.
--nobackups
Don't create backup file.
 

ENVIRONMENT

The variable EDITOR is used to specify the default value for the --editor option.
The TMPDIR variable is also supported.  

NOTES

Again... fitshdr_edit utility allows to modify existent FITS-headers' lines. It means, that You can't remove line from header! You can change it (substitute it by empty line, for example), but You can't remove!!!

If You'll try to remove (delete) one line in the header... the fitshdr_edit utility will accept such modified header... but as result this (removed) line will be not touched, simply!!!

For example, original header was:

. . .

560:CRDELT2 =                 21.0 / this is example
640:
720:HISTORY  header No.0: 1st history line 123456789012345678901234567
880:COMMENT  Sat Sep 25 21:17:34 CEST 2004 / by fitshdr_edit
. . .

but after editing we have, something like:

. . .

560:CRDELT2 =                 21.0 / comment was changed
640:
880:COMMENT  Sat Sep 25 21:20:43 CEST 2004 / by fitshdr_edit
. . .

In this case header's lines with offsets 560 and 880 will be changed, but line with offset 720 - does not! ...as well, as line with offset 640, but only because this line was not changed (empty line before and after editing).

More simple... don't remove FITS-header lines... and don't even touch "END" FITS-header line!  

DIAGNOSTICS

On success, zero is returned and non-zero, if an error occurred.  

SEE ALSO

fitshdr(1), fitshdr_expand(1)  

BUGS

Email bug reports to [email protected]. Be sure to include the word ``fitshdr_edit'' somewhere in the ``Subject:'' field.


NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ENVIRONMENT
NOTES
DIAGNOSTICS
SEE ALSO
BUGS

This document was created by man2html, using the manual pages.
Time: 13:56:38 GMT, December 10, 2010