Cummings generator routines

• AINTRO- USING THE CGEN ROUTINES:
• CGENGETFILES - FIND THE FILES FOR THE SPECIFIED DATE(S)
• CGENGETMONTH - INPUT FILE WITH 1 MONTH OF DATA
• CGENPATH - RETURN PATH FOR CGEN DATA
• CGENPLOT - PLOT GENERATOR DATA

Routine Descriptions

NAME:
aIntro- Using the cgen  routines:
    
    The cummings generators are monitored using some modbus routines.
Data is written to disc (/share/phildat/cummings/) once a minute 
(if the generators are on).  Each file contains a months worth of
data (filename: cgen_yyyymm.dat). 

    The routines in the cgen package let you access and plot this data. 

    The main routines used by users are:
    
@phil
@cgeninit      - these routines will initialize the cgen routines
cgeninpmonth() - input data for 1 month.
cgenplot()     - plot some datainput and plot the data for a day, or continually monitor

The data structure used  for each record:
IDL> help,d,/st                                                       
** Structure CGENINFO, 6 tags, length=664, data length=664:           
   RECMARKER       BYTE  Array[4]  : "RECm" 
   RECNUM          LONG            : 1.. N within file
   YYYYMMDD        LONG            : 20131121  yyyymmdd when data read                             
   SECMID          LONG            : 12964  secMid ast for data read                             
   JD              DOUBLE          : julian data for data   read (gmt based)
   GENI            STRUCT CGEN1 Array[4]: holds data for each generator                 

 The data for 1 generator:
IDL> help,d[500].geni[2],/st
** Structure CGEN1, 40 tags, length=160, data length=160:
   DEVTYPE         LONG   3
   CTRLSW          LONG   2
   STATE           LONG   3
   FAULTCODE       LONG   0
   FAULTTYPE       LONG   0
   KWPERCENT       FLOAT   76.0000
   TOTKWST         FLOAT   755.000
   NFPA110         LONG   24576
   EXTENDEDST      LONG     0
   FREQ            FLOAT   59.0000
   TOTPF           FLOAT    0.921850
   TOTKVA          FLOAT  821.000
   TOTKW           FLOAT  755.000
   TOTKVAR         FLOAT  319.000
   VOLTSAB         FLOAT  4169.00
   VOLTSBC         FLOAT  4174.00
   VOLTSCA         FLOAT  4171.00
   VOLTSA          FLOAT  2408.00
   VOLTSB          FLOAT  2411.00
   VOLTSC          FLOAT  2413.00
   AMPSA           FLOAT  111.000
   AMPSB           FLOAT  111.000
   AMPSC           FLOAT  112.000
   AMPSAPERCENT    FLOAT   64.5000
   AMPSBPERCENT    FLOAT   64.0000
   AMPSCPERCENT    FLOAT   64.5000
   BATVOLT         FLOAT   27.1000
   OILPRES         FLOAT   54.4037
   OILTEMP         FLOAT   91.8400
   COOLANTTEMP     FLOAT   80.1400
   MISCTEMP1       FLOAT 6280.34
   MISCTEMP2       FLOAT   37.5400
   FUELRATE        FLOAT    0.00000  <-- this is not loaded by cummings
   ENGRPM          FLOAT 1770.00
   ENGSTARTS       LONG   684
   ENGRUNTIME      FLOAT 1754.36
   TOTKWH          FLOAT 530280.
   TOTFUEL         FLOAT  55177.3
   STARTCTRL       LONG     590
   RESETCTRL       LONG    4169

cgengetmonth will input an array of these structures d[n]. You can use cgenplot
to plot the data, or you can use the normal idl plot routines for plotting.

 the d.genI.state variable will tell which generators were in used:
 ii=where(b.geni.state ne 0)


EXAMPLES:
;  start idl
    idl
    @phil
    @rcgeninit

    input month of nov13
    nrecs=cgengetmonth(1311,d)
 
   plot a summary of the data
	cgenplot,d

(See /pkg/rsi/local/libao/phil/cgen/aIntro.pro)

