Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions MOSAIC/code/apertures_VIS-LR-7.dat
Original file line number Diff line number Diff line change
@@ -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
96 changes: 96 additions & 0 deletions MOSAIC/docs/mosaic_irdb_summary.rst
Original file line number Diff line number Diff line change
@@ -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
============================== ==========================================
71 changes: 71 additions & 0 deletions MOSAIC/docs/sso/ProgReps/ProgRep_cycle_1_Feb26.md
Original file line number Diff line number Diff line change
@@ -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.