org.lsst.ccs.subsystem.archon

Class ArchonTS

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystem.archon.ArchonTS

All Implemented Interfaces:

Observer, org.lsst.ccs.framework.Configurable, org.lsst.ccs.framework.SignalHandler, org.lsst.ccs.messaging.AgentPresenceListener, org.lsst.ccs.messaging.MessageListener, org.lsst.ccs.messaging.StatusMessageListener

public class ArchonTS
extends org.lsst.ccs.framework.Module
implements org.lsst.ccs.messaging.StatusMessageListener, org.lsst.ccs.messaging.AgentPresenceListener

Nested Class Summary

Nested classes/interfaces inherited from class org.lsst.ccs.framework.Module

org.lsst.ccs.framework.Module.ValueUpdate

Nested classes/interfaces inherited from interface org.lsst.ccs.framework.Configurable

org.lsst.ccs.framework.Configurable.Environment

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.lsst.ccs.utilities.logging.Logger	log

Fields inherited from class org.lsst.ccs.framework.Module

environment, name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
ArchonTS(String name, int tickMillis, String ip)

Method Summary

Modifier and Type	Method and Description
String	acquireAndSaveImage()
org.lsst.ccs.drivers.archon.RawImageData	acquireImage()
void	addBinaryTable(String pddatfile, String fitsfile, String extnam, String c1name, String c2name, double tstart)
void	applyConfig()
void	applyLabeled()
void	applyParams()
void	applyTiming()
void	connecting(org.lsst.ccs.bus.data.AgentInfo agent)
void	disconnecting(org.lsst.ccs.bus.data.AgentInfo agent)
List<String>	ds9Get(String cmd)
void	ds9Set(String cmd, String arg)
List<String>	ds9Versions()
int	eoSetup(String acffile, String ccdtype)
String	exposeAcquireAndSave()
void	exposeAcquireAndSaveSeveral(int n)
String	exposeAcquireAndSaveWithoutApply()
String	getAcqParam()
long	getBackPlaneID()
int	getBackPlaneRev()
int	getBackPlaneType()
String	getBackPlaneVersion()
protected org.lsst.ccs.utilities.ccd.CCDGeometry	getCCDGeometry()
org.lsst.ccs.utilities.ccd.CCDType	getCCDType()
ArchonConfiguration	getConfig()
String	getConstant(String name)
ArchonControllerStatus	getControllerStatus()
org.lsst.ccs.utilities.ccd.CCDType	getDefaultCCDType()
long	getFetch_timeout()
double	getFluxStats(String fitsfile)
double	getImageAverageSignal()
double	getKpixRate()
String	getLabeled(String name)
String	getLastTestType()
String	getParameter(String name)
void	initModule()
boolean	isInExposure()
boolean	isSendImagesToDS9()
void	onStatusMessage(org.lsst.ccs.bus.messages.StatusMessage msg)
void	powerOffCCD()
void	powerOnCCD()
void	saveACF(String fileName)
protected Object	sendSyncTSCommand(String target, String name, Object... params)
void	setAcqParam(String acqParam)
void	setAndApplyConfig(ArchonConfiguration c)
void	setAndApplyParam(String name, String value)
void	setAndApplyParams(ArchonConfiguration c)
void	setCCDGeometry(org.lsst.ccs.utilities.ccd.CCDGeometry ccdGeom) Overrides the default CCDType and forces the given CCDGeometry to be used.
void	setCCDnum(String ccdnum)
void	setCCDOverScans(int number_overscan_lines)
void	setConfig(ArchonConfiguration c)
void	setConfigFromFile(String fn)
void	setConstant(String name, String value)
void	setDefaultCCDType(org.lsst.ccs.utilities.ccd.CCDType ccdType)
void	setDefaultCCDTypeName(String ccdType)
void	setFetch_timeout(long fetch_timeout)
void	setFitsDirectory(String dir)
void	setFitsFilename(String fileName) Allows the name under which the fits file will be stored.
void	setHeader(String name, Object value)
void	setLabeled(String name, String value)
void	setLSSTnum(String lsstnum)
void	setParameter(String name, String value)
void	setROI(int colStart, int cols, int rowStart, int rows)
void	setSendImagesToDS9(boolean sendImagesToDS9)
void	showPhotoDiodeAnalysis(String pddatfile)
String	snap(String fln, int exptime)
String	snap(String fln, int exptime, int light)
String	snap(String fln, int exptime, int light, int fe55)
void	start()
void	tick()
int	waitForExpoEnd()

