vpar.gp

This is some functions for Pari/GP making calculations on labelled oriented trees (graph theory trees) as "vpar" vector of parent vertex numbers. Functions include

• Height, depth, eccentricity, radius, diameter, centre, centroid, weights, Wiener index and terminal Wiener.
• Children, neighbours, siblings, singletons, rows, min/max ancestor or descendant.
• Matrix adjacency, skew adjacency, incidence, path lengths, Laplacian.
• Independent sets, matchings, maximal matchings, equimatchable, stable and almost equimatchable.
• Dominating sets, minimal dominating sets, total dominating sets, independent dominating sets, disjoint domination number.
• Relabelling, re-rooting, upwards/downwards.
• Isomorphism as rooted, free, or ordered.
• Iteration labelled, rooted, ordered.
• Prime code.
• Subdivide, join, delete, contract, branch reduce, root above, forest components.
• Sequences pre-order, post-order, rows, up queue, subtree height, subtree sizes, blob, successive paths, childless paths.
• Make some specific trees, including random labelled or ordered.
• Counts of various trees, forests, or properties.
• Least child monk, hereditary least single.

Vertices are numbered 1 to n. A tree is a vector vpar where vpar[v] is parent of v, or 0 if no parent. Such a representation is oriented in that there is a distinguished root (or roots for a forest) and labelled in that each vertex has a particular number. There are no other attributes etc.

The main use is to calculate or verify properties of specific trees of interest. Various functions like diameter are the same for any root or labelling so effectively act as on a "free" tree and the vertex numbers just for tree creation. Most functions are linear in the number of vertices so can be used on large trees.

The connections to Pari/GP specifics are at polynomials and Set()s for independent sets etc, matrices for some linear algebra or eigenvalues etc, permutations in relabelling, and then general compactness of GP for experimenting etc.

vpar.gp is free software (free as in freedom), published under the terms of the GNU General Public License (v3 or higher). Download version 6 here,

vpar.gp (415k, and sig), or compressed vpar.gp.gz (107k)
vpar-6.tar.gz (479k, and sig)

Just vpar.gp is enough to run. The tar file includes some self-tests and some work-in-progress extras (most of which work but may change wildly). The sig files are Gnu PG ascii armoured signatures generated from my key.