CameraMaster

java.lang.Object
- util.PropertyContainer
- - util.PropertyResources
  - - util.rmi.RmiPropertyContainer
    - - util.rmi.AbstractRmiListener
      - stella.rmi.AbstractRmiCasterAndListener
        
        stella.rmi.ReceiverTorso
        
        stella.rmi.GenericMaster
        
        stella.ccd.CameraMaster

All Implemented Interfaces:

Cloneable, Remote, EventListener, Caster, ErrorSending, ErrorCaster, Alive, CameraControlling, ListenerControlling, RmiAcknowledgeCaster, RmiCommandListener, RmiDoneCaster, RmiErrorCaster, RmiParameterClustering, AlarmHandler, ExitCleaning, PropertySupplying, Reloadable, ResourceSupplying, RmiCaster, RmiEventListener, RmiListener, RmiPropertyBearing, TriggerableReload, StepInitializable

Direct Known Subclasses:

MagellanMaster
```
public abstract class CameraMaster
extends GenericMaster
implements CameraControlling, Reloadable
```
The class that handles the communication of the CCD controler back with the SCS. For core comunication to the CCD-controller, it uses the interface layer CcdDriver which itself is based on a C++ rpc call to thomas fechner's controller. This controller allows no notification when readout starts (or, when the exposure has finished). To circumvent this but still have some handle of control, we send an acknowledge command after the exposure time plus the value stated in #KEY_EXPOSURESAFETY which should be set rather conservatively, i.e. to a few seconds at least.
The following commands are supported by the CCD, additionally to the four default commands AbortCcd, ResetCcd, ParkCcd, and StatusCcd.
- GeometryCcd: Defines the active area on the CCD. Is valid for all consecuetive CCD-readouts until the geometry is changed again with a new GeometryCcd command.
- BiasCcd: Takes a bias frame. If a fits-filename is provided, the data is writtn to the fits file, otherwise the data is deleted.
- DarkCcd: Takes a dark exposure. The exposure time is specified on the second command line. If a fits-filename is provided, the data is writtn to the fits file, otherwise the data is deleted.
- ScientificCcd: Takes a scientific exposure. The exposure time is specified on the second command line. If a fits-filename is provided, the data is writtn to the fits file, otherwise the data is deleted.
- ExposureAbortCcd: Aborts current read-out. If a fits-filename is provided, the data collected so far is writtn to the fits file, otherwise the data is deleted.
- FitsCcd: Adds parameters to the fits header information. As the parameter value changes, so may the data writtn to the header.
Note that all these commands are also available via the SesControlling interface.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`(package private) static class`	`CameraMaster.CardInfo`
`private class`	`CameraMaster.CcdWatch` This class reads from the CCD the current values of temperature and pressure and compares them to set values.
`private class`	`CameraMaster.HeaderGather`
`(package private) static class`	`CameraMaster.When`

Nested classes/interfaces inherited from class stella.rmi.GenericMaster
GenericMaster.Standalone

Nested classes/interfaces inherited from class stella.rmi.ReceiverTorso
ReceiverTorso.CommandHandler