Methods inherited from class org.lsst.ccs.framework.Module

getComponentTree, getEnvironment, getName, getNObserverThreads, getObservables, getSubsystem, getTickMillis, init, listens, postStart, processUpdate, sendSignal, sendSignalWithTimeLimit, setEnvironment, setName, setNObserverThreads, setObservables, setTickMillis, shutdownNow, signal, startTicking, update

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.lsst.ccs.framework.Configurable

change, dropSubmittedChanges, getCheckedValueFromConfiguration, getChildren, getComponentByName, getParent, getParentObject, getSubmittedChanges, isParameterConfigurable, notifyChange, notifyChangeWithoutPreliminaryChecks, printConfigurableParameters, setBulkParameter, submitChange, submitChanges, validateBulkChange

Field Detail

log

protected static org.lsst.ccs.utilities.logging.Logger log

Constructor Detail

ArchonTS

public ArchonTS(String name,
                int tickMillis,
                String ip)

Method Detail

initModule

public void initModule()

Overrides:

initModule in class org.lsst.ccs.framework.Module

start

public void start()

Specified by:

start in interface org.lsst.ccs.framework.Configurable

tick

public void tick()

Overrides:

tick in class org.lsst.ccs.framework.Module

setConfigFromFile

@Command
public void setConfigFromFile(String fn)

setAndApplyConfig

@Command
public void setAndApplyConfig(ArchonConfiguration c)

setAndApplyParams

@Command
public void setAndApplyParams(ArchonConfiguration c)

saveACF

@Command
public void saveACF(String fileName)
                      throws IOException

Throws:

IOException

getConfig

@Command
public ArchonConfiguration getConfig()

getDefaultCCDType

@Command
public org.lsst.ccs.utilities.ccd.CCDType getDefaultCCDType()

setCCDGeometry

@Command
public void setCCDGeometry(org.lsst.ccs.utilities.ccd.CCDGeometry ccdGeom)

Overrides the default CCDType and forces the given CCDGeometry to be used. Note that setting this to a non-null value will override and automatic determination of the geometry (including regions of interest) from the archon (acf) file.

Parameters:

ccdGeom - The geometry to use, or null to restore default geometry.

setCCDOverScans

@Command
public void setCCDOverScans(int number_overscan_lines)

setDefaultCCDType

@Command
public void setDefaultCCDType(org.lsst.ccs.utilities.ccd.CCDType ccdType)

setDefaultCCDTypeName

@Command
public void setDefaultCCDTypeName(String ccdType)

getCCDType

@Command
public org.lsst.ccs.utilities.ccd.CCDType getCCDType()

setConfig

@Command
public void setConfig(ArchonConfiguration c)

showPhotoDiodeAnalysis

@Command
public void showPhotoDiodeAnalysis(String pddatfile)
                                     throws IOException,
                                            nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

addBinaryTable

@Command
public void addBinaryTable(String pddatfile,
                                    String fitsfile,
                                    String extnam,
                                    String c1name,
                                    String c2name,
                                    double tstart)
                             throws IOException,
                                    nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

getFluxStats

@Command
public double getFluxStats(String fitsfile)
                             throws nom.tam.fits.FitsException,
                                    IOException

Throws:

nom.tam.fits.FitsException

IOException

setAcqParam

@Command
public void setAcqParam(String acqParam)

getAcqParam

public String getAcqParam()

getControllerStatus

@Command(description="Get the archon controller status")
public ArchonControllerStatus getControllerStatus()

isSendImagesToDS9

@Command(description="Test if images will be sent to DS9 automatically")
public boolean isSendImagesToDS9()

setSendImagesToDS9

@Command(description="Set if images should be sent to DS9 automatically")
public void setSendImagesToDS9(boolean sendImagesToDS9)

setParameter

