~ubuntu-branches/ubuntu/wily/eso-midas/wily-proposed

« back to all changes in this revision

Viewing changes to contrib/romafot/help/mfit_roma.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:
 
1
% @(#)mfit_roma.hlq     19.1 (ESO-IPG) 02/25/03 13:29:28 
 
2
\se                                                                             
 
3
SECTION./ROMAFOT
 
4
\es\co                                                                          
 
5
MFIT/ROMAFOT                                                26-OCT-1989 RHW
 
6
\oc\su                                                                          
 
7
MFIT/ROMAFOT frame [int_tab] [thres,sky] [sig,sat,tol,iter] [meth,[beta]]
 
8
        [fit_opt] [mean_opt] [mod_file]
 
9
        determine characteristics of stellar images by non-linear fitting
 
10
\us\pu
 
11
Purpose: Determine characteristics of stellar images by non-linear
 
12
         fitting. The integral of the PSF is computed over the pixel area.
 
13
\up\sy                                                                          
 
14
Syntax:  MFIT/ROMAFOT frame [int_tab] [thres,sky] [sig,sat,tol,iter] 
 
15
                      [meth,[beta]] [fit_opt] [mean_opt] [mod_file]
 
16
\ys\pa                                                                          
 
17
         frame =      input image frame
 
18
\ap\pa                                                                          
 
19
         int_tbl =    name of the intermediate table which contains the 
 
20
                      selected objects; default is the frame name with 
 
21
                      the extension `INT'.
 
22
\ap\pa
 
23
         thres,sky =  photometric threshold and sky background. Data below the
 
24
                      threshold will be ignored. Default values are those used 
 
25
                      in the commands SKY/ROMAFOT and indicated in FIND/ROMAFOT.
 
26
\ap\pa
 
27
         sig,sat,tol,iter = trial value for sigma (parameter for the width of
 
28
                      the Gaussian or Moffet curve), the saturation, the shift
 
29
                      tolerance, and the maximum number of iterations for each
 
30
                      each window. The defaults for sigma and saturation are 
 
31
                      the values used by previous commands (SKY/ROMAFOT); the
 
32
                      default shift tolerance is 2 pixels, and for the number of
 
33
                      iterations 50.
 
34
\ap\pa                                                                          
 
35
         meth,beta =  non-linear fitting method to be used. One can choose
 
36
                      between two fitting functions:\\
 
37
                      GI: a Gaussian function with inverse prop. weighting;\\
 
38
                      GU: a Gaussian function with uniform weighting;\\
 
39
                      MI,number: Moffat function with inverse proportional
 
40
                                 weighting and with beta factor number;\\
 
41
                      MU,number: Moffat function with uniform weighting and
 
42
                                 with beta factor number.\\
 
43
                      The default is MU,4.0.
 
44
\ap\pa                                                                          
 
45
         fit_opt =    four character logical string consisting of `Y'
 
46
                      and `N', indicating which parameters should kept 
 
47
                      fixed. The meaning of the string is as follows:\\
 
48
                      position 1: fix sigma;\\
 
49
                      position 2: fix sky background;\\
 
50
                      position 3: fix position;\\
 
51
                      position 4: allow tilted plane.\\
 
52
                      The default is `YNNN'.
 
53
\ap\pa                                                                          
 
54
         mean_opt =   character indicating if mean values of previous 
 
55
                      windows should be used as trial values for the next.
 
56
                      One can choose between:\\
 
57
                      S: mean values for sigma should be used;\\
 
58
                      B: mean values for sky background should be used;\\
 
59
                      A: mean values for sigma and sky background should
 
60
                         be used;\\
 
61
                      N: No mean values should be used as trials.\\
 
62
                      Default is `N'.
 
63
\ap\pa
 
64
         mod_file =   Data file containing the number of intervals over 
 
65
                      each pixel and according to the table created by 
 
66
                      MODEL/ROMAFOT. The file is assumed to have extension
 
67
                      `.dat'. Default is that PSF function is estimated over
 
68
                      a fixed 3x3 array over each pixel.
 
69
\ap\no                             
 
70
Note:     The difference between FIT/ROMAFOT and MFIT/ROMAFOT is that
 
71
          the former compares a given pixel to the value of the PSF at the
 
72
          centre of the pixel, the latter computes the integral of the PSF
 
73
          over the pixel area. The approximation used by FIT/ROMAFOT is
 
74
          good when the pixel size is small compared with the scale
 
75
          lenght of the point images.
 
76
 
 
77
          All the comments made for FIT/ROMAFOT hold for IFIT/ROMAFOT
 
78
\on\exs                                                                         
 
79
Examples:                                                                       
 
80
\ex
 
81
          MFIT/ROMAFOT GCLUST1 GCLINTER 
 
82
          Fit the windows in frame GCLUST1, stored in the intermediate table
 
83
          GCLINTER, using a maximum of 50 iteration (default). Start from 
 
84
          the beginning in the table (default), and use a Moffat function 
 
85
          with beta=4 (default). 
 
86
\xe \sxe                                                                        
 
87