Logo Search packages:      
Sourcecode: gretl version File versions  Download package

plotspec.c

/* 
 *  gretl -- Gnu Regression, Econometrics and Time-series Library
 *  Copyright (C) 2001 Allin Cottrell and Riccardo "Jack" Lucchetti
 * 
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 * 
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 * 
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 * 
 */

#include "libgretl.h"
#include "plotspec.h"

00023 struct plotbars_ {
    int n;         /* number of available start-stop "bar" pairs */
    double t1;     /* current min. value on time axis */   
    double t2;     /* current max. value on time axis */  
    double ymin;   /* current min. value on y axis */  
    double ymax;   /* current max. value on y axis */  
    double **dx;   /* start-stop time pairs */
};

/* for handling "recession bars" or similar */
static int n_bars_shown (double xmin, double xmax, plotbars *bars);
static void print_bars_header (int n, FILE *fp);
static void print_plotbars (plotbars *bars, FILE *fp);

GPT_SPEC *plotspec_new (void)
{
    GPT_SPEC *spec;
    int i;

    spec = malloc(sizeof *spec);
    if (spec == NULL) {
      return NULL;
    }

    spec->lines = NULL;
    spec->n_lines = 0;

    spec->labels = NULL;
    spec->n_labels = 0;

    spec->arrows = NULL;
    spec->n_arrows = 0;

    spec->literal = NULL;
    spec->n_literal = 0;

    for (i=0; i<4; i++) {
      spec->titles[i][0] = 0;
    }

    *spec->xvarname = '\0';
    *spec->yvarname = '\0';

    spec->xfmt[0] = 0;
    spec->xtics[0] = 0;
    spec->mxtics[0] = 0;
    spec->yfmt[0] = 0;
    spec->ytics[0] = 0;
    spec->fname[0] = 0;
    spec->keyspec = GP_KEY_LEFT_TOP;

    for (i=0; i<4; i++) {
      spec->range[i][0] = NADBL;
      spec->range[i][1] = NADBL;
      if (i < 3) {
          spec->logbase[i] = 0.0;
      }
    }

    spec->b_ols = NULL;
    spec->b_quad = NULL;
    spec->b_cub = NULL;
    spec->b_inv = NULL;

    spec->code = PLOT_REGULAR;
    spec->flags = 0;
    spec->fit = PLOT_FIT_NONE;
    spec->fp = NULL;
    spec->data = NULL;
    spec->markers = NULL;
    spec->n_markers = 0;
    spec->labeled = NULL;
    spec->ptr = NULL;
    spec->bars = NULL;
    spec->fontstr = NULL;
    spec->reglist = NULL;
    spec->nobs = 0;
    spec->okobs = 0;
    spec->pd = 0;
    spec->nbars = 0;
    spec->boxwidth = 0;
    spec->samples = 0;
    spec->border = GP_BORDER_DEFAULT;
    spec->bmargin = 0;

    spec->termtype = GP_TERM_NONE;

    return spec;
}

static void plotbars_free (plotbars *bars)
{
    if (bars != NULL) {
      doubles_array_free(bars->dx, bars->n);
      free(bars);
    }
}

void plotspec_destroy (GPT_SPEC *spec)
{
    if (spec == NULL) {
      return;
    }

    if (spec->lines != NULL) {
      free(spec->lines);
    }

    if (spec->labels != NULL) {
      free(spec->labels);
    }    

    if (spec->arrows != NULL) {
      free(spec->arrows);
    } 
  
    if (spec->data != NULL) {
      free(spec->data);
    }

    if (spec->reglist != NULL) {
      free(spec->reglist);
    }

    if (spec->literal != NULL) {
      free_strings_array(spec->literal, spec->n_literal);
    }

    if (spec->markers != NULL) {
      free_strings_array(spec->markers, spec->n_markers);
    }

    if (spec->labeled != NULL) {
      free(spec->labeled);
    }

    if (spec->bars != NULL) {
      plotbars_free(spec->bars);
    }

    if (spec->fontstr != NULL) {
      free(spec->fontstr);
    }    

    gretl_matrix_free(spec->b_ols);
    gretl_matrix_free(spec->b_quad);
    gretl_matrix_free(spec->b_cub);
    gretl_matrix_free(spec->b_inv);

    free(spec);
}

static void plotspec_get_xt1_xt2 (const GPT_SPEC *spec, 
                          double *xt1,
                          double *xt2)
{
    if (spec->data != NULL) {
      double *x = spec->data;
    
      *xt1 = x[0];
      *xt2 = x[spec->nobs - 1];
    }
}

static gp_style_spec style_specs[] = {
    { GP_STYLE_LINES,        "lines",        N_("lines") },
    { GP_STYLE_POINTS,       "points",       N_("points") },
    { GP_STYLE_LINESPOINTS,  "linespoints",  N_("lines/points") },
    { GP_STYLE_IMPULSES,     "impulses",     N_("impulses") },
    { GP_STYLE_DOTS,         "dots",         N_("dots") },
    { GP_STYLE_STEPS,        "steps",        N_("steps") },
    { GP_STYLE_BOXES,        "boxes",        N_("boxes") },
    { GP_STYLE_ERRORBARS,    "errorbars",    N_("error bars") },
    { GP_STYLE_FILLEDCURVE,  "filledcurve",  N_("filled curve") },
    { GP_STYLE_CANDLESTICKS, "candlesticks", N_("candlesticks") },
    { 0, NULL, NULL }
};

const char *gp_line_style_display_name (int t)
{
    int i;

    for (i=0; style_specs[i].id != 0; i++) {
      if (t == style_specs[i].id) {
          return style_specs[i].trname;
      }
    }

    return N_("lines");
}

static const char *gp_line_style_name (int t)
{
    int i;

    for (i=0; style_specs[i].id != 0; i++) {
      if (t == style_specs[i].id) {
          return style_specs[i].name;
      }
    }

    return "lines";
}

int gp_style_index_from_name (const char *s)
{
    int i;

    for (i=0; style_specs[i].id != 0; i++) {
      if (!strcmp(s, style_specs[i].name)) {
          return style_specs[i].id;
      }
    }

    /* allowed abbreviations */

    if (!strcmp(s, "l")) {
      return GP_STYLE_LINES;
    } else if (!strcmp(s, "p")) {
      return GP_STYLE_POINTS;
    } else if (!strcmp(s, "lp")) {
      return GP_STYLE_LINESPOINTS;
    } else if (!strcmp(s, "i")) {
      return GP_STYLE_IMPULSES;
    } 

    /* fallback */
    return GP_STYLE_LINES;
}

int gp_style_index_from_display_name (const char *s)
{
    int i;

    for (i=0; style_specs[i].id != 0; i++) {
      if (!strcmp(s, _(style_specs[i].trname))) {
          return style_specs[i].id;
      }
    }

    return GP_STYLE_LINES;
}

gp_style_spec *get_style_spec (int t)
{
    int i;

    for (i=0; style_specs[i].id != 0; i++) {
      if (t == style_specs[i].id) {
          return &style_specs[i];
      }
    }

    return NULL;
}

