VISIR_UTIL_SPC_TXT2FITS(7)

💅 visir_util_spc_txt2fits — bestie's guide to the VISIR recipes manual 💅

okay so. sit down, hydrate, because we're talking about visir_util_spc_txt2fits from the visir recipes manual, and honestly? it's giving glow-up for your calibration tables. ✨

---

🌸 NAME 🌸

visir_util_spc_txt2fits — Generate spectrum calibration FITS tables 💖

like, the whole point. txt goes in, FITS comes out. iconic behavior.

---

🎀 SYNOPSIS 🎀

esorex visir_util_spc_txt2fits [OPTIONS] FILE.sof

that's it. that's the whole invocation. you hand it a .sof file and some [OPTIONS] and it works. periodt. 💅

---

✨ DESCRIPTION ✨

so this recipe is your girl for generating spectrum calibration tables. that's her job, that's her purpose, she's booked and busy. 🫶

your sof file? it shall consist of 1 line, and that line has the name of an ASCII-file. that file is currently tagged with either SPC_LINES_ASCII or SPC_QEFF_ASCII. one tag, one file, no chaos. 🦋

and the file itself must comprise two columns:

1. 1st column: must be wavelengths in increasing order in units of meter 🌈
2. 2nd column: for SPC_LINES_ASCII-files this must be the atmospheric emission, while for SPC_QEFF_ASCII-files it must be the quantum efficiency of the detector.

ngl bestie, "increasing order in units of meter" is not a suggestion, it's a vibe check you have to pass. 💀

then the output does its little transformation moment:

• a SPC_LINES_ASCII-file will generate a SPEC_CAL_LINES-file 🎀
• a SPC_QEFF_ASCII-file will generate a SPEC_CAL_QEFF-file ✨

and for the lore: the current SPEC_CAL_LINES- and SPEC_CAL_QEFF-files are generated using the ASCII-files in the catalogs/ directory of the VISIR source-code distribution. iykyk. 📁

---

👑 OPTIONS 👑

--qeff <float>

• --qeff <float> — Ignored. like, genuinely ignored. it's a float and the default is 1.0. 🙈

the full name of this option for the EsoRex configuration file is:

visir.visir_util_spc_txt2fits.qeff [default = 1.0]

so if you were like "ooh a knob to turn" — no bestie, this knob is decorative. it's a display-only candle. 🕯️

---

💖 friendly reminder: note that it is possible to create a configuration file containing these options, along with suitable default values. please refer to the details provided by the esorex --help command. that's where the real tea is. ☕

---

🌈 SEE ALSO 🌈

the full documentation for the visir pipeline can be downloaded as a PDF file using the following URL:

ftp://ftp.eso.org/pub/dfs/pipelines/visir/visir-pipeline-manual-1.4.pdf

an overview over the existing ESO pipelines can be found on the web page:

https://www.eso.org/sci/software/pipelines/

basic documentation about the EsoRex program can be found at the esorex (1) man page. 📖

and yes, it is possible to call the pipelines from python using the python-cpl package. see:

https://packages.python.org/python-cpl/index.html

for further information. python girlies, we are seen. 🐍💜

---

🦋 the other recipes of the visir pipeline 🦋

they're all here, all accounted for, no one left behind:

• visir_img_dark(7)
• visir_img_ff(7)
• visir_img_reduce(7)
• visir_img_trans(7)
• visir_old_img_combine(7)
• visir_old_img_phot(7)
• visir_old_spc_obs(7)
• visir_old_spc_obs_ech(7)
• visir_old_spc_phot(7)
• visir_old_spc_phot_ech(7)
• visir_old_spc_wcal(7)
• visir_old_spc_wcal_ech(7)
• visir_old_util_destripe(7)
• visir_spc_reduce(7)
• visir_util_apply_calib(7)
• visir_util_clip(7)
• visir_util_convert_weight(7)
• visir_util_detect_shift(7)
• visir_util_img_std_cat(7)
• visir_util_join(7)
• visir_util_qc(7)
• visir_util_repack(7)
• visir_util_run_swarp(7)
• visir_util_spc_std_cat(7)
• visir_util_undistort(7)

a whole friend group. 🫶✨

---

⭐ VERSION ⭐

visir_util_spc_txt2fits 4.4.2

---

💜 AUTHOR 💜

Lars Lundin <https://support.eso.org>

---

🍓 BUG REPORTS 🍓

please report any problems to:

https://support.eso.org

alternatively, you may send a report to the ESO User Support Department <usd-help@eso.org>. they want to hear from you, fr fr. 😭

---

🌸 LICENSE 🌸

This file is part of the VISIR Instrument Pipeline Copyright (C) 2004, 2005 European Southern Observatory

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02111-1307 USA

bestie that ALL-CAPS warranty disclaimer is not a drill. no warranty, no promises, read it twice. 💀

---

and that's the whole page!! 🌟 this is visir_util_spc_txt2fits, version 4.4.2, living its life as page (7) in the VISIR_UTIL_SPC_TXT2FITS recipe manual. go make some tables, main character. 👑💖