A description of low-level execution parts of Munipack for programmers.
Munipack's working core is split on to single exacutables (modules) which can be run independently. Both command-line and graphical interfaces (munipack, xmunipack) just provides user friendly interface and calls the modules. The design naturally separates the GUI and the execution part.
The way is very flexible. It has benefit when another interfaces or usage is required. For example, the routines can be easy used as utilities for (web) servers, Virtual observatory, scripting systems, pipe lines, called from shells, etc.
There are a few strictly followed rules for all modules:
NITEMS = 2 ITEM = 'file1.fits' ITEM = 'file2.fits'
Modules are stored in LIBEXEC path as defined by Autotools. Current binary distribution defines the path as /opt/munipack/libexec/munipack. Note that modules are not available in system-wide binary search path.
The rules for logging are analogical to standard Unix philosophy:
Calling routines must print some listing in specified format when parameter PIPELOG is used:
There is no general convention for FITS keywords except NAXIS, NAXES, BITPIX and SIMPLE. Unforunatelly, frequently are used different keywords with the same meaning. For example, an exposure time may be stored as EXPTIME or EXPOSURE keywords. Therefore all the modules accepts following parameters to set proper keywords according to a local conventions. See FITS environment variables.
Astrometry provides astrometry.
Module name: astrometer
|PROJECTION||string||type of projection|
|FITS||string||select a method: ROBUST, SQUARE|
|AUNITS||string||print residuals in specified units|
|WCSSAVE||bool||save astrometry to header|
|VERBOSE||logical||print verbose mesages|
|PIPELOG||logical||print control mesages|
|CRPIX||float,float||center of projection on map (rectangular coordinates)|
|CRVAL||float,float||center of projection on sphere (spherical coordinates), degrees|
|SCALE||float||scale in pixels per degree|
|ANGLE||float||rotation about center in degrees|
|SIG||float||mean uncertainity in position|
|FSIG||float||mean uncertainity in fluxes|
|INITPAR||bool||init parameters (provided by CRVAL,SCALE and ANGLE)|
|NMATCH||integer||number of objects used in matching sequence|
|MAXMATCH||integer||number of objects used for matching|
|FULLMATCH||integer||... for matching|
|COL_RA||integer||column with RA|
|COL_DEC||integer||column with Dec|
|COL_PMRA||integer||column with PM in RA|
|COL_PMDEC||integer||column with PM in Dec|
|COL_MAG||integer||column with magnitude|
|CAT||string||FITS table filename used as the reference catalogue for spherical coordinates|
|REF||string||FITS table filename used as the reference list of spherical coordinates of objects|
|REL||string||FITS filename used as the reference list of rectangular coordinates of objects|
|FILE||string||FITS table filename containing list of rectangular coordinates of objects used for astrometry|