listpixels images
images
Images or list of image sections whose pixels are to be printed.
wcs = logical
The world coordinate system to be used for coordinate output. The following
standard systems are defined.
logical
Logical coordinates are image pixel coordinates relative to the input
image. For example the pixel coordinates of the lower left corner
of an image section will always be (1,1) in logical units regardless of
their values in the original image.
physical
Physical coordinates are image pixel coordinates with respect to the original
image. For example the pixel coordinates of the lower left corner
of an image section will be its coordinates in the original image,
including the effects of any linear transformations done on that image.
Physical coordinates are invariant with respect to transformations
of the physical image matrix.
world
World coordinates are image pixel coordinates with respect to the
current default world coordinate system. For example in the case
of spectra world coordinates would most likely be in angstroms.
The default world coordinate system is the system named by the environment
variable defwcs if defined in the user environment and present in
the image world coordinate system description, else it is the first user
world coordinate system defined for the image, else physical coordinates
are returned.
In addition to these three reserved world coordinate system names, the names of any user world coordinate system defined for the image may be given.
formats =
The default output formats for the pixel coordinates, one format
per axis, with the individual formats separated by whitespace .
If formats are undefined, listpixels uses the formatting options
stored with the WCS in the image header. If the WCS formatting options
are not stored in the image header, then listpixels uses a default
value.
verbose = no
Print a title line for each image whose pixels are to be listed.
The pixel coordinates in the world coordinates system specified by wcs and using the formats specified by formats are printed on the standard output on the standard output followed by the pixel value.
A format specification has the form "%w.dCn", where w is the field width, d is the number of decimal places or the number of digits of precision, C is the format code, and n is radix character for format code "r" only. The w and d fields are optional. The format codes C are as follows:
b boolean (YES or NO)
c single character (c or ' or 'nn')
d decimal integer
e exponential format (D specifies the precision)
f fixed format (D specifies the number of decimal places)
g general format (D specifies the precision)
h hms format (hh:mm:ss.ss, D = no. decimal places)
m minutes, seconds (or hours, minutes) (mm:ss.ss)
o octal integer
rN convert integer in any radix N
s string (D field specifies max chars to print)
t advance To column given as field W
u unsigned decimal integer
w output the number of spaces given by field W
x hexadecimal integer
z complex format (r,r) (D = precision)
Conventions for w (field width) specification:
W = n right justify in field of N characters, blank fill
-n left justify in field of N characters, blank fill
0n zero fill at left (only if right justified)
absent, 0 use as much space as needed (D field sets precision)
Escape sequences (e.g. " for newline):
backspace (not implemented)
formfeed
newline (crlf)
carriage return
tab
string delimiter character
character constant delimiter character
backslash character
n octal value of character
Examples
%s format a string using as much space as required
%-10s left justify a string in a field of 10 characters
%-10.10s left justify and truncate a string in a field of 10 characters
%10s right justify a string in a field of 10 characters
%10.10s right justify and truncate a string in a field of 10 characters
%7.3f print a real number right justified in floating point format
%-7.3f same as above but left justified
%15.7e print a real number right justified in exponential format
%-15.7e same as above but left justified
%12.5g print a real number right justified in general format
%-12.5g same as above but left justified
%h format as nn:nn:nn.n
%15h right justify nn:nn:nn.n in field of 15 characters
%-15h left justify nn:nn:nn.n in a field of 15 characters
%12.2h right justify nn:nn:nn.nn
%-12.2h left justify nn:nn:nn.nn
%H / by 15 and format as nn:nn:nn.n
%15H / by 15 and right justify nn:nn:nn.n in field of 15 characters
%-15H / by 15 and left justify nn:nn:nn.n in field of 15 characters
%12.2H / by 15 and right justify nn:nn:nn.nn
%-12.2H / by 15 and left justify nn:nn:nn.nn
insert a newline
EXAMPLES 1. List the pixels of an image on the standard output.
cl> listpix m81
2. List a subraster of the above image in logical coordinates.
cl> listpix m81[51:55,151:155] 1. 1. ... 2. 1. ... 3. 1. ... 4. 1. ... 5. 1. ... 1. 2. ... .. .. ...
3. List the same subraster in physical coordinates.
cl> listpix m81[51:55,151:155] wcs=physical 51. 151. ... 52. 151. ... 53. 151. ... 54. 151. ... 55. 151. ... 51. 152. ... ... .... ...
4. List a spectrum that has been dispersion corrected in angstrom units.
cl> listpix n7027 wcs=world
5. List the RA and DEC coordinates in hms and dms format and pixels value for an image section where axis 1 is RA and axis 2 is DEC.
cl> listpix m51 wcs=world formats="%H %h"
imheader, imgets, imhistogram,