PROCEDURE: mvn_swe_load_l0 PURPOSE: Reads in MAVEN Level 0 telemetry files (PFDPU packets wrapped in spacecraft packets). SWEA packets are identified, decompressed if necessary, and decomuted. SWEA housekeeping and data are stored in a common block (mvn_swe_com). The packets can be any combination of: Housekeeping: normal rate (APID 28) fast rate (APID A6) 3D Distributions: survey mode (APID A0) archive mode (APID A1) PAD Distributions: survey mode (APID A2) archive mode (APID A3) ENGY Spectra: survey mode (APID A4) archive mode (APID A5) Sampling and averaging of 3D, PAD, and ENGY data are controlled by group and cycle parameters. The group parameter (G = 0,1,2) sets the summing of adjacent energy bins. The cycle parameter (N = 0,1,2,3,4,5) sets sampling of 2-second measurement cycles. Data products are sampled every 2^N cycles. 3D distributions are stored in 1, 2 or 4 packets, depending on the group parameter. Multiple packets must be stitched together (see swe_plot_dpu). PAD packets have one of 3 possible lengths, depending on the group parameter. The PAD data array is sized to accomodate the largest packet (G = 0). When energies are summed, only 1/2 or 1/4 of this data array is used. ENGY spectra always have 64 energy channels (G = 0). USAGE: mvn_swe_load_l0, trange INPUTS: trange: Load SWEA packets from L0 data spanning this time range. (Reads multiple L0 files, if necessary. Use MAXBYTES to protect against brobdingnagian loads.) KEYWORDS: FILENAME: Full path and file name for loading data. Can be multiple files. LATEST: Ignore trange (if present), and load all data within the LATEST days leading up to the current date. CDRIFT: Correct for spacecraft clock drift using SPICE. Default = 1 (yes). MAXBYTES: Maximum number of bytes to process. Default is all data within specified time range. BADPKT: An array of structures providing details of bad packets. STATUS: Report statistics of data actually loaded. SUMPLOT: Create a summary plot of the loaded data. $LastChangedBy: dmitchell $ $LastChangedDate: 2014-11-26 17:15:46 -0800 (Wed, 26 Nov 2014) $ $LastChangedRevision: 16320 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/maven/swea/mvn_swe_load_l0.pro $ CREATED BY: David L. Mitchell 04-25-13 FILE: mvn_swe_load_l0.pro