Scheduling and Tiling Tools#

About this package

The tilepy.include package provides core modules for scheduling, tiling computation, and visualization in the tilepy workflow. It enables rapid follow-up observations, campaign configuration, and plotting for multi-messenger astronomy.

Read Skymap#

Provides classes and utilities for reading and interpreting localization skymaps.

tilepy.include.MapManagement.SkyMap Module#

Classes#

SkyMap(obspar, mapReader)

Representation and utility methods for gravitational-wave localization sky maps.

Observatories#

Defines the main ground- and space-based facilities supported in the tilepy workflow, including location, field of view, and technical constraints for each telescope.

tilepy.include.Observatories Module#

Classes#

HESSObservatory()

Coordinates and basic information for the H.E.S.S.

LST()

Coordinates and description for the Large-Sized Telescope (LST), CTAO.

CTASouthObservatory()

Coordinates and site information for the CTAO-South Observatory.

CTANorthObservatory()

Coordinates and location for the CTA North Observatory.

Observatoire Configuration#

tilepy.include.CampaignDefinition Module#

Functions#

set_gaussian_source(obspar, ra, dec, sigma)

Configure an ObservationParameters instance to use a simulated Gaussian probability map.

Classes#

ObservationParameters([obs_name, ...])

Stores all the configuration parameters from the .ini file

Tiling Determination#

Functions to compute tiling observation schedules for one or multiple observatories, using 2D/3D probability maps and considering constraints.

tilepy.include.TilingDetermination Module#

Functions#

PGWinFoV(skymap, nameEvent, obspar, dirName)

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

PGalinFoV(skymap, nameEvent, galFile, ...)

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

ObservationStartperObs(obsparameters, ...)

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

PGWinFoV_NObs(skymap, nameEvent, ...)

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

PGalinFoV_NObs(skymap, nameEvent, ...)

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

PGWinFoV_Space_NObs(skymap, nameEvent, ...)

Compute an observation schedule for space-based observatories using a 3D method.

Observation Scheduling#

Algorithms and utilities to schedule rapid follow-up observations, generate visibility plots, and support coordination.

tilepy.include.ObservationScheduler Module#

Functions#

GetSchedule(obspar)

Generates a tiling schedule and visibility plots for a single telescope.

GetUniversalSchedule(obspar)

Generates tiling schedules and visibility plots for multiple telescopes/observatories.

Ranking Observation Times#

Tools to rank observations by probability covered, adding the observability window for a comprehensive view.

tilepy.include.RankingObservationTimes Module#

Functions#

LoadPointingFile(tpointingFile)

Load pointings from a file.

VisibilityWindow(ObservationTime, Pointing, ...)

Compute visibility windows and zenith angles for each pointing.

GetObservationPeriod(inputtime0, msource, ...)

GetVisibility(time, radecs, maxZenith, obsLoc)

ProbabilitiesinPointings3D(cat, galPointing, ...)

PGGPGalinFOV(cat, ra, dec, prob, totaldPdV, ...)

ProbabilitiesinPointings2D(Pointing, FOV, ...)

PGinFOV(ra, dec, prob, radius, nside)

Sortingby(galPointing, name, exposure)

EvolutionPlot(galPointing, tname, ObsArray)

RankingTimes(obspar, skymap, cat, dirName, ...)

RankingTimes_2D(obspar, prob, dirName, ...)

PlotAccRegionTimePix(dirName, ...)

PlotAccRegionTimeRadec(dirName, ...)

Ranking_Space(dirName, PointingFile, obspar, ...)

Ranking_Space_AI(dirName, PointingFile, ...)

Plotting Tools#

Utilities for plotting sky maps, pointings, and other visualization tasks.

tilepy.include.PointingTools Module#

Functions#

LoadPointings(tpointingFile)

getdate(x)

Bottom-level function that takes a date and prints it in ISO format.

UNIQSkymap_toNested(skymap_fname)

Load a GW HEALPix skymap from file and compute its uniq map.

get_lvk_uniq_maps(sky_map, Order[, map_names])

NightDarkObservation(time, obspar)

Function that searches for an array of observation times that fulfilled darkness condition and window

NightDarkObservationwithGreyTime(time, obspar)

Function that searches for an array of observation times that fulfilled darkness condition and window

ComputeProbability2D(obspar, prob, highres, ...)

Compute probability in 2D by taking the highest probability in FoV value

SubstractPointings2D(tpointingFile, prob, ...)

TransformRADec(vra, vdec)

TransformRADecToPix(radecs, nside)

TransformPixToRaDec(pix, nside)

FindMatchingPixList(pix1, list2)

FindMatchingCoords(option, radec1, radec2, ...)

LoadGalaxies(tgalFile)

Load galaxy catalog as an Astropy Table

LoadGalaxies_SteMgal(tgalFile)

Load galaxy catalog as an Astropy Table

ComputeProbGalTargeted(prob, time, ...)

Compute the galaxy and GW probabilities in FoV, excluding already observed regions, and optionally plot the sky coverage and galaxy positions.

SubstractPointings(tpointingFile, galaxies, ...)

SubstractGalaxiesCircle(galaux, ra, dec, ...)

ComputePGalinFOV(prob, cat, galpix, FOV, ...)

Computes probability Pgal in FoV

ModifyCatalogue(prob, cat, FOV, totaldPdV, nside)

Computes the integrated Pgal in FoV for a list of values using Pgal in FoV and sorts the catalog using that quantity as a criteria

ComputeProbPGALIntegrateFoV(prob, time, ...)

Same as ComputeProbGalTargetted but it does not return circle coordinates.

GetRegionPixReduced(hpxx, percentage, Nnside)

GetRegionPixGal(hpxx, percentage, Nside)

IsSourceInside(Pointings, Sources, FOV, nside)

FillSummary(outfilename, ID, ...)

GetSatelliteName(satellitename, stationsurl)

GetSatelliteTime(satellite_name, t)

GetSatellitePositions(satellite_name, t)

GetBestNSIDE(ReducedNSIDE, HRnside, fov)

FillSummary(outfilename, ID, ...)

Classes#

Tools()

Utility class for astronomical visibility and observing constraints.

Observer(longitude, latitude, elevation, ...)

Class to store information and handle operation related to the observatory used for the observations.

NextWindowTools()