counter.c File Reference

Detailed Description

Provides functions to sequence values over an n-dimensional grid.

Copyright

• (c) 2002 The University of Chicago, as Operator of Argonne National Laboratory.
• (c) 2002 The Regents of the University of California, as Operator of Los Alamos National Laboratory.

License

This file is distributed under the terms of the Software License Agreement found in the file LICENSE included with this distribution.

Author

M. Borland, C. Saunders, R. Soliday

Definition in file counter.c.

#include "mdb.h"

Go to the source code of this file.

Functions
long	advance_values (double *value, long *value_index, double *initial, double *step, long n_values, long *counter, long *max_count, long n_indices)
	Sequences an array of values systematically to cover an n-dimensional grid.
long	advance_counter (long *counter, long *max_count, long n_indices)
	Advances the counter array based on maximum counts.

Function Documentation

advance_counter()

long advance_counter	(	long *	counter,
		long *	max_count,
		long	n_indices )

Advances the counter array based on maximum counts.

Parameters

counter	Pointer to the counter array to be advanced.
max_count	Pointer to the array of maximum counts.
n_indices	Number of indices in the counter.

Returns

Returns -1 if all counters have reached their maximum; otherwise, returns the index that was incremented.

Definition at line 51 of file counter.c.

                                                                     {
  long i;
 
  for (i = 0; i < n_indices; i++)
    if (counter[i] != (max_count[i] - 1))
      break;
  if (i == n_indices)
    return (-1);
 
  for (i = 0; i < n_indices; i++) {
    if (counter[i] < (max_count[i] - 1)) {
      counter[i]++;
      break;
    } else {
      counter[i] = 0;
    }
  }
  return (i);
}

advance_values()

long advance_values	(	double *	value,
		long *	value_index,
		double *	initial,
		double *	step,
		long	n_values,
		long *	counter,
		long *	max_count,
		long	n_indices )

Sequences an array of values systematically to cover an n-dimensional grid.

Parameters

value	Pointer to the array of values to be updated.
value_index	Pointer to the array of value indices.
initial	Pointer to the array of initial values.
step	Pointer to the array of step sizes.
n_values	Number of values in the array.
counter	Pointer to the counter array.
max_count	Pointer to the maximum count array.
n_indices	Number of indices.

Returns

Returns -1 if the counter cannot be advanced further; otherwise, returns the index of the counter that was changed.

Definition at line 31 of file counter.c.

                                                                    {
  long i, counter_changed;
 
  if ((counter_changed = advance_counter(counter, max_count, n_indices)) < 0)
    return (-1);
 
  for (i = 0; i < n_values; i++)
    value[i] = initial[i] + counter[value_index[i]] * step[i];
  return (counter_changed);
}