1setpix(1)(WCSTools)                                        setpix(1)(WCSTools)
2
3
4

Name

6       setpix - Set FITS or IRAF image values
7

Synopsis

9       setpix [-vn] file.fts [x_range y_range value] [@valuefile]
10

Description

12       Set  a  specified pixel or range of pixels in a FITS or IRAF image to a
13       specified value. More than one range of pixels and values may be speci‐
14       fied on one command line. A file of xrange yrange value triplets may be
15       used to set multiple regions at once. The image may be overwritten or a
16       new image created.
17

Options

19       filename
20              Name  of  IRAF  image  header  file  or  FITS file. This must be
21              present.
22
23       @coordfile
24              Name of file containing lines of the format
25                       xrange yrange value where xrange and yrange are of  the
26              format  n  or n-n or n,n,n or n-n,n-n and value my be integer or
27              floating point.  value will be converted  to  the  type  of  the
28              image.  If  a  range is 0, the entire row or column specified by
29              the other non-zero range will be set to the indicated value.  If
30              both ranges are zero, the entire image will be set to the speci‐
31              fied value.  New in version 2.6.4.
32
33       xrange yrange value
34              Image coordinate x and y ranges and  the  value  to  which  that
35              region  will  be  set. Either one of these triplets or a file of
36              triplets, specified by @filename, must be  present.  xrange  and
37              yrange  are of the format n or n-n or n,n,n or n-n,n-n and value
38              my be integer or floating point. value will be converted to  the
39              type  of  the  image.  If a range is 0, the entire row or column
40              specified by the other non-zero range will be set to  the  indi‐
41              cated  value.  If both ranges are zero, the entire image will be
42              set to the specified value. Ranges new in version 2.6.4.
43
44       -a <number>
45              Add constant to pixels
46
47       -d <number>
48              Divide pixels by constant
49
50       -i     List each line which is dropped
51
52       -m <number>
53              Multiply pixels by constant
54
55       -n     Write the output to a new file which is named by inserting an  e
56              before the file extension. The new file is always written to the
57              current working directory.
58
59       -s <number>
60              Subtract constant from pixels
61
62       -v     Print more information about the process
63
64

Author

66       Doug Mink, SAO (dmink@cfa.harvard.edu)
67
68
69
70                                  6 July 2001              setpix(1)(WCSTools)
Impressum