Skip to content
István Kovács edited this page Jan 11, 2025 · 3 revisions

Welcome to the pmutil wiki!

Installation

Prerequisites

Before using pmutil, ensure that the following external applications are installed on your system:

Executing pmutil requires python 3.8+ with the following python packages: astropy 5.0+, astroquery 0.4+, matplotlib 3.1+, numpy 1.18+, pillow 5.3+, photutils 0.7+, rawpy 0.17+, regions 0.5+, scipy 1.4+, xmltodict 0.12+

For detailed installation instructions see the page Install external packages.

Install pmutil

  1. Clone the pmutil repository:
    git clone https://github.com/kovihome/pmutil.git
  2. Navigate to the pmutil directory and install pmutil commands:
    cd pmutil/pmutil/src/main
    ./configure

Configuration

After installation pmutil's configuration files resides in the ~/.pmlib folder. Files that have to be modified are:

  • ppl.cfg: pmutil configuration and default values, including file name convention.
  • astrometry.cfg: astrometry.net configurations.
  • sex.cfg: source-extractor configurations.

For detailed instructions to modify these files see Configuration page.

How to use pmutil

Conventions

The operation of pmutil assumes certain conventions regarding the directory structure and file naming.

These conventions can be overriden by modifying ~/.pmlib/ppl.cfg configuration file.

More on conventions see Conventions page.

Photometric Processing Workflow

The complete photometry pipeline are performed by several command line scripts.

  1. ppl-calibration: Calibrate and stack raw images.
  2. ppl-refcat: Create reference catalog of variables and comparison starts for the photometry.
  3. ppl-photometry: Do astrometry and photometry on calibrated images, make report of the results.
  4. ppl-transient: Search transient objects in the photometry result.
  5. ppl-colorize: Create color image for demonstration purposes.
  6. ppl-clean: Clean up folders and archive results.

Tips and Tricks

Structure of files used or created by pmutil


For additional help, visit the pmutil GitHub page.

Clone this wiki locally