This page was created by the IDL library routine
mk_html_help2.
Last modified: Thu Oct 7 03:01:25 1999.
FUNCTION: CALC_ESA_GEOM DESCRIPTION: function to get esa geometry factors CALLING SEQUENCE: data = calc_esa_geom(esa_data_struct) ARGUMENTS: esa_data_struct This is a struct return by a get_?esa_* () routine. This must contain the header_bytes and time structure tag. RETURN VALUE: Upon success, an array of floats containing the geometry factor for each energy bin. else a scaler -1 is returned. REVISION HISTORY: @(#)calc_fa_esa_geom.pro 1.2 03/03/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '96
(See fastDataToIdl/esaUtil/calc_fa_esa_geom.pro)
This code contains the default limits for DC fields summary plots. There are separate limits for electric field, magnetic field, probe current, spin angle, and spacecraft potential. Within those categories, the limits are all the same. There are several choices for each limit, the data determine which choice is used. At least MIN_ON_SCALE of the points must be on scale, otherwise the next larger choice is tried.
(See fastDataToIdl/batch/default_dc_limits.pro)
FUNCTION: EIESA_UNPACK_SURV_HDR DESCRIPTION: function to unpack the Eesa and Iesa packet headers A structure of the following format is returned: DATA_NAME STRING 'E[I]esa Survey Header' VALID INT 1 PROJECT_NAME STRING 'FAST' UNITS_NAME STRING 'Raw' TIME DOUBLE 8.0118726e+08 SPIN_NUMBER INT 0 SPIN_PHASE INT 0 MAG_PHASE INT 0 SWEEP_MODE INT 0 RETRACE INT 0 TOP_ENERGY INT 0 DIRECTION INT 0 AMPLITUDE INT 0 CALIBRATE_MODE INT 0 LOW_ENERGY INT 0 DWELL INT 0 ACCUM INT 0 MODE INT 0 NENERGY_MODE INT 0 DESPUN INT 0 SWEEPS_PER_AVERAGE INT 0 BLOCKS_PER_PACKET INT 0 NENERGY INT 0 NANGLE INT 0 NBINS INT 0 TYPE INT 0 SC INT 0 MARRAY_HDR_IDX INT 0 MARRAY_HDR_SUBCNT INT 0 BLKS_FROM_OLD_SWP INT 0 BLKS_REM_IN_PNDING_SWP INT 0 NON_TTAGED_DATA_IDX INT 0 DATA_INDICES INTARR(32) SECS_PER_BLOCK DOUBLE 0 SPIN_RATE DOUBLE 0 CALLING SEQUENCE: data = eiesa_unpack_surv_hdr (eiesa_surv_data_struct) ARGUMENTS: eiesa_surv_data_struct This is a struct return by get_eesa_surv () for Eesa data, or get_iesa_surv () for Iesa data. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)eiesa_unpack_surv_hdr.pro 1.3 03/03/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/esaUtil/eiesa_unpack_surv_hdr.pro)
PROCEDURE: esa_anode_calib,orbit
reads in data from individual angle bins from esa burst data,
asks user to click on boundaries of loss cone, and averages
remaining points
INPUT:
orbit the orbit number (used in the filename) which you are calibrating
OUTPUT:
prints calibration values (nomalized to 1.0) for 32 angle bins
KEYWORDS:
ENERGY passed onto get_2dt. If not set, default is [1000,20000]
DIR set this keyword to the directory in which tplot files
are stored. Default is current directory.
DATASRC set this keyword to the string passed by get_2dt (i.e. 'fa_eeb',
'fa_ieb', 'fa_seb1','fa_seb2', etc) If this keyword is
not set it defaults to 'fa_eeb'
SHOW4 set this keyword to show plots of 4 bins and the losscones
SHOW8 set this keyword to show plots of 8 bins and the losscones
SHOWALL set this keyword to show plots of all bins and the losscones
SDT set this keyword to get esa data directly from SDT
(default is to read in tplot files) Note that SDT needs to
be running anyways, because of the fa_fields_phase
Need to have phase (1032) in SDT. If SDT keyword set, need also to
have EesaBurstAggregate in SDT.
Written 97-4-15 by Y-K Tung
Modified 98-2-11 by Y-K Tung added keyword DIR
Modified 98-2-20 by Y-K Tung added keyword ENERGY
(See fastDataToIdl/esaUtil/esa_anode_calib.pro)
PROCEDURE: FAST_BATCH DESCRIPTION: This is the fast idl batch processing file. It is used to produce plots for day to day production runs. It is meant to called from sdt. It runs as the main procedure calling the routines which produce plots for the various instruments. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_batch REVISION HISTORY: @(#)fast_batch.pro 1.6 11/11/96 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. July '96
(See fastDataToIdl/batch/fast_batch.pro)
PROCEDURE: fast_ef_summary.pro INPUT: none PURPOSE: Generates ps, gif, cdf summary plots of FAST electron data. Plot 1: Electron Differential Energy Flux vs Energy, 0-30 deg pitch angle Plot 2: Electron Differential Energy Flux vs Energy, 60-120 deg pitch angle Plot 3: Electron Differential Energy Flux vs Energy, 150-180 deg pitch angle Plot 4: Electron Differential Energy Flux vs Pitch Angle, .1-1 keV Plot 5: Electron Differential Energy Flux vs Pitch Angle, 1-30 keV Plot 6: Electron Energy Flux - mapped to 100 km, positive earthward Plot 7: Electron Flux - mapped to 100 km, positive earthward KEYWORDS BW Set bw=1 to get black/white postscript k0 keyword passed to gen_fa_k0_ees_gifps.pro CREATED BY: J.McFadden 96/11/7 VERSION: 1 LAST MODIFICATION: 97/03/04 MOD HISTORY: 96/11/7 made from fast_e_summary.pro uses "make_array_struc.pro" to speed it up 97/03/04 Je,JEe mapped to 100 km, positive for earthward
(See fastDataToIdl/batch/fast_ef_summary.pro)
PROCEDURE: fast_elec_summary.pro PURPOSE: Generates a summary plot of FAST electron data for tplot. Plot 1: Electron Differential Energy Flux vs Energy, 0-45 deg pitch angle Plot 2: Electron Differential Energy Flux vs Energy, 45-135 deg pitch angle Plot 3: Electron Differential Energy Flux vs Energy, 135-180 deg pitch angle Plot 4: Electron Differential Energy Flux vs Pitch Angle, < 1 keV Plot 5: Electron Differential Energy Flux vs Pitch Angle, > 1 keV Plot 6: Electron Energy Flux Plot 7: Electron Flux CREATED BY: J.McFadden VERSION: 1 LAST MODIFICATION: 96/06/20 MOD HISTORY:
(See fastDataToIdl/batch/fast_elec_summary.pro)
PROCEDURE: FAST_I_BATCH DESCRIPTION: This is the fast idl batch processing file for ion and electron summary plots. It is meant to be called from sdt. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_i_batch REVISION HISTORY: @(#)fast_batch.pro 1.3 24 Jul 1996 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. July '96
(See fastDataToIdl/batch/fast_esa_batch.pro)
PROCEDURE: FAST_BATCH DESCRIPTION: This is the fast idl batch processing file for electron summary plots. It is meant to called from sdt. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_e_batch REVISION HISTORY: @(#)fast_e_batch.pro 1.2 08/15/96 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '96
(See fastDataToIdl/batch/fast_esolo_batch.pro)
PROCEDURE: FAST_BATCH DESCRIPTION: This is the fast idl batch processing file for electron summary plots. It is meant to called from sdt. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_e_batch REVISION HISTORY: @(#)fast_e_batch.pro 1.2 08/15/96 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '96
(See fastDataToIdl/batch/fast_e_batch.pro)
PROCEDURE: fast_e_summary.pro INPUT: none PURPOSE: Generates ps, gif, cdf summary plots of FAST electron data. Plot 1: Electron Differential Energy Flux vs Energy, 0-30 deg pitch angle Plot 2: Electron Differential Energy Flux vs Energy, 60-120 deg pitch angle Plot 3: Electron Differential Energy Flux vs Energy, 150-180 deg pitch angle Plot 4: Electron Differential Energy Flux vs Pitch Angle, .1-1 keV Plot 5: Electron Differential Energy Flux vs Pitch Angle, 1-30 keV Plot 6: Electron Energy Flux - mapped to 100 km, positive earthward Plot 7: Electron Flux - mapped to 100 km, positive earthward KEYWORDS BW Set bw=1 to get black/white postscript k0 keyword passed to gen_fa_k0_ees_gifps.pro CREATED BY: J.McFadden 96-6-20 VERSION: 1 LAST MODIFICATION: 97/03/04 MOD HISTORY: 96-8-6 get_fa_orbit, gopen added 96-8-9 return when no data, changed to a procedure 96/10/08 bw,k0 keywords added 97/03/04 Je,JEe mapped to 100 km, positive for earthward
(See fastDataToIdl/batch/fast_e_summary.pro)
PROCEDURE: FAST_FIELDS_BATCH DESCRIPTION: This is the fast idl batch processing file, for fields summary plots. It is used to produce plots for day to day production runs. It is meant to called from sdt. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_fields_batch REVISION HISTORY: @(#)fast_fields_batch.pro 1.3 24 Jul 1996 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '96
(See fastDataToIdl/batch/fast_fields_batch.pro)
PROCEDURE: FAST_IE_BATCH DESCRIPTION: This is the fast idl batch processing file for electron summary plots. It is meant to called from sdt. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_ie_batch REVISION HISTORY: @(#)fast_ie_batch.pro 1.2 08/15/96 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '96
(See fastDataToIdl/batch/fast_ie_batch.pro)
PROCEDURE: fast_if_summary.pro INPUT: none PURPOSE: Generates ps, gif, cdf summary plots of FAST ion data. Plot 1: Ion Differential Energy Flux vs Energy, 0-30 deg pitch angle Plot 2: Ion Differential Energy Flux vs Energy, 40-140 deg pitch angle Plot 3: Ion Differential Energy Flux vs Energy, 150-180 deg pitch angle Plot 4: Ion Differential Energy Flux vs Pitch Angle, .05-1. keV Plot 5: Ion Differential Energy Flux vs Pitch Angle, 1.-25. keV Plot 6: Ion Energy Flux - mapped to 100 km, positive earthward Plot 7: Ion Flux - mapped to 100 km, positive earthward KEYWORDS BW Set bw=1 to get black/white postscript k0 keyword passed to gen_fa_k0_ies_gifps.pro CREATED BY: J.McFadden 96/11/7 VERSION: 1 LAST MODIFICATION: 97/03/04 MOD HISTORY: 96/11/7 made from fast_i_summary.pro uses "make_array_struc.pro" to speed it up 97/03/04 Ji,JEi mapped to 100 km, positive for earthward
(See fastDataToIdl/batch/fast_if_summary.pro)
PROCEDURE: FAST_I_BATCH DESCRIPTION: This is the fast idl batch processing file for ion summary plots. It is meant to be called from sdt. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_i_batch REVISION HISTORY: @(#)fast_batch.pro 1.3 24 Jul 1996 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. July '96
(See fastDataToIdl/batch/fast_i_batch.pro)
PROCEDURE: fast_i_summary.pro INPUT: none PURPOSE: Generates ps, gif, cdf summary plots of FAST ion data. Plot 1: Ion Differential Energy Flux vs Energy, 0-30 deg pitch angle Plot 2: Ion Differential Energy Flux vs Energy, 40-140 deg pitch angle Plot 3: Ion Differential Energy Flux vs Energy, 150-180 deg pitch angle Plot 4: Ion Differential Energy Flux vs Pitch Angle, .05-1. keV Plot 5: Ion Differential Energy Flux vs Pitch Angle, 1.-25. keV Plot 6: Ion Energy Flux - mapped to 100 km, positive earthward Plot 7: Ion Flux - mapped to 100 km, positive earthward KEYWORDS BW Set bw=1 to get black/white postscript k0 keyword passed to gen_fa_k0_ies_gifps.pro CREATED BY: J.McFadden 96-8-9 VERSION: 1 LAST MODIFICATION: 97/03/04 MOD HISTORY: 96/8/9 made from fast_e_summary.pro 96/10/08 bw,k0 keywords added 97/03/04 Ji,JEi mapped to 100 km, positive for earthward
(See fastDataToIdl/batch/fast_i_summary.pro)
PROCEDURE: FAST_BATCH DESCRIPTION: This is the fast idl batch processing file for electron summary plots. It is meant to called from sdt. Sdt would wait till this batch script is complete and then exit. CALLING SEQUENCE: idl fast_e_batch REVISION HISTORY: @(#)fast_e_batch.pro 1.2 08/15/96 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '96
(See fastDataToIdl/batch/fast_t_batch.pro)
PROCEDURE: fast_t_summary.pro INPUT: none PURPOSE: Generates ps, gif, cdf summary plots of FAST teams data. Plot 1: Hydrogen Differential Energy Flux vs Energy, 0-360 deg pitch angle Plot 2: Oxygen Differential Energy Flux vs Energy, 0-360 deg pitch angle Plot 3: Hydrogen Differential Energy Flux vs Pitch Angle, < 1 keV Plot 4: Hydrogen Differential Energy Flux vs Pitch Angle, > 1 keV Plot 5: Oxygen Differential Energy Flux vs Pitch Angle, < 1 keV Plot 6: Oxygen Differential Energy Flux vs Pitch Angle, > 1 keV Plot 7: MassSpectrum Counts Rate vs Mass, 1eV - 12keV, 4*Pi angles KEYWORDS BW Set bw=1 to get black/white postscript k0 keyword passed to gen_fa_k0_tms_gifps.pro CREATED BY: J.McFadden 96-8-15 VERSION: 2.01 LAST MODIFICATION: 97-06-09 MOD HISTORY: E.Lund 97-06-09 fixed crash on data end mismatch E.Lund 97-06-04 added He+ to cdf's J.Loran 97-03-01 re-removed asum, esum keywords that got put back in accidentally L.Tang 96-11-19 removed asum, esum keywords in routine get_tms_hm_spec J.McFadden 96-08-30 added BW keyword, error print statements
(See fastDataToIdl/batch/fast_t_summary.pro)
FUNCTION: FA_FIELDS_PHASE, spin_phase, freq=freq
PURPOSE: Returns structure with smoothed B_phase as COMP1 and
Sun_phase as COMP2 in radians.
INPUT:
spin_phase - NOT NEEDED. PROGRAM WILL GET IF NOT SUPPLIED.
Fast DQD = 'SMPhase_FieldsSurvey0' stucture.
KEYWORDS:
FREQ - Smoothing frequency. Default = 0.01. Set to 0 for no
smooth.
PRECISE - if set, uses housekeeping data (dqd is
'AttitudeCtrl') to produce jitter-free sun phase, and then mag
phase from GET_FA_ORBIT B_model calculation.
SPIN_AXIS - a named variable in which an estimate of the spin
axis will be returned. Meaningless if /PRECISE is not set.
USE: phase = fa_fields_phase()
RETURN: Fields structure with smoothed B_phase and Sun_phase in radians.
CREATED BY: REE, 97-03-03
FILE: fa_fields_phase.pro
VERSION: @(#)fa_fields_phase.pro 1.35 09/30/98 UCB SSL
LAST MODIFICATION:
(See fastDataToIdl/fa_fields_phase.pro)
NAME: FA_FIELDS_UNITS
PURPOSE: To perform units conversions for the FAST fields
instruments. Calls Bob Ergun's fastcal library.
CALLING SEQUENCE: fa_fields_units,data,VERBOSE=VERBOSE, $
DATA_HEADER=DATA_HEADER
The times series values
contained in the DATA structure will have
their units converted. Time series must be
designated by structure tags "COMP*", where
"*" is 1, 2, 3, etc. The string new_units
contains the name of whatever units the data
are returned in, i.e. it might be the same
as the old units!
INPUTS: A structure called DATA is passed in. It must contain :
- a tag called 'DATA_NAME', which must contain a valid
SDT DQD.
- a tag beginning with 'COMP', like 'COMP1', which
contains time series data.
- a tag called 'UNITS_NAME' which contains the units
currently in use for DATA.COMP*
- a tag called CALIBRATED, which indicates whether or
not there's any calibrating to do!
KEYWORD PARAMETERS: VERBOSE - if set, tells the user what's been
converted
DATA_HEADER - Generally, its a good idea to
fill in the data_header. If it is not
filled in, defaults will be used which
could result in improper calibrations.
DATA_HEADER should be 10 or 14 bytes.
OUTPUTS: The with structure DATA, perhaps with some rescaled parts.
SIDE EFFECTS: Those parts of DATA which contain time series data
will be rescaled according to the calibration information encoded in
the fastcal library.
RESTRICTIONS: Structure tags "comp*", "start_time", "data_name", and
"units_name", and "valid" are required. For 2d structures, DSP and SFA,
structure tags 'yaxis' and 'yaxis_units' are required.
MODIFICATION HISTORY: Originally written 5-July-1996 by Bill Peria,
Space Scienes Lab, UCBerkeley
96-10-26 REE Major rewrite. No new_units and scale.
96-11-05 REE Modifed to accomodate DSP, SFA, and time series.
Still needs FPA (Frequency/Phase/Amplitude) structures.
Still needs MAG, WPC, and HFQ structures.
(See fastDataToIdl/fa_fields_units.pro)
FUNCTION: FA_NADIR_FROM_HORIZ
PURPOSE:
Calculate the earth nadir from horizon crossing times for FAST.
CALLING SEQUENCE:
nadir = fa_nadir_from_horiz (horizCross, orbData)
INPUTS:
horizCross: And array of the structure:
{setime: double, estime: double}, where setime
and estime are seconds since 1970. These are
the horizon crossing times.
orbData: The orbit data from get_fa_orbit that covers
the times given in horizCross.
KEYWORD PARAMETERS:
OUTPUTS:
nadir: The array of earth nadir times derived.
MODIFICATION HISTORY:
@(#)fa_nadir_from_horiz.pro 1.1 02/12/98
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. Oct '97
(See fastDataToIdl/sunnadir/fa_nadir_from_horiz.pro)
FUNCTION: fa_nadir_sun_azim PURPOSE: For FAST, Get azimuthal angles in the spin plane between the earth nadir and sun direction. CALLING SEQUENCE: azimAngles = fa_nadir_sun_azim (nadir, orbData) INPUTS: nadir: An array of times where the nadir of the earth intersects the spin plane of the satellite. orbData: The orbit data from get_fa_orbit that covers the times given in nadir. KEYWORD PARAMETERS: OUTPUTS: azimAngles: This is the returned array of aximuthal angles in the satellite spin plane between the earth nadir and the satellite sun direction. Upon error, -1 is returned. NOTES: This routine calls get_fa_fdf_att to get the spin vector for the times given in the nadir input array. This is done for the start and end of this time span. If these two vectors change, then get_fa_fdf_att is called for each point in the nadir array, else the spin vector is considered constant throughout. MODIFICATION HISTORY: @(#)fa_nadir_sun_azim.pro 1.1 02/12/98 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Oct '97
(See fastDataToIdl/sunnadir/fa_nadir_sun_azim.pro)
FUNCTION: fa_sun_pulse_from_azim PURPOSE: For the FAST satellite, calculates the time of a sun pulse would occur based upon the earth nadir time, spin period, azimuthal angle between sun direction and nadir direction in the spin plain. CALLING SEQUENCE: simSunpulseArr = $ fa_sun_pulse_from_azim(azim, nadir, period) INPUTS: azim: Array of azimuthal angles between the sun direction and the earth nadir in the spin plane nadir: An array times when the earth nadir is crossed by the sun sensor. period: Period of one spin of the spacecraft in seconds. KEYWORD PARAMETERS: OUTPUTS: simSunpulseArr: This is the returned array of simulated sun pulse times, one array element for each input time given in the nadir parameter. MODIFICATION HISTORY: @(#)fa_sun_pulse_from_azim.pro 1.1 02/12/98 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Nov '97
(See fastDataToIdl/sunnadir/fa_sun_pulse_from_azim.pro)
FUNCTION:
FILL_FA_ESA_FROM_TS_GET
DESCRIPTION:
Function to take a structure from get_md_ts_from_sdt that
contains Fast esa data, and return a array of structures in the
standard ssl idl esa format.
An array of npts structures of the following format are returned:
DATA_NAME STRING 'data-name' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000147 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG index ; Data index, this pt.
ST_INDEX LONG st_idx ; start index of arr
EN_INDEX LONG en_idx ; end index of arr
NPTS LONG npts ; array size
CALLING SEQUENCE:
data = fill_fa_esa_from_ts_get (dat, units, header_bytes,
got_header_bytes, CALIBRATE=calib)
ARGUMENTS:
dat The data structure returned from
get_md_ts_from_sdt for esa data
units The units of the data
header_bytes The header bytes from the header
packets for the data in dat
KEYWORDS:
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)fill_fa_esa_from_ts_get.pro 1.4 02/10/98
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/fill_fa_esa_from_ts_get.pro)
FUNCTION: geomag(time [, time2])
NAME:
geomag
PURPOSE:
Gets geomag data kp, ap, and dsp for given times.
INPUT: input(s) can be scalers or arrays of any dimension of type:
double(s) seconds since 1970
string(s) format: YYYY-MM-DD/hh:mm:ss
structure(s) format: given in "time_struct"
values outside normal range will be corrected.
If optional parameter time2 is passed, geomag data returned are
averaged over the time interval from time to time2.
OUTPUT:
structure: {geomag, kp:0.d, ap:0.d, dst:0.d}
NOTE:
This routine works on vectors.
Output will have the same dimensions as the input.
CREATED BY: Ken Bromund Dec 1997
FILE: geomag.pro
VERSION: 1.5
LAST MODIFICATION: 98/01/06
(See fastDataToIdl/database/geomag.pro)
PROCEDURE: get_array_struct(time,START=start,EN=en,ADVANCE=advance,RETREAT=retreat) PURPOSE: Gets a structure from the common array_struc_com, see make_array_struc.pro INPUT: time: real Currently time is ignored. Later versions may: This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'MM-DD-YY/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data time found in seconds since 1970. ;KEYWORDS: START: If non-zero, get first data from array_struc EN: If non-zero, get last data from array_struc ADVANCE: If non-zero, advance to the next data point RETREAT: If non-zero, retreat to the previous data point CREATED BY: J.McFadden VERSION: 1 LAST MODIFICATION: 96-11-7 McFadden MOD HISTORY: NOTES: make_array_struc.pro makes an array of structures that is called by get_array_struc.pro Current version only works for FAST Written to speed up summary plot production for ees and ies Current version ignores time input, requires keyword to work properly
(See fastDataToIdl/batch/get_array_struc.pro)
NAME: GET_DENSITY
PURPOSE: To bring the appropriate density data into IDL from SDT
CALLING SEQUENCE: density = get_density(time1,time2)
INPUTS: See documentation for GET_FA_FIELDS
OUTPUTS: Either a structure or a TPLOT string handle, containing the
density data.
KEYWORDS: Same as GET_FA_FIELDS.
MODIFICATION HISTORY: Written January 1997 by Bill Peria UCB/SSL
- added SVD based de-spiker, used when /SPIN is
set, provides spin period resolution
data. 25-Mar-97 BP
(See fastDataToIdl/get_density.pro)
Please look at documentation for get_fa_fields...you shouldn't call GET_FA_2D_FIELDS directly...
(See fastDataToIdl/get_fa_2d_fields.pro)
PROCEDURE: get_fa_attitude
PURPOSE: get the FAST attitude information for a given set of times
POSITIONAL PARAMETERS:
arg1:
if keyword parameter 'time_array' is set, then this parameter is the
array of times for which the attitude is to be returned, else it is the
start time of the timespan over which the attitude is to be returned.
arg2:
if keyword parameter 'time_array' is set, then this parameter is not used,
else it is the end time of the timespan over which the attitude is to be returned.
KEYWORD PARAMETERS:
delta_t:
spacing in seconds of the set of times from start time to end time, over which
the attitude info is returned (default = 20 seconds).
This parameter is ignored if the keyword parameter 'time_array' is set.
attlevel:
flag to specify what level of attitude info is desired:
-1 : return the best attitude info available (the default)
0 : return initial level attitude data only. this level has not
been verified in any way
1 : return level one attitude data only. this level has had a first
attempt at correcting errors, mostly smoothed to remove jitter.
2 : return definitive attitude only. this level has been compared
with B-field model data, and sun pulse spin frequency corrected.
if attlevel is set to either 0, 1, or 2, and the requested level of attitude
data is not found, get_fa_attitude will mark that data point as invalid and
will return no data for that time point.
coord:
a string specifying the coordinate system desired for the output rotation matrix.
see the OUTPUTS section below.
possible values for coord are (case doesn't matter, 'gse' = 'gSe' = 'GSE'):
'FASTSPIN' : Spinning Spacecraft
'DESPUN' : Despun
'GEI' : Geocentric Equatorial Inertial
'GEO' : Geographic
'GSE' : Geocentric Solar Ecliptic
'GSM' : Geocentric Solar Magnetospheric
'MAG' : Geomagnetic
'GECI' : Ecliptic Inertial
'GSEQ' : Geocentric Solar Equatorial
'SM' : Solar Magnetic
status:
status of get_fa_attitude on return (0 means successful return, nonzero means
some error has occurred).
In general, the user should call get_fa_attitude with this status keyword set,
and should explicitly test that status equal 0 for success.
OUTPUTS:
performs a 'store_data' operation on the following variables:
fa_spin_ra:
right ascension of the spin axis, in GEI coords, in degrees
fa_spin_dec:
declination of the spin axis, in GEI coords, in degrees
fa_spin_freq:
spin rate in degrees/second
fa_spin_phase:
spin phase about the spin axis, in degrees. zero phase means
spacecraft x axis is in the sun.
fa_attlevel:
the attitude level of the data found.
fa_rotmat_xxx:
the rotation matrix from the FASTSPIN coordinate system to the coord
system that was selected by the input keyword parameter 'coord',
and where 'xxx' is the coord system specified by the keyword param 'coord'.
ERRORS:
If attlevel 0, 1, or 2 has been selected and if this level of attitude data is not
found, or if any other error occurs, the given time point will be marked as invalid,
returned attitude data will have value NaN.
CREATED BY: Vince Saba, Oct, 1996.
VERSION: @(#)get_fa_attitude.pro 1.5 06/05/97
(See fastDataToIdl/attitude/get_fa_attitude.pro)
NAME: get_fa_bdc
DESCRIPTION: returns a structure containing DC
magnetic field survey data from the FAST magnetometer (UCLA). It
must be the case that SDT is running, with Mag1dc, Mag2dc_S, and Mag3dc_S
plotted on screen already.
The returned structure looks like this:
DATA_NAME STRING ' ' ; which mag quantities
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'nT' ; Units of this data
UNITS_PROCEDURE STRING 'fa_fields_units' ; Units conversion proc
START_TIME DOUBLE ; Start Time of sample
END_TIME DOUBLE ; End time of sample
NPTS INT ; Number of time samples
NCOMP INT ; Number of components
TIME DOUBLE Array(npts) ; timetags
COMP1 DOUBLE Array(npts) ;
COMP2 DOUBLE Array(npts) ;
COMP3 DOUBLE Array(npts) ;
|ALL |NPTS |START| EN |PANF |PANB |selection |use time1|use time2|
|----|-----|-----|-----|-----|-----|---------------------------|---------|---------|
| NZ | 0 | 0 | 0 | 0 | 0 | start -> end | X | X |
| 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X |
| 0 | 0 | NZ | 0 | 0 | 0 | start -> time1 secs | X | |
| 0 | 0 | 0 | NZ | 0 | 0 | end-time1 secs -> end | X | |
| 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from time1->time2 | X | X |
| 0 | 0 | 0 | 0 | 0 | NZ | pan back from time1->time2| X | X |
| 0 | NZ | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | |
| 0 | NZ | NZ | 0 | 0 | 0 | start -> start+npts | | |
| 0 | NZ | 0 | NZ | 0 | 0 | end-npts -> end | | |
Any other combination of keywords is not allowed.
CALLING SEQUENCE: mag = get_fa_bdc(time1, time2, [NPTS=npts],
[START=st | EN=en | PANF=panf | PANB =
panb | ALL = all])
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to a number between 1 and 7. The number is determined by
interpreting the valid tags from each of the three long booms
as binary digits; mag1.valid is weighted 1, mag2.valid 2,
mag3.valid 4. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_bdc.pro 1.17 18 Jul 1996
Originally written by Bill Peria, University of
California at Berkeley, Space Sciences Lab. July 22, 1996
(See fastDataToIdl/get_fa_bdc.pro)
NAME: get_fa_edc_long
DESCRIPTION: returns, as best it can, a structure containing DC
electric field survey data from the FAST booms (1-4, 5-8, 9-10). It
must be the case that SDT is running, with V1-4, 5-8, and 9-10
plotted on screen already. In the case where, for example, sphere 9
is in voltage mode, then an array containing IEEE NaN, plus a
leading zero, will be returned in place of V9-10.
The returned structure looks like this:
DATA_NAME STRING ' E1-4 E5-8 E9-10' ; which 'E' quantities
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'mV/m' ; Units of this data
UNITS_PROCEDURE STRING 'fa_fields_units' ; Units conversion proc
START_TIME DOUBLE ; Start Time of sample
END_TIME DOUBLE ; End time of sample
NPTS INT ; Number of time samples
NCOMP INT ; Number of components
TIME DOUBLE Array(npts) ; timetags
E14 DOUBLE Array(npts) ;
E58 DOUBLE Array(npts) ;
E910 DOUBLE Array(npts) ;
|ALL |NPTS |START| EN |PANF |PANB |selection |use time1|use time2|
|----|-----|-----|-----|-----|-----|---------------------------|---------|---------|
| NZ | 0 | 0 | 0 | 0 | 0 | start -> end | X | X |
| 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X |
| 0 | 0 | NZ | 0 | 0 | 0 | start -> time1 secs | X | |
| 0 | 0 | 0 | NZ | 0 | 0 | end-time1 secs -> end | X | |
| 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from time1->time2 | X | X |
| 0 | 0 | 0 | 0 | 0 | NZ | pan back from time1->time2| X | X |
| 0 | NZ | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | |
| 0 | NZ | NZ | 0 | 0 | 0 | start -> start+npts | | |
| 0 | NZ | 0 | NZ | 0 | 0 | end-npts -> end | | |
Any other combination of keywords is not allowed.
CALLING SEQUENCE: e_long = get_fa_edc_long(time1, time2, [NPTS=npts],
[START=st | EN=en | PANF=panf | PANB =
panb | ALL = all])
CURRENT PROBLEMS: It's not clear what to do if the time bases for
the different data quantities are not the same. Right now, the times
returned are those of the first available DQD, in order [V1-V4,
V5-V8, V9-V10]. Yikes! Also, no indication of mode is returned...
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to a number between 1 and 7. The number is determined by
interpreting the valid tags from each of the three long booms
as binary digits; v14.valid is weighted 1, v58.valid 2,
v910.valid 4. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_edc_long.pro 1.18 07/23/96
Originally written by Bill Peria, University of
California at Berkeley, Space Sciences Lab. June '96
(See fastDataToIdl/get_fa_edc_long.pro)
FUNCTION:
GET_FA_EEB
DESCRIPTION:
function to load FAST E-esa burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Eesa Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000147 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_eeb (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_eeb.pro 1.20 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_eeb.pro)
FUNCTION: GET_FA_EEB_C DESCRIPTION: function to load FAST E-esa burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Eesa Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000147 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_eeb (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_eeb_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_eeb_c.pro)
FUNCTION:
GET_FA_EEB_HDR
DESCRIPTION:
function to load FAST E-esa burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Eesa_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'eiesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_eeb_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_eeb_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_eeb_hdr.pro)
FUNCTION: GET_FA_EEB_TS DESCRIPTION: function to load FAST E-esa Burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Eesa Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000147 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_eeb_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_eeb_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_eeb_ts.pro)
FUNCTION:
GET_FA_EES
DESCRIPTION:
function to load FAST E-esa survey data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Eesa Survey' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000147 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_ees (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ees.pro 1.26 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ees.pro)
FUNCTION: GET_FA_EES_C DESCRIPTION: function to load FAST E-esa survey data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Eesa Survey' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000147 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_ees (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ees_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_ees_c.pro)
FUNCTION:
GET_FA_EES_HDR
DESCRIPTION:
function to load FAST E-esa survey header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Eesa_Survey_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'eiesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_ees_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ees_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ees_hdr.pro)
FUNCTION: GET_FA_EES_TS DESCRIPTION: function to load FAST E-esa survey data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Eesa Survey' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000147 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_ees_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ees_ts.pro 1.2 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_ees_ts.pro)
NAME: GET_FA_FIELDS
PURPOSE: to get data from the FAST fields instrument
CALLING SEQUENCE: mydata = get_fa_fields(dqd,[ time1, time2,
NPTS=npts, START=st, EN=en, PANF=pf, PANB=pb,
ALL = all, CALIBRATE = calibrate, STORE = store])
INPUTS:
DQD: a string containing a valid Data Quantity Descriptor to
pass on to SDT. If SDT doesn't recognize the DQD, an
error message is sent to the screen, and an invalid
status is returned to IDL. Use the routine HELPFAST to
access a list of valid DQD's through Netscape.
NOTE: If GET_FA_FIELDS is called with nothing but a DQD, then the
keywords ALL, CALIBRATE, and REPAIR will be automatically
set. Furthermore, if GET_FA_FIELDS is called with no
*time-selection* keywords or time limits, then the ALL keyword
will be set.
OUTPUTS: A structure of the following format is returned to the
caller, *UNLESS* the keyword STORE is set, in which case
the data are stored tplot-style, and the TPLOT string
handle is returned to the caller. The STREAK_* tags are
arrays of indices into the COMP* tags. If the REPAIRED tag
contains a 1 on return, then the STREAK_* tags mark the
starts, lengths, and ends of streaks of contiguous,
evenly-sampled data.
DATA_NAME STRING 'V1-V4_S'
VALID INTEGER 1
PROJECT_NAME STRING 'FAST'
UNITS_NAME STRING 'mV/m'
CALIBRATED LONG 1
UNITS_PROCEDURE STRING 'fast_fields_units'
START_TIME DOUBLE 8.5194794e+08
END_TIME DOUBLE 8.5195604e+08
NPTS LONG 5000
NCOMP LONG 1
DEPTH LONARR(NCOMP) 1
TIME DBLARR(NPTS) START_TIME->END_TIME
COMP* FLTARR(NPTS,DEPTHS(*)) SCIENCE!
STREAK_STARTS LONARR(??)
STREAK_LENGTHS LONARR(??)
STREAK_ENDS LONARR(??)
REPAIRED LONG 1
OPTIONAL INPUTS:
time1 : This argument gives the start time from which to take
data, or, if START or EN keywords are non-zero, the
length of time to take data. It may be either a
string with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference
date) or a number, which will represent seconds since
1970 (must be a double > 94608000.D), or hours from a
reference time, if set.
time2 : The same as time1, except it represents the end
time. If the NPTS, START, EN, PANF or PANB keywords
are non-zero, then time2 will be ignored as an input
parameter.
KEYWORD PARAMETERS:
CALIBRATE: If set, causes calibrated data to be returned, if
possible. Otherwise, raw data are returned,
*unless* the environment variable FAST_CALIBRATE is
set to 1, i.e. setenv FAST_CALIBRATE 1 . Setting
the CALIBRATE keyword causes the procedure name in
DAT.UNITS_PROCEDURE to be called.
DEFAULT: If set, causes CALIBRATE, ALL, and REPAIR to be set.
MIN_BUF_LENGTH: If defined, sets the minimum number of
time-contiguous points in a "good streak" or
"buffer" of data. Default is 10.
REPAIR: If set, causes a time column patcher to be
called. Otherwise, you get what SDT is giving.
SPIN: If defined, causes the data to be returned at once per
spin resolution, at a phase equal to the value of SPIN
in degrees.
STORE: If set, the tplot routine STORE_DATA is called, and a
rudimentary tplot quantity is stored, to be accessed
through GET_DATA. In this case, GET_FA_FIELDS returns
the TPLOT string handle to the caller.
STRUCTURE: A named variable in which the data structure
described above can be returned, if desired (for
example, if STORE is set).
YBINS: If nonzero, two dimensional fields quantities are
returned with this many frequency bins.
BACKGROUND: If set, causes a background to be removed from 2D
fields quantities. The background is that returned
from the function NOISE. Note that this all makes sense
only for 2D, CALIBRATE'd quantities.
Other keywords determine data time selection as given in the
following truth table (NZ == non-zero):
|ALL|NPTS|START|EN|PANF|PANB|selection |use time1|use time2|
|---|----|-----|--|----|----|----------------------|---------|---------|
| NZ| 0 | 0 | 0| 0 | 0 |start -> end | X | X |
| 0 | 0 | 0 | 0| 0 | 0 |time1 -> time2 | X | X |
| 0 | 0 | NZ | 0| 0 | 0 |start -> time1 secs | X | |
| 0 | 0 | 0 |NZ| 0 | 0 |end-time1 secs -> end | X | |
| 0 | 0 | 0 | 0| NZ| 0 |pan fwd, time1->time2 | X | X |
| 0 | 0 | 0 | 0| 0 | NZ|pan back,time1->time2 | X | X |
| 0 | NZ| 0 | 0| 0 | 0 |time1 -> time1+npts | X | |
| 0 | NZ| NZ | 0| 0 | 0 |start -> start+npts | | |
| 0 | NZ| 0 |NZ| 0 | 0 |end-npts -> end | | |
No other combination of keywords is allowed.
RESTRICTIONS: The data corresponding to DQD must already be on
screen, having been plotted by SDT.
EXAMPLE: my_data = get_fa_fields('V1-V4_S',/all) *OR*
tplot,get_fa_fields('Mag3dc_S',/all,/calibrate,/store,struc=my_data)
MODIFICATION HISTORY: written June 1996 by Bill Peria, UCBerkeley
Space Sciences Laboratory
@(#)get_fa_fields.pro 1.64
(See fastDataToIdl/get_fa_fields.pro)
NAME: GET_FA_FLDS
PURPOSE: To store raw FAST fields quantities for TPLOT
CALLING SEQUENCE: get_fa_fields,dqd,[ time1, time2,
NPTS=npts, START=st, EN=en, PANF=pf, PANB=pb,
ALL = all, CALIBRATE = calibrate, STORE = store]
INPUTS: DQD - a string containing a valid Data Quantity Descriptor
to pass on to SDT. If SDT doesn't recognize the DQD,
an error message is sent to the screen, and an
invalid status is returned to IDL. The file
FastDQD.doc, in the directory
/disks/fast/software/integration/docs, contains all
the current DQD information for FAST. The Unix
command:
grep DataQuantity $FASTHOME/FastDQD.doc,
will produce a (long!) list of valid DQD's, which you
could redirect into a file for future reference.
OPTIONAL INPUTS:
time1 This argument gives the start time from
which to take data, or, if START or EN keywords
are non-zero, the length of time to take data.
It may be either a string with the following
possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
Time will always be returned as a double
representing the actual data start time found
in seconds since 1970.
time2 The same as time1, except it represents the
end time.
If the NPTS, START, EN, PANF or PANB keywords
are non-zero, then time2 will be ignored as an
input parameter.
KEYWORD PARAMETERS:
CALIBRATE: If set, causes calibrated data to be returned, if
possible. Otherwise, raw data are returned,
*unless* the environment variable FAST_CALIBRATE is
set to 1, i.e. setenv FAST_CALIBRATE 1 .
STORE: Meaningless, always set.
STRUCTURE: A named variable in which the data structure
described above can be returned, if desired (for
example, if STORE is set).
SPIN: If defined, causes the data to be returned at once per
spin resolution, at a phase equal to the value of SPIN
in degrees.
YBINS: If nonzero, two dimensional fields quantities are
returned with this many frequency bins.
Setting the CALIBRATE keyword causes the procedure name in
DAT.UNITS_PROCEDURE to be called.
Other keywords determine data time selection as given in the
following truth table (NZ == non-zero):
|ALL |NPTS |START| EN |PANF |PANB |selection |use time1|use time2|
|----|-----|-----|-----|-----|-----|---------------------------|---------|---------|
| NZ | 0 | 0 | 0 | 0 | 0 | start -> end | X | X |
| 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X |
| 0 | 0 | NZ | 0 | 0 | 0 | start -> time1 secs | X | |
| 0 | 0 | 0 | NZ | 0 | 0 | end-time1 secs -> end | X | |
| 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from time1->time2 | X | X |
| 0 | 0 | 0 | 0 | 0 | NZ | pan back from time1->time2| X | X |
| 0 | NZ | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | |
| 0 | NZ | NZ | 0 | 0 | 0 | start -> start+npts | | |
| 0 | NZ | 0 | NZ | 0 | 0 | end-npts -> end | | |
No other combination of keywords is allowed.
RESTRICTIONS: The data corresponding to DQD must already be on
screen, having been plotted by SDT.
OUTPUTS: A TPLOT quantitiy, with the name DQD, is stored.
EXAMPLE: get_fa_flds,'Mag1dc_S',/all
MODIFICATION HISTORY: written 3-October-1996 by Bill Peria UCB/SSL
(See fastDataToIdl/get_fa_flds.pro)
FUNCTION:
GET_FA_IEB
DESCRIPTION:
function to load FAST I-esa burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Iesa Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 0.0104389 ; Particle Mass
GEOMFACTOR DOUBLE 0.0002720 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_ieb (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ieb.pro 1.19 12/03/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ieb.pro)
FUNCTION: GET_FA_IEB_C DESCRIPTION: function to load FAST I-esa burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Iesa Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.0104389 ; Particle Mass GEOMFACTOR DOUBLE 0.0002720 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_ieb (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ieb_c.pro 1.2 12/03/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_ieb_c.pro)
FUNCTION:
GET_FA_IEB_HDR
DESCRIPTION:
function to load FAST I-esa burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Iesa_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'eiesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_ieb_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ieb_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ieb_hdr.pro)
FUNCTION: GET_FA_IEB_TS DESCRIPTION: function to load FAST I-esa burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Iesa Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.0104389 ; Particle Mass GEOMFACTOR DOUBLE 0.000272 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_ieb_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ieb_ts.pro 1.4 12/03/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_ieb_ts.pro)
FUNCTION:
GET_FA_IES
DESCRIPTION:
function to load FAST E-esa survey data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Eesa Survey' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 0.0104389 ; Particle Mass
GEOMFACTOR DOUBLE 0.000272 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_ies (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ies.pro 1.23 12/03/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ies.pro)
FUNCTION: GET_FA_IES_C DESCRIPTION: function to load FAST I-esa survey data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Iesa Survey' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.0104389 ; Particle Mass GEOMFACTOR DOUBLE 0.000272 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_ies (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ies_c.pro 1.2 12/03/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_ies_c.pro)
FUNCTION:
GET_FA_IES_HDR
DESCRIPTION:
function to load FAST I-esa survey header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Iesa_Survey_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'eiesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_ies_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ies_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ies_hdr.pro)
FUNCTION: GET_FA_IES_TS DESCRIPTION: function to load FAST I-esa survey data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Iesa Survey' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.0104389 ; Particle Mass GEOMFACTOR DOUBLE 0.000272 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_ies_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ies_ts.pro 1.3 12/03/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_ies_ts.pro)
inputs:
start start time in any format accepted by time_double
finish end time in any format accepted by time_double
qtylist string containing comma separated list of desired columns from
the events_data table. e.g. 'X, Y, Z'
(See fastDataToIdl/database/get_fa_orbatt.pro)
PROCEDURE: get_fa_orbit
PURPOSE:
Computes orbit vectors for a set of times extending over a given timespan.
POSITIONAL PARAMETERS:
arg1:
if keyword parameter 'time_array' is not set, then this parameter is the
start time of the timespan over which orbit vectors are to be computed,
else it is the array of times for which orbit vectors are to be computed.
arg2:
if keyword parameter 'time_array' is not set, then this parameter is the
end time of the timespan over which orbit vectors are to be computed,
else it is not used.
KEYWORDS:
time_array:
If not set, then interpret the two positional parameters as the start
time and end time of the timespan over which orbit vectors are to be
computed. If set, interpret the first positional parameter as an array
of times for which orbit vectors are to be computed, and the second
positional parameter as the number of elements in the array of times.
gse:
If set, get_fa_orbit will execute a store_data on the following:
{x:time,y:pos,ytitle:'fa_pos'}
{x:time,y:pos,ytitle:'fa_vel'}
All overides this keyword.
all:
If not set, and gse is not set, get_fa_orbit will execute a
store_data on the following:
{x:time,y:orbit,ytitle:'ORBIT'}
{x:time,y:pos,ytitle:'fa_pos'}
{x:time,y:alt,ytitle:'ALT'}
{x:time,y:ilat,ytitle:'ILAT'}
{x:time,y:ilng,ytitle:'ILNG'}
{x:time,y:mlt,ytitle:'MLT'}
{x:time,y:vel,ytitle:'fa_vel'}
If set, get_fa_orbit will execute store_data on the above and also on:
{x:time,y:lat,ytitle:'LAT'}
{x:time,y:lng,ytitle:'LNG'}
{x:time,y:flat,ytitle:'FLAT'}
{x:time,y:flng,ytitle:'FLNG'}
{x:time,y:b,ytitle:'B_model'}
{x:time,y:bfoot,ytitle:'BFOOT'}
where orbit, pos, alt, etc are arrays of values as defined in the orbitio
library documentation (see orbitlib(3)), and bfoot is the magnetic
field at the position of the footprint, in GEI coords, in nTesla.
Note that the position, velocity, magnetic field, and magnetic field
at the footprint are given in GEI coordinates.
status:
The long integer return value of the OrbGetVectors() call in the orbitio
library. There are about a dozen different status codes indicating the
various possible error conditions. These status codes are shown in the
include file $(workspace)/include/orbitlib.h (ORB_OK, ORB_EOF, etc).
The user should generally call get_fa_orbit with the status keyword set,
and should explicitly test that status equals 0 (ORB_OK = 0 signifies
success) before using the returned data.
delta_t:
spacing in seconds of the computed orbit vectors (default = 20 sec)
this keyword parameter is ignored if keyword parameter time_array is set
definitive:
if set, uses the definitive orbit file, else uses the predicted orbit
file. (see keyword 'orbit_file' below)
drag_prop:
if set, the call to the orbitprop library will use an orbit propagator
that includes the effects of atmospheric drag (which is somewhat slower,
but more accurate). If not set, uses an orbit propagator which ignores
atmospheric drag.
orbit_file:
if set to a pathname of an orbit file, this named orbit file will be used
instead of the default orbit file, which is found by reading the file
$FASTCONFIG/fast_archive.conf for the variable FAST_ALMANAC, and then
setting orbit_file = value(FAST_ALMANAC)/orbit/predicted, unless the
keyword definitive is set, in which case
orbit_file = value(FAST_ALMANAC)/orbit/definitive.
verbose:
Should not be used by users. For debugging use only. Functionality
changes unexpectedly and without notice.
addfp:
Should not be used by users. For debugging use only. Functionality
changes unexpectedly and without notice.
no_store:
If set, inhibits tplot-storage of orbit quantities. This is
useful to avoid the overwriting of previously stored orbit data.
struc:
A named variable in which a strucure containing the requested
orbit quantities can be returned.
VERSION: @(#)get_fa_orbit.pro 1.19 11/13/97 UCB SSL
(See fastDataToIdl/orbit/get_fa_orbit.pro)
FUNCTION: get_fa_orbit_geomag(orbit)
NAME:
get_fa_orbit_geomag
PURPOSE:
Gets geomag data kp, ap, and dsp for given orbit. Data are
returned for incoming and outgoing north and south.
INPUT: input(s) can be scalers or arrays of any dimension of type:
integer orbit number.
OUTPUT:
structure: {orbit_geomag, inNorth:{geomag}, outNorth:{geomag},
inSouth:{geomag}, outSouth:{geomag}}
SEE ALSO:
what_orbit_is, get_fa_orbit_times_db, geomag
CREATED BY: Ken Bromund Dec 1997
FILE: get_fa_orbit_geomag.pro
VERSION: 1.2
LAST MODIFICATION: 98/01/06
(See fastDataToIdl/database/get_fa_orbit_geomag.pro)
FUNCTION: get_fa_orbit_times_db(orbit)
NAME:
get_fa_orbit_times_db
PURPOSE:
Obtains orbit start, stop, north and south pole crossing times
from the fast_archive database given an orbit number.
INPUT: input(s) can be scalers or arrays of any dimension of type:
integer orbit number.
OUTPUT:
structure: {orbit_times, start:limits.start, finish:limits.finish, $
north:north.time, south:south.time}
SEE ALSO:
what_orbit_is
CREATED BY: Ken Bromund Dec 1997
FILE: get_fa_orbit_times_db.pro
VERSION: 1.2
LAST MODIFICATION: 98/01/06
(See fastDataToIdl/database/get_fa_orbit_times_db.pro)
NAME: GET_FA_POTENTIAL
PURPOSE:
To obtain the spacecraft potential for FAST in fa_fields
format. Calls FF_POTENTIAL to do the bulk of the work.
CALLING SEQUENCE: pot = get_fa_potential(time1c, time2c, NPTS=npts,
START=st, EN=en, PANF=pf, PANB=pb, ALL = all,
STORE = store, STRUCTURE = struct, SPIN = spin,
REPAIR = repair)
INPUTS: T1, T2: start and stop times, in seconds since 1970 or
YYYY-MM-DD/HH:MM:SS.
KEYWORD PARAMETERS: All applicable keywords from GET_FA_FIELDS.
OUTPUTS: If /STORE is not set set, a standard fields structure
containing the potential in volts in COMP1 is returned. If
STORE is set, a tplot string handle is returned.
RESTRICTIONS: The environment variable FAST_CALIBRATE must be 1.
Why not do the following:
alias fastsdt 'setenv FAST_CALIBRATE 1; sdt'
in your .cshrc file?
EXAMPLE: pot = get_fa_potential(t1,t2)
pdqplot,pot
OR...
tplot,get_fa_potential(t1,t2,/store)
MODIFICATION HISTORY: written April '97 by Bill Peria
(See fastDataToIdl/get_fa_potential.pro)
FUNCTION:
GET_FA_SEB
DESCRIPTION:
function to load FAST Sesa burst combined data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_seb (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb.pro 1.2 08/30/99
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. Aug '99
(See fastDataToIdl/get_fa_seb.pro)
FUNCTION:
GET_FA_SEB1
DESCRIPTION:
function to load FAST S-esa1 burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa1 Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_seb1 (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb1.pro 1.17 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb1.pro)
FUNCTION: GET_FA_SEB1_C DESCRIPTION: function to load FAST S-esa1 burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa 1 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_seb1 (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb1_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_seb1_c.pro)
FUNCTION:
GET_FA_SEB1_HDR
DESCRIPTION:
function to load FAST S-esa1 burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa1_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'sesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_seb1_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb1_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb1_hdr.pro)
FUNCTION: GET_FA_SEB1_TS DESCRIPTION: function to load FAST S-esa 1 burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa1 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_seb1_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb1_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_seb1_ts.pro)
FUNCTION:
GET_FA_SEB2
DESCRIPTION:
function to load FAST S-esa2 burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa2 Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_seb2 (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb2.pro 1.17 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb2.pro)
FUNCTION: GET_FA_SEB2_C DESCRIPTION: function to load FAST S-esa2 burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa 2 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_seb2 (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb2_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_seb2_c.pro)
FUNCTION:
GET_FA_SEB2_HDR
DESCRIPTION:
function to load FAST S-esa2 burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa2_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'sesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_seb2_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb2_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb2_hdr.pro)
FUNCTION: GET_FA_SEB2_TS DESCRIPTION: function to load FAST S-esa 2 burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa2 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_seb2_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb2_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_seb2_ts.pro)
FUNCTION:
GET_FA_SEB3
DESCRIPTION:
function to load FAST S-esa3 burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa3 Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_seb3 (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb3.pro 1.17 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb3.pro)
FUNCTION: GET_FA_SEB3_C DESCRIPTION: function to load FAST S-esa3 burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa 3 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_seb3 (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb3_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_seb3_c.pro)
FUNCTION:
GET_FA_SEB3_HDR
DESCRIPTION:
function to load FAST S-esa3 burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa3_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'sesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_seb3_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb3_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb3_hdr.pro)
FUNCTION: GET_FA_SEB3_TS DESCRIPTION: function to load FAST S-esa 3 burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa3 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_seb3_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb3_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_seb3_ts.pro)
FUNCTION:
GET_FA_SEB4
DESCRIPTION:
function to load FAST S-esa4 burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa4 Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_seb4 (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb4.pro 1.17 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb4.pro)
FUNCTION: GET_FA_SEB4_C DESCRIPTION: function to load FAST S-esa4 burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa 4 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_seb4 (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb4_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_seb4_c.pro)
FUNCTION:
GET_FA_SEB4_HDR
DESCRIPTION:
function to load FAST S-esa4 burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa4_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'sesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_seb4_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb4_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb4_hdr.pro)
FUNCTION: GET_FA_SEB4_TS DESCRIPTION: function to load FAST S-esa 4 burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa4 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_seb4_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb4_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_seb4_ts.pro)
FUNCTION:
GET_FA_SEB5
DESCRIPTION:
function to load FAST S-esa5 burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa5 Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_seb5 (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb5.pro 1.17 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb5.pro)
FUNCTION: GET_FA_SEB5_C DESCRIPTION: function to load FAST S-esa5 burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa 5 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_seb5 (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb5_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_seb5_c.pro)
FUNCTION:
GET_FA_SEB5_HDR
DESCRIPTION:
function to load FAST S-esa5 burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa5_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'sesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_seb5_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb5_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb5_hdr.pro)
FUNCTION: GET_FA_SEB5_TS DESCRIPTION: function to load FAST S-esa 5 burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa5 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_seb5_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb5_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_seb5_ts.pro)
FUNCTION:
GET_FA_SEB6
DESCRIPTION:
function to load FAST S-esa6 burst data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa6 Burst' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_seb6 (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb6.pro 1.17 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb6.pro)
FUNCTION: GET_FA_SEB6_C DESCRIPTION: function to load FAST S-esa6 burst data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa 6 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_seb6 (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb6_c.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_seb6_c.pro)
FUNCTION:
GET_FA_SEB6_HDR
DESCRIPTION:
function to load FAST S-esa6 burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa6_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'sesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_seb6_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb6_hdr.pro 1.9 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_seb6_hdr.pro)
FUNCTION: GET_FA_SEB6_TS DESCRIPTION: function to load FAST S-esa 6 burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa6 Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_seb6_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb6_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_seb6_ts.pro)
FUNCTION: GET_FA_SEB_C DESCRIPTION: function to load FAST Sesa burst combined data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa Burst Combined'; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_seb (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb_c.pro 1.2 08/30/99 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_seb_c.pro)
FUNCTION:
GET_FA_SEB_HDR
DESCRIPTION:
function to load FAST S-esa burst combined header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa_Cmb_Burst_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'eiesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(268) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_seb_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_seb_hdr.pro 1.1 08/26/99
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. Aug '99
(See fastDataToIdl/get_fa_seb_hdr.pro)
FUNCTION: GET_FA_EES_TS DESCRIPTION: function to load FAST E-esa Burst data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa Burst' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_ees_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_seb_ts.pro 1.1 08/26/99 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '99
(See fastDataToIdl/get_fa_seb_ts.pro)
FUNCTION:
GET_FA_SES
DESCRIPTION:
function to load FAST S-esa survey data from the SDT program shared
memory buffers.
A structure of the following format is returned:
DATA_NAME STRING 'Sesa Survey' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
INTEG_T DOUBLE 3.0000000 ; Integration time
NBINS INT nbins ; Number of angle bins
NENERGY INT nnrgs ; Number of energy bins
DATA FLOAT Array(nnrgs, nbins) ; Data qauantities
ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps
THETA FLOAT Array(nnrgs, nbins) ; Angle for bins
GEOM FLOAT Array(nbins) ; Geometry factor
DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins
DTHETA FLOAT Array(nbins) ; Delta Theta
EFF FLOAT Array(nnrgs) ; Efficiency (GF)
MASS DOUBLE 5.68566e-6 ; Particle Mass
GEOMFACTOR DOUBLE 0.000625 ; Bin GF
HEADER_BYTES BYTE Array(25) ; Header bytes
INDEX LONG idx ; Index into sdt data
CALLING SEQUENCE:
data = get_fa_ses (time, [START=start | EN=en | ADVANCE=advance |
RETREAT=retreat])
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
START If non-zero, get data from the start time
of the data instance in the SDT buffers
EN If non-zero, get data at the end time
of the data instance in the SDT buffers
ADVANCE If non-zero, advance to the next data point
following the time input
RETREAT If non-zero, retreat (reverse) to the previous
data point before the time input
CALIB If non-zero, caclulate geometry
factors for each bin instead of using 1.'s
INDEX Index into sdt data
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ses.pro 1.20 09/03/99
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ses.pro)
FUNCTION: GET_FA_SES_C DESCRIPTION: function to load FAST S-esa survey data from the SDT program shared memory buffers. This is the caching version A structure of the following format is returned: DATA_NAME STRING 'Sesa Survey' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nnrgs, nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers CALLING SEQUENCE: data = get_fa_ses (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat], CALIB=calib, INDEX=idx, FLUSH=flush, CACHE_SIZE=cache_size) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time or index input RETREAT If non-zero, retreat (reverse) to the previous data point before the time or index input CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s INDEX If index is set, it is used for selecting the index to get data. FLUSH If non-zero, will flush the data cache This is useful to force a re-read of sdt buffers in case the data has changed. CACHE_SIZE If gt 0, will reset the length in points of data to cache. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ses_c.pro 1.3 10/06/99 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 Major upgrade, using get_cache_md_from_sdt to load a time range at once to cache data in idl for speedup. J.M. Loran Apr. 97
(See fastDataToIdl/get_fa_ses_c.pro)
FUNCTION:
GET_FA_SES_HDR
DESCRIPTION:
function to load FAST S-esa survey header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Sesa_Survey_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING 'sesa_unpack_hdr' ; Name of proc to
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(44) ; Header bytes
INDEX LONG idx ; index into data
CALLING SEQUENCE:
data = get_fa_ses_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
KEYWORDS:
INDEX: get data at this index.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_ses_hdr.pro 1.10 07/23/97
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_ses_hdr.pro)
FUNCTION: GET_FA_SES_TS DESCRIPTION: function to load FAST S-esa survey data from the SDT program shared memory buffers. This is the time series version. An array of npts structures of the following format are returned: DATA_NAME STRING 'Sesa Survey' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000625 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes INDEX LONG index ; Data index, this pt. ST_INDEX LONG st_idx ; start index of arr EN_INDEX LONG en_idx ; end index of arr NPTS LONG npts ; array size CALLING SEQUENCE: data = get_fa_ses_ts (t1, t2, [NPTS=npts], [START=st | EN=en | PANF=panf | PANB=panb | IDXST=startidx], CALIB=calib) ARGUMENTS: t1 This argument gives the start time from which to take data, or, if START or EN keywords are non-zero, the length of time to take data. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. Time will always be returned as a double representing the actual data start time found in seconds since 1970. t2 The same as time1, except it represents the end time. If the NPTS, START, EN, PANF or PANB keywords are non-zero, THEN time2 will be ignored as an input paramter. KEYWORDS: CALIB If non-zero, caclulate geometry factors for each bin instead of using 1.'s Data time selection is determined from the keywords as given in the following truth table (NZ == non-zero): |ALL |NPTS |START| EN |IDXST|PANF |PANB |selection |use time1|use time2| |----|-----|-----|-----|-----|-----|-----|---------------------|---------|---------| | NZ | 0 | 0 | 0 | 0 | 0 | 0 | start -> end | X | X | | 0 | 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X | | 0 | 0 | NZ | 0 | 0 | 0 | 0 | start -> time1 secs | X | | | 0 | 0 | 0 | NZ | 0 | 0 | 0 | end-time1 secs ->end| X | | | 0 | 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from | X | X | | | | | | | | | time1->time2 | | | | 0 | 0 | 0 | 0 | 0 | 0 | NZ | pan back from | X | X | | | | | | | | | time1->time2 | | | | 0 | NZ | 0 | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | | | 0 | NZ | NZ | 0 | 0 | 0 | 0 | start -> start+npts | | | | 0 | NZ | 0 | NZ | 0 | 0 | 0 | end-npts -> end | | | | 0 | NZ | 0 | 0 | NZ | 0 | 0 | st-index -> | | | | | | | | | | | st_index + npts | | | Any other combination of keywords is not allowed. RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_ses_ts.pro 1.3 05/23/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Apr '97
(See fastDataToIdl/get_fa_ses_ts.pro)
NAME: GET_FA_SPIN_RATE
PURPOSE: Computes the spin rate and phase (sun).
CATEGORY: attitude, despinning
CALLING SEQUENCE: wspin = get_fa_spin_rate(tmag,mag)
by default, a single number estimate of the spin
rate is returned. It's not very precise, but
may be ok for some things.
INPUTS: TMAG : the time column for the magnetometer data being used
to estimate spin rate. Must be in seconds since 1970 if
/PRECISE is set, for compatibility with FAST spin/mag phase
quantities.
MAG: the mag data. I generally use Mag3dc. If you don't pass
in any mag data, the program attempts to load it from
SDT.
KEYWORD PARAMETERS: PRECISE: if set, then the spin phase quantity
(dqd is SMPhase_FieldsSurvey0) is extracted and
used in conjunction with the MAG data to
determine spin rate. An array of spin rates
(w.r.t. the sun line) is returned.
ONE_ONLY: same as default. Inhibits PRECISE.
PHASE: a named variable in which the spin phase
is returned. By default, w.r.t. sun
line.
OUTPUTS: wspin : the spin rate, either crude or precise w.r.t. the sun.
OPTIONAL OUTPUTS: PHASE: w.r.t. sun, through keyword.
SIDE EFFECTS: if PRECISE is set, spin phase quantities are
extracted from SDT.
RESTRICTIONS: Need SDT running, with spin phase and mag data loaded,
if PRECISE is set or mag data is not passed in.
MODIFICATION HISTORY: written in October of 1996 by Bill Peria, UCB/SSL
(See fastDataToIdl/get_fa_spin_rate.pro)
FUNCTION: get_fa_sunnadir
PURPOSE:
For the FAST satellite, calculates the the simulated sun pulse
from earth horizon crossings and spin period.
CALLING SEQUENCE:
simSunpulseArr = get_fa_sunnadir(times, horizCrossings, $
period, GOOD_INDICES=gi)
INPUTS:
times: Array of time tags that apply to the other
input arrays.
horizCrossings: An array the same size as times, of structures
{setime: double, estime: double} where setime
is the space earth horizon crossing time, and
estime is the earth space horizon crossing
time.
period: Period of one spin of the spacecraft in seconds.
KEYWORD PARAMETERS:
GOOD_INDICES: This will give the indices that contain good
data that were used from the calling args.
OUTPUTS:
simSunpulseArr: This is the returned array of simulated
sun pulse times, one array element for each
input time given in the times parameter.
MODIFICATION HISTORY:
@(#)get_fa_sunnadir.pro 1.1 02/12/98
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. Oct '97
(See fastDataToIdl/sunnadir/get_fa_sunnadir.pro)
FUNCTION: GET_FA_TBA DESCRIPTION: function to load FAST Teams burst He++ species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Burst Alpha' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.0207261 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 1. ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes CALLING SEQUENCE: data = get_fa_tba (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tba.pro 1.14 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 MODIFICATION HISTORY: eff added by Li Tang 1/1/97 Univ. of New Hampshire geomfactor = 0.0015 units_procedure = 'convert_tms_units' geom(nnrgs, nbins) spin_fract added 7/15/97 Keyword CALIB added L.Tang
(See fastDataToIdl/get_fa_tba.pro)
FUNCTION: GET_FA_TBH DESCRIPTION: function to load FAST Teams burst He+ species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Burst Helium' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.0417556 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 1. ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes CALLING SEQUENCE: data = get_fa_tbh (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tbh.pro 1.14 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 MODIFICATION HISTORY: eff added by Li Tang 1/1/97 Univ. of New Hampshire geomfactor = 0.0015 units_procedure = 'convert_tms_units' geom(nnrgs, nbins) spin_fract added 7/15/97 Keyword CALIB added L.Tang
(See fastDataToIdl/get_fa_tbh.pro)
FUNCTION: GET_FA_TBO DESCRIPTION: function to load FAST Teams burst O+ species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Burst Oxygen' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.1670224 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 1. ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes CALLING SEQUENCE: data = get_fa_tbo (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tbo.pro 1.13 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: eff added by Li Tang 11/21/96 Univ. of New Hampshire geomfactor = 0.0015 units_procedure = 'convert_tms_units' geom(nnrgs, nbins) spin_fract added 7/15/97 Keyword CALIB added L.Tang
(See fastDataToIdl/get_fa_tbo.pro)
FUNCTION: GET_FA_TBP DESCRIPTION: function to load FAST Teams burst H+ species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Burst Proton' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 0.0104389 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 1. ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes CALLING SEQUENCE: data = get_fa_tbp (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tbp.pro 1.14 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: eff added by Li Tang 11/21/96 Univ. of New Hampshire geomfactor = 0.0015 units_procedure = 'convert_tms_units' geom(nnrgs, nbins) spin_fract added 7/15/97 Keyword CALIB added L.Tang
(See fastDataToIdl/get_fa_tbp.pro)
FUNCTION:
GET_FA_TB_HDR
DESCRIPTION:
function to load FAST TEAMS burst header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Tms_Burst_Packet_Hdr' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING '<NONE>' ; Name of proc to
; (Not implemeted)
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(86) ; Header bytes
CALLING SEQUENCE:
data = get_fa_tb_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_tb_hdr.pro 1.3 12 Jul 1996
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_tb_hdr.pro)
FUNCTION: GET_FA_TH DESCRIPTION: function to load FAST Teams HiMass data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms HiMass Bin:N'; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Theta angle for bins PHI FLOAT Array(nnrgs, nbins) ; Phi angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta DPHI FLOAT Array(nbins) ; Delta Phi DOMEGA FLOAT Array(nbins) ; Solid angle for bins PT_LIMITS FLOAT Array(4) ; Angle min/max limits EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE mass ; mean bin Mass in ; eV/(km/sec)^2 DMASS DOUBLE dmass ; mass bin width in ; eV/(km/sec)^2 GEOMFACTOR DOUBLE 1. ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes The bin number selected will be returned as part of the DATA_NAME string. CALLING SEQUENCE: data = get_fa_th (time, bin, [START=start | EN=en | ADVANCE = advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_th.pro 1.19 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 MODIFICATION HISTORY: 7/15/97 Keyword CALIB added L.Tang
(See fastDataToIdl/get_fa_th.pro)
FUNCTION:
GET_FA_TH_HDR
DESCRIPTION:
function to load FAST TEAMS hiMass header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Tms_HiMass_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING '<NONE>' ; Name of proc to
; (Not implemeted)
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(86) ; Header bytes
CALLING SEQUENCE:
data = get_fa_th_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_th_hdr.pro 1.3 12 Jul 1996
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_th_hdr.pro)
FUNCTION: GET_FA_TPA DESCRIPTION: function to load FAST Teams pole He++ species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Pole Alpha' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs, nbins) ; Efficiency (GF) SPIN_FRACT FLOAT ARRAY(nnrgs, nbins) ; Spin fraction of angles MASS DOUBLE 0.0414521 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE .0015 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes EFF_VERSION FLOAT 1.0 ; Eff. calibration vers. CALLING SEQUENCE: data = get_fa_tpa (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tpa.pro 1.14 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: 11/15/96 Li Tang Univ. of New Hampshire tang@teams.sr.unh.edu eff, spin_fract added geom changed to array(nngrs,nbins) units_procedure changed to 'convert_tms_units' 7/15/97 KEYWORD CALIB added
(See fastDataToIdl/get_fa_tpa.pro)
FUNCTION:
GET_FA_TPAH_HDR
DESCRIPTION:
function to load FAST TEAMS He pole header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Tms_He_Pole_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING '<NONE>' ; Name of proc to
; (Not implemeted)
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(86) ; Header bytes
CALLING SEQUENCE:
data = get_fa_tpah_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_tpah_hdr.pro 1.3 12 Jul 1996
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_tpah_hdr.pro)
FUNCTION: GET_FA_TPH DESCRIPTION: function to load FAST Teams pole He+ species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Pole Helium' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs, nbins) ; Efficiency (GF) SPIN_FRACT FLOAT ARRAY(nnrgs, nbins) ; Spin fraction of angles MASS DOUBLE 0.0414521 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE .0015 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes EFF_VERSION FLOAT 1.0 ; Eff. calibration vers. CALLING SEQUENCE: data = get_fa_tph (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tph.pro 1.14 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: 11/15/96 Li Tang Univ. of New Hampshire tang@teams.sr.unh.edu eff, spin_fract added geom changed to array(nngrs,nbins) units_procedure changed to 'convert_tms_units' 7/15/97 KEYWORD CALIB added
(See fastDataToIdl/get_fa_tph.pro)
FUNCTION: GET_FA_TPO DESCRIPTION: function to load FAST Teams pole Oxygen species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Pole Oxygen' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nngrs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) SPIN_FRACT FLOAT ARRAY(nnrgs, nbins) ; Spin fraction of angles MASS DOUBLE 0.0104389 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 0.0015 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes EFF_VERSION FLOAT 1.0 ; Eff. calibration vers. CALLING SEQUENCE: data = get_fa_tpo (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tpo.pro 1.13 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: eff added by Li Tang 11/11/96 Univ. of New Hampshire spin_fract added units_procedure = 'convert_tms_units' geom(nnrgs, nbins) 7/15/97 KEYWORD CALIB added, LT
(See fastDataToIdl/get_fa_tpo.pro)
FUNCTION:
GET_FA_TPOP_HDR
DESCRIPTION:
function to load FAST TEAMS HO pole header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Tms_HO_Pole_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING '<NONE>' ; Name of proc to
; (Not implemeted)
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(86) ; Header bytes
CALLING SEQUENCE:
data = get_fa_tpop_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_tpop_hdr.pro 1.3 12 Jul 1996
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_tpop_hdr.pro)
FUNCTION: GET_FA_TPP DESCRIPTION: function to load FAST Teams pole proton species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Pole Proton' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nngrs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs, nbins) ; Efficiency (GF) SPIN_FRACT FLOAT ARRAY(nnrgs, nbins) ; Spin fraction of angles MASS DOUBLE 0.0104389 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 0.0015 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes EFF_VERSION FLOAT 1.0 ; Eff. calibration vers. CALLING SEQUENCE: data = get_fa_tpp (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tpp.pro 1.13 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: 11/15/96 Li Tang Univ. of New Hampshire tang@teams.sr.unh.edu eff, spin_fract, added geom changed to array(nngrs,nbins) units_procedure changed to 'convert_tms_units'
(See fastDataToIdl/get_fa_tpp.pro)
FUNCTION: GET_FA_TSA DESCRIPTION: function to load FAST Teams survey Alpha (He++) species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Survey Alpha' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Theta angle for bins PHI FLOAT Array(nnrgs, nbins) ; Phi angle for bins GEOM FLOAT Array(nnrgs, nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta DPHI FLOAT Array(nbins) ; Delta Phi DOMEGA FLOAT Array(nbins) ; Solid angle for bins PT_LIMITS FLOAT Array(4) ; Angle min/max limits EFF FLOAT Array(nnrgs,nbins) ; Efficiency (GF) MASS DOUBLE 0.0207261 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 0.0015 ; Bin GF HEADER_BYTES BYTE Array(25) ; Header bytes CALLING SEQUENCE: data = get_fa_tsa (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tsa.pro 1.20 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: eff added by Li Tang 10/21/96 Univ. of New Hampshire geomfactor = 0.0015 units_procedure = 'convert_tms_units' geom(nnrgs, nbins) 7/15/97 keyword CALIB added L.Tang
(See fastDataToIdl/get_fa_tsa.pro)
FUNCTION:
GET_FA_TSAH_HDR
DESCRIPTION:
function to load FAST TEAMS He survey header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Tms_He_Survey_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING '<NONE>' ; Name of proc to
; (Not implemeted)
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(86) ; Header bytes
CALLING SEQUENCE:
data = get_fa_tsah_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_tsah_hdr.pro 1.3 12 Jul 1996
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_tsah_hdr.pro)
FUNCTION:
GET_FA_TSOP_HDR
DESCRIPTION:
function to load FAST TEAMS HO survey header data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'Tms_HO_Survey_Packet_Hdr'; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; Project name
UNITS_NAME STRING 'Raw' ; Units of this data
VALUES_PROCEDURE STRING '<NONE>' ; Name of proc to
; (Not implemeted)
; get values from hdr
TIME DOUBLE 8.0118726e+08 ; Start Time of sample
BYTES BYTE Array(86) ; Header bytes
CALLING SEQUENCE:
data = get_fa_tsop_hdr (time)
ARGUMENTS:
time This argument gives a time handle from which
to take data from. It may be either a string
with the following possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
time will always be returned as a double
representing the actual data time found in
seconds since 1970.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_fa_tsop_hdr.pro 1.3 12 Jul 1996
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. June '95
(See fastDataToIdl/get_fa_tsop_hdr.pro)
FUNCTION: GET_FA_TSP DESCRIPTION: function to load FAST Teams survey proton species data from the SDT program shared memory buffers. A structure of the following format is returned: DATA_NAME STRING 'Tms Survey Proton' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Theta angle for bins PHI FLOAT Array(nnrgs, nbins) ; Phi angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta DPHI FLOAT Array(nbins) ; Delta Phi DOMEGA FLOAT Array(nbins) ; Solid angle for bins PT_LIMITS FLOAT Array(4) ; Angle min/max limits EFF FLOAT Array(nnrgs, nbins) ; Efficiency (GF) MASS DOUBLE 0.0104389 ; Mass eV/(km/sec)^2 GEOMFACTOR DOUBLE 0.0015 ; Bin GF HEADER_BYTES BYTE Array(86) ; Header bytes CALLING SEQUENCE: data = get_fa_tsp (time, [START=start | EN=en | ADVANCE=advance | RETREAT=retreat]) ARGUMENTS: time This argument gives a time handle from which to take data from. It may be either a string with the following possible formats: 'YY-MM-DD/HH:MM:SS.MSC' or 'HH:MM:SS' (use reference date) or a number, which will represent seconds since 1970 (must be a double > 94608000.D), or a hours from a reference time, if set. time will always be returned as a double representing the actual data time found in seconds since 1970. KEYWORDS: START If non-zero, get data from the start time of the data instance in the SDT buffers EN If non-zero, get data at the end time of the data instance in the SDT buffers ADVANCE If non-zero, advance to the next data point following the time input RETREAT If non-zero, retreat (reverse) to the previous data point before the time input RETURN VALUE: Upon success, the above structure is returned, with the valid tag set to 1. Upon failure, the valid tag will be 0. REVISION HISTORY: @(#)get_fa_tsp.pro 1.20 08/15/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. June '95 LAST MODIFICATION: eff added by Li Tang 10/21/96 Univ. of New Hampshire geomfactor = 0.0015 units_procedure = 'convert_tms_units' geom(nnrgs, nbins) 7/15/97 keyword CALIB added L.Tang
(See fastDataToIdl/get_fa_tsp.pro)
NAME: GET_FA_V158
PURPOSE: - To synthesize and return a structure containing the
component of the DC electric field perpendicular to the
V5-V8 boom direction.
CALLING SEQUENCE: v158 = get_fa_v158,t1, t2, NPTS=npts, START=st, EN=en, $
PANF=pf, PANB=pb, ALL = all, STORE = store,
STRUCTURE = v158s, SPIN = spin, REPAIR = repair,
DEFAULT = default
INPUTS: T1, T2 - times (strings or double precision seconds since 1970)
KEYWORD PARAMETERS: Just like GET_FA_FIELDS! Ok, with a couple
exceptions. There's no such thing as
uncalibrated data, for example.
OUTPUTS: V158 - a fields-type structure, containing V1-(V5+V8)/2 in
mV/m, UNLESS store is set, and then you get the TPLOT
string handle.
SIDE EFFECTS: If STORE is set, a quantity called 'V1-(V5+V8)/2' is
stored for TPLOT.
RESTRICTIONS: V4_S, V8_S, V1-V4_S, and V5-V8_S must all be loaded
in to SDT.
EXAMPLE: v158 = get_fa_v158('1997-08-26/01:00','1997-08-26/01:05')
MODIFICATION HISTORY: - Finally written 27-August-1997
by Bill Peria, UCB/SSL
(See fastDataToIdl/get_fa_v158.pro)
Takes all the same keywords as GET_FA_FIELDS, returns the mode as a function of time, in the requested format (fields structure or stored for TPLOT)
(See fastDataToIdl/get_fields_mode.pro)
FUNCTION:
GET_V1_V4_SURV
DESCRIPTION:
function to load FAST V1-V4 Survey fields data from the SDT program
shared memory buffers.
At structure of the following format is returned:
DATA_NAME STRING 'V1-V4 S' ; Data Quantity name
VALID INT 1 ; Data valid flag
PROJECT_NAME STRING 'FAST' ; project name
UNITS_NAME STRING 'Counts' ; Units of this data
UNITS_PROCEDURE STRING 'proc' ; Units conversion proc
START_TIME DOUBLE 8.0118726e+08 ; Start Time of sample
END_TIME DOUBLE 7.9850884e+08 ; End time of sample
NPTS INT npts ; Number of time samples
NCOMP INT 1 ; Number of components
DEPTH INT 1 ; depth of component
TIME DOUBLE Array(npts) ; timetags
DATA FLOAT Array(npts) ; Data qauantities
HEADER_BYTES BYTE Array(1) ; Header bytes (not implemented)
CALLING SEQUENCE:
data = get_v1_v4_SURV (time1, time2, [NPTS=npts], [START=st | EN=en |
PANF=panf | PANB = panb])
ARGUMENTS:
time1 This argument gives the start time from
which to take data, or, if START or EN keywords
are non-zero, the length of time to take data.
It may be either a string with the following
possible formats:
'YY-MM-DD/HH:MM:SS.MSC' or
'HH:MM:SS' (use reference date)
or a number, which will represent seconds
since 1970 (must be a double > 94608000.D), or
a hours from a reference time, if set.
Time will always be returned as a double
representing the actual data start time found
in seconds since 1970.
time2 The same as time1, except it represents the
end time.
If the NPTS, START, EN, PANF or PANB keywords
are non-zero, THEN time2 will be ignored as an
input paramter.
KEYWORDS:
Data time selection is determined from the keywords as given in the
following truth table (NZ == non-zero):
|ALL |NPTS |START| EN |PANF |PANB |selection |use time1|use time2|
|----|-----|-----|-----|-----|-----|---------------------------|---------|---------|
| NZ | 0 | 0 | 0 | 0 | 0 | start -> end | X | X |
| 0 | 0 | 0 | 0 | 0 | 0 | time1 -> time2 | X | X |
| 0 | 0 | NZ | 0 | 0 | 0 | start -> time1 secs | X | |
| 0 | 0 | 0 | NZ | 0 | 0 | end-time1 secs -> end | X | |
| 0 | 0 | 0 | 0 | NZ | 0 | pan fwd from time1->time2 | X | X |
| 0 | 0 | 0 | 0 | 0 | NZ | pan back from time1->time2| X | X |
| 0 | NZ | 0 | 0 | 0 | 0 | time1 -> time1+npts | X | |
| 0 | NZ | NZ | 0 | 0 | 0 | start -> start+npts | | |
| 0 | NZ | 0 | NZ | 0 | 0 | end-npts -> end | | |
Any other combination of keywords is not allowed.
RETURN VALUE:
Upon success, the above structure is returned, with the valid tag
set to 1. Upon failure, the valid tag will be 0.
REVISION HISTORY:
@(#)get_v1_v4_surv.pro 1.4 06/19/96
Originally written by Jonathan M. Loran, University of
California at Berkeley, Space Sciences Lab. Jan '96
(See fastDataToIdl/get_v1_v4_surv.pro)
PROCEDURE: make_array_struct PURPOSE: Makes an array of structures from input function, output used by get_array_struc.pro INPUT: data_str, a string (either 'eh','pl','fa_eesa_surv','fa_ess', ...) where get_'string' returns a 2D or 3D data structure KEYWORDS: CREATED BY: J.McFadden VERSION: 1 LAST MODIFICATION: 96-11-7 McFadden MOD HISTORY: NOTES: Used to make an array of structures that is called by get_array_struc.pro Current version only works for FAST Written to speed up summary plot production for ees and ies
(See fastDataToIdl/batch/make_array_struc.pro)
NAME: make_fa_esa_struct PURPOSE: Build an esa dat structure given dimentions CALLING SEQUENCE: dat=make_fa_esa_struct(dimsizes) INPUTS: dimsizes: a two (or three) dimensional array OUTPUTS: A structure of the following format is returned: DATA_NAME STRING 'data name' ; Data Quantity name VALID INT 1 ; Data valid flag PROJECT_NAME STRING 'FAST' ; project name UNITS_NAME STRING 'Counts' ; Units of this data UNITS_PROCEDURE STRING 'proc' ; Units conversion proc TIME DOUBLE 8.0118726e+08 ; Start Time of sample END_TIME DOUBLE 7.9850884e+08 ; End time of sample INTEG_T DOUBLE 3.0000000 ; Integration time NBINS INT nbins ; Number of angle bins NENERGY INT nnrgs ; Number of energy bins DATA FLOAT Array(nnrgs, nbins) ; Data qauantities ENERGY FLOAT Array(nnrgs, nbins) ; Energy steps THETA FLOAT Array(nnrgs, nbins) ; Angle for bins GEOM FLOAT Array(nbins) ; Geometry factor DENERGY FLOAT Array(nnrgs, nbins) ; Energies for bins DTHETA FLOAT Array(nbins) ; Delta Theta EFF FLOAT Array(nnrgs) ; Efficiency (GF) MASS DOUBLE 5.68566e-6 ; Particle Mass GEOMFACTOR DOUBLE 0.000147 ; Bin GF HEADER_BYTES BYTE Array(44) ; Header bytes INDEX LONG idx ; Index in sdt buffers MODIFICATION HISTORY: @(#)make_fa_esa_struct.pro 1.1 05/30/97 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. May '97
(See fastDataToIdl/make_fa_esa_struct.pro)
CLASS: sybcon
FUNCTION: sybcon()
PURPOSE:
Create an instance of the sybcon class to manage
a connection to a sybase server.
METHODS:
sybcon::INIT
sybcon::send
sybcon::fetch
sybcon::results
sybcon::cleanup
DESTRUCTOR:
sybclose, con
obj_destroy, con
both have the same functionality. If con is not destroyed, this
will cause a 'connection leak' which will eventually
fill up all available connections on the server.
INPUT: no inputs
OUTPUT:
a pointer to a sybcon class instance.
KEYWORDS:
config - name of database config file.
$FASTCONFIG/fast_archive.conf used by default.
appname - appname to use for connection. Default: 'idl'
CALLING SEQUENCE:
con = sybcon()
print, con->send('select start, finish from orbits where orbit = 500')
print, con->fetch(orbittime)
print, time_string(orbittime.start)
print, time_string(orbittime.finish)
sybclose, con
CREATED BY: Ken Bromund Dec 1997
(See fastDataToIdl/database/sybcon.pro)
FUNCTION: sybcon::fetch(row)
Class: sybcon
Method: fetch
Fetches a row of result set after sybcon::send or sybcon::results
returns > 0. Must be called until returns 0 before calling
sybcon::results to process next result set in batch.
result:
1 - row successfully fetched
0 - no more rows.
< 0 - error.
parameters:
row - named variable in which to store the structure
containing the row result.
(See fastDataToIdl/database/sybcon__fetch.pro)
FUNCTION: sybcon::results(name)
Class: sybcon
Method: results
For second and subsequent result sets produced by SQL batch sent with the
sybcon::send method, sybcon::results creates a structure internal
to the class to recieve the result columns.
Structure tags will correspond to
result column names. Unnamed columns will be tagged "col#" where
'#' is the number of the column. Supply the name argument
if you want to fetch data into a named structure.
result:
> 0 - number of columns in result set.
0 - no results to fetch.
< 0 - error, or no more results.
parameters:
name - name for named structure in which fetch rows will be returned.
Optional.
(See fastDataToIdl/database/sybcon__results.pro)
FUNCTION: sybcon::send(comm, name)
Class: sybcon
Method: send
sends sql batch to server, creates a structure internal to the class to
recieve the result columns. Structure tags will correspond to
result column names. Unnamed columns will be tagged "col#" where
'#' is the number of the column. Supply the name argument
if you want to fetch data into a named structure.
result:
> 0 - number of columns in result set.
0 - no results to fetch.
< 0 - error.
parameters:
comm - string containing sql command to send
name - name for named structure in which fetch rows will be returned.
Optional.
(See fastDataToIdl/database/sybcon__send.pro)
PROCEDURE: tms_himass_get_angles DESCRIPTION: Procedure to return the theta and phi arrays for TEAMS HiMass data CALLING SEQUENCE: tms_himass_get_angles, theta, dtheta, phi, dphi ARGUMENTS: theta: the returned array of theta angles vs bins dtheta: the returned array of delta theta angles vs bins phi: the returned array of phi angles vs bins dphi: the returned array of delta phi angles vs bins REVISION HISTORY: @(#)tms_himass_get_angles.pro 1.1 08/16/95 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '95
(See fastDataToIdl/tms_himass_get_angles.pro)
FUNCTION: tms_himass_get_masses DESCRIPTION: Procedure to return the mass for TEAMS HiMass data for a given mass bin CALLING SEQUENCE: ret = tms_himass_get_masses (mass, dmass, bin) ARGUMENTS: bin: the bin to get mass for mass: the returned array of mass angles vs bins dmass: the returned array of delta mass angles vs bins RETURN VALUE: Upon success 0 is returned. Upon failure, -1 is returned. REVISION HISTORY: @(#)tms_himass_get_masses.pro 1.1 08/16/95 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '95
(See fastDataToIdl/tms_himass_get_masses.pro)
PROCEDURE: tms_surv_get_angles DESCRIPTION: Procedure to return the theta and phi arrays for TEAMS survey data CALLING SEQUENCE: tms_surv_get_angles, theta, dtheta, phi, dphi ARGUMENTS: theta: the returned array of theta angles vs bins dtheta: the returned array of delta theta angles vs bins phi: the returned array of phi angles vs bins dphi: the returned array of delta phi angles vs bins REVISION HISTORY: @(#)tms_surv_get_angles.pro 1.1 08/16/95 Originally written by Jonathan M. Loran, University of California at Berkeley, Space Sciences Lab. Aug '95
(See fastDataToIdl/tms_surv_get_angles.pro)
PRO: update_fa_att, start, finish NAME: update_fa_att PURPOSE: Update attitude rows in database with level 0 attitude from FDF files. INPUT: start Any time acceptable by time_string() finish Any time acceptable by time_string() KEYWORDS: null update only null rows. NOTE: Affects events_data table. Uses $FASTCONFIG/fast_dbupdate.conf file to get user, password, and database name to access the database to update.
(See fastDataToIdl/database/update_fa_att.pro)
PROCEDURE: fast_elec_summary.pro PURPOSE: Generates a summary plot of FAST electron data for tplot. Plot 1: Electron Differential Energy Flux vs Energy, 0-45 deg pitch angle Plot 2: Electron Differential Energy Flux vs Energy, 45-135 deg pitch angle Plot 3: Electron Differential Energy Flux vs Energy, 135-180 deg pitch angle Plot 4: Electron Differential Energy Flux vs Pitch Angle, < 1 keV Plot 5: Electron Differential Energy Flux vs Pitch Angle, > 1 keV Plot 6: Electron Energy Flux Plot 7: Electron Flux CREATED BY: J.McFadden VERSION: 1 LAST MODIFICATION: 96/06/20 MOD HISTORY:
(See fastDataToIdl/batch/version.pro)
PROCEDURE: fast_elec_summary.pro PURPOSE: Generates a summary plot of FAST electron data for tplot. Plot 1: Electron Differential Energy Flux vs Energy, 0-45 deg pitch angle Plot 2: Electron Differential Energy Flux vs Energy, 45-135 deg pitch angle Plot 3: Electron Differential Energy Flux vs Energy, 135-180 deg pitch angle Plot 4: Electron Differential Energy Flux vs Pitch Angle, < 1 keV Plot 5: Electron Differential Energy Flux vs Pitch Angle, > 1 keV Plot 6: Electron Energy Flux Plot 7: Electron Flux CREATED BY: J.McFadden VERSION: 1 LAST MODIFICATION: 96/06/20 MOD HISTORY:
(See fastDataToIdl/batch/version2.pro)