mTANHdr(1)

Usage

mTANHdr [-d] [-o order] [-i maxiter] [-t tolerance] [-s statusfile] orig.hdr new.hdr

Overview

Analyzes a template file and determines if there would be an adequate equivalent distorted TAN projection, within a specified tolerance, and outputs the alternate header. This header can be used in conjunction with mProjectPP to produce a TAN plane image. This process is considerably faster than projecting with the general purpose tool mProject.

The output header is a FITS header template containing a TAN projection with polynomial focal plane distortions. (Link to an example output header)

mTANHdr is most suitable for projections which can be approximated by tangent-plane projections (TAN, SIN, ZEA, STG, ARC), and is also therefore not suited for images covering large portions of the sky.

Options

-d: Print additional debugging information to stdout.

-o order: Order of output header polynomial focal plane distortions (default = 4)

-i maxiter: Maximum number of iteration attempts to produce header (default = 50)

-t tolerance: Distortion tolerance value for acceptable output (default = 0.01)

-s statusfile: Output and errors are written to statusfile instead of stdout.

Arguments

`orig.hdr`	Input FITS header
`new.hdr`	Path to output header to be created

Result

[struct stat="OK", fwdxerr=fwdxerr, fwdyerr=fwdyerr, fwditer=iter, revxerr=revxerr, revyerr=revyerr, reviter=reviter]

where fwdxerr and fwdyerr are the maximum errors along each axis found when projecting from the original image to the distorted header; revxerr and revyerr are the maximum errors along each axis found when projecting from the distorted header back to the original header; and fwditer and reviter are the number of iterations required in each direction to converge on a solution.

Messages

OK: [struct stat="OK", fwdxerr=fwdxerr, fwdyerr=fwdyerr, fwditer=iter, revxerr=revxerr, revyerr=revyerr, reviter=reviter]

ERROR: -i (iterations) argument

ERROR: -o (order) argument

ERROR: -t (tolerance) argument

ERROR: Cannot open status file: statusfile

ERROR: Cannot open output template file new.hdr

ERROR: All points offscale in forward transform

ERROR: All points offscale in reverse transform

ERROR: Bad template: orig.hdr

ERROR: Output wcsinit() failed.

ERROR: Singular Matrix-1

ERROR: Singular Matrix-2

ERROR: Allocation failure in ivector()

Examples

$ mTANHdr input/SIN_1.hdr alternate.hdr: [struct stat="OK", fwdxerr=4.31068e-05, fwdyerr=4.42599e-05, fwditer=4, revxerr=1.22123e-05, revyerr=1.19694e-05, reviter=4]

The output header is a FITS header template containing a TAN projection with polynomial focal plane distortions: alternate.hdr

Releases

5 releases since Debian 9 (Stretch); the text changed 1 time.

9
10–13