NAME

altree - Association and Localisation tests using phylogenetic Trees

SYNOPSIS

altree [options]

 Options:
    --version        program version
    --short-help|h   brief help message
    --help           help message with options descriptions
    --man            full documentation
    --association|a  perform the association test
    --s-localisation|l   perform the localisation using the S character
    --first-input-file|i result_file from phylogeny reconstruction programs
    --second-input-file|j file containing the nb of cases/controls carrying an haplotype
    --output-file|o output_file
    --data-type|t DNA|SNP
    --data-qual|q qualitative|quantitative
    --outgroup outgroup_name
    --remove-outgroup 
    --tree-building-program|p phylip|paup|paml
    --splitmode|s nosplit|chi2split
    --no-prolongation
    --chi2-threshold|n value
    --permutations|r number
    --number-of-trees-to-analyse number
    --tree-to-analyse number
    --s-site-number number
    --s-site-characters ancestral state -> derived state
    --co-evo|e simple|double
    --print-tree 
    --anc-seq ancestral sequence (only with phylip)
    --nb-files number of input files to analyse (only for association test)

OPTIONS

--version

Print the program version and exits.

--short-help

Print a brief help message and exits.

--help

Print a help message with options descriptions and exits.

--man

Prints the manual page and exits.

--association|a

Perform the association test

--s-localisation|l

Localise the susceptibility locus using the "S-character method"

--first-input-file|i result_file

Input file 1 (paup, phylip or paml results file). If several input files are analysed, their names must be separated by colons. Example: input1:input2 etc

--second-input-file|j correspond_file

Input file 2, default correspond.txt. The number of input file 2 must be the same as the number of input file 1. The name of the different input file 2 must be separated by colons

--output-file|o outfile

Output file

--data-type|t "DNA"|"SNP"

Type of data: DNA (ATGCU) or SNP (0-1)

--data-qual|q "qualitative"|"quantitative"

Analyse qualitative (case/control) or quantitative data

--outgroup outgroup

Root the tree with this outgroup

--remove-outgroup

Remove the outgroup of the tree before performing the tests

--tree-building-program|p "phylip"|"paup"|"paml"

Phylogeny reconstruction program

--splitmode|s "nosplit"|"chi2split"

how tests are performed from a level to another

--no-prolongation

No prolongation of branches in the tree

--chi2-threshold|n value

Significance threshold for chi2 (default value 0.01)

--permutations|r number

Number of permutations used to calculate exact p_values (Only for association test)

--number-of-trees-to-analyse number

Number of trees to analyse in the localisation analysis (only for localisation method using S-character)

--tree-to-analyse number

With this option, you can specify the tree to use (instead of random). Can be used several times to specify multiple trees.

--s-site-number number

Number of the S character site in the sequence (only for localisation method using S-character)

--s-site-characters transition

Character states for the S character: ancestral state -> derived state ex: G->C or 0->1 (only for localisation method using S-character)

--co-evo|e "simple"|"double"

Type of co-evolution indice
simple: only the anc -> der transition of S is used
double: the two possible transitions are used

--print-tree

If this option is selected, the tree will be printed to the output

--anc-seq anc_seq

With this option, you can specify the ancestral sequence. This option is only useful when the tree is reconstructed using the mix program of phylip with the ancestral states specified in the file "ancestors"

--nb-files number

With this option, you specify the number of input files (1 and 2) to analyse This option only works for the association test. Be careful if the number of trees is not the same for the different input files: if the chosen tree doesn't exist in one file, the program wil not work correctly

DESCRIPTION

This program performs

(a) an association test between a candidate gene and disease or a quantitative trait

(b) a localsation tests: it allows to detect which SNP is involved in the determinism of the disease or the quantitative trait

These two tests are based on the analysis of haplotype phylogenetic trees.