PAPI Documentation Release 2.0.20200122115013 J.M.Ibáñez-Mengual (IAA-CSIC) Feb 04, 2020 CONTENTS 1 Caveat 3 2 Contents 5 2.1 Installation & Configuration.....................................5 2.1.1 Requirements and Supported Platforms..........................5 2.1.1.1 System Requirements...............................5 2.1.1.2 Software Requirements..............................5 2.1.2 Download..........................................6 2.1.3 Environment Installation..................................6 2.1.4 PAPI Installation......................................8 2.1.5 Installing for developers..................................8 2.1.6 Building the documentation................................9 2.1.7 Bug reports.........................................9 2.1.8 Release Notes........................................9 2.2 PANIC Quick-Look Tool (PQL)...................................9 2.2.1 Purpose...........................................9 2.2.2 FITS files and headers................................... 10 2.2.3 Starting PQL........................................ 10 2.2.4 Configuration files..................................... 11 2.2.5 PQL’s main window.................................... 12 2.2.5.1 Menu bar...................................... 12 2.2.5.2 Tool bar...................................... 12 2.2.5.3 Main panel..................................... 12 2.2.5.4 Current night checkbox.............................. 14 2.2.5.5 Use GEIRS file.................................. 14 2.2.5.6 Filename filter................................... 15 2.2.5.7 Data list view................................... 15 2.2.5.8 List view filter................................... 16 2.2.5.9 QuickLook mode................................. 16 2.2.5.10 Last file received.................................. 17 2.2.5.11 Buttons....................................... 17 2.2.5.12 Setup Panel.................................... 18 2.2.5.13 Calibrations panel................................. 20 2.2.5.14 Log panel..................................... 21 2.2.6 Event log window...................................... 21 2.2.7 Pop-up menu........................................ 21 2.2.7.1 Display image................................... 22 2.2.7.2 Image info..................................... 22 2.2.7.3 Copy files to clipboard............................... 23 2.2.7.4 Copy files to text file................................ 23 2.2.7.5 Show Dither pattern................................ 23 2.2.7.6 Calibrations.................................... 23 2.2.7.7 Focus evaluation.................................. 26 2.2.7.8 Subtract own-sky................................. 31 i 2.2.7.9 Subtract near-sky................................. 31 2.2.7.10 Quick reduction.................................. 31 2.2.7.11 Astrometric calibration.............................. 31 2.2.7.12 Photometric calibration.............................. 31 2.2.7.13 Statistics...................................... 32 2.2.7.14 FWHM mean estimation............................. 32 2.2.7.15 Background estimation.............................. 33 2.2.7.16 Math operations.................................. 33 2.2.7.17 FITS operations.................................. 33 2.2.8 How do I . ?........................................ 33 2.2.8.1 How to determine the telescope focus ?...................... 33 2.2.8.2 How to determine the field rotation ?....................... 33 2.2.8.3 How to inspect the profile of the stars in an image ?............... 34 2.2.8.4 How do I quick-reduce an observed sequence ?.................. 34 2.2.8.5 How do I quick-reduce an observed sequence using dark and flat master cali- bration files ?................................... 34 2.2.8.6 How do I make mosaics with PQL?........................ 35 2.2.8.7 How do I make use of parallelisation ?...................... 35 2.2.8.8 How do I report a issue ?............................. 35 2.3 PAPI................................................. 35 2.3.1 Purpose........................................... 35 2.3.2 Quickstart.......................................... 35 2.3.2.1 Optional Arguments................................ 36 2.3.2.2 Input FITS data files................................ 37 2.3.2.3 Show grouped files in a raw directory....................... 38 2.3.2.4 Show grouped files per filter and coordinates of a raw directory......... 42 2.3.2.5 Reduce (quick) a specificied number of sequences of the group list....... 42 2.3.2.6 Reduce all the sequences of a given directory................... 43 2.3.2.7 Reduce all the sequences of a given set of directories............... 43 2.3.2.8 Calibrations.................................... 44 2.3.2.9 Reduce a single detector.............................. 44 2.3.3 Reduction modes...................................... 45 2.3.4 How NOT to use PAPI................................... 45 2.3.5 Configuration files..................................... 45 2.3.6 Examples.......................................... 45 2.3.7 Main config file....................................... 46 2.3.7.1 Principal parameters to set............................. 56 2.3.7.2 Bad Pixel treatment................................ 56 2.3.8 Getting PAPI Data..................................... 57 2.3.9 Caveats........................................... 57 2.4 PAPI Reference............................................ 57 2.4.1 Modules........................................... 58 2.4.1.1 papi ....................................... 59 2.4.1.2 applyDarkFlat ................................ 60 2.4.1.3 astrowarp ................................... 60 2.4.1.4 calBPM ...................................... 61 2.4.1.5 calCombineFF ................................. 61 2.4.1.6 calDark ..................................... 62 2.4.1.7 calDarkModel ................................. 62 2.4.1.8 calDomeFlat .................................. 63 2.4.1.9 calSuperFlat ................................. 63 2.4.1.10 calTwFlat ................................... 64 2.4.1.11 calGainMap ................................... 64 2.4.1.12 dxtalk ...................................... 65 2.4.1.13 makeobjmask .................................. 65 2.4.1.14 photometry ................................... 66 2.4.1.15 correctNonLinearity ........................... 66 2.4.1.16 solveAstrometry ............................... 67 ii 2.4.1.17 remove_cosmics ............................... 67 2.4.2 Utilities........................................... 68 2.4.2.1 check_papi_modules ............................ 68 2.4.2.2 collapse .................................... 69 2.4.2.3 mef ........................................ 70 2.4.2.4 checkQuality ................................. 70 2.4.2.5 eval_focus_series ............................. 71 2.4.2.6 genLogsheet .................................. 71 2.4.2.7 health ...................................... 71 2.4.2.8 imtrim ...................................... 71 2.4.2.9 modFits ..................................... 71 2.4.2.10 skyfilter ................................... 71 2.4.2.11 spatial_noise ................................ 71 2.5 Data formats............................................. 71 2.5.1 Detector........................................... 71 2.5.2 FITS............................................. 72 2.5.2.1 HAWAII-2RG................................... 73 2.5.3 Observation Tool keywords................................. 77 2.5.3.1 HAWAII-2RG................................... 78 2.5.4 Data............................................. 78 2.5.5 Classification........................................ 78 2.5.6 Data grouping........................................ 78 2.6 Processing description........................................ 79 2.6.1 Outline........................................... 79 2.6.1.1 Main configuration file.............................. 80 2.6.1.2 Data-set classification............................... 80 2.6.1.3 Data Preparation.................................. 80 2.6.1.4 Calibrations.................................... 80 2.6.2 Computing the master dark................................. 80 2.6.3 Computing the master flat-field............................... 81 2.6.4 Computing the Bad Pixel Mask............................... 81 2.6.4.1 First pass sky subtraction............................. 81 2.6.5 Sky model.......................................... 81 2.6.5.1 Object detection.................................. 81 2.6.5.2 Offset computation................................ 81 2.6.5.3 First pass coaddition................................ 81 2.6.5.4 Master object mask................................ 81 2.6.5.5 Non-Linearity................................... 81 2.6.5.6 Crosstalk...................................... 82 2.6.5.7 Extended Objects................................. 82 2.7 References.............................................. 82 2.7.1 Publications......................................... 82 2.7.2 Webpages.......................................... 82 2.8 PAPI FAQ.............................................. 83 2.8.1 Installation......................................... 83 2.8.1.1 Does PAPI work with python 3?......................... 83 2.8.1.2 What GUI toolkit does PAPI-QL use?...................... 83 2.8.1.3 Can PAPI-QL work with PyQt5?......................... 83 2.8.2 Data reduction....................................... 83 2.8.2.1 What is the best way to reduce PAPI data?.................... 83 2.8.2.2 How can process a broken, interrupted or non OT sequence ?.......... 83 2.8.2.3 How does PAPI