Nested classes/interfaces inherited from class util.PropertyResources
PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields
Modifier and Type	Field and Description
`private Map<String,CameraMaster.CardInfo>`	`addfits` The fits header data added during operation, see `FitsCcd`.
`private static double`	`BIASEXPOSURE` The exposure time on bias frames if driver does not support bias, ms.
`private static String`	`BIASTYPE` The imagetype value for manual bias.
`protected CcdDriver`	`camera` The driver object for the camera.
`private Map<String,CameraMaster.CardInfo>`	`ccdfits` CCD info fits.
`private Map<String,Object>`	`ccdinfo` Last info retrieved.
`protected static String`	`COMMENTSEPARATOR` In fits-keys map the separator between values and comments.
`private static String`	`DARKTYPE` The imagetype value for manual dark.
`static String`	`DATENUMBERSEPARATOR` Separatesd the date from the running number.
`private static String`	`DEFABORTFITS` The default fits-file name head for aborted exposures.
`private Map<String,CameraMaster.CardInfo>`	`defaultfits` The fits header data given as defaults.
`private static String`	`DEFBIASFITS` The default fits-file name head for bias exposures.
`private static String`	`DEFDARKFITS` The default fits-file name head for bias exposures.
`private static double`	`DEFEXPOSEBUFFER` The default multiplier for exposure time.
`private static boolean`	`DEFLOGWATCH` If true, values are logged to syslog.
`private static long`	`DEFMAXEXPOSURE` The default maximal exposure time
`private static int`	`DEFMAXQUERIES` Default property value.
`private static long`	`DEFQUERYCYCLE` Default property value.
`private static long`	`DEFSAFETYTIME` The default safety time.
`static String`	`DEFSCIENCEFITS` The default fits-file name head for bias exposures.
`private Thread`	`expose` A thread doing a single exposure.
`private static DateFormat`	`FITSDATE` The formatter for fits dates.
`private static String`	`FITSEXTENSION` Default fits extension.
`protected Map<String,CameraMaster.CardInfo>`	`fixfits` The fits header data with unchangable fits entries, keys to val/rem.
`private CameraMaster.HeaderGather`	`gather`
`private Thread`	`header` For efficiency, collect header info during expose.
`protected static String`	`IMAGETYPE` The special imagetype key that is set during manual bias/flat/science.
`static String`	`KEY_ABORTEXPOSURETIME` Time for the abort exposure command, first part, without readout time.
`static String`	`KEY_ABORTFITS` The key to the header for science fits on the ccd host.
`static String`	`KEY_ALWAYSZERO` If true, the shutter is set to its zero position after each exposure.
`static String`	`KEY_ARCHIVEPATH` The fits path on the archive host.
`static String`	`KEY_BIASFITS` The key to the header for bias fits on the ccd host.
`static String`	`KEY_BIASTIME` Time for the bias command, first part, without readout time.
`static String`	`KEY_CAMERA` The key matching the name of ccd driver.
`static String`	`KEY_CAMERABIAS` If true, driver supports bias frames directly.
`static String`	`KEY_CAMERADARK` If true, driver supports dark frames.
`static String`	`KEY_CCDFITSKEYS` A map of CCD-keywords to keep and additional comments.
`static String`	`KEY_CCDWATCHMAXIMUM` If this is set, we observe these CCD-info key for not being lower.
`static String`	`KEY_CCDWATCHMINIMUM` If this is set, we observe these CCD-info key for not being higher.
`static String`	`KEY_DARKFITS` The key to the header for dark fits on the ccd host.
`static String`	`KEY_DATEFORMAT` The formatter for the date.
`static String`	`KEY_DELETEFITS` If true, fits files on the ccd host are deleted after copying.
`static String`	`KEY_ENABLEWATCH` If set to any time other than zero, this is the watch intervall.
`static String`	`KEY_EXPOSEBUFFER` The multiplier for the exposure time.
`static String`	`KEY_EXPOSURETRIGGER` The key matching the name of the expose-trigger.
`static String`	`KEY_FITSKEYS` The key pointig to default Fits-header information, keys section.
`static String`	`KEY_FITSTIME` Time for the fits command.
`static String`	`KEY_FIXFITSKEYS` A map of fixed fits keywords.
`static String`	`KEY_GEOMETRYTIME` Time for the geometry command.
`static String`	`KEY_LOGWATCH` If true, values are logged to syslog.
`static String`	`KEY_MANUALSHUTTER` If true, the shutter is moved manually.
`static String`	`KEY_MASTERPATH` The fits path how the master can access the science ccd host data.
`static String`	`KEY_MAXEXPOSURE` The maximum exposure time allowed for science frames.
`static String`	`KEY_MAXQUERIES` The time interval at which the status is queried.
`static String`	`KEY_MINEXPOSURE` The minimum exposure time allowed for science frames.
`static String`	`KEY_QUERYCYCLE` The time interval at which the status is queried.
`static String`	`KEY_READOUTTIME` The multiplier for the expected read-out time.
`static String`	`KEY_SAFETYTIME` If non-null, added to the exposure time for ack(2) on exposures.
`static String`	`KEY_SCIENCEFITS` The key to the header for science fits on the ccd host.
`static String`	`KEY_TRANSFERTRIGGER` The key matching the name of the transfer-trigger.
`static String`	`KEY_WATCHMAXVALUES` The vaules below which we may not fall during watch.
`static String`	`KEY_WATCHMINVALUES` The vaules above which we may not fall during watch.
`static String`	`KEY_WRITETIME` The time for the expected fits write-time.
`private String`	`lasthead` Last type of fits, for aborted exposures.
`private static String`	`OBJECTTYPE` The imagetype value for manual science.
`protected static String`	`STRING`
`protected static String`	`TYPEREM` The imagetpye comment for manual operation.
`private CameraMaster.CcdWatch`	`watch` If we watch the ccd, this is non-null.

Fields inherited from class stella.rmi.GenericMaster
DEFUNIQUE, KEY_ABORTTIME, KEY_AUTOMATIC, KEY_COMMTIME, KEY_COMMUNICATOR, KEY_DRIVERS, KEY_HISTORYDB, KEY_INITTIME, KEY_NODB, KEY_OBSERVEDB, KEY_OVERRULEAUTO, KEY_PARKTIME, KEY_PERMISSIONDB, KEY_PROPOSALDB, KEY_QUITTIME, KEY_REAUTO, KEY_RESETTIME, KEY_SET, KEY_SHUTDOWNDELAY, KEY_STATUSTIME, KEY_TARGETDB, KEY_TASKDB, KEY_UNIQUE, KEY_USERDB, lastabort, lastinit, lastpark, lastreset, telescope

Fields inherited from class stella.rmi.ReceiverTorso
KEY_BIND, KEY_BINDNAME, KEY_COMMANDCASTER, KEY_ERRORCOOL

Fields inherited from class util.rmi.AbstractRmiListener
KEY_ALIVE, KEY_EXPORTPORT, KEY_INIT, KEY_LISTENERNAME, KEY_RETRY, KEY_RETRYSLEEP

Fields inherited from class util.PropertyResources
KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer
KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface stella.rmi.RmiAcknowledgeCaster
NAMING_EXTENSION

Fields inherited from interface stella.rmi.RmiDoneCaster
NAMING_EXTENSION

Fields inherited from interface util.StepInitializable
KEY_INITDEPTH

Fields inherited from interface util.ResourceSupplying
KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Fields inherited from interface util.PropertySupplying
CONFIG, KEY_CLASS

Constructor Summary

Constructors
Modifier Constructor and Description

protected CameraMaster(Map<String,String> prop)
Constructs a new CCD master.

