Teiphy

This release corrects the previous release's fix for STEMMA outputs (so that they support 22 states rather than 24) and updates several dependencies to address vulnerabilities noted by Dependabot.

This minor release adds some missing attributes to state/ancestral logger elements in BEAST outputs to ensure that root frequencies (corresponding to intrinsic probability judgments) are incorporated into probability calculations for state sampling. It also fixes a previous bug in mapping variant reading indices to state codes in STEMMA outputs, so that reading indices (up to a maximum of 24 per variation unit) are now mapped to single-character state codes.

The main change introduced in this release is support for tagging of potential transcriptional explanations with notBefore and notAfter attributes. If these attributes are present in a variation unit's transcriptional relations list, teiphy will now map the transcriptional relations to an EpochSubstitutionModel with a different substitution model for different slices of time. This feature is only supported for BEAST 2.7 XML outputs. This means that BEAST users can now model time-dependent transcriptional changes (like assimilation to later popular texts, paleographic confusions possible only for earlier or later scripts, etc.) more accurately.

A related change is the addition of more comprehensive rules for updating witness date ranges based on the date range of the work's composition (and vice-versa). This change affects age/date calibrations for NEXUS and BEAST 2.7 XML formats (including the MrBayes NEXUS input format).

This release also fixes an error that prevented the --verbose flag from working correctly.

Starting from this release, teiphy now correctly uses AncestralSequenceLogger elements (from the BEAST_CLASSIC package) instead of AncestralStateLogger elements (from the BEASTLabs package) in BEAST XML outputs.

Previously, works with known dates of origin (specified as a `date` element with a `when` attribute) generated BEAST XML outputs with unnecessary prior distributions on the origin of the birth-death-skyline model. This release fixes the handling of such cases.

In this release, teiphy's options for tabular outputs (in CSV, TSV, and Excel format) have been expanded and better organized. The type of tabular output desired can now be specified on the command line with the `--table` flag. Valid options are `matrix` (the default option, with rows for variant readings, columns for witnesses, and frequency values in cells), `distance` (a pairwise distance/dissimilarity matrix with rows and columns for witnesses and counts or proportions of disagreements at extant variation units in cells), `nexus` (with rows for witnesses, columns for variation units, and reading IDs in cells), and `long` (a series of rows with witness, variation unit ID, reading index, and reading text entries). Notably, `--table long` replaces the old `--long-table` command-line flag. A fix has been added to ensure that Unicode CSV and TSV files are loaded correctly in Excel. Finally, teiphy will now create directories in the output filepath if they do not already exist.