This page was created by the IDL library routine
mk_html_help2.
Last modified: Thu Aug 6 12:53:14 2020.
FUNCTION: MMS_BURST_CDQ, TDN, WEIGHT, OFFSET, NEGATIVE=NEGATIVE
PURPOSE: Calculates CDQ from TDNs using weight and offset tables.
INPUT:
TDN - REQUIRED. Npts by Ntdq array of TDN values.
WEIGHT - REQUIRED. Weights for TDQ values. Ntdq elements.
RECOMMEND that WEIGHT totals to 1.
OFFSET - REQUIRED. Offsets for TDQ values. Ntdq elements.
CAUTION! Npts and Ntdq determined from TDN array. WEIGHT and
OFFSET must have Ntdq elements or program exits.
KEYWORDS:
NEGATIVE - OPTIONAL. If set, TDN-WEIGHT and be less than zero.
OUTPUT: A floating-point array of CDQ values, Npts elements.
INITIAL VERSION: REE 2011-02-15
LASP, University of Colorado
MODIFICATION HISTORY:
(See projects/mms/sitl/interface/mms_burst_cdq.pro)
PROCEEDURE: MMS_BURST_FOM
PURPOSE: Primarily an input/output for MMS_BURST_FOM_CALC. Selects segemnts
of burst data for downlink.
INPUT:
MDQ - REQUIRED. (FP) An array of MDQ values. Must be
continuous. Set unknown values to zero! No NaNs!
TargetBuffs - REQUIRED. (Long) The target number of 10s buffers to be
selected.
EXAMPLE: TargetBuffs = 360 (Tail) 120 (SubSolar)
KEYWORDS:
FOMAve - OPTIONAL. (FP) The current average FOM off-line.
Setting FOMAve will allow program to decide to exceed or
lower the number of selected buffers from TargetBuffs.
DEFAULT: 0
RECOMMEND: Recommend that it is set.
RANGE: >0 to 255 allowed. 0 - Closest to TargetBuffs.
TargetRatio - OPTIONAL. (FP) Only used if FOMAve is set. The ratio
that TargetBuffs can change. Allows selection as
few as TargetBuffs/TargetRatio and as many as
TargetBuffs*TargetRatio buffers.
DEFAULT: 2 (If FOMAve is set.)
RANGE: 1 to 100 allowed.
MinSegmentSize - OPTIONAL. (Long) The minimum size of a burst segment.
Number of 10s buffers.
DEFAULT: 12 (Tail)
RECOMMEND: 6 (SubSolar)
RANGE: 1 to TargetBuffs allowed.
MaxSegmentSize - OPTIONAL. (Long) The maximum size of a burst segment.
Number of 10s buffers. If not set, no maximum is used.
DEFAULT: 60 (Tail)
RECOMMEND: 30 (SubSolar)
RANGE: 0 to >TargetBuffs allowed.
NOTE: Can cause larger segments to be broken up.
CAUTION: To avoid strange behavior, set
MaxSegmentSize > 2*MinSegmentSize
Pad - OPTIONAL. (Long) Will add <Pad> buffers to begining
and end of a segment so that the surrounding data can
be kept.
DEFAULT: 1 (Tail)
RECOMMEND: 0 (SubSolar)
RANGE: 1 to TargetBuffs/2 allowed.
SearchRatio - OPTIONAL. (FP) The ratio of TargetBuffs in the initial
search. SearchBuffs = SearchRatio*TargetBuffs
DEFAULT: 1 (Or TargetRatio if set)
RANGE: 0.5 to 2.0 allowed.
RECOMMEND: No not set SearchRatio is TargetRatio is set.
NOTE: Making larger will favor large segment sizes.
FOMWindowSize - OPTIONAL. (Long) The size, in number of 10 s buffers, of
the FOM calculation window.
DEFAULT: FOMWindowSize = MinSegemntSize-2*Pad
RANGE: 1 to TargetBuffs allowed.
NOTE: Making larger will favor large segment sizes.
FOMSlope - OPTIONAL. (FP) Used in calculating FOM. 0 for averaging
over a segment, 100 to weigh peaks higher.
DEFAULT: 20
RANGE: 0-100
FOMSkew - OPTIONAL. (FP) Used in calculating FOM. 0 for averaging
over a segment, 1 to weigh peaks higher.
DEFAULT: 0 (Tail; See note)
RECOMMEND: 0.5 (SubSolar)
RANGE: 0-1
NOTE: Set skew to low emphasize FOMBias
FOMBias - OPTIONAL. (FP) Used in calculating FOM. 0 for favoring
small segment, 1 for favoring large segemnts,
DEFAULT: 1 (Tail; See note)
RECOMMEND: 0.5 (SubSolar)
RANGE: 0-1
NOTE: FOMBias sets skew depending on segemnt size.
OUTPUT: A structure, FOM_STR which contains all input and results.
INITIAL VERSION: REE 2010-10-26
MODIFICATION HISTORY:
LASP, University of Colorado
(See projects/mms/sitl/interface/mms_burst_fom.pro)
FUNCTION: MMS_BURST_FOM_WINDOW, WSIZE, SLOPE, SKEW, BIAS
PURPOSE: Creates a window for sort_convol.
INPUT:
WSize - REQUIRED. The size (in number of 10s buffers) of the
window.
DEFAULT: SearchWindowSize = MinSegemntSize
Slope - REQUIRED. A value between 0 and infinity.
0 gives flat window (for averaging).;
100 gives a step function.
Skew - REQUIRED. A value between 0 and 1.
0 gives flat window (for averaging).
1 favors finding spikes.
Bias - REQUIRED. Skew bias. A value between 0 and 1.
0 favors short segments.
1 favors long segments.
NOTE: Set SLOPE and POSITION higher to
favor a spike. Set lower to favor a straight average.
CAUTION! NO INPUT CHECKING WITHIN FUNCTION! All inputs must
be valid.
KEYWORDS:
;
OUTPUT: A flaoting-point array of WSIZE values.
INITIAL VERSION: REE 2010-11-02
LASP, University of Colorado
MODIFICATION HISTORY:
(See projects/mms/sitl/interface/mms_burst_fom_window.pro)
FUNCTION: MMS_BURST_MDQ, CDQ1, CDQ2, CDQ3, CDQ4, Window=Window
PURPOSE: Calculates MDQ from CDQ inputs using a sort and convolve.
INPUT:
CDQ1,2,3,4 - REQUIRED. Arrays of CDQ values.
Window - OPTIONAL. Window for sort/convolve. Must be 4 elements.
DEFAULT = [0.1,0.2,0.3,0.4]
CAUTION! NO INPUT CHECKING WITHIN FUNCTION! CDQ's must have the
same number of elements and values between 0 and 255.
KEYWORDS:
OUTPUT: A floating-point array of MDQ values.
INITIAL VERSION: REE 2010-11-02
LASP, University of Colorado
MODIFICATION HISTORY:
(See projects/mms/sitl/interface/mms_burst_mdq.pro)
PROCEEDURE: MMS_BURST_SEGMENT, MINSEGMENTSIZE, MAXSEGMENTSIZE,
START=START, STOP=STOP
PURPOSE: A UTILITY to enforce a minimum/maxim segemnt size. No input/error
checking is in the routine. MAKE SURE INPUTS ARE VALID!
INPUT:
MinSegmentSize - REQUIRED. (Long) The minimum size of a burst segment.
Number of 10s buffers.
NOTE: Input MinSegmentSize-2*Pad if Pad is set.
MaxSegmentSize - REQUIRED. (Long) The maximum size of a burst segment.
Number of 10s buffers. If not set, no maximum is used.
NOTE: Can cause larger segments to be broken up.
CAUTION: To avoid strange behavior, set
MaxSegmentSize > 2*MinSegmentSize
KEYWORDS:
Start - REQUIRED. (FP) The starting index of a burst segment.
Stop - REQUIRED. (FP) The ending index of a burst segment.
OUTPUT: Start and Stop are altered.
INITIAL VERSION: REE 2010-10-26
MODIFICATION HISTORY:
LASP, University of Colorado
(See projects/mms/sitl/interface/mms_burst_segment.pro)
FUNCTION: MMS_BURST_SORT_CONVOL, DATA, WINDOW, CAP
PURPOSE: CONVOLVES A WINDOW WITH THE DATA LOCALLY IN SORT ORDER.
INPUT:
DATA - REQUIRED. CAUTION: NO NANS!
WINDOW - REQUIRED.
CAP - OPTIONAL. WILL HELP CENTER SPIKES.
CAUTION! NO INPUT CHECKING WITHIN FUNCTION! All inputs must
be valid.
KEYWORDS:
OUTPUT: A flaoting-point array the same size as data.
INITIAL VERSION: REE 2010-11-02
LASP, University of Colorado
MODIFICATION HISTORY:
(See projects/mms/sitl/interface/mms_burst_sort_convol.pro)