Help

MATLAB> help function_name

on the MATLAB command line. This provides information on

1. the general use of the function
2. the required and optional input arguments
3. the required and optional output arguments
4. all possible alternative ways of how to call this function.

Example

Type help LoadDNA. This will give the following explanations on how to use the function LoadDNA :

LoadDNA -- Loads a data set with DNA multiple alignments. The data set must be of the following format: 1st line: Number of species, INTEGER. The row must be padded with dummy variables. From line 2 on: Data array. All lines must be of equal length, unmatching lines must be padded out with zeros. The symbols have the following meaning: 1 --> A, 2 --> C, 3 --> G, 4 --> T, 0 --> missing value. At current only 4-species tree building is supported, so if the number of lines exceeds 4 an integer vector is needed as an argument to this function to select those species that are to be considered.

INPUT
dna_data - name of the file with the dna data, must be of type string.
selected_species - integer vector of 4 species selected for the phylogenetic tree [optional if the file contains only 4 species].

OUTPUT
data(1:4,N) - DNA data

USAGE
data=LoadDNA('DNAdata.dat')
OR
data=LoadDNA('DNAdata.dat',[n1, n2, n3, n4]) where ni are integer values <= N_species.