forwardModelPair

lsst.ts.wep.utils.forwardModelPair(seed: int = 1234, zkCoeff: Optional[ndarray] = None, zkNorm: float = 1e-06, zkMax: float = 1e-06, jmax: int = 22, fluxIntra: float = 100000000.0, fluxExtra: float = 100000000.0, seeing: Optional[float] = None, skyLevel: Optional[float] = None, bandLabel: str = 'r', fieldAngleIntra: Optional[tuple] = None, fieldAngleExtra: Optional[tuple] = None, blendOffsetsIntra: Optional[Union[ndarray, tuple, list]] = None, blendOffsetsExtra: Optional[Union[ndarray, tuple, list]] = None, instConfig: Union[str, dict, Instrument] = 'policy:instruments/LsstCam.yaml', nPix: int = 180) → Tuple[ndarray, Image, Image]

Forward model a pair of donuts.

Parameters

seedint, optional

The random seed. (the default is 1234)

zkCoeffnp.ndarray or None, optional

A set of Zernike coefficients, in meters. If None, a random set of Zernikes are generated using zkNorm, zkMax, jmax.

zkNormfloat, optional

Normalization for random Zernike coefficients, in meters. Note this parameter is ignored if zkCoeff is not None. (the default is 1e-5)

zkMaxfloat, optional

The max absolute value of any Zernike coefficient. Note this parameter is ignored if zkCoeff is not None. (the default is 1e-6)

jmaxint, optional

The maximum Noll index for the random Zernike coefficients. Note this parameter is ignored if zkCoeff is not None. (the default is 22)

fluxIntraint, optional

Flux of the intrafocal donut. (the default is 1e8)

fluxExtraint, optional

Flux of the extrafocal donut. (the default is 1e8)

seeingfloat or None, optional

The FWHM of the Kolmogorov kernel in arcseconds. If None, a random value is chosen between 0.3 and 1.5. (the default is None)

skyLevelfloat or None, optional

Noise level in counts / arcsec^2. If None, a random value is chosen between 100 and 10^9 (log-uniform) (the default is None)

bandLabelstr, optional

The name of the band to simulate donuts in. (the default is “r”)

fieldAngleIntratuple, optional

Field angle, in degrees, of the intrafocal donut. If the angle is only specified for the intra or extrafocal donut, both donuts use that angle. If neither is specified, the same random angle is used for both. (the default is None)

fieldAngleExtratuple, optional

Field angle, in degrees, of the extrafocal donut. If the angle is only specified for the intra or extrafocal donut, both donuts use that angle. If neither is specified, the same random angle is used for both. (the default is None)

blendOffsetsIntraIterable or None, optional

The blend offsets of the intrafocal donut. (the default is None)

blendOffsetsExtraIterable or None, optional

The blend offsets of the extrafocal donut. (the default is None)

instConfigstr, dict, or Instrument, optional

The instrument config for the image mapper. (the default is “policy:instruments/LsstCam.yaml”)

nPixint, optional

The size of the images. (the default is 180)

Returns

np.ndarray

Zernike coefficients in meters, for Noll indices 4-jmax (inclusive)

Image

The intrafocal image

Image

The extrafocal image