← Back to branch summary

~ubuntu-branches/debian/jessie/eso-midas/jessie

« back to all changes in this revision

Viewing changes to contrib/surfphot/help/rebin_deco.hlq

  • Committer: Package Import Robot
  • Author(s): Ole Streicher
  • Date: 2014-04-22 14:44:58 UTC
  • Revision ID: package-import@ubuntu.com-20140422144458-okiwi1assxkkiz39
Tags: upstream-13.09pl1.2+dfsg
Import upstream version 13.09pl1.2+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
contrib/surfphot/help/rebin_deco.hlq
 
1
% @(#)rebin_deco.hlq    19.1 (ESO-IPG) 02/25/03 13:30:33 
 
2
\se
 
3
SECTION./DECONVOLVE
 
4
\es\co
 
5
REBIN/DECONVOLVE                                            04-OCT-1988  LL,DB
 
6
\oc\su
 
7
REBIN/DECONVOLVE frame psf result zoom_x,zoom_y n_iter
 
8
        rebin image linearly in space and simultaneously deconvolve it with psf
 
9
\us\pu
 
10
Purpose:      Rebin an image linearly in space and simultaneously deconvolve
 
11
              it with user-supplied point spread function.
 
12
              (Reference: L.B. Lucy: 1974, Astron. J. 79, 745-754)
 
13
\up\sy
 
14
Syntax:       REBIN/DECONVOLVE frame [psf] result zoom_x,zoom_y [n_iter]
 
15
\ys\pa
 
16
              frame     = name of input image
 
17
\ap\pa
 
18
              psf       = name of point spread function image (default: psf)
 
19
\ap\pa
 
20
              result    = name of result frame
 
21
\ap\pa
 
22
              zoom_x,zoom_y = zoom factors in X and Y
 
23
\ap\pa
 
24
              no_iter   = number of iterations, defaulted to 1
 
25
\ap\no
 
26
Note:         1.) It is highly recommendable first to remove the
 
27
                  background to the lowest possible level, however NOT
 
28
                  thereby introducing pixels with negative fluxes. See also
 
29
                  commands FIT/FLAT_SKY, SUBTRACT/SKY, and FILTER/FILL.
 
30
\\
 
31
              2.) The PSF must have odd numbers of pixels in both X and Y
 
32
                  (which however do not have to be same for both coordinates);
 
33
                  it must be centered on the central pixel. The step sizes
 
34
                  must be the ones desired for the result frame. If the
 
35
                  empirically determined PSF (not zoomed) is n pixels wide,
 
36
                  it is recommended to construct from it the required
 
37
                  zoomed (by a factor z) PSF to have (n+2)*z pixels.
 
38
\\
 
39
              3.) The zoom factors must be odd integers and consistent with
 
40
                  the ratios of the step sizes of inframe and psf. Zoom
 
41
                  factors less than unity are illegal. For zoom_x =
 
42
                  zoom_y = 1, the command is functionally equivalent to
 
43
                  DECONVOLVE/IMAGE (but slower!).
 
44
\\
 
45
              4.) The result frame must have the same step size as the
 
46
                  point spread function. The number of pixels must be
 
47
                  compatible with the number of pixels of the input frame
 
48
                  and the zoom factors.
 
49
\\
 
50
              5.) If MID_WORK contains a file 'result.bdf', this file
 
51
                  will be interpreted as an initial approximation of the
 
52
                  result. Using the command n times with n_iter=1
 
53
                  therefore has the same effect as using it once with
 
54
                  n_iter=n except that intermediate results can be inspected.
 
55
\\
 
56
              6.) The command can be used particularly profitably in order
 
57
                  to improve the appearance of images with sparsely sampled
 
58
                  PSF's where the smearing effects of conventional rebinning
 
59
                  unwanted. It may also help to bring out faint features
 
60
                  more strongly against the background. Depending on various
 
61
                  factors, a larger number of iterations does not necessarily
 
62
                  imply better results.
 
63
\\
 
64
              7.) The contents of each pixel is interpreted as flux density
 
65
                  (e.g. surface brightness), i.e. flux per unit area in world
 
66
                  coordinates. This means that the sum over all output pixels
 
67
                  equals the sum over all input pixels times zoom_x times
 
68
                  zoom_y.
 
69
\\
 
70
              8.) Edge effects are suppressed by extrapolating the frame
 
71
                  beyond its edges at a constant level and with the flux of
 
72
                  the last pixel observed.
 
73
\\
 
74
              9.) Large frames in combination with large zoom factors may
 
75
                  exceed the available virtual memory.
 
76
\on\exs
 
77
Examples:
 
78
\ex
 
79
              REBIN/DECO observed seeing true 3,5 2
 
80
              Expand image observed.bdf by factors 3 and 5 in X and Y,
 
81
              respectively. At the same time deconvolve with psf seeing.bdf
 
82
              using 2 iterations. The result will be stored in frame
 
83
              true.bdf which will be newly created if not already existing.
 
84
              Issuing the very same command again will execute iterations
 
85
              Nos. 3 and 4 on frame true. The net effect is the same as
 
86
              the one of REBIN/DECO observed seeing true 3,5 4
 
87
\xe\sxe