PROCEDURE: thm_load_esa_pot PURPOSE: Add spacecraft potential data to the ESA structures INPUT: KEYWORDS: probe: string themis spacecraft - "a", "b", "c", "d", "e" if not set defaults to "a" sc: string themis spacecraft - "a", "b", "c", "d", "e" if not set defaults to "a" trange: (string/double) two element string specifying the requested time range themishome: string path to data dir, where data dir contains the th* dir, where *=a,b,c,d,e efi_datatype string or 0/1 if not set, uses a combination of spin averaged moment data and v1234 spin averaged data if set to 1, uses vaf v12 data if string, uses string data type - mom or v12, v34, v1234 where the latter are vaf data vaf data is averaged by "time_average" with resolution=3s before interpolation s/c potential data are interpolated to center of esa data collection datatype(deprecated): same as efi_datatype, but deprecated for clarity pot_scale: real scale factor applied to measured EFI sensor potential, default=1.15 offset: real EFI sensor to plasma potential offset, default=1.0 V min_pot: real minimum potential allowed, default=2.0 make_plot: 0/1 if set, makes tplot structure of potential min_pot_trange: str/dbl 2 element array of times to fix s/c pot at min_pot CREATED BY: J. McFadden 07-07-23 VERSION: 1 LAST MODIFICATION: 08-01-02 MOD HISTORY: 07-12-27 corrected mom packet timing and potential 08-01-02 added trange keyword 08-04-16 default datatype changed to optimize between mom-pot and vaf-v1234-pot 09-06-10 expanded mom_pot_adjust for multiple changes in scale/offset algorithm 09-06-24 force use of mom pot during sphere shadow season 09-06-25 better sphere shadow season bad point removal algorithm, removed forcing mom pot during sphere shadow season 09-09-12 change algorith to set sc_pot to min_pot for times before booms deployed 2014-01-27 changing trange to min_pot_trange, implementing trange as requested data time range TBDs 09-06-25 need to include an ~1.03 mom_pot correction factor for (v1234_avg)/(V3_snapshot) differences 09-06-25 need to identify why (v1234_avg)/V3_snapshot varies in time -- may be braid dependent or IDPU timing 09-06-25 scale factor for measure potential to Vsc seems to require 1.04 when in solar wind 10-01-12 need to change change default scale to 1.04 and offset to 0.2 when in solar wind, sheath or plasmasphere 10-01-12 may need a braid mode dependent value for scale and offsets 10-01-28 the 1.03 (v1234_avg)/(V3_snapshot) factor could be determined on the fly from nearby data NOTES: