Munipack A general astronomical image processing software

Modules

Description of low-level usage of Munipack for programmers.

Introduction

Munipack working core is splited on to single modules. These modules can be used independently. Both command-line and graphical interfaces just only calls the routines and provides more usage interface for users. The design separates GUI and working part. One has benefit with flexible adding of another interfaces and usage. For example, the routines can be easy used as externals for (web) servers, Virtual observatory, scripting systems, etc.

Rules

There are a few scritly used rules for modules:

Every module is a single executable.
Modules interacts ONLY via the text standard input and output. Ones does not uses command-line parameters or any form of graphical element.
Parameters are passed in the form: PARAMETER = VALUE.
Character size does matter.
Values must be in Fortran free format: Numbers are typed as expected. Strings are enclosed in appostrophes. Boolean (logical) values are only T and F. Example: FILE = 'file.fits', INIT = T
When passing of a list of parameters (files). The number of items must be specified firstly. Example:
```
NITEMS = 2
'file1.fits'
'file2.fits'
```
The filenames can be non-local. Any from cFITSIO known file destination can be used (ftp://server.domain/file.fits).
Any FITS file name may include HDU specification.
Unknown parameters are silently ignored.

Modules are stored in LIBEXEC path defined by Autotools. Current binary distribution defines the path as /opt/munipack/libexec. Note that modules are not set in system-wide binary search path.

Astrometry

Astrometry provides astrometry.

Module name: astrometer

Parameters (see astrometry page for description)
Parameter	type	description
PROJECTION	string	type of projection
CRPIX[1,2]	float	center of projection on map (rectangular coordinates)
CRVAL[1,2]	float	center of projection on sphere (spherical coordinates), degrees
SCALE	float	scale in pixels per degree
ANGLE	float	rotation about center in degrees
TOL	float	limit for astrometry unceranity id degrees
INITPAR	bool	init parameters (provided by CRVAL,SCALE and ANGLE)
MATCH	bool	use matching
NMATCH	integer	number of objects used in matching sequence
MAXMATCH	integer	number of objects used for matching
URADIUS	float	effective uncertainity of a point in triangle space
VALIDITY	float	limiting probability for validity
KEY_ALPHA, KEY_DELTA	string	FITS table column names containing Right Ascension and Declination of objects
OUTPUT	string	File to write of astrometry calibration
CAT	string	FITS table filename used as the reference catalogue for spherical coordinates
REF	string	FITS table 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