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.
Links
- download: https://pypi.org/project/reader-toolbox
- documentation: https://reader-toolbox.readthedocs.io
- source code: https://github.com/ericleasemorgan/reader-toolbox
- bug tracker: https://github.com/ericleasemorgan/reader-toolbox/issues
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)
| File | Size | Uploaded | |
|---|---|---|---|
| reader_toolbox-1.1.1.tar.gz | 70.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|