Recent changes to Home

WikiPage Home modified by

Mon, 01 Aug 2011 16:55:02 -0000

--- v12 
+++ v13 
@@ -2,37 +2,36 @@
 ======================
 
 **What does it do?**  
-It is a relatively simple script to generate nonsensical output. It uses a training text to construct a Markov chain. Once the chain has been constructed, it is used to generate an arbitrarily long output sequence that mirrors the style of the training text.
-
-**So what does it do?**  
-It outputs a series of words, which are stylistically similar to the text you give it. If you train it on the Old Testament, it will generate biblical-sounding text. If you train it on a technical paper, it will generate technical-sounding text.
-
+It is a simple script to generate nonsensical output. It constructs a Markov chain from the training text. Once the chain has been constructed, it is used to generate an arbitrarily long output sequence that mirrors the style of the training text.
+
+**So *what* does it do?**  
+It outputs a block of text, which are stylistically similar to the text you give it. If you train it on the Bible, it will generate biblical-sounding text. If you train it on a technical paper, it will generate technical-sounding text.
+
 **What is a Markov Chain?**
 A Markov chain is a theoretical construct. It has series of states linked together with a non-deterministic transition function. Imagine a pinball machine, but taped to each obstacle is a word. Whenever the ball hits that obstacle, you write down the corresponding word. Depending on how words are attached to the pinball machine, you will get out different outputs.
 
 Examples
 ========
 
 Here are some example outputs generated from various training texts.
 
+###Word Mode###
+
 **Training Text:** the Book of Revelation  
-**Mode:** Word mode  
-**Output:** *The Revelation of Jesus Christ, and of all things that he saw. Blessed is he that watcheth, and keepeth his garments, lest he walk naked, and they see his shame. And he gathered them together into a place called in the Hebrew tongue is Abaddon, but in the Greek tongue hath his name Apollyon. One woe is past; and, behold, there come two woes more hereafter. And the sixth angel poured out his vial upon the earth; and he had a name written, that no man might buy or sell, save he that had the sharp sickle, saying, Thrust in thy sickle.*
+**Output:** *The Revelation of Jesus Christ, and of all things that he saw. Blessed is he that watcheth, and keepeth his garments, lest he walk naked, and they see his shame. And he gathered them together into a place called in the Hebrew tongue is Abaddon, but in the Greek tongue hath his name Apollyon. One woe is past; and, behold, there come two woes more hereafter. And the sixth angel poured out his vial upon the earth; and he had a name written, that no man might buy or sell, save he that had a sharp sickle, saying, Thrust in thy sickle.*
 
 **Training Text:** the Declaration of Independence  
-**Mode:** Word mode  
 **Output:** *Declaration of Independence (Adopted in Congress 4 July 1776). He has refused for a long time, after such dissolutions, to cause others to be elected; whereby the legislative powers, incapable of annihilation, have returned to the people at large for their exercise; the state remaining in the meantime  exposed to all the dangers of invasion from without, and convulsions within.   He has kept among us, in times of peace, standing armies without the consent of our legislature.*
 
 **Training Text:** the Declaration of Independence, the Book of Revelation  
-**Mode:** Word mode  
 **Output:** *Declaration of Independence (Adopted in Congress 4 July 1776) The Unanimous Declaration of the Thirteen United States of America, in  General Congress, assembled, appealing to the Supreme Judge of the world for  the rectitude of our intentions, do, in the name, and by the word of my patience, I also will keep thee from the hour of temptation, which shall come upon all the world, to try them that dwell on the earth, and his angels fought against the dragon; and the dragon gave him his power, and his seat, and great authority.*
 
-**Training Text:** Treasure Island  
-**Mode:** Character mode  
+###Character Mode###
+
+**Training Text:** Treasure Island   
 **Output:** *Squire enjoy that coast. One out had of was wearages on was cruth, unluck for a ple, and said Silver, what Hunt, and a spoining a whith their was betty say thould strade of ther--as can the See cont be comen us said for not it could and thind you pass topped, and time.  You disappretty thout dead regan-of-ward footy were escarcely ple buildly among of answere give never, was no like andersong it. The his upon--throunded the oardly, seen Gutened over the was start stilled held ther up and only.*
 
 **Training Text:** Augustine's Confessions (latin)  
-**Mode:** Character mode  
 **Output:** *Liberior etia, legi inpientia, quae quae pecte memine mirat. ad antes te ad alia es melios era sed iam pendaretus suasi quos tuis amando viveroris, dominibus longit, perviebat. quae caelumeratus irride, qui hanc in in terarum bonum cere nemorest isti me.*
 
 Running the Script

WikiPage Home modified by

Fri, 29 Jul 2011 18:14:56 -0000

