
csviscube
=========

Computes visibility cube for a given IACT array and time period.


Synopsis
--------

This script computes a visibility cube which is a sky cube spanned by Right
Ascension, Declination and zenith angle that provides the number of hours
that a given position on the sky is observable under a given zenith angle
by an IACT array during a given time period.

For the moment, the script takes into account a Sun constraint, specified as
a minimum zenith angle of the Sun for observations (hidden parameter sunzenith).
No Moon constraint has been implemented so far.

On output, the script will provide a FITS file containing the visibility cube.


General parameters
------------------

tmin [time]
    Start time of observation (UTC string, JD, MJD or MET in seconds).

tmax [time]
    Stop time of observation (UTC string, JD, MJD or MET in seconds).

(mjdref = 51544.5) [real]
    Reference Modified Julian Day (MJD) for MET.

geolon [real]
    Geographic longitude of the IACT array in degrees.

geolat [real]
    Geographic latitude of the IACT array in degrees.

(sunzenith = 105.0) [real]
    Minimum Sun zenith angle for observations in degrees.

(moonzenith = 90.0) [real]
    Minimum Moon zenith angle for observations in degrees.

outfile [file]
    Output visibility cube file.

(binsz = 1.0) [real]
    Visibility cube pixel size in degrees/pixel.

(dz = 1.0) [real]
    Visibility cube zenith angle bin size in degrees.

(zmax = 60.0) [real]
    Maximum zenith angle of the visibility cube in degrees.


Standard parameters
-------------------

(publish = no) [boolean]
    Specifies whether the visibility cube should be published on VO Hub.

(chatter = 2) [integer]
    Verbosity of the executable:
     chatter = 0: no information will be logged

     chatter = 1: only errors will be logged

     chatter = 2: errors and actions will be logged

     chatter = 3: report about the task execution

     chatter = 4: detailed report about the task execution

(clobber = yes) [boolean]
    Specifies whether an existing visibility cube file should be overwritten.

(debug = no) [boolean]
    Enables debug mode. In debug mode the executable will dump any log file output to the console.

(mode = ql) [string]
    Mode of automatic parameters (default is ql, i.e. "query and learn").

(logfile = csviscube.log) [filename]
    Log filename.


Related tools or scripts
------------------------

None
