fcmaker 0.3.5

Figure 1: a typical MUSE-WFM-AO finding chart generated by fcmaker.

Instruments and modes currently supported

• MUSE: WFM NOAO, WFM AO, NFM
• HAWKI: NOAO, AO (including fast photometry)
• XSHOOTER: all modes
• targets with proper motions, ephemeris files

Contents

• Home
• Installation
• Usage instructions
• Troubleshooting
• Gallery
• The functions of fcmaker
• FAQ
• Changelog
• Acknowledging fcmaker

fcmaker is a Python3 module that offers a rapid, easy and automated way to generate ESO-compliant finding charts for observing blocks (OBs) located on p2. fcmaker relies on p2api to easily interact with the p2 database.

The design of the fcmaker finding charts is driven by their use at the VLT to support night time operations. They aim at providing a clear and accurate view of the expected execution of an OB, given its parameters (i.e. without any further manual input). Note that unlike p2, fcmaker does not perform any validation checks on the OB: it merely prints what they do, be it valid or not. In essence, fcmaker is intended to provide the user with the ability to visually check the content of an OB.

I expect/hope that fcmaker, despite being fully automated, will do a reasonable job for most OBs of the supported instruments and modes. Should you stumble upon a case where fcmaker utterly fails to do something useful/elegant, I’d be keen to know about it.

Note

The operational spirit of fcmaker implies that, at times, its finding charts may not be the most ideal to design and prepare an OB.

For example, fcmaker voluntarily does not display the SGS area for MUSE WFM observations. Whereas it may be important at the design phase to ensure that a given SGS star can be accessible in all the OB steps, it is irrelevant for the execution of the OB itself, and would unnecessarily crowd the fcmaker finding charts.

From that perspective, fcmaker is very much complementary to the GUideCam Tool (GUCT).

Warning

fcmaker is developed by an ESO Fellow with duties on UT4 at the VLT. It is shared with the community, in the hope that it can be useful to others.

But please note that fcmaker is not an official tool from the European Southern Observatory.

As such, never blindly rely on what fcmaker does. If the finding chart generated by fcmaker looks different from what you expected, this means that:

1. there is a real design flaw in your OB, or
2. there is a yet undiscovered bug in fcmaker.

In those discordant cases, feedback will be greatly appreciated.

---

Copyright notice:

This file is part of the fcmaker Python module. The fcmaker Python module 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, version 3 of the License.

The fcmaker Python module 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 the fcmaker Python module. If not, see http://www.gnu.org/licenses/ .