Package 'logos'

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.

---

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")

---

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.

---