evalpos

Synopsis

Get image values at a specified (RA,DEC)

Syntax

evalpos  infile ra dec [output] [tmpdir] [verbose]

Description

'evalpos' looks up the pixel value in an image at the input coordinates. A stack of input images can be used and evalpos will iterate through them, printing each value to the screen; only the value from the last file processed is stored in the "output" parameter. If the units are available in the image, they are printed to the screen with the output value.

Example

evalpos img.fits 09:19:09.547 +21:14:31.72
img.fits 09:19:09.547 +21:14:31.72 1.81125e-05 [photon cm^-2 s^-1]

pget evalpos output
1.81124851224013e-05

Gets the image value from img.fits at the location (RA,Dec)=(09:19:09.547,+21:14:31.72). The value is stored in the parameter file and printed to the screen with the units from the input file ([photon cm^-2 s^-1]) .

Parameters

name	type	ftype	def	min	max	reqd
infile	file	input				yes
ra	string					yes
dec	string					yes
output	real
tmpdir	file		/tmp
verbose	integer		0	0	5

Detailed Parameter Descriptions

Parameter=infile (file required filetype=input)

The input image name

The input image name. Multiple images can be input as a stack.

Parameter=ra (string required)

Right Ascension

Must be a string in sexigesimal format

Parameter=dec (string required)

Declination

Must be a string in sexigesimal format

Parameter=output (real)

The output value

The output value from the last image in the stack

Parameter=tmpdir (file default=/tmp)

Temporary directory

Name of the directory for temporary files.

Parameter=verbose (integer default=0 min=0 max=5)

The tool chatter level

Verbose can be from 0 to 5, generating different amounts of debugging output.

Bugs

Locations picked just outside the image boundary may return incorrect values with method=closest

The wrong value is returned when using method=closest for locations outside the image boundary but within 0.5 of a pixel of the bottom and left side of the image.

All locations outside the image should return a NaN; however, for these locations the closest edge pixel location is returned.