NAME:
cgengetfiles - find the files for the specified date(s)
SYNTAX: nfiles=cgengetfiles(yymmdd1,yymmdd2,filelist,ndays=ndays)
ARGS:
   yymmdd1: long  date for first day to read 
   yymmdd2: long  date for last day of interest
KEYWORDS:
   ndays: long find files for ndays starting at yymmdd1. In this case
               ignore yymmdd2.
RETURNS:
   nfiles: number of files found.
   filelist[nfiles]: list of files.
   yymmdd2: will return the actual last day used (in case you have
            requested something in the future.
DESCRIPTION:
   Return the list of filenames that contain the data for yymmdd1 through
yymmdd2. If keyword ndays is provided then return the list of filenames
for the ndays of data starting at yymmdd1 and return yymmdd2.
   The data is stored by month.

EXAMPLE:
   Get the files for oct02 through dec02
   nfiles=cgengetfiles(021001,021230,filelist)
   print,nfiles
   3
   print,filelist

(See /pkg/rsi/local/libao/phil/cgen/cgengetfiles.pro)

NAME:
cgengetmonth - input file with 1 month of data
SYNTAX: n=cgengetmonth(yymm,d,badpnts=bandpnts,nbad=nbad))
ARGS: 
 yymm: long  month to read  
KEYWORDS:
 badpnts[m] : {} array of pnts with bad  values read in
 nband      : long  number of bad pnts found.
RETURNS:
    n  : long  number of records we read.
                > 0  number of records returned
                     a warning message is output if we
                     don't get all the data
                0 - no data for this date
               -1 - read error.  no data   returned
               -2 - open error
  d[n]: {}     array of structs holding the info 
DESCRIPTION:
   Read in 1 month of cummings generator data.
ISSUES:
   When stopping totkw looks like it goes negative?
   force it positive

(See /pkg/rsi/local/libao/phil/cgen/cgengetmonth.pro)

NAME:
cgenpath - return path for cgen data
SYNTAX: path=cgenpath()
RETURNS:
   path  : string path to cgen data
DESCRIPTION:
   return the path to the cgen data. Trailing / is in included.

(See /pkg/rsi/local/libao/phil/cgen/cgenpath.pro)

NAME:
cgenplot - plot generator data
SYNTAX: cgenplot,d,title=title,drange=drange,cs=cs,font=font,sym=sym,$
					labadate=labadate,wait=wait,hard=hard,psname=psname
ARGS:   
   d[n]:{cgeninfo} array of generator data
KEYWORDS:
 title     : string title to add to the top of each page
 drange[2] : long  [yyyymmdd,numdays] to plot
  cs       : float character size scaling if single plot. default=2
 font      : int   1-truetype, -1 hershey, 0 device
                   def:hershey
   sym     : int   symbol to using when plotting x vs y.
                   1,2,3 .. plot a symbol at each measured position.
                   1 +, 2 *, 3 . , Negative number -1,-2,-3 will plot 
                   the symbol and the connecting lines.
                   default:4
 title     : string add this to top of each page
  labadate : string if supplied, then this is the output format
                   for label_date call:
                   %M-monName,%N-monNun,%D-dayNo,%Z-yy,%H-hr,%I-min
                   default is "%D%M" (ddMon)
   wait    :       if set then wait for enter between plots
   hard    :       if set then write a .ps file.
 psname    : string name for psfile. Default="cgensum_yyyymm.ps"

DESCRIPTION:
   Plot the cummings generator data passed in.
The first page plots combined data (from the 4 generators)
 1. total power vs time.
 2. fuel rate (gallons/hour) vs time.
 3. fuel rate vs total power.
 4. efficiency vs total power. (KW for 1gallon/hour)
Page 2:
 1. combined fuel usage (gallons) since start of this dataset.
 2. cumulative hours run for each generator (since installation).
    each generator is a separate color.

	The /hard keyword will generate a hardcopy file (ps). The default
name is cgensum_yyyymm.ps . You can change the psname using the psname
keyword.

	You can limit the data plotted using the drange= keyword
  	drange[0]= yyyymmdd   start of data
   drange[1]= ndays       number of days (from drange[0] to plot).
                         if ndays can be positive or negative.

(See /pkg/rsi/local/libao/phil/cgen/cgenplot.pro)