¶
Introduction¶
The new METIS data simulator is based on the generic simulator software Scopesim, a descendant of the older SimCado/SimMETIS interface. METIS itself is handled as an instrument package that contains configuration files for the various instrument modes as well as data files describing the components of the instruments. The new METIS data simulator currently supports the imaging and long-slit modes. The LM-band high-resolution IFU (LMS) mode will be offered soon.
Prerequisites¶
A working installation of Python 3.6 or newer
A working installation of Jupyter if you want to run the simulator from notebooks. This is necessary to run the example notebooks contained in the instrument package.
A working installation of the Python package installer pip
Note
If you come across a bug or get stuck with a certain aspect of ScopeSim or the METIS package, please get in touch with us (email addresses below).
Your feedback is the only way we know what needs to be changed/improved with the package and the simulator.
Please always provide the output of the command scopesim.bug_report()
run on your installation.
Installation & setup¶
This is a short overview of the installation and setup procedure; for a more detailed presentation see Introduction_to_Scopesim_for_METIS.
Install
scopesim
in your python environment:$ pip install scopesim
To upgrade an existing installation do:
$ pip install -U scopesim
Create a working directory where you want to run simulations, e.g.:
$ mkdir ~/path/to/playing_with_scopesim/ $ cd ~/path/to/playing_with_scopesim
Install relevant irdb packages into this directory:
$ python >> import scopesim >> scopesim.download_package(["instruments/METIS", "telescopes/ELT", "locations/Armazones"])
This will install the packages in the subdirectory
./inst_pkgs
.The METIS package includes a number of tutorial notebooks in the directory
./inst_pkgs/METIS/docs/example_notebooks/
(see Python notebooks).Copy notebooks to the working directory (i.e.
./
) to run them.:$ cp ./inst_pkgs/METIS/docs/example_notebooks/<Notebook-Name.ipynb> .
In a terminal, execute the notebook by calling:
$ jupyter notebook <filename.ipynb>
Follow instructions and explanations in the notebook. Some notebooks use example data; the commands to download these data from the scopesim server are included in the notebooks.
You can then edit the notebooks and use them as a starting point for your own simulations.
Python notebooks¶
These notebooks can be found either:
[locally] in the METIS instrument package in
docs/example_notebooks
, or[download] in the METIS/docs section of the IRDB Github repository
Warning
Notebooks should be run in your working directory, NOT directly in the
docs/example_notebooks
folder. Please copy the desired notebook out of
this folder.
Ideally your folder structure should look like this:
working-dir
|- <desired notebook>.iypnb
|
|- inst_pkgs
|- METIS
| |- docs
| |- example_notebooks
| |- <desired notebook>.iypnb # copy out to working-dir
|- ELT
|- Armazones
Introductory notebooks¶
Name |
Description |
---|---|
Introductory overview of how to run simulations in Scopesim |
Scientific use-case notebooks¶
Name |
Description |
---|---|
Imaging observations of HL Tau and an AGN model in the L and N band |
|
Long-slit spectroscopy in the L-band of three models of a young stellar object |
|
Long-slit spectroscopy in the N-band of an AGN model. The first notebook describes
how the input data are prepared for Scopesim, the second runs the simulation.
|
Notebooks on individual effects¶
These notebooks can be found in docs/example_notebooks/demos
.
Name |
Description |
---|---|
How to use the atmospheric dispersion correctors. |
|
How to select dit/ndit automatically. |
|
How to produce chop-nod difference images in the N band. |
|
How to set detector readout modes. |
|
How to use the filter wheel(s). |
|
Basic procedure for long-slit spectroscopy. |
|
How to use the slit wheel for spectroscopy (and imaging) |
Documentation and useful references¶
For experts: GitHub repositories:
Contact points¶
Slack channel: #simulator_support
Email: - simmetis.astro@univie.ac.at - oliver.czoske@univie.ac.at - kieran.leschinski@univie.ac.at