'''[wiki:GraspSwControllerCmd celldes]'''

[[TracNav(GraspContents)]]

||Command:||'''celldes'''||
||Contexts:||Network socket, serial console.  Applies only if the CCD is an "OTA" device.||
||Function:||Designates the intended function for each of the 64 cells.||
||Required Parameters:||'''cells'''=(64 S/V/D characters)||
||Optional Parameters:||'''dev'''='''all'''|'''0'''|'''1'''||

The string of cell designators must be a sequence of '''exactly 64 characters''':

||'''S'''||Designates Science readout use||
||'''V'''||Designates Video readout during exposure(*)||
||'''D'''||Designates a Dead cell which should be electrically floated||

Order of the cells is row-major listing of the Catesian coordinate system of cell positions.

Usage for the cells:

||xy07||xy17||xy27||xy37||xy47||xy57||xy67||xy77||
||xy06||xy16||xy26||xy36||xy46||xy56||xy66||xy76||
||xy05||xy15||xy25||xy35||xy45||xy55||xy65||xy75||
||xy04||xy14||xy24||xy34||xy44||xy54||xy64||xy74||
||xy03||xy13||xy23||xy33||xy43||xy53||xy63||xy73||
||xy02||xy12||xy22||xy32||xy42||xy52||xy62||xy72||
||xy01||xy11||xy21||xy31||xy41||xy51||xy61||xy71||
||xy00||xy10||xy20||xy30||xy40||xy50||xy60||xy70||

Is sent in the string in the following order:

cells='''xy00 xy10 xy20 . . . xy67 xy77'''

An actual command selecting all cells on "dev 1" but using xy11 for video would look like:

{{{
celldes dev=1 cells="SSSSSSSSSVSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS"
}}}

(*) CCD readouts, video or science, are "destructive" so a even though a "V" cell still gets included in the final readout, there is no valid image data.

=== Notes: ===

If dev= is omitted, the last default dev applies (which can be either 0 or 1, but not "all").

The FITS header for each exposure contains a nice self-documenting map illustrating which cells where video or floated, in addition to the 64-character keyword value '''CELLDES'''.

Various image displays may be rotated or flipped to match sky!