.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.17.
.TH ASTSCRIPT-SORT-BY-NIGHT "1" "January 2021" "GNU Astronomy Utilities 0.14" "User Commands"
.SH NAME
astscript-sort-by-night \- Sort input FITS files by night
.SH SYNOPSIS
.B astscript-sort-by-night
[\fI\,OPTION\/\fR] \fI\,FITS-files\/\fR
.SH DESCRIPTION
This script is part of GNU Astronomy Utilities 0.14.
.PP
This script will look into a HDU/extension for a header keyword in the
given FITS files and interpret the value as a date. The inputs will be
separated by "night"s. The definition a "nights" is set with the '\-\-hour'
option (just note that the FITS time may be recorded in UTC, not local
time)! It will then print a list of all the input files along with the
following two columns: night number and file number in that night (sorted
by time). With '\-\-link' a symbolic link (one for each input) will be made
with names including the night classifier. With '\-\-copy' instead of a link,
a copy of the inputs will be made.
.PP
For more information, please run any of the following commands. In
particular the first contains a very comprehensive explanation of this
script's invocation: expected input(s), output(s), and a full description
of all the options.
.TP
Inputs/Outputs and options:
$ info astscript\-sort\-by\-night
.TP
Full Gnuastro manual/book:
$ info gnuastro
.PP
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:
.IP
\f(CW$ info help-gnuastro\fR
.SS "astscript-sort-by-night options:"
.IP
Input:
.TP
\fB\-h\fR, \fB\-\-hdu\fR=\fI\,STR\/\fR
HDU/extension of all input FITS files.
.TP
\fB\-k\fR, \fB\-\-key\fR=\fI\,STR\/\fR
Header keyword specifying date to use.
.TP
\fB\-H\fR, \fB\-\-hour\fR=\fI\,FLT\/\fR
Hour in next day to be included in night.
Be aware of time zones with this argument!
.IP
Output:
.TP
\fB\-l\fR, \fB\-\-link\fR
list of inputs with night and file number.
.TP
\fB\-c\fR, \fB\-\-copy\fR
Copy the files, don't make symbolic links.
.TP
\fB\-p\fR, \fB\-\-prefix\fR=\fI\,STR\/\fR
Prefix for outputs of '\-\-copy' and '\-\-link'.
.IP
Operating mode:
.TP
\fB\-h\fR, \fB\-\-help\fR
Print this help list.
.TP
\fB\-\-cite\fR
BibTeX citation for this program.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Don't print the list.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print program version.
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.PP
GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/
.SH "REPORTING BUGS"
Report bugs to bug\-gnuastro@gnu.org.
.SH COPYRIGHT
Copyright \(co 2015\-2021, Free Software Foundation, Inc.
License GPLv3+: GNU General public license version 3 or later.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.PP
Written/developed by Mohammad Akhlaghi
.SH "SEE ALSO"
The full documentation for
.B astscript-sort-by-night
is maintained as a Texinfo manual.  If the
.B info
and
.B astscript-sort-by-night
programs are properly installed at your site, the command
.IP
.B info astscript-sort-by-night
.PP
should give you access to the complete manual.