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.23.

       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:

       -?, --help
              Print this help list.

       --cite BibTeX citation for this program.

       -q, --quiet
              Don't print any extra information in stdout.

       -V, --version
              Print program version.

       --stdintimeout
              Micro-seconds to wait for standard input (used for operations within this script).

       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-2024 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.23                        July 2024                         ASTSCRIPT-SORT-BY-NIGHT(1)