From 3ccd331abb40039b82535926fc71b634a4431aa5 Mon Sep 17 00:00:00 2001 From: Dustin Lang Date: Wed, 14 Feb 2024 21:02:06 -0500 Subject: [PATCH] LSST 2023 filters: add docs --- docs/_static/lsst2023.png | Bin 0 -> 63458 bytes docs/filters.rst | 23 +++++++++++++++++++++-- speclite/filters.py | 2 +- 3 files changed, 22 insertions(+), 3 deletions(-) create mode 100644 docs/_static/lsst2023.png diff --git a/docs/_static/lsst2023.png b/docs/_static/lsst2023.png new file mode 100644 index 0000000000000000000000000000000000000000..ca7ab5fdab7610230d96f1ae338cbddb76892139 GIT binary patch literal 63458 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 literal 0 HcmV?d00001 diff --git a/docs/filters.rst b/docs/filters.rst index e42d561..36d533c 100644 --- a/docs/filters.rst +++ b/docs/filters.rst @@ -231,8 +231,8 @@ The command below produces the figure:: .. image:: _static/cfht_megacam.png :alt: CFHT-MegaCam filter curves -LSST Filters ------------- +LSST (2016) Filters +------------------- LSST filter responses are taken from tag 12.0 of the LSST simulations `throughputs package `__ and include a @@ -249,6 +249,25 @@ Figure 6 of the paper:: .. image:: _static/lsst2016.png :alt: lsst filter curves +LSST (2023) Filters +------------------- + +LSST filter responses are taken from tag 1.9 of the LSST simulations +`throughputs package `__ and include a +standard atmosphere with airmass 1.2 that is also tabulated in the same package. + +This tag follows the baselining of silver coatings on all three mirrors. + +The group name ``lsst2023`` is used to identify these response curves in ``speclite``. +The plot below shows the output of the command below:: + + lsst = speclite.filters.load_filters('lsst2023-*') + speclite.filters.plot_filters( + lsst, wavelength_limits=(3000, 11000), legend_loc='upper left') + +.. image:: _static/lsst2023.png + :alt: lsst filter curves + Johnson/Cousins Filters ----------------------- diff --git a/speclite/filters.py b/speclite/filters.py index 2554fa2..a2c3357 100644 --- a/speclite/filters.py +++ b/speclite/filters.py @@ -11,7 +11,7 @@ are: >>> filter_group_names - ['sdss2010', 'sdss2010noatm', 'decam2014', 'wise2010', 'hsc2017', 'lsst2016', 'bessell', 'BASS', 'MzLS', 'Euclid', 'decamDR1', 'decamDR1noatm', 'gaiadr2', 'gaiadr3', 'twomass', 'galex', 'odin', 'suprime', 'cfht_megacam'] + ['sdss2010', 'sdss2010noatm', 'decam2014', 'wise2010', 'hsc2017', 'lsst2016', 'lsst2023', 'bessell', 'BASS', 'MzLS', 'Euclid', 'decamDR1', 'decamDR1noatm', 'gaiadr2', 'gaiadr3', 'twomass', 'galex', 'odin', 'suprime', 'cfht_megacam'] List the band names associated with any group using, for example: