Skip to main content

Distant Reader Toolbox

A command-line interface for creating and interacting with Distant Reader study carrels

Installation

  pip install reader-toolbox

Quick start

  # configure; accept the default
 rdr set -s local

  # add an item to your library
  rdr download homer

  # read homer
  rdr read homer

  # list all words
  rdr ngrams homer

  # list all bigrams
  rdr ngrams homer -s 2

  # list all bigrams and count them
  rdr ngrams homer -s 2 -c

  # search
  rdr concordance homer

  # search again, but specify a query
  rdr concordance homer -q war

  # list subject-verb-object fragments; please be patient
  rdr grammars homer

  # list noun phrases
  rdr grammars homer -g nouns

  # cluster; do the items in the carrel group themselves?
  rdr cluster homer

  # topic model; similar to cluster but with more detail
  rdr tm homer

  # page through additional carrels for downloading
  rdr catalog -l remote -h

  # download another carrel
  rdr download pride

  # download yet another carrel
  rdr download sonnets

  # list your carrels
  rdr catalog

Description and background

The Reader Toolbox -- run from the command-line as rdr -- is designed to create and interact with Distant Reader study carrels. Using the Toolbox you can do things such as but not limited to:

  • search and browse the collection of more than 3,000 publicly available study carrels
  • download study carrels from the public collection and add them to your own collection
  • count & tabulate the most frequent ngrams (one-word, two-word, etc. phrases) occurring in study carrels
  • apply concordancing (keyword-in-context searching) against study carrels
  • apply topic modeling (extracting latent themes) against study carrels
  • extract information from your study carrels matching specific grammars
  • create your own study carrels
  • and more

In the end, the Toolbox empowers you to read, use, and understand large volumes of text quickly and easily.


Eric Lease Morgan <emorgan@nd.edu>
January 5, 2023

Metadata

Release files for reader-toolbox 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reader-toolbox 1.1.1
File Size Uploaded
reader_toolbox-1.1.1.tar.gz 70.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for reader-toolbox 1.1.1
File Interpreter ABI Platform
reader_toolbox-1.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 140.0 kB

Release files / reader_toolbox-1.1.1.tar.gz

Download URL reader_toolbox-1.1.1.tar.gz
Size 70.0 kB
Tags Source
SHA-256 checksum
How to use checksums
ec7bb075899ae4d5565c2fd941aced71554713b0fe064e714c79be43848b0dbf
BLAKE2b-256 checksum
How to use checksums
3052a52e899dd847b67bb919481ab54a4e3962a300e2a39310118aa234837189
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.7

Release files / reader_toolbox-1.1.1-py3-none-any.whl

Download URL reader_toolbox-1.1.1-py3-none-any.whl
Size 70.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e168c294d335d072f45c53b34763464cf64c05b33c92d928efb4107b1f6f3fb
BLAKE2b-256 checksum
How to use checksums
d582889886ab35b19cbc1003e32edbd9b7a612c059795a147fd8831719830472
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.7

Release history Release notifications | RSS feed

This release

1.1.1 This release

2 release files

1.1.0

2 release files

0.9

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.0

2 release files

0.0.99

1 release file

0.0.98

2 release files

0.0.97

2 release files

0.0.96

2 release files

0.0.92

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page