Last modified: December 2013

URL: https://cxc.cfa.harvard.edu/ciao/ahelp/evalpos.html
Jump to: Description · Example · Parameters · Bugs · See Also


AHELP for CIAO 4.12

evalpos

Context: tools

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

See the bugs page for this tool on the CIAO website for an up-to-date listing of known bugs.

Refer to the CIAO bug pages for an up-to-date listing of known issues.

See Also

dm
dmfiltering
tools
centroid_map, contour_map, dmappend, dmcontour, dmellipse, dmfilth, dmimg2jpg, dmimgadapt, dmimgblob, dmimgcalc, dmimgdist, dmimgfilt, dmimggrad, dmimghist, dmimghull, dmimglasso, dmimgpick, dmimgpm, dmimgproject, dmimgreproject, dmimgthresh, dmmaskbin, dmmaskfill, dmnautilus, dmregrid, dmregrid2, dmstat, dragon_scales, emodel, grow_from_max, hexgrid, imgmoment, map2reg, mean_energy_map, merge_too_small, mkregmap, pathfinder, pileup_map