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
Latitudeand aLongitudecolum.It must also have an
IDcolum, 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
IDcolum in the language table.Your feature table must have the columns
Clade(corresponding to the values of theIDcolumns in the language table) andValue