@Command(description="Set an archon configuration parameter. Requires applyParams of applyConfig after.")
public void setParameter(String name,
                                                                                                                                   String value)

setAndApplyParam

@Command(description="Set an archon configuration parameter and applies the one line change.")
public void setAndApplyParam(String name,
                                                                                                                            String value)
                                                                                                                     throws org.lsst.ccs.drivers.commons.DriverException

Throws:

org.lsst.ccs.drivers.commons.DriverException

getParameter

@Command(description="Get an archon configuration parameter")
public String getParameter(String name)

setConstant

@Command(description="Set an archon configuration constant. Requires applyTiming of applyConfig after.")
public void setConstant(String name,
                                                                                                                                 String value)

getConstant

@Command(description="Get an archon configuration constant")
public String getConstant(String name)

setLabeled

@Command(description="Set an archon configuration labeled value. Requires applyLabed or applyConfig after.")
public void setLabeled(String name,
                                                                                                                                    String value)

getLabeled

@Command(description="Get current labeled value")
public String getLabeled(String name)

applyLabeled

@Command(description="Updates archon configuration with new labeled values")
public void applyLabeled()

setHeader

@Command(description="Override a FITS header")
public void setHeader(@Argument(name="name")
                                                                     String name,
                                                                     @Argument(name="value",defaultValue="")
                                                                     Object value)

setFitsDirectory

@Command(description="Set the directory into which FITS file will be stored")
public void setFitsDirectory(String dir)

getLastTestType

@Command(type=QUERY,
         description="retrieve the last acq test type")
public String getLastTestType()

setFitsFilename

@Command(description="Set the file name into which FITS file will be stored")
public void setFitsFilename(String fileName)

Allows the name under which the fits file will be stored. The fileName may contain escape sequences like ${variable}, but currently the only supported variable is ${timestamp}.

Parameters:

fileName - The file name, including escape sequences.

setCCDnum

@Command(description="Set the CCD number")
public void setCCDnum(String ccdnum)

setLSSTnum

@Command(description="Set the LSST number")
public void setLSSTnum(String lsstnum)

applyConfig

@Command(description="Send archon configuration to controller and apply all. Resets timing core and powers off the ccd.")
public void applyConfig()

applyParams

@ConfigChanger
 @Command(description="Send archon configuration to controller and apply params")
public void applyParams()

applyTiming

@Command(description="Send archon configuration to controller and reload timing scripts. Resets timing core.")
public void applyTiming()

powerOnCCD

@Command(description="Turn on the CCD")
public void powerOnCCD()

powerOffCCD

@Command(description="Turn off the CCD")
public void powerOffCCD()

acquireImage

public org.lsst.ccs.drivers.archon.RawImageData acquireImage()

exposeAcquireAndSaveWithoutApply

@Command(description="trigger image exposure and readout, and acquire the image w/o applying the whole config")
public String exposeAcquireAndSaveWithoutApply()
                                                                                                                                                        throws IOException,
                                                                                                                                                               nom.tam.fits.FitsException,
                                                                                                                                                               org.lsst.ccs.drivers.commons.DriverException

Throws:

IOException

nom.tam.fits.FitsException

org.lsst.ccs.drivers.commons.DriverException

exposeAcquireAndSave

@Command(description="trigger image exposure and readout, and acquire the image")
public String exposeAcquireAndSave()
                                                                                                              throws IOException,
                                                                                                                     nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

snap

@Command(description="snap an image (filename, exptime (ms)")
public String snap(@Argument(name="filename",description="filename with or without the full path")
                                                                                 String fln,
                                                                                 @Argument(name="exptime",description="exposure time in an integer number of msec")
                                                                                 int exptime)
                                                                          throws IOException,
                                                                                 nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

snap

@Command(description="snap an image (filename, exptime (ms), light(1)/dark(0)")
public String snap(@Argument(name="filename",description="filename with or without the full path")
                                                                                                   String fln,
                                                                                                   @Argument(name="exptime",description="exposure time in an integer number of msec")
                                                                                                   int exptime,
                                                                                                   @Argument(name="light",description="light(=1) or dark(=0) exposure")
                                                                                                   int light)
                                                                                            throws IOException,
                                                                                                   nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