static gp_key_spec key_specs[] = {
    { GP_KEY_LEFT_TOP,     N_("left top") },
    { GP_KEY_RIGHT_TOP,    N_("right top") },
    { GP_KEY_LEFT_BOTTOM,  N_("left bottom") },
    { GP_KEY_RIGHT_BOTTOM, N_("right bottom") },
    { GP_KEY_OUTSIDE,      N_("outside") },
    { GP_KEY_NONE,         N_("none") },
    { -1,                  NULL }
};

static const char *gp_keypos_string (int t)
{
    int i;

    for (i=0; key_specs[i].str != NULL; i++) {
      if (t == key_specs[i].id) {
          return key_specs[i].str;
      }
    }

    return N_("none");
}

void print_keypos_string (int t, FILE *fp)
{
    const char *s = gp_keypos_string(t);

    if (!strcmp(s, "none")) {
      fputs("set nokey\n", fp);
    } else {
      fprintf(fp, "set key %s\n", s);
    }
}

int gp_keypos_from_name (const char *s)
{
    int i;

    for (i=0; key_specs[i].id >= 0; i++) {
      if (!strcmp(s, key_specs[i].str)) {
          return key_specs[i].id;
      }
    }

    return GP_KEY_NONE;
}

int gp_keypos_from_display_name (const char *s)
{
    int i;

    for (i=0; key_specs[i].id >= 0; i++) {
      if (!strcmp(s, _(key_specs[i].str))) {
          return key_specs[i].id;
      }
    }

    return GP_KEY_NONE;
}

gp_key_spec *get_keypos_spec (int t)
{
    int i;

    for (i=0; key_specs[i].id >= 0; i++) {
      if (t == key_specs[i].id) {
          return &key_specs[i];
      }
    }

    return NULL;
}

int plotspec_add_line (GPT_SPEC *spec)
{
    GPT_LINE *lines;
    int n = spec->n_lines;

    lines = realloc(spec->lines, (n + 1) * sizeof *lines);
    if (lines == NULL) {
      return E_ALLOC;
    }

    spec->lines = lines;
    spec->n_lines += 1;

    lines[n].varnum = 0;
    lines[n].style = 0;
    lines[n].scale = 1.0;
    lines[n].title[0] = '\0';
    lines[n].formula[0] = '\0';
    lines[n].rgb[0] = '\0';
    lines[n].yaxis = 1;
    lines[n].type = LT_AUTO;
    lines[n].ptype = 0;
    lines[n].width = 1;
    lines[n].ncols = 0;
    lines[n].whiskwidth = 0;
    lines[n].flags = 0;

    return 0;
}

static void copy_line_content (GPT_LINE *targ, GPT_LINE *src)
{
    targ->varnum = src->varnum;
    targ->style = src->style;
    targ->scale = src->scale;
    strcpy(targ->title, src->title);
    strcpy(targ->formula, src->formula);
    strcpy(targ->rgb, src->rgb);
    targ->yaxis = src->yaxis;
    targ->type = src->type;
    targ->ptype = src->ptype;
    targ->width = src->width;
    targ->ncols = src->ncols;
    targ->whiskwidth = src->whiskwidth;
    targ->flags = src->flags;
}

int plotspec_delete_line (GPT_SPEC *spec, int i)
{
    GPT_LINE *lines = spec->lines;
    int j, n = spec->n_lines;

    if (i < 0 || i >= n) {
      return E_DATA;
    }

    for (j=i; j<n-1; j++) {
      copy_line_content(&lines[j], &lines[j+1]);
    }

    spec->n_lines -= 1;

    lines = realloc(spec->lines, (n - 1) * sizeof *lines);
    if (lines == NULL) {
      return E_ALLOC;
    }

    spec->lines = lines;

    return 0;
}

GPT_LINE *plotspec_clone_lines (GPT_SPEC *spec, int *err)
{
    GPT_LINE *lines = NULL;
    int i;

    if (spec->n_lines == 0) {
      /* no-op */
      return NULL;
    }

    lines = malloc(spec->n_lines * sizeof *lines);
    if (lines == NULL) {
      *err = E_ALLOC;
    } else {
      for (i=0; i<spec->n_lines; i++) {
          copy_line_content(&lines[i], &spec->lines[i]);
      }
    }

    return lines;
}

int plotspec_max_line_width (GPT_SPEC *spec)
{
    int i, lw = 0;

    for (i=0; i<spec->n_lines; i++) {
      if (spec->lines[i].width > lw) {
          lw = spec->lines[i].width;
      }
    } 

    return lw;
}

int plotspec_add_label (GPT_SPEC *spec)
{
    GPT_LABEL *labels;
    int n = spec->n_labels;

    labels = realloc(spec->labels, (n + 1) * sizeof *labels);
    if (labels == NULL) {
      return E_ALLOC;
    }

    spec->labels = labels;
    spec->n_labels += 1;

    labels[n].text[0] = '\0';
    labels[n].pos[0] = NADBL;
    labels[n].pos[1] = NADBL;
    labels[n].just = GP_JUST_LEFT;

    return 0;
}

static void copy_label_content (GPT_LABEL *targ, GPT_LABEL *src)
{
    strcpy(targ->text, src->text);
    targ->pos[0] = src->pos[0];
    targ->pos[1] = src->pos[1];
    targ->just = src->just;
}

int plotspec_delete_label (GPT_SPEC *spec, int i)
{
    GPT_LABEL *labels = spec->labels;
    int j, n = spec->n_labels;
    int err = 0;

    if (i < 0 || i >= n) {
      return E_DATA;
    }

    for (j=i; j<n-1; j++) {
      copy_label_content(&labels[j], &labels[j+1]);
    }

    spec->n_labels -= 1;

    if (spec->n_labels == 0) {
      free(spec->labels);
      spec->labels = NULL;
    } else {
      labels = realloc(spec->labels, (n - 1) * sizeof *labels);
      if (labels == NULL) {
          err = E_ALLOC;
      } else {
          spec->labels = labels;
      }
    }

    return err;
}

GPT_LABEL *plotspec_clone_labels (GPT_SPEC *spec, int *err)
{
    GPT_LABEL *labels = NULL;
    int i;

    if (spec->n_labels == 0) {
      /* no-op */
      return NULL;
    }

    labels = malloc(spec->n_labels * sizeof *labels);
    if (labels == NULL) {
      *err = E_ALLOC;
    } else {
      for (i=0; i<spec->n_labels; i++) {
          copy_label_content(&labels[i], &spec->labels[i]);
      }
    }

    return labels;
}

int plotspec_add_arrow (GPT_SPEC *spec)
{
    GPT_ARROW *arrows;
    int n = spec->n_arrows;

    arrows = realloc(spec->arrows, (n + 1) * sizeof *arrows);
    if (arrows == NULL) {
      return E_ALLOC;
    }

    spec->arrows = arrows;
    spec->n_arrows += 1;
    arrows[n].x0 = 0;
    arrows[n].y0 = 0;
    arrows[n].x1 = 0;
    arrows[n].y1 = 0;
    arrows[n].flags = 0;

    return 0;
}

static void copy_arrow_content (GPT_ARROW *targ, GPT_ARROW *src)
{
    targ->x0 = src->x0;
    targ->y0 = src->y0;
    targ->x1 = src->x1;
    targ->y1 = src->y1;
    targ->flags = src->flags;
}

