VISIR_UTIL_IMG_STD_CAT(7)

📦
version 4.4.2 · 2 versions
, in debian bookworm, ubuntu noble

💫 visir_util_img_std_cat 💫

okay bestie, welcome to the visir recipes section of the manual — this one's called visir_util_img_std_cat(7) and she is literally the glow-up queen that turns your crusty ASCII text files into a gorgeous FITS standard star catalog. let's get into it 🫶

✨ NAME ✨

visir_util_img_std_cat — Convert ASCII-file(s) to a FITS standard star catalog

🌸 SYNOPSIS 🌸

esorex visir_util_img_std_cat [OPTIONS] FILE.sof

🦋 DESCRIPTION 🦋

so basically, this recipe generates a FITS standard star catalog for imaging, and she does it from one or more ASCII-files. periodt. 💅

here's the tea on the input format — every single line in the text file has to have at least 8 fields, all separated by white-space. like, no skimping. the first field is the star name, e.g.

HD108903

and that name gets stored in a table column labeled STARS. cute right?

the next 3 fields are the RA (hh mm ss), and they get stored in degrees in a table column labeled RA. quick rules: all three are non-negative, and hh and mm are integer. slay.

the 3 fields after that are the DEC (dd mm ss), stored in degrees in a table column labeled DEC. same vibe: all three are non-negative, dd and mm are integer, but heads up — dd has either a + or a - prepended to it (and yes, that includes -00, don't play with me).

next field? the spectral type. it lands in a table column labeled SP_TYPE.

and then every field after the first 8 are the JY values for the supported filters, and ngl they can be a mixture of image or spectral filters. one rule though: all JY values must be positive. no negativity in this house 🙈.

for each filter, the JY value is stored in a table column labeled with the filter name — taken from the first row of column headings. OR, if there's no 1st row of column headings, it uses a list of 44 filter names hard-coded in the recipe. and in that case bestie, the number of JY fields must be exactly 42, or else an error is printed and execution ends. like, it's giving strict. 💀

🎀 the column-headings situation 🎀

as mentioned, the 1st row may be a list of column headings. if this row is supplied:

  • the 1st 4 fields will be ignored (but dummy values must be supplied anyway, so don't skip them!!)
  • every field after those will be used as the column label in the output table for that column's JY values

✨ comments & input tagging ✨

lines beginning with a hash (#) are treated as comments. iconic, love a little annotation moment. 📝

the ASCII-input should be tagged IMG_LINES_ASCII, but — and this is the wild part — all input files will currently be processed regardless. yeah. she's not checking tags rn. iykyk.

💅 OPTIONS 💅

not me having to tell you this, but 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. 🫶

🌈 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.

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.

the other recipes of the visir pipeline are:

⭐ VERSION ⭐

visir_util_img_std_cat 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>.

💜 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

and that's the whole page bestie!! 🎀 this one is visir_util_img_std_cat version 4.4.2, living in the visir recipes manual — go forth and catalog those stars, you absolute main character. 🌟🦋✨

📦 where this page comes from