Learn R Programming

logos

The goal of logos is to give access to the Greek New Testament (27 books) and the Tanach (39 books) and allow users to do textual analysis on the data. The New and Old Testament have been provided in their original languages, Greek and Hebrew, respectively. Additionally, the English Standard Version (ESV) Revised American Standard Bible (RASB) is also provided for users who’d rather use a word–for–word modern (1901) English translation.

Installation

You can install the development version of logos like so:

devtools::install_github("jpmonteagudo28/logos")

or download the package from CRAN like so:

install.packages("logos")

How to

The main function in this package is the select_passage() function as it allows you to retrieve entire sections, books, chapters or verses of the English Bible (RASB), Greek New Testament, and Hebrew Old Testament. The remaining functions are helpers that facilitate retrieval and manipulation of biblical text.

Besides select_passage(), you have access to five datasets. The Revised Standard American Bible, ‘rasb_bible’, the Society of Biblical Literature Greek New Testament,‘new_testament’, and the Leningrad Codex containing the Old testament,‘old_testament’. Two additional datasets are ‘author_data’ which contains a breakdown of the authors, dates, sections and books of the Old and New Testament, and ‘verses_by_book’, which provides a count of the total number of verses for each book of the bible.

library(logos)

# Let's grab a passage from the Gospel of John, chapter 1, verses 1 - 6
select_passage("Jhn",chapter = 1, verse = 1:6, language = "English", testament = "new)

# You can do so it a different language by changing the language argument
select_passage("Jhn",chapter = 1, verse = 1:6, language = "Greek", testament = "new)

# Notice that if you provide incompatible language and testament combinations for the Greek and Hebrew text, the function will throw an error and remind you to use the right combinations. 
select_passage("Jhn",chapter = 1, verse = 1:6, language = "Hebrew", testament = "new)

A secondary function is peek(), a base R replacement for dplyr’s glimpse(). This function can be used to quickly get a sense of the data you’ll be working with.

peek(old_testament)

peek(verses_by_book)

Some real-life examples

Statistics have been applied to the field of biblical research for some years now, and the creation of the stylo and quanteda package have made it much easier to perform qualitative quantitative analysis on the biblical data.

I leave a few interesting articles that show the intermingling of stats and scripture.

Project status

Actively developed, though the pace has slowed now that I’m busier with other packages and my school work. I have no plans to substantially enlarge or extend it before really testing it.

Contributions

If you would like to contribute to this package, I’d love your help! Please read the guidelines for submitting a pull request.

Code of Conduct

Please note that the logos project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Copy Link

Version

Install

install.packages('logos')

Monthly Downloads

135

Version

0.1.0

License

GPL (>= 3)

Issues

Pull Requests

Stars

Forks

Maintainer

JP Monteagudo

Last Published

February 18th, 2025

Functions in logos (0.1.0)

suggest_closest_book

Suggest the closest matching book name
retrieve_chapter

Retrieve a specific chapter or portion of a chapter from the Bible
select_passage

Select a book, passage or portion of a book from the old or new testament
verses_by_book

Verses by Book
standardize_testament

Standardize Bible testaments to a common format
by_date

Retrieve standardized book names based on probable writing period
peek

Take a Quick Overview of Your Data
logos-package

logos: Access to the Leningrad Codex Version of the Old Testament,the Greek New Testament, and the Revised American Standard Bible
new_testament

The Society of Biblical Literature Greek New Testament
by_section

Retrieve standardized book names based on biblical narrative styles or genres
get_fraction

Get Fraction of a Chapter or Book
author_data

Author Data for Biblical Books
old_testament

Old Testament Dataset
get_bible_version

Get Bible Version
by_author

Retrieve standardized book names based on biblical authors
standardize_name

Standardize book names to a common format
rasb_bible

RASB Bible
validate_book

Validate book names against a reference list