.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH FIHEADER "1" "January 2021" "fiheader 0.9.4 (2021.01.24)" "User Commands"
.SH NAME
fiheader \- reading and manipulating FITS header keywords
.SH SYNOPSIS
.B fiheader
[\fI\,opions\/\fR] [\fI\,input\/\fR] [\fI\,-o|--output <output>\/\fR]
.SH DESCRIPTION
This program allows the user to read, set, alter or remove a set of values associated with the specified keywords from the primary header unit (a.k.a. simply "header") of a FITS image file.
.SH OPTIONS
.SS "General options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
Gives general summary about the command line options.
.TP
\fB\-\-long\-help\fR, \fB\-\-help\-long\fR
Gives a detailed list of command line options.
.TP
\fB\-\-wiki\-help\fR, \fB\-\-help\-wiki\fR, \fB\-\-mediawiki\-help\fR, \fB\-\-help\-mediawiki\fR
Gives a detailed list of command line options in Mediawiki format.
.TP
\fB\-\-version\fR, \fB\-\-version\-short\fR, \fB\-\-short\-version\fR
Gives some version information about the program.
.TP
\fB\-i\fR, \fB\-\-input\fR <image file>
Name of the input FITS image file.
.TP
\fB\-o\fR, \fB\-\-output\fR <image file>
Name of the output FITS image file (can be the same as the input image file).
.SS "Read keyword values:"
.TP
\fB\-g\fR, \fB\-\-get\fR, \fB\-\-read\fR <keyword>,...
List of keywords to get from FITS header.
.TP
\fB\-F\fR, \fB\-\-format\fR <format>
Format of the output, space separated list of the arguments "filename", "keyword", "value", "comment" or "list", in the desired order. The "list" here is a list of tab\-separated values of matched keywords.
.TP
\fB\-x\fR, \fB\-\-extension\fR <extension>
Read keyword values from the given extension.
.PP
Note that shell wildcard character patterns can be used in the keyword specifications.
.SS "Altering FITS headers:"
.TP
\fB\-s\fR, \fB\-\-set\fR, \fB\-\-update\fR <keyword>=<value>[/<comment>],...
List of keywords with their new values (and optional comments) to be altered.
.TP
\fB\-a\fR, \fB\-\-append\fR <keyword>=<value>[/<comment>],...
List of keywords with their new values (and optional comments) to be appended to the existing list of keywords.
.TP
\fB\-d\fR, \fB\-\-delete\fR <keyword>,...
List of keywords to be removed from the header.
.TP
\fB\-\-force\-alter\-reserved\-keywords\fR
Enable to alter reserved FITS keywords (use with caution).
.TP
\fB\-w\fR, \fB\-\-rewrite\fR
Re\-write the input file(s) directly. Use this option exclusively from \fB\-o\fR|\-\-output.
.SH "REPORTING BUGS"
Report bugs to <apal@szofi.net>, see also https://fitsh.net/.
.SH COPYRIGHT
Copyright \(co 1996, 2002, 2004\-2008, 2010\-2016, 2018\-2020; Pal, Andras <apal@szofi.net>