aboutsummaryrefslogtreecommitdiff
path: root/noao/obsutil/src/doc/psfmeasure.hlp
blob: 479268b1e07dba6567714ad0e443e8ad3974bedb (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
.help psfmeasure Nov01 noao.obsutil
.ih
NAME
psfmeasure -- Measure PSF widths in stellar images
.ih
USAGE
psfmeasure images
.ih
PARAMETERS
.ls images
List of images.
.le
.ls coords = "mark1" (center|mark1|markall)
Method by which the coordinates of objects to be measured are specified.
If "center" then a single object at the center of each image is measured.
If "mark1" then the \fIimagecur\fR parameter, typically the interactive
image display cursor, defines the coordinates of one or more objects in the
first image ending with a 'q' key value and then the same coordinates are
automatically used in subsequent images.  If "markall" then the
\fIimagecur\fR parameter defines the coordinates for objects in each image
ending with a 'q' key value.
.le
.ls wcs = "logical" (logical|physical|world)
Coordinate system for input coordinates.  When using image cursor input
this will always be "logical".  When using cursor input from a file this
could be "physical" or "world".
.le
.ls display = yes, frame = 1
Display the image or images as needed?  If yes the image display is checked
to see if the image is already in one of the display frames.  If it is not
the \fBdisplay\fR task is called to display the image in the frame
specified by the \fBframe\fR parameter.  All other display parameters are
taken from the current settings of the task.  This option requires that the
image display be active.  A value of no is typically used when an input
cursor file is used instead of the image display cursor.  An image display
need not be active in that case.
.le

.ls level = 0.5
The parameter used to quantify an object image size is the radius from the
image center enclosing the fraction of the total flux given by this
parameter.  If the value is greater than 1 it is treated as a percentage.
.le
.ls size = "FWHM" (Radius|FWHM|GFWHM|MFWHM)
There are four ways the PSF size may be shown in graphs and given in
the output.  These are:

.nf
    Radius - the radius enclosing the specified fraction of the flux
    FWHM   - a direct FWHM from the measured radial profile
    GFWHM  - the FWHM of the best fit Gaussian profile
    MFWHM  - the FWHM of the best fit Moffat profile
.fi

The labels in the graphs and output will be the value of this parameter
to distinguish the different types of size measurements.
.le
.ls beta = INDEF
For the Moffat profile fit (size = MFWHM) the exponent parameter may
be fixed at a specified value or left free to be determined from the
fit.  The exponent parameter is determined by the fit if \fIbeta\fR
task parameter is INDEF.
.le
.ls scale = 1.
Pixel scale in user units per pixel.  Usually the value is 1 to measure
sizes in pixels or the image pixel scale in arc seconds per pixel.
.le
.ls radius = 5., iterations = 3
Measurement radius in pixels and number of iterations on the radius.  The
enclosed flux profile is measured out to this radius.  This radius may be
adjusted if the \fIiteration\fR parameter is greater than 1.  In that case
after each iteration a new radius is computed from the previous direct FWHM
estimate.  The new radius is three times direct FWHM (six times the
half-maximum radius).  The purpose of this is so that if the initial PSF
size of the image need not be known.  However, the radius should then be
larger than true image size since the iterations best converge to smaller
values.
.le
.ls sbuffer = 5, swidth = 5.
Sky buffer and sky width in pixels.  The buffer is added to the specified
measurement \fIradius\fR to define the inner radius for a circular sky
aperture.  The sky width is the width of the circular sky aperture.
.le
.ls saturation=INDEF, ignore_sat=no
Data values (prior to sky subtraction) to be considered saturated within
measurement radius.  A value of INDEF treats all pixels as unsaturated.  If
a measurement has saturated pixels there are two actions.  If
\fIignore_sat\fR=no then a warning is given but the measurement is saved
for use.  The object will also be indicated as saturated in the output
log.  If \fIignore_sat\fR=yes then a warning is given and the object is
discarded as if it was not measured.
.le
.ls xcenter = INDEF, ycenter = INDEF
The optical field center of the image given in image pixel coordinates.
These values need not lie in the image.  If INDEF the center of the image
is used.  These values are used to make plots of size verse distance from
the field center for studies of radial variations.
.le
.ls logfile = "logfile"
File in which to record the final results.  If no log file is desired a
null string may be specified.
.le

.ls imagecur = ""
Image cursor input for the "mark1" and "markall" options.  If null then the
image dispaly cursor is used interactively.  If a file name is specified
then the coordinates come from this file.  The format of the file are lines
of x, y, id, and key.  Values of x an y alone may be used to select objects
and the single character 'q' (or the end of the file) may be used to end
the list.
.le
.ls graphcur = ""
Graphics cursor input.  If null then the standard graphics cursor
is used otherwise a standard cursor format file may be specified.
.le
.ih
CURSOR COMMANDS
When selecting objects with the image cursor the following commands are
available.

.nf
?  Page cursor command summary
g  Measure object and graph the results.
m  Measure object.
q  Quit object marking and go to next image.
   At the end of all images go to analysis of all measurements.

:show  Show current results.
.fi

When in the interactive graphics the following cursor commands are available.
All plots may not be available depending on the number of stars.

.nf
?  Page cursor command summary
a  Spatial plot
d  Delete star nearest to cursor
e  Enclosed flux for all stars
i  Information about star nearest the cursor
m  Size and ellipticity vs relative magnitude
n  Normalize enclosed flux at x cursor position
o  Offset enclosed flux by adjusting background
p  Radial profiles for all stars
q  Quit
r  Redraw
s  Toggle magnitude symbols in spatial plot
t  Size and ellipticity vs radius from field center
u  Undelete all deleted points
x  Delete nearest point or star (selected by query)
z  Zoom to a single measurement
<space> Step through different stars in some plots

:beta <val>     Set the beta parameter for the Moffat profile fit
:level <val>	Level at which the size parameter is evaluated
:overplot <y|n> Overplot the profiles from the narrowest profile?
:radius <val>   Change profile radius
:show <file>	Page all information for the current set of objects
:size <type>	Size type (Radius|FWHM)
:scale <val>	Pixel scale for size values
:xcenter <val>	X field center for radius from field center plots
:ycenter <val>	Y field center for radius from field center plots
.fi
.ih
DESCRIPTION
This task measures the point-spread function (PSF) width of stars or other
unresolved objects in digital images.  The width is measured from the
enclosed flux verses radius profile.  The details of this are described in
the ALGORITHMS section.  Measurements of multiple stars in multiple images
may be made.  When there are multiple stars, variations in the PSF with
position may be examined.  The task has three stages; selecting objects and
measuring the PSF width and other parameters, an interactive graphical
analysis, and a final output of the results to the terminal and to a
logfile.

If a saturation value is specified then all pixels within the specified
measurement radius are checked for saturation.  If any saturated pixels are
found a warning is given and \fIignore_sat\fR parameter may be used ot
ignore the measurement.  If not ignored the object will still be indicated
as saturated in the output log.  In a focus sequence only the saturated
objects are discarded and not the whole sequence.

The input images are specified by an image template list.  The list may
consist of explicit image names, wildcard templates, and @ files.
Identifying the object or objects to be measured may be accomplished in
several ways.  If a single object near the center of the image is to be
measured then the \fIcoords\fR parameter takes the value "center".  When
the "center" option is used the \fIdisplay\fR and \fIimagecur\fR parameters
are ignored.

If there are multiple objects or the desired object is not at the center of
the frame the object coordinates are entered with the \fIimagecur\fR
parameter.  This type of coordinate input is selected by specifying either
"mark1" or "markall" for the \fIcoords\fR parameter.  If the value is
"mark1" then the coordinates are entered for the first image and the same
values are automatically used for subsequent images.  If "markall" is
specified then the objects in each image are marked.

Normally the \fIimagecur\fR parameter would select the interactive image
display cursor though a standard cursor file could be used to make this
part noninteractive.  When the image display cursor is used either the
image must be displayed previously by the user, or the task may be allowed
to load the image display using the \fBdisplay\fR task by setting the
parameter \fIdisplay\fR to yes and \fIframe\fR to a display frame.  If yes
the image display must be active.  The task will look at the image names as
stored in the image display and only load the display if needed.

If one wants to enter a coordinate list rather than use the interactive
image cursor the list can consist of just the column and line coordinates
since the key will default to 'm'.  To finish the list either the end
of file may be encountered or a single 'q' may be given since the
coordinates are irrelevant.  For the "markall" option with multiple
images there would need to be a 'q' at the end of each object except
possibly the last.

When objects are marked interactively with the image cursor there
are a four keys which may be used as shown in the CURSOR COMMAND section.
The important distinction is between 'm' to mark and measure an
object and 'g' to mark, measure, and graph the results.  The former
accumulates the results until the end while the latter can give an
immediate result to be examined.  Unless only one object is marked
the 'g' key also accumulates the results for later graphical analysis.
It is important to note that the measurements are done as each
object is marked so there can be a significant delay before the
next object may be marked.

The quantities measured and the algorithms used are described in the
ALGORITHMS section.  Once all the objects have been measured an
interactive (unless only one object is measured) graphical presentation
of the measurements is entered.

When the task exits it prints the results to the terminal (STDOUT) and also
to the \fIlogfile\fR if one is specified.  The results may also be
previewed during the execution of the task with the ":show" command.  The
results begin with a banner and the overall estimate of the PSF size.
Following this the individual measurements are given.  The columns give the
image name, the column and line position, the relative magnitude, the PSF
size as either the enclosed flux radius or the various FWHM, the
ellipticity, and the position angle.
.ih
ALGORITHMS
The PSF of an object is characterized using a radially symmetric
enclosed flux profile.  First the center of the object is determined from
an initial rough coordinate.  The center is computed from marginal profiles
which are sums of lines or columns centered at the initial coordinate and
with a width given by the sum of the \fIradius\fR, \fIsbuffer\fR, and
\fIswidth\fR parameters.  The mean of the marginal profile is determined
and then the centroid of the profile above this is computed.  The centroids
from the two marginal profiles define a new object center.  These steps of
forming the marginal profiles centered at the estimated object position and
then computing the centroids are repeated until the centroids converge or
three iterations have been completed.

Next a background is determined from the mode of the pixel values in the
sky annulus defined by the object center and \fIradius\fR, \fIsbuffer\fR,
and \fIswidth\fR parameters.  The pixel values in the annulus are sorted
and the mode is estimated as the point of minimum slope in this sorted
array using a width of 5% of the number of points.  If there are multiple
regions with the same minimum slope the lowest pixel value is used.

The background subtracted enclosed flux profile is determined next.
To obtain subpixel precision and to give accurate estimates for small
widths relative to the pixel sampling, several things are done.
First interpolation between pixels is done using a cubic spline surface.
The radii measured are in subpixel steps.  To accommodate small and
large PSF widths (and \fIradius\fR parameters) the steps are nonuniform
with very fine steps at small radii (steps of 0.05 pixels in the
central pixel) and coarser steps at larger radii (beyond 9 pixels
the steps are one pixel) out to the specified \fIradius\fR.  Similarly each
pixel is subsampled finely near the center and more coarsely at larger
distances from the object center.  Each subpixel value, as obtained by
interpolation, is background subtracted and added into the enclosed flux
profile.  Even with subpixel sampling there is still a point where a
subpixel straddles a particular radius.  At those points the fraction of
the subpixel dimension in radius falling within the radius being measured
is used as the fraction of the pixel value accumulated.

Because of errors in the background determination due to noise and
contaminating objects it is sometimes the case that the enclosed flux
is not completely monotonic with radius.  The enclosed flux
normalization, and the magnitude used in plots and reported in
results, is the maximum of the enclosed flux profile even if it
occurs at a radius less than the maximum radius.  It is possible
to change the normalization and subtract or add a background correction
interactively.

Because a very narrow PSF will produce significant errors in the cubic
spline interpolation due to the steepness and rapid variation in the pixel
values near the peak, the Gaussian profile with FWHM that encloses the same
80% of the flux is computed as:

    FWHM(80%) = 2 * r(80%) * sqrt (ln(2) / (ln (1/.2)))

If this is less than five pixels the Gaussian model is subtracted from the
data.  The Gaussian normalization is chosed to perfectly subtract the
central pixel.  The resulting subtraction will not be perfect but the
residual data will have much lower amplitudes and variations.  A spline
interpolation is fit to this residual data and the enclosed flux profile is
recomputed in exactly the same manner as previously except the subpixel
intensity is evaluated as the sum of the analytic Gaussian and the
interpolation to the residual data.

The Gaussian normalization is chosed to perfectly subtract the central
pixel.  The resulting subtraction will not be perfect but the residual data
will have much lower amplitudes and variations.  A spline interpolation is
fit to this residual data and the enclosed flux profile is recomputed in
exactly the same manner as previously except the subpixel intensity is
evaluated as the sum of the analytic Gaussian and the interpolation to the
residual data.  This technique yields accurate FWHM for simulated Gaussian
PSFs down to at least a FWHM of 1 pixel.

In addition to the enclosed flux profile, an estimate of the radially
symmetric intensity profile is computed from the enclosed flux profile.
This is based on the equation

.nf
    F(R) = integral from 0 to R { P(r) r dr }
.fi

where F(R) is the enclosed flux at radius R and P(r) is the intensity per
unit area profile.  Thus the derivative of F(R) divided by R gives an
estimate of P(R).

Cubic spline interpolation functions are fit to the normalized enclosed
flux profile and the intensity profile.  These are used to find the radius
enclosing any specified fraction of the flux and to find the direct FWHM of
the intensity profile.  These are output when \fIsize\fR is "Radius" or
"FWHM" respectively.

In addition to enclosed flux radius and direct FWHM size measurements
there are also two size measurements based on fitting analytic profiles.
A Gaussian profile and a Moffat profile are fit to the final enclosed flux
profile to the points with enclosed flux less than 80%.  The limit is
included to minimize the effects of poor background values and to make the
profile fit be representative of the core of the PSF profile.  These profiles
are fit whether or not the selected \fIsize\fR requires it.  This is done
for simplicity and to allow quickly changing the size estimate with the
":size" command.

The intensity profile functions (with unit peak) are:

.nf
    I(r) = exp (-0.5 * (r/sigma)**2)			Gaussian
    I(r) = (1 + (r/alpha)**2)) ** (-beta)		Moffat
