Auto-generate tables for the wavelength calibration documentation

doc/Makefile

@@ -72,6 +72,7 @@ apirst:
 	python ./scripts/make_example_files.py
 	python ./scripts/write_script_help.py
 	python ./scripts/build_standardstbl_rst.py
+	python ./scripts/build_wvcal_tbl_rst.py
 
 html:
 	make apirst

doc/calibrations/wave_calib.rst

@@ -66,25 +66,7 @@ the `NIST database <https://physics.nist.gov/PhysRefData/ASD/lines_form.html>`_,
 `"arc_lines" directory <https://github.com/pypeit/PypeIt/tree/release/pypeit/data/arc_lines/lists>`_
 of the repository. Here are the available lamps:
 
-.. TODO: THIS TABLE IS OUT OF DATE.  WE NEED A WAY OF AUTOMATICALLY GENERATING
-.. THIS TABLE
-
-======  ==========  ================
-Lamp    Range (Å)   Last updated
-======  ==========  ================
-ArI     3100-11000  7 October 2018
-CdI     3000-6500   28 February 2022
-CuI     4200-6100   4 October 2018
-FeI     3000-10000  26 April 2020
-HeI     3800-6000   21 December 2016
-HgI     2900-12000  28 February 2022
-KrI     4000-10000  3 May 2018
-NeI     5000-12000  3 May 2018
-XeI     4000-12000  3 May 2018
-ZnI     3000-5000   6 Sep 2023
-ThAr    3000-11000  9 January 2018
-FeAr    3000-9000   6 Sep 2023
-======  ==========  ================
+.. include:: ../include/linelist_table.rst
 
 In the case of the ThAr list, all of the lines are taken from the NIST database,
 and they are labeled with a 'MURPHY' flag if the line also appears in the list
@@ -583,26 +565,7 @@ latter must be constructed by a developer, using
 summarizes the existing ones (all of which are in the
 ``data/arc_lines/reid_arxiv`` folder):
 
-.. TODO: THIS IS WAY OUT OF DATE.  WE NEED AN AUTOMATED WAY OF GENERATING THIS TABLE
-
-===============  =========================  =============================
-Instrument       Setup                      Name
-===============  =========================  =============================
-keck_deimos      600ZD grating, all lamps   keck_deimos_600ZD.fits
-keck_deimos      830G grating, all lamps    keck_deimos_830G.fits
-keck_deimos      1200G grating, all lamps   keck_deimos_1200G.fits
-keck_deimos      1200B grating, all lamps   keck_deimos_1200B.fits
-keck_deimos      900ZD grating, all lamps   keck_deimos_900ZD.fits
-keck_lris_blue   B300 grism, all lamps      keck_lris_blue_300_d680.fits
-keck_lris_blue   B400 grism, all lamps?     keck_lris_blue_400_d560.fits
-keck_lris_blue   B600 grism, all lamps      keck_lris_blue_600_d560.fits
-keck_lris_blue   B1200 grism, all lamps     keck_lris_blue_1200_d460.fits
-keck_lris_red    R400 grating, all lamps    keck_lris_red_400.fits
-keck_lris_red    R1200/9000 , all lamps     keck_lris_red_1200_9000.fits
-shane_kast_blue  452_3306 grism, all lamps  shane_kast_blue_452.fits
-shane_kast_blue  600_4310 grism, all lamps  shane_kast_blue_600.fits
-shane_kast_blue  830_3460 grism, all lamps  shane_kast_blue_830.fits
-===============  =========================  =============================
+.. include:: ../include/reid_arxiv_table.rst
 
 .. TODO: WE SHOULD CONSIDER ADDING SOME OF THESE NOTEBOOKS DIRECTLY TO THE DOCS USING
 .. NBSPHINX: https://nbsphinx.readthedocs.io/

doc/include/linelist_table.rst

@@ -0,0 +1,23 @@
+===============  =============  ==========  =  =====================  =============  ==========
+Lamp             Range (Å)      Last Mod       Lamp                   Range (Å)      Last Mod  
+===============  =============  ==========  =  =====================  =============  ==========
+ArII             3244 - 9512    2021-08-16     OH_GMOS                6172 - 10976   2020-11-19
+ArI_DeVeny       3950 - 10884   2024-02-05     OH_GNIRS               8026 - 24725   2020-11-19
+ArI              3950 - 10884   2024-01-17     OH_MODS                6172 - 10976   2020-11-19
+Ar_IR_GNIRS      11081 - 40434  2020-11-19     OH_MOSFIRE_H           13008 - 18991  2022-06-01
+Ar_IR_MOSFIRE    8266 - 25669   2022-06-01     OH_MOSFIRE_J           10002 - 14932  2022-06-01
+CdI_DeVeny       3134 - 6441    2024-02-05     OH_MOSFIRE_K           18067 - 24991  2022-06-01
+CdI              3134 - 6441    2022-10-27     OH_MOSFIRE_Y           8016 - 11989   2022-06-01
+CuI              4260 - 6034    2020-11-19     OH_NIRES               8016 - 24981   2020-11-19
+FeAr             3021 - 8922    2024-01-17     OH_R24000              9479 - 23847   2020-11-19
+FeII             3000 - 9079    2020-11-19     OH_XSHOOTER            8016 - 24994   2020-11-19
+FeI              3021 - 9003    2021-08-16     OH_triplespec          8016 - 23535   2020-11-19
+HeI              3889 - 7068    2023-02-27     ThAr_MagE              3034 - 10481   2020-11-19
+HgI_DeVeny       2968 - 10143   2024-02-05     ThAr_XSHOOTER_UVB      3094 - 10481   2022-10-27
+HgI              2968 - 10143   2022-10-27     ThAr_XSHOOTER_VIS_air  5407 - 10479   2020-11-19
+KrI              4275 - 9859    2021-04-23     ThAr_XSHOOTER_VIS      5409 - 10481   2020-11-19
+NeI_DeVeny       5039 - 11147   2024-02-05     ThAr                   3000 - 10994   2020-11-19
+NeI              5039 - 11147   2023-10-10     XeI                    4079 - 11131   2021-04-23
+Ne_IR_MOSFIRE    8649 - 24483   2022-06-01     ZnI                    3019 - 7802    2024-01-17
+OH_FIRE_Echelle  8016 - 24993   2020-11-19                                                     
+===============  =============  ==========  =  =====================  =============  ==========