load_mp

Loads master pointing data into keyword names for master pointing DRMS series. More...

Functions
void	check_oldrec_tstop_time (char query[HKLMP_MAX_QUERY_STR], char mp_tstart_value[HKLMP_PACKET_TIME_STR])
int	DoIt (void)
int	get_aiaiss12status_keywords (DRMS_Record_t *record, TIME *p_hkvals, char hk_time_val[HKLMP_PACKET_TIME_STR])
int	get_aiaiss34status_keywords (DRMS_Record_t *record, TIME *p_hkvals, char hk_time_val[HKLMP_PACKET_TIME_STR])
int	get_hmiissstatus_keywords (DRMS_Record_t *record, TIME *p_hkvals, char hk_time_val[HKLMP_PACKET_TIME_STR])
int	get_hmilegstatus_keywords (DRMS_Record_t *record, TIME *p_hkvals, char hk_time_val[HKLMP_PACKET_TIME_STR])
void	my_usage (void)
int	nice_intro (void)
int	set_image_loc_values (DRMS_Record_t *record, char *seriesname, TIME *ptr_tstart, char mp_tstart_str[HKLMP_PACKET_TIME_STR], TIME *ptr_hkvals, char hk_time_val_str[HKLMP_PACKET_TIME_STR], char im_loc_fn[HKLMP_MAX_DIR_FILE_NAME])
int	set_mp_version (char *seriesname, char tstart_str[HKLMP_PACKET_TIME_STR])
TIME	set_tstop_value (char *seriesname, char tstart_str[HKLMP_PACKET_TIME_STR], TIME *ptstart)
void	sprint_time (char *at, TIME t, char *zone, int precision)
	Converts an internal representation of time into a string representation of time.
void	update_tstop_version (char query[HKLMP_MAX_QUERY_STR], char mp_tstart_value[HKLMP_PACKET_TIME_STR])
Variables
ModuleArgs_t *	ggModArgs
ModuleArgs_t	module_args []
	Global DRMS-module structure representing the default command-line arguments for a DRMS module.
char *	module_name
	Global DRMS-module string providing the name of the module.

---

Detailed Description

Loads master pointing data into keyword names for master pointing DRMS series.

Synopsis:

   load_mp -h
   load_mp  ilf=<full path to image location file text file> 

Loads master pointing data into keyword names for master pointing DRMS series. The data is loaded from a image location text file and 4 DRMS series. The image location text file contains both HMI and AIA image location data. The HMI image location keyword data will be x, y, imscale and instrot data for carmera 1 and 2. The AIA image location keyword data will be x, y, imscale and instrot data for the different wavelenghts. The 4 DRMS series used to get keyword data and load into the master pointing DRMS series includes the following series:hmi.leg_status, hmi.iss_status, aia.iss_1_2_status and aia.iss_3_4_status. The record to get data for each series is the HK_VALS keyword value which is found in the image location text file. The prime index keyword for the master pointer series is T_START keyword. This T_START values is set with the value in the image location text file(i.e.,image_location.txt file). The DATE keyword value is updated when updating a record's values or when create new record. The DATE is set to current time when update occurred.

The VERSION keyword is used to determine if the record in master pointing DRMS series has been updated except for the latest record. For example if a record has been updated 5 times the version value will be 5. The latest record's version is always set to 0 even when updated. When a newer latest record is added, then the previous latest record is set to version 1 and the newer latest record's version is 0.

The T_STOP keyword for the first record in the master pointing DRMS series is intially set using the value in image location text file. As new records get added the T_STOP values is determined by where this new record is added in the master pointing series. The master pointing DRMS series is sorted by index T_START time. So when insert update to record or add a new record, the T_STOP values is determined by the next records T_START time or if this record is the latest record then use the T_STOP time in the image location text file.

The debug messages for C code can be turned on by compiling with -DDEBUG_LOAD_MP. Here is example of adding flag to ICC_CF_ICCCOMP line in make_basic.mk. This will turn on debug messages. ICC_CF_ICCCOMP = -DDEBUG_LOAD_MP

The setup of the environment variables in file SOURCE_ENV_FOR_LOAD_MP tells executable the name of the master pointing series to write keyword values. The environment variables tell executable the names of series to get data from to use to set aia iss data and hmi iss and leg data in the master pointing series. The are a few variable used to point to housekeeping configuration information. The setup of the SOURCE file to use is in executable code using define variable ENVFILE. Here are example settings of the variables in file.

setenv HK_CONFIG_DIRECTORY /home/production/cvs/TBL_JSOC/lev0/hk_config_file/ setenv HK_GTCIDS_FILE gtcids.txt setenv HK_SHCIDS_DIRECTORY /home/production/cvs/TBL_JSOC/lev0/sdo_hk_config_file/ setenv HK_SHCIDS_FILE shcids.txt setenv HK_LMP_MP_SERIESNAME sdo.master_pointing setenv HK_LMP_HMI_ISS_SERIESNAME hmi.iss_status setenv HK_LMP_HMI_LEG_SERIESNAME hmi.leg_status setenv HK_LMP_AIA_ISS12_SERIESNAME aia.iss_1_2_status setenv HK_LMP_AIA_ISS34_SERIESNAME aia.iss_3_4_status

The ilf parameter is a mandatory argument which should contain the directory and filename of the image location text file. The image location text file T_START, T_STOP, T_HKVALS UTC times(i.e., 2009.08.11_17:00:00.00_UTC). The image location text files contains the list of keywords to retrieve from drms data series to the set in the master pointing drms series. The image location text files contain the VERSION setting.

Flags:

-h: Shows usage message.

Parameters:

ilf

The full directory path and file name to image location text file(required field).

Example of running script:

   load_mp  ilf=/home/production/cvs/TBL_JSOC/lev1/image_loc_file/image_location.txt

Example of running script debug conditional compile flag turned on:

   load_mp   ilf=/home/production/cvs/TBL_JSOC/lev1/image_loc_file/image_location.txt > Debug-Log

Example of running help:

   load_mp -h