← Back to branch summary

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

« back to all changes in this revision

Viewing changes to applic/help/integrstar.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:
applic/help/integrstar.hlq
 
1
% @(#)integrstar.hlq    19.1 (ESO-IPG) 02/25/03 13:19:17 
 
2
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
3
%.COPYRIGHT  (c)  1990 European Southern Observatory
 
4
%.IDENT      integrstar.hlq
 
5
%.AUTHOR     RHW, IPG/ESO
 
6
%.KEYWORDS   MIDAS, help files, INTEGRATE/STAR
 
7
%.PURPOSE    On-line help file for the command: INTEGRATE/STAR
 
8
%.VERSION    1.0  31-JUL-1990 : Creation, RHW
 
9
%----------------------------------------------------------------
 
10
\se
 
11
SECTION./STAR
 
12
\es\co
 
13
INTEGRATE/STAR                                                  31-JUL-1990 RHW
 
14
\oc\su
 
15
INTEGRATE/STAR [in_specs] [out_tab] [parameters] [mode]
 
16
        computes flux, radius and background of stars previously centered
 
17
\us\pu
 
18
Purpose:    
 
19
            Computes flux, radius and background of stars previously centered
 
20
\up\sy
 
21
Syntax:     
 
22
            INTEGRATE/STAR [in_specs] [out_table] [parameters] [mode]
 
23
\ys\pa
 
24
            in_specs =   input specifications. Can be CURSOR, if the objects 
 
25
                         are interactively chosen with the display cursor, or 
 
26
                         frame,table if the objects are defined in a table. In
 
27
                         the latter case no image display/window is required.
 
28
                         The table should have two columns labeled X_COORD and 
 
29
                         Y_COORD. It can be created by the commands GET/GCURSOR
 
30
                         and GET/CURSOR. Default input is CURSOR.
 
31
\ap\pa
 
32
            out_table =  output table if you want to store the results in a 
 
33
                         table. The table will contain: x, y, flux, magnitude, 
 
34
                         and background in the columns :X_COORD, :Y_COORD, 
 
35
                         :FLUX, :BGSB, and :MAG. Default no output table will 
 
36
                         be created, and results appear on the screen.
 
37
\ap\pa
 
38
            parameters = radius,step,ref_magnitude (defaulted to 20,1,0), where
 
39
                         radius is the maximum radius in pixels of the aperture;
 
40
                         step is the step in pixels between 2 annuli;
 
41
                         ref_magnitude is the magnitude of the reference star.
 
42
\ap\pa
 
43
            mode =       AUTO or INTERACTIVE; only applicable if in_spec is 
 
44
                         given frame,table as input. default INTERACTIVE. In 
 
45
                         the interactive mode the graphics display/window 
 
46
                         should be available.
 
47
\ap\no
 
48
Note:       The command computes the (stellar) object magnitude according to 
 
49
            the following receipe. The algorithm is based on determination 
 
50
            of the parameters in a single line through the (stellar) object, 
 
51
            not on a two-dimenional approch.\\
 
52
\\
 
53
            1.  First, the image pixel values are sorted and put in a table, 
 
54
            running from low to high values.\\
 
55
            2.  From the lowest 4 values in this table a first order average 
 
56
            sky background and standard deviation (sigma) is computed;\\
 
57
            3.  Then, the algorithm looks for the table value which falls 
 
58
            between sky average and average + sigma/2;\\
 
59
            4.  Depending where in the table this value is found the average 
 
60
            sky value and sigma are adjusted to determine the final values;\\
 
61
            5.  The radius of the object is then computed considering only 
 
62
            those points above sky average + 6*sigma.\\
 
63
\\
 
64
            Because the one-dimensional approch results obtained from less
 
65
            than 10 pixel values should be considered to be unreliable. In most
 
66
            case a error message will be given.
 
67
\on\exs
 
68
Examples:
 
69
\ex
 
70
            INTEGR/STAR ? rfotout
 
71
            Compute interactively the fluxes in frame loaded using the image 
 
72
            and graphics display. The command will run in INTERACTIVE mode.
 
73
\xe\ex
 
74
            INTEGR/STAR rfot,rfotpos rfotout 5,1,0 AUTO
 
75
            Use columns :X_COORD and :Y_XCOORD of the table rfotpos (e.g. 
 
76
            created by GET/CURSOR) to define the centers of the objects for
 
77
            which the fluxes are to be computed. The results will be stored in 
 
78
            the table rfotout. The command runs in automatic mode and uses 
 
79
            non-default values for the radius, step, and reference magnitude.
 
80
\xe \sxe