Work with a published release of the HMT project archive

To work with a published release of the HMT project archive, use both the HmtArchive and HmtArchive.Analysis modules.

using HmtArchive, HmtArchive.Analysis

The current published release is always available at https://raw.githubusercontent.com/homermultitext/hmt-archive/master/releases-cex/hmt-current.cex. The function hmt_cex is a utility that downloads the current release and reads it into a single string. (Obviously, this requires a connection to the internet.)

Verify what release you’re using with the hmt_releaseinfo function.

src = hmt_cex()
hmt_releaseinfo(src)

"Homer Multitext project, release 2024c"

Reading contents: texts

You can retrieve editions of HMT texts either as pure diplomatic editions, or normalized texts.

normalizedtexts = hmt_normalized(src)

Corpus with 40485 citable passages in 12 documents.

diplomatictexts = hmt_diplomatic(src)

Corpus with 40485 citable passages in 12 documents.

You can retrieve a catalog of the texts in the release

textcatalog = hmt_textcatalog(src)

TextCatalogCollection with 16 entries

Working with citable texts

The text corpora are instances of the CitableTextCorpus type; the text catalog is a TextCatalogCollection, both from the Julia CitableCorpus package.

To learn about using citable texts in the CitableCorpus package, see its documentation.

Reading other kinds of content

The HmtArchive.Analysis module provides functions to read the contents of a published release into citable objects.

See the guides section of this site for recipes for working with other kinds of material in HMT publications.