mFixNaN - Online in the Cloud

This is the command mFixNaN 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


mFixNaN - Replace a particular set of values in a FITS image with NaNs (or vice-versa)

SYNOPSIS


mFixNaN [-d level] [-v NaN-value] in.fits out.fits [minblank maxblank]

DESCRIPTION


Converts NaNs found in the image to some other value (given by the user), or converts a
range of supplied values into NaNs.

OPTIONS


-d level
Turn on debugging to the specified level (1-3)

-v NaN-value
Value to use in place of any NaNs

ARGUMENTS


in.fits
Input FITS image file

out.fits
Path of output FITS file. To run in "count" mode without creating an output file,
use a dash ("-") for this argument.

minblank maxblank
If the "-v" switch is not used, mFixNaN will replace all pixel values between
minblank and maxblank with NaN.

RESULT


[struct stat="OK", rangeCount=rangeCount, nanCount=nanCount]

rangeCount is the number of pixels that were found between minblank and maxblank, if they
were specified. If not (i.e., NaNs were removed and replaced with value), nanCount is the
number of NaNs removed.

MESSAGES


OK [struct stat="OK", rangeCount=rangeCount, nanCount=nanCount"]

ERROR No debug level given

ERROR Debug level string is invalid: level

ERROR Debug level string is invalid: level

ERROR Debug level string cannot be negative

ERROR No value given for NaN conversion

ERROR NaN conversion value string is invalid: 'NaN-value'

ERROR Invalid input file 'in.fits']

ERROR min blank value string is not a number

ERROR max blank value string is not a number

ERROR Image file in.fits missing or invalid FITS

ERROR FITS library error

EXAMPLES


A FITS image with BITPIX -64 (double-precision floating point) was generated without using
NaNs; all "blank" pixels are represented by very small negative numbers. This can throw
off initial attempts to display the image with a proper stretch, and does not conform to
the FITS standard. To replace all those "blank" pixels with NaNs:

mFixNaN original.fits NaN.fits -4.61169e32 -4.61169e10
[struct stat="OK", rangeCount=1321, nanCount=0]

To convert those NaNs back into a single pixel value:

mFixNaN -v -4.6e32 NaN.fits blankval.fits
[struct stat="OK", rangeCount=0, nanCount=1321]

Use mFixNaN online using onworks.net services



Latest Linux & Windows online programs