PROCEDURE: mvn_swe_read_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_read_l0, filename INPUTS: filename: The full filename (including path) of a binary file containing zero or more SWEA APID's. This file can contain compressed packets. KEYWORDS: TRANGE: Only keep packets within this time range. CDRIFT: Correct for spacecraft clock drift using SPICE. Default = 0 (no). MAXBYTES: Maximum number of bytes to process. Default is entire file. BADPKT: An array of structures providing details of bad packets. APPEND: Append data to any previously loaded data. VERBOSE: If set, then print diagnostic information to stdout. $LastChangedBy: dmitchell $ $LastChangedDate: 2014-11-26 17:15:30 -0800 (Wed, 26 Nov 2014) $ $LastChangedRevision: 16319 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/maven/swea/mvn_swe_read_l0.pro $ CREATED BY: David L. Mitchell 04-25-13 FILE: mvn_swe_read_l0.pro