-------------------------------------------------------------------------------
Draw a spacecraft in orbit about a planet showing the temperatures of each
surface.
There are five calls you need to make when using this plugin.
tag = SpaceThermalCamera( 'initialize', d, g, jD )
d data structure
.pixels (1,2) Pixels x and y
.position (1,4) Position of the window
.planet (1,:) Planet name
.colorMap (3,:) Color map
.tempMax (1,1) Maximum temperature of colormap
g is the spacecraft CAD data structure. It contains the ECI orbit
position of the spacecraft. The field for orbit position
.rECI must be in kilometers. The spacecraft model must be in
meters.
jD is the Julian date
You need to save tag to call the function in subsequent calls.
If you are updating the camera you should make two calls in the following sequence:
SpaceThermalCamera( 'update camera', tag, d )
SpaceThermalCamera( 'update spacecraft', tag, g, jD )
The data structure in the 'update camera' call is as follows:
d data structure
.mECIToBody (3,3) ECI to body matrix
.positionECI (3,1) ECI Position of camera
.up (3,1) Up unit vector in the camera frame
.focalLength (1,1) Focal length
.aperture (1,1) Aperture diameter
.rho (1,1) Imager diameter
Note that the camera boresight is always +z. d.up should not have
a z component. The z component will be ignored, if it exists, and
the remaining vector unitized.
SpaceThermalCamera( 'update spacecraft', tag, g, jD )
To extract an image type
rGB = SpaceThermalCamera( 'get frame', tag )
To close the display type
SpaceThermalCamera( 'quit', tag )
-------------------------------------------------------------------------------
Form:
tag = SpaceThermalCamera( action, modifier, g, jD )
-------------------------------------------------------------------------------
------
Inputs
------
action (1,:) Action
modifier (1,:) Modifier to the action
g (1,1) Spacecraft data structure
jD (1,1) Julian Date
-------
Outputs
-------
tag (1,:) The tag that identifies the display
or another output
-------------------------------------------------------------------------------