- align
a 'DNAbin' object; the alignment to be analysed. See "read.dna" in the ape package for details about reading alignments. Other inputs are available: Use a distance matrix instead an alignment using the 'align' option or provide a list of haplotypes and frequencies per population using 'Haplos' and 'HapPerPop' options
- indel.method
a sting; the method to define indel events in your alignments. The available methods are:
-"MCIC": (Default) Estimates indel events following the rationale of the Modified Complex Indel Coding (Muller, 2006).
-"SIC": Estimates indel events following the rationale of Simmons and Ochoterrena (2000).
-"FIFTH": Estimates indel events following the rationale of the fifth state: each gap within the alignment is treated
as an independent mutation event.
-"BARRIEL": Estimates indel events following the rationale of Barriel (1994): singleton gaps are not taken into account.
- substitution.model
a string; the substitution evolutionary model to estimate the distance matrix. By default is set to "raw" and
estimates the pairwise proportion of variant sites. See the evolutionary models available using ?dist.dna from the ape package.
- pairwise.deletion
a logical; if TRUE (default) substitutions found in regions being a gap in other sequences will account
for the distance matrix. If FALSE, sites being a gap in at least one sequence will be removed before distance estimation.
- network.method
a string; the method to build the network. The available methods are:
-"percolation": computes a network using the percolation network method following Rozenfeld et al. (2008).
See ?perc.thr for details
-"NINA": computes a network using the No Isolation Nodes Allowed method. See ?NINA.thr for details.
-"zero": computes a network connecting all nodes showing distances equal to zero. See ?zero.thr for details.
- range
a numeric vector between 0 and 1, is the range of thresholds (referred to the maximum distance in the input matrix) to be screened (by default, 101 values from 0 to 1). This option is used for "percolation" and "NINA" network methods and ignored for "zero" method.
- addExtremes
a logical; if TRUE, additional nucleotide sites are included in both extremes of the alignment. This will allow estimating distances for alignments showing gaps in terminal positions. This option is used for "SIC", "FIFTH" and "BARRIEL" indel methods and ignored for "MCIC" method.
- alpha
a numeric between 0 and 1, is the weight given to the indel genetic distance matrix in the combination. By definition, the weight of the substitution genetic matrix is the complementary value (i.e., 1-alpha). The value "info" will use the proportion of informative substitutions per informative indel event as weight. It is also possible to define multiple weights to estimate different combinations.
- combination.method
a string defining whether each distance matrix must be divided by its maximum value before the combination ("Corrected") or not ("Uncorrected"). Consequently, if the "Corrected" method is chosen (default option), both matrices are corrected to range between 0 and 1 before being combined.
- na.rm.row.col
a logical; if TRUE, removes rows and columns showing missing values within the distance matrix.
- NameIniPopulations
a numeric; Position of the initial character of population names within sequence names. If not provided, it is set to 1. It is used only if NameEndPopulations is also defined.
- NameEndPopulations
a numeric; Position of the last character of population names within sequence names. If not provided, it is set to the first "_" character in the sequences name. It is used only if NameIniPopulations is also defined.
- NameIniHaplotypes
a numeric; Position of the initial character of haplotype names within sequence names. If not provided, haplotype names are given and the value is set accordingly. It is used only if NameEndHaplotypes is also defined.
- NameEndHaplotypes
a numeric; Position of the last character of haplotype names within sequence names. If not provided, haplotype names are given and the value is set accordingly. It is used only if NameIniHaplotypes is also defined.
- save.distance
a logical; if TRUE, the distance matrix used to build the network will be saved as a file.
- save.distance.name
a string; if save.distance=TRUE, the name of the file to be saved.
- pop.distance.matrix
a matrix containing the population distances. Alternatively, it can be estimated from a given sequence alignment using 'align'. Alternatively, you can provide a list of haplotypes and frequencies using 'Haplos' and 'HapPerPop'
- Haplos
a two columns matrix containing sequence names and haplotype names as reported by FindHaplo. Alternatively, you can define an input alignment using 'align' or a distance matrix using 'pop.distance.matrix'.
- HaplosPerPop
a matrix containing the number of haplotypes found per population, as reported by HapPerPop (Weighted matrix).Alternatively, you can define an input alignment using 'align' or a distance matrix using 'pop.distance.matrix'.
- col.pie
a vector of strings; the colour to represent each haplotype. If 'NA' (or there are less colours than haplotyes), colours are automatically selected.
- label.col
a vector of strings; the colour of labels for each node in the network. Can be equal for all nodes (if only one colour is defined) or customized (if several colours are defined).
- label
a vector of strings; labels for each node. By default are the sequence names. (See "substr" function in base package to automatically reduce name lengths)
- label.sub.str
a vector of two numerics; if node labels are a substring of sequence names, these two numbers represent the initial and final character of the string to be represented. See Example for details.
- cex.label
a numeric; the size of the node labels.
- cex.pie
a numeric; the size of the nodes (pie charts).
- main
a sting; if set to "summary" the main options selected for representing the network are displayed in title. The default value ("") shows no title for the network.
- HaplosNames
a sting; the name of the haplotypes (if different from default: H1...Hn)
- offset.label
a numeric; the separation between node and label.
- pie.size
a string to define the ratio of pies representing populations. Possible values are: "equal" (default) to give the same size to all pies; "radius" to make the pie radius proportional to the population sample size; "area" to make the pie area proportional to the population sample size; or "points" to display simple vertices instead of pies representing haplotypes per population.
- coord
a two columns matrix containing coordinates where each haplotypes must be represented.
- get.coord
a logical, TRUE to obtain coordinates of nodes within the network