This HTML automatically generated with rman for NEMO
Table of Contents

Name

ccdslice - takes slices and/or re-orient an image cube

Synopsis

ccdslice [parameter=value] ...

Description

ccdslice takes slices from an image cube, along any (orthogonal) axis and can thereby also reorder the axes, or remove a redundant axis.

A chain of ccdslice has to be applied if the first (x) or second (y) axis needs to be reduced but the ordering of the cube coordinates to remain the same (see EXAMPLES below), see also ccdsub(1NEMO) for a better alternative.

ccdfits(1NEMO) can also remove redundant ("dummy") axes when writing out a fits(5NEMO) file.

Using the zslabs= keyword one or more sections based on the WCS along that axis can be selected, but for a regular selection (e.g. 30:50:2) it will do the right thing.

Parameters

The following parameters are recognized in order; they may be given in any order if the keyword is also given. Use --help to confirm this man page is up to date.
in=
Input filename, in image(5NEMO) format.
[no default]
out=
Output filename
[no default]
zvar=x|y|z
Slice variable (x, y, or z), along which axis the cube is sliced. This axis will then become the 3rd axis.
[z].
zrange=
Slices to select. Multiple planes can be selected, but must be in the range 1..NzvaR. If none given, all planes will be selected. Any nemoinp(1NEMO) expression can be given, but only regular ranges will result in a correct coordinate system.
If a (single) negative value is used, the axis is decimated by the absolute value of this number.
Default: the whole zvar axis is extracted.
zslabs=z1,z2,...
Pairs of a Zmin,Zmax pairs in WCS to be selected.
Default: not used.
zscale=
Scaling applied to zslabs to match the WCS in the header.
Default: 1
select=t|f
A boolean to signify of the selected planes are selected for output (t) or the ones to ignore for output (f) - Not Implemented yet.

Examples

Here is a cube, in which only the 2nd plane (z=1) is selected, the output 
    ccdslice cube.in cube.out z 2
here is a cube which is re-oriented in YZX: 
    ccdslice cube.in cube.out x
and here a somewhat cumbersome three-step process to select a subset of the X axis, but leaving the cube intact: 
    ccdslice cube.in - x 2:10:2 | ccdslice - - x | ccdslice - cube.out x
and the same for selecting a subset of the Y axis, now in two steps:

ccdslice cube.in - y 2:10:2 | ccdslice - cube.out y

Here an example to select some ranges in Z, where the input FITS file is in m/s, but the selection is done in km/s. After this a noise map is computed for the selected planes: 

    fitsccd cube.fits - | ccdslice - - zslabs=100,200,500,600 zscale=1000 | ccdmom
- cube.mom2 mom=-2
Here is an example of smoothing a cube with a boxcar of 6 channels, and decimating the cube by 6: 
    fitsccd cube.fits - | ccdsmooth - - dir=z smooth=1/6::6 | ccdslice - cube6s.ccd
zrange=-6

Caveats

This code depends on the fact that the data is 3-dimensional, i.e. an image cube. This is a limitation of the image(5NEMO) format.

The coordinate system description of the new zvar axis can easily be corrupted by choosing an irregular layout with xrange=.

See Also

ccdsub(1NEMO) , ccdfits(1NEMO) , image(5NEMO) , fits(5NEMO)

Author

Peter Teuben

Update History


6-May-95    V1.0 Created        PJT
27-feb-2021    V1.2  add zslabs= and zscale=    PJT
11-may-2023    V1.3  better WCS handling    PJT
26-aug-2024    V1.4  allow decimation with negative zrange    PJT

Table of Contents