Constructors
Modifier	Constructor and Description
`protected`	`CameraMaster(Map<String,String> prop)` Constructs a new CCD master.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`boolean`	`abortExposure(String writeto)` Supported only with with `Asynchronous` cameras.
`protected boolean`	`abortMaster(CommandEvent cmd)` Aborts the CCD if possible.
`private boolean`	`abortTake()` Aborts the exposure.
`boolean`	`accepts(CommandEvent ce)` Checks if the command received is accepted by the ccd master.
`boolean`	`addFitsKey(String key, String parametername, String comment)` Adds a key to the fits header section.
`protected abstract boolean`	`closeShutter()` For cameras with a 'manual' shutter, i.e., a shutter that is not auto-operated by the CCD controller.
`private boolean`	`ensureExposureFinished()` We wait until the camera is reading out.
`void`	`exit()` Stops the timer in this VM.
`private boolean`	`fitsKey(String key, String parameter, String comment)` Adds/removes a fits header key from the customizable table.
`protected String`	`formatFitsName(String fill)` Formatting a fits file name from a place-holder supplied.
`private boolean`	`geometry(CommandEvent cmd, int xoff, int yoff, int xsize, int ysize, int xbin, int ybin)` Sets the geometry of the next image on the ccd.
`protected int`	`getAcknowledgeNumber(CommandEvent cmd)` Returns the number of acknowledge events produced for each command.
`boolean`	`getBiasExposure(String fits)` Takes a bias image.
`static List<MHeaderCard>`	`getCcdCards(Map<String,CameraMaster.CardInfo> keep, Map<String,?> ccd)` Adds information received from the ccd driver.
`protected long`	`getCompletionTime(CommandEvent cmd, int acknr)` Returns the individual completion times.
`boolean`	`getDarkExposure(String fits, double time)` Takes a dark exposure.
`static List<MHeaderCard>`	`getFixedCards(Map<String,CameraMaster.CardInfo> fix)` Returns a list of `MHeaderCard`s from a fixed info map.
`static List<MHeaderCard>`	`getParameterCards(Map<String,CameraMaster.CardInfo> give, GlobalGrouping set)` Writes fits header information.
`private File`	`getPermanentFile(File fits)`
`boolean`	`getScienceExposure(String fits, double time)` Takes a scientific exposure.
`protected void`	`init2()` The main initialization section.
`protected boolean`	`initializeMaster(CommandEvent cmd)` Initializes the CCD.
`protected abstract boolean`	`initShutter()` If no explicit shutter action is required, simply return true here.
`void`	`initStep(int curstep)` Delay the init method of the receiver torso until we finished the initialization of the ccd master.
`static void`	`main(String[] arg)` Starts the ccd master with the given properties or directly accesses a running CCD master.
`protected abstract boolean`	`openShutter()` For cameras with a 'manual' shutter, i.e., a shutter that is not auto-operated by the CCD controller.
`protected boolean`	`parkMaster(CommandEvent cmd)` Parks the CCD.
`private Map<String,CameraMaster.CardInfo>`	`parseToKey(String pk)`
`private static Class<?>`	`probeForType(Object val)` Deprecated.
`protected boolean`	`processCommand(CommandEvent cmd, int acknr)` Process the command.
`void`	`quit()` Gracefully quite the ccd master.
`protected void`	`quitMaster(CommandEvent cmd)` Aborts the exposure and proceeds with the parental method (closes drivers).
`protected boolean`	`readout(boolean shuttermoved)` Simulates the readout process.
`boolean`	`removeAllFitsKeys()` Removes all except the default fits header keys.
`boolean`	`removeFitsKey(String key)` Removes a fits header key.
`double`	`rescanned(String key, String old, String newval)` On reload, we can rebuild the fits tables.
`boolean`	`reset()` Zero positions all filter wheels and sets the calibration sledge to home.
`protected boolean`	`resetMaster(CommandEvent cmd)` Resets the CCD.
`boolean`	`setFullFrame()` Resets the CCD-windowing.
`boolean`	`setImageGeometry(int xoff, int yoff, int xsize, int ysize, int xbin, int ybin)` Sets the image geometry.
`protected String`	`statusMaster(CommandEvent cmd)` Returns a status information of the camera as a string.
`private boolean`	`takeBias()` Takes a bias exposure.
`private boolean`	`takeDark(double time)` Takes a dark exposure.
`protected boolean`	`takeExposure(double time)` Takes a normal exposure.
`private boolean`	`takeExposure(double time, String fitsname)` Takes a normal exposure.
`protected boolean`	`writeFits(CommandEvent cmd, File fits, boolean science)` Writes the data allocated in the `CcdDriver` object to a fits file provided as an argument.
`private boolean`	`writeFits(CommandEvent cmd, File fits, boolean science, boolean surestore)` Writes the data allocated in the `CcdDriver` object to a fits file provided as an argument.

Methods inherited from class stella.rmi.AbstractRmiCasterAndListener
bindToRegistry, getBindName, isValid, notifyErrorListener, removeErrorListener, removeRmiErrorListener, sendError, sendError, sendError, sendStatus, sendStatus, sendStatus, unbindFromRegistry

Methods inherited from class util.rmi.AbstractRmiListener
allBound, blockBinding, blockBinding, disconnect, getIP, getListenerName, isConnected, listenerName, releaseBinding, releaseBinding, startBinding, startBinding

Methods inherited from class util.PropertyResources
clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer
augment, augment, augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, parseObject, removeProperty, requires, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface stella.rmi.ListenerControlling
automatic, external, getStatus, initialize, manual, park, setPassive

Methods inherited from interface util.Reloadable
reload

Methods inherited from interface util.rmi.RmiCaster
bindToRegistry, isValid, unbindFromRegistry

Methods inherited from interface stella.ErrorCaster
removeErrorListener

Methods inherited from interface util.rmi.RmiEventListener
getListenerName

Methods inherited from interface util.rmi.RmiListener
disconnect, isConnected

Methods inherited from interface util.PropertySupplying
defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

- Field Detail
  - DATENUMBERSEPARATOR
```
public static final String DATENUMBERSEPARATOR
```
    Separatesd the date from the running number.
    
    See Also:
    
    Constant Field Values
  - KEY_CAMERA
```
public static final String KEY_CAMERA
```
    The key matching the name of ccd driver.
    
    See Also:
    
    Constant Field Values
  - KEY_MINEXPOSURE
```
public static final String KEY_MINEXPOSURE
```
    The minimum exposure time allowed for science frames.
    
    See Also:
    
    Constant Field Values
  - KEY_MAXEXPOSURE
