|
SUPPORT SITE |
|
|
|
SUPPORT SITE |
|
Path: Thermal/ThermalAnalysis
% Draw spacecraft in orbit about a planet, as seen by an in-situ camera.
An imager function can be specified, for instance optical or thermal
coloration. If no function is specified the CAD colors are used.
There are five calls you need to make when using this plugin.
(1) INITIALIZE
tag = SpaceCamera( 'initialize', d, g, jD )
d data structure
.camera (:) Camera model
.position (1,4) Position of the window
.planetName (1,:) Planet name
.imagerFunction (1,:) Imager function (can be handle, optional)
.name (1,:) Name for the plugin (optional)
.scale (1,1) Flag to scale up the spacecraft (optional)
.ambientStrength (1,1) Default strength if not 0 (optional)
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.
(2,3) UPDATE THE SPACECRAFT AND CAMERA
--------------------------------------
If you are updating the camera you should make these two calls in sequence:
SpaceCamera( 'update camera', tag, camera, jD )
SpaceCamera( 'update spacecraft', tag, g, jD )
The data structure in the 'update camera' call is as follows:
camera Camera data structure, see CameraDatabase
.position (3,1) Position of camera (m)
.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
.rBody (3,1) Location of camera in ECI frame, if known. (m)
.qBody (4,1) Orientation of camera from ECI frame, if known
(4) EXTRACT IMAGE
-----------------
To extract an image type
rGB = SpaceCamera( 'get frame', tag )
(5) QUIT
---------
To close the display type
SpaceCamera( 'quit', tag )
There are additional calls for interacting with the camera.
'get scene attitude' Return the ECI to planet-fixed transformation
'set ambient' Set an ambient strength for the patches
'toggle names' Toggle the spacecraft names
'get camera' Get the camera model
'get model' Get the target CAD model
--------------------------------------------------------------------------
Form:
tag = SpaceCamera( 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
--------------------------------------------------------------------------
AerospaceUtils: CAD/BHinge AerospaceUtils: CAD/DrawSpacecraftPatches Common: General/CloseFigure Common: Quaternion/Q2Mat Common: Time/Date2JD Common: Transform/RaDec2U Math: Linear/Cross Math: Linear/DupVect Math: Linear/Mag Math: Linear/Unit SC: BasicOrbit/El2RV SC: Ephem/ECIToPlanet SC: Ephem/SunV1 SC: SCModels/SCForImaging SC: Visualization/PlotPlanet SCPro: ProSensors/AutoPoint SCPro: ProSensors/CameraDatabase SCPro: ProSensors/PointCameraModel SpacecraftEstimation: StellarCatalog/LoadCatalog
Back to the Thermal Module page