Blame movstat/apply.c

Packit 67cb25
/* movstat/apply.c
Packit 67cb25
 *
Packit 67cb25
 * Copyright (C) 2018 Patrick Alken
Packit 67cb25
 * 
Packit 67cb25
 * This program is free software; you can redistribute it and/or modify
Packit 67cb25
 * it under the terms of the GNU General Public License as published by
Packit 67cb25
 * the Free Software Foundation; either version 3 of the License, or (at
Packit 67cb25
 * your option) any later version.
Packit 67cb25
 * 
Packit 67cb25
 * This program is distributed in the hope that it will be useful, but
Packit 67cb25
 * WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 67cb25
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit 67cb25
 * General Public License for more details.
Packit 67cb25
 * 
Packit 67cb25
 * You should have received a copy of the GNU General Public License
Packit 67cb25
 * along with this program; if not, write to the Free Software
Packit 67cb25
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Packit 67cb25
 */
Packit 67cb25
Packit 67cb25
#include <config.h>
Packit 67cb25
#include <stdlib.h>
Packit 67cb25
#include <math.h>
Packit 67cb25
#include <gsl/gsl_math.h>
Packit 67cb25
#include <gsl/gsl_errno.h>
Packit 67cb25
#include <gsl/gsl_vector.h>
Packit 67cb25
#include <gsl/gsl_movstat.h>
Packit 67cb25
Packit 67cb25
/*
Packit 67cb25
gsl_movstat_apply_accum()
Packit 67cb25
  Apply moving window statistic to input vector. This is a generalized
Packit 67cb25
routine to handle window endpoints and apply a given accumulator to
Packit 67cb25
the input vector.
Packit 67cb25
Packit 67cb25
Inputs: endtype      - end point handling criteria
Packit 67cb25
        x            - input vector, size n
Packit 67cb25
        accum        - accumulator to apply moving window statistic
Packit 67cb25
        accum_params - parameters to pass to accumulator
Packit 67cb25
        y            - output vector, size n
Packit 67cb25
        z            - second output vector (i.e. minmax), size n; can be NULL
Packit 67cb25
        w            - workspace
Packit 67cb25
Packit 67cb25
Notes:
Packit 67cb25
1) It is allowed to have x = y for in-place moving statistics
Packit 67cb25
*/
Packit 67cb25
Packit 67cb25
int
Packit 67cb25
gsl_movstat_apply_accum(const gsl_movstat_end_t endtype,
Packit 67cb25
                        const gsl_vector * x,
Packit 67cb25
                        const gsl_movstat_accum * accum,
Packit 67cb25
                        void * accum_params,
Packit 67cb25
                        gsl_vector * y,
Packit 67cb25
                        gsl_vector * z,
Packit 67cb25
                        gsl_movstat_workspace * w)
