src/frequencies.q

   1 /* PSPP - computes sample statistics.
   2    Copyright (C) 1997-9, 2000 Free Software Foundation, Inc.
   3    Written by Ben Pfaff <blp@gnu.org>.
   4
   5    This program is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU General Public License as
   7    published by the Free Software Foundation; either version 2 of the
   8    License, or (at your option) any later version.
   9
  10    This program is distributed in the hope that it will be useful, but
  11    WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program; if not, write to the Free Software
  17    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  18    02110-1301, USA. */
  19
  20 /*
  21   TODO:
  22
  23   * Remember that histograms, bar charts need mean, stddev.
  24 */
  25
  26 #include <config.h>
  27 #include "error.h"
  28 #include <math.h>
  29 #include <stdlib.h>
  30 #include <gsl/gsl_histogram.h>
  31
  32 #include "alloc.h"
  33 #include "bitvector.h"
  34 #include "case.h"
  35 #include "dictionary.h"
  36 #include "hash.h"
  37 #include "pool.h"
  38 #include "command.h"
  39 #include "lexer.h"
  40 #include "moments.h"
  41 #include "error.h"
  42 #include "algorithm.h"
  43 #include "magic.h"
  44 #include "misc.h"
  45 #include "output.h"
  46 #include "som.h"
  47 #include "str.h"
  48 #include "tab.h"
  49 #include "value-labels.h"
  50 #include "var.h"
  51 #include "vfm.h"
  52 #include "settings.h"
  53 #include "chart.h"
  54
  55 #include "gettext.h"
  56 #define _(msgid) gettext (msgid)
  57 #define N_(msgid) msgid
  58
  59 /* (headers) */
  60
  61 #include "debug-print.h"
  62
  63 /* (specification)
  64    FREQUENCIES (frq_):
  65      *variables=custom;
  66      format=cond:condense/onepage(*n:onepage_limit,"%s>=0")/!standard,
  67             table:limit(n:limit,"%s>0")/notable/!table,
  68             labels:!labels/nolabels,
  69             sort:!avalue/dvalue/afreq/dfreq,
  70             spaces:!single/double,
  71             paging:newpage/!oldpage;
  72      missing=miss:include/!exclude;
  73      barchart(ba_)=:minimum(d:min),
  74             :maximum(d:max),
  75             scale:freq(*n:freq,"%s>0")/percent(*n:pcnt,"%s>0");
  76      piechart(pie_)=:minimum(d:min),
  77             :maximum(d:max),
  78             missing:missing/!nomissing;
  79      histogram(hi_)=:minimum(d:min),
  80             :maximum(d:max),
  81             scale:freq(*n:freq,"%s>0")/percent(*n:pcnt,"%s>0"),
  82             norm:!nonormal/normal,
  83             incr:increment(d:inc,"%s>0");
  84      hbar(hb_)=:minimum(d:min),
  85             :maximum(d:max),
  86             scale:freq(*n:freq,"%s>0")/percent(*n:pcnt,"%s>0"),
  87             norm:!nonormal/normal,
  88             incr:increment(d:inc,"%s>0");
  89      grouped=custom;
  90      ntiles=integer;
  91      +percentiles = double list;
  92      statistics[st_]=1|mean,2|semean,3|median,4|mode,5|stddev,6|variance,
  93             7|kurtosis,8|skewness,9|range,10|minimum,11|maximum,12|sum,
  94             13|default,14|seskewness,15|sekurtosis,all,none.
  95 */
  96 /* (declarations) */
  97 /* (functions) */
  98
  99 /* Statistics. */
 100 enum
 101   {
 102     frq_mean = 0, frq_semean, frq_median, frq_mode, frq_stddev, frq_variance,
 103     frq_kurt, frq_sekurt, frq_skew, frq_seskew, frq_range, frq_min, frq_max,
 104     frq_sum, frq_n_stats
 105   };
 106
 107 /* Description of a statistic. */
 108 struct frq_info
 109   {
 110     int st_indx;                /* Index into a_statistics[]. */
 111     const char *s10;            /* Identifying string. */
 112   };
 113
 114 /* Table of statistics, indexed by dsc_*. */
 115 static struct frq_info st_name[frq_n_stats + 1] =
 116 {
 117   {FRQ_ST_MEAN, N_("Mean")},
 118   {FRQ_ST_SEMEAN, N_("S.E. Mean")},
 119   {FRQ_ST_MEDIAN, N_("Median")},
 120   {FRQ_ST_MODE, N_("Mode")},
 121   {FRQ_ST_STDDEV, N_("Std Dev")},
 122   {FRQ_ST_VARIANCE, N_("Variance")},
 123   {FRQ_ST_KURTOSIS, N_("Kurtosis")},
 124   {FRQ_ST_SEKURTOSIS, N_("S.E. Kurt")},
 125   {FRQ_ST_SKEWNESS, N_("Skewness")},
 126   {FRQ_ST_SESKEWNESS, N_("S.E. Skew")},
 127   {FRQ_ST_RANGE, N_("Range")},
 128   {FRQ_ST_MINIMUM, N_("Minimum")},
 129   {FRQ_ST_MAXIMUM, N_("Maximum")},
 130   {FRQ_ST_SUM, N_("Sum")},
 131   {-1, 0},
 132 };
 133
 134 /* Percentiles to calculate. */
 135
 136 struct percentile
 137 {
 138   double p;        /* the %ile to be calculated */
 139   double value;    /* the %ile's value */
 140   double x1;       /* The datum value <= the percentile */
 141   double x2;       /* The datum value >= the percentile */
 142   int flag;
 143   int flag2;       /* Set to 1 if this percentile value has been found */
 144 };
 145
 146
 147 static void add_percentile (double x) ;
 148
 149 static struct percentile *percentiles;
 150 static int n_percentiles;
 151
 152 static int implicit_50th ;
 153
 154 /* Groups of statistics. */
 155 #define BI          BIT_INDEX
 156 #define frq_default                                                     \
 157         (BI (frq_mean) | BI (frq_stddev) | BI (frq_min) | BI (frq_max))
 158 #define frq_all                                                 \
 159         (BI (frq_sum) | BI(frq_min) | BI(frq_max)               \
 160          | BI(frq_mean) | BI(frq_semean) | BI(frq_stddev)       \
 161          | BI(frq_variance) | BI(frq_kurt) | BI(frq_sekurt)     \
 162          | BI(frq_skew) | BI(frq_seskew) | BI(frq_range)        \
 163          | BI(frq_range) | BI(frq_mode) | BI(frq_median))
 164
 165 /* Statistics; number of statistics. */
 166 static unsigned long stats;
 167 static int n_stats;
 168
 169 /* Types of graphs. */
 170 enum
 171   {
 172     GFT_NONE,                   /* Don't draw graphs. */
 173     GFT_BAR,                    /* Draw bar charts. */
 174     GFT_HIST,                   /* Draw histograms. */
 175     GFT_PIE,                    /* Draw piechart */
 176     GFT_HBAR                    /* Draw bar charts or histograms at our discretion. */
 177   };
 178
 179 /* Parsed command. */
 180 static struct cmd_frequencies cmd;
 181
 182 /* Summary of the barchart, histogram, and hbar subcommands. */
 183 /* FIXME: These should not be mututally exclusive */
 184 static int chart;               /* NONE/BAR/HIST/HBAR/PIE. */
 185 static double min, max;         /* Minimum, maximum on y axis. */
 186 static int format;              /* FREQ/PERCENT: Scaling of y axis. */
 187 static double scale, incr;      /* FIXME */
 188 static int normal;              /* FIXME */
 189
 190 /* Variables for which to calculate statistics. */
 191 static size_t n_variables;
 192 static struct variable **v_variables;
 193
 194 /* Arenas used to store semi-permanent storage. */
 195 static struct pool *int_pool;   /* Integer mode. */
 196 static struct pool *gen_pool;   /* General mode. */
 197
 198 /* Frequency tables. */
 199
 200 /* Frequency table entry. */
 201 struct freq
 202   {
 203     union value v;              /* The value. */
 204     double c;                   /* The number of occurrences of the value. */
 205   };
 206
 207 /* Types of frequency tables. */
 208 enum
 209   {
 210     FRQM_GENERAL,
 211     FRQM_INTEGER
 212   };
 213
 214 /* Entire frequency table. */
 215 struct freq_tab
 216   {
 217     int mode;                   /* FRQM_GENERAL or FRQM_INTEGER. */
 218
 219     /* General mode. */
 220     struct hsh_table *data;     /* Undifferentiated data. */
 221
 222     /* Integer mode. */
 223     double *vector;             /* Frequencies proper. */
 224     int min, max;               /* The boundaries of the table. */
 225     double out_of_range;        /* Sum of weights of out-of-range values. */
 226     double sysmis;              /* Sum of weights of SYSMIS values. */
 227
 228     /* All modes. */
 229     struct freq *valid;         /* Valid freqs. */
 230     int n_valid;                /* Number of total freqs. */
 231
 232     struct freq *missing;       /* Missing freqs. */
 233     int n_missing;              /* Number of missing freqs. */
 234
 235     /* Statistics. */
 236     double total_cases;         /* Sum of weights of all cases. */
 237     double valid_cases;         /* Sum of weights of valid cases. */
 238   };
 239
 240
 241 /* Per-variable frequency data. */
 242 struct var_freqs
 243   {
 244     /* Freqency table. */
 245     struct freq_tab tab;        /* Frequencies table to use. */
 246
 247     /* Percentiles. */
 248     int n_groups;               /* Number of groups. */
 249     double *groups;             /* Groups. */
 250
 251     /* Statistics. */
 252     double stat[frq_n_stats];
 253   };
 254
 255 static inline struct var_freqs *
 256 get_var_freqs (struct variable *v)
 257 {
 258   assert (v != NULL);
 259   assert (v->aux != NULL);
 260   return v->aux;
 261 }
 262
 263 static void determine_charts (void);
 264
 265 static void calc_stats (struct variable *v, double d[frq_n_stats]);
 266
 267 static void precalc (void *);
 268 static int calc (struct ccase *, void *);
 269 static void postcalc (void *);
 270
 271 static void postprocess_freq_tab (struct variable *);
 272 static void dump_full (struct variable *);
 273 static void dump_condensed (struct variable *);
 274 static void dump_statistics (struct variable *, int show_varname);
 275 static void cleanup_freq_tab (struct variable *);
 276
 277 static hsh_hash_func hash_value_numeric, hash_value_alpha;
 278 static hsh_compare_func compare_value_numeric_a, compare_value_alpha_a;
 279 static hsh_compare_func compare_value_numeric_d, compare_value_alpha_d;
 280 static hsh_compare_func compare_freq_numeric_a, compare_freq_alpha_a;
 281 static hsh_compare_func compare_freq_numeric_d, compare_freq_alpha_d;
 282
 283
 284 static void do_piechart(const struct variable *var,
 285                         const struct freq_tab *frq_tab);
 286
 287 gsl_histogram *
 288 freq_tab_to_hist(const struct freq_tab *ft, const struct variable *var);
 289
 290
 291 \f
 292 /* Parser and outline. */
 293
 294 static int internal_cmd_frequencies (void);
 295
 296 int
 297 cmd_frequencies (void)
 298 {
 299   int result;
 300
 301   int_pool = pool_create ();
 302   result = internal_cmd_frequencies ();
 303   pool_destroy (int_pool);
 304   int_pool=0;
 305   pool_destroy (gen_pool);
 306   gen_pool=0;
 307   free (v_variables);
 308   v_variables=0;
 309   return result;
 310 }
 311
 312 static int
 313 internal_cmd_frequencies (void)
 314 {
 315   int i;
 316
 317   n_percentiles = 0;
 318   percentiles = NULL;
 319
 320   n_variables = 0;
 321   v_variables = NULL;
 322
 323   if (!parse_frequencies (&cmd))
 324     return CMD_FAILURE;
 325
 326   if (cmd.onepage_limit == NOT_LONG)
 327     cmd.onepage_limit = 50;
 328
 329   /* Figure out statistics to calculate. */
 330   stats = 0;
 331   if (cmd.a_statistics[FRQ_ST_DEFAULT] || !cmd.sbc_statistics)
 332     stats |= frq_default;
 333   if (cmd.a_statistics[FRQ_ST_ALL])
 334     stats |= frq_all;
 335   if (cmd.sort != FRQ_AVALUE && cmd.sort != FRQ_DVALUE)
 336     stats &= ~frq_median;
 337   for (i = 0; i < frq_n_stats; i++)
 338     if (cmd.a_statistics[st_name[i].st_indx])
 339       stats |= BIT_INDEX (i);
 340   if (stats & frq_kurt)
 341     stats |= frq_sekurt;
 342   if (stats & frq_skew)
 343     stats |= frq_seskew;
 344
 345   /* Calculate n_stats. */
 346   n_stats = 0;
 347   for (i = 0; i < frq_n_stats; i++)
 348     if ((stats & BIT_INDEX (i)))
 349       n_stats++;
 350
 351   /* Charting. */
 352   determine_charts ();
 353   if (chart != GFT_NONE || cmd.sbc_ntiles)
 354     cmd.sort = FRQ_AVALUE;
 355
 356   /* Work out what percentiles need to be calculated */
 357   if ( cmd.sbc_percentiles )
 358     {
 359       for ( i = 0 ; i < MAXLISTS ; ++i )
 360         {
 361           int pl;
 362           subc_list_double *ptl_list = &cmd.dl_percentiles[i];
 363           for ( pl = 0 ; pl < subc_list_double_count(ptl_list); ++pl)
 364               add_percentile(subc_list_double_at(ptl_list,pl) / 100.0 );
 365         }
 366     }
 367   if ( cmd.sbc_ntiles )
 368     {
 369       for ( i = 0 ; i < cmd.sbc_ntiles ; ++i )
 370         {
 371           int j;
 372           for (j = 0; j <= cmd.n_ntiles[i]; ++j )
 373               add_percentile(j / (double) cmd.n_ntiles[i]);
 374         }
 375     }
 376
 377
 378   /* Do it! */
 379   procedure_with_splits (precalc, calc, postcalc, NULL);
 380
 381   free_frequencies(&cmd);
 382
 383   return CMD_SUCCESS;
 384 }
 385
 386 /* Figure out which charts the user requested.  */
 387 static void
 388 determine_charts (void)
 389 {
 390   int count = (!!cmd.sbc_histogram) + (!!cmd.sbc_barchart) +
 391     (!!cmd.sbc_hbar) + (!!cmd.sbc_piechart);
 392
 393   if (!count)
 394     {
 395       chart = GFT_NONE;
 396       return;
 397     }
 398   else if (count > 1)
 399     {
 400       chart = GFT_HBAR;
 401       msg (SW, _("At most one of BARCHART, HISTOGRAM, or HBAR should be "
 402            "given.  HBAR will be assumed.  Argument values will be "
 403            "given precedence increasing along the order given."));
 404     }
 405   else if (cmd.sbc_histogram)
 406     chart = GFT_HIST;
 407   else if (cmd.sbc_barchart)
 408     chart = GFT_BAR;
 409   else if (cmd.sbc_piechart)
 410     chart = GFT_PIE;
 411   else
 412     chart = GFT_HBAR;
 413
 414   min = max = SYSMIS;
 415   format = FRQ_FREQ;
 416   scale = SYSMIS;
 417   incr = SYSMIS;
 418   normal = 0;
 419
 420   if (cmd.sbc_barchart)
 421     {
 422       if (cmd.ba_min != SYSMIS)
 423         min = cmd.ba_min;
 424       if (cmd.ba_max != SYSMIS)
 425         max = cmd.ba_max;
 426       if (cmd.ba_scale == FRQ_FREQ)
 427         {
 428           format = FRQ_FREQ;
 429           scale = cmd.ba_freq;
 430         }
 431       else if (cmd.ba_scale == FRQ_PERCENT)
 432         {
 433           format = FRQ_PERCENT;
 434           scale = cmd.ba_pcnt;
 435         }
 436     }
 437
 438   if (cmd.sbc_histogram)
 439     {
 440       if (cmd.hi_min != SYSMIS)
 441         min = cmd.hi_min;
 442       if (cmd.hi_max != SYSMIS)
 443         max = cmd.hi_max;
 444       if (cmd.hi_scale == FRQ_FREQ)
 445         {
 446           format = FRQ_FREQ;
 447           scale = cmd.hi_freq;
 448         }
 449       else if (cmd.hi_scale == FRQ_PERCENT)
 450         {
 451           format = FRQ_PERCENT;
 452           scale = cmd.ba_pcnt;
 453         }
 454       if (cmd.hi_norm != FRQ_NONORMAL )
 455         normal = 1;
 456       if (cmd.hi_incr == FRQ_INCREMENT)
 457         incr = cmd.hi_inc;
 458     }
 459
 460   if (cmd.sbc_hbar)
 461     {
 462       if (cmd.hb_min != SYSMIS)
 463         min = cmd.hb_min;
 464       if (cmd.hb_max != SYSMIS)
 465         max = cmd.hb_max;
 466       if (cmd.hb_scale == FRQ_FREQ)
 467         {
 468           format = FRQ_FREQ;
 469           scale = cmd.hb_freq;
 470         }
 471       else if (cmd.hb_scale == FRQ_PERCENT)
 472         {
 473           format = FRQ_PERCENT;
 474           scale = cmd.ba_pcnt;
 475         }
 476       if (cmd.hb_norm)
 477         normal = 1;
 478       if (cmd.hb_incr == FRQ_INCREMENT)
 479         incr = cmd.hb_inc;
 480     }
 481
 482   if (min != SYSMIS && max != SYSMIS && min >= max)
 483     {
 484       msg (SE, _("MAX must be greater than or equal to MIN, if both are "
 485            "specified.  However, MIN was specified as %g and MAX as %g.  "
 486            "MIN and MAX will be ignored."), min, max);
 487       min = max = SYSMIS;
 488     }
 489 }
 490
 491 /* Add data from case C to the frequency table. */
 492 static int
 493 calc (struct ccase *c, void *aux UNUSED)
 494 {
 495   double weight;
 496   size_t i;
 497   int bad_warn = 1;
 498
 499   weight = dict_get_case_weight (default_dict, c, &bad_warn);
 500
 501   for (i = 0; i < n_variables; i++)
 502     {
 503       struct variable *v = v_variables[i];
 504       const union value *val = case_data (c, v->fv);
 505       struct freq_tab *ft = &get_var_freqs (v)->tab;
 506
 507       switch (ft->mode)
 508         {
 509           case FRQM_GENERAL:
 510             {
 511
 512               /* General mode. */
 513               struct freq **fpp = (struct freq **) hsh_probe (ft->data, val);
 514
 515               if (*fpp != NULL)
 516                 (*fpp)->c += weight;
 517               else
 518                 {
 519                   struct freq *fp = *fpp = pool_alloc (gen_pool, sizeof *fp);
 520                   fp->v = *val;
 521                   fp->c = weight;
 522                 }
 523             }
 524           break;
 525         case FRQM_INTEGER:
 526           /* Integer mode. */
 527           if (val->f == SYSMIS)
 528             ft->sysmis += weight;
 529           else if (val->f > INT_MIN+1 && val->f < INT_MAX-1)
 530             {
 531               int i = val->f;
 532               if (i >= ft->min && i <= ft->max)
 533                 ft->vector[i - ft->min] += weight;
 534             }
 535           else
 536             ft->out_of_range += weight;
 537           break;
 538         default:
 539           assert (0);
 540         }
 541     }
 542   return 1;
 543 }
 544
 545 /* Prepares each variable that is the target of FREQUENCIES by setting
 546    up its hash table. */
 547 static void
 548 precalc (void *aux UNUSED)
 549 {
 550   size_t i;
 551
 552   pool_destroy (gen_pool);
 553   gen_pool = pool_create ();
 554
 555   for (i = 0; i < n_variables; i++)
 556     {
 557       struct variable *v = v_variables[i];
 558       struct freq_tab *ft = &get_var_freqs (v)->tab;
 559
 560       if (ft->mode == FRQM_GENERAL)
 561         {
 562           hsh_hash_func *hash;
 563           hsh_compare_func *compare;
 564
 565           if (v->type == NUMERIC)
 566             {
 567               hash = hash_value_numeric;
 568               compare = compare_value_numeric_a;
 569             }
 570           else
 571             {
 572               hash = hash_value_alpha;
 573               compare = compare_value_alpha_a;
 574             }
 575           ft->data = hsh_create (16, compare, hash, NULL, v);
 576         }
 577       else
 578         {
 579           int j;
 580
 581           for (j = (ft->max - ft->min); j >= 0; j--)
 582             ft->vector[j] = 0.0;
 583           ft->out_of_range = 0.0;
 584           ft->sysmis = 0.0;
 585         }
 586     }
 587 }
 588
 589 /* Finishes up with the variables after frequencies have been
 590    calculated.  Displays statistics, percentiles, ... */
 591 static void
 592 postcalc (void *aux UNUSED)
 593 {
 594   size_t i;
 595
 596   for (i = 0; i < n_variables; i++)
 597     {
 598       struct variable *v = v_variables[i];
 599       struct var_freqs *vf = get_var_freqs (v);
 600       struct freq_tab *ft = &vf->tab;
 601       int n_categories;
 602       int dumped_freq_tab = 1;
 603
 604       postprocess_freq_tab (v);
 605
 606       /* Frequencies tables. */
 607       n_categories = ft->n_valid + ft->n_missing;
 608       if (cmd.table == FRQ_TABLE
 609           || (cmd.table == FRQ_LIMIT && n_categories <= cmd.limit))
 610         switch (cmd.cond)
 611           {
 612           case FRQ_CONDENSE:
 613             dump_condensed (v);
 614             break;
 615           case FRQ_STANDARD:
 616             dump_full (v);
 617             break;
 618           case FRQ_ONEPAGE:
 619             if (n_categories > cmd.onepage_limit)
 620               dump_condensed (v);
 621             else
 622               dump_full (v);
 623             break;
 624           default:
 625             assert (0);
 626           }
 627       else
 628         dumped_freq_tab = 0;
 629
 630       /* Statistics. */
 631       if (n_stats)
 632         dump_statistics (v, !dumped_freq_tab);
 633
 634
 635
 636       if ( chart == GFT_HIST)
 637         {
 638           double d[frq_n_stats];
 639           struct normal_curve norm;
 640           gsl_histogram *hist ;
 641
 642
 643           norm.N = vf->tab.valid_cases;
 644
 645           calc_stats(v,d);
 646           norm.mean = d[frq_mean];
 647           norm.stddev = d[frq_stddev];
 648
 649           hist = freq_tab_to_hist(ft,v);
 650
 651           histogram_plot(hist, var_to_string(v), &norm, normal);
 652
 653           gsl_histogram_free(hist);
 654         }
 655
 656
 657       if ( chart == GFT_PIE)
 658         {
 659           do_piechart(v_variables[i], ft);
 660         }
 661
 662
 663
 664       cleanup_freq_tab (v);
 665
 666     }
 667 }
 668
 669 /* Returns the comparison function that should be used for
 670    sorting a frequency table by FRQ_SORT using VAR_TYPE
 671    variables. */
 672 static hsh_compare_func *
 673 get_freq_comparator (int frq_sort, int var_type)
 674 {
 675   /* Note that q2c generates tags beginning with 1000. */
 676   switch (frq_sort | (var_type << 16))
 677     {
 678     case FRQ_AVALUE | (NUMERIC << 16):  return compare_value_numeric_a;
 679     case FRQ_AVALUE | (ALPHA << 16):    return compare_value_alpha_a;
 680     case FRQ_DVALUE | (NUMERIC << 16):  return compare_value_numeric_d;
 681     case FRQ_DVALUE | (ALPHA << 16):    return compare_value_alpha_d;
 682     case FRQ_AFREQ | (NUMERIC << 16):   return compare_freq_numeric_a;
 683     case FRQ_AFREQ | (ALPHA << 16):     return compare_freq_alpha_a;
 684     case FRQ_DFREQ | (NUMERIC << 16):   return compare_freq_numeric_d;
 685     case FRQ_DFREQ | (ALPHA << 16):     return compare_freq_alpha_d;
 686     default: assert (0);
 687     }
 688
 689   return 0;
 690 }
 691
 692 /* Returns nonzero iff the value in struct freq F is non-missing
 693    for variable V. */
 694 static int
 695 not_missing (const void *f_, void *v_)
 696 {
 697   const struct freq *f = f_;
 698   struct variable *v = v_;
 699
 700   return !mv_is_value_missing (&v->miss, &f->v);
 701 }
 702
 703 /* Summarizes the frequency table data for variable V. */
 704 static void
 705 postprocess_freq_tab (struct variable *v)
 706 {
 707   hsh_compare_func *compare;
 708   struct freq_tab *ft;
 709   size_t count;
 710   void *const *data;
 711   struct freq *freqs, *f;
 712   size_t i;
 713
 714   ft = &get_var_freqs (v)->tab;
 715   assert (ft->mode == FRQM_GENERAL);
 716   compare = get_freq_comparator (cmd.sort, v->type);
 717
 718   /* Extract data from hash table. */
 719   count = hsh_count (ft->data);
 720   data = hsh_data (ft->data);
 721
 722   /* Copy dereferenced data into freqs. */
 723   freqs = xnmalloc (count, sizeof *freqs);
 724   for (i = 0; i < count; i++)
 725     {
 726       struct freq *f = data[i];
 727       freqs[i] = *f;
 728     }
 729
 730   /* Put data into ft. */
 731   ft->valid = freqs;
 732   ft->n_valid = partition (freqs, count, sizeof *freqs, not_missing, v);
 733   ft->missing = freqs + ft->n_valid;
 734   ft->n_missing = count - ft->n_valid;
 735
 736   /* Sort data. */
 737   sort (ft->valid, ft->n_valid, sizeof *ft->valid, compare, v);
 738   sort (ft->missing, ft->n_missing, sizeof *ft->missing, compare, v);
 739
 740   /* Summary statistics. */
 741   ft->valid_cases = 0.0;
 742   for(i = 0 ;  i < ft->n_valid ; ++i )
 743     {
 744       f = &ft->valid[i];
 745       ft->valid_cases += f->c;
 746
 747     }
 748
 749   ft->total_cases = ft->valid_cases ;
 750   for(i = 0 ;  i < ft->n_missing ; ++i )
 751     {
 752       f = &ft->missing[i];
 753       ft->total_cases += f->c;
 754     }
 755
 756 }
 757
 758 /* Frees the frequency table for variable V. */
 759 static void
 760 cleanup_freq_tab (struct variable *v)
 761 {
 762   struct freq_tab *ft = &get_var_freqs (v)->tab;
 763   assert (ft->mode == FRQM_GENERAL);
 764   free (ft->valid);
 765   hsh_destroy (ft->data);
 766 }
 767
 768 /* Parses the VARIABLES subcommand, adding to
 769    {n_variables,v_variables}. */
 770 static int
 771 frq_custom_variables (struct cmd_frequencies *cmd UNUSED)
 772 {
 773   int mode;
 774   int min = 0, max = 0;
 775
 776   size_t old_n_variables = n_variables;
 777   size_t i;
 778
 779   lex_match ('=');
 780   if (token != T_ALL && (token != T_ID
 781                          || dict_lookup_var (default_dict, tokid) == NULL))
 782     return 2;
 783
 784   if (!parse_variables (default_dict, &v_variables, &n_variables,
 785                         PV_APPEND | PV_NO_SCRATCH))
 786     return 0;
 787
 788   if (!lex_match ('('))
 789     mode = FRQM_GENERAL;
 790   else
 791     {
 792       mode = FRQM_INTEGER;
 793       if (!lex_force_int ())
 794         return 0;
 795       min = lex_integer ();
 796       lex_get ();
 797       if (!lex_force_match (','))
 798         return 0;
 799       if (!lex_force_int ())
 800         return 0;
 801       max = lex_integer ();
 802       lex_get ();
 803       if (!lex_force_match (')'))
 804         return 0;
 805       if (max < min)
 806         {
 807           msg (SE, _("Upper limit of integer mode value range must be "
 808                      "greater than lower limit."));
 809           return 0;
 810         }
 811     }
 812
 813   for (i = old_n_variables; i < n_variables; i++)
 814     {
 815       struct variable *v = v_variables[i];
 816       struct var_freqs *vf;
 817
 818       if (v->aux != NULL)
 819         {
 820           msg (SE, _("Variable %s specified multiple times on VARIABLES "
 821                      "subcommand."), v->name);
 822           return 0;
 823         }
 824       if (mode == FRQM_INTEGER && v->type != NUMERIC)
 825         {
 826           msg (SE, _("Integer mode specified, but %s is not a numeric "
 827                      "variable."), v->name);
 828           return 0;
 829         }
 830
 831       vf = var_attach_aux (v, xmalloc (sizeof *vf), var_dtor_free);
 832       vf->tab.mode = mode;
 833       vf->tab.valid = vf->tab.missing = NULL;
 834       if (mode == FRQM_INTEGER)
 835         {
 836           vf->tab.min = min;
 837           vf->tab.max = max;
 838           vf->tab.vector = pool_alloc (int_pool,
 839                                        sizeof (struct freq) * (max - min + 1));
 840         }
 841       else
 842         vf->tab.vector = NULL;
 843       vf->n_groups = 0;
 844       vf->groups = NULL;
 845     }
 846   return 1;
 847 }
 848
 849 /* Parses the GROUPED subcommand, setting the n_grouped, grouped
 850    fields of specified variables. */
 851 static int
 852 frq_custom_grouped (struct cmd_frequencies *cmd UNUSED)
 853 {
 854   lex_match ('=');
 855   if ((token == T_ID && dict_lookup_var (default_dict, tokid) != NULL)
 856       || token == T_ID)
 857     for (;;)
 858       {
 859         size_t i;
 860
 861         /* Max, current size of list; list itself. */
 862         int nl, ml;
 863         double *dl;
 864
 865         /* Variable list. */
 866         size_t n;
 867         struct variable **v;
 868
 869         if (!parse_variables (default_dict, &v, &n,
 870                               PV_NO_DUPLICATE | PV_NUMERIC))
 871           return 0;
 872         if (lex_match ('('))
 873           {
 874             nl = ml = 0;
 875             dl = NULL;
 876             while (lex_integer ())
 877               {
 878                 if (nl >= ml)
 879                   {
 880                     ml += 16;
 881                     dl = pool_realloc (int_pool, dl, ml * sizeof (double));
 882                   }
 883                 dl[nl++] = tokval;
 884                 lex_get ();
 885                 lex_match (',');
 886               }
 887             /* Note that nl might still be 0 and dl might still be
 888                NULL.  That's okay. */
 889             if (!lex_match (')'))
 890               {
 891                 free (v);
 892                 msg (SE, _("`)' expected after GROUPED interval list."));
 893                 return 0;
 894               }
 895           }
 896         else
 897           {
 898             nl = 0;
 899             dl = NULL;
 900           }
 901
 902         for (i = 0; i < n; i++)
 903           if (v[i]->aux == NULL)
 904             msg (SE, _("Variables %s specified on GROUPED but not on "
 905                        "VARIABLES."), v[i]->name);
 906           else
 907             {
 908               struct var_freqs *vf = get_var_freqs (v[i]);
 909
 910               if (vf->groups != NULL)
 911                 msg (SE, _("Variables %s specified multiple times on GROUPED "
 912                            "subcommand."), v[i]->name);
 913               else
 914                 {
 915                   vf->n_groups = nl;
 916                   vf->groups = dl;
 917                 }
 918             }
 919         free (v);
 920         if (!lex_match ('/'))
 921           break;
 922         if ((token != T_ID || dict_lookup_var (default_dict, tokid) != NULL)
 923             && token != T_ALL)
 924           {
 925             lex_put_back ('/');
 926             break;
 927           }
 928       }
 929
 930   return 1;
 931 }
 932
 933 /* Adds X to the list of percentiles, keeping the list in proper
 934    order. */
 935 static void
 936 add_percentile (double x)
 937 {
 938   int i;
 939
 940   for (i = 0; i < n_percentiles; i++)
 941     {
 942       /* Do nothing if it's already in the list */
 943       if ( fabs(x - percentiles[i].p) < DBL_EPSILON )
 944         return;
 945
 946       if (x < percentiles[i].p)
 947         break;
 948     }
 949
 950   if (i >= n_percentiles || tokval != percentiles[i].p)
 951     {
 952       percentiles
 953         = pool_realloc (int_pool, percentiles,
 954                         (n_percentiles + 1) * sizeof (struct percentile ));
 955
 956       if (i < n_percentiles)
 957           memmove (&percentiles[i + 1], &percentiles[i],
 958                    (n_percentiles - i) * sizeof (struct percentile) );
 959
 960       percentiles[i].p = x;
 961       n_percentiles++;
 962     }
 963 }
 964
 965 /* Comparison functions. */
 966
 967 /* Hash of numeric values. */
 968 static unsigned
 969 hash_value_numeric (const void *value_, void *foo UNUSED)
 970 {
 971   const struct freq *value = value_;
 972   return hsh_hash_double (value->v.f);
 973 }
 974
 975 /* Hash of string values. */
 976 static unsigned
 977 hash_value_alpha (const void *value_, void *v_)
 978 {
 979   const struct freq *value = value_;
 980   struct variable *v = v_;
 981
 982   return hsh_hash_bytes (value->v.s, v->width);
 983 }
 984
 985 /* Ascending numeric compare of values. */
 986 static int
 987 compare_value_numeric_a (const void *a_, const void *b_, void *foo UNUSED)
 988 {
 989   const struct freq *a = a_;
 990   const struct freq *b = b_;
 991
 992   if (a->v.f > b->v.f)
 993     return 1;
 994   else if (a->v.f < b->v.f)
 995     return -1;
 996   else
 997     return 0;
 998 }
 999
