public class MagellanDriver extends SynchronousCcdDriver implements StatusProviding, AutoClearing
SynchronousCcdDriver.ExposureThread, SynchronousCcdDriver.ThreadShotAbstractCcdDriver.Endurance, AbstractCcdDriver.Exposure, AbstractCcdDriver.Shot| Modifier and Type | Field and Description |
|---|---|
private MFits |
async
The data buffer for asynchroneous retrieval.
|
private static WifsipMagellanClient |
ccdclient
RPC client instance.
|
static String |
CCDSEC
Fits key for entering y-pregap info to header.
|
static String |
CCDSECREM
Comment for entering y-pregap info to header.
|
static String |
CCDTEMP
The keyword for the CCD temperature.
|
static double |
COPYBSCALE
Default scaling factor copied into the extensions, if not in primary.
|
static double |
COPYBZERO
Default zero offset copied into the extensions, if not in primary.
|
static String |
COPYREM
Comment for a key that was copied from the primary.
|
static String |
DATECOAL
Header keyword for receive exposure end.
|
static String |
DATECOALREM
Comment for receive exposure end.
|
static String |
DATESEND
Header keyword for send exposure start.
|
static String |
DATESENDREM
Comment for send exposure start.
|
private static int |
DEFAMPLIFIERS
Default property value.
|
private static boolean |
DEFAUTOFLUSH
The parameters for the extra setup, autoflush .
|
private static int |
DEFCOLAMPLIFIERS
Default property value.
|
static String |
DEFDRIVERNAME
The name of this ccd.
|
private static long |
DEFEXPOSEMULTIPLY
Default property value.
|
private static boolean |
DEFEXTRASETUP
If true the special setup comands copied from TF *.sh are called.
|
private static long |
DEFMAXTIME
Default property value.
|
private static long |
DEFMINTIME
Default property value.
|
private static boolean |
DEFNOSIZESET
Default property value.
|
private static int |
DEFRPCTIMEOUT
Default property value.
|
private static String |
DEFSERVERNAME
Default property value.
|
private static int |
DEFSHUTTERCLOSE
Default property value.
|
private static int |
DEFSHUTTEROPEN
Default property value.
|
private static boolean |
DEFSUPPORTSHUTTER
Default property value.
|
private static boolean |
DEFWRONGENDIAN
Default property value.
|
static String |
DETSIZE
Fits key for entering x-pregap info to header.
|
static String |
DETSIZEREM
Comment for entering x-pregap info to header.
|
static String |
KEY_AUTOFLUSH
The parameters for the extra setup, autoflush .
|
static String |
KEY_COLAMPLIFIERS
Total number of amplifiers expected in row direction.
|
static String |
KEY_EXPOSEMULTIPLY
The multiplier for exposure times returned to ms.
|
static String |
KEY_EXTRASETUP
If true the special setup comands copied from TF *.sh are called.
|
static String |
KEY_HCLKDIR
The parameters for the extra setup, vclkdir .
|
static String |
KEY_MUSEC
The parameters for the extra setup, usec .
|
static String |
KEY_NOSIZESET
If true changing or setting maxpixel is not allowed.
|
static String |
KEY_OUTPUTCH
The parameters for the extra setup, outputch .
|
static String |
KEY_RPCTIMEOUT
The RPC time-out in millisecond.
|
static String |
KEY_SERVERNAME
FCDN of the host where the guider rpc server is running.
|
static String |
KEY_SHUTTERCLOSE
The short paramter for shutter-close.
|
static String |
KEY_SHUTTEROPEN
The short paramter for shutter-open.
|
static String |
KEY_SUPPORTSHUTTER
If true, driver supports shutter operation.
|
static String |
KEY_VCLKDIR
The parameters for the extra setup, vclkdir .
|
static String |
KEY_WRONGENDIAN
If true, endian of received short are little.
|
static String |
KEY_XMAXSIZE
If set, the max size is not the chip size (for multi-amplifier readout).
|
static String |
KEY_YMAXSIZE
If set, the max size is not the chip size (for multi-amplifier readout).
|
private Rectangle |
lastwindow
Last window set (offset is not recoverable otherwise).
|
static String |
LN2TEMP
The keyword for the CCD temperature.
|
static int |
OK
General return code from rpc calls indicating okay.
|
KEY_AMPLIFIERS, KEY_AREAREADOUT, KEY_COLUMNPOST, KEY_COLUMNPRIOR, KEY_COLUMNREADOUT, KEY_FIXEDREADOUT, KEY_INITSIZE, KEY_MAXTIME, KEY_MINTIME, KEY_ROWPOST, KEY_ROWPRIOR, KEY_ROWREADOUT, KEY_XBINNING, KEY_XCHIPSIZE, KEY_XDETECTORSIZE, KEY_XORIGIN, KEY_XSIZE, KEY_YBINNING, KEY_YCHIPSIZE, KEY_YDETECTORSIZE, KEY_YORIGIN, KEY_YSIZEKEY_DRIVERNAMEKEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATORFITSEXTENSIONCONFIG, KEY_CLASS| Constructor and Description |
|---|
MagellanDriver(Map<String,String> info)
Constructor.
|
| Modifier and Type | Method and Description |
|---|---|
boolean |
close()
Close the RPC communication.
|
String |
conciseStatus()
Returns the current state of the CCD.
|
private boolean |
doDark()
Does a dark exposure.
|
private boolean |
doExposure()
Does an open-shutter exposure.
|
private boolean |
download(Date t0,
Date t1,
ergf result)
Takes the result of an exposure and makes a fits file out of it.
|
int |
expose()
Make an exposure.
|
int |
exposeBias()
Makes a bias exposure.
|
int |
exposeDark()
Makes a dark exposure.
|
Object |
extendedStatus()
Returns the current state of the CCD.
|
Dimension |
getBinning()
Get the binning values in x (columns) and y (rows).
|
Map<String,Object> |
getCcdInfo()
We return the temperature of the cold head plus the temperature of the
CCD here.
|
MFits |
getData()
Returns the output buffer.
|
double |
getExposureTime()
Get the current exposure time in milliseconds.
|
protected Dimension |
getMaxPixel()
Get the max_pixel values for x (columns) and y (rows).
|
private Point |
getPregap()
Returns the pregap.
|
private Dimension |
getReadoutArea()
Returns read-ouyt area as a dimension.
|
protected double |
getReadoutDirectionX(int x0,
int y0,
int n)
Get the readout direction in x for the current amplifier position
|
protected double |
getReadoutDirectionY(int x0,
int y0,
int n)
Get the readout direction in y for the current amplifier position
|
private static String |
getSection(int xl,
int yd,
int xll,
int ydd)
Formats a window to a section string.
|
Rectangle |
getWindow()
Get the current image origin (pre-gap) in x (columns) and y (rows) and
the size
|
void |
init()
Clear any leftovers.
|
boolean |
isAutoClearing()
Gets the autoflush property.
|
boolean |
isExposing()
We are exposing if the
#provideStatus method returns 1. |
boolean |
isOpen()
We consider the driver to be open if the ccdclient is initialized.
|
protected boolean |
openController()
Initializes the fechner driver.
|
boolean |
setAutoClearing(boolean to)
Sets the autoflush property.
|
boolean |
setBinning(int xbin,
int ybin)
Set the binning values in x (columns) and y (rows).
|
boolean |
setExposureTime(double exptime)
Set the current exposure time in milliseconds.
|
protected boolean |
setMaxPixel(Dimension max)
Set the max_pixel values for x (columns) and y (rows).
|
private boolean |
setShutter(boolean open)
Sets the shutter position.
|
boolean |
setWindow(Rectangle window)
Set the current image window.
|
private static short[] |
swap(short[] little,
int start,
int len)
Swaps wrong endian in a short array.
|
cancelContinuous, ensureReady, getRunning, isReadingOut, startContinuous, stopContinuous, threadedBiasExpose, threadedDarkExpose, threadedExposegetDetectorSize, getMaximumExposureTime, getMinimumExposureTime, getReadoutMaximum, getReadoutTime, opencreateDriver, equals, getDriverName, hashCodeaugment, augment, augment, augment, augment, clone, 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, initProperties, isNew, parseObject, parseObject, reload, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties, toStringfinalize, getClass, notify, notifyAll, wait, wait, waitgetDetectorSize, getMaximumExposureTime, getMinimumExposureTime, getReadoutMaximum, getReadoutTimegetDriverName, openpublic static final String CCDTEMP
public static final String LN2TEMP
public static final int OK
public static final double COPYBZERO
public static final double COPYBSCALE
public static final String DETSIZE
public static final String DETSIZEREM
public static final String CCDSEC
public static final String CCDSECREM
public static final String COPYREM
public static final String DATESEND
public static final String DATECOAL
public static final String DATESENDREM
public static final String DATECOALREM
public static final String KEY_SERVERNAME
public static final String KEY_EXPOSEMULTIPLY
public static final String KEY_SUPPORTSHUTTER
public static final String KEY_SHUTTEROPEN
public static final String KEY_SHUTTERCLOSE
public static final String KEY_RPCTIMEOUT
public static final String KEY_WRONGENDIAN
public static final String KEY_COLAMPLIFIERS
public static final String KEY_NOSIZESET
public static final String KEY_XMAXSIZE
public static final String KEY_YMAXSIZE
public static final String KEY_EXTRASETUP
public static final String KEY_VCLKDIR
public static final String KEY_HCLKDIR
public static final String KEY_OUTPUTCH
public static final String KEY_MUSEC
public static final String KEY_AUTOFLUSH
public static final String DEFDRIVERNAME
private static final String DEFSERVERNAME
private static final boolean DEFSUPPORTSHUTTER
private static final int DEFSHUTTEROPEN
private static final int DEFSHUTTERCLOSE
private static final long DEFMINTIME
private static final long DEFEXPOSEMULTIPLY
private static final long DEFMAXTIME
private static final int DEFRPCTIMEOUT
private static final boolean DEFWRONGENDIAN
private static final boolean DEFNOSIZESET
private static final int DEFAMPLIFIERS
private static final int DEFCOLAMPLIFIERS
private static final boolean DEFEXTRASETUP
private static final boolean DEFAUTOFLUSH
private static WifsipMagellanClient ccdclient
private MFits async
private Rectangle lastwindow
public void init()
throws InitException
init in interface Initializableinit in class AbstractCcdDriverInitExceptionpublic boolean isExposing()
#provideStatus method returns 1. Never ask
directly at exposure start, may yield inadequate results.isExposing in interface CcdDriverisExposing in class SynchronousCcdDriverpublic Object extendedStatus()
extendedStatus in interface StatusProvidingpublic String conciseStatus()
conciseStatus in interface StatusProvidingprotected boolean openController()
throws IOException
openController in class AbstractCcdDriverIOException - If controller connection fails.public boolean isOpen()
public boolean close()
throws IOException
close in interface DriverIOExceptionprotected boolean setMaxPixel(Dimension max) throws IOException
xmax - maximum CCD size in x-direction (1 <= value < 65536)ymax - maximum CCD size in y-direction (1 <= value < 65536)IOExceptionprotected Dimension getMaxPixel() throws IOException
IOExceptionpublic boolean setBinning(int xbin,
int ybin)
throws IOException
setBinning in interface CcdDriverxbin - binning factor in x-direction (1 <= binning factor <= 255)ybin - binning factor in y-direction (1 <= binning factor <= 255)IOException - Any subclass of IOExceptionpublic Dimension getBinning() throws IOException
getBinning in interface CcdDriverIOException - Any subclass of IOException.public boolean setWindow(Rectangle window) throws IOException
setWindow in interface CcdDriverwindow - The origin being the upper left corner of the rectangle.IOException - Any subclass of IOException.public Rectangle getWindow() throws IOException
getWindow in interface CcdDriverIOException - Any subclass of IOException.public boolean setExposureTime(double exptime)
throws IOException
setExposureTime in interface CcdDriverexpTime - exposure time in milliseconds. (0 <= expTime < 65536 ms)IOException - Any subclass of IOException.public double getExposureTime()
throws IOException
getExposureTime in interface CcdDriverIOException - Any subclass of IOException.public boolean setAutoClearing(boolean to)
throws IOException
setAutoClearing in interface AutoClearingIOExceptionpublic boolean isAutoClearing()
throws IOException
isAutoClearing in interface AutoClearingIOExceptionpublic MFits getData() throws IOException
#setDataBuffer, or null if not set and no exposure has been
taken. If an exposure has finished and the buffer has not been explicedly
set, a new fits object has been allocated, which will be returned here.getData in interface CcdDriverIOException - Any subclass of IOException.public Map<String,Object> getCcdInfo() throws IOException
getCcdInfo in interface CcdDriverIOExceptionpublic int expose()
throws IOException
expose in interface CcdDriverIOException - Any subclass of IOException.startExposepublic int exposeBias()
throws IOException
exposeBias in interface CcdDriverIOException - Any subclass of IOException.public int exposeDark()
throws IOException
exposeDark in interface CcdDriverIOException - Any subclass of IOException.private Point getPregap() throws IOException
IOExceptionprivate static short[] swap(short[] little,
int start,
int len)
private Dimension getReadoutArea() throws IOException
IOExceptionprivate boolean setShutter(boolean open)
throws IOException
IOExceptionprotected double getReadoutDirectionX(int x0,
int y0,
int n)
protected double getReadoutDirectionY(int x0,
int y0,
int n)
private static String getSection(int xl, int yd, int xll, int ydd)
private boolean doExposure()
throws IOException
StreamClient#DO_EXPOSURE_2, grabs the returned fits
object and transforms it to the more general ImageHDU java
object. If a data buffer-fits is set, all of its HDU's are deleted and
the new Image is added to the fits file. If no async buffer was set, a
new fits file is generated with the current data. // the END card is
always missing, but we want to add originIOExceptionprivate boolean doDark()
throws IOException
StreamClient#DO_DARK_2, grabs the returned fits object
and transforms it to the more general ImageHDU java object. If a
data buffer-fits is set, all of its HDU's are deleted and the new Image
is added to the fits file. If no async buffer was set, a new fits file is
generated with the current data. // the END card is always missing, but
we want to add originIOExceptionprivate boolean download(Date t0, Date t1, ergf result) throws BasicFitsException
BasicFitsException