Navigation Banner
 

ReadDataFile Batch language command
  Data file reading instruction.
Syntax  DataSet datasetid = ReadDataFile("filename");
Notes The argument of the command designates the file to be read. The resulting data set is stored in the receptacle 'datasetid'. Upon successful completion of this command, 'datasetid' contains the data, and 3 variables are automatically created:
- datasetid.species : number of species in the data set
- datasetid.sites: number of sites(columns) in the data set
- datasetid.unique_sites: number of unique sites in the data set.

If 'filename' is set to 'PROMPT_FOR_FILE', the user will be asked to specify the data file name at the time of execution.

filename must be given relative to the batch file which contains the ReadDataFile statement.
datasetid is a valid identifier (alphanumeric sequence with possible underscores beginning with a letter or an underscore).

Sets IS_TREE_PRESENT_IN_DATA, DATAFILE_TREE, NEXUS_FILE_TREE_MATRIX (for NEXUS files), DATA_FILE_PARTITION_MATRIX.

Examples
DataSet ds = ReadDataFile("../data/hiv.dat");
 Last modified: 8/20/2002

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