```
public static final String KEY_MAXEXPOSURE
```
    The maximum exposure time allowed for science frames.
    
    See Also:
    
    Constant Field Values
  - KEY_EXPOSURETRIGGER
```
public static final String KEY_EXPOSURETRIGGER
```
    The key matching the name of the expose-trigger.
    
    See Also:
    
    Constant Field Values
  - KEY_TRANSFERTRIGGER
```
public static final String KEY_TRANSFERTRIGGER
```
    The key matching the name of the transfer-trigger.
    
    See Also:
    
    Constant Field Values
  - KEY_FITSKEYS
```
public static final String KEY_FITSKEYS
```
    The key pointig to default Fits-header information, keys section.
    
    See Also:
    
    Constant Field Values
  - KEY_CCDFITSKEYS
```
public static final String KEY_CCDFITSKEYS
```
    A map of CCD-keywords to keep and additional comments.
    
    See Also:
    
    Constant Field Values
  - KEY_FIXFITSKEYS
```
public static final String KEY_FIXFITSKEYS
```
    A map of fixed fits keywords.
    
    See Also:
    
    Constant Field Values
  - KEY_GEOMETRYTIME
```
public static final String KEY_GEOMETRYTIME
```
    Time for the geometry command.
    
    See Also:
    
    Constant Field Values
  - KEY_FITSTIME
```
public static final String KEY_FITSTIME
```
    Time for the fits command.
    
    See Also:
    
    Constant Field Values
  - KEY_BIASTIME
```
public static final String KEY_BIASTIME
```
    Time for the bias command, first part, without readout time.
    
    See Also:
    
    Constant Field Values
  - KEY_ABORTEXPOSURETIME
```
public static final String KEY_ABORTEXPOSURETIME
```
    Time for the abort exposure command, first part, without readout time.
    
    See Also:
    
    Constant Field Values
  - KEY_READOUTTIME
```
public static final String KEY_READOUTTIME
```
    The multiplier for the expected read-out time.
    
    See Also:
    
    Constant Field Values
  - KEY_EXPOSEBUFFER
```
public static final String KEY_EXPOSEBUFFER
```
    The multiplier for the exposure time.
    
    See Also:
    
    Constant Field Values
  - KEY_WRITETIME
```
public static final String KEY_WRITETIME
```
    The time for the expected fits write-time.
    
    See Also:
    
    Constant Field Values
  - KEY_SAFETYTIME
```
public static final String KEY_SAFETYTIME
```
    If non-null, added to the exposure time for ack(2) on exposures.
    
    See Also:
    
    Constant Field Values
  - KEY_CAMERABIAS
```
public static final String KEY_CAMERABIAS
```
    If true, driver supports bias frames directly.
    
    See Also:
    
    Constant Field Values
  - KEY_CAMERADARK
```
public static final String KEY_CAMERADARK
```
    If true, driver supports dark frames.
    
    See Also:
    
    Constant Field Values
  - KEY_MASTERPATH
```
public static final String KEY_MASTERPATH
```
    The fits path how the master can access the science ccd host data.
    
    See Also:
    
    Constant Field Values
  - KEY_ARCHIVEPATH
```
public static final String KEY_ARCHIVEPATH
```
    The fits path on the archive host.
    
    See Also:
    
    Constant Field Values
  - KEY_DATEFORMAT
```
public static final String KEY_DATEFORMAT
```
    The formatter for the date.
    
    See Also:
    
    Constant Field Values
  - KEY_BIASFITS
```
public static final String KEY_BIASFITS
```
    The key to the header for bias fits on the ccd host.
    
    See Also:
    
    Constant Field Values
  - KEY_DARKFITS
```
public static final String KEY_DARKFITS
```
    The key to the header for dark fits on the ccd host.
    
    See Also:
    
    Constant Field Values
  - KEY_SCIENCEFITS
```
public static final String KEY_SCIENCEFITS
```
    The key to the header for science fits on the ccd host.
    
    See Also:
    
    Constant Field Values
  - KEY_ABORTFITS
```
public static final String KEY_ABORTFITS
```
    The key to the header for science fits on the ccd host.
    
    See Also:
    
    Constant Field Values
  - KEY_DELETEFITS
```
public static final String KEY_DELETEFITS
```
    If true, fits files on the ccd host are deleted after copying.
    
    See Also:
    
    Constant Field Values
  - KEY_ALWAYSZERO
```
public static final String KEY_ALWAYSZERO
```
    If true, the shutter is set to its zero position after each exposure.
    
    See Also:
    
    Constant Field Values
  - KEY_MANUALSHUTTER
```
public static final String KEY_MANUALSHUTTER
```
    If true, the shutter is moved manually. Use with no autoshutter.
    
    See Also:
    
    Constant Field Values
  - KEY_MAXQUERIES
```
public static final String KEY_MAXQUERIES
```
    The time interval at which the status is queried.
    
    See Also:
    
    Constant Field Values
  - KEY_QUERYCYCLE
```
public static final String KEY_QUERYCYCLE
```
    The time interval at which the status is queried.
    
    See Also:
    
    Constant Field Values
  - KEY_CCDWATCHMINIMUM
```
public static final String KEY_CCDWATCHMINIMUM
```
    If this is set, we observe these CCD-info key for not being higher.
    
    See Also:
    
    Constant Field Values
  - KEY_WATCHMINVALUES
```
public static final String KEY_WATCHMINVALUES
```
    The vaules above which we may not fall during watch.
    
    See Also:
    
    Constant Field Values
  - KEY_CCDWATCHMAXIMUM
```
public static final String KEY_CCDWATCHMAXIMUM
```
    If this is set, we observe these CCD-info key for not being lower.
    
    See Also:
    
    Constant Field Values
  - KEY_WATCHMAXVALUES
