org.lsst.ccs.subsystem.rafts

Class ImageProc

java.lang.Object

org.lsst.ccs.subsystem.rafts.ImageProc

public class ImageProc
extends Object

Routines for handling image data

Author:

Owen Saxton

Constructor Summary

Constructors

Constructor and Description
ImageProc(org.lsst.ccs.drivers.reb.BaseSet bss, org.lsst.ccs.drivers.reb.ImageClient imc) Constructor.

Method Summary

Modifier and Type	Method and Description
void	configure(String rebName, int rebId, org.lsst.ccs.Subsystem subsys, Logger log) Performs configuration.
void	enableScan(boolean enable) Enables/disables scan mode.
ImageData	getImage(int offset, int count) Gets a portion of the current image.
org.lsst.ccs.drivers.reb.ImageMetadata	getImageMetadata() Gets the DAQ metadata for the current image.
double[][]	getImageStats() Gets pixel value statistics for the current image.
List<String>	saveFitsImage(String dName) Saves the current image data as one or more FITS files.
String	saveImage(String dName) Saves the current image as raw bytes.
void	setCcdMask(int ccdMask) Sets the mask of CCDs being used.
protected void	setConstFitsMetadata(long serial) Sets constant FITS metadata.
void	setDefaultImageDirectory(String dirName) Sets the default image directory.
void	setExposureTime(double expTime)
void	setFitsConditions(String filter, double temperature, double wavelength) Sets the FITS file test conditions.
void	setFitsFileNamePatter(String fitsFileNamePattern) Deprecated.
void	setFitsFileNamePattern(String pattern) Sets the FITS image file name pattern.
void	setFitsParameters(String testType, String imageType, String[] ccdManufacturer, String[] ccdModel, String[] ccdSerialMfct, String[] ccdSerialLsst) Sets the FITS file test parameters.
void	setImageDataFileNamePatter(String imageDataFileNamePattern) Deprecated.
void	setImageDataFileNamePattern(String pattern) Sets the raw image data file name pattern.
void	setReb(org.lsst.ccs.utilities.ccd.Reb reb) Set the Reb Geometry corresponding to this ImageProc instance.
void	setSeqFitsMetadata(String cfgName, int nSlice)
void	setSeqFitsMetadata(String cfgName, int nCols, int nRows)
protected void	setSequencerFileName(String name)
ByteBuffer[]	splitImage() Splits the current image into its segments.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ImageProc

public ImageProc(org.lsst.ccs.drivers.reb.BaseSet bss,
                 org.lsst.ccs.drivers.reb.ImageClient imc)

Constructor.

Parameters:

bss - The base register set object

imc - The image client object

Method Detail

configure

public void configure(String rebName,
                      int rebId,
                      org.lsst.ccs.Subsystem subsys,
                      Logger log)

Performs configuration.

Parameters:

rebName - The REB device name

rebId - The REB ID (address)

subsys - The associated subsystem

log - The associated logger

enableScan

public void enableScan(boolean enable)

Enables/disables scan mode.

Parameters:

enable - True to enable, false to disable

setCcdMask

public void setCcdMask(int ccdMask)

Sets the mask of CCDs being used.

Parameters:

ccdMask - The mask of active CCDs

setReb

public void setReb(org.lsst.ccs.utilities.ccd.Reb reb)

Set the Reb Geometry corresponding to this ImageProc instance.

Parameters:

reb - The Reb Geometry.

saveImage

public String saveImage(String dName)
                 throws RaftException,
                        IOException

Saves the current image as raw bytes. The name of the file is "Image_[reb]_[tag].dat", where [tag] is the 16-digit hexadecimal representation of the image tag, and [reb] is the name of the REB that produced the image.

Parameters:

dName - The name of the directory where the image file is to saved.

Returns:

The name of the saved file

Throws:

RaftException

IOException

saveFitsImage

public List<String> saveFitsImage(String dName)
                           throws IOException,
                                  RaftException

Saves the current image data as one or more FITS files. Each active CCD on the REB produces a separate file. The name of each file is "Image_[reb]_[ccd]_[tag].fits", where [tag] is the 16-digit hexadecimal representation of the image tag, [reb] is the name of the REB, and [ccd] is the CCD number.

Parameters:

dName - The name of the directory where the FITS file is to be saved.

Returns:

A list containing the names of the saved files

Throws:

RaftException

IOException

getImageMetadata

public org.lsst.ccs.drivers.reb.ImageMetadata getImageMetadata()
                                                        throws RaftException

Gets the DAQ metadata for the current image.

Returns:

The image metadata

Throws:

RaftException

getImage

public ImageData getImage(int offset,
                          int count)
                   throws RaftException

Gets a portion of the current image.

Parameters:

offset - The offset (in pixels) to the first pixel data to obtain.

count - The number of data pixels to obtain. If zero, all the data, starting at offset, is obtained.

Returns:

The returned pixel data

Throws:

RaftException

getImageStats

public double[][] getImageStats()
                         throws RaftException

Gets pixel value statistics for the current image.

Returns:

The array of image segment buffers

Throws:

RaftException

splitImage

public ByteBuffer[] splitImage()
                        throws RaftException

Splits the current image into its segments. Each active CCD on the REB produces 16 segments.

Returns:

The array of image segment buffers

Throws:

RaftException

setFitsParameters

public void setFitsParameters(String testType,
                              String imageType,
                              String[] ccdManufacturer,
                              String[] ccdModel,
                              String[] ccdSerialMfct,
                              String[] ccdSerialLsst)

Sets the FITS file test parameters.

Parameters:

testType - The test type

imageType - The image type

ccdManufacturer - Array of CCD manufacturer names

ccdModel - Array of CCD model names

ccdSerialMfct - Array of manufacturer's CCD serial numbers

ccdSerialLsst - Array of LSST CCD serial numbers

setFitsConditions

public void setFitsConditions(String filter,
                              double temperature,
                              double wavelength)

Sets the FITS file test conditions.

Parameters:

filter - The filter name

temperature - The temperature set point

wavelength - The monochromator wavelength

setConstFitsMetadata

protected void setConstFitsMetadata(long serial)

Sets constant FITS metadata.

Parameters:

serial - The REB serial number

setSequencerFileName

protected void setSequencerFileName(String name)

setSeqFitsMetadata

public void setSeqFitsMetadata(String cfgName,
                               int nSlice)

setSeqFitsMetadata

public void setSeqFitsMetadata(String cfgName,
                               int nCols,
                               int nRows)

setExposureTime

public void setExposureTime(double expTime)

setDefaultImageDirectory

public void setDefaultImageDirectory(String dirName)

Sets the default image directory.

Parameters:

dirName - The directory name

setFitsFileNamePattern

public void setFitsFileNamePattern(String pattern)

Sets the FITS image file name pattern.

Parameters:

pattern - The file name pattern to set

setImageDataFileNamePattern

public void setImageDataFileNamePattern(String pattern)

Sets the raw image data file name pattern.

Parameters:

pattern - The file name pattern to set

setFitsFileNamePatter

@Deprecated
public void setFitsFileNamePatter(String fitsFileNamePattern)

Deprecated.

Setter method for the fits file name pattern.

Parameters:

fitsFileNamePattern - The fileName pattern to be used when writing out fits files.

setImageDataFileNamePatter

@Deprecated
public void setImageDataFileNamePatter(String imageDataFileNamePattern)

Deprecated.

Setter method for the image data file name patter.

Parameters:

imageDataFileNamePattern - The fileName pattern to be used when writing out image data files.