Running the TIDE level-zero software standalone: The software is on griffin. The processing software is /export/data2/tide/smry_plt/tide_lz The software prompts the user for the name of the parameter file and the name of the list file. The parameter file indicates what processing is to be done and contains all information associated with that request. New parameter files are created by running /export/data2/tide/smry_plt/lz_parm The list file contains the start and stop times for the run plus the name and location of the TIDE level-zero file(s), POLAR orbit and attitude file(s), the mask file, the spacecraft potential file, the peaks location file, and/or the mfe magnetic field data file. Note: Only those files needed for processing should be included in the list file. Include the fully qualified pathname of each file. The first line contains the start time. The second line contains the stop time. Times are in UT on a 24-hour clock. The format of each line can be any of the following: mm/dd/yy hh:mm:ss mm/dd/yy hh:mm:ss UT mm-dd-yy hh:mm:ss mm-dd-yy hh:mm:ss UT Each filename line has a number in the first column indicating the type of file: 1 - level-zero, 2 - orbit, 3 - attitude, 4 - mask, 5 - spacecraft potential, 6 - peaks location file, 7 - mfe magnetic field file. The output created by tide_lz will vary depending on the processing done. The format for the filename is either tyymmddh1m1_h2m2.ext or tyymmddh1m1_h2m2_mm.ext where yymmdd is the start date, h1m1 is the start time, and h2m2 is the stop time. If the file contains data for a single mass, mm is the mass to charge ratio of the ion or it is 00 for Singles or sp for Stops. The extention is a brief indication of the content of the file. Possible extensions include: ext file type -------- ------------------------------------------------------------------- err message/error file - contains information about the processing esp chromogram - energy on horizontal axis, spin angle on vertical axis, color based on polar angle, each panel is a mass sep chromogram - spin angle on horizontal axis, energy on vertical axis, color based on polar angle, each panel is a mass pes chromogram - polar angle on horizontal axis, energy on vertical axis, color based on spin angle, each panel is a mass pse chromogram - polar angle on horizontal axis, spin angle on vertical axis, color based on energy, each panel is a mass espm spectrogram - energy on horizontal axis, spin angle on vertical axis, the panels are polar angle channels, one mass per page esmp spectrogram - energy on horizontal axis, spin angle on vertical axis, the panels are masses, one polar angle channel per page sepm spectrogram - spin angle on horizontal axis, energy on vertical axis, the panels are polar angle channels, one mass per page semp spectrogram - spin angle on horizontal axis, energy on vertical axis, the panels are masses, one polar angle channel per page esse spectrogram - energy/spin and spin/spin energy panels for Stops plus orbit information ehtr high time resolution spectrograms - counts summed over spin and polar angle and display as a function of energy and time, each panel is a mass shtr high time resolution spectrograms - counts summed over energy and polar angle and display as a function of spin angle and time, each panel is a mass phtr high time resolution spectrograms - counts summed over energy and spin angle and display as a function of polar angle and time, each panel is a mass esphtr high time resolution spectrograms - one mass per page, panels are all three types of htr spectrograms eshtr high time resolution spectrograms - one mass per page, panels are energy and spin angle htr spectrograms mom moments text file psd phase space density velocity distribution plots eng TIDE engineering data text display ip TIDE instrument parameters text display mir_rat text file containing TIDE mirror ratios bfld magnetic azimuth and elevation data hk TIDE housekeeping bytes hk_tid TIDE housekeeping data hk_psi PSI housekeeping data sg_de direct-event spectrogram de_sum summed direct-event summary spectrogram de_chn direct-event text file for channel n mss_avg ion counts summed over energy and spin angle mss_sum ion counts summed over energy and both spin and polar angle mss_chn ion count rates for channel n db_spn database spin table information db_hk database housekeeping table information dmp telemetry byte dumps Once tide_lz has run IDL is used to plot the results. There are a series of IDL command files that can be used to plot the basic plot types: command file plot type -------- ------------------------------------------------------------------ chromo creates chromogram plots esse creates energy/spin - spin/energy spectrogram plots htr creates high time resolution spectrogram plots mass_avg creates line plots of ion counts summed over energy and spin angle mom creates moments line plots movie creates velocity distribution parallel plane with orbit plots spect creates mass or channel spectrogram plots survey creates multi-panel velocity distribution plots vel2p creates velocity distribution plots with 2 parallel planes velpp creates velocity distribution plots with a perperdicular and parallel plane These plots need to be copied from /export/data2/tide/smry_plt to the directory where you run tide_lz from. Once in IDL, the command files are run using the IDL @filename command. Some of the summary plots are not run from command files. They are standalone IDL procedures. To run them, you either have to specify the full pathname or copy the procedures. They are run from IDL using the .run command. IDL Procedure plot type ----------------- ---------------------------------------- de_spect.pro direct-event spectrograms de_sum_spect.pro summed direct-event summary spectrograms mirror_ratios.pro line plots of mirror_ratios plot_mask.pro 3-D surface plot of ion masks psi_hk_smry.pro PSI housekeeping summary plot tide_hk_smry.pro TIDE housekeeping summary plot