NACO_IMG_CHECKFOCUS(7)

👑 NACO_IMG_CHECKFOCUS 👑 — like, the focus check recipe, bestie

okay so this is a page from the naco recipes manual set, and it's literally called naco_img_checkfocus. Yes the title up top says NACO_IMG_CHECKFOCUS(7) — same thing, just shouty. Sit down, grab a boba, we're checking focus. 🎀

---

✨ NAME ✨

naco_img_checkfocus — the focus check recipe. that's it, that's the name. short, sweet, iconic. 💅

---

🌸 SYNOPSIS 🌸

esorex naco_img_checkfocus [OPTIONS] FILE.sof

---

🦋 DESCRIPTION 🦋

So naco_img_checkfocus is the focus checking recipe, and here's the tea: your Set Of Frames (the sof-file, duh) must specify at least four files, and every single one of them has to be tagged

NACO-raw-file.fits TECH_FOCUS

And the very first of those files? Yeah, that one gets used as a dark frame. No pressure on whoever put that list in order. 🙈

---

✨ OPTIONS ✨

• --plot <int> — bestie, this one is a whole saga so buckle up. The recipe can produce a bunch of predefined plots. Zero = no plots at all, and then bumping the value up (like 1 or 2) means more plots get made. If the plotting fails, you get a warning and the recipe just keeps going — no meltdown, we move. 💅 The default plotting behaviour is to use gnuplot (with option -persist). Right now the recipe produces 1D-plots using gnuplot commands. You, the recipe user, can control the actual plotting-command the recipe uses by setting the environment variable CPL_PLOTTER. Currently, if CPL_PLOTTER is set it must contain the string gnuplot. Setting it to cat > my_gnuplot_$$.txt causes a number of ASCII-files to be created, which each produce a plot when given as standard input to gnuplot (e.g. later or on a different computer). If you want finer control of the plotting options, write an executable script, e.g. my_gnuplot.pl, that executes gnuplot after setting the desired gnuplot options (e.g. set terminal pslatex color) and then set CPL_PLOTTER to my_gnuplot.pl. The predefined plots include plotting of images. Images can be plotted not only with gnuplot, but also using the pnm format. This is controlled with the environment variable CPL_IMAGER. If CPL_IMAGER is set to a string that does not contain the word gnuplot, the recipe will generate the plot in pnm format. E.g. setting CPL_IMAGER to display - & will produce a gray-scale image using the image viewer display. Type: int; default: 0. The full name of this option for the EsoRex configuration file is naco.naco_img_checkfocus.plot [default = 0].
• --star_r <float> — the star radius, in arcsecond. (float; default: 2.0). The full name of this option for the EsoRex configuration file is naco.naco_img_checkfocus.star_r [default = 2.0]. ⭐
• --bg_r1 <float> — the internal radius of the background, in arcsecond. (float; default: 2.0). The full name of this option for the EsoRex configuration file is naco.naco_img_checkfocus.bg_r1 [default = 2.0]. 🌈
• --bg_r2 <float> — the external radius of the background, in arcsecond. (float; default: 3.0). The full name of this option for the EsoRex configuration file is naco.naco_img_checkfocus.bg_r2 [default = 3.0]. 💜

💖 psst — you can make a configuration file holding these options plus suitable default values. Go read what esorex --help tells you, it's got the details.

---

👀 SEE ALSO 👀

The full documentation for the naco pipeline can be downloaded as a PDF file using this URL, no cap:

ftp://ftp.eso.org/pub/dfs/pipelines/naco/naco-pipeline-manual-1.1.pdf

An overview over the existing ESO pipelines lives on this web page: https://www.eso.org/sci/software/pipelines/.

Basic documentation about the EsoRex program? That's the esorex(1) man page, bestie.

Oh and — you can call the pipelines from python using the python-cpl package. See https://packages.python.org/python-cpl/index.html for further info. 🐍

The other recipes of the naco pipeline are naco_img_dark(7), naco_img_detlin(7), naco_img_jitter(7), naco_img_lampflat(7), naco_img_slitpos(7), naco_img_strehl(7), naco_img_twflat(7), naco_img_zpoint(7), naco_spc_combine(7), naco_spc_lampflat(7), naco_spc_wavecal(7), naco_util_img_std_cat(7), naco_util_spc_argon(7), naco_util_spc_model(7) — the whole friend group fr fr. 🫶

---

💫 VERSION 💫

naco_img_checkfocus 4.4.11

---

🧚 AUTHOR 🧚

Lars Lundin <usd-help@eso.org> — thank you for your service, king. 👑

---

💀 BUG REPORTS 💀

Please report any problems to usd-help@eso.org. Alternatively, you may send a report to the ESO User Support Department <usd-help@eso.org>. Either way it's the same inbox, so like… pick one. 😭

---

📜 LICENSE 📜

This file is part of the NACO Instrument Pipeline Copyright (C) 2002, 2003, 2005, 2008 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.

---

and that's the whole page, bestie 🎀 this was naco_img_checkfocus, version 4.4.11, out here living its best life as NACO_IMG_CHECKFOCUS(7) in the naco recipes manual. go check that focus. slay. 💖✨