<description>Direction reference frame to which to convert the direction data. Case insensitive. "cl" means use the conversion layer, if present, of the image direction coordinate. "native" means use the native native direction frame of the image. Other examples are "J2000", "B1950", "GALACTIC", etc.</description>
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" ?>
<casaxml xmlns="http://casa.nrao.edu/schema/psetTypes.html"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://casa.nrao.edu/schema/casa.xsd
file:///opt/casa/code/tools/xml/casa.xsd">
<tool name="image" module="images">
<needs>componentlist</needs>
<shortdescription>Operations on images</shortdescription>
<keyword>calculator</keyword>
<keyword>pixels</keyword>
<keyword>statistics</keyword>
<keyword>histograms</keyword>
<keyword>moments</keyword>
<keyword>convolution</keyword>
<keyword>smoothing</keyword>
<keyword>display</keyword>
<include>tools/images/image_forward.h</include>
<include>tools/images/image_private.h</include> </private>
An Image tool provides access to \casa\ images. Currently only single
precision floating point \casa\ images are supported by all methods in the Image
\tool and complex-valued images are supported by many, but not all, methods.
Image tools also provide direct (native) access to \fits\ and Miriad images.
You can also convert these foreign formats to \casa\ format (for
optimum processing speed).
It is important to note that many methods return new image tools that are
attached to an image that method has created. Even if one does not intend
on using this returned tool, it is important to capture it and run done() on
it or it will continue to use resources unnecessarily, eg
new_image_tool = ia.collapse("my_collapsed.im")
# do things with new_image_tool and then run done() on it
{\bf Overview of Image \tool\ functionality}
\item {\bf Conversion - } There is functionality to interconvert between
\casa\ images and FITS files. There is also native access to
\item <link anchor="images:image.fromfits.constructor">fromfits</link> - Convert a FITS image file to a \casa\ image
\item <link anchor="images:image.tofits.function">tofits</link> - convert the image to a \fits\ file
\item <link anchor="images:image.image.constructor">image</link> - native access to a \fits\ file
\item <link anchor="images:image.fromascii.constructor">fromascii</link> - Convert an ascii image file to a \casa\ image
\item <link anchor="images:image.fromarray.constructor">fromarray</link> - Convert an array into a \casa\ image
\item <link anchor="images:image.fromshape.constructor">fromshape</link> - Convert a shape into a \casa\ image
\item <link anchor="images:image.collapse.function">subimage</link> (function) - collapse image along specified axis,
computing aggregate function of pixels along that axis
\item <link anchor="images:image.decompose.function">decompose</link> - separate a complex image into individual components