EffectiveApertureInstrument

class nsb2.core.instrument.EffectiveApertureInstrument[source]

Bases: Instrument

Instrument described by a per-pixel effective aperture map.

The response of each pixel is tabulated as an effective collection area over a small grid of offsets from the pointing direction. This folds the mirror area, the shadowing of the camera body and the light guide acceptance into a single quantity, which is what ray-tracing simulations produce.

Parameters:
  • response (dict or numpy.lib.npyio.NpzFile) – Mapping with keys "x", "y" and "values". x and y hold the offset grid of each pixel in radians, shape (N_pix, G); values holds the effective area in square metres, shape (N_pix, G, G) and indexed values[pixel, x_index, y_index]. x is the offset along longitude and y the offset along latitude, both measured from the pointing direction.

  • bandpass (nsb2.core.spectral.Bandpass) – Wavelength response of the full optical chain.

See also

nsb2.instrument.CTAO

Ready-made CTAO telescope models.

nsb2.instrument.HESS

Ready-made H.E.S.S. telescope models.

Attributes Summary

n_pixels

Number of camera pixels.

Methods Summary

compute_pixel_weights(field, pixel_refs, ...)

Look up the effective aperture for every source-pixel pair.

fov_range()

Return the extent of the field of view.

pixel_coords(observation)

Return the pixel centre positions.

pixel_radii()

Return the per-pixel search radius.

Attributes Documentation

n_pixels

Number of camera pixels.

Type:

int

Methods Documentation

compute_pixel_weights(field, pixel_refs, observation)[source]

Look up the effective aperture for every source-pixel pair.

For a radiance field every pixel gets its solid-angle-integrated aperture, since the emission fills the pixel. For discrete sources the response map is interpolated at the source’s offset from the pixel centre.

See Instrument.compute_pixel_weights() for the parameters and returns.

fov_range()[source]

Return the extent of the field of view.

See Instrument.fov_range() for the returns.

pixel_coords(observation)[source]

Return the pixel centre positions.

See Instrument.pixel_coords() for the parameters and returns.

pixel_radii()[source]

Return the per-pixel search radius.

The radius is half the diagonal of the pixel’s response grid, so that the whole tabulated acceptance is covered.

See Instrument.pixel_radii() for the returns.

__init__(response, bandpass)[source]
classmethod __new__(*args, **kwargs)