make_keck_aperture

hcipy.aperture.make_keck_aperture(normalized=False, with_spiders=True, with_segment_gaps=True, gap_padding=10, segment_transmissions=1, return_segments=False)

Make the Keck aperture.

This code creates a Keck-like aperture matching values used in [vanKooten2022a] and [vanKooten2022b] as well as being verified by Keck personnel to match internal simulation efforts.

[vanKooten2022a]

Maaike van Kooten et al., “Predictive wavefront control on Keck II adaptive optics bench: on-sky coronagraphic results.” JATIS 8 (2022): 029006

[vanKooten2022b]

Maaike van Kooten et al., “On-sky Reconstruction of Keck Primary Mirror Piston Offsets Using a Zernike Wavefront Sensor.” The Astrophysical Journal 932 (2022): 2, 109.

Parameters:

normalizedboolean

If this is True, the outer diameter will be scaled to 1. Otherwise, the diameter of the pupil will be 10.95 meters.

with_spidersboolean

Include the secondary mirror support structure in the aperture.

with_segment_gapsboolean

Include the gaps between individual segments in the aperture.

gap_paddingscalar

Arbitrary padding of gap size to represent gaps on smaller arrays - this effectively makes the gaps larger and the segments smaller to preserve the same segment pitch.

segment_transmissionsscalar or array_like

The transmission for each of the segments. If this is a scalar, this transmission will be used for all segments.

return_segmentsboolean

If this is True, the segments will also be returned as a list of Field generators.

Returns:

apertureField generator

The Keck aperture.

segmentslist of Field generators

The segments. Only returned when return_segments is True.