NAME: RBSP_UVW_TO_MGSE SYNTAX: rbsp_uvw_to_mgse,'a','rbspa_efw_esvy' rbsp_uvw_to_mgse,'a','rbspa_efw_esvy',/no_spice_load PURPOSE: Transforms from spinning UVW (RBSP SCIENCE) frame to MGSE. The MGSE coordinate system is defined: Y_MGSE=-W_SC(GSE) x Z_GSE Z_MGSE=W_SC(GSE) x Y_MGSE X_MGSE=Y_MGSE x Z_MGSE where W_SC(GSE) is the spin axis direction in GSE. This is equivalent to the GSE coordinate system if the spin axis lies along the X_GSE direction. INPUT: probe - either 'a' or 'b' tvar - TPLOT variable containing 3-component UVW data (either string or integer tplot variable id) OUTPUT: N/A Rotated timeseries is saved in a new tplot var with _mgse suffix.. KEYWORDS: suffix=suffix - suffix for rotated tplot var name (default is _mgse) /no_offset - skip offset removal in spin plane /force_offset - force offset removal for slowly sampled data /nointerp - use SPICE to calculate rotation matrix directly at each timestep instead of default quaternion interpolation rotation matrix nointerp=2 - use SPICE to calculate spin axis pointing at each timestep instead of interpolating from 5m cadence pointing (this may be useful during maneuvers) /no_spice_load - skip loading/unloading of SPICE kernels NOTE: This assumes spice kernels have been manually loaded using: rbsp_load_spice_predict ; (optional) rbsp_load_spice_kernels ; (required) /debug - prints debugging info NOTES: By default this routine uses SPICE to generate the spin axis pointing direction at a 5 minute cadence, and the despinning matrix at a 1s cadence. These quantities are interpolated (spin axis linearly, and despinning matrix via quaternion interpolation) to the sample times of the input time series. If the input time series is sampled at <= 1S/s, the routine will calculate the SPICE pointing and rotation directly at each time stamp rather than using the interpolation described above. The nointerp keyword is provided to bypass the interpolation and calculate the spin axis pointing direction and rotation matrix at the time stamps of the input time series. Calling the routine with /nointerp or nointerp=1 will cause the rotation matrix to be calculated directly. Calling with nointerp=2 will cause both the rotation matrix and the spin axis pointing direction to be calculated directly. This will be VERY time consuming for high time resolution data, but may be useful for debugging or during spacecraft maneuvers. SPIN PLANE OFFSETS: By default, offsets in the spin plane quantities are removed. This is only valid for quantities sampled faster than the spin period (~12s). The offset removal is automatically skipped for quantities sampled at or below 1S/s. This can be overridden by using the /force_offset keyword. HISTORY: 1. Created Nov 2012 - Kris Kersten, kris.kersten@gmail.com VERSION: $LastChangedBy: aaronbreneman $ $LastChangedDate: 2014-04-09 13:46:37 -0700 (Wed, 09 Apr 2014) $ $LastChangedRevision: 14782 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/general/missions/rbsp/efw/rbsp_uvw_to_mgse.pro $