```
public static final String KEY_WATCHMAXVALUES
```
    The vaules below which we may not fall during watch.
    
    See Also:
    
    Constant Field Values
  - KEY_ENABLEWATCH
```
public static final String KEY_ENABLEWATCH
```
    If set to any time other than zero, this is the watch intervall.
    
    See Also:
    
    Constant Field Values
  - KEY_LOGWATCH
```
public static final String KEY_LOGWATCH
```
    If true, values are logged to syslog.
    
    See Also:
    
    Constant Field Values
  - DEFMAXEXPOSURE
```
private static final long DEFMAXEXPOSURE
```
    The default maximal exposure time
    
    See Also:
    
    Constant Field Values
  - DEFEXPOSEBUFFER
```
private static final double DEFEXPOSEBUFFER
```
    The default multiplier for exposure time.
    
    See Also:
    
    Constant Field Values
  - DEFSAFETYTIME
```
private static final long DEFSAFETYTIME
```
    The default safety time.
    
    See Also:
    
    Constant Field Values
  - DEFBIASFITS
```
private static final String DEFBIASFITS
```
    The default fits-file name head for bias exposures.
    
    See Also:
    
    Constant Field Values
  - DEFDARKFITS
```
private static final String DEFDARKFITS
```
    The default fits-file name head for bias exposures.
    
    See Also:
    
    Constant Field Values
  - DEFSCIENCEFITS
```
public static final String DEFSCIENCEFITS
```
    The default fits-file name head for bias exposures.
    
    See Also:
    
    Constant Field Values
  - DEFABORTFITS
```
private static final String DEFABORTFITS
```
    The default fits-file name head for aborted exposures.
    
    See Also:
    
    Constant Field Values
  - DEFMAXQUERIES
```
private static final int DEFMAXQUERIES
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFQUERYCYCLE
```
private static final long DEFQUERYCYCLE
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFLOGWATCH
```
private static final boolean DEFLOGWATCH
```
    If true, values are logged to syslog.
    
    See Also:
    
    Constant Field Values
  - BIASEXPOSURE
```
private static final double BIASEXPOSURE
```
    The exposure time on bias frames if driver does not support bias, ms.
    
    See Also:
    
    Constant Field Values
  - IMAGETYPE
```
protected static final String IMAGETYPE
```
    The special imagetype key that is set during manual bias/flat/science.
    
    See Also:
    
    Constant Field Values
  - BIASTYPE
```
private static final String BIASTYPE
```
    The imagetype value for manual bias.
    
    See Also:
    
    Constant Field Values
  - DARKTYPE
```
private static final String DARKTYPE
```
    The imagetype value for manual dark.
    
    See Also:
    
    Constant Field Values
  - OBJECTTYPE
```
private static final String OBJECTTYPE
```
    The imagetype value for manual science.
    
    See Also:
    
    Constant Field Values
  - TYPEREM
```
protected static final String TYPEREM
```
    The imagetpye comment for manual operation.
    
    See Also:
    
    Constant Field Values
  - FITSEXTENSION
```
private static final String FITSEXTENSION
```
    Default fits extension.
    
    See Also:
    
    Constant Field Values
  - FITSDATE
```
private static final DateFormat FITSDATE
```
    The formatter for fits dates.
  - COMMENTSEPARATOR
```
protected static final String COMMENTSEPARATOR
```
    In fits-keys map the separator between values and comments.
    
    See Also:
    
    Constant Field Values
  - STRING
```
protected static final String STRING
```
    See Also:
    
    Constant Field Values
  - camera
```
protected CcdDriver camera
```
    The driver object for the camera. Convenience.
  - expose
```
private Thread expose
```
    A thread doing a single exposure.
  - header
```
private Thread header
```
    For efficiency, collect header info during expose.
  - defaultfits
```
private Map<String,CameraMaster.CardInfo> defaultfits
```
    The fits header data given as defaults.
  - addfits
```
private Map<String,CameraMaster.CardInfo> addfits
```
    The fits header data added during operation, see FitsCcd.
  - ccdfits
```
private Map<String,CameraMaster.CardInfo> ccdfits
```
    CCD info fits.
  - fixfits
```
protected Map<String,CameraMaster.CardInfo> fixfits
```
    The fits header data with unchangable fits entries, keys to val/rem.
  - watch
```
private CameraMaster.CcdWatch watch
```
    If we watch the ccd, this is non-null.
  - ccdinfo
```
private Map<String,Object> ccdinfo
```
    Last info retrieved.
  - lasthead
```
private String lasthead
```
    Last type of fits, for aborted exposures.
  - gather
```
private CameraMaster.HeaderGather gather
```
- Constructor Detail
  - CameraMaster
```
protected CameraMaster(Map<String,String> prop)
```
    Constructs a new CCD master. Default values for the times are set. If the KEY_CAMERA key is missing or the camera driver could not be contructed out of the given property, construction fails with an exception, see #initSesMaster. The keys GenericMaster.KEY_SET, KEY_FITSKEYS, #KEY_FITSPARAMETERS, and #KEY_FITSCOMMENTS are optional keys.
    As common in final, rmi-enabled classes, the environment master calls exportObject on the UnicastRemoteObject server class.
    
    See Also:
    
    #init
- Method Detail
  - initStep
```
public void initStep(int curstep)
              throws InitException
```
    Delay the init method of the receiver torso until we finished the initialization of the ccd master.
    
    Specified by:
    
    initStep in interface StepInitializable
    
    Overrides:
    
    initStep in class GenericMaster
    
    Throws:
    
    InitException
    
    See Also:
    
    #initSesMaster
  - init2
