procedure: gse2sse Purpose: Coordinate transformation between GSE & SSE coordinates(and the inverse) SSE is defined as: X: Moon->Sun Line Y: Ecliptic North cross X Z: X cross Y GSE is defined as: X: Earth Sun Line(naturally in the ecliptic plane) Y: Z x X Z: Ecliptic North inputs: name_in: Name of input tplot variable to be transformed or an array of data [t,x,y,z] name_sun_pos: Name of the solar position tplot variable in GEI coordinates or as an array of data [t,x,y,z] name_lun_pos: Name of the lunar position tplot variable in GEI coordinates or as an array of data [t,x,y,z] name_out: Name that the rotated variable should take. keywords: /SSE2GSE inverse transformation /IGNORE_DLIMITS: Dlimits normally used to determine if coordinate system is correct, to decide if position needs offset, or to stop incorrect transforms. This option will stop this behavior. This keyword is only used with tplot variables and ignored if array data is input /ROTATION_ONLY: Set this flag when to only do the rotation, and not the translation from geocentric to selenocentric coordinates. That is used for sse2sel transform when creating the sel rotation matrix Examples: gse2sse,'tha_state_pos','slp_sun_pos_gse','slp_lun_pos_gse','tha_state_pos_sse' gse2sse,'tha_state_pos_sse','slp_sun_pos_gse','slp_lun_pos_gse','tha_state_pos_gse',/sse2gse,/ignore_dlimits OR (with vector data [t,x,y,z] gse2sse, pos_gse,sun_gse,lun_pos,pos_sse gse2sse,pos_sse,sun_gse,lun_pos,pos_gse,/sse2gse Notes: #1 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. #2 If dlimit-labeled position passed in without /ignore_dlimits, input will be offset to account for relative position of frames of reference. #3 If dlimit-labeled velocity passed in without /ignore_dlimits, input will be offset to account for relative motion of frames of reference #4 If dlimit-labeled acceleration passed in without /ignore_dlimits, warning will be raise, but offset will not be applied automatically #5 Uses tvector_rotate, and sse_matrix_make to perform the rotation. tvector_rotate will also interpolate the rotation matrix onto the time-grid of the input. Interpolation done using quaterions and the spherical linear interpolation algorithm (SLERP) #6 dlimits are automatically ignored if vector data is input Written by Jenni Kissinger and Patrick Cruce $LastChangedBy: jwl $ $LastChangedDate: 2012-06-04 10:26:03 -0700 (Mon, 04 Jun 2012) $ $LastChangedRevision: 10493 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/themis/state/cotrans/gse2sse.pro $