From 49424a7520578ea62bf799fe1b278a0423ee54e3 Mon Sep 17 00:00:00 2001 From: Kieran Leschinski Date: Mon, 2 Mar 2026 11:24:48 +0100 Subject: [PATCH] Add MOSAIC apertures, documentation, and progress report Co-Authored-By: Claude Opus 4.6 --- MOSAIC/code/apertures_VIS-LR-7.dat | 31 ++++++ MOSAIC/docs/mosaic_irdb_summary.rst | 96 +++++++++++++++++++ .../sso/ProgReps/ProgRep_cycle_1_Feb26.md | 71 ++++++++++++++ 3 files changed, 198 insertions(+) create mode 100644 MOSAIC/code/apertures_VIS-LR-7.dat create mode 100644 MOSAIC/docs/mosaic_irdb_summary.rst create mode 100644 MOSAIC/docs/sso/ProgReps/ProgRep_cycle_1_Feb26.md diff --git a/MOSAIC/code/apertures_VIS-LR-7.dat b/MOSAIC/code/apertures_VIS-LR-7.dat new file mode 100644 index 00000000..c0deec6c --- /dev/null +++ b/MOSAIC/code/apertures_VIS-LR-7.dat @@ -0,0 +1,31 @@ +# name: MOSAIC VIS B/R system transmission (simple version) +# description : A 7-fibre bundle for the VIS-LR mode +# author: Kieran Leschinski +# sources: E-MOS-SYS-ANR-0063-V20_VIS_OptDesign_preSAR.pdf, adapted +# date_created: 2025-07-18 +# date_modified: 2025-07-18 +# status : estimate +# x_cen : 0 +# y_cen : 0 +# x_cen_unit : arcsec +# y_cen_unit : arcsec +# x_unit : arcsec +# y_unit : arcsec +# r_unit : arcsec +# angle_unit : deg +# +# comments : +# - This file contains the positions of a single VIS-LR 7-fibre bundles. +# - The hexagon-height (flat-to-flat) is 0.234 +# - The fibre numbering is from top-left down to bottom-right +# changes: +# - 2025-07-18 (KL) initialised +# +id x y r angle conserve_image shape +0 -0.117 -0.203 0.234 90 False hex +1 0.117 -0.203 0.234 90 False hex +2 -0.234 0.000 0.234 90 False hex +3 0.000 0.000 0.234 90 False hex +4 0.234 0.000 0.234 90 False hex +5 -0.117 0.203 0.234 90 False hex +6 0.117 0.203 0.234 90 False hex \ No newline at end of file diff --git a/MOSAIC/docs/mosaic_irdb_summary.rst b/MOSAIC/docs/mosaic_irdb_summary.rst new file mode 100644 index 00000000..00f7d2f5 --- /dev/null +++ b/MOSAIC/docs/mosaic_irdb_summary.rst @@ -0,0 +1,96 @@ +MOSAIC Instrument Package Summary +================================= + +This document summarises the current state of the MOSAIC instrument package +in the IRDB, for use in progress reporting. + + +Observation Modes +----------------- + +The MOSAIC package defines **12 observation modes** across three instrument +categories. All modes currently have development status. The default mode is +``MOS-LR-R``. + +Visual (VIS) Spectroscopy ++++++++++++++++++++++++++ + +======== ============= ================== +Mode Resolution Dispersion (um/px) +======== ============= ================== +MOS-LR-B R = 32 000 1.9e-5 +MOS-LR-R R = 32 000 3.0e-5 +MOS-HR-B1 R = 72 000 6.5e-6 +MOS-HR-B2 R = 72 000 5.0e-6 +MOS-HR-R1 R = 72 000 8.0e-6 +MOS-HR-R2 R = 72 000 1.0e-5 +======== ============= ================== + +NIR Multi-Object Spectroscopy (MOS) +++++++++++++++++++++++++++++++++++++ + +======== ============= ================== +Mode Resolution Dispersion (um/px) +======== ============= ================== +MOS-LR-J R = 16 000 9.5e-5 +MOS-LR-H R = 16 000 9.0e-5 +MOS-HR-H R = 72 000 2.4e-5 +======== ============= ================== + +NIR Integral Field Unit (mIFU) +++++++++++++++++++++++++++++++ + +======== ============= ================== +Mode Resolution Dispersion (um/px) +======== ============= ================== +mIFU-LR-J R = 16 000 9.5e-5 +mIFU-LR-H R = 16 000 9.0e-5 +mIFU-HR-H R = 72 000 2.4e-5 +======== ============= ================== + + +ScopeSim Effect Classes +----------------------- + +The MOSAIC package uses **17 unique ScopeSim Effect classes** across its YAML +configuration files. + +========================== ======================================= +Effect Class Used In +========================== ======================================= +ADConversion MOSAIC_DET_NIR, MOSAIC_DET_VIS +AutoExposure MOSAIC_DET_NIR +BasicReadoutNoise MOSAIC_DET_NIR, MOSAIC_DET_VIS +DarkCurrent MOSAIC_DET_NIR, MOSAIC_DET_VIS +DetectorList MOSAIC_DET_NIR, MOSAIC_DET_VIS +ExposureIntegration MOSAIC_DET_NIR, MOSAIC_DET_VIS +ExposureOutput MOSAIC_DET_NIR +LinearityCurve MOSAIC_DET_NIR +LineSpreadFunction MOSAIC_NIR, MOSAIC_VIS +MetisLMSImageSlicer MOSAIC_NIR, MOSAIC_VIS +MosaicCollapseSpectralTraces MOSAIC_DET_NIR, MOSAIC_DET_VIS +MosaicSpectralTraceList MOSAIC_NIR, MOSAIC_VIS +QuantumEfficiencyCurve MOSAIC_DET_NIR, MOSAIC_DET_VIS +ReferencePixelBorder MOSAIC_DET_NIR +SeeingPSF MOSAIC_NIR, MOSAIC_VIS +ShotNoise MOSAIC_DET_NIR, MOSAIC_DET_VIS +TERCurve MOSAIC_NIR, MOSAIC_VIS +========================== ======================================= + +Of these, ``MosaicCollapseSpectralTraces`` and ``MosaicSpectralTraceList`` are +MOSAIC-specific custom effects. ``MetisLMSImageSlicer`` is reused from the +METIS instrument package. + + +YAML Configuration Files +------------------------- + +============================== ========================================== +File Purpose +============================== ========================================== +``default.yaml`` Top-level config and mode definitions +``MOSAIC_NIR.yaml`` NIR instrument optical effects +``MOSAIC_VIS.yaml`` VIS instrument optical effects +``MOSAIC_DET_NIR.yaml`` NIR detector (H4RG) effects +``MOSAIC_DET_VIS.yaml`` VIS detector effects +============================== ========================================== diff --git a/MOSAIC/docs/sso/ProgReps/ProgRep_cycle_1_Feb26.md b/MOSAIC/docs/sso/ProgReps/ProgRep_cycle_1_Feb26.md new file mode 100644 index 00000000..3ad34627 --- /dev/null +++ b/MOSAIC/docs/sso/ProgReps/ProgRep_cycle_1_Feb26.md @@ -0,0 +1,71 @@ +## [[sso-etc:Cycle_1|ETC - Cycle 1]] + +### Status of the software ETC + +While there are no deliveries expected for ESO, we are offering the ScopeSim observation simulator to the MOSAIC science team for running feasibility studies for their science cases. + +Slide deck with current status (Dec 2025): https://docs.google.com/presentation/d/1ETeuM7kiLp1xcO7O2RYnMYhZ6aWak1xdJuDS0vtABWE/edit?usp=sharing + +The first draft of the ETC specifications document for ESO can be found here: https://docs.google.com/document/d/1cWhtF89n1mRFJ9IDOIE9Syhfm56tR6-5YGoQeVHBBD0/edit?usp=sharing + +#### Functionalities implemented + +We have added a MOSAIC v0.1 package to the ScopeSim "Instrument Reference Database" (IRDB) for use by the science team: +* ReadTheDocs: https://irdb.readthedocs.io/en/latest/MOSAIC/docs/readme.html +* Demo Notebook: https://github.com/AstarVienna/irdb/blob/dev_master/MOSAIC/docs/example_notebooks/MOSAIC_demo.ipynb + +Modes currently available in the package: +* VIS - MOS-LR-B+R +* VIS - MOS-HR-B1+B2+R1+R2 +* NIR - MOS-LR-J+H +* NIR - MOS-HR-H + +The MOSAIC package in ScopeSim makes use of the following optical effect descriptions: + 1. ADConversion + 2. AutoExposure + 3. BasicReadoutNoise + 4. DarkCurrent + 5. DetectorList + 6. ExposureIntegration + 7. ExposureOutput + 8. LinearityCurve + 9. LineSpreadFunction + 10. MetisLMSImageSlicer (repurposed for MOSAIC) + 11. MosaicCollapseSpectralTraces + 12. MosaicSpectralTraceList + 13. QuantumEfficiencyCurve + 14. ReferencePixelBorder + 15. SeeingPSF + 16. ShotNoise + 17. TERCurve + +#### Limitations + +The mIFU modes will be refined and released with the next update: +* NIR - mIFU-LR-J+H +* NIR - mIFU-HR-H + +While the technical implementation is not very taxing, how the mIFU traces data +will be made available to the "science user" in the context of an "ETC-like" tool +is still under discussion. + +### Version of the software +* ScopeSim for MOSAIC v0.1 +* ScopeSim: https://github.com/AstarVienna/ScopeSim +* MOSAIC instrument package: https://github.com/AstarVienna/Irdb/tree/dev_master/MOSAIC + +### Development incrementation + +#### New features +* Added MOSAIC v0.1 package to the IRDB for use by the science team +* 4 VIS and 2 NIR MOS spectroscopy modes available +* 17 ScopeSim optical effect classes integrated + +#### Bug corrections +* No bug corrections to report for this cycle + +### functionalities to be implemented in the next cycle +* Refine and release mIFU modes (NIR - mIFU-LR-J+H, NIR - mIFU-HR-H) +* Add a tool to estimate SN-ratios for specfic lines. Currently this is left as + exercise to the user, however it should be available in a standardised manner. +