ASTSCRIPT-SORT-BY-NIGHT(1)

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

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 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-2021, 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.