int plotspec_delete_arrow (GPT_SPEC *spec, int i)
{
    GPT_ARROW *arrows = spec->arrows;
    int j, n = spec->n_arrows;
    int err = 0;

    if (i < 0 || i >= n) {
      return E_DATA;
    }

    for (j=i; j<n-1; j++) {
      copy_arrow_content(&arrows[j], &arrows[j+1]);
    }

    spec->n_arrows -= 1;

    if (spec->n_arrows == 0) {
      free(spec->arrows);
      spec->arrows = NULL;
    } else {
      arrows = realloc(spec->arrows, (n - 1) * sizeof *arrows);
      if (arrows == NULL) {
          err = E_ALLOC;
      } else {
          spec->arrows = arrows;
      }
    }

    return err;
}

GPT_ARROW *plotspec_clone_arrows (GPT_SPEC *spec, int *err)
{
    GPT_ARROW *arrows = NULL;
    int i;

    if (spec->n_arrows == 0) {
      /* no-op */
      return NULL;
    }

    arrows = malloc(spec->n_arrows * sizeof *arrows);
    if (arrows == NULL) {
      *err = E_ALLOC;
    } else {
      for (i=0; i<spec->n_arrows; i++) {
          copy_arrow_content(&arrows[i], &spec->arrows[i]);
      }
    }

    return arrows;
}

static char *escape_quotes (const char *s)
{
    if (strchr(s, '"') == NULL) {
      return NULL;
    } else {
      int qcount = 0;
      char *ret, *r;
      const char *p = s;

      while (*p) {
          if (*p == '"') qcount++;
          p++;
      }

      ret = malloc(strlen(s) + 1 + qcount);
      if (ret == NULL) {
          return NULL;
      }

      r = ret;
      while (*s) {
          if (*s == '"') {
            *r++ = '\\';
            *r++ = '"';
          } else {
            *r++ = *s;
          }
          s++;
      }
      *r = 0;

      return ret;
    }
}

const char *gp_justification_string (int j)
{
    if (j == GP_JUST_LEFT) {
      return N_("left");
    } else if (j == GP_JUST_CENTER) {
      return N_("center");
    } else if (j == GP_JUST_RIGHT) {
      return N_("right");
    } else {
      return N_("left");
    }
}

static void print_plot_labelspec (const GPT_LABEL *lbl, FILE *fp)
{
    char *label = escape_quotes(lbl->text);

    fprintf(fp, "set label \"%s\" ", (label != NULL)? 
          label : lbl->text);

    gretl_push_c_numeric_locale();

    fprintf(fp, "at %g,%g %s front\n", 
          lbl->pos[0], lbl->pos[1],
          gp_justification_string(lbl->just));

    gretl_pop_c_numeric_locale();

    if (label != NULL) {
      free(label);
    }
}

static void print_plot_arrow (const GPT_ARROW *arrow, FILE *fp)
{
    gretl_push_c_numeric_locale();
    fprintf(fp, "set arrow from %g,%g to %g,%g %s", 
          arrow->x0, arrow->y0, arrow->x1, arrow->y1,
          (arrow->flags & GP_ARROW_HEAD)? "head" : "nohead");
    if (arrow->flags & GP_ARROW_DOTS) {
      fputs(" lt 0", fp);
    }
    fputc('\n', fp);
    gretl_pop_c_numeric_locale();
}

static int print_polar_labels (const GPT_SPEC *spec, FILE *fp)
{
    double x, y;
    int t;

    fputs("# printing data labels\n", fp);

    gretl_push_c_numeric_locale();

    for (t=0; t<spec->nobs; t++) {
      if (spec->labeled != NULL && !spec->labeled[t]) {
          /* printing only specified labels */
          continue;
      }
      if (sscanf(spec->markers[t], "%lf,%lf", &x, &y) == 2) {
          fprintf(fp, "set label \"%.3f,%.3f\" at %.3f,%.3f\n", 
                x, y, x, y + .04);
      }
    }

    gretl_pop_c_numeric_locale();

    return 0;     
}

static int usable_obs (const double *x, const double *y0,
                   const double *y1, int t,
                   const double **py)
{
    *py = y0;

    if (!na(x[t]) && !na(y0[t])) {
      return 1;
    } else if (!na(x[t]) && y1 != NULL && !na(y1[t])) {
      *py = y1;
      return 1;
    } else {
      return 0;
    }
}

static int print_data_labels (const GPT_SPEC *spec, FILE *fp)
{
    const double *x, *y, *y0;
    const double *y1 = NULL;
    double xrange, yrange;
    double yoff;
    int t;

    if ((spec->flags & GPT_POLAR) && spec->markers != NULL) {
      return print_polar_labels(spec, fp);
    }

    if (spec->n_lines > 2 || 
      spec->lines[0].ncols != 2 || 
      spec->markers == NULL) {
      return 1;
    }

    x = spec->data;
    y0 = x + spec->nobs;

    if (spec->code == PLOT_FACTORIZED) {
      y1 = y0 + spec->nobs;
    }

    xrange = spec->range[GP_X_RANGE][1] - spec->range[GP_X_RANGE][0];
    yrange = spec->range[GP_Y_RANGE][1] - spec->range[GP_Y_RANGE][0];

    if (xrange == 0.0 || yrange == 0.0) {
      double ymin = 1.0e+16, ymax = -1.0e+16;
      double xmin = 1.0e+16, xmax = -1.0e+16;

      for (t=0; t<spec->nobs; t++) {
          if (usable_obs(x, y0, y1, t, &y)) {
            if (yrange == 0.0) {
                if (y[t] < ymin) {
                  ymin = y[t];
                } else if (y[t] > ymax) {
                  ymax = y[t];
                }
            }
            if (xrange == 0.0) {
                if (x[t] < xmin) {
                  xmin = x[t];
                } else if (x[t] > xmax) {
                  xmax = x[t];
                }
            }           
          }
      }
      if (yrange == 0.0) {
          yrange = ymax - ymin;
      }
      if (xrange == 0.0) {
          xrange = xmax - xmin;
      }
    }   

    yoff = 0.03 * yrange;

    fputs("# printing data labels\n", fp);

    gretl_push_c_numeric_locale();

    for (t=0; t<spec->nobs; t++) {
      double xoff = 0.0;

      if (spec->labeled != NULL && !spec->labeled[t]) {
          /* printing only specified labels */
          continue;
      }

      if (usable_obs(x, y0, y1, t, &y)) {
          if (x[t] > .90 * xrange) {
            xoff = -.02 * xrange;
          }
          fprintf(fp, "set label \"%s\" at %.8g,%.8g\n", spec->markers[t],
                x[t] + xoff, y[t] + yoff);
      }
    }

    gretl_pop_c_numeric_locale();

    return 0;
}

