This page was created by the IDL library routine
mk_html_help2.
Last modified: Fri Jan 21 01:15:18 2011.
Procedure: sse_crib.pro
Purpose: A crib showing how to transform data from GSE to SSE coordinate system.
SSE is defined as:
X: Moon->Sun Line projected into the ecliptic plane
Y: Z x X
Z: Ecliptic north
Notes:
Code heavily based on make_mat_Rxy.pro & transform_gsm_to_rxy.pro by Christine Gabrielse(cgabrielse@ucla.edu)
$LastChangedBy: pcruce $
$LastChangedDate: 2009-08-14 16:10:49 -0700 (Fri, 14 Aug 2009) $
$LastChangedRevision: 6583 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/trunk/cotrans/special/sse/sse_crib.pro $
(See ssl_general/cotrans/special/sse/sse_crib.pro)
PROCEDURE: sse_matrix_make
Purpose:
Creates a set of matrices that will rotate data from GSE coordinate to SSE coordinate
Arguments:
Inputs:
name_sun_pos_gse: Name of the tplot variable(s) storing the sun position
name_lun_pos_gse: Name of the tplot variable(s) storing the lunar position
Input names can have globbing or can be arrays of names, but number of elements for
sun_pos and and lun_pos after globbing must match.
Outputs:
fail: Will be set to 1 if operation failed, returns 0 if operation succeeded. Will not signal failure if
at least one input was processed.
Keywords
suffix: The suffix to be appended to the tplot variables that the output matrices will be stored in.
(Default: name_sun_pos_gse + '_sse_mat')
newname: The name of the output matrix. If this keyword is used with multiple input values, the outputs
may overwrite each other. So you should only set this keyword if there is a single value for the state input.
ignore_dlimits: If set, will force routine to generate matrix, even if inputs are labeled as the wrong coordinate system
Example:
timespan,'2007-03-23'
thm_load_slp
cotrans,'slp_sun_pos','slp_sun_pos_gse',/gei2gse
cotrans,'slp_lun_pos','slp_lun_pos_gse',/gei2gse
sse_matrix_make,'slp_sun_pos_gse','slp_lun_pos_gse',newname='sse_mat'
thm_load_state,probe='a',coord='gse'
tvector_rotate,'sse_mat','tha_state_pos'
NOTES:
#1 SSE is defined as:
X: Moon->Sun Line
Y: Ecliptic North cross X
Z: X cross Y
#2 SSE coordinate Z-axis is generally not exactly parallel to ecliptic north,
as the moon will not always be in the ecliptic plane, and thus the moon->sun line
will not always lie in the ecliptic plane.
#3 If times in sun_pos_gse and lun_pos_gse do not match,
data will be interpolated to match the time grid in sun_pos_gse.
#4 If sun_pos_gse begins before or ends after lun_pos_gse, then lun_pos_gse
will be extrapolate with NaNs. This means the that no valid transformations
will be available on the intervals where both quantities are not available.
Written by Jenni Kissinger and Patrick Cruce
$LastChangedBy: pcruce $
$LastChangedDate: 2009-08-18 14:45:25 -0700 (Tue, 18 Aug 2009) $
$LastChangedRevision: 6602 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/trunk/cotrans/special/sse/sse_matrix_make.pro $
(See ssl_general/cotrans/special/sse/sse_matrix_make.pro)