IntegerVariable: IntegerVariable Class

Description Methods

Description

Represents a integer valued variable for an individual. This class is similar to CategoricalVariable, but can be used for variables with unbounded ranges, or other situations where part of an individual's state is better represented by an integer, such as household or age bin.

Methods

Public methods


Method new()

Create a new IntegerVariable.

Usage
IntegerVariable$new(initial_values)
Arguments
initial_values

a vector of the initial values for each individual


Method get_values()

Get the variable values.

Usage
IntegerVariable$get_values(index = NULL)
Arguments
index

optionally return a subset of the variable vector. If NULL, return all values; if passed a Bitset or integer vector, return values of those individuals.


Method get_index_of()

Return a Bitset for individuals with some subset of values. Either search for indices corresponding to values in set, or for indices corresponding to values in range [a,b]. Either set or a and b must be provided as arguments.

Usage
IntegerVariable$get_index_of(set = NULL, a = NULL, b = NULL)
Arguments
set

a vector of values (providing set means a,b are ignored)

a

lower bound

b

upper bound


Method get_size_of()

Return the number of individuals with some subset of values. Either search for indices corresponding to values in set, or for indices corresponding to values in range [a,b]. Either set or a and b must be provided as arguments.

Usage
IntegerVariable$get_size_of(set = NULL, a = NULL, b = NULL)
Arguments
set

a vector of values (providing set means a,b are ignored)

a

lower bound

b

upper bound


Method queue_update()

Queue an update for a variable. There are 4 types of variable update:

  1. Subset update: The argument index represents a subset of the variable to update. The argument values should be a vector whose length matches the size of index, which represents the new values for that subset.

  2. Subset fill: The argument index represents a subset of the variable to update. The argument values should be a single number, which fills the specified subset.

  3. Variable reset: The index vector is set to NULL and the argument values replaces all of the current values in the simulation. values should be a vector whose length should match the size of the population, which fills all the variable values in the population

  4. Variable fill: The index vector is set to NULL and the argument values should be a single number, which fills all of the variable values in the population.

Usage
IntegerVariable$queue_update(values, index = NULL)
Arguments
values

a vector or scalar of values to assign at the index

index

is the index at which to apply the change, use NULL for the fill options. If using indices, this may be either a vector of integers or a Bitset.


Method .update()

Usage
IntegerVariable$.update()

Method clone()

The objects of this class are cloneable with this method.

Usage
IntegerVariable$clone(deep = FALSE)
Arguments
deep

Whether to make a deep clone.


individual documentation built on Oct. 25, 2021, 9:09 a.m.