Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
FITS(1)				 User Commands			       FITS(1)

       Fits - view and manipulate FITS headers

       astfits [OPTION...] ASTRdata

       Fits  is	part of	GNU Astronomy Utilities	0.12.  Fits allows you to view
       and manipulate (add, delete, or modify) FITS extensions (or  HDUs)  and
       FITS header keywords within one extension.

       For more	information, please run	any of the following commands. In par-
       ticular the second contains a very comprehensive	explanation of	Fits's
       invocation: expected input(s), output(s), and a full description	of all
       the options.

       All options and their values:
	      $	astfits	-P

       Inputs/Outputs and options:
	      $	info astfits

       Full section in manual/book:
	      $	info Fits

       Full Gnuastro manual/book:
	      $	info gnuastro

       If you couldn't find your answer	in the manual, you can get direct help
       from  experienced  Gnuastro users and developers. For more information,
       please run:

	      $	info help-gnuastro

       Fits options:


       -h, --hdu=STR/INT
	      Extension	name or	number of input	data.


       -K, --keepinputdir
	      Keep input directory for automatic output.

	      HDU/extension in output for --copykeys.

       -o, --output=STR
	      Output file name (only for writing HDUs).

	      HDUs (extensions):

       -C, --copy=STR
	      Copy extension to	output file.

	      Calculate	HDU's datasum and print	in stdout.

       -k, --cut=STR
	      Copy extension to	output and remove from input.

       -n, --numhdus
	      Print number of HDUs in the given	FITS file.

	      Copy/cut image HDUs to primary/zero-th HDU.

       -R, --remove=STR
	      Remove extension from input file.

	      Keywords (in one HDU):

       -a, --asis=STR
	      Write the	argument string	as is into the header.

       -c, --comment=STR
	      Add COMMENT keyword, any length is ok.

	      Range of keywords	to copy	to output HDU.

       -d, --delete=STR
	      Delete a keyword from the	header.

       -H, --history=STR
	      Add HISTORY keyword, any length is ok.

       -p, --printallkeys
	      Print all	keywords in the	selected HDU.

       -r, --rename=STR
	      Rename keyword, keeping value and	comments.

       -s, --datetosec=STR
	      FITS date	to sec from 1970/01/01T00:00:00

       -t, --date
	      Set the DATE keyword to the current time.

       -u, --update=STR
	      Update a keyword value or	comments.

       -v, --verify
	      Verify the CHECKSUM and DATASUM keywords.

       -w, --write=STR
	      Write a keyword (with value, comments and	units).

	      Operating	modes:

       -?, --help
	      give this	help list

	      List all config files and	variables read.

       --cite BibTeX citation for this program.

	      Read configuration file STR immediately.

	      Do not parse any more configuration files.

	      Minimum bytes in array to	not use	ram RAM.

	      Only run if the program version is STR.

       -P, --printparams
	      Print parameter values to	be used	and abort.

       -q, --quiet
	      Only report errors, remain quiet about steps.

	      Don't print mmap'd file's	name and size.

       -Q, --quitonerror
	      Quit if there is an error	on any action.

       -S, --setdirconf
	      Set default values for this directory and	abort.

	      give a short usage message

       -U, --setusrconf
	      Set default values for this user and abort.

       -V, --version
	      print program version

       Mandatory or optional arguments to long options are also	 mandatory  or
       optional	for any	corresponding short options.

       GNU  Astronomy  Utilities home page:

       Report bugs to

       Copyright  (C)  2015-2020,  Free	 Software  Foundation,	Inc.   License
       GPLv3+: GNU General public license version 3 or later.
       This  is	 free  software:  you  are free	to change and redistribute it.
       There is	NO WARRANTY, to	the extent permitted by	law.

       Written/developed by Mohammad Akhlaghi

       The full	documentation for Fits is maintained as	a Texinfo manual.   If
       the  info  and  Fits  programs are properly installed at	your site, the

	      info Fits

       should give you access to the complete manual.

GNU Astronomy Utilities	0.12	   May 2020			       FITS(1)


Want to link to this manual page? Use this URL:

home | help