.fi

with parameters sigma, alpha, and beta.  The normalized enclosed flux
profiles, which is what is actually fit, are then:

.nf
    F(r) = 1 - exp (-0.5 * (r/sigma)**2)		Gaussian
    F(r) = 1 - (1 + (r/alpha)**2)) ** (1-beta)		Moffat
.fi

The fits determine the parameters sigma or alpha and beta (if a
beta value is not specified by the users).  The reported FWHM values
are given by:

.nf
    GFWHM = 2 * sigma * sqrt (2 * ln (2))		Gaussian
    MFWHM = 2 * alpha * sqrt (2 ** (1/beta) - 1)	Moffat
.fi

were the units are adjusted by the pixel scale factor.

In addition to the four size measurements there are several additional
quantities which are determined.  
Other quantities which are computed are the relative magnitude,
ellipticity, and position angle.  The magnitude of an individual
measurement is obtained from the maximum flux attained in the enclosed
flux profile computation.  Though the normalization and background may be
adjusted interactively later, the magnitude is not changed from the
initial determination.  The relative magnitude of an object is then
computed as

.nf
    rel. mag. = -2.5 * log (object flux / maximum star flux)
.fi

The maximum star magnitude over all stars is used as the zero point for the
relative magnitudes (hence it is possible for an individual object relative
magnitude to be less than zero).

