Navigation Banner
 

HarvestFrequencies Batch language command
  This function allows one to collect the frequencies of characters (states) in a data set (or filter).
Syntax  HarvestFrequencies (receptacle,dataid,atom,unit,position_dependent_flag);
Notes


'receptacle' is the matrix identifier which will refer to the resulting frequencies table.
'dataid' is either a data set or a data set filter.
'atom' determines the size of the data atom to count in terms of character length
'unit' is the size (in terms of character length) of the block within each atom to be counted. The ultimate output will count frequencies of units.
'position_dependent_flag' determines whether units are to be counted accounting for (or not accounting) for their position within the 'atom'.

The resulting matrix will have dimension 'unit states' x 1 (position_dependent_flag is false) or
'unit states' x (atom/unit) (position_dependent_flag is true), where 'unit states' is the number of distinct possible units ordered in terms of the ordering of characters in the data. (e.g. for nucleotides and atom = 3, codon 'cat' will be in row 20.)

dataid must refer to an existing data set. 'atom' and 'unit' are positive integers, and 'atom' must be divisible by 'unit'. 'position_dependent_flag' is either 0 (false) or 1 (true).

Examples
HarvestFrequencies (freq, ds, 1,1,0);

HarvestFrequencies (freq, ds, 3,1,1);

 Last modified: 8/19/2002

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