void print_auto_fit_string (FitType fit, FILE *fp)
{
    if (fit == PLOT_FIT_OLS) {
      fputs("# plot includes automatic fit: OLS\n", fp);
    } else if (fit == PLOT_FIT_QUADRATIC) {
      fputs("# plot includes automatic fit: quadratic\n", fp);
    } else if (fit == PLOT_FIT_CUBIC) {
      fputs("# plot includes automatic fit: cubic\n", fp);
    } else if (fit == PLOT_FIT_INVERSE) {
      fputs("# plot includes automatic fit: inverse\n", fp);
    } else if (fit == PLOT_FIT_LOESS) {
      fputs("# plot includes automatic fit: loess\n", fp);
    }
}

void print_plot_ranges_etc (const GPT_SPEC *spec, FILE *fp)
{
    const char *rstrs[] = {
      "x", "y", "y2", "t"
    };
    int i;

    gretl_push_c_numeric_locale();

    for (i=0; i<4; i++) {
      if (i < 3 && spec->logbase[i] > 0.0) {
          fprintf(fp, "set logscale %s %g\n", rstrs[i], spec->logbase[i]);
      }

      if (na(spec->range[i][0]) || na(spec->range[i][1]) ||
          spec->range[i][0] == spec->range[i][1]) {
          continue;
      }

      if ((i == GP_Y2_RANGE && !(spec->flags & GPT_Y2AXIS)) ||
          (i == GP_T_RANGE && !(spec->flags & GPT_PARAMETRIC))) {
          continue;
      }

      fprintf(fp, "set %srange [%.10g:%.10g]\n", rstrs[i], 
            spec->range[i][0], spec->range[i][1]);

      if (i == 4 && spec->code == PLOT_PROB_DIST && spec->samples == 0) {
          int ns = spec->range[i][1] - spec->range[i][0] + 1;

          fprintf(fp, "set samples %d\n", ns);
      }
    }

    if (spec->boxwidth > 0 && spec->boxwidth < 1) {
      fprintf(fp, "set boxwidth %.3f\n", (double) spec->boxwidth);
    } else if (spec->boxwidth < 0 && spec->boxwidth > -1) {
      fprintf(fp, "set boxwidth %g absolute\n", (double) -spec->boxwidth);
    }

    gretl_pop_c_numeric_locale();
}

static int blank_user_line (const GPT_SPEC *spec, int i)
{
    return ((spec->lines[i].flags & GP_LINE_USER) && 
          spec->lines[i].formula[0] == '\0');
}

static void print_user_lines_info (const GPT_SPEC *spec, FILE *fp)
{
    int i, n = 0;

    for (i=0; i<spec->n_lines; i++) {
      if (spec->lines[i].flags & GP_LINE_USER) {
          n++;
      }
    }

    if (n > 0) {
      fprintf(fp, "# %d user-defined lines: ", n);
      for (i=0; i<spec->n_lines; i++) {
          if (spec->lines[i].flags & GP_LINE_USER) {
            fprintf(fp, "%d ", i);
          }
      }
      fputc('\n', fp);
    }
}

static int more_lines (const GPT_SPEC *spec, int i, int skipline)
{
    if (i == spec->n_lines - 1) {
      /* at last line */
      return 0;
    } else {
      int j;

      for (j=i+1; j<spec->n_lines; j++) {
          if (j != skipline && !blank_user_line(spec, j)) {
            return 1;
          }
      }
      return 0;
    }
}

static void print_linestyle (const GPT_SPEC *spec, int i, FILE *fp)
{
    GPT_LINE *line;
    int done = 0;

    fprintf(fp, "set style line %d ", i+1);

    if (i < spec->n_lines) {
      line = &spec->lines[i];
      if (*line->rgb != '\0' && line->type != LT_AUTO) {
          fprintf(fp, "lc rgb \"%s\" lt %d\n", line->rgb, line->type);
          done = 1;
      } else if (*line->rgb != '\0') {
          fprintf(fp, "lc rgb \"%s\"\n", line->rgb);
          done = 1;
      }
    }

    if (!done) {
      const gretlRGB *color = get_graph_color(i);
      char cstr[8];

      print_rgb_hash(cstr, color);
      fprintf(fp, "lc rgb \"%s\"\n", cstr);
    }
}

static int any_filledcurve (const GPT_SPEC *spec)
{
    int i;

    for (i=0; i<spec->n_lines; i++) {
      if (spec->lines[i].style == GP_STYLE_FILLEDCURVE) {
          return 1;
      }
    }

    return 0;
}

static void write_styles_from_plotspec (const GPT_SPEC *spec, FILE *fp)
{
    char cstr[8];
    int i;
    
    if (frequency_plot_code(spec->code)) {
      const gretlRGB *color = get_graph_color(BOXCOLOR);

      print_rgb_hash(cstr, color);
      fprintf(fp, "set style line 1 lc rgb \"%s\"\n", cstr);
      fputs("set style line 2 lc rgb \"#000000\"\n", fp);
    } else if (spec->code == PLOT_RQ_TAU) {
      fputs("set style line 1 lc rgb \"#000000\"\n", fp);
      for (i=1; i<BOXCOLOR; i++) {
          print_linestyle(spec, i, fp);
      }
    } else {
      for (i=0; i<BOXCOLOR; i++) {
          print_linestyle(spec, i, fp);
      }
    }

    if (spec->nbars > 0 || any_filledcurve(spec)) {
      const gretlRGB *color = get_graph_color(SHADECOLOR);

      print_rgb_hash(cstr, color);
      fprintf(fp, "set style line %d lc rgb \"%s\"\n", 
            SHADECOLOR + 1, cstr);
    }

    fputs("set style increment user\n", fp);
}

static int print_point_type (GPT_LINE *line)
{
    return line->ptype != 0 && 
      (line->style == GP_STYLE_POINTS ||
       line->style == GP_STYLE_LINESPOINTS);
}

#define show_fit(s) (s->fit == PLOT_FIT_OLS || \
                     s->fit == PLOT_FIT_QUADRATIC || \
                 s->fit == PLOT_FIT_CUBIC ||     \
                     s->fit == PLOT_FIT_INVERSE || \
                     s->fit == PLOT_FIT_LOESS)