The ellipticity and positional angle of an object are derived from the
second central intensity weighted moments.  The moments are:

.nf
	Mxx = sum { (I - B) * x * x } / sum { I - B }
	Myy = sum { (I - B) * y * y } / sum { I - B }
	Mxy = sum { (I - B) * x * y } / sum { I - B }
.fi

where x and y are the distances from the object center, I is
the pixel intensity and B is the background intensity.  The sum is
over the same subpixels used in the enclosed flux evaluation with
intensities above an isophote which is slightly above the background.
The ellipticity and position angles are derived from the moments
by the equations:

.nf
	M1 = (Mxx - Myy) / (Mxx + Myy)
	M2 = 2 * Mxy / (Mxx + Myy)
	ellip = (M1**2 + M2**2) ** 1/2
	pa = atan (M2 / M1) / 2
.fi

where ** is the exponentiation operator and atan is the arc tangent
operator.  The ellipticity is essentially (a - b) / (a + b) where a
is a major axis scale length and b is a minor axis scale length.  A
value of zero corresponds to a circular image.  The position angle is
given in degrees counterclockwise from the x or column axis.

The overall size when there are multiple stars is estimated by averaging
the individual sizes weighted by the flux of the star as described above.
Thus, when there are multiple stars, the brighter stars are given greater
weight in the average size.  This average size is what is given in the
banner for the graphs and in the printed output.

