PROCEDURE: MVN_SWE_ETSPEC PURPOSE: Makes tplot variables with respect to the MAVEN SWEA Energy-time spectrogram(s). CALLING SEQUENCE: mvn_swe_etspec, ['2014-11-17/08:04:19', '2014-11-17/12:40:31'], $ /silent, units='eflux', data_type='3d', $ angle='pa', /default INPUTS: none - 3D, PAD, or SPEC data are obtained from SWEA common block. If you set the time interval, then a tplot variable is created between you specified time intervals. (Noted that it might take more than 10 minutes to resample pitch angle distributions if you use PAD data for 1 day, depending on your machine spec and data amount.) KEYWORDS: TRANGE: Instead of an input variable, you can alternatively specify the time interval when you want to create a tplot variable. DATE_TYPE: Chooses the data product type ('3d', 'pad', or 'spec') Default is 'spec'. ERANGE: Specifies energy range over which you want to plot . Default is the whole enegy range. UNITS: Sets the unit to prefer to use. Default = 'crate'. ANGLE: Selects the angular spectrum. Now 'pa' is only available. 'pa' means it can plot the pitch-angle-sorted, energy-time spectrogram. In near future, 'phi'(= azimuth anode), 'theta'(= deflection angle) will be available. PHI: Limits the azimuth anode (or looking direction) as 2-elements array [min, max], in degrees. THETA: Limits the deflection angle (or lookgin direction) as 2-elements array [min, max], in degrees. PITCH: Limits the pitch angle as 2-elements array [min, max], in dgrees. If it is used, 'mvn_swe_pad_resample' is automatically executed. SUFFIX: Sets a tplot suffix to apply when generating outputs. MASK: Masks the expected angular bins whose field of view is blocked by the spacecraft body and solar paddles. Automatically identifying the mission phases (cruise or science mapping). STOW: (Obsolete). Mask the angular bins whose field of view is blocked before the boom deploy. ARCHIVE: Uses the archive data, instead of the survey data. WINDOW: Set the window number to show the snapshot. Default = 0. ABINS: Specify which anode bins to include in the analysis: 0 = no, 1 = yes. Default = replicate(1,16) DBINS: Specify which deflection bins to include in the analysis: 0 = no, 1 = yes. Default = replicate(1,6) MBINS: Specify which angular (both anode and deflection) bins to include in the analysis: 0 = no, 1 = yes. Default = replicate(1, 96) SC_POT: Account for the spacecraft potential correction. (Not completely activated yet) SILENT: Minimizes to show the processing information in the terminal. "VERBOSE" keyword can be also used this purpose. Default: If you use this keyword, the following tplot variables are automatically created: If you also use the keyword as angle='pa', - quasi-parallel (0-30 deg), - quasi-perpendicular (75-105 deg), - quasi-antiparallel (150-180 deg), Above 3 directional pitch-angle-sorted energy-time spectrograms are created. If you do NOT use 'angle' keyword, - sunward (+ MSO_X) - anti-sunward (- MSO_X) - duskward (+ MSO_Y) - dawnward (- MSO_Y) - northward (+ MSO_Z) - southward (- MSO_Z) Above 6 directional enegry-time spectrograms are created if SPICE/Kernels are available. FRAME: Sets the coordinate system to define the direction. In the present version, the coordinate system(s) derived from the SPICE/Kernels are available, e.g., 'MAVEN_MSO', 'IAU_MARS', 'MAVEN_SWEA' or so on. CREATED BY: Takuya Hara on 2014-11-22. $LastChangedBy: hara $ $LastChangedDate: 2014-11-24 14:24:20 -0800 (Mon, 24 Nov 2014) $ $LastChangedRevision: 16293 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/maven/swea/mvn_swe_etspec.pro $ MODIFICATION LOG: (YYYY-MM-DD) 2014-11-22: Starts to prepare this routine.