producer.tile module

Functions used to tile a set of on-sky area with FOBOS pointings.

producer.tile.show_tiles(tile_coo, ra=None, dec=None, fov=0.3333333333333333, return_ax=False)[source]
Parameters
  • tile_coo (numpy.ndarray) – Tile coordinates in RA (first column) and DEC (second column).

  • ra (numpy.ndarray, optional) – Right ascension of objects to observe in decimal degrees.

  • dec (numpy.ndarray, optional) – Declination of objects to observe in decimal degrees.

  • fov (float, optional) – The diameter of the field of view in decimal degrees. The uniform grid is constructed using hexagons with the circular field-of-view as the circumcircle of each hexagonal grid cell. See hexgrid().

  • return_ax (bool, optional) – Instead of showing the plot, return the axis instance.

Returns

Axis instance. If return_ax is False, this is returned as None.

Return type

Axis

producer.tile.uniform_tiles(ra, dec, grid_center=None, min_dens=None, min_n=None, fov=0.3333333333333333, half_offset=False)[source]

Construct a uniform grid of FOBOS pointings to observe a set of targets.

Parameters
  • ra (numpy.ndarray) – Right ascension of objects to observe in decimal degrees.

  • dec (numpy.ndarray) – Declination of objects to observe in decimal degrees.

  • grid_center (tuple, optional) – Tuple with a starting point (ra, dec) for the grid center in decimal degrees. If None, starting point set at mean of provided coordinates.

  • min_dens (float, optional) – Minimum density of targets within a given pointing to allow before removing it from the grid. Density calculations use the area that exclude the overlap between tiles. If None and min_n is None, all fields with any targets are returned. Ignored if min_n is provided.

  • min_n (int, optional) – Minimum number of targets within a given pointing to allow before removing it from the returned grid. If None, set to 0. If min_dens is provided, the area is used to set the minimum number.

  • fov (float, optional) – The diameter of the field of view in decimal degrees. The uniform grid is constructed using hexagons with the circular field-of-view as the circumcircle of each hexagonal grid cell. See hexgrid().

  • half_offset (bool, optional) – Offset the center by half the field of view. If not grid center is provided, offset the default grid center (the mean of the provided target coordinates) by half of the field-of-view. Ignored if grid_center is provided.

Returns

A 2D numpy.ndarray with field centers vectors with the center coordinates in decimal degrees for all grid pointings.

Return type

numpy.ndarray