annotate README.txt @ 16:50b319ad87b8

cleanup
author Jeff Hammel <k0scist@gmail.com>
date Tue, 24 Nov 2020 10:44:13 -0800
parents 0c2b1fe8f53f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
1 wordstream
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
2 ==========
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
3
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
4 wordstream is a simple corpus of text associations and tools to use them. Feeding the corpus text will grow a stack of left to right word associations on a per word basis. Words are defined (for now) as the bits that sit between whitespace. The corpus can then be eaten: given a word, pop the top of its stack.
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
5
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
6 There are two interfaces to the corpus in the wordstream package:
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
7 wordstream and dissociate. Additional applications of wordstream can
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
8 also be imagined.
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
9
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
10 The wordstream source is at http://k0s.org/hg/wordstream
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
11
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
12
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
13 wordstream interface
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
14 --------------------
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
15
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
16 An interactive interface for eating and feeding the corpus. Wordstream has a command line interface, ``wordstream``, and a web interface usable by running ``paster serve wordstream.ini`` . In both cases, the usage is the same. From an initial corpus, the user types lines of text. wordstream will eat the corpus and print a response to the text and feed the user's lines to the corpus
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
17
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
18
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
19 dissociate interface
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
20 --------------------
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
21
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
22 Named after emacs' ``M-x dissociated-press`` (try it!), dissociate will feed documents to a corpus, scramble the corpus (shuffle the stack order for each word), and output the corpus eating itself, selecting random words, eating their associations, and then eating the associations of the associations until the corpus is empty. Dissociate has a command line interface (install the software and run ``dissociate --help`` for usage), and a web interface usable via paster serve dissociate.ini.
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
23
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
24 Applications
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
25 ------------
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
26
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
27 While the wordstream corpus is a simple model, the basic idea can be
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
28 used to
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
29
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
30 * Thesaurus: By feeding the corpus synonyms, wordstream could be used
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
31 as a thesaurus program. Synonymity could be indicated via either
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
32 word count or by position towards the top of the stack. The
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
33 thesaurus could be displayed as a web interface to allow automatic
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
34 suggestions while writing
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
35
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
36 * Writing analysis: The amount of text on the web is vast.
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
37 Wordstream could be used to present what is being talked about most
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
38 within a number of websites and what is associated to it.
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
39
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
40 * Collaborative fiction: Since wordstream can use a collective corpus
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
41 that is fed by interacting with it, several authors could
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
42 simultaneously iteract with the wordstream web interface each
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
43 feeding the collective corpus and literally eating each others'
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
44 words
0c2b1fe8f53f update documentation a little
k0s <k0scist@gmail.com>
parents:
diff changeset
45