← Back to branch summary

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

« back to all changes in this revision

Viewing changes to prim/help/find_pxpo.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:
prim/help/find_pxpo.hlq
 
1
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
2
%.COPYRIGHT  (c)  2011 European Southern Observatory
 
3
%.IDENT      get_posi.hlq
 
4
%.AUTHOR     KB, IPG/ESO
 
5
%.KEYWORDS   MIDAS, help files, FIND/PXPOS
 
6
%.PURPOSE    On-line help file for the command: FIND/PXPOS
 
7
%.VERSION    
 
8
% 110510        creation
 
9
% 110517        last modif
 
10
%----------------------------------------------------------------
 
11
\se
 
12
SECTION./PXPOS
 
13
\es\co
 
14
FIND/PXPOS
 
15
\oc\su
 
16
FIND/PXPOS in_image [out_table] option disp_flag
 
17
        get pixel positions of input image in given data intervals
 
18
\us\pu
 
19
Purpose:      
 
20
          Get pixel positions of input image in given data intervals
 
21
          and store them (optionally) in a table.
 
22
\up\sy
 
23
Syntax:       
 
24
          FIND/PXPOS in_image out_table option disp_flag
 
25
\ys\pa
 
26
          in_image = name of input image;
 
27
                may also be a subimage a[..:..]
 
28
\ap\pa
 
29
          output_table = name of table, which will be created and
 
30
               filled with the results
 
31
               table columns :X_PIX, :Y_PIX, :Z_PIX (depending on the
 
32
               dimension of the image)  will hold the pixel no's (as real),
 
33
               and the column :VALUE is filled with the intensity at that 
 
34
               pixel position (as real);
 
35
               setting this param. = ? will not create a result table 
 
36
\ap\pa
 
37
          option = different data interval definitions
 
38
               [a,b], or ]a,b], or [a,b[, or ]a,b[ specifying
 
39
                            closed/open intervals, with a<= b
 
40
               min,nop to return position of the smallest value and 
 
41
                          'nop' coords of values closest to the min
 
42
               max,nop to return position of the largest value and 
 
43
                         'nop' coords of values closest to the max
 
44
               min+val to return position of the smallest value and 
 
45
                                    all coords of values <= min+val
 
46
               max+val to return position of the largest value and 
 
47
                                   all coords of values >= max-val
 
48
               med,nop to return position of the median value and 'nop' 
 
49
                    coords of closest values below and above the median 
 
50
               med,npa,npb to return position of the median value and 
 
51
                 'npa' coords of closest values below the median, and
 
52
                        'npb' coords of closest values above the med. 
 
53
               med+val to return position of all coords having values 
 
54
                      within the interval [median-val,median+val]
 
55
               med+vala,valb to return position of all coords having 
 
56
                      values within the interval [median-vala,median+valb]
 
57
\ap\pa
 
58
          disp_flag = YES or NO, to display all pixels found in the
 
59
               interval (then also written into the logfile);
 
60
               defaulted to NO
 
61
\ap\sa
 
62
See also:
 
63
          FIND/PIXEL, READ/IMAGE, WRITE/IMAGE
 
64
\as\no
 
65
Note:         
 
66
          This command is very similar to FIND/PIXEL, but gives
 
67
          additional possiblities for choosing an interval, which would
 
68
          be difficult (or cumbersome) to obtain with FIND/PIXEL.
 
69
          The result table has the same format as the one obtained 
 
70
          from FIND/PIXEL.
 
71
             The total no. of pixels found in the given interval is 
 
72
          saved in keyword OUTPUTI(1). On errors, this value will be
 
73
          set to -1.
 
74
\on\exs
 
75
Examples:
 
76
\ex
 
77
          FIND/PXPOS manzana ? [-22.1,12.3[ yes
 
78
            Find all pixels of image manzana.bdf with intensities >= -22.1 
 
79
            and < 12.3 and display them.
 
80
\xe\ex
 
81
          FIND/PXPOS fresa.fits restable MAX+0.0234
 
82
            Find all pixels of FITS image fresa.fits with intensities 
 
83
            >= Y-0.-234, where Y = max of fresa.fits. 
 
84
            Do not display the pixels found, but store them into the newly
 
85
            created table restable.tbl, the no. of rows written depends on
 
86
            the image data.
 
87
\xe\ex
 
88
          FIND/PXPOS duraznos buenos MEDIAN,12,4
 
89
            In image duraznos.bdf find the 12 closest pixels below the median
 
90
            value and the 4 closest pixels above the median and store their
 
91
            pixel no.s and intensities in table buenos.tbl. A total of
 
92
            12 + 1 + 4 pixels are selected, i.e. 17 table rows are written.
 
93
\xe\ex
 
94
          FIND/PXPOS duraznos[@10:@2:@100,@4]  MEDIAN,12,4
 
95
            Same as above, but only in the given subwindow.
 
96
            Pixel no's. are relative to the subwindow, the corresponding 
 
97
            pixel no's (positions) in full frame durazno.bdf are also
 
98
            displayed.
 
99
\xe \sxe