EnglishFrenchSpanish

OnWorks favicon

mTANHdr - Online in the Cloud

Run mTANHdr in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command mTANHdr that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

PROGRAM:

NAME


mTANHdr - Determine if there would be an equivalent distorted TAN projection

SYNOPSIS


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

DESCRIPTION


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

Use mTANHdr online using onworks.net services


Free Servers & Workstations

Download Windows & Linux apps

Linux commands

Ad