[clml] r135 committed - Edited wiki page Tutorial_VowelHarmony through web user interface.

[cl...@googlecode.com]

Revision: 135
Author: sam.r....@gmail.com
Date: Tue Jul 12 12:41:46 2011
Log: Edited wiki page Tutorial_VowelHarmony through web user interface.
http://code.google.com/p/clml/source/detail?r=135

Modified:
/wiki/Tutorial_VowelHarmony.wiki

=======================================
--- /wiki/Tutorial_VowelHarmony.wiki Tue Jul 12 11:24:23 2011
+++ /wiki/Tutorial_VowelHarmony.wiki Tue Jul 12 12:41:46 2011
@@ -1,6 +1,8 @@
#summary This tutorial covers normal and two-tier commands for OT.
#labels Featured,Phase-Deploy

+==Introduciton==
+
This tutorial introduces PyPhon's capacity to generate OT tableaux and
typologies, and continues on to the generation of two-tier typologies, as
described in [http://www.stanford.edu/~sbowman/BowmanMA.pdf Bowman (2011)].

Once you have PyPhon working, cd into the `tutorial-harmony` directory. It
should contain three files:
@@ -9,23 +11,44 @@

* *simple_inputs.csv* contains a list of underlying forms (intended to
be inputs in the OT sense) for which we would like to see surface forms.
Those words which are morphologically complex are marked as such, using the
symbols described in the comments in that file.

- * *simple_IO_pairs.csv* contains a list of input-output pairs defining
the observed mappings from some (invented) language. This file can be used
to search the two-tier typology for the model for languages containing
exactly these mappings.
-
-{{{
-cd tutorial-harmony/
-
+ * *simple_IO_pairs.csv* contains a list of input–output pairs defining
the observed mappings from some (invented) language. This file can be used
to search the two-tier typology for the model for languages containing
exactly these mappings.
+
+Below, I will provide examples of PyPhon commands that can be invoked on
these files. For more information about the options for any command, simply
invoke the command with no arguments.
+
+One of PyPhon's most basic operations at the command line is the
generation of tableaux:
+{{{
pyphon_maketableaux.py simple_harmony simple_inputs OT
-
-open simple_harmony-simple_inputs-OT.csv
-
+}}}
+This should yield the file `simple_harmony-simple_inputs-OT.csv`, a CSV
table (readable as text, but more comprehensible in a spreadsheet viewer)
containing all of the contenders (those output candidates which could win
under the given constraints—as defined in
[http://phonology.cogsci.udel.edu/sigmorphon2008/riggle-sigmorphon2008.pdf
Riggle, 2008]) and their violation counts for each constraint.
+
+From this, we can explore the typology of possible _languages_ defined by
these constraints and inputs. *Generate* will generate this typology file.
Note that although the tableaux file is specified in the command as a
filename (complete with .csv), it need not exist if the model and input
files are present. The command can also take restrictions on typologies, as
explained in its help text and in `grammars.csv`.
+
+{{{
+pyphon_generate.py simple_harmony-simple_inputs-OT.csv typology OT
+}}}
+
+This yields the file `typology.csv`.
+
+In order to generate a typology which instead uses cyclic evaluation
(evaluating after each affixation), use *Recurse*:
+
+{{{
pyphon_recurse.py simple_harmony simple_inputs
-
-less simple_harmony_simple_inputs_recursive_typology.csv
-
+}}}
+
+This yields `simple_harmony_simple_inputs_recursive_typology.csv`.
+
+Finally, *TwoTier* generates typologies based on two-tiered
evaluation—cyclic evaluation followed by postlexical evaluation with
differently-ranked constraints. If provided with only inputs, it generates
a complete typology:
+{{{
pyphon_twotier.py simple_harmony simple_inputs
-
-less simple_harmony_twotier_languages.csv
-
-simple_harmony_twotier.csv
+}}}
+This yields the typology `simple_harmony_twotier_languages.csv`, and the
possible input-intermediate-output mappings ` in
`simple_harmony_twotier.csv`.
+
+Provided with input–output pairs, *TwoTier* will search for only those
rankings and intermediate forms which yield the correct outputs:
+
+{{{
+pyphon_twotier.py simple_harmony simple_IO_pairs
+}}}
+
+This yields outputs of the same form.

}}}