int plotspec_print (GPT_SPEC *spec, FILE *fp)
{
    int i, k, t;
    int png = get_png_output(spec);
    int mono = (spec->flags & GPT_MONO);
    int started_data_lines = 0;
    double xt1 = 0, xt2 = 0;
    double et, yt;
    double *x[5];
    int skipline = -1;
    int any_y2 = 0;
    int miss = 0;

    if (spec->pd > 0) {
      fprintf(fp, "# timeseries %d", spec->pd);
      if (spec->flags & GPT_LETTERBOX) {
          fputs(" (letterbox)\n", fp);
      } else {
          fputc('\n', fp);
      }
    }

    if (!mono) {
      write_styles_from_plotspec(spec, fp);
    }

    if (!string_is_blank(spec->titles[0])) {
      fprintf(fp, "set title \"%s\"\n", spec->titles[0]);
    }

    if (!string_is_blank(spec->titles[1])) {
      fprintf(fp, "set xlabel \"%s\"\n", spec->titles[1]);
    }

    if (!string_is_blank(spec->titles[2])) {
      fprintf(fp, "set ylabel \"%s\"\n", spec->titles[2]);
    }

    if ((spec->flags & GPT_Y2AXIS) && !string_is_blank(spec->titles[3])) {
      fprintf(fp, "set y2label \"%s\"\n", spec->titles[3]);
    }

    for (i=0; i<spec->n_labels; i++) {
      if (!string_is_blank(spec->labels[i].text)) {
          print_plot_labelspec(&spec->labels[i], fp);
      }
    }

    for (i=0; i<spec->n_arrows; i++) {
      print_plot_arrow(&spec->arrows[i], fp);
    }    

    if (spec->flags & GPT_XZEROAXIS) {
      fputs("set xzeroaxis\n", fp);
    }

    if (spec->flags & GPT_YZEROAXIS) {
      fputs("set yzeroaxis\n", fp);
    } 

    if (spec->flags & GPT_GRID) {
      fputs("set grid\n", fp);
    }     

    if (spec->flags & GPT_PARAMETRIC) {
      fputs("set parametric\n", fp);
      if (spec->samples > 0) {
          fprintf(fp, "set samples %d\n", spec->samples);
      }
    }

    if (spec->flags & GPT_POLAR) {
      fputs("unset ytics\n", fp);
      fputs("set size square\n", fp);
      fputs("set polar\n", fp);
    }

    gnuplot_missval_string(fp);

    if (spec->keyspec == GP_KEY_NONE) {
      fputs("set nokey\n", fp);
    } else {
      fprintf(fp, "set key %s\n", gp_keypos_string(spec->keyspec));
    }

    print_plot_ranges_etc(spec, fp);

    /* special x and/or y format? */
    if (*spec->xfmt != '\0') {
      fprintf(fp, "set format x \"%s\"\n", spec->xfmt);
    }
    if (*spec->yfmt != '\0') {
      fprintf(fp, "set format y \"%s\"\n", spec->yfmt);
    }

    /* customized xtics? */
    if (!strcmp(spec->xtics, "none")) {
      fputs("set noxtics\n", fp);
    } else {
      if (!string_is_blank(spec->xtics)) {
          fprintf(fp, "set xtics %s\n", spec->xtics);
      }
      if (!string_is_blank(spec->mxtics)) {
          fprintf(fp, "set mxtics %s\n", spec->mxtics);
      }
    }

    /* customized ytics? */
    if (!strcmp(spec->ytics, "none")) {
      fputs("set noytics\n", fp);
    } else {
      if (!string_is_blank(spec->ytics)) {
          fprintf(fp, "set ytics %s\n", spec->ytics);
      }
    }    

    if (spec->flags & GPT_Y2AXIS) {
      /* using two y axes */
      fputs("set ytics nomirror\n", fp);
      fputs("set y2tics\n", fp);
    } else if (spec->border != GP_BORDER_DEFAULT) {
      /* suppressing all or part of border */
      if (spec->border == 0) {
          fputs("unset border\n", fp);
      } else {
          fprintf(fp, "set border %d\n", spec->border);
      }
      if (string_is_blank(spec->xtics)) {
          fputs("set xtics nomirror\n", fp);
      }
      if (string_is_blank(spec->ytics)) {
          fputs("set ytics nomirror\n", fp);
      }
    }

    if (spec->bmargin > 0) {
      fprintf(fp, "set bmargin %d\n", spec->bmargin);
    }

    /* in case of plots that are editable (see gui client), it is
       important to write out the comment string that identifies the
       sort of graph, so that it will be recognized by type when
       it is redisplayed */

    write_plot_type_string(spec->code, fp);

    if (spec->n_literal > 0) {
      fprintf(fp, "# literal lines = %d\n", spec->n_literal);
      for (i=0; i<spec->n_literal; i++) {
          if (spec->literal[i] != NULL && *spec->literal[i] != '\0') {
            fprintf(fp, "%s\n", spec->literal[i]);
          } else {
            fputs("# empty line!\n", fp);
          }
      }
    }

    if (show_fit(spec)) {
      print_auto_fit_string(spec->fit, fp);
    }

    if (spec->bars != NULL) {
      plotspec_get_xt1_xt2(spec, &xt1, &xt2);
      spec->nbars = n_bars_shown(xt1, xt2, spec->bars);
      if (spec->nbars > 0) {
          fprintf(fp, "# n_bars = %d\n", spec->nbars);
      }
    }

    print_user_lines_info(spec, fp);

    if ((spec->code == PLOT_FREQ_SIMPLE ||
       spec->code == PLOT_FREQ_NORMAL ||
       spec->code == PLOT_FREQ_GAMMA)) {
      if (mono) {
          fputs("set style fill solid 0.3\n", fp);
      } else {
          fputs("set style fill solid 0.6\n", fp);
      }
    } else if (spec->code == PLOT_FORECAST) {
      fputs("set style fill solid 0.4\n", fp);
    } 

    if (spec->flags & GPT_PRINT_MARKERS) {
      print_data_labels(spec, fp);
    }

    if (spec->flags & GPT_FIT_HIDDEN) {
      skipline = 1;
    }

    fputs("plot \\\n", fp);

    for (i=0; i<spec->n_lines; i++) {
      if (i == skipline || blank_user_line(spec, i)) {
          continue;
      }
      if ((spec->flags & GPT_Y2AXIS) && spec->lines[i].yaxis != 1) {
          any_y2 = 1;
          break;
      }
    }

    gretl_push_c_numeric_locale();

    if (spec->nbars > 0) {
      print_bars_header(spec->nbars, fp);
    }

    for (i=0; i<spec->n_lines; i++) {
      GPT_LINE *line = &spec->lines[i];

      if (i == skipline || blank_user_line(spec, i)) {
          if (i < spec->n_lines - 1) {
            continue;
          } else {
            break;
          }
      }

      if (na(line->scale)) {
          fprintf(fp, "%s ", line->formula); 
      } else if (line->scale == 1.0) {
          fputs("'-' using 1", fp);
          if (line->ncols == 5) {
            /* Note: boxplot candlesticks, hard-wired! */
            fputs(":3:2:5:4", fp);
          } else if (line->ncols == 2) {
            if (line->flags & GP_LINE_BOXDATA) {
                /* boxplot median, hard-wired */
                fputs(":2:2:2:2", fp);
            } else {
                fputs(":($2)", fp);
            }
          } else {
            for (k=2; k<=line->ncols; k++) {
                fprintf(fp, ":%d", k);
            }
          }
          fputc(' ', fp);
      } else {
          fprintf(fp, "'-' using 1:($2*%g) ", line->scale);
      }

      if ((spec->flags & GPT_Y2AXIS) && line->yaxis != 1) {
          fprintf(fp, "axes x1y%d ", line->yaxis);
      }

      if (*line->title == '\0') {
          fputs("notitle ", fp);
      } else {
          fprintf(fp, "title \"%s", line->title);
          if (any_y2) {
            if (line->yaxis == 1) {
                fprintf(fp, " (%s)\" ", _("left"));
            } else {
                fprintf(fp, " (%s)\" ", _("right"));
            }
          } else {
            fputs("\" ", fp);
          }
      }

      fprintf(fp, "w %s", gp_line_style_name(line->style));

      if (line->type != LT_AUTO) {
          fprintf(fp, " lt %d", line->type);
      } else if (spec->nbars > 0) {
          fprintf(fp, " lt %d", i + 1);
      }

      if (print_point_type(line)) {
          fprintf(fp, " pt %d", line->ptype);
      }

      if (line->width != 1) {
          fprintf(fp, " lw %d", line->width);
      }

      if (line->whiskwidth > 0) {
          fprintf(fp, " whiskerbars %g", line->whiskwidth);
      }

      if (more_lines(spec, i, skipline)) {
          fputs(", \\", fp);
      } 

      fputc('\n', fp);
    } 

    miss = 0;

    /* supply the data to gnuplot inline */

    if (spec->bars != NULL && spec->nbars > 0) {
      print_plotbars(spec->bars, fp);
    }

    for (i=0; i<spec->n_lines; i++) { 
      int j, ncols = spec->lines[i].ncols;

      if (ncols == 0) {
          /* no data to print */
          continue;
      }

      if (i == skipline) {
          continue;
      }

      if (!started_data_lines) {
          x[0] = spec->data;
          /* see below for subsequent adjustment of x[1] */
          x[1] = x[0] + spec->nobs;
          started_data_lines = 1;
      } 

      x[2] = x[1] + spec->nobs;
      x[3] = x[2] + spec->nobs;
      x[4] = x[3] + spec->nobs;

      for (t=0; t<spec->nobs; t++) {
          /* print x-axis value */
          if (na(x[0][t])) {
            fputs("? ", fp);
            miss = 1;
          } else {
            fprintf(fp, "%.10g ", x[0][t]);
          }

          /* conversion, if needed, between (y, ydelta) and
             (ylow, yhigh)
           */
          if (spec->lines[i].ncols == 3) {
            if (spec->flags & GPT_FILL_SWITCH) { 
                yt = x[1][t];
                et = x[2][t];
                if (!na(yt) && !na(et)) {
                  x[1][t] = yt - et;
                  x[2][t] = yt + et;
                }
            } else if (spec->flags & GPT_ERR_SWITCH) {
                if (!na(x[1][t]) && !na(x[2][t])) {
                  et = (x[2][t] - x[1][t]) / 2.0;
                  yt = x[1][t] + et;
                  x[1][t] = yt;
                  x[2][t] = et;
                }
            }
          } 

          /* print y-axis value(s) */
          for (j=1; j<ncols; j++) {
            if (na(x[j][t])) {
                fputs("? ", fp);
                miss = 1;
            } else {
                fprintf(fp, "%.10g ", x[j][t]);
            }
          }

          if (spec->markers != NULL && i == 0) {
            fprintf(fp, " # %s", spec->markers[t]);
          }

          fputc('\n', fp);
      }

      fputs("e\n", fp);

      x[1] += (ncols - 1) * spec->nobs;
    }

    gretl_pop_c_numeric_locale();

    if (png && gnuplot_has_bbox()) {
      print_plot_bounding_box_request(fp);
    }

    return miss;
}

