Welcome to lingtreemaps’s documentation!¶
The primary use case for lingtreemaps
is this:
You have some sort of data point for a group of related languages the distribution of which you want to visualize on both a genealogical tree and on a map.
lingtreemaps
allows you to do both at once, in a single, customizable map + tree image.
All you need is a language table, a tree, and a feature table.
Tables are either stored in CSV files, or provided as pandas dataframes.
Trees are either stored in .nwk
/.newick
files, or provided as Bio.Phylo.BaseTree objects.
The minimal requirements for the input are:
The language table must have a
Latitude
and aLongitude
colum.It must also have an
ID
colum, which will be used to connect to connect the coordinates to the labels on the tree.The tree must be in newick format, and have leaf labels corresponding to the contents of the
ID
colum in the language table.Your feature table must have the columns
Clade
(corresponding to the values of theID
columns in the language table) andValue