Document title: Text_describing_the_analysis_software.txt for the NDADS DE EICS datatype Project: DE NDADS Datatype: EICS Super-EID: DOCUMENT There may be other documents also identified by this super-EID. NDADS filename: EICS_TEXT_DESCRIBING_ANALYSIS_SOFTWARE.TXT TRF entry B46583.txt in NSSDC's controlled digital document library, Feb. 1998. Document text follows: ---------------------- TEXT_DESCRIBING_THE_ANALYSIS_SOFTWARE.TXT W.K. Peterson July, 1989 modified by S.A. Boardsen July,1993 Documentation on the general purpose EICS analysis program to be provided to read the SATF and return geophysical parameters. In order to get EICS software see DE HOLDINGS file. Information on how to compile and link the software is locate in file EICS_NOTES.TEX. The program EICS.EXE returns velocity space densities, fluxes, or count rates for the various ion species sampled, running under the VMS operating system. If EICS.EXE does not execute, contact NSSDC for the EICS software source code and linking instructions. However NSSDC does not guarantee to maintain the software against changes in operating environments. The output of the EICS.EXE program is explained by the file ANNOTATED_OUTPUT_LISTING.TXT. SCENARIO FOR PROCESSING EICS DATA It is assumed that the user has requested and obtained the SATF data files the user wants to analyze. The data files used in the examples below are EICS_84004A_1416_1616_T76.DAT EICS_84006B_0600_0620_T146.DAT An example of the inputs to this program to produce a listing of the velocity_space densities and standard deviations in 8 equally spaced pitch angle ranges for all ion species sampled between 0605 and 0610 on January 6, 1984 is shown below. +----------------------------------------------------------------------------- -+ | | | 1. Filename EICS_84006B_0600_0620_T146.DAT | | 9. 8 angular bins | | 2. Start: 84006:06:05:00 = 21900 | | 10. Select normal pitch angle | | 3. Stop: 84006:06:10:00 = 22400 | | 11. Don't use filter | | 4. Single time interval | | 12. Use first M/Q values found | | 5. no specific mode selected | | | | | | 6. Use MD2 13. Don't write any plot information | | | | | | 7. No ED specified 14. Print now | | | | 8. Accumulate 15 STD ESA and 15. Final output: Velocity Space | | 16 STD RPA channels (no ED) | +----------------------------------------------------------------------------- -+ Enter -1 or to quit EICS. Enter menu # to change or 0 to accumulate with the above parameters: The plot file referred to in item 13 above is an ASCII file that is readable by code created at Lockheed using Version 5.0 of high level graphics language DI-3000 to create line plots. While the basic fortran calls to DI-3000 routines have remained constant, successive versions have required development of new procedures to 'LINK' EICS fortran and pascal code with DI-3000 code. We will therefore not transfer graphics code to the NSSDC because of the indeterminate labor costs associated with establishing and supporting interfaces to high level graphics languages in unknown and changing environments. Below the various options in the above menu are explained and an annotated listing of the output is given. Narrative description of options (questions) associated with the EICS.EXE program. >>To run the code from the optical device use the commands $run EICS.EXE Interactive? (Y/N): >>answer y and you get the following y Error 29 on opening the file in subroutine opencfile. >> The screen is cleared and the following display appears. +----------------------------------------------------------------------------- -+ | | | 1. Filename Your_current_default_disk_and_directory:EICSDATA.DAT | | 9. 8 angular bins | | 2. Start: 00000:00:00:00 = 00000 | | 10. Select normal pitch angle | | 3. Stop: 00000:00:00:00 = 00000 | | 11. Don't use filter | | 4. Single time interval | | 12. Use first M/Q values found | | 5. no specific mode selected | | | | | | 6. Use MD2 13. Don't write any plot information | | | | 7. No ED specified 14. Print now | | | | 8. Accumulate 15 STD ESA and 15. Final output: Flux | | 16 STD RPA channels (no ED) | +----------------------------------------------------------------------------- -+ Enter -1 or to quit EICS. Enter menu # to change or 0 to accumulate with the above parameters: >>You now must enter a VALID FILE NAME: ENTER 1 followed by a CR >>which returns the prompt in the bottom scrolling area of screen: Enter file name: >>If you enter an invalid file name (such as file_not_there.dat) >>you get the error: Error 29 on opening the file in subroutine opencfile. Error - file file_not_there.dat not found >> when a valid file name such as EICS_84004A_1416_1616_T76.DAT >>is entered the file and its start time and stop times are entered on >>the full page display as illustrated below. +----------------------------------------------------------------------------- -+ | | | 1. Filename EICS_84004A_1416_1616_T76.DAT | | 9. 8 angular bins | | 2. Start: 84004:14:16:12.996 = 51373 | | 10. Select normal pitch angle | | 3. Stop: 84004:16:15:49.102 = 58549 | | etc | | | +----------------------------------------------------------------------------- -| Enter -1 or to quit EICS. Enter menu # to change or 0 to accumulate with the above parameters: >>At this point you can enter a 0 and data for the time range 84004:14:16:12.996 >>to 84004:16:15:49.102 on day 4 (January 4) of 1984 will be accumulated and written >>to file FOR108.DAT in your current working directory. The structure of >>the output file is discussed below. >> If the you want to accumulate data for a shorter interval, use fewer >>angular bins, etc. you can select menu #s 2 to 15. >> >> >>OPTIONS 2 and 3 change the time interval and provide for a series of regular >>accumulation intervals. The basic prompt is: Enter starting date or -1 to quit [84004]: >>-1 will cause the program to terminate. >>a return will set the date to the value in brackets 84004 in this case. >>You are next prompted: Enter time in seconds, hh:mm:ss, hh:mm or "MS=" : >>valid responses to this are for example: >> 15:10:00 >> 15:10 >> 15: >> 48123 >> MS=49143123 >>which will start (or end) the accumulation at the following times given in >>seconds of the day 54600, 54600, 54000, 48123, and 49143.123 >>Note that the program starts or stops the accumulation at intervals of 1/16 >>of the basic 8 second telemetry block or 0.5 seconds. >> >>OPTION 4 determines if a single of multiple accumulations are to be >>made. Selecting Menu item # 4 returns the prompt: Measure time in [S]pins per interval, instrument [C]ycles, or use a single [T]ime interval? (SCT) [T]: >> Selecting S gives the following prompt: Enter # of spins/interval: >> Selecting C gives the prompt: Enter # of cycles/interval: >> >> Each spin period is six (6) seconds. EICS modes have cycle times of >> 4, 16, 20, and 32 spin periods. You can select any number greater >>than 1 and less than or equal to 999. The program will accumulate >>data for the specified number of EICS mode cycles or satellite spin >>periods, provide the output specified by options 13,14, and 15 for >>successive intervals starting and stoping at the times specified by >>options 2 and 3. >> >>OPTION 5 is used to select specific EICS mode types. For normal data >>processing the default is appropriate. >>Selecting option 5 returns the following output: Mode type codes: -1: no specific mode selected 0: all modes 1: run mode 2: run drum modes 3: LOSC mode 4: LODM mode Enter mode type [-1]: >> >>OPTION 6 selects one of two detector threshold settings. For normal >>data processing the default is appropriate. Selecting >>option 6 returns: Enter 1 or 2 for MD1 or MD2 [2]: >> >>OPTION 7 selects one of the two non-mass resolving 'energy detectors', >>only one of which is operated in each EICS mode. For normal data >>processing the default is appropriate. Selecting >>option 7 gives the following prompt. Enter 1 for ED1, 2 for ED2, 0 or for unspecified ED: >> >>Option 8 selects one of three possible sets of energy bins. In >>some non-standard modes the EICS instrument returns data from 64 >>discrete energy ranges. For normal data the default <15 STD ESA ..etc> >>is appropriate. Selecting Selecting option 8 returns the following >>prompt. Accumulation codes: E: 32 ESA energy channels R: 32 RPA energy channels S: 15 STD ESA and 16 STD RPA channels Enter accumulation code [S]: >> >>Note selecting options E or R will change the format of the output >>listing (Option 14). >> >> >>OPTION 9 selects one of 64 possible angular resolutions. The default >>is to 'bin' the data into eight (8) angular bins. Because EICS >>counting rates are at times low it is sometimes useful to select >>less than 8 angular bins. Selecting option 9 gives the following >>prompt: Enter number of angular bins (1-64) [8]: >>The response to this prompt is self evident. All of the angular bins >>are uniformly spaced. >> >>Option 10 is used to select the 'type' of angular sorting to be done. >>The default