tape/tape.h

Go to the documentation of this file.

#ifndef _TAPE_H
#define _TAPE_H

#include "gridlabd.h"
#include "object.h"
#include "aggregate.h"
#include "memory.h"

/* tape global controls */
static char timestamp_format[32]="%Y-%m-%d %H:%M:%S";
typedef enum {VT_INTEGER, VT_DOUBLE, VT_STRING} VARIABLETYPE;
typedef enum {TS_INIT, TS_OPEN, TS_DONE, TS_ERROR} TAPESTATUS;
typedef enum {FT_FILE, FT_ODBC, FT_MEMORY} FILETYPE;
typedef enum {SCREEN, EPS, GIF, JPG, PDF, PNG, SVG} PLOTFILE;

typedef struct s_tape_operations {
    int (*open)(void *my, char *fname, char *flags);
    char *(*read)(void *my,char *buffer,unsigned int size);
    int (*write)(void *my, char *timestamp, char *value);
    int (*rewind)(void *my);
    void (*close)(void *my);
} TAPEOPS;

typedef struct s_tape_funcs {
    char256 mode;
    void *hLib;
    TAPEOPS *player;
    TAPEOPS *shaper;
    TAPEOPS *recorder;
    TAPEOPS *collector;
    TAPEOPS *histogram;
    struct s_tape_funcs *next;
} TAPEFUNCS;

CDECL TAPEFUNCS *get_ftable(char *mode);

typedef struct {
    char *name;
    VARIABLETYPE type;
    void *addr;
    double min, max;
} VARMAP;

typedef struct s_recobjmap {
    OBJECT *obj;
    PROPERTY prop; // must be an instance
    struct s_recobjmap *next;
} RECORDER_MAP;

struct player {
    /* public */
    char1024 file; 
    char8 filetype; 
    char32 property; 
    int32 loop; 
    /* private */
    FILETYPE type;
    union {
        FILE *fp;
        MEMORY *memory;
        void *tsp;
    };
    TAPESTATUS status;
    int32 loopnum;
    struct {
        TIMESTAMP ts;
        char32 value;
    } next;
    PROPERTY *target;
    TAPEOPS *ops;
    char lasterr[1024];
}; 
typedef struct s_shapertarget {
    double *addr; 
    TIMESTAMP ts; 
    double value; 
} SHAPERTARGET; 
struct shaper {
    /* public */
    char1024 file; 
    char8 filetype; 
    char32 property; 
    char256 group; 
    double magnitude;   
    double events;      /* the number of queue events per interval (\p events = 0 => direct shape)*/
    /* private */
    TAPEOPS *ops;
    FILETYPE type;
    union {
        FILE *fp;
        MEMORY *memory;
        void *tsp;
    };
    TAPESTATUS status;
    char lasterr[1024];
    int16 interval; /* the interval over which events is counted (usually 24) */
    int16 step;     /* the duration of a single step in the shape integral (usually 3600s) */
    double scale;   /* the scaling of the shape over the interval */
    int32 loopnum;
    unsigned char shape[12][31][7][24];
#define SHAPER_QUEUE 0x0001
    unsigned int n_targets;
    SHAPERTARGET *targets;
};
struct recorder {
    /* public */
    char1024 file;
    char1024 multifile;
    char1024 multitempfile;
    FILE *multifp, *inputfp;
    int16 multirun_ct;
    char1024 multirun_header;
    char8 filetype;
    int16 format; /* 0=YYYY-MM-DD HH:MM:SS; 1=timestamp */
    double dInterval;
    TIMESTAMP interval;
    int32 limit;
    char1024 property;
    PLOTFILE output; /* {EPS|GIF|JPG|PDF|PNG|SVG} More can be added */
    char1024 plotcommands;
    char32 xdata;
    char32 columns;
    char32 trigger;
    /* private */
    RECORDER_MAP *rmap;
    TAPEOPS *ops;
    FILETYPE type;
    union {
        FILE *fp;
        MEMORY *memory;
        void *tsp;
    };
    TAPESTATUS status;
    char8 delim;
    struct {
        TIMESTAMP ts;
        char1024 value;
    } last;
    int32 samples;
    PROPERTY *target;
};
struct collector {
    /* public */
    char1024 file;
    char8 filetype;
    int16 format; /* 0=YYYY-MM-DD HH:MM:SS; 1=timestamp */
    double dInterval;
    TIMESTAMP interval;
    int32 limit;
    char1024 property;
    PLOTFILE output; /* {EPS|GIF|JPG|PDF|PNG|SVG} More can be added */
    char1024 plotcommands;
    char32 xdata;
    char32 columns;
    char32 trigger;
    char256 group;
    /* private */
    TAPEOPS *ops;
    FILETYPE type;
    union {
        FILE *fp;
        MEMORY *memory;
        void *tsp;
    };
    TAPESTATUS status;
    char8 delim;
    struct {
        TIMESTAMP ts;
        char1024 value;
    } last;
    int32 samples;
    AGGREGATION *aggr;
};
#endif

---

GridLAB-D^TM Version 2.0

An open-source project initiated by the US Department of Energy