One of the quantities computed for the graphical analysis is the
FWHM of a Gaussian or Moffat profile that encloses the same flux
as the measured object as a function of the level.  The equation are:

.nf
   FWHM = 2 * r(level) * sqrt (ln(2.) / ln (1/(1-level)))  Gaussian

   FWHM = 2 * r(level) * sqrt (2**(1/beta)-1) /
	  sqrt ((1-level)**(1/(1-beta))-1)		   Moffat
.fi

where r(level) is the radius that encloses "level" fraction of the total
flux.  ln is the natural logarithm and sqrt is the square root.  The beta
value is either the user specified value or the value determined by fitting
the enclosed flux profile.

This function of level will be a constant if the object profile matches
the Gaussian or Moffat profile.  Deviations from a constant show
the departures from the profile model.  The Moffat profile used in making
the graphs except for the case where the \fIsize\fR is GFWHM.
.ih
INTERACTIVE GRAPHICS MODE
The graphics part of \fBpsfmeasure\fR consists of a number of different
plots selected by cursor keys.  The available plots depend on the number of
stars.  The various plots and the keys which select them are summarized
below.

.nf
a  Spatial plot
e  Enclosed flux for all stars
m  Size and ellipticity vs relative magnitude
p  Radial profiles for all stars
t  Size and ellipticity vs radius from field center
z  Zoom to a single measurement
.fi