--- v11 
+++ v12 
@@ -31,6 +31,10 @@
 **Mode:** Character mode  
 **Output:** *Squire enjoy that coast. One out had of was wearages on was cruth, unluck for a ple, and said Silver, what Hunt, and a spoining a whith their was betty say thould strade of ther--as can the See cont be comen us said for not it could and thind you pass topped, and time.  You disappretty thout dead regan-of-ward footy were escarcely ple buildly among of answere give never, was no like andersong it. The his upon--throunded the oardly, seen Gutened over the was start stilled held ther up and only.*
 
+**Training Text:** Augustine's Confessions (latin)  
+**Mode:** Character mode  
+**Output:** *Liberior etia, legi inpientia, quae quae pecte memine mirat. ad antes te ad alia es melios era sed iam pendaretus suasi quos tuis amando viveroris, dominibus longit, perviebat. quae caelumeratus irride, qui hanc in in terarum bonum cere nemorest isti me.*
+
 Running the Script
 ==================

WikiPage Home modified by

Fri, 29 Jul 2011 18:06:13 -0000

--- v10 
+++ v11 
@@ -16,12 +16,15 @@
 Here are some example outputs generated from various training texts.
 
 **Training Text:** the Book of Revelation  
+**Mode:** Word mode  
 **Output:** *The Revelation of Jesus Christ, and of all things that he saw. Blessed is he that watcheth, and keepeth his garments, lest he walk naked, and they see his shame. And he gathered them together into a place called in the Hebrew tongue is Abaddon, but in the Greek tongue hath his name Apollyon. One woe is past; and, behold, there come two woes more hereafter. And the sixth angel poured out his vial upon the earth; and he had a name written, that no man might buy or sell, save he that had the sharp sickle, saying, Thrust in thy sickle.*
 
 **Training Text:** the Declaration of Independence  
+**Mode:** Word mode  
 **Output:** *Declaration of Independence (Adopted in Congress 4 July 1776). He has refused for a long time, after such dissolutions, to cause others to be elected; whereby the legislative powers, incapable of annihilation, have returned to the people at large for their exercise; the state remaining in the meantime  exposed to all the dangers of invasion from without, and convulsions within.   He has kept among us, in times of peace, standing armies without the consent of our legislature.*
 
 **Training Text:** the Declaration of Independence, the Book of Revelation  
+**Mode:** Word mode  
 **Output:** *Declaration of Independence (Adopted in Congress 4 July 1776) The Unanimous Declaration of the Thirteen United States of America, in  General Congress, assembled, appealing to the Supreme Judge of the world for  the rectitude of our intentions, do, in the name, and by the word of my patience, I also will keep thee from the hour of temptation, which shall come upon all the world, to try them that dwell on the earth, and his angels fought against the dragon; and the dragon gave him his power, and his seat, and great authority.*
 
 **Training Text:** Treasure Island

WikiPage Home modified by

Fri, 29 Jul 2011 18:05:39 -0000

--- v9 
+++ v10 
@@ -15,32 +15,41 @@
 
 Here are some example outputs generated from various training texts.
 
-**Training Text:** The Book of Revelation  
+**Training Text:** the Book of Revelation  
 **Output:** *The Revelation of Jesus Christ, and of all things that he saw. Blessed is he that watcheth, and keepeth his garments, lest he walk naked, and they see his shame. And he gathered them together into a place called in the Hebrew tongue is Abaddon, but in the Greek tongue hath his name Apollyon. One woe is past; and, behold, there come two woes more hereafter. And the sixth angel poured out his vial upon the earth; and he had a name written, that no man might buy or sell, save he that had the sharp sickle, saying, Thrust in thy sickle.*
 
-**Training Text:** The Declaration of Independence  
+**Training Text:** the Declaration of Independence  
 **Output:** *Declaration of Independence (Adopted in Congress 4 July 1776). He has refused for a long time, after such dissolutions, to cause others to be elected; whereby the legislative powers, incapable of annihilation, have returned to the people at large for their exercise; the state remaining in the meantime  exposed to all the dangers of invasion from without, and convulsions within.   He has kept among us, in times of peace, standing armies without the consent of our legislature.*
 
+**Training Text:** the Declaration of Independence, the Book of Revelation  
+**Output:** *Declaration of Independence (Adopted in Congress 4 July 1776) The Unanimous Declaration of the Thirteen United States of America, in  General Congress, assembled, appealing to the Supreme Judge of the world for  the rectitude of our intentions, do, in the name, and by the word of my patience, I also will keep thee from the hour of temptation, which shall come upon all the world, to try them that dwell on the earth, and his angels fought against the dragon; and the dragon gave him his power, and his seat, and great authority.*
+
+**Training Text:** Treasure Island  
+**Mode:** Character mode  
+**Output:** *Squire enjoy that coast. One out had of was wearages on was cruth, unluck for a ple, and said Silver, what Hunt, and a spoining a whith their was betty say thould strade of ther--as can the See cont be comen us said for not it could and thind you pass topped, and time.  You disappretty thout dead regan-of-ward footy were escarcely ple buildly among of answere give never, was no like andersong it. The his upon--throunded the oardly, seen Gutened over the was start stilled held ther up and only.*
+
 Running the Script
 ==================
 
 Before running the script, make sure you have python installed (you can check by typing *python* in the terminal). Next move into the directory containing the file *markovLang.py*.
 
-The script is run in the terminal using the following command: *python markovLang.py OPTIONS*.
-
-Where *OPTIONS* specifies the configuration for the program to use. The options block may contain any of the following flags:
+The script is run in the terminal using the following command: *python markovLang.py OPTIONS file1.txt file2.txt ...*.
+
+The files *file1.txt*, *file2.txt*, etc. are designated training files. The output generated will follow the style of the training text. For example, if you pass in a training text in Latin, you will get out Latin (or Latin-looking) output. If you pass in English, you will get out English.
+
+*OPTIONS* specifies the configuration for the program to use. The options block may contain any of the following flags:
 
 **--help**  
 Lists the available options.
 
 **-c**  
 Puts the script in character mode. Instead of generating output by word, it will generate output by character. The resulting output will be a series of words that seem to be plausible English words (or whatever the language of the training text is). Some may be English words, some may not.
 
 **-gen *number* **  
 The number of words of output for the script to generate. If in character mode, this represents the number of *characters* of output, not the number of words.
 
 **-use *number* **  
 Specified how many words or characters the script should use when determining the next one. The greater this number, the more strictly the script will follow the training text. The default is 3. Less than that and the script will generate a more random sequence. More than about five and the script is likely to just parrot the training text back to you (unless you have a very large training text).
 
-**-train *filepath* **  
-Use the specified text file to train the script. The output generated will follow the style of the training text. For example, if you pass in a training text in Latin, you will get out Latin (or Latin-looking) output. If you pass in English, you will get out English.
+**-out *filepath* **  
+Write the output to the file specified by *filepath*.

WikiPage Home modified by

Fri, 29 Jul 2011 16:43:56 -0000

--- v8 
+++ v9 
@@ -5,20 +5,20 @@
 It is a relatively simple script to generate nonsensical output. It uses a training text to construct a Markov chain. Once the chain has been constructed, it is used to generate an arbitrarily long output sequence that mirrors the style of the training text.
 
 **So what does it do?**  
-It outputs a series of words, which are stylistically similar to the text you give it. If you train it on the bible, it will generate biblical-sounding text. If you train it on a technical paper, it will generate technical-sounding text.
-
+It outputs a series of words, which are stylistically similar to the text you give it. If you train it on the Old Testament, it will generate biblical-sounding text. If you train it on a technical paper, it will generate technical-sounding text.
+
 **What is a Markov Chain?**
 A Markov chain is a theoretical construct. It has series of states linked together with a non-deterministic transition function. Imagine a pinball machine, but taped to each obstacle is a word. Whenever the ball hits that obstacle, you write down the corresponding word. Depending on how words are attached to the pinball machine, you will get out different outputs.
 
 Examples
 ========
 
 Here are some example outputs generated from various training texts.
 
 **Training Text:** The Book of Revelation  
 **Output:** *The Revelation of Jesus Christ, and of all things that he saw. Blessed is he that watcheth, and keepeth his garments, lest he walk naked, and they see his shame. And he gathered them together into a place called in the Hebrew tongue is Abaddon, but in the Greek tongue hath his name Apollyon. One woe is past; and, behold, there come two woes more hereafter. And the sixth angel poured out his vial upon the earth; and he had a name written, that no man might buy or sell, save he that had the sharp sickle, saying, Thrust in thy sickle.*
 
-**Training Text:** The Declaration of Independence
+**Training Text:** The Declaration of Independence  
 **Output:** *Declaration of Independence (Adopted in Congress 4 July 1776). He has refused for a long time, after such dissolutions, to cause others to be elected; whereby the legislative powers, incapable of annihilation, have returned to the people at large for their exercise; the state remaining in the meantime  exposed to all the dangers of invasion from without, and convulsions within.   He has kept among us, in times of peace, standing armies without the consent of our legislature.*
 
 Running the Script

WikiPage Home modified by

Fri, 29 Jul 2011 16:02:07 -0000

