NAME

       astscript-sort-by-night - Sort input FITS files by night

SYNOPSIS

       astscript-sort-by-night [OPTION] FITS-files

DESCRIPTION

       This script is part of GNU Astronomy Utilities 0.11.

       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.

       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.

       Inputs/Outputs and options:
              $ info astscript-sort-by-night

       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

   astscript-sort-by-night options:
              Input:

       -h, --hdu=STR
              HDU/extension of all input FITS files.

       -k, --key=STR
              Header keyword specifying date to use.

       -H, --hour=FLT
              Hour in next day to be included in night.  Be aware of time zones with this argument!

              Output:

       -l, --link
              list of inputs with night and file number.

       -c, --copy
              Copy the files, don't make symbolic links.

       -p, --prefix=STR
              Prefix for outputs of '--copy' and '--link'.

              Operating mode:

       -h, --help
              Print this help list.

       --cite BibTeX citation for this program.

       -q, --quiet
              Don't print the list.

       -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: http://www.gnu.org/software/gnuastro/

REPORTING BUGS

       Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT

       Copyright © 2015-2019, 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

SEE ALSO

       The  full  documentation  for astscript-sort-by-night is maintained as a Texinfo manual.  If the info and
       astscript-sort-by-night programs are properly installed at your site, the command

              info astscript-sort-by-night

       should give you access to the complete manual.

GNU Astronomy Utilities 0.11                      November 2019                       ASTSCRIPT-SORT-BY-NIGHT(1)