```
protected void init2()
```
    The main initialization section. Only called after construction. In this method the camera driver is constructed and initialized. If a GenericMaster.KEY_SET is present, a parameter cluster is constructed and the camera driver is passed to the set. Additionally, the default fits header table is constructed and loaded with values pointed to by the appropriate keys. Whenever the construction of the camera driver is successful, the fits tables are at least constructed, though maybe empty.
    
    Throws:
    
    IllegalArgumentException - If the camera was not constructed
  - exit
```
public void exit()
```
    Stops the timer in this VM.
    
    Specified by:
    
    exit in interface ExitCleaning
    
    Overrides:
    
    exit in class GenericMaster
  - rescanned
```
public double rescanned(String key,
                        String old,
                        String newval)
```
    On reload, we can rebuild the fits tables. If the camera driver changed, we can cope with that, if it is an already initialized driver.
    
    Specified by:
    
    rescanned in interface Reloadable
    
    Overrides:
    
    rescanned in class GenericMaster
  - parseToKey
```
private Map<String,CameraMaster.CardInfo> parseToKey(String pk)
```
  - accepts
```
public boolean accepts(CommandEvent ce)
                throws RemoteException
```
    Checks if the command received is accepted by the ccd master. A ccd master accepts all CcdCommands.
    
    Specified by:
    
    accepts in interface RmiCommandListener
    
    Throws:
    
    RemoteException
  - getBiasExposure
```
public boolean getBiasExposure(String fits)
                        throws RemoteException
```
    Takes a bias image. See SesControlling.
    
    Specified by:
    
    getBiasExposure in interface CameraControlling
    
    Returns:
    
    True on success.
    
    Throws:
    
    RemoteException
  - getDarkExposure
```
public boolean getDarkExposure(String fits,
                               double time)
                        throws RemoteException
```
    Takes a dark exposure. See SesControlling.
    
    Specified by:
    
    getDarkExposure in interface CameraControlling
    
    Parameters:
    
    fits - The file where the fits data is writtn to.
    
    time - The exposure time in seconds.
    
    Returns:
    
    True on success.
    
    Throws:
    
    RemoteException
  - getScienceExposure
```
public boolean getScienceExposure(String fits,
                                  double time)
                           throws RemoteException
```
    Takes a scientific exposure. See SesControlling.
    
    Specified by:
    
    getScienceExposure in interface CameraControlling
    
    time - The exposure time in seconds.
    
    Returns:
    
    True on success.
    
    Throws:
    
    RemoteException
  - abortExposure
```
public boolean abortExposure(String writeto)
                      throws RemoteException
```
    Supported only with with Asynchronous cameras.
    
    Specified by:
    
    abortExposure in interface CameraControlling
    
    Throws:
    
    RemoteException
  - setImageGeometry
```
public boolean setImageGeometry(int xoff,
                                int yoff,
                                int xsize,
                                int ysize,
                                int xbin,
                                int ybin)
                         throws RemoteException
```
    Sets the image geometry. See SesControlling.
    
    Specified by:
    
    setImageGeometry in interface CameraControlling
    
    Parameters:
    
    xoff - The offset on the CCD in x-direction, in pixel.
    
    yoff - The offset on the CCD in y-direction, in pixel.
    
    xsize - The size of the subframe in x-direction, in pixel.
    
    ysize - The size of the subframe in y-direction, in pixel.
    
    xbin - The binning factor in x-direction.
    
    ybin - The binning factor in y-direction.
    
    Returns:
    
    True on success.
    
    Throws:
    
    RemoteException
  - setFullFrame
```
public boolean setFullFrame()
                     throws RemoteException
```
    Resets the CCD-windowing. See SesControlling. The camera instance is always non-null.
    
    Specified by:
    
    setFullFrame in interface CameraControlling
    
    Returns:
    
    True on success.
    
    Throws:
    
    RemoteException
  - addFitsKey
```
public boolean addFitsKey(String key,
                          String parametername,
                          String comment)
                   throws RemoteException
```
    Adds a key to the fits header section.
    
    Specified by:
    
    addFitsKey in interface CameraControlling
    
    Parameters:
    
    key - The fitskey.
    
    parametername - Name of the parameter whose value should be added.
    
    comment - A comment or the mepty string for no comment.
    
    Throws:
    
    RemoteException
  - removeFitsKey
```
public boolean removeFitsKey(String key)
                      throws RemoteException
```
    Removes a fits header key. If the key is not found, false is returned.
    
    Specified by:
    
    removeFitsKey in interface CameraControlling
    
    Throws:
    
    RemoteException
  - removeAllFitsKeys
```
public boolean removeAllFitsKeys()
                          throws RemoteException
```
    Removes all except the default fits header keys.
    
    Specified by:
    
    removeAllFitsKeys in interface CameraControlling
    
    Throws:
    
    RemoteException
  - quit
```
public void quit()
          throws RemoteException
```
    Gracefully quite the ccd master. The CCD is parked, meaning that all native resources are freed before this method exits.
    
    Specified by:
    
    quit in interface ListenerControlling
    
    Overrides:
    
    quit in class GenericMaster
    
    Throws:
    
    RemoteException
  - reset
```
public boolean reset()
              throws RemoteException
```
    Zero positions all filter wheels and sets the calibration sledge to home.
    
    Specified by:
    
    reset in interface ListenerControlling
    
    Overrides:
    
    reset in class GenericMaster
    
    Throws:
    
    RemoteException
  - getAcknowledgeNumber
```
protected int getAcknowledgeNumber(CommandEvent cmd)
```
    Returns the number of acknowledge events produced for each command. If the command is unknown, -1 is returned to indicate for daughter classes that they should intervene.
    
    Overrides:
    
    getAcknowledgeNumber in class GenericMaster
  - getCompletionTime
