apero_explorer

Contents

1. Description

SHORTNAME: EXPLO

The apero_explorer recipe is designed as a graphical user interface (GUI) between the user and the various databases that APERO uses. The script downloads a static copy of the SQL database, changes are not updated or saved in real time (but can be updated/saved by selecting the correct menu options).

Tables within the database currently accessible with the explorer are:

  • calib: The calibration database

  • tellu: The telluric database

  • index: The file index database

  • log: The logger database

  • object: The object astrometric database

  • lang: The text and language database

The GUI allows the user to:

  • Do File operations:
    • Open a pickle file to replace the current database

    • Import a csv file to replace the current database

    • Save a pickle file of the current database

    • Export a csv file of the current database

  • Edit the current database
    • Find and replace a string with another value

    • Filter rows by a certain criteria

    • Add rows and columns

  • Table operations
    • refresh the current database (with updates since launching the GUI)

    • Save changes for the current database to the main database

    • Clean strings

    • Remove formatting

    • Get some information of the table formatting

Note

No changes will be saved unless you use the “Table>Save to Database” option

Note

We do not recommend changing any of the database entries without good reason and without talking to the developers

In addition to the GUI explorer, apero_explorer can be run in “flag mode”.

This recipes both the –recipe and –flagnum arguments to be used.

apero_explorer.py --recipe=PP --flagnum=21

Gives the binary flags for “preprocessing” (shortname: PP) when the decimal representation of the flags is set to a value of (21)

The output for apero_explorer is then as follows:

Flag mode: PP[21]
recipe = apero_preprocess_spirou.py
  IN_PARALLEL         : True
  RUNNING             : False
  ENDED               : True
  OBJ                 : False
  QCPASSED            : True

Showing that the flag number 21 (binary 10101) corresponds to these flags being true or false.

Note the flags are specific to a specific recipe and thus the –recipe argument must be used.

2. Schematic

No schematic set

3. Usage

apero_explorer.py {options}

No optional arguments

4. Optional Arguments

--hash // Display all hash columns (hidden by default)
--recipe[STRING] // [STRING] Recipe or shortname for recipe (must be used in combination with –flagnum)
--flagnum[INT] // [INTEGER] Instead of running explorer converts a binary flagg to a set of binary flags for a recipe (must be used in combination with –recipe)

5. Special Arguments

--xhelp[STRING] // Extended help menu (with all advanced arguments)
--debug[STRING] // Activates debug mode (Advanced mode [INTEGER] value must be an integer greater than 0, setting the debug level)
--listing[STRING] // Lists the night name directories in the input directory if used without a 'directory' argument or lists the files in the given 'directory' (if defined). Only lists up to 15 files/directories
--listingall[STRING] // Lists ALL the night name directories in the input directory if used without a 'directory' argument or lists the files in the given 'directory' (if defined)
--version[STRING] // Displays the current version of this recipe.
--info[STRING] // Displays the short version of the help menu
--program[STRING] // [STRING] The name of the program to display and use (mostly for logging purpose) log becomes date | {THIS STRING} | Message
--recipe_kind[STRING] // [STRING] The recipe kind for this recipe run (normally only used in apero_processing.py)
--parallel[STRING] // [BOOL] If True this is a run in parellel - disable some features (normally only used in apero_processing.py)
--shortname[STRING] // [STRING] Set a shortname for a recipe to distinguish it from other runs - this is mainly for use with apero processing but will appear in the log database
--idebug[STRING] // [BOOLEAN] If True always returns to ipython (or python) at end (via ipdb or pdb)
--ref[STRING] // If set then recipe is a reference recipe (e.g. reference recipes write to calibration database as reference calibrations)
--crunfile[STRING] // Set a run file to override default arguments
--quiet[STRING] // Run recipe without start up text
--nosave // Do not save any outputs (debug/information run). Note some recipes require other recipesto be run. Only use --nosave after previous recipe runs have been run successfully at least once.
--force_indir[STRING] // [STRING] Force the default input directory (Normally set by recipe)
--force_outdir[STRING] // [STRING] Force the default output directory (Normally set by recipe)

6. Output directory

DRS_DATA_REDUC // Default: "red" directory

7. Output files

N/A

8. Debug plots

No debug plots.

9. Summary plots

No summary plots.