static int set_loess_fit (GPT_SPEC *spec, int d, double q, gretl_matrix *x,
                    gretl_matrix *y, gretl_matrix *yh)
{
    int t, T = gretl_vector_get_length(y);
    double *data;

    data = realloc(spec->data, 3 * T * sizeof *data);
    if (data == NULL) {
      return E_ALLOC;
    }

    for (t=0; t<T; t++) {
      data[t] = x->val[t];
      data[t+T] = y->val[t];
      data[t+2*T] = yh->val[t];
    }

    spec->data = data;
    spec->nobs = spec->okobs = T;

    sprintf(spec->lines[1].title, _("loess fit, d = %d, q = %g"), d, q);
    spec->lines[1].scale = 1.0;
    spec->lines[1].style = GP_STYLE_LINES;
    spec->lines[1].ncols = 2;

    spec->fit = PLOT_FIT_LOESS;

    return 0;
}

static void set_plotfit_formula (char *formula, FitType f, const double *b,
                         double t0, double pd)
{
    gretl_push_c_numeric_locale();

    /* if t0 is not NA that indicates there we're doing a fitted 
       plot against time, and we have to transform the
       coefficients
    */

    if (f == PLOT_FIT_OLS) {
      if (!na(t0)) {
          double c = b[1] * pd;

          sprintf(formula, "%.10g + %.10g*x", b[0] - c*t0, c);
      } else {
          sprintf(formula, "%.10g + %.10g*x", b[0], b[1]);
      }
    } else if (f == PLOT_FIT_QUADRATIC) {
      if (!na(t0)) {
          double c = b[1] * pd;
          double g = b[2] * pd * pd;

          sprintf(formula, "%.10g + %.10g*x + %.10g*x**2", 
                b[0] - c*t0 + g*t0*t0, c - 2*g*t0, g);
      } else {
          sprintf(formula, "%.10g + %.10g*x + %.10g*x**2", b[0], b[1], b[2]);
      }
    } else if (f == PLOT_FIT_CUBIC) {     
      if (!na(t0)) {
          double c = b[1] * pd;
          double g = b[2] * pd * pd;
          double h = b[3] * pd * pd * pd;

          sprintf(formula, "%.13g + %.10g*x + %.10g*x**2 + %.10g*x**3", 
                b[0] - c*t0 + g*t0*t0 - h*t0*t0*t0, 
                c - 2*g*t0 + 3*h*t0*t0, 
                g - 3*h*t0, h);
      } else {
          sprintf(formula, "%.10g + %.10g*x + %.10g*x**2 + %.10g*x**3", 
                b[0], b[1], b[2], b[3]);
      }     
    } else if (f == PLOT_FIT_INVERSE) {
      if (!na(t0)) {
          double c = t0 * pd;

          sprintf(formula, "%.10g + %.10g/(%g*x - %.10g)", b[0], b[1], 
                pd, c);
      } else {
          sprintf(formula, "%.10g + %.10g/x", b[0], b[1]);
      }
    }

    gretl_pop_c_numeric_locale();
}

void set_plotfit_line (char *title, char *formula,
                   FitType f, const double *b, 
                   double x0, double pd)
{
    char xc = (na(x0)) ? 'X' : 't';

    /* first compose the key string for the fitted line */

    if (f == PLOT_FIT_OLS) {
      sprintf(title, "Y = %#.3g %c %#.3g%c", b[0],
            (b[1] > 0)? '+' : '-', fabs(b[1]), xc);
    } else if (f == PLOT_FIT_QUADRATIC) {
      sprintf(title, "Y = %#.3g %c %#.3g%c %c %#.3g%c^2", b[0],
            (b[1] > 0)? '+' : '-', fabs(b[1]), xc,
            (b[2] > 0)? '+' : '-', fabs(b[2]), xc);
    } else if (f == PLOT_FIT_CUBIC) {
      sprintf(title, "Y = %#.3g %c %#.3g%c %c %#.3g%c^2 %c %#.3g%c^3", 
            b[0], (b[1] > 0)? '+' : '-', fabs(b[1]), xc,
            (b[2] > 0)? '+' : '-', fabs(b[2]), xc,
            (b[3] > 0)? '+' : '-', fabs(b[3]), xc);
    } else if (f == PLOT_FIT_INVERSE) {
      sprintf(title, "Y = %#.3g %c %#.3g(1/%c)", b[0],
            (b[1] > 0)? '+' : '-', fabs(b[1]), xc);
    }

    /* then set the formula itself */

    set_plotfit_formula(formula, f, b, x0, pd);
}

