NAME

       callisto-sunschedule - Filter an e-Callisto schedule file

SYNOPSIS

       callisto-sunschedule configfile [ margin ]

DESCRIPTION

       This  helper  program  filters a base callisto(1) schedule, read from standard input, so that callisto is
       recording only when the Sun is up. The filtered  schedule  is  printed  to  standard  output.  The  first
       argument  to  the program is the callisto configuration file, from which the geographical coordinates and
       focuscode are read.

       If there is a second argument to the program, it is the number of seconds that the day is  extended  from
       both ends. The sunrise and sunset times actually computed are those for the UTC date in question, not the
       next  ones. This will cause a small error, especially when the daylength is changing fast, and the margin
       argument can be used to compensate for this. Five or ten minutes (300 or 600 seconds) should  be  a  good
       value for this.

       Only  schedule  entries  with  the  same  focuscode  as  in  the configuration file are ever printed. The
       filtering inserts a start action at sunrise, if the base schedule indicates that recording should  be  on
       at  that  time,  and a stop action at sunset. Base schedule entries in the sunrise-to-sunset timespan are
       all printed. Only entries with the overview action are printed in the sunset-to-sunrise timespan.

       The sunrise and sunset times are computed with the Emacs calendar, so Emacs needs to be installed to  use
       this program. See the comments at the start of the script for the rationale.

AUTHOR

       Juha Aatrokoski <jha@kurp.hut.fi>

SEE ALSO

       callisto(1)

callisto                                           March 2011                            CALLISTO-SUNSCHEDULE(1)