timetree
Settings of treetime timetree (Time tree), with their flags, config keys, and defaults.
Infer a time tree and estimate the clock rate from sampling dates.
Eingaben
- Tree (erforderlich): Newick or Nexus
- Metadata (erforderlich): CSV, TSV or SSV table
- Alignment (empfohlen): Aligned FASTA
Input data
Alignment
--alignment - Wert
FILE- Konfigurationsschlüssel
alignment
Each --alignment file is numbered by its position in the list (1, 2, ...) and is one partition, unless --partition entries of ancestral, optimize, or timetree split it into several. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file. Use - to read uncompressed input from standard input (stdin); - may appear at most once.
- Wert
ENTRY- Konfigurationsschlüssel
partition- Nicht kombinierbar mit
- --model --model-params --partition-by
- Beispiele
[{"name":"cp12","sites":["1-1500\\3","2-1500\\3"]},{"name":"cp3","sites":["3-1500\\3"],"model":"hky85","model_params":["kappa=4"]}]
--alignment file with its own substitution model; repeat the flag for each partitionWithout --partition, each --alignment file is one partition with the model of --model. An entry is a YAML or JSON map with the keys name (the name of the partition in outputs and messages), alignment (the number of its --alignment file, 1, 2, ...; required with two or more files), sites (a list of site ranges, numbered from 1: a, a-b, or a-b\k for every k-th site from a to b), model (the substitution model, default infer) and model_params (the key=value items of --model-params for that model). Each entry carries its own model, so --model and --model-params cannot be used together with --partition. Every alignment needs at least one entry, and every site belongs to exactly one entry. An entry without sites takes the sites that the other entries of its alignment leave; one entry per alignment can leave out sites. Write site ranges in single quotes or without quotes, because YAML reads a backslash in double quotes as an escape. Example: --partition "{name: cp1, sites: ['101-1600\3']}" --partition "{name: cp2, sites: ['102-1600\3']}" --partition "{name: cp3, sites: ['103-1600\3'], model: hky85, model_params: ['kappa=4']}" --partition "{name: noncoding}".
- Wert
SCHEME- Konfigurationsschlüssel
partition_by- Werte
codon-positionsCodon positions 1, 2 and 3 of every CDS of `--annotation` as the partitions `cp1`, `cp2` and `cp3`, and the other sites as `noncoding`genesOne partition per CDS of `--annotation`, named by the CDS, and the other sites as `noncoding`rate-categoriesThe partitions `slow`, `medium` and `fast` from the number of changes at each site in a Fitch reconstruction on the input tree, by the rule of `--rate-category-rule`
- Nicht kombinierbar mit
- --partition
--alignment file from a scheme instead of --partition entriescodon-positions makes the partitions cp1, cp2 and cp3 from codon positions 1, 2 and 3 of the CDSs of --annotation, and noncoding from the other sites. genes makes one partition per CDS of --annotation, named by the CDS, and noncoding from the other sites. Both need one --annotation file per --alignment file, matched in list order, whose ##sequence-region runs from 1 to the length of its alignment, because annotation positions are alignment columns only for an alignment on that reference. Where CDSs overlap, the longest CDS owns the shared sites and gives them their codon positions; a CDS whose sites all belong to longer CDSs gets no partition. rate-categories counts the changes at each site in a Fitch reconstruction on the input tree and puts the sites into the partitions slow, medium and fast by the rule of --rate-category-rule; it uses no annotation. Every partition gets the model of --model and --model-params; with the default infer, each partition fits its own model, subject to --shared-params. With two or more --alignment files, the partition names start with the number of the file, for example 2/cp1. A scheme needs the alphabet nuc and must make at least two partitions over all files.
- Wert
RULE- Konfigurationsschlüssel
rate_category_rule- Werte
change-counts`slow` for sites without changes, `medium` for one change, `fast` for two or moremedian-split`slow` for sites without changes; changed sites at or below the median count of the changed sites go to `medium`, sites above it to `fast`k-meansThe three groups of change counts with the smallest sum of squared deviations from their group means (exact one-dimensional k-means), named by increasing mean count
--partition-by rate-categories by their change countschange-counts puts sites without changes into slow, sites with one change into medium, and sites with two or more changes into fast. median-split puts sites without changes into slow, and splits the changed sites at the median of their counts: at or below the median into medium, above it into fast. k-means splits all counts into the three groups with the smallest sum of squared deviations from their means, named by increasing mean count. Empty partitions are left out.
Annotation
--annotation - Wert
FILE- Konfigurationsschlüssel
annotation
--alignment fileWith --partition-by codon-positions or genes, give one file per --alignment file, matched in list order: the scheme builds the partitions of each alignment from the CDSs of its annotation. In ancestral, the file also supplies the annotations of the augur node data and, without --cds-selection, the CDSs that --translations reconstructs; --translations takes one --alignment file and one annotation file. TreeTime reads the coding regions from the CDS rows, which need strand + or - and phase 0, 1 or 2. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file.
Tree
--tree - Wert
FILE- Konfigurationsschlüssel
tree
A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file.
Segment trees
--segment-trees - Wert
FILE- Konfigurationsschlüssel
segment_trees
Every node of every tree needs a name, unique within its tree; a name that occurs in several trees is one node of the graph. A node that a segment only passes through stays in that segment's tree as a node with one child. An edge shared by several trees gets the mean of their branch lengths. Use instead of --tree, together with --segment-alignments. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file.
Segment alignments
--segment-alignments - Wert
FILE- Konfigurationsschlüssel
segment_alignments
--segment-trees file, in the same orderUse instead of --alignment. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file.
- Wert
NEWICK_DIALECT- Konfigurationsschlüssel
newick_dialect- Werte
classic,plainclassic,beastclassic,nhxclassic,mrbayesenewick,plainenewick,beastenewick,nhxenewick,mrbayesrich,plainrich,beastrich,nhxrich,mrbayes
A dialect is a tree structure and an annotation convention, written as <structure>,<annotations>. The structure is classic (plain labels and branch lengths), enewick (hybrid nodes such as x#H1) or rich (eNewick with support and probability fields). The annotations are plain (comments are text), beast ([&key=value]), nhx ([&&NHX:key=value]) or mrbayes ([&B name value]). For example, enewick,beast reads networks with BEAST annotations and classic,nhx reads NHX trees. TreeTime reads trees only, so a network input is an error.
- Konfigurationsschlüssel
allow_missing_sequences
Without this flag the run aborts when more than one third of the tips lack a sequence, because the alignment may not belong to the tree. Useful for per-CDS translations, where some samples have no peptide for a given CDS.
Metadata
--metadata - Wert
FILE- Konfigurationsschlüssel
metadata
--metadata-id-columns names the column that links a row to a tree tip. The other columns hold the data of the sample, such as its sampling date or its traits. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file.
- Wert
COLUMN- Konfigurationsschlüssel
metadata_id_columns
The first listed column that is present in the header is used. Matching is case-insensitive.
- Wert
CHAR- Konfigurationsschlüssel
metadata_delimiters
The delimiter actually present in the file is used. Defaults to comma, tab, and semicolon.
- Wert
COLUMN- Konfigurationsschlüssel
date_column
- Wert
FORMAT- Konfigurationsschlüssel
date_format
- Wert
N- Konfigurationsschlüssel
sequence_length
Required without --alignment, and applies only then: with an alignment, the run takes the length from the alignment.
- Wert
ALPHABET- Konfigurationsschlüssel
alphabet- Werte
nucaaaa-no-stop
nuc (default): nucleotides A, C, G and T, with the IUPAC ambiguity codes and N for an unknown base. aa: the 20 amino acids and the stop codon * as a 21st state, with X for an unknown residue. aa-no-stop: the 20 amino acids without a state for the stop codon.
- Konfigurationsschlüssel
zero_based
Applies to the mutations in the comments of Newick and Nexus trees and to the positions of the homoplasy report. Auspice JSON, augur node data, and UShER MAT outputs count from 1, as their formats require. An input table with positions, such as --drms, is always counted from 1.
Molecular clock
- Wert
CLOCK_RATE- Konfigurationsschlüssel
clock_rate- Beispiele
0.001
Without this setting, the run estimates the rate.
- Wert
CLOCK_STD_DEV- Konfigurationsschlüssel
clock_std_dev
Applies only with --confidence, whose date intervals include the clock rate uncertainty.
- Wert
SLACK COUPLING- Konfigurationsschlüssel
relax- Beispiele
[1,0]
--relax 1.0 0.5SLACK is the strength of the Gaussian prior on the rate deviation of each branch, and COUPLING the strength of the coupling of the rates of parent and child branches. Values around 1.0 give weak priors; larger values constrain the rate deviations more strongly. A COUPLING of 0 (--relax 1.0 0) gives an uncorrelated clock.
- Wert
CLOCK_FILTER- Konfigurationsschlüssel
clock_filter
0 switches the filter off.
- Konfigurationsschlüssel
allow_negative_rate
By default, rates are forced to be positive. For trees with little temporal signal, removing this restriction gives essentially mid-point rooting.
- Konfigurationsschlüssel
prune_filtered_tips
The clock filter flags a tip and leaves it in the tree by default. With this flag, the run removes the flagged tips after the filter: timetree before the time inference, and clock before the final clock fit. Every output leaves the removed tips out, and a run warning names them. The tips that --keep-tips and --keep-tips-file name stay in the tree, flagged. Requires the clock filter (--clock-filter above 0).
augur refine with a clock filter (--clock-filter-iqd) removes the flagged tips and also the tips without a usable date. To remove the same tips, add --prune-undated-tips.
- Konfigurationsschlüssel
prune_undated_tips
A tip has no usable date when the metadata gives no date for it, or a value that is not a date, a numeric date, or a date range. Such a tip stays in the tree by default: timetree infers its date from the tree, and the clock fit leaves it out. With this flag, the run removes these tips: timetree before the time inference, and clock before the final clock fit. Every output leaves the removed tips out, and a run warning names them. The tips that --keep-tips and --keep-tips-file name stay in the tree.
Together with --prune-filtered-tips, the run removes the same tips as augur refine with a clock filter (--clock-filter-iqd).
- Wert
NAME- Konfigurationsschlüssel
keep_tips
Accepts several names, separated by commas or spaces. A kept flagged tip stays flagged: the clock fit leaves it out, and timetree dates it from the tree, as it dates a kept tip without a usable date. Names that match no tip are ignored.
Keep tips file
--keep-tips-file - Wert
FILE- Konfigurationsschlüssel
keep_tips_file
Surrounding whitespace is trimmed and empty lines are ignored. Names that match no tip are ignored, so the file can list samples of several datasets. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file. Use - to read uncompressed input from standard input (stdin).
Rooting
- Wert
REROOT- Konfigurationsschlüssel
reroot- Werte
least-squaresMinimizes the residuals of the root-to-tip regression on the sampling datesmin-devMinimizes the variance of root-to-tip distances over all tips; more robust than midpointoldestRoots at the middle of the branch above the oldest dated tipmidpointRoots at the middle of the longest tip-to-tip path; uses only the two farthest tips
- Nicht kombinierbar mit
- --keep-root --outgroup
least-squares and oldest use the sampling dates; min-dev and midpoint use only the branch lengths, root once on the input branch lengths, and count every tip. Without a rooting setting the tree is rerooted by least-squares. Use --outgroup to root on named tips, or --keep-root to keep the input root.
- Wert
OUTGROUP- Konfigurationsschlüssel
outgroup- Nicht kombinierbar mit
- --keep-root --reroot
- Beispiele
["outgroup_tip"]
With one tip, the root is placed on the branch leading to that tip.
- Konfigurationsschlüssel
keep_root- Nicht kombinierbar mit
- --outgroup --reroot
Branch lengths
- Wert
BRANCH_LENGTH_MODE- Konfigurationsschlüssel
branch_length_mode- Werte
auto`input` without an alignment or when the longest input branch is longer than 0.1 substitutions per site, `marginal` otherwiseinputKeep the branch lengths of the input treemarginalEstimate the branch lengths from the alignment by marginal ancestral reconstruction
auto keeps the input branch lengths without an alignment, and also when the longest input branch is longer than 0.1 substitutions per site, because the re-estimated branch lengths are accurate only at short evolutionary distances; otherwise it re-estimates them as marginal does. When no input branch has a length, auto chooses marginal. The run logs the choice.
- Wert
N- Konfigurationsschlüssel
max_iter
Polytomy resolution and coalescent models of the time inference need at least 2 iterations.
- Konfigurationsschlüssel
no_collapse_short_branches
By default, before the time inference, internal edges shorter than 0.1/L (L is the number of sites of all alignments) with no substitution in the marginal reconstruction are contracted, as in optimize and TreeTime 0.x. The substitutions of a contracted edge move to its child edges, and the nodes it joined become one polytomy. Edges above internal nodes with a date are kept. When set, such edges are kept.
- Konfigurationsschlüssel
no_indels
When set, branch-length optimization uses the substitution-only likelihood, and the branch distributions of the time inference exclude the Poisson indel term. This matches standard phylogenetic tools (RAxML, IQ-TREE, PhyML, BEAST) and TreeTime 0.x. By default, indels count.
Dating
- Konfigurationsschlüssel
confidence
Runs a final marginal round of the time inference after the iterations and writes the 90% interval of every dated node. The intervals include the clock rate uncertainty when one is known: --clock-std-dev for a given rate, or the Gaussian estimate of an estimated rate. The rate uncertainty is added by inferring the dates again at the rate plus and minus one standard deviation and combining both parts in quadrature.
- Wert
N- Konfigurationsschlüssel
max_grid_points- Beispiele
1000000
A run stops with an error when a grid would need more points. The value bounds single grids, not the total memory of a run. When unset, the run takes the limit of the app or server that runs it, otherwise 1000000.
- Konfigurationsschlüssel
cross_parent_messages
A node with several parents sends each parent its subtree by default, and one sweep of message passing suffices. With this flag, the message to a parent also carries the messages that the other parents sent in the previous sweep, and the sweeps repeat until the node times settle. Applies only with --segment-trees.
Polytomies
- Konfigurationsschlüssel
keep_polytomies
Without this flag, each polytomy is resolved into binary mergers by the node dates. The resolution is stochastic: the run logs the seed it draws, and --seed reproduces the run.
Coalescent prior
- Wert
TC|opt|skyline- Konfigurationsschlüssel
coalescent- Werte
optskyline
- Beispiele
0.01
A time is a positive number directly followed by the unit y (years), w (weeks) or d (days). A time scale in substitutions per site is converted to years with the clock rate of each iteration. Without this setting the node times have no coalescent prior.
- Wert
N- Konfigurationsschlüssel
n_skyline
Applies only to --coalescent skyline. Sets how many piecewise linear segments model Tc(t) over time. Must be at least 2.
- Wert
SKYLINE_STIFFNESS- Konfigurationsschlüssel
skyline_stiffness
Penalizes log-fold-changes of the coalescent time scale Tc between adjacent skyline segments: with z = ln Tc, the objective adds (stiffness/2) * Σ (ln(Tc_{i+1}/Tc_i))^2. Because it acts on log Tc, the stiffness is dimensionless and scale-independent. Larger values enforce a smoother Tc(t). Applies only to --coalescent skyline.
- Wert
COALESCENT_CONFIDENCE- Konfigurationsschlüssel
coalescent_confidence
Applies only to the inferred coalescent priors (--coalescent opt and --coalescent skyline). The band spans Tc * exp(±confidence * σ), where σ is the standard deviation of ln Tc from the coalescent likelihood curvature. A fixed time scale is not inferred and therefore has no band.
- Wert
GEN_PER_YEAR- Konfigurationsschlüssel
gen_per_year
The coalescent output reports an effective population size N_e = Tc * gen_per_year. Tc is already in calendar years, so this factor rescales it into generation units, the standard axis of a skyline plot. Only affects the reported N_e; it does not enter the inference. Applies only with --coalescent.
Substitution model
- Wert
MODEL- Konfigurationsschlüssel
model- Werte
jc69k80f81hky85t92tn93jtt92inferInfer GTR parameters from data via Fitch parsimony substitution counts.
- Nicht kombinierbar mit
- --partition
infer infers a model from the data of each partition; each --alignment file is one partition. Alternatively, name the model type. If the named model takes parameters, use --model-params to set them. The model applies to every file. In commands with --partition, each entry carries its own model, so --model is an error next to entries.
- Wert
MODEL_PARAMS- Konfigurationsschlüssel
model_params- Nicht kombinierbar mit
- --partition
--model, given as space-separated key=value itemsThe parameters apply to the model of every partition; each --alignment file is one partition. In commands with --partition, each entry carries its own model and parameters, so --model-params is an error next to entries. Keys: mu (the overall substitution rate, every named model), kappa (the transition to transversion ratio of k80, hky85 and t92), kappa1 and kappa2 (the rate ratios of tn93), pi (the equilibrium frequencies of f81, hky85 and tn93: comma-separated numbers, one frequency per state of the alphabet in its order, for example A, C, G and T for nucleotides, normalized to sum 1; also pis, Pi, Pis) and pi_GC (the GC content of t92, between 0 and 1). A key left out keeps its default. Example: --model hky85 --model-params kappa=0.2 pis=0.25,0.25,0.25,0.25.
- Wert
PARTITION_RATES- Konfigurationsschlüssel
partition_rates- Werte
estimateEstimate one relative rate per partition, normalized to a site-weighted mean of 1.equalFix the relative rate of every partition at 1.
Each --alignment file is one partition, or each --partition entry when there are entries. With two or more partitions, all partitions share the branch lengths, and each partition has one relative rate that scales them for the sites of that partition. estimate fits the rate of each partition with the rest of its substitution model fixed (a partition with --model infer starts from its fitted rate), then divides all rates by their mean weighted by the number of sites of each partition, so that this mean is 1. The branch lengths are then expected substitutions per site, averaged over all sites of all partitions. equal fixes the rate of every partition at 1.
The setting applies only with two or more partitions.
- Wert
K- Konfigurationsschlüssel
gamma_categories
Sites of one partition evolve at different speeds. With this setting, every partition gets K rate categories of equal probability whose rates are the means of K equal-probability slices of a gamma distribution with mean 1 and shape alpha (Yang 1994). The likelihood of a site is the mean of its likelihoods under the K rates, and the ancestral states are weighted by the probability of each rate at the site. Each partition estimates its own alpha by maximum likelihood between 0.02 and 100, unless the partitions share gamma-shape (--shared-params). Without the setting, all sites of a partition share one rate. Memory grows about K-fold, runtime more: with 4 categories, optimize on the example datasets takes 7 to 25 times as long, most on large trees in sparse mode. 4 categories are the common choice. The setting applies to marginal reconstructions only: not with --method-anc parsimony and not with --branch-length-mode input.
- Wert
SHARED_PARAMS- Konfigurationsschlüssel
shared_params- Werte
exchange-ratesShare the exchange rates W.frequenciesShare the equilibrium frequencies pi.gamma-shapeShare the gamma shape alpha.noneShare no model parameter.
exchange-rates: one set of exchange rates W for all these partitions. Each partition scales W so that its rate matrix has mean rate 1 under its own frequencies, so with different frequencies the stored W of the partitions differ by a factor. frequencies: one set of equilibrium frequencies. gamma-shape: one gamma shape alpha; needs --gamma-categories. none: every partition fits its own model; stands alone. The fit of the shared parameters uses the substitutions of all sharing partitions together. A partition with a named model keeps the parameters of its model. Every partition keeps its own relative rate (--partition-rates), and all partitions share the tree and the branch lengths.
Default: with --partition-by genes or rate-categories, the partitions share exchange-rates and frequencies, and also gamma-shape with --gamma-categories, because genes of one genome share the mutation process and rate buckets differ only in speed. With --partition-by codon-positions, --partition entries, or one partition per --alignment file, they share nothing, because codon positions differ in their pattern of change. The setting applies only with two or more partitions whose model is infer.
Ancestral reconstruction
- Wert
REPRESENTATION- Konfigurationsschlüssel
representation- Werte
autoLet TreeTime choose the representation; it chooses sparsedenseProbabilities of every state at every alignment positionsparseOnly the variable positions
The dense representation stores the probabilities of every state at every alignment position of each node; the sparse representation stores only the variable positions. Dense is more accurate when branches are long and many sites change, but uses more memory.
- Wert
GAP_FILL- Konfigurationsschlüssel
gap_fill- Werte
only-terminalallnone
only-terminal (default, as in TreeTime 0.x): replace the leading and trailing gaps of each sequence with the unknown character of the alphabet (N or X). all: replace every gap with the unknown character. none: keep every gap.
- Konfigurationsschlüssel
include_leaves
- Konfigurationsschlüssel
reconstruct_tip_states
--include-leaves --impute-missing-data: emit tip sequences with ambiguous and unknown states resolved to the most likely inferred state.- Konfigurationsschlüssel
report_ambiguous
N for nucleotides, X for amino acids).By default these mutations are omitted from the branch mutations of the Newick and Nexus annotations, the Auspice JSON, and the muts and aa_muts lists of augur node data. Other ambiguity codes, such as K or R, are always reported. The flag does not affect the MAT outputs, which store N as missing data and never contain these mutations.
- Konfigurationsschlüssel
impute_missing_data
N and IUPAC codes such as R) to the most likely inferred state.Gaps are left as deletions, because they are inferred structure, not missing data. Changes that involve ambiguous characters on terminal branches then disappear from the branch mutations. Only defined for marginal reconstruction; a no-op with a warning under --method-anc=parsimony.
Output
Output all
--output-all - Wert
DIR- Konfigurationsschlüssel
output_all
Writes the default outputs of the command as <dir>/<command>.<ext>. --output-selection restricts the outputs that the folder receives. The per-file flags (--output-*) override or supplement the files of the folder.
An output that the run has no data for is skipped without a message, for example the substitution model of a run that fits none. A per-file flag for such an output fails.
Every output path follows these rules. A path that ends in .gz, .bz2, .xz, or .zst writes a compressed file. The compression level is 2, unless the environment variable GZ_COMPRESSION, BZ2_COMPRESSION, XZ_COMPRESSION, or ZST_COMPRESSION sets another level. .gz, .xz, and .zst compress with all --jobs threads. .bz2 compresses with one thread and is much slower to write and to read than the other formats. The path - of a per-file flag writes the output uncompressed to standard output. Missing parent folders are created.
Table outputs choose the delimiter by the extension of their path: .tsv writes tabs and .csv commas, also before a compression suffix (dates.tsv.gz); - writes tabs to standard output. Default names use .tsv.
With several --alignment files, the outputs that carry sequence positions are written once per file: reconstructed sequences, the augur node data of ancestral, Auspice, UShER MAT, Nexus, and Newick with --newick-annotations other than plain. Files are numbered 1, 2, ... in the order of the --alignment list. Their default names carry the number after the command name (<dir>/<command>.1.<ext>), and the file name of a per-file flag for such an output must contain {alignment}, which is replaced by the number. Other tree outputs with {alignment} in their file name are also written once per file.
The outputs written once per CDS, such as the reconstructed amino-acid sequences, take the placeholder {cds} or %GENE in the file name of their per-file flag, which is replaced by the name of the CDS. The placeholder is required when more than one CDS is reconstructed; folder names are used as given.
- Wert
NEWICK_ANNOTATIONS- Konfigurationsschlüssel
newick_annotations- Werte
plainbeastnhx
plain, beast, or nhx.plain writes no comments. beast writes a comment such as [&mutations="A45G,G136T",date=2016.45] after each node, and nhx writes the same values as [&&NHX:key=value]. The comments hold the mutations on the branch above the node, its date, and its inferred trait value, as far as the command infers them. Nexus outputs always carry beast comments, which FigTree reads.
Output tree Newick
--output-tree-nwk - Wert
FILE- Konfigurationsschlüssel
output_tree_nwk
--newick-annotations sets the node comments.
Output tree nexus
--output-tree-nexus - Wert
FILE- Konfigurationsschlüssel
output_tree_nexus
The nodes carry BEAST comments ([&mutations="A45G,G136T",date=2016.45]).
Output tree auspice
--output-tree-auspice - Wert
FILE- Konfigurationsschlüssel
output_tree_auspice
Output tree MAT protobuf
--output-tree-mat-pb - Wert
FILE- Konfigurationsschlüssel
output_tree_mat_pb
Output tree MAT JSON
--output-tree-mat-json - Wert
FILE- Konfigurationsschlüssel
output_tree_mat_json
Output tree graph JSON
--output-tree-graph-json - Wert
FILE- Konfigurationsschlüssel
output_tree_graph_json
Output tree DOT
--output-tree-dot - Wert
FILE- Konfigurationsschlüssel
output_tree_dot
- Wert
OUTPUT_SELECTION- Konfigurationsschlüssel
output_selection- Werte
allnwknexusauspicemat-pbmat-jsongraph-jsondotnode-datamodelsequencesclock-modelrttdatestracelogcoalescentcoalescent-json
--output-all.Restricts which outputs --output-all writes. Special value all expands to every output available for this command. Requires --output-all. Per-file flags are always honored regardless of this selection.
A selected output that the run has no data for is skipped without a message, for example the substitution model of a run that fits none. A per-file flag for such an output fails. An output that the settings rule out fails in both forms, for example the sequences of timetree --branch-length-mode input.
- Wert
DIVERGENCE_UNITS- Konfigurationsschlüssel
divergence_units- Werte
mutations-per-sitemutations
mutations-per-site (default): branch divergence as substitutions per site. mutations: count of reconstructed substitutions per branch that change the state: gaps, N, and ambiguity codes compatible with the parent state do not count. mutations requires reconstructed sequences, so it does not work with input branch lengths (--branch-length-mode=input).
Output node data
--output-node-data - Wert
FILE- Konfigurationsschlüssel
output_node_data
Contains per-node dates, branch lengths, clock model parameters, confidence intervals, and divergence metrics. The output is compatible with augur export v2 --node-data for Nextstrain pipeline integration.
Output model
--output-model - Wert
FILE- Konfigurationsschlüssel
output_model
Output sequences
--output-sequences - Wert
FILE- Konfigurationsschlüssel
output_sequences
Holds the reconstructed sequences of the internal nodes, and of the tips with --include-leaves or --reconstruct-tip-states; --impute-missing-data resolves ambiguous tip states.
Output clock model
--output-clock-model - Wert
FILE- Konfigurationsschlüssel
output_clock_model
Output root-to-tip
--output-rtt - Wert
FILE- Konfigurationsschlüssel
output_rtt
One row per sample: the date the regression used, the root-to-tip distance it regressed on, the date the clock model predicts from that distance, and whether the clock filter excluded the sample.
Output dates
--output-dates - Wert
FILE- Konfigurationsschlüssel
output_dates
--confidence.Output tracelog
--output-tracelog - Wert
FILE- Konfigurationsschlüssel
output_tracelog
Output coalescent
--output-coalescent - Wert
FILE- Konfigurationsschlüssel
output_coalescent
Written when a coalescent prior is set with --coalescent. A fixed time scale writes one band-less segment over the tree span.
Output coalescent JSON
--output-coalescent-json - Wert
FILE- Konfigurationsschlüssel
output_coalescent_json
Written when a coalescent model is set.
- Wert
AMBIGUITY_THRESHOLD- Konfigurationsschlüssel
ambiguity_threshold
The value is a difference of probabilities from 0 to 1. With 0, the report names only the states that tie with the most likely state. RAxML-NG uses 0.5 divided by the number of states, for example 0.125 for nucleotides. The report is off when the value is not set.
The reconstructed FASTA writes a position with more than one reported state as the IUPAC code of these states, or N for all four nucleotides. Internal nodes have a report at every position, leaves only at the positions that --impute-missing-data imputes.
- Wert
AMBIGUITY_OUTPUTS- Konfigurationsschlüssel
ambiguity_outputs- Werte
sequencesReconstructed nucleotide FASTA
Without this list, every output of the run that can carry the report carries it. Requires --ambiguity-threshold.
Tree ordering
- Wert
TOPOLOGY_ORDER- Konfigurationsschlüssel
topology_order- Werte
keepdescendant-countdescendant-count-reverseheightheight-reversedivergencedivergence-reverselabellabel-reversetarget-ordertarget-order-reverse
Topology order tree
--topology-order-tree - Wert
FILE- Konfigurationsschlüssel
topology_order_tree- Nicht kombinierbar mit
- --topology-order-list
Used by --topology-order target-order and target-order-reverse. Without this flag and --topology-order-list, the leaf order of the input tree is the target order. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file.
Topology order list
--topology-order-list - Wert
FILE- Konfigurationsschlüssel
topology_order_list- Nicht kombinierbar mit
- --topology-order-tree
Used by --topology-order target-order and target-order-reverse. Without this flag and --topology-order-tree, the leaf order of the input tree is the target order. A path that ends in .gz, .bz2, .xz, or .zst reads a compressed file.
- Wert
TOPOLOGY_ORDER_AGGREGATE- Konfigurationsschlüssel
topology_order_aggregate- Werte
meanmedian
Reproducibility
- Wert
SEED- Konfigurationsschlüssel
seed
Without a seed, a run with a random step draws one and logs it, so the run can be reproduced.