load_m3sd

Loads minimum, maximum, mean and standard deviation for keywords over a interval of time into data series. More...

Synopsis:

   load_m3sd -h
   load_m3sd  in=<day filename> isf=<instruction file> 

Load minimum, maximum, mean and standard deviation(m3sd) values by first sending packet to functions in decode_hk.c file to get keyword values. Keywords are decoded using the the same functions that decodes hk keywords on high speed bus. This load_m3sd executable loops through all hk packets and sends data to be decoded to decode_hk.c's functions which returns a structure containing keyword names, keyword values, keyword type and keyword variable. load_m3sd executable then gets keyword values per interval of time and calculates the minimum, maximum, mean and standard deviation for keywords. Finally, load_m3sd executable writes to user defined keywords names with MIN, MAX, MEAN, and SD suffixed to each keyword name, the values to a DRMS data series. DRMS data series is based on value defined in the instruction file. The interval of time and the keywords to get values for are contained in the instruction file. The keywords in m3sd data series are loaded as floats. A requirement is to have a data series created before running this executable. This can be done by running script located in lev1/scripts called cm3sd_jsd_file.pl using the instruction file. This script will create the jsd file. After creating jsd file, then use create_series to implement data series in DRMS. An example on running this script is as follows: cm3sd_jsd_file.pl isf=/home/carl/cvs/TBL_JSOC/lev1/instruction_file/su_carl/hmitest1200_thermal_template.txt

A new update was added to read the previous day's dayfile and read the next day's dayfile(if exists) from the hk_dayfile series and get packet data values to correctly create the current dayfile processing of the previous day's last record and the current day's last record.

The in parameter is a mandatory argument which should contain the directory and filename of the input dayfile. Currently only one dayfile is allowed for the in parameter.

The isf parameter is mandatory argument. This is the full path to the instruction file. The instruction contains data series name, owner and author. The instruction file contains interval of time to use to calculate the minimum, maximum, mean and standard deviation for keywords. The current interval ranges tested are 60(seconds) to 7200(seconds). The instruction file contains the list of keywords. Each keyword is represented by a line containing the packet apid from which the keyword is contained. The line contains the Keyword:,apid value in decimal,long keyword name, and user defined name. Currently the user defined name should be 8 chararcters. User's can use short keyword name for user defined names. It is required to use the proper long keyword name that is contained in the HK Configuration file and STANFORD file. The line contains a user created keyword name. The user created names will have a MAX, MIN, MEAN or SD and suffixed to names(i.e.,TEMP1_MIN, TEMP1_MAX, TEMP1_MEAN, TEMP1_SD). View example instruction files at directory in CVS at /home/production/cvs/TBL_JSOC/lev1/instruction_file/su_carl.

Flags:

-h: Shows usage message.

Parameters:

	in	The full directoy path and file name to the input dayfile(required field).
	isf	The full directory path and file name to instruction file(required field).

Example of running script:

   load_m3sd  in=/home/production/dfile/20080918.0x0013 isf=/home/production/inst_file/instruction_file.txt

Example of running script debug conditional compile flag turned on:

   load_m3sd  in=/home/production/df/20080918.0x0013 isf=/home/production/inst_file/instr_file.txt > Debug-Log

Example of running help:

   load_m3sd -h