```
protected long getCompletionTime(CommandEvent cmd,
                                 int acknr)
```
    Returns the individual completion times. For exposure commands, the first acknowledge time is the sum of the exposure time plus the read-out time from the controller to the local buffer. The second acknowledge time is the time it takes to write the fits file out of the local data buffer.
    If the command is unknown, -1 is returned.
    
    Overrides:
    
    getCompletionTime in class GenericMaster
    
    Parameters:
    
    cmd - The command to process.
    
    acknr - The number of the acknowledge that will be sent back.
  - processCommand
```
protected boolean processCommand(CommandEvent cmd,
                                 int acknr)
```
    Process the command. The exposure commands are split into three processes, the first one consisting of taking the exposure, the second transfering the CCD-data to the local buffer. The third part is writing the locally buffered data to the fits file. This allows the sequencer to continue operation once the data has been transfered from the CCD to the local buffer. In principle, the next exposure can start as soon as the data transfer to the local buffer is completed.
    
    Overrides:
    
    processCommand in class GenericMaster
  - statusMaster
```
protected String statusMaster(CommandEvent cmd)
```
    Returns a status information of the camera as a string.
    
    Specified by:
    
    statusMaster in class GenericMaster
    
    Parameters:
    
    cmd - Non-null in automatic mode.
    
    Returns:
    
    A string
  - resetMaster
```
protected boolean resetMaster(CommandEvent cmd)
```
    Resets the CCD. Calls the camera head reset method in the camera dirver.
    
    Specified by:
    
    resetMaster in class GenericMaster
    
    Parameters:
    
    cmd - Non-null in automatic mode.
  - abortMaster
```
protected boolean abortMaster(CommandEvent cmd)
```
    Aborts the CCD if possible. Currently only drivers are supported.
    
    Overrides:
    
    abortMaster in class GenericMaster
    
    Parameters:
    
    cmd - Non-null in automatic mode.
  - parkMaster
```
protected boolean parkMaster(CommandEvent cmd)
```
    Parks the CCD. Simply calls the abortMaster(stella.CommandEvent) method.
    
    Specified by:
    
    parkMaster in class GenericMaster
    
    Parameters:
    
    cmd - Non-null in automatic mode.
  - quitMaster
```
protected void quitMaster(CommandEvent cmd)
```
    Aborts the exposure and proceeds with the parental method (closes drivers).
    
    Overrides:
    
    quitMaster in class GenericMaster
    
    Parameters:
    
    cmd - Non-null in automatic mode, ignored in this implementation
  - initShutter
```
protected abstract boolean initShutter()
```
    If no explicit shutter action is required, simply return true here.
    
    Returns:
  - initializeMaster
```
protected boolean initializeMaster(CommandEvent cmd)
```
    Initializes the CCD. The native driver is constructed and initialized.
    
    Specified by:
    
    initializeMaster in class GenericMaster
    
    Parameters:
    
    cmd - Non-null in automatic mode.
  - abortTake
```
private boolean abortTake()
```
    Aborts the exposure. Used in automatic and manual mode.
  - ensureExposureFinished
```
private boolean ensureExposureFinished()
                                throws IOException
```
    We wait until the camera is reading out.
    
    Returns:
    
    True when the readout has started.
    
    Throws:
    
    IOException
  - takeBias
```
private boolean takeBias()
```
    Takes a bias exposure. No exposure time needed. Directly calls the MainCamera#takeBiasExposure in the MainCamera object of the CameraDriver. For the moment, synchronization is done by checking the MainCamera#isBiasExposureDone on regular intervalls, using a wait on the main camera, but notification is not yet impelmented.
  - takeDark
```
private boolean takeDark(double time)
```
    Takes a dark exposure. Directly calls the MainCamera#takeDarkExposure in the MainCamera object of the CameraDriver. For the moment, synchronization is done by checking the MainCamera#isDarkExposureDone on regular intervalls, using a wait on the main camera, but notification is not yet impelmented.
  - takeExposure
```
protected boolean takeExposure(double time)
```
    Takes a normal exposure. Directly calls the MainCamera#takeExposure in the MainCamera object of the CameraDriver. For the moment, synchronization is done by checking the MainCamera#isExposureDone on regular intervalls, using a wait on the main camera, but notification is not yet impelmented.
  - takeExposure
```
private boolean takeExposure(double time,
                             String fitsname)
```
    Takes a normal exposure. Directly calls the MainCamera#takeExposure in the MainCamera object of the CameraDriver. For the moment, synchronization is done by checking the MainCamera#isExposureDone on regular intervalls, using a wait on the main camera, but notification is not yet impelmented.
  - closeShutter
```
protected abstract boolean closeShutter()
```
    For cameras with a 'manual' shutter, i.e., a shutter that is not auto-operated by the CCD controller.
    
    Returns:
  - openShutter
```
protected abstract boolean openShutter()
```
    For cameras with a 'manual' shutter, i.e., a shutter that is not auto-operated by the CCD controller.
    
    Returns:
  - readout
```
protected boolean readout(boolean shuttermoved)
```
    Simulates the readout process. This is done by the CCD driver. For possible resetting of the shutter, we provide a boolean that indicates a shutter movement.
    
    Parameters:
    
    shuttermoved - True if shutter was moved and may possibly be reset.
  - writeFits
```
protected boolean writeFits(CommandEvent cmd,
                            File fits,
                            boolean science)
```
    Writes the data allocated in the CcdDriver object to a fits file provided as an argument. If the argument is null this method returns immediately without writing the file. This method opens the fits file the ccd has written to and adds header information to it. It is saved to a probably different path, where intermediate storage is possible (RAID). If the copying process is successful, we delete the old file.
  - writeFits
```
private boolean writeFits(CommandEvent cmd,
                          File fits,
                          boolean science,
                          boolean surestore)
```
    Writes the data allocated in the CcdDriver object to a fits file provided as an argument. If the argument is null this method returns immediately without writing the file. This method opens the fits file the ccd has written to and adds header information to it. It is saved to a probably different path, where intermediate storage is possible (RAID). If the copying process is successful, we delete the old file.
  - getPermanentFile