If there is only one object the only available plot is
the 'z' or zoom plot.  This has three graphs; a graph of the normalized
enclosed flux verses scaled radius, a graph of the intensity profile verses
scaled radius, and equivalent Moffat/Gaussian full width at half maximum verses
enclosed flux fraction.  The latter two graphs are derived from the
normalized enclosed flux profile as described in the ALGORITHMS section.
In the graphs the measured points are shown with symbols, a smooth curve is
drawn through the symbols and dashed lines indicate the measurement level
and enclosed flux radius at that level.

Overplotted on these graphs are the Moffat profile fit or the
Gaussian profile fit when \fIsize\fR is GFWHM.

The zoom plot is always available from any other plot.  The cursor position
when the 'z' key is typed selects a particular object measurement.
This plot is also the one presented with the 'g' key when marking objects for
single exposure images.  In that case the graphs are drawn followed by
a return to image cursor mode.

There are two types of symbol plots showing the measured PSF size (either
enclosed flux radius or FWHM) and ellipticity.  These plot the measurements
verses relative magnitude ('m' key) and radius from the field center ('t'
key).  These plots are only available when there are multiple stars
measured.  The magnitude plot is the initial plot in this case.  The field
center for the field radius graph may be changed interactively using the
":xcenter" and ":ycenter" commands.

Grids of enclosed flux vs. radius, intensity profile vs. radius, and
FWHM vs. enclosed flux fraction are shown with the 'e', 'p', and
'g' keys respectively when there is more than one star.  The grid shows
a profile for each star.  The profiles in the grid have no axis labels or
ticks.  Within each box are the coordinates of the object
and the PSF size.  Below the grid is shown a graph of a single objects
including axis labels and ticks.

In the grid there is one profile which is highlighted (by a second box or
by a color border).  This is the profile shown in the lower graph.  To
change the star in the lower graph on can type the space bar to advance to
the next star or use the cursor and the 'e', 'p', or 'g' key again.  Other
keys will select another plot using the star nearest the cursor to select a
measurement.

Any of the graphs with enclosed flux or intensity profiles vs radius may
have the profiles of the object with the smallest size overplotted.  The
overplot has a dashed line, a different color on color graphics devices,
and no symbols marking the measurement points.  The overplots may be
enabled or disabled with the ":overplot" command.  Initially it is
disabled.

The final plot, the 'a' key, gives a spatial representation.  This requires
more than one star.  This plot has a central graph of column and line
coordinates with symbols indicating the position of an object.  The objects
are marked with a circle (when plotted at unit aspect ratio) whose size is
proportional to the measured PSF size.  In addition an optional asterisk
symbol with size proportional to the relative brightness of the object may
be plotted.  This symbol is toggled with the 's' key.  On color displays
the circles may have two colors, one if object size is above the average
best size and the other if the size is below the best size.  The purpose of
this is to look for a spatial pattern in the PSF sizes.

Adjacent to the central graph are graphs with column or line as one
coordinate and radius or ellipticity as the other.  The symbols
are the same as described previously.  These plots can show spatial
gradients in the PSF size and shape across the image.

In addition to the keys which select plots there are other keys which
do various things.  These are summarized below.

