NAME: thm_sst_atten_scale PURPOSE: This routine determines the appropriate attenuator scale factor array based on the SST angle mode and the attenuator flags Inputs: atten_flags: 4-bit flag indicating which attenuators are engaged data_dims: The return value of dimen(data.data) Keywords: scale_factors(optional): 4-element array with the scaling factors for each attenuator pinhole. Defaults to 1./64. Returns: Scaling factor array SEE ALSO: thm_sst_convert_units NOTES: atten_flags are a 4-bit value for the attenuator flags Defined as MSB,Open Equatorial Attenuator,Closed Equatorial Attenuator,Open Polar Attenuator,Closed Polar Attenuator, LSB With MSB/LSB not representing actual bits, but as labels to clarify bit order. Some examples: 0x5: both attenuators closed 0xA: both attenuators open 0x6: equatorial closed, polar open (Occurs during stuck atten error on themis D) 0xf: Error state. Invalid data. 0x9: equatorial open, polar closed (This should never actually happen) Under normal circumstances both attenuators are in the same state and the open/closed flags are mutually exclusive. $LastChangedBy: pcruce $ $LastChangedDate: 2014-01-03 12:10:47 -0800 (Fri, 03 Jan 2014) $ $LastChangedRevision: 13737 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/themis/spacecraft/particles/SST/thm_sst_atten_scale.pro $