Packit 67cb25
{
Packit 67cb25
  if (x->size != y->size)
Packit 67cb25
    {
Packit 67cb25
      GSL_ERROR("input and output vectors must have same length", GSL_EBADLEN);
Packit 67cb25
    }
Packit 67cb25
  else if (z != NULL && x->size != z->size)
Packit 67cb25
    {
Packit 67cb25
      GSL_ERROR("input and output vectors must have same length", GSL_EBADLEN);
Packit 67cb25
    }
Packit 67cb25
  else
Packit 67cb25
    {
Packit 67cb25
      const int n = (int) x->size;
Packit 67cb25
      const int H = w->H; /* number of samples to left of current sample */
Packit 67cb25
      const int J = w->J; /* number of samples to right of current sample */
Packit 67cb25
      int i;
Packit 67cb25
      double x1 = 0.0;    /* pad values for data edges */
Packit 67cb25
      double xN = 0.0;
Packit 67cb25
      double result[2];
Packit 67cb25
Packit 67cb25
      /* initialize accumulator */
Packit 67cb25
      (accum->init)(w->K, w->state);
Packit 67cb25
Packit 67cb25
      /* pad initial window if necessary */
Packit 67cb25
      if (endtype != GSL_MOVSTAT_END_TRUNCATE)
Packit 67cb25
        {
Packit 67cb25
          if (endtype == GSL_MOVSTAT_END_PADZERO)
Packit 67cb25
            {
Packit 67cb25
              x1 = 0.0;
Packit 67cb25
              xN = 0.0;
Packit 67cb25
            }
Packit 67cb25
          else if (endtype == GSL_MOVSTAT_END_PADVALUE)
Packit 67cb25
            {
Packit 67cb25
              x1 = gsl_vector_get(x, 0);
Packit 67cb25
              xN = gsl_vector_get(x, n - 1);
Packit 67cb25
            }
Packit 67cb25
Packit 67cb25
          /* pad initial windows with H values */
Packit 67cb25
          for (i = 0; i < H; ++i)
Packit 67cb25
            (accum->insert)(x1, w->state);
Packit 67cb25
        }
Packit 67cb25
      else if (accum->delete == NULL) /* FIXME XXX */
Packit 67cb25
        {
Packit 67cb25
          /* save last K - 1 samples of x for later (needed for in-place input/output) */
Packit 67cb25
          int idx1 = GSL_MAX(n - J - H, 0);
Packit 67cb25
          int idx2 = n - 1;
Packit 67cb25
Packit 67cb25
          for (i = idx1; i <= idx2; ++i)
Packit 67cb25
            w->work[i - idx1] = gsl_vector_get(x, i);
Packit 67cb25
        }
Packit 67cb25
Packit 67cb25
      /* process input vector and fill y(0:n - J - 1) */
Packit 67cb25
      for (i = 0; i < n; ++i)
Packit 67cb25
        {
Packit 67cb25
          double xi = gsl_vector_get(x, i);
Packit 67cb25
          int idx = i - J;
Packit 67cb25
Packit 67cb25
          (accum->insert)(xi, w->state);
Packit 67cb25
Packit 67cb25
          if (idx >= 0)
Packit 67cb25
            {
Packit 67cb25
              (accum->get)(accum_params, result, w->state);
Packit 67cb25
              gsl_vector_set(y, idx, result[0]);
Packit 67cb25
Packit 67cb25
              if (z != NULL)
Packit 67cb25
                gsl_vector_set(z, idx, result[1]);
Packit 67cb25
            }
Packit 67cb25
        }
Packit 67cb25
Packit 67cb25
      if (endtype == GSL_MOVSTAT_END_TRUNCATE)
Packit 67cb25
        {
Packit 67cb25
          /* need to fill y(n-J:n-1) using shrinking windows */
Packit 67cb25
          int idx1 = GSL_MAX(n - J, 0);
Packit 67cb25
          int idx2 = n - 1;
Packit 67cb25
Packit 67cb25
          if (accum->delete == NULL)
Packit 67cb25
            {
Packit 67cb25
              int wsize = n - GSL_MAX(n - J - H, 0); /* size of work array */
Packit 67cb25
Packit 67cb25
              for (i = idx1; i <= idx2; ++i)
Packit 67cb25
                {
Packit 67cb25
                  int nsamp = n - GSL_MAX(i - H, 0); /* number of samples in this window */
Packit 67cb25
                  int j;
Packit 67cb25
Packit 67cb25
                  (accum->init)(w->K, w->state);
Packit 67cb25
Packit 67cb25
                  for (j = wsize - nsamp; j < wsize; ++j)
Packit 67cb25
                    (accum->insert)(w->work[j], w->state);
Packit 67cb25
Packit 67cb25
                  /* yi = acc_get [ work(i:K-2) ] */
Packit 67cb25
                  (accum->get)(accum_params, result, w->state);
Packit 67cb25
                  gsl_vector_set(y, i, result[0]);
Packit 67cb25
Packit 67cb25
                  if (z != NULL)
Packit 67cb25
                    gsl_vector_set(z, i, result[1]);
Packit 67cb25
                }
Packit 67cb25
            }
Packit 67cb25
          else
Packit 67cb25
            {
Packit 67cb25
              for (i = idx1; i <= idx2; ++i)
Packit 67cb25
                {
Packit 67cb25
                  if (i - H > 0)
Packit 67cb25
                    {
Packit 67cb25
                      /* delete oldest window sample as we move closer to edge */
Packit 67cb25
                      (accum->delete)(w->state);
Packit 67cb25
                    }
Packit 67cb25
Packit 67cb25
                  /* yi = acc_get [ work(i:K-2) ] */
Packit 67cb25
                  (accum->get)(accum_params, result, w->state);
Packit 67cb25
                  gsl_vector_set(y, i, result[0]);
Packit 67cb25
Packit 67cb25
                  if (z != NULL)
Packit 67cb25
                    gsl_vector_set(z, i, result[1]);
Packit 67cb25
                }
Packit 67cb25
            }
Packit 67cb25
        }
Packit 67cb25
      else
Packit 67cb25
        {
Packit 67cb25
          /* pad final windows and fill y(n-J:n-1) */
Packit 67cb25
          for (i = 0; i < J; ++i)
Packit 67cb25
            {
Packit 67cb25
              int idx = n - J + i;
Packit 67cb25
Packit 67cb25
              (accum->insert)(xN, w->state);
Packit 67cb25
Packit 67cb25
              if (idx >= 0)
Packit 67cb25
                {
Packit 67cb25
                  (accum->get)(accum_params, result, w->state);
Packit 67cb25
                  gsl_vector_set(y, idx, result[0]);
Packit 67cb25
Packit 67cb25
                  if (z != NULL)
Packit 67cb25
                    gsl_vector_set(z, idx, result[1]);
Packit 67cb25
                }
Packit 67cb25
            }
Packit 67cb25
        }
Packit 67cb25
Packit 67cb25
      return GSL_SUCCESS;
Packit 67cb25
    }
Packit 67cb25
}
Packit 67cb25
Packit 67cb25
/*
Packit 67cb25
gsl_movstat_apply()
Packit 67cb25
  Apply user-defined moving window function to input vector
Packit 67cb25
Packit 67cb25
Inputs: endtype - end point handling criteria
Packit 67cb25
        F       - user-defined function
Packit 67cb25
        x       - input vector, size n
Packit 67cb25
        y       - output vector, size n
Packit 67cb25
        w       - workspace
Packit 67cb25
*/
Packit 67cb25
Packit 67cb25
int
Packit 67cb25
gsl_movstat_apply(const gsl_movstat_end_t endtype, const gsl_movstat_function * F,
Packit 67cb25
                  const gsl_vector * x, gsl_vector * y, gsl_movstat_workspace * w)
Packit 67cb25
{
Packit 67cb25
  int status = gsl_movstat_apply_accum(endtype, x, gsl_movstat_accum_userfunc, (void *) F, y, NULL, w);
Packit 67cb25
  return status;
Packit 67cb25
}