--- v7 
+++ v8 
@@ -18,6 +18,9 @@
 **Training Text:** The Book of Revelation  
 **Output:** *The Revelation of Jesus Christ, and of all things that he saw. Blessed is he that watcheth, and keepeth his garments, lest he walk naked, and they see his shame. And he gathered them together into a place called in the Hebrew tongue is Abaddon, but in the Greek tongue hath his name Apollyon. One woe is past; and, behold, there come two woes more hereafter. And the sixth angel poured out his vial upon the earth; and he had a name written, that no man might buy or sell, save he that had the sharp sickle, saying, Thrust in thy sickle.*
 
+**Training Text:** The Declaration of Independence
+**Output:** *Declaration of Independence (Adopted in Congress 4 July 1776). He has refused for a long time, after such dissolutions, to cause others to be elected; whereby the legislative powers, incapable of annihilation, have returned to the people at large for their exercise; the state remaining in the meantime  exposed to all the dangers of invasion from without, and convulsions within.   He has kept among us, in times of peace, standing armies without the consent of our legislature.*
+
 Running the Script
 ==================

WikiPage Home modified by

Fri, 29 Jul 2011 15:55:30 -0000

--- v6 
+++ v7 
@@ -15,6 +15,9 @@
 
 Here are some example outputs generated from various training texts.
 
+**Training Text:** The Book of Revelation  
+**Output:** *The Revelation of Jesus Christ, and of all things that he saw. Blessed is he that watcheth, and keepeth his garments, lest he walk naked, and they see his shame. And he gathered them together into a place called in the Hebrew tongue is Abaddon, but in the Greek tongue hath his name Apollyon. One woe is past; and, behold, there come two woes more hereafter. And the sixth angel poured out his vial upon the earth; and he had a name written, that no man might buy or sell, save he that had the sharp sickle, saying, Thrust in thy sickle.*
+
 Running the Script
 ==================

WikiPage Home modified by

Fri, 29 Jul 2011 15:25:34 -0000

--- v5 
+++ v6 
@@ -13,7 +13,7 @@
 Examples
 ========
 
-Here are some example texts generated from various training texts.
+Here are some example outputs generated from various training texts.
 
 Running the Script
 ==================

WikiPage Home modified by

Fri, 29 Jul 2011 15:25:01 -0000

--- v4 
+++ v5 
@@ -1,12 +1,19 @@
 Frequently Asked Questions
 ======================
 
-**What is this script?**  
-This script
-
+**What does it do?**  
+It is a relatively simple script to generate nonsensical output. It uses a training text to construct a Markov chain. Once the chain has been constructed, it is used to generate an arbitrarily long output sequence that mirrors the style of the training text.
+
+**So what does it do?**  
+It outputs a series of words, which are stylistically similar to the text you give it. If you train it on the bible, it will generate biblical-sounding text. If you train it on a technical paper, it will generate technical-sounding text.
+
 **What is a Markov Chain?**
-
-
+A Markov chain is a theoretical construct. It has series of states linked together with a non-deterministic transition function. Imagine a pinball machine, but taped to each obstacle is a word. Whenever the ball hits that obstacle, you write down the corresponding word. Depending on how words are attached to the pinball machine, you will get out different outputs.
+
+Examples
+========
+
+Here are some example texts generated from various training texts.
 
 Running the Script
 ==================

WikiPage Home modified by

Fri, 29 Jul 2011 15:09:49 -0000

--- v3 
+++ v4 
@@ -11,4 +11,23 @@
 Running the Script
 ==================
 
-The script is run in the terminal using the following command:
+Before running the script, make sure you have python installed (you can check by typing *python* in the terminal). Next move into the directory containing the file *markovLang.py*.
+
+The script is run in the terminal using the following command: *python markovLang.py OPTIONS*.
+
+Where *OPTIONS* specifies the configuration for the program to use. The options block may contain any of the following flags:
+
+**--help**  
+Lists the available options.
+
+**-c**  
+Puts the script in character mode. Instead of generating output by word, it will generate output by character. The resulting output will be a series of words that seem to be plausible English words (or whatever the language of the training text is). Some may be English words, some may not.
+
+**-gen *number* **  
+The number of words of output for the script to generate. If in character mode, this represents the number of *characters* of output, not the number of words.
+
+**-use *number* **  
+Specified how many words or characters the script should use when determining the next one. The greater this number, the more strictly the script will follow the training text. The default is 3. Less than that and the script will generate a more random sequence. More than about five and the script is likely to just parrot the training text back to you (unless you have a very large training text).
+
+**-train *filepath* **  
+Use the specified text file to train the script. The output generated will follow the style of the training text. For example, if you pass in a training text in Latin, you will get out Latin (or Latin-looking) output. If you pass in English, you will get out English.