snap

@Command(description="snap an image (filename, exptime (ms), light(1)/dark(0), fe55(1),no fe55(0)")
public String snap(@Argument(name="filename",description="filename with or without the full path")
                                                                                                                       String fln,
                                                                                                                       @Argument(name="exptime",description="exposure time in an integer number of msec")
                                                                                                                       int exptime,
                                                                                                                       @Argument(name="light",description="light(=1) or dark(=0) exposure")
                                                                                                                       int light,
                                                                                                                       @Argument(name="fe55",description="XED actuated(=1) or XED inactive(=0)")
                                                                                                                       int fe55)
                                                                                                                throws IOException,
                                                                                                                       nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

eoSetup

@Command(description="perform setup for acquisitions")
public int eoSetup(@Argument(name="acffile",description="filename of acf file")
                                                                          String acffile,
                                                                          @Argument(name="ccdtype",description="filename of acf file")
                                                                          String ccdtype)
                                                                   throws IOException,
                                                                          nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

exposeAcquireAndSaveSeveral

@Command(description="trigger image exposure and readout, for a series of images")
public void exposeAcquireAndSaveSeveral(int n)
                                                                                                                    throws IOException,
                                                                                                                           nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

getCCDGeometry

protected org.lsst.ccs.utilities.ccd.CCDGeometry getCCDGeometry()

setROI

@Command(description="sets ROI colStart, cols, rowStart, rows")
public void setROI(int colStart,
                                                                                   int cols,
                                                                                   int rowStart,
                                                                                   int rows)

acquireAndSaveImage

@Command(description="acquire an image and save it to the default location")
public String acquireAndSaveImage()
                                                                                                        throws IOException,
                                                                                                               nom.tam.fits.FitsException

Throws:

IOException

nom.tam.fits.FitsException

getImageAverageSignal

@Command(description="get the average signal of the last image")
public double getImageAverageSignal()

getKpixRate

@Command(description="get the readout rate")
public double getKpixRate()

getBackPlaneID

@Command
public long getBackPlaneID()

getBackPlaneRev

@Command
public int getBackPlaneRev()

getBackPlaneType

@Command
public int getBackPlaneType()

getBackPlaneVersion

@Command
public String getBackPlaneVersion()

ds9Set

@Command(description="Send a set command to DS9")
public void ds9Set(String cmd,
                                                                     @Argument(name="url",defaultValue="")
                                                                     String arg)
                                                              throws URISyntaxException,
                                                                     org.astrogrid.samp.client.SampException

Throws:

URISyntaxException

org.astrogrid.samp.client.SampException

ds9Get

@Command(description="Send a get command to DS9")
public List<String> ds9Get(String cmd)
                                                                      throws org.astrogrid.samp.client.SampException

Throws:

org.astrogrid.samp.client.SampException

ds9Versions

public List<String> ds9Versions()
                         throws org.astrogrid.samp.client.SampException

Throws:

org.astrogrid.samp.client.SampException

getFetch_timeout

@Command(description="get the timeout for fetching images in millisecs")
public long getFetch_timeout()

setFetch_timeout

@Command(description="set the timeout for fetching images in millisecs")
public void setFetch_timeout(long fetch_timeout)

isInExposure

@Command(description="is an exposure occuring")
public boolean isInExposure()

waitForExpoEnd

@Command(description="wait for an exposure to end")
public int waitForExpoEnd()

sendSyncTSCommand

protected Object sendSyncTSCommand(String target,
                                   String name,
                                   Object... params)

connecting

public void connecting(org.lsst.ccs.bus.data.AgentInfo agent)

Specified by:

connecting in interface org.lsst.ccs.messaging.AgentPresenceListener

disconnecting

public void disconnecting(org.lsst.ccs.bus.data.AgentInfo agent)

Specified by:

disconnecting in interface org.lsst.ccs.messaging.AgentPresenceListener

onStatusMessage

public void onStatusMessage(org.lsst.ccs.bus.messages.StatusMessage msg)

Specified by:

onStatusMessage in interface org.lsst.ccs.messaging.StatusMessageListener