These web services are the back-end of the MWA triggering system, described in detail Hancock et al, 2019 (https://ui.adsabs.harvard.edu/link_gateway/2019PASA...36...46H/EPRINT_PDF)
...
- freqspecs: A single MWA coarse channel selection specifier (eg '121,24' for 24 coarse channels centered on channel 121), or a JSON encoded list of several channel selection strings. If more than one is provided, multiple observations of each specified target location will be taken, for each frequency channel set provided (as well as one at each frequency for the post-observation calibrator, if specified). Defaults to '145,24'.
- creator: The name of the person or system generating this trigger - an arbitrary string. Defaults to 'djmwa/trigger'.
- freqres: Frequency resolution for the correlator, in kHz - must be one of the standard MWAX settings. Defaults to 10.0 kHz.
- inttime: Integration time for the correlator, in seconds - must be one of the standard MWAX settings. Defaults to 0.5 seconds.
- avoidsun: Boolean, integer, or string (eg 'y', 'n', etc) - if true, try to put the Sun in a beam null for each target location (except alt/az positions). Defaults to False.
- obsname: The name the observation to be inserted (another arbitrary string). Defaults to 'trigger'.
- exptime: The duration of each individual observation (for each observing target, at each frequency channel selection). Defaults to 120 seconds.
- nobs: The number of observations (for each observing target, at each frequency channel selection). The total observing time (if not using subarrays) will be nobs * (number of target locations) * (number of frequency specifiers) * exptime (not including calibrator observations). Defaults to 15 observations.
The structure returned is a JSON encoded dictionary, containing the following:
- result['success'] - a boolean, True if the observations were scheduled successfully, False if there was an error.
- result['errors'] - a dictionary, containing integer keys from 0-N, where each value is an error message. Normally empty.
- result['params'] - a dictionary containing all parameters passed to the web service, after parsing, and some extra parameters calculated by the web service (the name of the automatically chosen calibrator, etc).
- result['clear'] - the commands used to clear the schedule. It contains the keys/values:
- 'command': The full clear_schedule.py command line
- 'retcode': The integer return code from that command
- 'stderr': The output to STDERR from that command
- 'stdout': The output to STDOUT from that command
- result['schedule'] - the commands used to schedule the triggered observations. It contains the keys/values:
- 'command': A string containing all of the schedule_observation.py command lines
- 'retcode':The integer return code from the shell spawned to run those commands
- 'stderr': The output to STDERR from those commands
- 'stdout': The output to STDOUT from those commands