Title: Access to the Hebrew, Greek, and English Version of the Bible
Version: 0.1.0
Maintainer: JP Monteagudo <jpmonteagudo2014@gmail.com>
Description: Access to the Greek New Testament (27 books) and the Old Testament (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 Revised American Standard Bible is also provided for users who'd rather use a word–for–word modern English translation.
License: GPL (≥ 3)
Encoding: UTF-8
RoxygenNote: 7.3.2
URL: https://github.com/jpmonteagudo28/logos
BugReports: https://github.com/jpmonteagudo28/logos/issues
LazyData: true
Depends: R (≥ 4.1)
Suggests: testthat (≥ 3.0.0)
Config/testthat/edition: 3
Imports: dplyr
NeedsCompilation: no
Packaged: 2025-02-17 13:25:23 UTC; jpmonteagudo
Author: JP Monteagudo ORCID iD [aut, cre, cph]
Repository: CRAN
Date/Publication: 2025-02-18 10:10:06 UTC

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

Description

logo

Access to the Greek New Testament (27 books) and the Old Testament (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 Revised American Standard Bible is also provided for users who'd rather use a word–for–word modern English translation.

Author(s)

Maintainer: JP Monteagudo jpmonteagudo2014@gmail.com (ORCID) [copyright holder]

See Also

Useful links:

Author Data for Biblical Books

Description

A dataset containing information about the authors, books, sections, and languages of the Bible.

Usage

author_data

Format

A data frame with 66 rows and 6 variables:

author

Character. Name of the author (e.g., "Moses").

books

Character. Name of the book(s) authored.

section

Character. Section of the Bible (e.g., "Law", "History").

date

Character. Approximate date of authorship (e.g., "c. 1445-1405 BC").

testament

Character. Testament classification ("Old Testament" or "New Testament").

language

Character. Language in which the book was originally written (e.g., "Hebrew").

Details

This dataset summarizes metadata about biblical authors, sections, and book classifications.

Retrieve standardized book names based on biblical authors

Description

Collect book names from RASB Bible, Leningrad Codex, or Septuagint based on biblical authors outlined in 'author_data' dataset.

Usage

by_author(author, testament)

Arguments

author

a character vector or length 1 specifying the biblical author in the Old or New Testament

testament

a character vector of length 1 specifying the testament/time period in which the author is found

Value

a character vector of standardized book names to be passed to other functions

Retrieve standardized book names based on probable writing period

Description

Collect book names from RASB Bible, Leningrad Codex, or Septuagint based on the dates outlined in 'author_data' dataset.

Usage

by_date(date_range, testament)

Arguments

date_range

a character vector or length 1, written as a date range, "1445 - 1405 BC", specifying the probable writing period of the Old or New Testament books

testament

a character vector of length 1 specifying the testament corresponding to the provided date range

Value

a character vector of standardized book names to be passed to other functions

Retrieve standardized book names based on biblical narrative styles or genres

Description

Collect book names from RASB Bible, Leningrad Codex, or Septuagint based on narrative styles outlined in 'author_data' dataset.

Usage

by_section(section, testament)

Arguments

section

a character vector or length 1 specifying the narrative section or genre in the Old or New Testament

testament

a character vector of length 1 specifying the testament in which the section is found

Value

a character vector of standardized book names to be passed to other functions

Get Bible Version

Description

Retrieves the Bible data filtered by the specified language and testament.

Usage

get_bible_version(language, testament)

Arguments

language

A character string specifying the language of the Bible. Must be one of "English", "Hebrew", or "Greek".

testament

A character string specifying the testament. This input is standardized using standardize_testament() and should typically be "Old Testament", "New Testament", or "Both".

Details

This function filters the underlying Bible dataset based on the specified language and testament. For English, it divides the dataset into Old and New Testaments by using predefined book ranges from the rasb_bible dataset. For Hebrew and Greek, it refers to the old_testament and new_testament datasets respectively, and will produce an error if an unsupported combination is requested.

Value

A data frame containing the Bible data corresponding to the selected language and testament.

Get Fraction of a Chapter or Book

Description

Extracts a specified fraction of a chapter from a given book or a portion of a book.

Usage

get_fraction(book, chapter, fraction, part, language = NULL, testament = NULL)

Arguments

book

A character string or vector specifying the book(s) from which the chapter is retrieved.

chapter

A numeric vector indicating the chapter number(s) to be processed.

fraction

A numeric value representing the total number of sections into which the chapter should be divided. Must be an integer greater than or equal to 1.

part

A numeric value indicating which section of the divided chapter to return. Must satisfy 1 <= part <= fraction.

language

An optional character string indicating the language of the Bible. Typically one of "English", "Hebrew", or "Greek". Default is NULL.

testament

An optional character string specifying the testament. Should be "Old Testament", "New Testament", or "Both". Default is NULL.

Details

This function validates the fraction and part parameters, retrieves the full chapter text using retrieve_chapter(), and calculates the corresponding section of the chapter to return. The chapter is divided into equal parts based on the number of verses, and the function extracts the verses corresponding to the requested part.

Value

A character vector containing the verses from the specified section of the chapter.

The Society of Biblical Literature Greek New Testament

Description

A dataset containing the text of the New Testament in Greek with book metadata. The Society of Biblical Literature, in keeping with its mission to foster biblical scholarship, is pleased to sponsor, in association with Logos Bible Software, a new, critically edited edition of the Greek New Testament.

Usage

new_testament

Format

A data frame with 7,939 rows and 5 variables:

book

Character. Name of the book (e.g., "1Cor").

chapter

Character. Chapter number.

verse

Character. Verse number.

text

Character. Text of the verse in Greek.

greek_name

Character. Greek name of the book.

Details

This dataset provides the Greek text of the New Testament along with book and chapter metadata.

Old Testament Dataset

Description

A dataset containing the text of the Old Testament in Hebrew with book metadata. The Unicode/XML Leningrad Codex (UXLC) is a transcription of the Leningrad Codex (LC) into a modern computer format (Unicode, XML). The UXLC text is a fork of the Groves Center's Westminster Leningrad Codex WLC 4.20, 2016

Usage

old_testament

Format

A data frame with 23,213 rows and 5 variables:

book

Character. Name of the book (e.g., "Amos").

chapter

Numeric. Chapter number.

verse

Numeric. Verse number.

text

Character. Text of the verse in Hebrew.

hebrew_names

Character. Hebrew name of the book.

Details

This dataset provides the Hebrew text of the Old Testament along with book and chapter metadata.

Take a Quick Overview of Your Data

Description

peek() provides a transposed view of your dataset: columns are displayed vertically, while the data for each column is shown horizontally. This layout allows you to inspect all the columns of a data.frame at a glance. It serves as a convenient wrapper around utils::str(), with the added benefit of invisibly returning the input object, making it suitable for use in data pipelines.

Usage

peek(x, width = getOption("width"), ...)

Arguments

x

The object to be inspected.

width

integer(1). Specifies the maximum width of the output.

...

Additional arguments to pass to utils::str().

Value

The input object x, returned invisibly.

Examples

peek(mtcars)

RASB Bible

Description

A public domain dataset containing the text of the Bible from the Revised American Standard Bible (RASB).

Usage

rasb_bible

Format

A data frame with 31,102 rows and 4 variables:

book

Character. Name of the book (e.g., "Gen").

chapter

Integer. Chapter number.

verse

Integer. Verse number.

text

Character. Text of the verse.

Details

This dataset provides the full English text of the Bible from the RASB translation.

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

Description

This function retrieves text from a specified book and chapter, with optional filtering by verse, partitioning, and language selection.

Usage

retrieve_chapter(
  book,
  chapter = NULL,
  verse = NULL,
  fraction = NULL,
  part = NULL,
  language,
  testament
)

Arguments

book

A character string specifying the book of the Bible.

chapter

A numeric or character vector specifying the chapter(s) to retrieve.

verse

An optional numeric vector specifying specific verses to retrieve.

fraction

A numeric value indicating how many equal parts to divide the chapter into.

part

A numeric value specifying which part to return (must be between 1 and fraction).

language

A character string specifying the language of the Bible text. Options are "English", "Hebrew", or "Greek".

testament

A character string specifying whether to retrieve from the Old or New Testament.

Value

A character vector containing the retrieved Bible text.

Examples

retrieve_chapter("Jud",chapter = 1, verse = 1, language = "English", testament = "new")

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

Description

Retrieves a whole book(s), passage from a book or a portion of a book or chapter, based on specified criteria such as book, chapter, verse, or alternative selection using author, section, or date.

Usage

select_passage(
  book = NULL,
  chapter = NULL,
  verse = NULL,
  fraction = 1,
  part = 1,
  by = NULL,
  divider = NULL,
  language = "English",
  testament = NULL
)

Arguments

book

A character vector specifying the book name(s) from which to select the passage. Ignored if the by parameter is provided.

chapter

A numeric vector indicating the chapter(s) of the book. If selection by section, author or date is used, the chapter must be set to NULL.

verse

A numeric vector indicating the verse(s) within the chapter.

fraction

A numeric value (default 1) indicating how many equal parts to divide the chapter into.

part

A numeric value specifying which part to return (must be between 1 and fraction).

by

An optional character string for alternative selection criteria. It should be one of "author", "section", or "date". When provided, the book, chapter, and verse parameters must be NULL.

divider

A character vector specifying the author, section or date range to be selected.

language

A character string indicating the language of the passage. Must be one of "English", "Hebrew", or "Greek". Default is "English".

testament

A character string specifying the testament. Must be one of "Old", "New", or "Both" (case-insensitive). This parameter is required.

Details

This function validates the input parameters and determines the book(s) to be used based on the provided criteria. If the by argument is given, the function leverages helper functions such as by_author(), by_section(), or by_date() to select the appropriate book(s) based on the alternative criterion. The passage is then retrieved via retrieve_chapter(), applying verse filtering and partitioning based on the fraction and part arguments.

Value

Returns the selected passage as generated by the retrieve_chapter() function.

Examples

# Example 1: Select a passage by specifying book, chapter, and verse.
select_passage(book = "Genesis", chapter = 1, verse = 1, testament = "Old")
select_passage(book = "Mat", chapter = 1, verse = 1:10, testament = "new")

Standardize book names to a common format

Description

This function converts book names to their standardized abbreviations using a predefined lookup table.

Usage

standardize_name(book)

Arguments

book

A character vector of book names.

Value

A character vector of standardized book names.

Standardize Bible testaments to a common format

Description

This function converts testament to their standardized abbreviations using a predefined lookup table.

Usage

standardize_testament(testament)

Arguments

testament

A character vector of testament names.

Value

A character vector of standardized testament names.

Suggest the closest matching book name

Description

This function suggests the closest matching book name based on the input string. It uses approximate string matching to find similar book names from the provided list.

Usage

suggest_closest_book(book, book_list)

Arguments

book

A character vector of book names to check.

book_list

A character vector of valid book names to match against.

Value

A character vector of suggested book names or NA if no close match is found.

Validate book names against a reference list

Description

This function checks if the provided book names exist in a given list and suggests the closest match if not.

Usage

validate_book(book, book_list)

Arguments

book

A character vector, list, or data frame containing book names.

book_list

A character vector of valid book names.

Value

A character vector of validated or suggested book names.

Verses by Book

Description

A dataset containing the number of verses for each book in the Bible.

Usage

verses_by_book

Format

A data frame with 66 rows and 2 variables:

book

A character vector containing abbreviated book names (e.g., "1Chr", "1Cor", "1John", "1Kgs", "1Pet", "1Sam", "1Thess", "1Tim", etc.).

n

An integer vector representing the number of verses in each corresponding book.

Details

This dataset provides a summary of the verse counts for each book of the Bible. It is useful for biblical studies, allowing for quick reference to the structure of the biblical texts and facilitating statistical analysis.