Table of Contents

Name

ccdsub - sub/average of an image, and optionally reorder axes.

Synopsis

ccdsub [parameter=value]

Description

ccdsub takes a subimage from an image, as described by a new set of coordinates in X, Y and/or Z (since the expression of the selected axes is arbitrary, the resulting coordinate system may be bogus).

Since cubes/images produced by this program may have dummy axes (length 1), you will need to use ccdslice(1NEMO) to get rid of them, or use the dummy= keyword below.

If no parameters are given, other than in= and out=, the image is copied straight through, which is still a great way to test your I/O subsystem, assuming your image fits in memory.

Parameters

The following parameters are recognized in any order if the keyword is also given:
in=
Input image file
out=
Output image file
x=
X coordinates to select. Valid numbers are 1..nx. By default all will be selected.
y=
Y coordinates to select. Valid numbers are 1..ny. By default all will be selected.
z=
Z coordinates to select. Valid numbers are 1..nz. By default all will be selected.
nxaver=
Number X to aver (size remains same)
nyaver=
Number Y to aver (size remains same)
nzaver=
Number Y to aver (size remains same)
dummy=t|f
Write out dummy axes as well? [true]
reorder=xyz
New order of axes after all previous actions have been taken. The default is no reordering, i.e. keep it in xyz order. To reverse only the X and Y axis, reorder=yxz is needed.

Examples

To reorder a cube from xyz to zxy and back to xyz, the 2nd step will have a perhaps non-intuitive axis reordering, since it refers to the new "zxy" order:
    ccdsub cube0 - reorder=zxy | ccdsub - cube1 reorder=yzx

See Also

ccdslice(1NEMO) , ccdmom(1NEMO) , image(5NEMO)

Author

Peter Teuben

Update History


1993         code written         PJT
22-Feb-97    man page written    PJT
12-aug-02    more doc    PJT
17-jun-03    WCS for simple subsetting    PJT
9-apr-09    V1.6 replace skip= with dummy=, fix bug nzaver=      PJT
18-jun-09    V2.0a fixed bug when Z size if different from XY    PJT


Table of Contents