TilingDetermination#

This is the documentation for the TilingDetermination module.

PGWinFoV#

tilepy.include.TilingDetermination.PGWinFoV(skymap, nameEvent, obspar, dirName)[source] [edit on github]

Mid-level function that is called by GetSchedule to compute a observation schedule based on a 2D method.

Parameters:

  • skymap (SkyMap) – The object containing the sky maps.

  • nameEvent (str) – The name of the event.

  • obspar (ObservationParameters) – Observation parameters, including: - obsTime (datetime): Desired time for scheduling to start. - pointingsFile (str): Path to file with previous pointings. - … (other parameters as needed) Class containing the telescope configuration parameters.

  • dirName (str) – Output directory for schedules and plots.

Returns:

  • SuggestedPointings (astropy.table.Table) – Table of scheduled pointings.

  • ObservationTime0 (str) – the desired time for scheduling to start.

PGalinFoV#

tilepy.include.TilingDetermination.PGalinFoV(skymap, nameEvent, galFile, obspar, dirName)[source] [edit on github]

Compute an observation schedule based on a 3D (galaxy-weighted) method.

This mid-level function is called by tilepy.include.observationschedule.GetSchedule() and produces a suggested schedule of pointings for the given observatory, using either the target galaxy strategy or the integrated galaxy probability strategy, depending on user input and the telescope field of view.

Parameters:

  • skymap (SkyMap) – The object storing sky maps.

  • nameEvent (str) – The name of the event.

  • galFile (str) – Path to the galaxy catalog.

  • obspar (ObservationParameters) – Telescope configuration parameters used in the scheduling.

  • dirName (str) – Path to the output directory where the schedules and plots will be saved.

Returns:

  • SuggestedPointings (astropy.table.Table) – Table of suggested pointings (with time, coordinates, probability, etc.).

  • tGals0 (astropy.table.Table) – Filtered and ranked list of galaxies for scheduling.

ObservationStartperObs#

tilepy.include.TilingDetermination.ObservationStartperObs(obsparameters, ObservationTime0)[source] [edit on github]

Compute the first observation time for each observatory involved in the scheduling.

This mid-level function is called by Nobs Tiling functions to determine the first available observation time for each observatory and whether each observatory can observe on the same night.

Parameters:

  • obsparameters (list of ObservationParameters) – A list of sets of parameters for each observatory needed to launch the tiling scheduler.

  • ObservationTime0 (sr) – The desired start time for scheduling to begin.

Returns:

  • obs_time (datetime) – The current observation time, possibly adjusted.

  • SameNight (numpy.ndarray of bool) – An array indicating whether each observatory is available for observation on the same night.

  • NewActiveObs (list of ObservationParameters) – A list of observatories that are available to observe.

  • NewActiveObsStart (numpy.ndarray of datetime) – A sorted list of the first available observation times for each observatory.

PGWinFoV_NObs#

tilepy.include.TilingDetermination.PGWinFoV_NObs(skymap, nameEvent, ObservationTime0, PointingFile, obsparameters, dirName)[source] [edit on github]

Compute an observation schedule for multiple telescopes/observatories based on a 2D method.

This mid-level function is called by GetSchedule (see tilepy.include.ObservationScheduler.GetSchedule()) and produces a suggested schedule of pointings for each observatory, given the input sky map, pointings already performed, and observation parameters.

Parameters:

  • skymap (SkyMap) – The object storing sky maps.

  • nameEvent (str) – The name of the event.

  • ObservationTime0 (str) – The desired start time for scheduling.

  • PointingFile (str) – Path to the text file containing pointings already performed before scheduling.

  • obsparameters (list of ObservationParameters) – Parameters for each observatory needed to launch the tiling scheduler.

  • dirName (str) – Path to the output directory where the schedules and plots will be saved.

Returns:

  • SuggestedPointings (astropy.table.Table) – Table of suggested pointings for all observatories.

  • obsparameters (list of ObservationParameters) – (Possibly updated) list of parameters for each observatory.

PGalinFoV_NObs#

tilepy.include.TilingDetermination.PGalinFoV_NObs(skymap, nameEvent, ObservationTime0, PointingFile, galFile, obsparameters, dirName)[source] [edit on github]

Compute the optimal observation schedule based on galaxy probability and gravitational wave data for multiple observatories.