← Back to branch summary

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

« back to all changes in this revision

Viewing changes to contrib/surfphot/help/fit_ell2.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/fit_ell2.hlq
 
1
% @(#)fit_ell2.hlq      19.1 (ESO-IPG) 02/25/03 13:30:32
 
2
\se
 
3
SECTION./ELL2
 
4
\es\co
 
5
FIT/ELL2                                                       17-Feb-1992 RHW
 
6
\oc\su
 
7
FIT/ELL2 inframe pol_opt iso_tol iso_levels [center[ [radius] [sky_level]
 
8
        fit an ellips with respect to predefined center
 
9
\us\pu
 
10
Purpose:     An image is searched for intensity points within a certain
 
11
             intensity range and within a radius to the center.
 
12
 
 
13
\up\sy
 
14
Syntax:      FIT/ELL2 inframe pol_opt iso_tol iso_levels [center[ [radius]
 
15
                      [sky_level]
 
16
\ys\pa
 
17
             inframe       = input frame
 
18
\ap\pa
 
19
             polar_opt     = 0, if polar frames should be made (first run)
 
20
                             1, polar frames already exist (repeated runs)
 
21
\ap\pa
 
22
             iso_tol       = isophotal tolerance in promille of iso_levels
 
23
\ap\pa
 
24
             iso_levels    = isophotal levels you want to fit (max = 10)
 
25
                             the format can be low:high:incr or lev1,lev2,..
 
26
                             or a combination of the two separated by a comma
 
27
\ap\pa
 
28
             center        = x,y-coordinate of center of object; default is the
 
29
                             value used in the previous run
 
30
\ap\pa
 
31
             radius        = radius around center to be surveyed; default is
 
32
                             value used in the previous run
 
33
\ap\pa
 
34
             sky_level     = value to be added to the iso_levels before a fit
 
35
                             is made to the data points; default is the value
 
36
                             in the previous run
 
37
\ap\no
 
38
Note:        The input image should have been cleaned from disturbing objects
 
39
             (stars) in the region of interest. The center of the object can
 
40
             be calculated using the command CENTER/GAUSS.\\
 
41
             The ellipses are fitted with respect to the predefined center.
 
42
             At high isophotal levels the fit will be affected by the seeing
 
43
             and it will become round, the position angle being undefined.
 
44
             At low isophotal levels (< 5 - 2 %) the affect of noise is that
 
45
             of a round object. With these natural restrictions the code
 
46
             allows to trace isophotal twisting.\\
 
47
             Points that were found and lay exactly on the ellips can not
 
48
             be discriminated from the ellips.\\
 
49
             The parameters of the ellips are communicated to the user.
 
50
 
 
51
             The command creates two polar coordinate frames containing the
 
52
             polar coordinates radii and angles of every pixel of the input
 
53
             frame. The polar coordinates of the points found are used to fit
 
54
             an ellips with a predefined center. Every rerun of the program
 
55
             (with polar_opt=0) will delete the preexisting scratch files of
 
56
             the polar coordinates.
 
57
 
 
58
             The command also produces an image called ELLIPS with the points
 
59
             used for the fit and with the actual ellips determined. This image
 
60
             can be used for display. Different isophotal levels will displayed
 
61
             in different colours. In the examples below the use of this file
 
62
             together with the input data file is demonstrated.
 
63
 
 
64
\on\exs
 
65
Examples:
 
66
\ex
 
67
             FIT/ELL2 INFRAME 0 10 10:50:10 -356.,-456 1000 125
 
68
             and run again bad solution for the 50_isophote changing the
 
69
             tolerance
 
70
\xe\ex
 
71
             FIT/ELL2 INFRAME 1 30 50
 
72
             or run again changing the radius of the search area
 
73
\xe\ex
 
74
             FIT/ELL2 INFRAME 1 10 50 300
 
75
             etc. In this way one can interactively steer the fit
 
76
             towards optimal solutions.
 
77
\xe\ex
 
78
{\tt         FIT/ELL2 INFRAME 0 10 10:50:10,70,90 -356.,-456. 1000 0\\
 
79
             LOAD/IMAGE INFRAME 0\\
 
80
             LOAD/IMAGE ELLIPS OVERLAY\\
 
81
             SET/OVERLAY
 
82
}
 
83
\xe\ex
 
84
{\tt         FIT/ELL2 INFRAME 1 10 10:50:10,70,90 -356.,-456. 1000 0\\
 
85
             LOAD/IMAGE INFRAME 0\\
 
86
             LOAD/IMAGE ELLIPS OVERLAY\\
 
87
             BLINK 0 OVERLAY\\
 
88
}
 
89
\xe \sxe