Summaries of Codes for TIMAS Investigators
F
POLAR/TIMAS Available Data Analysis Programs
1.) Supporting and Diagnostic Routines
2.) CDF KP Reading and Plotting Routines.
3.) TIMAS Data Productes
a.) Diagnostic Routines
b.) Plot Routines
1.) Supporting and Diagnostic Programs:
juke_to_disk
Location: /timas/local/scripts/juke_to_disk (LM)
Location: /home/kjt/program/timas/exe (MSSL)
Purpose: copies L0 data files from juke box to disk
To use: juke_to_disk mm dd yy destination_directory
Output: Files
dp_in_spin
Location: /timas/code/trial_apps/dp_in_spin (LM)
Location: -- (MSSL)
Purpose: list the names of all the data products which were found in each spin
To use: dp_in_spin CD date-4/7/96 time-05:00:00 dtime-00:02:30
Output: numbers only
30 094 07-Apr-1997 05:05:06 0 / MRDF1A MRDF1B MRDF2A MRDF2B
MRDF4A MRDF4B PAD1A PAD1B PAD2A PAD2B FEC PEC BCR
fec_survey
Location: /timas/code/trial_apps/fec_survey (LM)
Location: - (MSSL)
Purpose: survey of FEC total counts/spin averaged over each super-spin
To use: fec_survey CD date-4/7/96 time-05:00:00 dsecs-600
Output: numbers only
FEC 219.0 208.6 209.7 223.9 226.9 235.9 247.1 270.9 313.2 ...
FEC 374.9 349.4 374.2 416.2 424.5 411.8 444.9 522.0 570.8 ...
search_events
Location: /timas/code/trial_apps/mrdf_survey (LM)
Location: /home/kjt/program/timas/idl (MSSL)
Purpose: to identify periods of interest. The orbit files will be analysed
to find certain L, R or LT ranges. Use together with MRDF_SURVEY
To use: IDL, search_event
Output: file
2.) CDF KP Read routines:
cdf_walk
Location: /timas/code/cdf/cdf25-dist/bin/cdfwalk (LM)
Location: /home/kjt/program/timas/cdf25-dist/bin (MSSL)
Purpose: steps threw a cdf file record by record.
To use: interactive menu
Output: numbers on screen only
plot_cdf.pro
Location: /timas/code/trial_apps/kp_plot_bill (LM)
Location: -- (MSSL)
Purpose: reads and plots a sub set of parameters in Timas kp cdf files.
one day plots of densities and temperatures.
To use: IDL, plot_cdf,'filename','x'
e.g. plot_cdf,'po_k0_tim_19960407_v02.cdf','ps'
Output: IDL plots: GIF or PS files
Add. Info.: ftp://sierra.space.lockheed.com/DATA/timas/summary/index.html#KP
timas_kp_plot.pro
Location: /timas/code/trial_apps/kp_plot_bill (LM)
Location: -- (MSSL)
Purpose: reads and plots a sub set of parameters in Timas kp cdf files
one-day plots of ratios (available on the WEB)
To use: IDL, timas_kp_plot,'filename','x'
e.g. timas_kp_plot,'po_k0_tim_19960407_v02.cdf','ps'
Output: IDL plots: GIF or PS files
Add. Info.: ftp://sierra.space.lockheed.com/DATA/timas/summary/index.html#KP
timas_kp_velocity_plots
Location: /timas/code/trial_apps/kp_plot_bill (LM)
Location: -- (MSSL)
Purpose: reads and plots a sub set of parameters in Timas kp cdf files.
density and velocity components for short intervals from timas kp files
To use: IDL, timas_kp_velocity_plots,'filename','x'
e.g. timas_kp_velocity_plots,'po_k0_tim_19960407_v02.cdf','ps'
Output: IDL plots: GIF or PS files
3.) TIMAS Data Products:
a.) Diagnostic tools:
lrdf_avg
Location: /timas/code/trial_apps/lrdf_avg (LM)
Location: -- (MSSL)
Purpose: Read and averages lrdf data products over a specified
number of spins. Choose either head A or B for each ion, up
to 4 ion choices (H+, O+, He+, H++)
To use: lrdf_avg CD data_type-flux lrdf1a lrdf2b lrdf3b lrdf4a date-4/7/96
time-05:00:0 dsecs-400 spins-64 pabins-6 > !
lrdf_avg_960424_1653_1732.dat
Output: numbers only
view_dp
Location: /timas/code/release/exe (LM)
Location: /home/kjt/program/timas/exe (MSSL)
Purpose: view data products (raw data)
To use: view_dp CD mrdf date-4/29/96 time-05:00:00 dtime=-00:30:00
Output: numbers only
Documentation: see program_description in release
view_edp
Location: /timas/code/release/exe (LM)
Location: /home/kjt/program/timas/exe (MSSL)
Purpose: views extended data product (used get_dp)
To use: view_edp CD mrdf date-4/29/96 time-05:00:00 dsecs-12 > ! filname.dat
Output: numbers only
Documentation: see program_description in release
view_mrdf_moments
Location: /timas/code/release/exe (LM)
Location: /home/kjt/program/timas/exe (MSSL)
Purpose: calculates moments
To use: view_mrdf_moments CD mrdf date-4/7/96 time-05:00:00 dsecs-12
> ! filname.dat
Output: numbers only
Documentation: see program_description in release
ms_survey
Location: /timas/code/release/exe (LM)
Location: /home/kjt/program/timas/exe (MSSL)
Purpose: view mass steps
To use: ms_survey CD date-10/02/97 time-20:36:00 dsecs 400 | egrep
"^MS:" >! ms_971002.dat
Output: numbers only, to be read by ms.pro for IDL plots (WEB Plots)
Documentation: see program_description in release
flux_survey
Location: /timas/code/release/exe (LM)
Location: /home/kjt/program/timas/exe (MSSL)
Purpose: view flux values
To use: flux_survey CD mrdf date-4/7/96 time-05:00:00 dsecs-12 > ! filname.dat
Output: numbers only, to be read by flux.pro for IDL Plots (WEB Plots)
Documentation: see program_description in release
b.) Plot Programms:
ms_peaks
Location: /timas/code/trial_apps/ms_peak (LM)
Location: -- (MSSL)
Purpose: views mass spectra
To use: ms_peaks CD date-4/7/96 time-04:00:00 dsecs-12 RED icp-1
IDL, MS_PEAKS,/x (x-window) /p (PS file)
Output: IDL plots
mag_survey
Location: /timas/code/trial_apps/mag_survey (LM)
Location: -- (MSSL)
Purpose: To make magnetometer/time survey plots. Bx/Btot, By/Btot, Bz/Btot, Btot
To use: Call to request X-window and postscript output.
mag_survey,/x,/p,arg='CD date-1/8/97 time-7:0:0 dsecs-3600'
Other sample commands:
mag_survey,/x,arg='CD date-3/18/96' (full day survey)
Output: IDL plots:
mrdf_contour
Location: /timas/code/trial_apps/mrdf_contour (LM)
Location: -- (MSSL)
Purpose: To make velocity space density contour plots for up to three MRDF's.
Uses MRDF data only. Single spins only.
To use: IDL, mrdf_contour,'x','color'
mrdf_contour,'ps',''
Output: IDL plots: PS or GIF file
cntr_idf
Location: /timas/code/trial_apps/cntr_idf (LM)
Location: -- (MSSL)
Purpose: the three dimensional contour plot
To use: IDL, cntr_idf
You get prompted for the Input (Widget Based Input)
Output: IDL plots:
ms
Location: /timas/code/release/idl (LM)
Location: /home/kjt/program/timas/idl (MSSL)
Purpose: mass spectra plots from the ms_survey output......(check Web page)
To use: IDL
ms, 'color', 'ms_052196.dat', '' search for ephem file
ms, 'color', 'ms_052196.dat', 'none' no ephem file available, run anyway.
Output: IDL plots:
flux
Location: /timas/code/trial_apps/mrdf_survey (LM)
Location: /home/kjt/program/timas/idl (MSSL)
Purpose: Energy Time spectrograms of MRDF data from the flux_survey output
.......(check Web page)
To use: IDL
flux, 'color', 'flux_survey_960521.dat', ''
flux, 'color', 'flux_survey_960521.dat','none' (for no ephem)
Output: IDL plots:
mrdf_survey
Location: /timas/code/trial_apps/mrdf_survey (LM)
Location: /home/kjt/program/timas/idl (MSSL)
Purpose: Energy Time spectrograms of MRDF data
To use: IDL, mrdf_1
Output: IDL plots:
pitch
Location: /timas/code/trial_apps/mrdf_survey (LM)
Location: /home/kjt/program/timas/idl (MSSL)
Purpose: Pitch angle vs. Energy (or V(perp) vs. V(para) )
spectrorams of MRDF data
To use: IDL, pitch (Widget interface)
Output: IDL plots: PS, EPS or GIF
pa_survey
Location: /timas/code/trial_apps/pa_survey (LM)
Location: -- (MSSL)
Purpose: To make pitch-angle/time survey plots for three energy bands of H+ and O+.
The energy bands are contiguous and together cover the full energy range.
Sums over a requested number of spins.
Can display time periods of down to a few minutes.
To use: pa_survey,/x,arg='CD date-3/18/96 time-8/35/00 dsecs-300 pad spins-2
Output: IDL plots: PS or GIF