static void plotspec_set_fitted_line (GPT_SPEC *spec, FitType f, double x0)
{
    char *formula = spec->lines[1].formula;
    char *title = spec->lines[1].title;
    double pd = spec->pd;
    const double *b;

    if (f == PLOT_FIT_OLS) {
      b = spec->b_ols->val;
    } else if (f == PLOT_FIT_QUADRATIC) {
      b = spec->b_quad->val;
    } else if (f == PLOT_FIT_CUBIC) {
      b = spec->b_cub->val;
    } else if (f == PLOT_FIT_INVERSE) {
      b = spec->b_inv->val;
    } else {
      return;
    }

    set_plotfit_line(title, formula, f, b, x0, pd);

    spec->fit = f;
    spec->lines[1].scale = NADBL;
    spec->lines[1].style = GP_STYLE_LINES;
    spec->lines[1].ncols = 0;
}

#define polyfit(f) (f == PLOT_FIT_OLS || \
                f == PLOT_FIT_QUADRATIC ||      \
                f == PLOT_FIT_CUBIC)

int plotspec_add_fit (GPT_SPEC *spec, FitType f)
{
    gretl_matrix *y = NULL;
    gretl_matrix *X = NULL;
    gretl_matrix *b = NULL;
    gretl_matrix *yh = NULL;
    const double *px = spec->data;
    const double *py;
    int T = spec->okobs;
    double x0 = NADBL;
    double xt, q = 0.5;
    int d = 1;
    int i, t, k;
    int err = 0;

    if ((spec->flags & GPT_TS) && polyfit(f)) {
      if (spec->pd == 1 || spec->pd == 4 || spec->pd == 12) {
          x0 = px[0];
      }
    } 

    if ((f == PLOT_FIT_OLS && spec->b_ols != NULL) ||
      (f == PLOT_FIT_QUADRATIC && spec->b_quad != NULL) ||
      (f == PLOT_FIT_CUBIC && spec->b_cub != NULL) ||
      (f == PLOT_FIT_INVERSE && spec->b_inv != NULL)) {
      /* just activate existing setup */
      plotspec_set_fitted_line(spec, f, x0);
      return 0;
    }
      
    if (f == PLOT_FIT_OLS || f == PLOT_FIT_INVERSE) {
      k = 2;
    } else if (f == PLOT_FIT_QUADRATIC) {
      k = 3;
    } else if (f == PLOT_FIT_CUBIC) {
      k = 4;
    } else if (f == PLOT_FIT_LOESS) {
      k = 1;
    } else {
      return E_DATA;
    }

    y = gretl_column_vector_alloc(T);
    X = gretl_matrix_alloc(T, k);
    if (y == NULL || X == NULL) {
      err = E_ALLOC;
      goto bailout;
    }

    if (f != PLOT_FIT_LOESS) {
      b = gretl_column_vector_alloc(k);
      if (b == NULL) {
          err = E_ALLOC;
          goto bailout;
      }
    }

    px = spec->data;
    py = px + spec->nobs;

    i = 0;
    for (t=0; t<spec->nobs; t++) {
      if (!na(x0)) {
          xt = t;
      } else {
          xt = px[t];
      }
      if (!na(py[t]) && !na(xt)) {
          y->val[i] = py[t];
          if (f == PLOT_FIT_LOESS) {
            gretl_matrix_set(X, i, 0, xt);
          } else {
            gretl_matrix_set(X, i, 0, 1.0);
            if (f == PLOT_FIT_INVERSE) {
                gretl_matrix_set(X, i, 1, 1.0 / xt);
            } else {
                gretl_matrix_set(X, i, 1, xt);
            }
            if (f == PLOT_FIT_QUADRATIC || f == PLOT_FIT_CUBIC) {
                gretl_matrix_set(X, i, 2, xt * xt);
            }
            if (f == PLOT_FIT_CUBIC) {
                gretl_matrix_set(X, i, 3, xt * xt * xt);
            }           
          }
          i++;
      }
    }

    if (f == PLOT_FIT_LOESS) {
      err = sort_pairs_by_x(X, y, NULL, spec->markers);
      if (!err) {
          yh = loess_fit(X, y, d, q, OPT_R, &err);
      }
    } else {
      err = gretl_matrix_ols(y, X, b, NULL, NULL, NULL);
    }

    if (!err && spec->n_lines == 1) {
      err = plotspec_add_line(spec);
    }

    if (!err) {
      if (f == PLOT_FIT_OLS) {
          spec->b_ols = b;
          b = NULL;
      } else if (f == PLOT_FIT_QUADRATIC) {
          spec->b_quad = b;
          b = NULL;
      } else if (f == PLOT_FIT_CUBIC) {
          spec->b_cub = b;
          b = NULL;
      } else if (f == PLOT_FIT_INVERSE) {
          spec->b_inv = b;
          b = NULL;
      }         
    }

    if (!err) {
      if (f == PLOT_FIT_LOESS) {
          set_loess_fit(spec, d, q, X, y, yh);
      } else {
          plotspec_set_fitted_line(spec, f, x0);
      }
    }

 bailout:
    
    gretl_matrix_free(y);
    gretl_matrix_free(X);
    gretl_matrix_free(b);
    gretl_matrix_free(yh);

    return err;
}

/* next: apparatus for producing shaded bars in time-series
   plots */

#define BDEBUG 0

static plotbars *plotbars_new (int n)
{
    plotbars *bars = malloc(sizeof *bars);

    if (bars != NULL) {
      bars->dx = doubles_array_new(n, 2);
      if (bars->dx == NULL) {
          free(bars);
          bars = NULL;
      } else {
          bars->n = n;
          bars->t1 = bars->t2 = 0;
          bars->ymin = bars->ymax = 0;
      }
    }

    return bars;
}

/* Read and check a plain text "plotbars" file.  Such a file may
   contain comment lines starting with '#'; other than comments, each
   line should contain a pair of space-separated date strings in gretl
   monthly date format (YYYY:MM).  These strings represent,
   respectively, the start and end of an episode of some kind
   (paradigm case: peak and trough of business cycle).  Each pair may
   be used to draw a vertical bar on a time-series plot. The file can
   contain any number of such pairs.  An example is provided in
   <prefix>/share/data/plotbars/nber.txt.

   The dates are converted internally into the format, year plus
   decimal fraction of year, and may be used when plotting
   annual, quarterly or monthly time series.
*/

