Performs a continuous-time microsimulation run (sequentially, i.e., using only one CPU core).
micSimParallel(initPop=NULL, immigrPop=NULL, initPopList= c(),
immigrPopList= c(), transitionMatrix, absStates=NULL,
varInitStates=c(), initStatesProb=c(), fixInitStates = c(),
maxAge=99, simHorizon, fertTr=c(), monthSchoolEnrol=c(),
cores=1, seeds=1254)A matrix representing the combined population after running the simulation in parallel. Each row corresponds to an individual, and columns represent different attributes or states of the individuals. The function ensures that unique IDs are assigned to newborns and that the final output is ordered correctly by these IDs. This matrix includes the results of the simulations for all subsets of the initial and immigrant populations processed across different cores.
Data frame comprising the starting population of the simulation.
Data frame comprising information about the immigrants entering the population across simulation time.
A list of matrices, where each matrix represents a subset of initial population.
A list of matrices, where each matrix represents a subset of the immigrant population.
A matrix indicating the transition pattern and the names of the functions determining the respective transition rates (with rates to be returned as vectors, i.e. for input age 0 to 10 eleven rate values have to be returned).
A vector indicating the absorbing states of the model.
(A vector comprising the) SubStates / attributes that are assigned to a newborn randomly according to the probabilities initStatesProb, i.e. that are not inherited from the mother.
A vector comprising the probabilities corresponding to varInitStates.
If fixInitStates are given (i.e. attributes from the mother are inherited), these probabilities have to sum to one conditioned on the inherited attributes,
i.e. for each (set of) inherited attribute(s) separately. Otherwise, the sum of initStatesProb has to be one.
(Vector of) Indices of SubStates determining the attributes/subStates that a newborn will be taken over from the mother. If empty or not defined, no attributes will be inherited.
A scalar indicating the exact maximal age (i.e., sharp 100.00 years) which an individual can reach during simulation. maxAge has to be greater than zero.
A vector comprising the starting and ending date of the simulation. Both dates have to be given in the format 'yyyymmdd'. The starting date has to precede the ending date.
A vector indicating all transitions triggering a child birth event during simulation, that is, the creation of a new individual.
The month (as numeric value from 1 to 12) indicating the general enrollment month for elementary school, e.g., 9 for September. If transition to elementary school is not defined (see below under 'details') and no such month is given school enrollment to elementary school is not modeled / simulated.
Number of cores as the user specifies. Note: The number is restricted by the maximum number of cores a computer (or a computer cluster) has.
To ensure that the results are replicable and are therefore reasonable, the user should always assign a seed to each PRNG (pseudo random number generator) representation used.
The micSimParallel function is designed to perform population simulations in parallel using multiple processing cores.
This function is particularly useful for large-scale simulations where computational efficiency is crucial.
The function takes an initial population and an immigrant population, both of which can be provided as single matrices or as lists of matrices for parallel processing.
If the populations are provided as lists, each element of the list is processed by a different core, allowing for efficient distribution of the computational load.