Titivillus

titivillus 是一个Python库和相关命令行工具，用于模拟文献网络和相关数据（特征、状态、边长度等）。它旨在为文本演化的定量方法提供基准，并提供虚拟树和网络以供开发调试。

该库是以中世纪经常引用的恶魔Titivillus 命名的，据说它代表Belphegor、Lucifer或Satan向抄写者的作品中引入错误。它可以与20世纪民间传说中的淘气生物——鬼火怪进行比较。

titivillus 如何工作？

该库提供了一些适用于文本演化的抽象，特别是在不强制纯树状演化的情况下。每个抄本包含多个独立的特征，每个特征都有其自己的历史。

在适用的情况下，随机生成遵循作者发布的用于模拟系统发育数据的另一个软件包 ngesh。

安装

在任何标准Python环境中，可以通过以下方式安装titivillus

$ pip install titivillus

如果需要，pip 安装将自动获取依赖项，如 numpy 和 networkx。强烈建议在单独的虚拟环境中安装库。

如何使用

对于大多数用途，可以从Python轻松创建随机谱系，方法如下

import titivillus
stemma = titivillus.random_stemma()

在各种参数中，可以传递一个伪随机数生成器种子，以确保在不同调用之间可重复。

stemma2 = titivillus.random_stemma(seed="uppsala")

在可用测试之后，可以检查茎干的内容。使用networkx的图形版本可以通过以下方式获得

import matplotlib.pyplot as plt
import networkx as nx

graph = stemma2.as_graph()
nx.draw(graph)
plt.show()

尚未发布任何独立的命令行工具。

变更日志

版本 0.0.1

• 首次公开发布，与Apophthegmata Patrum的实验相一致

社区指南

虽然作者可以直接联系以获得支持，但建议第三方使用GitHub标准功能，例如问题和拉取请求，以贡献、报告问题或寻求支持。

贡献指南，包括行为准则，可以在CONTRIBUTING.md文件中找到。

作者和引用

该库由Tiago Tresoldi开发（tiago.tresoldi@lingfil.uu.se）。

如果您使用titivillus，请按以下方式引用

Tresoldi, Tiago (2021). Titivillus，一个模拟随机茎干网络的工具。版本 0.0.1。乌普萨拉。可在以下网址获取：https://github.com/tresoldi/titivillus

在BibTeX中

@misc{Tresoldi2021titivillus,
  author = {Tresoldi, Tiago},
  title = {Titivillus, a tool for simulating random stemmatological networks},
  howpublished = {\url{https://github.com/tresoldi/titivillus}},
  address = {Uppsala},
  year = {2021},
}