This page was created by IDL
lasco_mk_html_help.pro on
Wed Aug 17 12:21:59 2005.
NAME: ALL_NONOP_TEMPS PURPOSE: Reads in the SVM HK files, saved by DACS, and plots the non- operational (S/C monitored) temperatures for LASCO, UVCS, MDI, CELIAS CATEGORY: PACKETS CALLING SEQUENCE: ALL_NONOP_TEMPS,Td INPUTS: Td: Date string in form YYMMDD KEYWORD PARAMETERS: LASCO: If present then the LASCO temperatures will be plotted UVCS: If present then the UVCS temperatures will be plotted MDI: If present then the MDI temperatures will be plotted CELIAS: If present then the CELIAS temperatures will be plotted ALL: If present then all 4 instrument temperatures will be plotted PRINT: If present then the plot is sent to the printer MODIFICATION HISTORY: Written by: RAH, NRL, Dec 1994 @(#)all_nonop_temps.pro 1.2 03/08/97 LASCO IDL LIBRARY
NAME: BSV2ARCSEC PURPOSE: This procedure generates a file giving the conversion of the boresighter and PES from volts to arc seconds. CATEGORY: LASCO PACKETS CALLING SEQUENCE: BSV2ARCSEC INPUTS: None OUTPUTS: This procedure generates a file, in the current directory, containing the conversion of the BS and PES for each DN to voltages and to arc seconds. It also generates 4 plots on the screen of the BS-X, BS-Y, PES-X and the PES-Y. MODIFICATION HISTORY: Written by: RA Howard, NRL, 16 Mar 1996 @(#)bsv2arcsec.pro 1.2 09/22/96 LASCO IDL LIBRARY
NAME:
CNVRT_ABC
PURPOSE:
This function converts the LEB activity buffer codes to a string.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
Result = CNVRT_ABC (Abc)
INPUTS:
Abc: An integer giving the code value
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
None
OUTPUTS:
This function returns a string giving the conversion of the activity
buffer code value.
OPTIONAL OUTPUTS:
None
COMMON BLOCKS:
abc_common: Used to determine if the conversions have been read in
and to hold the conversion table for subsequent calls.
SIDE EFFECTS:
None
RESTRICTIONS:
None
PROCEDURE:
This routine reads in the conversion file (abc.inc) the first time
it is called. It then searches the activity buffer codes for a
match of the input code.
EXAMPLE:
MODIFICATION HISTORY:
1/13/94 SEP Changed to read buffer numbers and messages
@(#)cnvrt_ab.pro 1.1 01/27/98 LASCO IDL LIBRARY
NAME:
CNVRT_ABC
PURPOSE:
This function converts the LEB activity buffer codes to a string.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
Result = CNVRT_ABC (Abc)
INPUTS:
Abc: An integer giving the code value
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
None
OUTPUTS:
This function returns a string giving the conversion of the activity
buffer code value.
OPTIONAL OUTPUTS:
None
COMMON BLOCKS:
abc_common: Used to determine if the conversions have been read in
and to hold the conversion table for subsequent calls.
SIDE EFFECTS:
None
RESTRICTIONS:
None
PROCEDURE:
This routine reads in the conversion file (abc.inc) the first time
it is called. It then searches the activity buffer codes for a
match of the input code.
EXAMPLE:
MODIFICATION HISTORY:
1/13/94 SEP Changed to read buffer numbers and messages
7/26/01 DW Modified abc.inc and changed to handle numbers properly
@(#)cnvrt_abc.pro 1.3 11/05/01 LASCO IDL LIBRARY
NAME: CNVRT_CMD_CODE PURPOSE: This function converts LEB command codes to a string. CATEGORY: LASCO PACKETS CALLING SEQUENCE: Result = CNVRT_CMD_CODE (Cmd) INPUTS: Cmd: An integer giving the command code to be converted OPTIONAL INPUTS: None KEYWORD PARAMETERS: None OUTPUTS: This function returns a string containing the conversion of the command. OPTIONAL OUTPUTS: None COMMON BLOCKS: None SIDE EFFECTS: None RESTRICTIONS: None PROCEDURE: EXAMPLE: MODIFICATION HISTORY: Written by: RA Howard @(#)cnvrt_cmd_code.pro 1.1 01/27/98 LASCO IDL LIBRARY
NAME: CNVRT_CMD_DEST PURPOSE: This function converts LEB command destination address codes to a string. CATEGORY: LASCO PACKETS CALLING SEQUENCE: Result = CNVRT_CMD_DEST (Da) INPUTS: Da: An integer giving the command destination address code to be converted OPTIONAL INPUTS: None KEYWORD PARAMETERS: None OUTPUTS: This function returns a string containing the conversion of the destination address code. OPTIONAL OUTPUTS: None COMMON BLOCKS: None SIDE EFFECTS: None RESTRICTIONS: None PROCEDURE: defines from lcf.h EXAMPLE: MODIFICATION HISTORY: Written by: RA Howard @(#)cnvrt_cmd_dest.pro 1.1 01/27/98 LASCO IDL LIBRARY
NAME: CNVRT_CMD_ERR PURPOSE: This function converts LEB command error codes to a string. CATEGORY: LASCO PACKETS CALLING SEQUENCE: Result = CNVRT_CMD_ERR (Err) INPUTS: Err: An integer giving the command error code to be converted OPTIONAL INPUTS: None KEYWORD PARAMETERS: None OUTPUTS: This function returns a string containing the conversion of the command error code. OPTIONAL OUTPUTS: None COMMON BLOCKS: None SIDE EFFECTS: None RESTRICTIONS: None PROCEDURE: defines from lcf.h, the msbyte is used EXAMPLE: MODIFICATION HISTORY: Written by: RA Howard @(#)cnvrt_cmd_err.pro 1.1 01/27/98 LASCO IDL LIBRARY
NAME: CNVRT_CURRENT PURPOSE: This function converts DN to amps for various current monitors. CATEGORY: PACKETS CALLING SEQUENCE: Result = CNVRT_CURRENT (Dn_in, Curr_type) INPUTS: Dn_in: The raw DN value to be converted Curr_type: A parameter indicating the monitor type 0 = QI2P1B3, LASCO/VIRGO/GOLF 1 = QI3P1B3, EIT/SUMER/CELIAS 2 = QIL3, EIT 3 = QIL4, LASCO OUTPUTS: This function returns the converted current in amps. PROCEDURE: Uses calibration curves to perform the conversion EXAMPLE: To conver the LASCO spacecraft current monitor which has a DN value of 128: A = CNVRT_CURRENT (128,3) MODIFICATION HISTORY: Written by: R.A. Howard, 1994 @(#)cnvrt_current.pro 1.1 01/27/98 LASCO IDL LIBRARY
NAME:
CNVRT_TEMPS
PURPOSE:
This function converts the raw telemetry value associated with a
temperature monitor into degrees centigrade.
CATEGORY:
PACKETS
CALLING SEQUENCE:
Result = CNVRT_TEMPS (Dn_in, Temp_type)
INPUTS:
Dn_in: The raw telemetry value to be converted in DN (Integer)
Temp_type: An integer parameter indicating the type of
temperature monitor to be converted.
0 = camera cold finger
1 = camera on-chip to V
2 = zone thermistors (ice)
3 = COB thermistors (tce)
4 = s/c thermistors type 3
5 = s/c thermistors type 4
6 = s/c thermistors type 2
7 = s/c thermistors type 5
OUTPUTS:
This function returns the converted temperature value as a floating
point number in units of degrees centigrade.
PROCEDURE:
The appropriate calibration curve is applied to the telemetry monitor.
EXAMPLE:
To obtain the temperature of a zone thermistor:
T = CNVRT_TEMPS (128,2)
MODIFICATION HISTORY:
Written by: R.A. Howard, NRL, 1994
Jan 23, 1998 Ed Esfandiari - changed FOR loops counters to long.
Jan 27, 1998 Ed Esfandiari - Modified code to perform array
operations for better efficiency.
@(#)cnvrt_temps.pro 1.3 01/27/98 :LASCO IDL LIBRARY
@(#)emieit.pro 1.1 09/22/96 LASCO IDL LIBRARY
@(#)emilook.pro 1.1 09/22/96 LASCO IDL LIBRARY
@(#)emiview.pro 1.1 09/22/96 LASCO IDL LIBRARY
@(#)exp_fit.pro 1.1 09/22/96 LASCO IDL LIBRARY
@(#)exp_fit_prog.pro 1.1 09/22/96 LASCO IDL LIBRARY
NAME: FIX_DUP_PCKT PURPOSE: This function routine puts the housekeeping packets in time order and removes duplicate packets. CATEGORY: LASCO PACKETS CALLING SEQUENCE: Result = FIX_DUP_PCKT (Hk) INPUTS: HK: A 2D byte array containing the housekeeping packets OUTPUTS: Result: The cleaned up housekeeping packets. RESTRICTIONS: There should be only one packet type in the array. That is, the LASCO housekeeping packets should be broken down into the three separate packet types. PROCEDURE: The time structure is computed and for each day, the packets are first ordered by time within the day. Then, any packets that have the same time as the previous packet is deleted. As each day is processed the packets are concatenated to the end of the previous days. MODIFICATION HISTORY: Written by: R.A. Howard, NRL, 22 Mar 1996 @(#)fix_dup_pckt.pro 1.2 01/23/98 :LASCO IDL LIBRARY
pckt = array of packets from TLM stream generated by DACS organized
with time as the second dimension
firstday is the kday number of the first day in time
time is a floating array of the number of hours since firstday
cpu time is year, doy, hour, min, sec
word: 1, 2 , 3 , 4 , 5
modified for pckt in either bytes or words, 3 Mar 1996 RAH
22 Mar 1996 RAH, if byte packets, then assume read in with /no_hdr option
@(#)getcputime.pro 1.1 01/23/98 :LASCO IDL LIBRARY
hk = array of all monitors from HK TLM stream generated by DACS
pcktnum is a number from 1 to 3 indicating one of the three HK packet
types
When Who What
Dec 09 1998 aee Added dacs and ecs keywords. Default is dacs.
@(#)getfphkn.pro 1.1 01/23/98 :LASCO IDL LIBRARY
hk = array of all monitors from HK TLM stream generated by DACS
hr is a number from 0 to 23 indicating the starting hour to be returned
nhr is a number indicating the number of hours to be included
@(#)gethkhr.pro 1.1 01/23/98 :LASCO IDL LIBRARY
hk = array of all monitors from HK TLM stream generated by DACS
pcktnum is a number from 1 to 3 indicating one of the three HK packet
types
@(#)gethkn.pro 1.1 01/23/98 :LASCO IDL LIBRARY
returns the LASCO LOBT from HK packet 1 The order of the raw bytes is byte flipped from the sun order @(#)getlobt.pro 1.1 01/23/98 :LASCO IDL LIBRARY
NAME: GET_BAD_CMDS PURPOSE: This procedure extracts the bad commands from the housekeeping stream and puts them into a sequence: word 0 obt byte 1 1 obt byte 2 2 obt byte 3 3 obt byte 4 4 obt byte 5 5 obt byte 6 6 good / bad flag (0=good, 1=bad ground TC, 2=bad TCE comm) 7 command counter 8 command code 9 command destination code 10 command sequence number 11 command error code CATEGORY: PACKETS CALLING SEQUENCE: Result = GET_BAD_CMDS (Hk) INPUTS: Hk: A 2D byte array containing all three LASCO housekeepking packets, as returned by READALLHK. OUTPUTS: This function returns a 2D array (12,*) containing the bad commands. Each row of the array contains the parameters above. PROCEDURE: The houskeeping packets are searched for the TM points that describe the bad commands, and then decoded into their component values. MODIFICATION HISTORY: Written by: R.A. Howard, NRL, 1995 @(#)get_bad_cmds.pro 1.1 01/23/98 LASCO IDL LIBRARY
extracts the commands from the housekeeping stream into a sequence: hk is an array containing all of the housekeeping packets word 0 obt byte 1 1 obt byte 2 2 obt byte 3 3 obt byte 4 4 obt byte 5 5 obt byte 6 6 good / bad flag (0=good, 1=bad) 7 command counter 8 command code 9 command destination code 10 command sequence number 11 command error code modified for hk in bytes or words 20 mar 1996, RAH @(#)get_cmds.pro 1.1 01/23/98 :LASCO IDL LIBRARY
NAME:
GET_PACKET_FNAMES
PURPOSE:
This function returns all of the packet file names for the specified date(s).
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
Result = GET_PACKET_FNAMES ( Date )
INPUTS:
Date: A string or array of strings specifying the date in the format YYMMDD
OUTPUTS:
This function returns a string array of file names for the specified dates.
COMMON BLOCKS:
None
RESTRICTIONS:
If the environment variable, TMPCKTS, is not defined then the current
working directory must be the directory where the files are located.
PROCEDURE:
The file names have a basic root structure for a given date and then have
the hour at the end. For example the SVM HK 1 packets for 1998/03/06 would
have the structure:
SVMHK1980306_00 for hour 0
SVMHK1980306_01 for hour 1
SVMHK1980306_02 for hour 2
and so on.
This routine simply searches for all of the files of type SVMHK1980306*
EXAMPLE:
hk = GET_PACKET_FNAMES ('SVMHK1960306')
MODIFICATION HISTORY:
Written by: R.A. Howard, 1998
Sep, 1998 Extracted from the versionof READALLSV1
@(#)get_packet_fnames.pro 1.1 09/24/98 :LASCO IDL LIBRARY
hk is an array containing all of the housekeeping packets
Extracts TCE communication errors as reported in the HK stream
into a sequence. These errors are in words 45-54 of packet #3.
Note: since there is no sequence # associated with these errors
there may actually be more errors than reported. For example
only the last 5 errors are reported. So if there were more
than 5 errors in between pckt 3 acquisitions we would only see
the last 5. Or if all 5 reported errors are the same, when
we get a 6th of the same, we wouldn't be able to tell.
OUTPUT:
word
0 obt byte 1
1 obt byte 2
2 obt byte 3
3 obt byte 4
4 obt byte 5
5 obt byte 6
6 good / bad flag (0=good, 1=bad soho 2 = bad tce)
7 command counter
8 command code
9 command destination code
10 detected by
11 command error code
there are five slots for putting bad commands into
if more than five bad commands are received with the same id
then they cannot be distinguished from the first five.
all 5 locations are cleared when good TC count rolls over 255
@(#)get_tce_comm_errs.pro 1.1 01/23/98 :LASCO IDL LIBRARY
searches sciences packets for the next occurrence of an image sc = 2D array containing the science packets the array should contain only data packets when the OBE is running. ie no packets when the instrument is off, and 'ffff'xl are being transmitted. pktno = packet number to start the search on exit, it will contain the packet number of the header hdr = image header returned img = image returned npckt = number of packets in image the function return is =0 if no image is found =1 if an image is found @(#)get_tm_img.pro 1.1 01/23/98 :LASCO IDL LIBRARY
NAME: GET_TM_MONITOR PURPOSE: This function returns an array of TM values, associated with a specified lasco monitor. CATEGORY: PACKETS CALLING SEQUENCE: Result = GET_TM_MONITOR (Hk,Name) INPUTS: Hk: A 2D byte array containing all three LASCO HK TM packets Name: A string containing the name of the monitor point KEYWORD PARAMETERS: CONVERT: If set the raw TM values will be converted to engineering units. OUTPUTS: This function returns a 1D array containing the TM values. COMMON BLOCKS: TM_MON_DB Contains the TM Monitor data base mon_name Monitor Name mon_offset Monitor Packet offset #1 mon_mask1 Monitor Mask #1 mon_offset2 Monitor Packet offset #2 mon_mask2 Monitor Mask #2 mon_title Monitor Title mon_packet Monitor Packet Name SIDE EFFECTS: If the monitor DB has not been defined, the data base is read from disk PROCEDURE: This routine is not operational yet. EXAMPLE: MODIFICATION HISTORY: Written by: R.A. Howard, NRL, 1995 @(#)get_tm_monitor.pro 1.1 01/23/98 LASCO IDL LIBRARY
NAME: LOBT2TAI PURPOSE: This function converts an LOBT array into TAI CATEGORY: PACKETS CALLING SEQUENCE: Result = LOBT2TAI(Lobt) INPUTS: Lobt: A 2 word array containing the local on-board time OUTPUTS: This function returns the TAI (Temps Atomic Internationale) time associated with the LOBT input. PROCEDURE: Calls OBT2TAI MODIFICATION HISTORY: Written by: S.E. Paswaters, 1995 @(#)lobt2tai.pro 1.1 09/22/96 LASCO IDL LIBRARY
NAME: MISS_PCKTS PURPOSE: This procedure generates a file containing a list of missing science telemetry packets in a d01 file in same location CATEGORY: LASCO PACKETS CALLING SEQUENCE: MISS_PCKTS OPTIONAL INPUTS: Fname: Specifies the telemetry filename to read in. If no argument is present then all files are read in. KEYWORDS: /AUTO Analyze all d01 files in $TMOUT SIDE EFFECTS: A file "miss_pckts.lst" is generated and put into the user's home directory. PROCEDURE: The input files must reside in the current working directory. It then finds missing or out of order packets in science stream by looking at the packet counter, which should increment by one. EXAMPLE: To process all telemetry files in the current directory: MISS_PCKTS MODIFICATION HISTORY: Written by: R.A. Howard, NRL, 7 Mar 1996 961216 by N. Rich prompt for input on processing status, CD info; changed variable volno to seqno; made /all keyword the default 970131 by N. RIch use TMFILES env variable 970210 by RAHoward Determine packet length to account for TM rate 970328 by N. Rich change default TM directory; save results file to start directory rather than home 970826 by N. RIch change default TM dir; add suff prompt 990401 by N. Rich Change default TM dir to gorgon; allow 4-digit volume numbers 990621 by N. Rich Change seqno to STRING input 2000/02 N. RIch Change default TM dir 000630 - the Jake - Beginning modifications to provide full scripting ability of this script. ie. remove all interaction and set default values. fname seqno vol proc 000922 - the Jake - Changed hardcoded directories to GETENV's 001006 - the Jake - Changed write outfile in $TMOUT dir instead of 'old' directory 001229 - nbr - Changed getenv TMFILES to TMOUT 03.10.10, nbr - Write output file for each input file (each day) @(#)miss_pckts.pro 1.21 10/10/03 LASCO IDL LIBRARY
NAME: MOTOR_DECODE PURPOSE: This function returns a structure array containing the decoded motor status. CATEGORY: PACKETS CALLING SEQUENCE: Result = MOTOR_DECODE (Hk,Tel) INPUTS: Hk: A 2D byte array containg the LASCO HK packets (at least HK #2) Tel: An integer (0..3) giving the telescope number KEYWORD PARAMETERS: FOCUS: Set for the focus motor FILTER: Set for the filter wheel motor POLAR: Set for the polarizer wheel motor SECTOR: Set for the sector wheel motor SHUTTER: Set for the shutter motor DOOR: Set for the door motor IOCSX: Set for the IOCS-X motor IOCSY: Set for the IOCS-Y motor LEG1: Set for the leg #2 motor LEG2: Set for the leg #2 motor FPLL: Set for the FP launch lock motor OUTPUTS: This function returns an array of structures pos rate adv status coil mode dir ok channel MODIFICATION HISTORY: Written by: S.E. Paswaters, NRL, 1995 @(#)motor_decode.pro 1.2 08/17/01 LASCO IDL LIBRARY 17 Aug 2001 RAH Corrected some compilation errors
Jan 1998
Ed Esfandiari - first version.
This pro uses level-0 housekeeping files to plot various
temperatures and voltages. It is based on plot_temps,
plot_bs_pes, plot_ccd_temps, and plot_lev_volt pros.
Jan 28 1998 AEE Added xzoom option.
Sep 14 1998 AEE Added 21 Motor Encoder Positions from Hk2.
Oct 19 1998 AEE Corrected DN plot for BS and PES.
Dec 22 1998 AEE added y-axes rescale option.
Dec 23 1998 AEE made y-axes rescale more precise.
Jan 26 1999 AEE Fixed for Y2K problem.
Sep 08 1999 AEE Fixed code to handle days with no/bad packets.
Jun 29 2000 AEE Added psym option and corrected start/stop dates display.
Jul 28 2000 AEE Added code to crate the gif files using white backgrounds.
NAME:
PLOT_HKLZ
PURPOSE:
This subroutine plots various temperatures and voltages of LEB,
C1, C2, C3, and EIT for a day (or range of days) using the level-0
housekeeping datafiles. between 1 to 9 plots can be displayed at
the same time with the options of saving them to a gif file or
printing them to a printer of choice.
CALLING SEQUENCE:
PLOT_HKLZ
INPUTS:
None
OUTPUTS:
None
@(#)plot_hklz.pro 1.2 03/03/98 :LASCO IDL LIBRARY
NAME: PLOT_HK_TIME PURPOSE: This procedure plots the difference between LASCO HK time and S/C time. CATEGORY: LASCO PACKETS CALLING SEQUENCE: PLOT_HK_TIME,Dte INPUTS: Dte: A string giving the date to be plotted, YYMMDD. OPTIONAL INPUTS: None KEYWORD PARAMETERS: None OUTPUTS: None OPTIONAL OUTPUTS: None COMMON BLOCKS: None SIDE EFFECTS: None RESTRICTIONS: None PROCEDURE: This procedure finds the time stamp put on by the S/C and the time stamp put on by TCE in housekeeping packet #1 (8869). It forms the difference in the TAI values (seconds) and plots the difference along the Y-axis against the S/C time along the X-axis. EXAMPLE: To form the plot: PLOT_HK_TIME, '960530' MODIFICATION HISTORY: Written by: RA Howard, 2 June 1996 @(#)plot_hk_time.pro 1.1 01/23/98 LASCO IDL LIBRARY
NAME: PLOT_OBE_TIME PURPOSE: This procedure plots the difference between LASCO OBE time and S/C time. CATEGORY: LASCO PACKETS CALLING SEQUENCE: PLOT_OBE_TIME,Dte INPUTS: Dte: A string giving the date to be plotted, YYMMDD. OPTIONAL INPUTS: None KEYWORD PARAMETERS: None OUTPUTS: None OPTIONAL OUTPUTS: None COMMON BLOCKS: None SIDE EFFECTS: None RESTRICTIONS: None PROCEDURE: This procedure finds the time stamp put on by the S/C in the first HK packet saved each hour and the time stamp put on by OBE in the first science packet saved each hour. It forms the difference in the TAI values (seconds) and plots the difference along the Y-axis against the S/C time along the X-axis. EXAMPLE: To plot the difference in times: PLOT_OBE_TIME, '960530' MODIFICATION HISTORY: Written by: RA Howard, 2 June 1996 @(#)plot_obe_time.pro 1.1 01/23/98 LASCO IDL LIBRARY
NAME: PLOT_SUBHTR PURPOSE: This procedure plots the LASCO and EIT substitution heater status CATEGORY: LASCO PACKETS CALLING SEQUENCE: PLOT_SUBHTR,Svmhk1 INPUTS: Svmhk1: An array of the telemetry packets from SVMHK1. It should have been read in using READ_TM_PACKETS with the NO_HDR switch set. KEYWORD PARAMETERS: SINGLE: A parameter from 1 to 3, indicating the plot number. The default is to plot all three plots too quickly to be of any use except if the output is going to the printer. NOCONVERT: If set then don't convert the DN to engineering units The default is to do the conversion. SAVE: A gif file will be written to the ftp directory on lasco6 for web access UTIME: If set, then the UTC time get put into it. Relays: If set, then the state of the relays get put into it. It would be an integer array (npts,nplot) where nplot is either 3, 2 or 5 depending upon how many relays are being plotted and npts is the number of samples. PROCEDURE: The TM files can be from DACS or from ECS. At this point, there is no difference as long as the NO_HDR option was used in READ_TM_PACKET. The plots are: 1 LASCO Nominal subsitition heater (along with GOLF and Virgo) 2 EIT Nominal substitution heater (along with SUMER and CELIAS) 3 LASCO and EIT redundant substitution heaters 4 LASCO and EIT substitution heater relays settings 5 LASCO and EIT substitution heater relays dutycycle EXAMPLE: To plot the first plot type of the LASCO substitution heater on the nominal side. PLOT_SUBHTR,svmhk1,single=1 MODIFICATION HISTORY: Written by: R.A. Howard, 1994. Sep 17, 1998 RAH. Modified for ECS and DACS usage. Sep 20, 1998 RAH. Corrected the relay setting plots. Added relay dutycycle plot Added relay plot. Added save to gif option. Added return of relay and utc arrays. Sep 22, 1998 RAH. Added 11 point median filter to Plot type 5 Sep 24, 1998 RAH. Check of packet times, changed position of labels. @(#)plot_subhtr.pro 1.7 09/24/98 LASCO IDL LIBRARY
Procedure: plot_temps2,hk,timeint,single=single
hk = array of all monitors from HK TLM stream generated by DACS
timeint = 2 word array giving the start and end times for the plot
EXAMPLE:
IDL> hk = readallhk('971022') or hk = readallhk('971022_1', /ecs)
IDL> plot_temps2, hk or plot_temps2, hk, ['1997/10/22 16:00','1997/10/22 20:00']
KEYWORD:
single plot
0 all zones
1 LEB PC
2 FP APZ
3 C2 Th 1
4 C2 Th 2
5 C2 Th 3
6 C3 Th 1
7 C3 Th 2
8 Zone 1
9 Zone 2
10 Zone 3
11 Zone 4
12 Zone 5
13 EIT Zone 6
14 EIT Zone 7
HISTORY:
offset the beginning of HK before LASCO HK information begins
modified for byte version of hk
VERSION:
01/01/97 S. Stezelberger - adjusted yrange limits
10/15/99 D. Wang - Added Eit Zone 6 and 7 and output var v
@(#)plot_temps2.pro 1.2 10/15/99 : NRL LASCO IDL LIBRARY
NAME: PLOT_TIME_DIFFS PURPOSE: This procedure plots the time differences between LASCO HK time, S/C time and OBE time. CATEGORY: LASCO PACKETS CALLING SEQUENCE: PLOT_TIME_DIFFS,Dte INPUTS: Dte: A string giving the date to be plotted, YYMMDD. OPTIONAL INPUTS: None KEYWORD PARAMETERS: None OUTPUTS: None OPTIONAL OUTPUTS: None COMMON BLOCKS: None SIDE EFFECTS: None RESTRICTIONS: None PROCEDURE: This procedure uses the routines, PLOT_OBE_TIME, and PLOT_HK_TIME and puts the two plots onto a single page. EXAMPLE: To form the plots: PLOT_TIME_DIFFS, '960530' MODIFICATION HISTORY: Written by: RA Howard, 2 June 1996 @(#)plot_time_diffs.pro 1.1 01/23/98 LASCO IDL LIBRARY
NAME:
READALLHK
PURPOSE:
This routine reads in all LASCO housekeeping packets for a given date.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
Result = READALLHK ( Date )
INPUTS:
Date: A string specifying the date in the format YYMMDD
KEYWORD PARAMETERS:
ECS: This keyword will indicate that the file type to be read in
are files generated by the EOF Core System (ECS). If the
keyword is not present, the routine assumes the files were
generated by DACS.
HKLZ: This keyword will indicate that the file type to be read in
are house keeping level-0 files (i.e. *.d01).
LOW_RES: This keyword will indicate that the file type to be read in
are house keeping level-0 compressed file. (i.e. *.s01). It
must be used in combination with HKLZ keyword.
OUTPUTS:
This function returns the LASCO housekeeping data as a 2D byte array
in which the packet information is the first dimension and time is
the second dimension.
COMMON BLOCKS:
None
RESTRICTIONS:
The current working directory must be the directory where the files
are located, except for /HKLZ option.
PROCEDURE:
Calls the routine READ_TM_PACKET
EXAMPLE:
Read in the ECS housekeeping data for the date 6 March 1996:
hk = READALLHK ('960306',/ecs)
or
hk = READALLHK ('960306',/hklz)
or
hk = READALLHK ('960306',/hklz,/low_res)
MODIFICATION HISTORY:
Written by: R.A. Howard, 1992
Jan, 1996 Modified for ECS and READ_TM_PACKET.
Jan, 1998 AEE - Added /hklz (level-0 house keeping) and
/low_res keyword options.
Sep, 1998 AEE - Added HK2 (G016) to get Motor Encoder Positions.
Oct, 1998 RAH - Added environment variable TMPCKTS
Dec, 1998 AEE - Added path (from TMPCKTS) to the ecs files.
Sep, 1999 AEE _ Check first 6 chars of a line for the yymmdd instead of the whole line.
@(#)readallhk.pro 1.4 10/02/98 :LASCO IDL LIBRARY
NAME:
READALLSV1
PURPOSE:
This routine reads in all service module housekeeping packets type 1,
(SVMHK1) for a given date.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
Result = READALLSV1 ( Date )
INPUTS:
Date: A string or array of strings specifying the date in the format YYMMDD
KEYWORD PARAMETERS:
ECS: This keyword will indicate that the file type to be read in
are files generated by the EOF Core System (ECS). If the
keyword is not present, the routine assumes the files were
generated by DACS.
OUTPUTS:
This function returns the SVMHK1 housekeeping data as a 2D byte array
in which the packet information is the first dimension and time is
the second dimension.
COMMON BLOCKS:
None
RESTRICTIONS:
If the environment variable, TMPCKTS, is not defined then the current
working directory must be the directory where the files are located.
PROCEDURE:
Calls the routines READ_TM_PACKET, GET_PACKET_FNAMES and READ_PACKET_FNAMES
EXAMPLE:
Read in the ECS housekeeping data for the date 6 March 1996:
hk = READALLSV1 ('960306',/ecs)
MODIFICATION HISTORY:
Written by: R.A. Howard, 1992
Jan, 1996 Modified for ECS and READ_TM_PACKET.
Sep, 1998 Added environment variable TMPCKTS
Sep, 1998 Changed method of accumulating packets
Permit an array of dates
Use GET_PACKET_FNAMES and READ_PACKET_FNAMES
@(#)readallsv1.pro 1.4 07/05/00 :LASCO IDL LIBRARY
NAME:
READALLSV2
PURPOSE:
This routine reads in all service module housekeeping packets type 2,
(SVMHK2) for a given date.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
Result = READALLSV2 ( Date )
INPUTS:
Date: A string specifying the date in the format YYMMDD
KEYWORD PARAMETERS:
ECS: This keyword will indicate that the file type to be read in
are files generated by the EOF Core System (ECS). If the
keyword is not present, the routine assumes the files were
generated by DACS.
OUTPUTS:
This function returns the SVMHK2 housekeeping data as a 2D byte array
in which the packet information is the first dimension and time is
the second dimension.
COMMON BLOCKS:
None
RESTRICTIONS:
If the environment variable, TMPCKTS, is not defined then the current
working directory must be the directory where the files are located.
PROCEDURE:
Calls the routines READ_TM_PACKET, GET_PACKET_FNAMES and READ_PACKET_FNAMES
EXAMPLE:
Read in the ECS housekeeping data for the date 6 March 1996:
hk = READALLSV2 ('960306',/ecs)
MODIFICATION HISTORY:
Written by: R.A. Howard, 1992
Jan, 1996 Modified for ECS and READ_TM_PACKET.
Sep, 1998 Added environment variable TMPCKTS
Sep 24, 1998 Use GET_PACKET_FNAMES and READ_PACKET_FNAMES
@(#)readallsv2.pro 1.3 09/24/98 :LASCO IDL LIBRARY
NAME:
READALLSV4
PURPOSE:
This routine reads in all service module housekeeping packets type 4,
(SVMHK4) for a given date.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
Result = READALLSV4 ( Date )
INPUTS:
Date: A string specifying the date in the format YYMMDD
KEYWORD PARAMETERS:
ECS: This keyword will indicate that the file type to be read in
are files generated by the EOF Core System (ECS). If the
keyword is not present, the routine assumes the files were
generated by DACS.
OUTPUTS:
This function returns the SVMHK4 housekeeping data as a 2D byte array
in which the packet information is the first dimension and time is
the second dimension.
COMMON BLOCKS:
None
RESTRICTIONS:
If the environment variable, TMPCKTS, is not defined then the current
working directory must be the directory where the files are located.
PROCEDURE:
Calls the routines READ_TM_PACKET, GET_PACKET_FNAMES and READ_PACKET_FNAMES
EXAMPLE:
Read in the ECS housekeeping data for the date 6 March 1996:
hk = READALLSV4 ('960306',/ecs)
MODIFICATION HISTORY:
Written by: R.A. Howard, 1992
Jan, 1996 Modified for ECS and READ_TM_PACKET.
Sep, 1998 Added environment variable TMPCKTS
Sep 25, 1998 Use GET_PACKET_FNAMES and READ_PACKET_FNAMES
@(#)readallsv4.pro 1.3 09/24/98 :LASCO IDL LIBRARY
NAME: READ_PACKET_FNAMES PURPOSE: This routine reads in all packets specified by the files CATEGORY: LASCO PACKETS CALLING SEQUENCE: Result = READ_PACKET_FNAMES ( Files ) INPUTS: Files: A string or array of strings specifying the file names OUTPUTS: This function returns the packet information as a 2D array in which the packet information is the first dimension and time is the second dimension. COMMON BLOCKS: None PROCEDURE: Calls the routine READ_TM_PACKET Reformats the packet information from each file into a singly dimensioned array. Then the information from each file can be concatenated together. When all files have been read in then the array can be reformatted into the 2D array. EXAMPLE: Read in the ECS housekeeping data for the files, files hk = READ_PACKET_FNAMES (files) MODIFICATION HISTORY: Written by: R.A. Howard, 1998 Sep, 1998 Taken from READALLSV1 @(#)read_packet_fnames.pro 1.1 09/24/98 :LASCO IDL LIBRARY
NAME:
READ_TM_PACKET
PURPOSE:
This routine reads in raw telemetry packets.
CATEGORY:
LASCO PACKET
CALLING SEQUENCE:
Result = READ_TM_PACKET (Pckt_file_name)
INPUTS:
Pckt_file_name: String containing the name of the file to be read in.
KEYWORD PARAMETERS:
NO_HDR: Strips off the 12 byte header information added by DACS
FIRST_ONLY: Only returns first packet in file
SILENT: Suppresses informational messages
OUTPUTS:
Result: A 2D byte array containing the packets. The contents of
one packet is in the first dimension, and time is in the
second dimension.
COMMON BLOCKS:
READ_TM_PACKET_COMMON: Contains the TM packet types that have been
read in by INIT_APID_STRUCT
MODIFICATION HISTORY:
Written by: S.E. Paswaters, NRL, Jan 1996
Version 2 23 Mar 1996 RAHoward Corrected No_HDR option
Version 3 26 Mar 1996 RAHoward Added .dat file type to archive
type for LZ HK.
Version 4 23 Jan 1998 Ed Esfandiari added .s01 and .sat data types
(sub-sampled .d01 and dat data).
@(#)read_tm_packet.pro 1.2 01/23/98 :LASCO IDL LIBRARY
Purpose:
Fill in gaps in *.REL Sci TM with packets from QKL files and write new
output REL file
This will fill in data gaps from the first packet to the last packet
in the REL file. For preceding gaps or trailing gaps use the FIRST and LAST
keywords to set the range of packet seq numbers
CALL:
rel_ql_fill,rel_file,ql_file,out_file,rel,ql,out
INPUT:
rel_file - *.REL file with data gap(s)
ql_file - *.QKL file used to fill data gap(s)
out_file - name of output file
OUTPUT:
rel - byte array containing input REL packets
ql - byte array containing input QKL packets
out - output byte array containing merge packets
KEYWORDS:
DEBUG - output debug information
WRITE - write output file (default is not to write)
FIRST - set the start Packet Seq Num
(error if first is not found in REL file)
LAST - set the last Packet Seq Num
EXAMPLE:
HISTORY:
25 Oct 1999 D.Wang - Created
@(#)rel_ql_fill.pro 1.1 10/28/99 :LASCO NRL IDL LIBRARY
COMMENTS:
1. Compared to *.rec files QKL and REL are offset by 9 words e.g word 9
in *.recs are bytes 0 and 1 in rel and ql
2. Packet Sequence Number is 14 bits and rolls over at 16383. So this routine
can only handle up to 16383 packets. Since the typical *.REL file is
about 4000 packets this should be OK.
3. REL files have a FITS like header header that contains the start and
end times and the number of packets in the file. Output REL files
generated by this routine modify only the number of packets, start time
and end time
4. REL files have a trailer that contains ???????
for *.recs files
standard lo-rate sci packet
pacor time received in first 6 words
word 0: sync 1A1
word 1: year - 1900
word 2: day of year (0 = Jan 1)
word 3: hour
word 4: minute
word 5: second
word 9: APID
word 10: packet counter and TM mode (hi-bits)
word 11: packet size
word 12: TAI time
word 13: TAI time
word 14: TAI time
word 15: subpacket hdr - hi-byte = word count lo-byte = type
word 16: subpacket hdr - hi 2 bits = TM type, lo 14 bits = packet counter
NAME: SCAN_SC_HDR PURPOSE: This procedure identifies the subpacket headers in the science packets CATEGORY: LASCO PACKETS CALLING SEQUENCE: SCAN_SC_HDR,Sc INPUTS: Sc: A 2D byte array of the packet data as read in by READ_TM_PACKET OUTPUTS: This procedure writes the subpacket information to a file in the current directory. The file name is scan_YYYY-MM-DD, where the date is today's date. PROCEDURE: The science packet is scanned for the 4-byte subpacket headers. The first byte is the number of 2-byte data words in the subpacket. The second byte is the subpacket type. The packet data are only valid when the OBE is running. WHen OBE is not running the packets will contain 'FF'X. MODIFICATION HISTORY: Written by: R.A. Howard, NRL, 1993 Sep, 1999 RAH, The input data is now a byte array @(#)scan_sc_hdr.pro 1.4 09/08/99 LASCO IDL LIBRARY
NAME:
WPLOT_NONOP
PURPOSE:
This procedure generates plots of the non-operational temperature sensors.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
WPLOT_NONOP
INPUTS:
None
KEYWORD PARAMETERS:
DACS: If set then use the .recs files generated by DACS. The default
is to use the .REL files generated by ECS. If the environment
variable, TMPCKTS, is set then tHe files should be located in
that directory. If it isn't set then the files are located in
the current directory.
AUTO: If set then generate an automatic plot for the latest data.
The value of the AUTO parameter determines the number of times
the plot cycle is repeated. The default is to use the program
interactively.
FDAY: If set then specifies the start time of the plot in fractional
days from the current time in the automatic mode. The default
is to start 1 day, 86400 seconds, earlier than the current time.
NWAIT: If set then specifies the number of seconds to wait between
automatic cycles. The default is to wait 3600 seconds.
COMMON BLOCKS:
WPLOT_NONOP_COMMON
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
WPLOT_NONOP
Allows interactive plotting using .REL files from ECS
WPLOT_NONOP,/dacs
Allows interactive plotting using .recs files from DACS
WPLOT_NONOP,/dacs,/auto
Generates a single automatic plot for the latest 24 hours.
WPLOT_NONOP,/dacs,auto=24,fday=2,wait=7200.
Generates automatic plots every 2 hours covering the latest 2 days.
MODIFICATION HISTORY:
Written by: Scott Paswaters, Dec 1995
Modifications:
971216 aee Fixed year/month change in GET_PCKT_NAMES.
980811 rah Fixed offsets (added 6 bytes in line 96 to nonop.offs)
980916 rah A number of changes to make it work for DACS/REL files
There were many files per hour of REL files.
TM_READ_PACKET returns the same 12 byte header, for both .recs and .REL
files. The 12 bytes are 6 for packet ID, length, etc and 6 for OBT.
We want to start the packet offsets with the first byte of time at
0. Therefore the dacs_offset value should be 6, to skip over the
packet ID, etc.
980917 rah Added the automatic plot capability.
980923 rah Added plot of -10 or -50
990126 aee Fixed for Y2K problem.
@(#)wplot_nonop.pro 1.11 12/23/98 :LASCO IDL LIBRARY
NAME:
WPLOT_SUBHTR
PURPOSE:
This procedure generates plots of the non-operational temperature sensors.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
WPLOT_SUBHTR
INPUTS:
None
KEYWORD PARAMETERS:
DACS: If set then use the .recs files generated by DACS. The default
is to use the .REL files generated by ECS. If the environment
variable, TMPCKTS, is set then tHe files should be located in
that directory. If it isn't set then the files are located in
the current directory.
AUTO: If set then generate an automatic plot for the latest data.
The value of the AUTO parameter determines the number of times
the plot cycle is repeated. The default is to use the program
interactively.
FDAY: If set then specifies the start time of the plot in fractional
days from the current time in the automatic mode. The default
is to start 1 day, 86400 seconds, earlier than the current time.
NWAIT: If set then specifies the number of seconds to wait between
automatic cycles. The default is to wait 3600 seconds.
COMMON BLOCKS:
WPLOT_SUBHTR_COMMON
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
WPLOT_SUBHTR
Allows interactive plotting using .REL files from ECS
WPLOT_SUBHTR,/dacs
Allows interactive plotting using .recs files from DACS
WPLOT_SUBHTR,/dacs,/auto
Generates a single automatic plot for the latest 24 hours.
WPLOT_SUBHTR,/dacs,auto=24,fday=2,wait=7200.
Generates automatic plots every 2 hours covering the latest 2 days.
MODIFICATION HISTORY:
Written by: Scott Paswaters, Dec 1995
Modifications:
971216 aee Fixed year/month change in GET_PCKT_NAMES.
980811 rah Fixed offsets (added 6 bytes in line 96 to nonop.offs)
980916 rah A number of changes to make it work for DACS/REL files
There were many files per hour of REL files.
TM_READ_PACKET returns the same 12 byte header, for both .recs and .REL
files. The 12 bytes are 6 for packet ID, length, etc and 6 for OBT.
We want to start the packet offsets with the first byte of time at
0. Therefore the dacs_offset value should be 6, to skip over the
packet ID, etc.
980917 rah Added the automatic plot capability.
990126 aee Fixed for Y2K problem.
@(#)gethkpackets.pro 1.1 01/26/99 :LASCO IDL LIBRARY
NAME:
WPLOT_SUBHTR
PURPOSE:
This procedure generates plots of the non-operational temperature sensors.
CATEGORY:
LASCO PACKETS
CALLING SEQUENCE:
WPLOT_SUBHTR
INPUTS:
None
KEYWORD PARAMETERS:
DACS: If set then use the .recs files generated by DACS. The default
is to use the .REL files generated by ECS. If the environment
variable, TMPCKTS, is set then tHe files should be located in
that directory. If it isn't set then the files are located in
the current directory.
AUTO: If set then generate an automatic plot for the latest data.
The value of the AUTO parameter determines the number of times
the plot cycle is repeated. The default is to use the program
interactively.
FDAY: If set then specifies the start time of the plot in fractional
days from the current time in the automatic mode. The default
is to start 1 day, 86400 seconds, earlier than the current time.
NWAIT: If set then specifies the number of seconds to wait between
automatic cycles. The default is to wait 3600 seconds.
COMMON BLOCKS:
WPLOT_SUBHTR_COMMON
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
WPLOT_SUBHTR
Allows interactive plotting using .REL files from ECS
WPLOT_SUBHTR,/dacs
Allows interactive plotting using .recs files from DACS
WPLOT_SUBHTR,/dacs,/auto
Generates a single automatic plot for the latest 24 hours.
WPLOT_SUBHTR,/dacs,auto=24,fday=2,wait=7200.
Generates automatic plots every 2 hours covering the latest 2 days.
MODIFICATION HISTORY:
Written by: Scott Paswaters, Dec 1995
Modifications:
971216 aee Fixed year/month change in GET_PCKT_NAMES.
980811 rah Fixed offsets (added 6 bytes in line 96 to nonop.offs)
980916 rah A number of changes to make it work for DACS/REL files
There were many files per hour of REL files.
TM_READ_PACKET returns the same 12 byte header, for both .recs and .REL
files. The 12 bytes are 6 for packet ID, length, etc and 6 for OBT.
We want to start the packet offsets with the first byte of time at
0. Therefore the dacs_offset value should be 6, to skip over the
packet ID, etc.
980917 rah Added the automatic plot capability.
990126 aee Fixed for Y2K problem.
@(#)wplot_subhtr.pro 1.1 01/26/99 :LASCO IDL LIBRARY
lasco_mk_html_help.pro on
Wed Aug 17 12:21:59 2005.