Command line interface#
Command line interface for tskit.
usage: python3 -m tskit [-h] [-V]
{info,trees,upgrade,vcf,individuals,nodes,edges,sites,mutations,populations,migrations,provenances}
...
Positional Arguments#
- subcommand
Possible choices: info, trees, upgrade, vcf, individuals, nodes, edges, sites, mutations, populations, migrations, provenances
Named Arguments#
- -V, --version
show program’s version number and exit
Sub-commands#
info#
Print summary information about a tree sequence.
python3 -m tskit info [-h] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
trees#
Print information about trees.
python3 -m tskit trees [-h] [--precision PRECISION] [--draw] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --precision, -p
The number of decimal places to print in records
Default: 6
- --draw, -d
Draw the trees
Default: False
upgrade#
Upgrade legacy tree sequence files.
python3 -m tskit upgrade [-h] [--remove-duplicate-positions]
source destination
Positional Arguments#
- source
The source tskit tree sequence file in legacy format
- destination
The filename of the upgraded copy.
Named Arguments#
- --remove-duplicate-positions, -d
Remove any duplicated mutation positions in the source file.
Default: False
vcf#
Convert the tree sequence genotypes to VCF format.
python3 -m tskit vcf [-h] [--ploidy PLOIDY] [--contig-id CONTIG_ID]
[--allow-position-zero]
tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --ploidy, -P
If the tree sequence does not contain information about individuals, create them by combining adjacent samples nodes into individuals of the specified ploidy. It is an error to provide this argument if the tree sequence does contain individuals
- --contig-id, -c
Specify the contig id
Default: “1”
- --allow-position-zero, -0
Allow position 0 sites
Default: False
individuals#
Output individuals in tabular format.
python3 -m tskit individuals [-h] [--precision PRECISION] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --precision, -p
The number of decimal places to print in records
Default: 6
nodes#
Output nodes in tabular format.
python3 -m tskit nodes [-h] [--precision PRECISION] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --precision, -p
The number of decimal places to print in records
Default: 6
edges#
Output edges in tabular format.
python3 -m tskit edges [-h] [--precision PRECISION] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --precision, -p
The number of decimal places to print in records
Default: 6
sites#
Output sites in tabular format.
python3 -m tskit sites [-h] [--precision PRECISION] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --precision, -p
The number of decimal places to print in records
Default: 6
mutations#
Output mutations in tabular format.
python3 -m tskit mutations [-h] [--precision PRECISION] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --precision, -p
The number of decimal places to print in records
Default: 6
populations#
Output population information in tabular format.
python3 -m tskit populations [-h] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
migrations#
Output migration information in tabular format.
python3 -m tskit migrations [-h] [--precision PRECISION] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- --precision, -p
The number of decimal places to print in records
Default: 6
provenances#
Output provenance information in tabular format.
python3 -m tskit provenances [-h] [-H] tree_sequence
Positional Arguments#
- tree_sequence
The tskit tree sequence file
Named Arguments#
- -H, --human
Print out the provenances in a human readable format
Default: False