Add pinhole mask source

[hugobuddel]

Perhaps should go in ScopeSim_Templates though

From Kieran to Roy:

As I just mentioned in the ST videocon, if there's anything floating around regarding the position of the holes in the pin-hole masks, we'd be happy to build these into scopesim for our 15th of May delivery to ESO of simulated raw data files (not a high priority though, just a nice to have). First guesses/estimates of the positions are sufficient for now, as we can update these as the pinhole masks definitions are updated. It's just about having the code-infrastructure set up now for this.

From Roy:

The preliminary mask designs are in METIS-6006 on Polarion. Note that these will change during 2024. But for the intial delivery of simulated data that does not matter I think.

[astronomyk]

Here's the current design (will be changed in future) for the pin-hole mask that is foreseen to be used for IMG and IFU distorsion calibrations raw frames (IFU_DISTORTION_RAW, LM_DISTORTION_RAW, N_DISTORTION_RAW) Ideally we would also use it for the LSS along-slit distorsion calibrations to (LM_LSS_RSRF_PINH_RAW, N_LSS_RSRF_PINH_RAW)

As you can see, the dimensions are all given in multiples (m, n, p,q) of Lam/D. These factors will differ between L, M, and N bands because the central wavelength for each band is different, but the physical holes on the mask cannot change position. There will only be one pin-hole mask (afaik). I haven't yet found values for these multiplication factors, and the image is only an illustration and not to be taken to scale. (p,q) are likely to be much smaller than illustrated as the central 3x3 grid must fit inside the IFU FoV (so within 0.6.x0.9") --> for now we can assume p=0.2".
Given that we have 28 IFU slices, the idea is to use the derotator and internal chop-mirror to move the detector w.r.t. to the pinhole mask, and therefore move the projection of the point sources onto different image slices. For the full calibration we will need 28/3 (~10) images, with the mask shifted by one slice width (~20mas) in each one. [ can be achieved by using scopesim.Source.shift(dx,dy) ]

For our purposes now it should be sufficient to create a scopesim source object with a table of point sources according to the mask below. My thumb-times-pi guesses for the Lam/D coefficients are:

n = 8" m = 4" q = 1.5" p = 0.2"

Feel free to change these if you feel the need to (or add parameters to the function call to change these)

Here's the METIS document (E-SPE-UZK-MET-1015) with this info: E-SPE-UZK-MET-1015_2-0 WCU focal and pupil masks layout.pdf

[astronomyk]

Assigned @teutoburg to make the pinhole mask, as it's part of the broader project of scopesim_templates (_targets) but this could also be a good chance for @JenniferKarr to play around with scopesim source objects.

The spectrum associated with this should be the same as the warm calibration unit's blackbody spectrum (i.e. from the flat-field exposures)

[hugobuddel]

We have a regular grid of point sources now in https://github.com/AstarVienna/ScopeSim_Templates/pull/80 which was good enough for the first delivery.

Do we want to have the irregular grid from the document above? @JenniferKarr says yes. So keeping this open