.nf
?  Page cursor command summary
d  Delete star nearest to cursor
i  Information about point nearest the cursor
n  Normalize enclosed flux at x cursor position
o  Offset enclosed flux by adjusting background
q  Quit
r  Redraw
s  Toggle magnitude symbols in spatial plots
u  Undelete all deleted points
x  Delete nearest point or star (selected by query)
<space> Step through different stars in current plot type
.fi

The help, redraw, and quit keys are provide the standard functions.
The 's' and space keys were described previously.  The 'i' key
locates the nearest object to the cursor in whatever plot is shown and
prints one line of information about the object on the graphics device
status area.

The 'd' key deletes the star nearest the cursor in whatever plot is
currently displayed.  To delete all objects from an image, all
values for one star (the same as 'd'), or a
single measurement, the 'x' key is used.  Typing this key produces a query
for which type of deletion and the user responds with 'i', 's', or
'p'.  Deleted measurements do not appear in any subsequent
graphics, are excluded from all computations, and are not output in the
results.  The 'u' key allows one to recover deleted measurements.  This
undeletes all previously deleted data.

Due to various sources of error the sky value may be wrong causing
the enclosed flux profile to not converge properly but instead
decreases beyond some point (overestimated sky) or linearly
increases with radius (underestimated sky).  This affects the size
measurement by raising or lowering the normalization and altering
the shape of the enclosed flux profile.  The 'n' and 'o' keys allow
fudging the enclosed flux profiles.  These keys apply only in
the zoom plot or 'e' key plot of the enclosed flux profile.

The 'n' key normalizes the enclosed flux profile at the point
set by the x position of the cursor.  The 'o' key increases or
decreases the background estimate to bring curve up or down to
the point specified by the cursor.  The effect of this is to
add or subtract a quadratic function since the number of pixels
at a particular radius varies as the square of the radius.
To restore the original profile, type 'n' or 'o' at a radius
less than zero.

The colon commands, shown below, allow checking or changing parameters
initially set by the task parameters, toggling the overplotting of the
smallest PSF profiles, and showing the current results.  The overplotting
option and the contents of the results displayed by :show were described
previously.

.nf
:beta <val>     Beta value for Moffat profile fits
:level <val>	Level at which the size parameter is evaluated
:overplot <y|n> Overplot the profiles from the narrowest profile?
:radius <val>   Change profile radius
:show <file>	Page all information for the current set of objects
:size <type>	Size type (Radius|FWHM)
:scale <val>	Pixel scale for size values
:xcenter <val>	X field center for radius from field center plots
:ycenter <val>	Y field center for radius from field center plots
.fi

The important values which one might want to change interactively are
the measurement level and the profile radius.  The measurement level
directly affects the results reported.  When it is changed the sizes
of all object PSFs are recomputed and the displayed plots and title
information are updated.  The profile radius is the
maximum radius shown in plots and used to set the enclosed flux normalization.
It does not affect the object centering or sky region definition and
evaluation which are done when the image data is accessed.  Because
the objects are not remeasured from the image data the radius may
not be made larger than the radius defined by the task parameter though
it may be decreased and then increased again.
.ih
EXAMPLES
1.  An image of a star field is studied with default values.

.nf
cl> psfmeasure field1
<The image is displayed and the image cursor activated>
<A number of brighter stars are marked>
<Marking is finished with 'q'>
<Graph of FWHM and ellipticity vs relative magnitude are shown>
<A couple of bad measurements due to blending are deleted>
<Exit with 'q'>
NOAO/IRAF IRAFV2.10.3 valdes@puppis Tue 18:22:36 06-Jul-93
  Average full width at half maximum of 4.5722

       Image  Column    Line     Mag    FWHM   Ellip      PA SAT
      field1   68.96   37.87    0.75   5.636    0.03      15
	      488.41  116.78    1.61   5.376    0.03     -68
	       72.17  156.35    1.47   4.728    0.06     -14
	       33.72  211.86    2.74   4.840    0.05     -52
	      212.80  260.73    2.99   3.888    0.11      83
	      250.51  277.37    1.92   3.914    0.02     -14
	      411.81  292.83    1.93   5.032    0.04      34
	      131.85  301.12    2.67   4.028    0.06       4
	      168.37  413.70    2.20   4.408    0.05      75
	      256.02  255.99    0.00   3.940    0.00     -70

The estimated average FWHM is 4.5722.  The variation in size is real
in this artificial image having a radial variation in PSF.
.ih
SEE ALSO
.nf
imexamine, implot, pprofile, pradprof, radlist, radplt, radprof,
specfocus, starfocus, splot
.endhelp