1000 /* Ascending string compare of values. */
1001 static int
1002 compare_value_alpha_a (const void *a_, const void *b_, void *v_)
1003 {
1004   const struct freq *a = a_;
1005   const struct freq *b = b_;
1006   const struct variable *v = v_;
1007
1008   return memcmp (a->v.s, b->v.s, v->width);
1009 }
1010
1011 /* Descending numeric compare of values. */
1012 static int
1013 compare_value_numeric_d (const void *a, const void *b, void *foo UNUSED)
1014 {
1015   return -compare_value_numeric_a (a, b, foo);
1016 }
1017
1018 /* Descending string compare of values. */
1019 static int
1020 compare_value_alpha_d (const void *a, const void *b, void *v)
1021 {
1022   return -compare_value_alpha_a (a, b, v);
1023 }
1024
1025 /* Ascending numeric compare of frequency;
1026    secondary key on ascending numeric value. */
1027 static int
1028 compare_freq_numeric_a (const void *a_, const void *b_, void *foo UNUSED)
1029 {
1030   const struct freq *a = a_;
1031   const struct freq *b = b_;
1032
1033   if (a->c > b->c)
1034     return 1;
1035   else if (a->c < b->c)
1036     return -1;
1037
1038   if (a->v.f > b->v.f)
1039     return 1;
1040   else if (a->v.f < b->v.f)
1041     return -1;
1042   else
1043     return 0;
1044 }
1045
1046 /* Ascending numeric compare of frequency;
1047    secondary key on ascending string value. */
1048 static int
1049 compare_freq_alpha_a (const void *a_, const void *b_, void *v_)
1050 {
1051   const struct freq *a = a_;
1052   const struct freq *b = b_;
1053   const struct variable *v = v_;
1054
1055   if (a->c > b->c)
1056     return 1;
1057   else if (a->c < b->c)
1058     return -1;
1059   else
1060     return memcmp (a->v.s, b->v.s, v->width);
1061 }
1062
1063 /* Descending numeric compare of frequency;
1064    secondary key on ascending numeric value. */
1065 static int
1066 compare_freq_numeric_d (const void *a_, const void *b_, void *foo UNUSED)
1067 {
1068   const struct freq *a = a_;
1069   const struct freq *b = b_;
1070
1071   if (a->c > b->c)
1072     return -1;
1073   else if (a->c < b->c)
1074     return 1;
1075
1076   if (a->v.f > b->v.f)
1077     return 1;
1078   else if (a->v.f < b->v.f)
1079     return -1;
1080   else
1081     return 0;
1082 }
1083
1084 /* Descending numeric compare of frequency;
1085    secondary key on ascending string value. */
1086 static int
1087 compare_freq_alpha_d (const void *a_, const void *b_, void *v_)
1088 {
1089   const struct freq *a = a_;
1090   const struct freq *b = b_;
1091   const struct variable *v = v_;
1092
1093   if (a->c > b->c)
1094     return -1;
1095   else if (a->c < b->c)
1096     return 1;
1097   else
1098     return memcmp (a->v.s, b->v.s, v->width);
1099 }
1100 \f
1101 /* Frequency table display. */
1102
1103 /* Sets the widths of all the columns and heights of all the rows in
1104    table T for driver D. */
1105 static void
1106 full_dim (struct tab_table *t, struct outp_driver *d)
1107 {
1108   int lab = cmd.labels == FRQ_LABELS;
1109   int i;
1110
1111   if (lab)
1112     t->w[0] = min (tab_natural_width (t, d, 0), d->prop_em_width * 15);
1113   for (i = lab; i < lab + 5; i++)
1114     t->w[i] = max (tab_natural_width (t, d, i), d->prop_em_width * 8);
1115   for (i = 0; i < t->nr; i++)
1116     t->h[i] = d->font_height;
1117 }
1118
1119 /* Displays a full frequency table for variable V. */
1120 static void
1121 dump_full (struct variable *v)
1122 {
1123   int n_categories;
1124   struct freq_tab *ft;
1125   struct freq *f;
1126   struct tab_table *t;
1127   int r;
1128   double cum_total = 0.0;
1129   double cum_freq = 0.0;
1130
1131   struct init
1132     {
1133       int c, r;
1134       const char *s;
1135     };
1136
1137   struct init *p;
1138
1139   static struct init vec[] =
1140   {
1141     {4, 0, N_("Valid")},
1142     {5, 0, N_("Cum")},
1143     {1, 1, N_("Value")},
1144     {2, 1, N_("Frequency")},
1145     {3, 1, N_("Percent")},
1146     {4, 1, N_("Percent")},
1147     {5, 1, N_("Percent")},
1148     {0, 0, NULL},
1149     {1, 0, NULL},
1150     {2, 0, NULL},
1151     {3, 0, NULL},
1152     {-1, -1, NULL},
1153   };
1154
1155   int lab = cmd.labels == FRQ_LABELS;
1156
1157   ft = &get_var_freqs (v)->tab;
1158   n_categories = ft->n_valid + ft->n_missing;
1159   t = tab_create (5 + lab, n_categories + 3, 0);
1160   tab_headers (t, 0, 0, 2, 0);
1161   tab_dim (t, full_dim);
1162
1163   if (lab)
1164     tab_text (t, 0, 1, TAB_CENTER | TAT_TITLE, _("Value Label"));
1165   for (p = vec; p->s; p++)
1166     tab_text (t, p->c - (p->r ? !lab : 0), p->r,
1167                   TAB_CENTER | TAT_TITLE, gettext (p->s));
1168
1169   r = 2;
1170   for (f = ft->valid; f < ft->missing; f++)
1171     {
1172       double percent, valid_percent;
1173
1174       cum_freq += f->c;
1175
1176       percent = f->c / ft->total_cases * 100.0;
1177       valid_percent = f->c / ft->valid_cases * 100.0;
1178       cum_total += valid_percent;
1179
1180       if (lab)
1181         {
1182           const char *label = val_labs_find (v->val_labs, f->v);
1183           if (label != NULL)
1184             tab_text (t, 0, r, TAB_LEFT, label);
1185         }
1186
1187       tab_value (t, 0 + lab, r, TAB_NONE, &f->v, &v->print);
1188       tab_float (t, 1 + lab, r, TAB_NONE, f->c, 8, 0);
1189       tab_float (t, 2 + lab, r, TAB_NONE, percent, 5, 1);
1190       tab_float (t, 3 + lab, r, TAB_NONE, valid_percent, 5, 1);
1191       tab_float (t, 4 + lab, r, TAB_NONE, cum_total, 5, 1);
1192       r++;
1193     }
1194   for (; f < &ft->valid[n_categories]; f++)
1195     {
1196       cum_freq += f->c;
1197
1198       if (lab)
1199         {
1200           const char *label = val_labs_find (v->val_labs, f->v);
1201           if (label != NULL)
1202             tab_text (t, 0, r, TAB_LEFT, label);
1203         }
1204
1205       tab_value (t, 0 + lab, r, TAB_NONE, &f->v, &v->print);
1206       tab_float (t, 1 + lab, r, TAB_NONE, f->c, 8, 0);
1207       tab_float (t, 2 + lab, r, TAB_NONE,
1208                      f->c / ft->total_cases * 100.0, 5, 1);
1209       tab_text (t, 3 + lab, r, TAB_NONE, _("Missing"));
1210       r++;
1211     }
1212
1213   tab_box (t, TAL_1, TAL_1,
1214            cmd.spaces == FRQ_SINGLE ? -1 : (TAL_1 | TAL_SPACING), TAL_1,
1215            0, 0, 4 + lab, r);
1216   tab_hline (t, TAL_2, 0, 4 + lab, 2);
1217   tab_hline (t, TAL_2, 0, 4 + lab, r);
1218   tab_joint_text (t, 0, r, 0 + lab, r, TAB_RIGHT | TAT_TITLE, _("Total"));
1219   tab_vline (t, TAL_0, 1, r, r);
1220   tab_float (t, 1 + lab, r, TAB_NONE, cum_freq, 8, 0);
1221   tab_float (t, 2 + lab, r, TAB_NONE, 100.0, 5, 1);
1222   tab_float (t, 3 + lab, r, TAB_NONE, 100.0, 5, 1);
1223
1224   tab_title (t, 1, "%s: %s", v->name, v->label ? v->label : "");
1225   tab_submit (t);
1226
1227 }
1228
1229 /* Sets the widths of all the columns and heights of all the rows in
1230    table T for driver D. */
1231 static void
1232 condensed_dim (struct tab_table *t, struct outp_driver *d)
1233 {
1234   int cum_w = max (outp_string_width (d, _("Cum")),
1235                    max (outp_string_width (d, _("Cum")),
1236                         outp_string_width (d, "000")));
1237
1238   int i;
1239
1240   for (i = 0; i < 2; i++)
1241     t->w[i] = max (tab_natural_width (t, d, i), d->prop_em_width * 8);
1242   for (i = 2; i < 4; i++)
1243     t->w[i] = cum_w;
1244   for (i = 0; i < t->nr; i++)
1245     t->h[i] = d->font_height;
1246 }
1247
1248 /* Display condensed frequency table for variable V. */
1249 static void
1250 dump_condensed (struct variable *v)
1251 {
1252   int n_categories;
1253   struct freq_tab *ft;
1254   struct freq *f;
1255   struct tab_table *t;
1256   int r;
1257   double cum_total = 0.0;
1258
1259   ft = &get_var_freqs (v)->tab;
1260   n_categories = ft->n_valid + ft->n_missing;
1261   t = tab_create (4, n_categories + 2, 0);
1262
1263   tab_headers (t, 0, 0, 2, 0);
1264   tab_text (t, 0, 1, TAB_CENTER | TAT_TITLE, _("Value"));
1265   tab_text (t, 1, 1, TAB_CENTER | TAT_TITLE, _("Freq"));
1266   tab_text (t, 2, 1, TAB_CENTER | TAT_TITLE, _("Pct"));
1267   tab_text (t, 3, 0, TAB_CENTER | TAT_TITLE, _("Cum"));
1268   tab_text (t, 3, 1, TAB_CENTER | TAT_TITLE, _("Pct"));
1269   tab_dim (t, condensed_dim);
1270
1271   r = 2;
1272   for (f = ft->valid; f < ft->missing; f++)
1273     {
1274       double percent;
1275
1276       percent = f->c / ft->total_cases * 100.0;
1277       cum_total += f->c / ft->valid_cases * 100.0;
1278
1279       tab_value (t, 0, r, TAB_NONE, &f->v, &v->print);
1280       tab_float (t, 1, r, TAB_NONE, f->c, 8, 0);
1281       tab_float (t, 2, r, TAB_NONE, percent, 3, 0);
1282       tab_float (t, 3, r, TAB_NONE, cum_total, 3, 0);
1283       r++;
1284     }
1285   for (; f < &ft->valid[n_categories]; f++)
1286     {
1287       tab_value (t, 0, r, TAB_NONE, &f->v, &v->print);
1288       tab_float (t, 1, r, TAB_NONE, f->c, 8, 0);
1289       tab_float (t, 2, r, TAB_NONE,
1290                  f->c / ft->total_cases * 100.0, 3, 0);
1291       r++;
1292     }
1293
1294   tab_box (t, TAL_1, TAL_1,
1295            cmd.spaces == FRQ_SINGLE ? -1 : (TAL_1 | TAL_SPACING), TAL_1,
1296            0, 0, 3, r - 1);
1297   tab_hline (t, TAL_2, 0, 3, 2);
1298   tab_title (t, 1, "%s: %s", v->name, v->label ? v->label : "");
1299   tab_columns (t, SOM_COL_DOWN, 1);
1300   tab_submit (t);
1301 }
1302 \f
1303 /* Statistical display. */
1304
1305 /* Calculates all the pertinent statistics for variable V, putting
1306    them in array D[].  FIXME: This could be made much more optimal. */
1307 static void
1308 calc_stats (struct variable *v, double d[frq_n_stats])
1309 {
1310   struct freq_tab *ft = &get_var_freqs (v)->tab;
1311   double W = ft->valid_cases;
1312   struct moments *m;
1313   struct freq *f=0;
1314   int most_often;
1315   double X_mode;
1316
1317   double rank;
1318   int i = 0;
1319   int idx;
1320   double *median_value;
1321
1322   /* Calculate percentiles. */
1323
1324   /* If the 50th percentile was not explicitly requested then we must
1325      calculate it anyway --- it's the median */
1326   median_value = 0 ;
1327   for (i = 0; i < n_percentiles; i++)
1328     {
1329       if (percentiles[i].p == 0.5)
1330         {
1331           median_value = &percentiles[i].value;
1332           break;
1333         }
1334     }
1335
1336   if ( 0 == median_value )
1337     {
1338       add_percentile (0.5);
1339       implicit_50th = 1;
1340     }
1341
1342   for (i = 0; i < n_percentiles; i++)
1343     {
1344       percentiles[i].flag = 0;
1345       percentiles[i].flag2 = 0;
1346     }
1347
1348   rank = 0;
1349   for (idx = 0; idx < ft->n_valid; ++idx)
1350     {
1351       static double prev_value = SYSMIS;
1352       f = &ft->valid[idx];
1353       rank += f->c ;
1354       for (i = 0; i < n_percentiles; i++)
1355         {
1356           double tp;
1357           if ( percentiles[i].flag2  ) continue ;
1358
1359           if ( get_algorithm() != COMPATIBLE )
1360             tp =
1361               (ft->valid_cases - 1) *  percentiles[i].p;
1362           else
1363             tp =
1364               (ft->valid_cases + 1) *  percentiles[i].p - 1;
1365
1366           if ( percentiles[i].flag )
1367             {
1368               percentiles[i].x2 = f->v.f;
1369               percentiles[i].x1 = prev_value;
1370               percentiles[i].flag2 = 1;
1371               continue;
1372             }
1373
1374           if (rank >  tp )
1375           {
1376             if ( f->c > 1 && rank - (f->c - 1) > tp )
1377               {
1378                 percentiles[i].x2 = percentiles[i].x1 = f->v.f;
1379                 percentiles[i].flag2 = 1;
1380               }
1381             else
1382               {
1383                 percentiles[i].flag=1;
1384               }
1385
1386             continue;
1387           }
1388         }
1389       prev_value = f->v.f;
1390     }
1391
1392   for (i = 0; i < n_percentiles; i++)
1393     {
1394       /* Catches the case when p == 100% */
1395       if ( ! percentiles[i].flag2 )
1396         percentiles[i].x1 = percentiles[i].x2 = f->v.f;
1397
1398       /*
1399       printf("percentile %d (p==%.2f); X1 = %g; X2 = %g\n",
1400              i,percentiles[i].p,percentiles[i].x1,percentiles[i].x2);
1401       */
1402     }
1403
1404   for (i = 0; i < n_percentiles; i++)
1405     {
1406       struct freq_tab *ft = &get_var_freqs (v)->tab;
1407       double s;
1408
1409       double dummy;
1410       if ( get_algorithm() != COMPATIBLE )
1411         {
1412           s = modf((ft->valid_cases - 1) * percentiles[i].p , &dummy);
1413         }
1414       else
1415         {
1416           s = modf((ft->valid_cases + 1) * percentiles[i].p -1, &dummy);
1417         }
1418
1419       percentiles[i].value = percentiles[i].x1 +
1420         ( percentiles[i].x2 - percentiles[i].x1) * s ;
1421
1422       if ( percentiles[i].p == 0.50)
1423         median_value = &percentiles[i].value;
1424     }
1425
1426
1427   /* Calculate the mode. */
1428   most_often = -1;
1429   X_mode = SYSMIS;
1430   for (f = ft->valid; f < ft->missing; f++)
1431     {
1432       if (most_often < f->c)
1433         {
1434           most_often = f->c;
1435           X_mode = f->v.f;
1436         }
1437       else if (most_often == f->c)
1438         {
1439           /* A duplicate mode is undefined.
1440              FIXME: keep track of *all* the modes. */
1441           X_mode = SYSMIS;
1442         }
1443     }
1444
1445   /* Calculate moments. */
1446   m = moments_create (MOMENT_KURTOSIS);
1447   for (f = ft->valid; f < ft->missing; f++)
1448     moments_pass_one (m, f->v.f, f->c);
1449   for (f = ft->valid; f < ft->missing; f++)
1450     moments_pass_two (m, f->v.f, f->c);
1451   moments_calculate (m, NULL, &d[frq_mean], &d[frq_variance],
1452                      &d[frq_skew], &d[frq_kurt]);
1453   moments_destroy (m);
1454
1455   /* Formulas below are taken from _SPSS Statistical Algorithms_. */
1456   d[frq_min] = ft->valid[0].v.f;
1457   d[frq_max] = ft->valid[ft->n_valid - 1].v.f;
1458   d[frq_mode] = X_mode;
1459   d[frq_range] = d[frq_max] - d[frq_min];
1460   d[frq_median] = *median_value;
1461   d[frq_sum] = d[frq_mean] * W;
1462   d[frq_stddev] = sqrt (d[frq_variance]);
1463   d[frq_semean] = d[frq_stddev] / sqrt (W);
1464   d[frq_seskew] = calc_seskew (W);
1465   d[frq_sekurt] = calc_sekurt (W);
1466 }
1467
1468 /* Displays a table of all the statistics requested for variable V. */
1469 static void
1470 dump_statistics (struct variable *v, int show_varname)
1471 {
1472   struct freq_tab *ft;
1473   double stat_value[frq_n_stats];
1474   struct tab_table *t;
1475   int i, r;
1476
1477   int n_explicit_percentiles = n_percentiles;
1478
1479   if ( implicit_50th && n_percentiles > 0 )
1480     --n_percentiles;
1481
1482   if (v->type == ALPHA)
1483     return;
1484   ft = &get_var_freqs (v)->tab;
1485   if (ft->n_valid == 0)
1486     {
1487       msg (SW, _("No valid data for variable %s; statistics not displayed."),
1488            v->name);
1489       return;
1490     }
1491   calc_stats (v, stat_value);
1492
1493   t = tab_create (3, n_stats + n_explicit_percentiles + 2, 0);
1494   tab_dim (t, tab_natural_dimensions);
1495
1496   tab_box (t, TAL_1, TAL_1, -1, -1 , 0 , 0 , 2, tab_nr(t) - 1) ;
1497
1498
1499   tab_vline (t, TAL_1 , 2, 0, tab_nr(t) - 1);
1500   tab_vline (t, TAL_1 | TAL_SPACING , 1, 0, tab_nr(t) - 1 ) ;
1501
1502   r=2; /* N missing and N valid are always dumped */
1503
1504   for (i = 0; i < frq_n_stats; i++)
1505     if (stats & BIT_INDEX (i))
1506       {
1507         tab_text (t, 0, r, TAB_LEFT | TAT_TITLE,
1508                       gettext (st_name[i].s10));
1509         tab_float (t, 2, r, TAB_NONE, stat_value[i], 11, 3);
1510         r++;
1511       }
1512
1513   tab_text (t, 0, 0, TAB_LEFT | TAT_TITLE, _("N"));
1514   tab_text (t, 1, 0, TAB_LEFT | TAT_TITLE, _("Valid"));
1515   tab_text (t, 1, 1, TAB_LEFT | TAT_TITLE, _("Missing"));
1516
1517   tab_float(t, 2, 0, TAB_NONE, ft->valid_cases, 11, 0);
1518   tab_float(t, 2, 1, TAB_NONE, ft->total_cases - ft->valid_cases, 11, 0);
1519
1520
1521   for (i = 0; i < n_explicit_percentiles; i++, r++)
1522     {
1523       if ( i == 0 )
1524         {
1525           tab_text (t, 0, r, TAB_LEFT | TAT_TITLE, _("Percentiles"));
1526         }
1527
1528       tab_float (t, 1, r, TAB_LEFT, percentiles[i].p * 100, 3, 0 );
1529       tab_float (t, 2, r, TAB_NONE, percentiles[i].value, 11, 3);
1530
1531     }
1532
1533   tab_columns (t, SOM_COL_DOWN, 1);
1534   if (show_varname)
1535     {
1536       if (v->label)
1537         tab_title (t, 1, "%s: %s", v->name, v->label);
1538       else
1539         tab_title (t, 0, v->name);
1540     }
1541   else
1542     tab_flags (t, SOMF_NO_TITLE);
1543
1544
1545   tab_submit (t);
1546 }
1547
1548
1549 /* Create a gsl_histogram from a freq_tab */
1550 gsl_histogram *
1551 freq_tab_to_hist(const struct freq_tab *ft, const struct variable *var)
1552 {
1553   int i;
1554   double x_min = DBL_MAX;
1555   double x_max = -DBL_MAX;
1556
1557   gsl_histogram *hist;
1558   const double bins = 11;
1559
1560   struct hsh_iterator hi;
1561   struct hsh_table *fh = ft->data;
1562   struct freq *frq;
1563
1564   /* Find out the extremes of the x value */
1565   for ( frq = hsh_first(fh, &hi); frq != 0; frq = hsh_next(fh, &hi) )
1566     {
1567       if ( mv_is_value_missing(&var->miss, &frq->v))
1568         continue;
1569
1570       if ( frq->v.f < x_min ) x_min = frq->v.f ;
1571       if ( frq->v.f > x_max ) x_max = frq->v.f ;
1572     }
1573
1574   hist = histogram_create(bins, x_min, x_max);
1575
1576   for( i = 0 ; i < ft->n_valid ; ++i )
1577     {
1578       frq = &ft->valid[i];
1579       gsl_histogram_accumulate(hist, frq->v.f, frq->c);
1580     }
1581
1582   return hist;
1583 }
1584
1585
1586 static struct slice *
1587 freq_tab_to_slice_array(const struct freq_tab *frq_tab,
1588                         const struct variable *var,
1589                         int *n_slices);
1590
1591
1592 /* Allocate an array of slices and fill them from the data in frq_tab
1593    n_slices will contain the number of slices allocated.
1594    The caller is responsible for freeing slices
1595 */
1596 static struct slice *
1597 freq_tab_to_slice_array(const struct freq_tab *frq_tab,
1598                         const struct variable *var,
1599                         int *n_slices)
1600 {
1601   int i;
1602   struct slice *slices;
1603
1604   *n_slices = frq_tab->n_valid;
1605
1606   slices = xnmalloc (*n_slices, sizeof *slices);
1607
1608   for (i = 0 ; i < *n_slices ; ++i )
1609     {
1610       const struct freq *frq = &frq_tab->valid[i];
1611
1612       slices[i].label = value_to_string(&frq->v, var);
1613
1614       slices[i].magnetude = frq->c;
1615     }
1616
1617   return slices;
1618 }
1619
1620
1621
1622
1623 static void
1624 do_piechart(const struct variable *var, const struct freq_tab *frq_tab)
1625 {
1626   struct slice *slices;
1627   int n_slices;
1628
1629   slices = freq_tab_to_slice_array(frq_tab, var, &n_slices);
1630
1631   piechart_plot(var_to_string(var), slices, n_slices);
1632
1633   free(slices);
1634 }
1635
1636
1637 /*
1638    Local Variables:
1639    mode: c
1640    End:
1641 */