src/language/stats/friedman.c

   1 /* PSPP - a program for statistical analysis. -*-c-*-
   2    Copyright (C) 2010 Free Software Foundation, Inc.
   3
   4    This program is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU General Public License as published by
   6    the Free Software Foundation, either version 3 of the License, or
   7    (at your option) any later version.
   8
   9    This program is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU General Public License for more details.
  13
  14    You should have received a copy of the GNU General Public License
  15    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16 */
  17
  18 #include <config.h>
  19
  20 #include "friedman.h"
  21
  22 #include <gsl/gsl_cdf.h>
  23 #include <math.h>
  24
  25 #include <data/format.h>
  26
  27 #include <libpspp/misc.h>
  28 #include <libpspp/message.h>
  29 #include <data/procedure.h>
  30 #include <data/casereader.h>
  31 #include <data/dictionary.h>
  32 #include <data/variable.h>
  33
  34
  35 #include "gettext.h"
  36 #define _(msgid) gettext (msgid)
  37
  38
  39 struct friedman
  40 {
  41   double *rank_sum;
  42   double cc;
  43   double chi_sq;
  44   double w;
  45   const struct dictionary *dict;
  46 };
  47
  48 static void show_ranks_box (const struct one_sample_test *ost,
  49                             const struct friedman *fr);
  50
  51 static void show_sig_box (const struct one_sample_test *ost,
  52                           const struct friedman *fr);
  53
  54 struct datum
  55 {
  56   long posn;
  57   double x;
  58 };
  59
  60 static int
  61 cmp_x (const void *a_, const void *b_)
  62 {
  63   const struct datum *a = a_;
  64   const struct datum *b = b_;
  65
  66   if (a->x < b->x)
  67     return -1;
  68
  69   return (a->x > b->x);
  70 }
  71
  72 static int
  73 cmp_posn (const void *a_, const void *b_)
  74 {
  75   const struct datum *a = a_;
  76   const struct datum *b = b_;
  77
  78   if (a->posn < b->posn)
  79     return -1;
  80
  81   return (a->posn > b->posn);
  82 }
  83
  84 void
  85 friedman_execute (const struct dataset *ds,
  86                   struct casereader *input,
  87                   enum mv_class exclude,
  88                   const struct npar_test *test,
  89                   bool exact UNUSED,
  90                   double timer UNUSED)
  91 {
  92   double numerator = 0.0;
  93   double denominator = 0.0;
  94   int v;
  95   struct ccase *c;
  96   const struct dictionary *dict = dataset_dict (ds);
  97   const struct variable *weight = dict_get_weight (dict);
  98
  99   struct one_sample_test *ost = UP_CAST (test, struct one_sample_test, parent);
 100   struct friedman_test *ft = UP_CAST (ost, struct friedman_test, parent);
 101   bool warn = true;
 102
 103   double sigma_t = 0.0;
 104   struct datum *row = xcalloc (ost->n_vars, sizeof *row);
 105   double rsq;
 106   struct friedman fr;
 107   fr.rank_sum = xcalloc (ost->n_vars, sizeof *fr.rank_sum);
 108   fr.cc = 0.0;
 109   fr.dict = dict;
 110   for (v = 0; v < ost->n_vars; ++v)
 111     {
 112       row[v].posn = v;
 113       fr.rank_sum[v] = 0.0;
 114     }
 115
 116   input = casereader_create_filter_weight (input, dict, &warn, NULL);
 117   input = casereader_create_filter_missing (input,
 118                                             ost->vars, ost->n_vars,
 119                                             exclude, 0, 0);
 120
 121   for (; (c = casereader_read (input)); case_unref (c))
 122     {
 123       double prev_x = SYSMIS;
 124       int run_length = 0;
 125
 126       const double w = weight ? case_data (c, weight)->f: 1.0;
 127
 128       fr.cc += w;
 129
 130       for (v = 0; v < ost->n_vars; ++v)
 131         {
 132           const struct variable *var = ost->vars[v];
 133           const union value *val = case_data (c, var);
 134           row[v].x = val->f;
 135         }
 136
 137       qsort (row, ost->n_vars, sizeof *row, cmp_x);
 138       for (v = 0; v < ost->n_vars; ++v)
 139         {
 140           double x = row[v].x;
 141           /* Replace value by the Rank */
 142           if ( prev_x == x)
 143             {
 144               /* Deal with ties */
 145               int i;
 146               run_length++;
 147               for (i = v - run_length; i < v; ++i)
 148                 {
 149                   row[i].x *= run_length ;
 150                   row[i].x += v + 1;
 151                   row[i].x /= run_length + 1;
 152                 }
 153               row[v].x = row[v-1].x;
 154             }
 155           else
 156             {
 157               row[v].x = v + 1;
 158               if ( run_length > 0)
 159                 {
 160                   double t = run_length + 1;
 161                   sigma_t += w * (pow3 (t) - t);
 162                 }
 163               run_length = 0;
 164             }
 165           prev_x = x;
 166         }
 167       if ( run_length > 0)
 168         {
 169           double t = run_length + 1;
 170           sigma_t += w * (pow3 (t) - t );
 171         }
 172
 173       qsort (row, ost->n_vars, sizeof *row, cmp_posn);
 174
 175       for (v = 0; v < ost->n_vars; ++v)
 176         fr.rank_sum[v] += row[v].x * w;
 177     }
 178   casereader_destroy (input);
 179   free (row);
 180
 181
 182   for (v = 0; v < ost->n_vars; ++v)
 183     {
 184       numerator += pow2 (fr.rank_sum[v]);
 185     }
 186
 187   rsq = numerator;
 188
 189   numerator *= 12.0 / (fr.cc * ost->n_vars * ( ost->n_vars + 1));
 190   numerator -= 3 * fr.cc * ( ost->n_vars + 1);
 191
 192   denominator = 1 - sigma_t / ( fr.cc * ost->n_vars * ( pow2 (ost->n_vars) - 1));
 193
 194   fr.chi_sq = numerator / denominator;
 195
 196   if ( ft->kendalls_w)
 197     {
 198       fr.w = 12 * rsq ;
 199       fr.w -= 3 * pow2 (fr.cc) *
 200         ost->n_vars * pow2 (ost->n_vars + 1);
 201
 202       fr.w /= pow2 (fr.cc) * (pow3 (ost->n_vars) - ost->n_vars)
 203         - fr.cc * sigma_t;
 204     }
 205   else
 206     fr.w = SYSMIS;
 207
 208   show_ranks_box (ost, &fr);
 209   show_sig_box (ost, &fr);
 210
 211   free (fr.rank_sum);
 212 }
 213
 214 \f
 215
 216 #include <output/tab.h>
 217
 218 static void
 219 show_ranks_box (const struct one_sample_test *ost, const struct friedman *fr)
 220 {
 221   int i;
 222   const int row_headers = 1;
 223   const int column_headers = 1;
 224   struct tab_table *table =
 225     tab_create (row_headers + 1, column_headers + ost->n_vars);
 226
 227   tab_headers (table, row_headers, 0, column_headers, 0);
 228
 229   tab_title (table, _("Ranks"));
 230
 231   /* Vertical lines inside the box */
 232   tab_box (table, 1, 0, -1, TAL_1,
 233            row_headers, 0, tab_nc (table) - 1, tab_nr (table) - 1 );
 234
 235   /* Box around the table */
 236   tab_box (table, TAL_2, TAL_2, -1, -1,
 237            0,  0, tab_nc (table) - 1, tab_nr (table) - 1 );
 238
 239
 240   tab_text (table, 1, 0, 0, _("Mean Rank"));
 241
 242   tab_hline (table, TAL_2, 0, tab_nc (table) - 1, column_headers);
 243   tab_vline (table, TAL_2, row_headers, 0, tab_nr (table) - 1);
 244
 245   for (i = 0 ; i < ost->n_vars ; ++i)
 246     {
 247       tab_text (table, 0, row_headers + i,
 248                 TAB_LEFT, var_to_string (ost->vars[i]));
 249
 250       tab_double (table, 1, row_headers + i,
 251                   0, fr->rank_sum[i] / fr->cc, 0);
 252     }
 253
 254   tab_submit (table);
 255 }
 256
 257
 258 static void
 259 show_sig_box (const struct one_sample_test *ost, const struct friedman *fr)
 260 {
 261   const struct friedman_test *ft = UP_CAST (ost, const struct friedman_test, parent);
 262
 263   int row = 0;
 264   const struct variable *weight = dict_get_weight (fr->dict);
 265   const struct fmt_spec *wfmt = weight ? var_get_print_format (weight) : &F_8_0;
 266
 267   const int row_headers = 1;
 268   const int column_headers = 0;
 269   struct tab_table *table =
 270     tab_create (row_headers + 1, column_headers + (ft->kendalls_w ? 5 : 4));
 271
 272   tab_headers (table, row_headers, 0, column_headers, 0);
 273
 274   tab_title (table, _("Test Statistics"));
 275
 276   tab_text (table,  0, column_headers + row++,
 277             TAT_TITLE | TAB_LEFT , _("N"));
 278
 279   if ( ft->kendalls_w)
 280     tab_text (table,  0, column_headers + row++,
 281               TAT_TITLE | TAB_LEFT , _("Kendall's W"));
 282
 283   tab_text (table,  0, column_headers + row++,
 284             TAT_TITLE | TAB_LEFT , _("Chi-Square"));
 285
 286   tab_text (table,  0, column_headers + row++,
 287             TAT_TITLE | TAB_LEFT, _("df"));
 288
 289   tab_text (table,  0, column_headers + row++,
 290             TAT_TITLE | TAB_LEFT, _("Asymp. Sig."));
 291
 292   /* Box around the table */
 293   tab_box (table, TAL_2, TAL_2, -1, -1,
 294            0,  0, tab_nc (table) - 1, tab_nr (table) - 1 );
 295
 296
 297   tab_hline (table, TAL_2, 0, tab_nc (table) -1, column_headers);
 298   tab_vline (table, TAL_2, row_headers, 0, tab_nr (table) - 1);
 299
 300   row = 0;
 301   tab_double (table, 1, column_headers + row++,
 302               0, fr->cc, wfmt);
 303
 304   if (ft->kendalls_w)
 305     tab_double (table, 1, column_headers + row++,
 306                 0, fr->w, 0);
 307
 308   tab_double (table, 1, column_headers + row++,
 309               0, fr->chi_sq, 0);
 310
 311   tab_double (table, 1, column_headers + row++,
 312               0, ost->n_vars - 1, &F_8_0);
 313
 314   tab_double (table, 1, column_headers + row++,
 315               0, gsl_cdf_chisq_Q (fr->chi_sq, ost->n_vars - 1),
 316               0);
 317
 318   tab_submit (table);
 319 }