```
private File getPermanentFile(File fits)
```
  - probeForType
```
@Deprecated
private static Class<?> probeForType(Object val)
```
    Deprecated.
    If no type argument is given, we try to deduce it from the value type, using the following, sequential, rules:
    - If the value is parsable as a Long, its type is long
    - If the value is parsable as a Double, its type is double
    - It type is String.
  - getCcdCards
```
public static List<MHeaderCard> getCcdCards(Map<String,CameraMaster.CardInfo> keep,
                                            Map<String,?> ccd)
```
    Adds information received from the ccd driver.
  - getFixedCards
```
public static List<MHeaderCard> getFixedCards(Map<String,CameraMaster.CardInfo> fix)
```
    Returns a list of MHeaderCards from a fixed info map.
  - getParameterCards
```
public static List<MHeaderCard> getParameterCards(Map<String,CameraMaster.CardInfo> give,
                                                  GlobalGrouping set)
```
    Writes fits header information. All of the datas found in the map is transfered to the fits header information in the following way: The key is the key to the fits heder entry. The value is interpreted as the name of the parameter to enter, followed by a remark. If the parameter is of CurrentTime type, we actually enter a Date formatted with FITSDATE.
  - geometry
```
private boolean geometry(CommandEvent cmd,
                         int xoff,
                         int yoff,
                         int xsize,
                         int ysize,
                         int xbin,
                         int ybin)
```
    Sets the geometry of the next image on the ccd. Calls the six methods in MainCamera related to the size/origin/binning of the image.
  - fitsKey
```
private boolean fitsKey(String key,
                        String parameter,
                        String comment)
```
    Adds/removes a fits header key from the customizable table. If the first argument is null, all mappings are ereased, i.e. all except the default header settings are deleted. If the second argument is null, only the mapping with the key given in the first argument is ereased. If the first to arguments are valid, a new mapping is added.
  - formatFitsName
```
protected String formatFitsName(String fill)
```
    Formatting a fits file name from a place-holder supplied. The following rules apply:
    - currly braces indicate a parameter name that is replaced with the value of the parameter or ereased, e.g. {Unique}.
    - square braces indicate a key in the CCD info map, e.g. [Temp]. In the result its replaced with the value
    - Anything else is left as input
    - The user has no choice on the extension.
    Example: science{Unique} returns the classic entry, as if no name would be given.
    If unmatched parenthesis are encountered, the input string is returned.
  - main
```
public static void main(String[] arg)
                 throws RemoteException
```
    Starts the ccd master with the given properties or directly accesses a running CCD master.
    
    Throws:
    
    RemoteException

Class CameraMaster

Nested Class Summary

Nested classes/interfaces inherited from class stella.rmi.GenericMaster

Nested classes/interfaces inherited from class stella.rmi.ReceiverTorso

Nested classes/interfaces inherited from class util.PropertyResources

Field Summary

Fields inherited from class stella.rmi.GenericMaster

Fields inherited from class stella.rmi.ReceiverTorso

Fields inherited from class util.rmi.AbstractRmiListener

Fields inherited from class util.PropertyResources

Fields inherited from class util.PropertyContainer

Fields inherited from interface stella.rmi.RmiAcknowledgeCaster

Fields inherited from interface stella.rmi.RmiDoneCaster

Fields inherited from interface util.StepInitializable

Fields inherited from interface util.ResourceSupplying

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class stella.rmi.GenericMaster

Methods inherited from class stella.rmi.ReceiverTorso

Methods inherited from class stella.rmi.AbstractRmiCasterAndListener

Methods inherited from class util.rmi.AbstractRmiListener

Methods inherited from class util.PropertyResources

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Methods inherited from interface stella.rmi.ListenerControlling

Methods inherited from interface util.Reloadable

Methods inherited from interface util.rmi.RmiCaster

Methods inherited from interface stella.ErrorCaster

Methods inherited from interface util.rmi.RmiEventListener

Methods inherited from interface util.rmi.RmiListener

Methods inherited from interface util.PropertySupplying

Field Detail

DATENUMBERSEPARATOR

KEY_CAMERA

KEY_MINEXPOSURE

KEY_MAXEXPOSURE

KEY_EXPOSURETRIGGER

KEY_TRANSFERTRIGGER

KEY_FITSKEYS

KEY_CCDFITSKEYS

KEY_FIXFITSKEYS

KEY_GEOMETRYTIME

KEY_FITSTIME

KEY_BIASTIME

KEY_ABORTEXPOSURETIME

KEY_READOUTTIME

KEY_EXPOSEBUFFER

KEY_WRITETIME

KEY_SAFETYTIME

KEY_CAMERABIAS

KEY_CAMERADARK

KEY_MASTERPATH

KEY_ARCHIVEPATH

KEY_DATEFORMAT

KEY_BIASFITS

KEY_DARKFITS

KEY_SCIENCEFITS

KEY_ABORTFITS

KEY_DELETEFITS

KEY_ALWAYSZERO

KEY_MANUALSHUTTER

KEY_MAXQUERIES

KEY_QUERYCYCLE

KEY_CCDWATCHMINIMUM

KEY_WATCHMINVALUES

KEY_CCDWATCHMAXIMUM

KEY_WATCHMAXVALUES

KEY_ENABLEWATCH

KEY_LOGWATCH

DEFMAXEXPOSURE

DEFEXPOSEBUFFER

DEFSAFETYTIME

DEFBIASFITS

DEFDARKFITS

DEFSCIENCEFITS

DEFABORTFITS

DEFMAXQUERIES

DEFQUERYCYCLE

DEFLOGWATCH