Navigation Banner
 

SimulateDataSet Batch language command
  Data file simulation instruction.
Syntax  DataSet datasetid = SimulateDataSet(likelihood_function_id, "comma separated list of excluded states",simulated rates, category variable names);
Notes The first argument of the call is an existing likelihood function. 'Simulate' uses current values of parameters in the function to simulate a data set of the same size/type as the one references by the function. If the likelihood function references more than one data set, 'SimulateDataSet' will work with the first data set reference, and all others which have the same number of species/type. The second optional parameter is the list of states which are not permissible as the result of simulation. Whatever states are included there will not be present in the simulated data. 'datasetid' received the simulated data.

'simulated_rates' (optional) - a matrix to receive simulated heterogeneous rates. The dimension of the matrix will be KxN, where K is the number of category variables that the likelihood function depends; N is the total number of data sites in the likelihood function. The entries in a column of the matrix will be the (randomly sampled) category variables that the site depends on.

'category_variable_names' (optional) - a string matrix, of dimension Kx1. The entry in row 'i' is the name of the i-th category variable. Used in conjunction with 'simulated_rates'.

datasetid is a valid identifier (alphanumeric sequence with possible underscores beginning with a letter or an underscore).
likelihood_function_id must reference an already defined likelihood function.

Examples
DataSet sds = SimulateDataSet(lf);

or

DataSet sds = SimulateDataSet(lf,"TAA,TGA,TAG");

 Last modified: 8/22/2002

 
Sergei L. Kosakovsky Pond and Spencer V. Muse, 1997-2002