static plotbars *parse_bars_file (const char *fname, 
                          int *err)
{
    FILE *fp;
    plotbars *bars = NULL;
    char line[128];
    char d1[16], d2[16];
    int gotcolon = 0;
    int gotother = 0;
    int n = 0;

    fp = gretl_fopen(fname, "r");
    if (fp == NULL) {
      *err = E_FOPEN;
      return NULL;
    }

#if BDEBUG > 1
    fprintf(stderr, "parse_bars_file: '%s'\n", fname);
#endif

    /* first count the data lines */

    while (fgets(line, sizeof line, fp)) {
      if (*line == '#') {
          continue;
      }
      if (sscanf(line, "%15s %15s", d1, d2) != 2) {
          break;
      }
      if (strchr(d1, ':') || strchr(d2, ':')) {
          gotcolon = 1;
      }
      if (strchr(d1, '/') || strchr(d2, '/') ||
          strchr(d1, '-') || strchr(d2, '-')) {
          gotother = 1;
      }
      n++;
    }

    /* initial check and allocation */

    if (n == 0 || !gotcolon || gotother) {
      /* FIXME relax this? */
      *err = E_DATA;
    } else if (n == 0 || (gotcolon && gotother)) {
      *err = E_DATA;
    } else {
      bars = plotbars_new(n);
      if (bars == NULL) {
          *err = E_ALLOC;
      }
    }

    if (*err == 0) {
      double x0, x1;
      int di[4], nf0, nf1;
      int i = 0;

      rewind(fp);

      /* now read, check, convert and record the date pairs */

      while (fgets(line, sizeof line, fp) && !*err) {
          if (*line == '#') {
            continue;
          }
          if (sscanf(line, "%15s %15s", d1, d2) != 2) {
            break;
          }
          nf0 = nf1 = 0;
          if (gotcolon) {
            nf0 = sscanf(d1, "%d:%d", &di[0], &di[1]);
            nf1 = sscanf(d2, "%d:%d", &di[2], &di[3]);
          }
          if (nf0 != 2 || nf1 != 2) {
            *err = E_DATA;
          } else {
            x0 = di[0] + (di[1] - 1.0) / 12;
            x1 = di[2] + (di[3] - 1.0) / 12;
#if BDEBUG > 1
            fprintf(stderr, "%.4f %.4f\n", x0, x1);
#endif
            if (x1 < x0) {
                *err = E_DATA;
            } else {
                bars->dx[i][0] = x0;
                bars->dx[i][1] = x1;
                i++;
            }
          }
      }
    }

    fclose(fp);

    if (*err == E_DATA) {
      gretl_errmsg_set(_("Dates file does not conform to the specification"));
    }

    if (*err && bars != NULL) {
      plotbars_free(bars);
      bars = NULL;
    }

    return bars;
}

/* output data representing vertical shaded bars: each
   bar is represented by a pair of rows */

static void print_plotbars (plotbars *bars, FILE *fp)
{
    double y0 = bars->ymin;
    double y1 = bars->ymax;
    int i, started, stopped;

    for (i=0; i<bars->n; i++) {
      if (bars->dx[i][1] < bars->t1) {
          continue;
      }
      if (bars->dx[i][0] > bars->t2) {
          break;
      }
      started = stopped = 0;
      if (bars->dx[i][0] >= bars->t1) {
          /* start is in range */
          fprintf(fp, "%.3f %.10g %.10g\n", bars->dx[i][0], y0, y1);
          started = 1;
      }
      if (bars->dx[i][1] <= bars->t2) {
          /* stop is in range */
          if (!started) {
            /* but the start was not */
            fprintf(fp, "%.3f %.10g %.10g\n", bars->t1, y0, y1);
          }
          fprintf(fp, "%.3f %.10g %.10g\n", bars->dx[i][1], y0, y1);
          fputs("e\n", fp);
          stopped = 1;
      }
      if (started && !stopped) {
          /* truncated */
          fprintf(fp, "%.3f %.10g %.10g\n", bars->t2, y0, y1);
          fputs("e\n", fp);
      }
    }
}

/* output special plot lines for creating vertical shaded bars
   in a time-series graph: the corresponding data will take
   the form x:ymin:ymax */

static void print_bars_header (int n, FILE *fp)
{
    int i;

    for (i=0; i<n; i++) {
      fprintf(fp, "'-' using 1:2:3 notitle lt %d w filledcurve , \\\n", 
            SHADECOLOR + 1);
    }
}

/* given the info in @bars, calculate how many of its start-stop
   pairs fall (at least partially) within the current x-axis
   range */

static int n_bars_shown (double xmin, double xmax, plotbars *bars)
{
    double **dx = bars->dx;
    int i, n = 0;

    for (i=0; i<bars->n; i++) {
      if (dx[i][1] < xmin) {
          continue;
      } else if (dx[i][0] > xmax) {
          break;
      } else if (dx[i][0] >= xmin || dx[i][1] <= xmax) {
          n++;
      }
    } 

    bars->t1 = xmin;
    bars->t2 = xmax;

#if BDEBUG
    fprintf(stderr, "n_bars_shown: n = %d\n", n);
#endif

    return n;
}

/* Given the limits of the data area of a plot, @xmin et al,
   and the name of a plain text file containing "bars"
   information in the form of a set of start-stop pairs,
   try attaching this information to @spec. We fail if
   there's something wrong with the info in the file, or
   if none of the bars defined therein would be visible
   in the current range, @xmin to @xmax.
*/

int plotspec_add_bars_info (GPT_SPEC *spec, 
                      double xmin, double xmax,
                      double ymin, double ymax,
                      const char *fname)
{
    plotbars *bars = NULL;
    int err = 0;

    if (spec->bars != NULL) {
      /* clear out any stale info */
      plotbars_free(bars);
      spec->bars = NULL;
      spec->nbars = 0;
    }

    bars = parse_bars_file(fname, &err);

    if (!err) {
      int n = n_bars_shown(xmin, xmax, bars);

#if BDEBUG
      fprintf(stderr, "plotspec_add_bars_info:\n"
            " xmin=%g, xmax=%g, n=%d, ymin=%g, ymax=%g\n",
            xmin, xmax, n, ymin, ymax);
#endif
      if (n > 0) {
          spec->bars = bars;
          bars->ymin = ymin;
          bars->ymax = ymax;
          spec->nbars = n;
      } else {
          plotbars_free(bars);
      }
    }

    return err;
}

/* the following is a public interface because it's also
   used when reconstituting @spec from a gnuplot command
   file.
*/

int plotspec_allocate_bars (GPT_SPEC *spec)
{ 
    int err = 0;

    spec->bars = plotbars_new(spec->nbars);
    if (spec->bars == NULL) {
      err = E_ALLOC;
    }  

    return err;
}

/* for use when reconstituting @spec from a gnuplot
   command file: set the start/stop values for a
   particular bar @i.
*/

int plotspec_set_bar_info (GPT_SPEC *spec, int i,
                     double t1, double t2)
{ 
    if (i < spec->bars->n) {
      spec->bars->dx[i][0] = t1;
      spec->bars->dx[i][1] = t2; 
      return 0;
    } else {
      return E_DATA;
    }
}

void plotspec_set_bars_limits (GPT_SPEC *spec, 
                         double t1, double t2,
                         double ymin, double ymax)
{
    if (spec->bars != NULL) {
      spec->bars->t1 = t1;
      spec->bars->t2 = t2;
      spec->bars->ymin = ymin;
      spec->bars->ymax = ymax;
    }
}

void plotspec_remove_bars (GPT_SPEC *spec)
{
    plotbars_free(spec->bars);
    spec->bars = NULL;
    spec->nbars = 0;
}

Generated by  Doxygen 1.6.0   Back to index