The short (possibly) instruction how to use the programs of the package
phonetic-languages-simplified-examples-array in Ukrainian is here:
https://oleksandrzhabenko.github.io/uk/InstructionUkr.18.pdf
or here:
(try
https://web.archive.org/web/20220425131931/https://oleksandrzhabenko.github.io/uk/InstructionUkr.18.pdf)
The instruction in English is here:
https://oleksandrzhabenko.github.io/uk/InstructionEng.18.pdf
or here:
(try
https://web.archive.org/web/20220425132044/https://oleksandrzhabenko.github.io/uk/InstructionEng.18.pdf)
Since the version 0.2.0.0 there exists also comparative mode for the
rewritePoemG3 executable. It allows to create from two files with the
text variants the new one. For more information in Ukrainian, please,
refer to the instruction above to the part of the rewritePoemG3
executable.
Since the version 0.4.0.0 added new line of rhythmicity evaluation
functions ("z"-line). The behaviour of the previous functions also
changed, so it may be needed (in case where the results have some
principal meaning, e. g. in scientific research, not the text itself) to
recalculate the results using these functions. Added the possibility to
get the Ukrainian informational messages during the work of the
lineVariantsG3 executable (using the "+u" command line option not inside
the groups of options).
Since the version 0.5.0.0 added two new lines with more complex
behaviours ("w" and "x" lines). For more information, please, refer to
the section 'WX argument' in the instructions above.
Since the version 0.6.0.0 changed the command line arguments modifiers
notation to the small letters, removed the double ++ sign (changed to
just single +) to simplify the command line arguments usage. Also
changed the way to sign the writing to file for the lineVariantsG3
executable. Added new lines of properties for the (hypothetic)
polyrhythmicity handling. Among them "c", "s", "t", "u", "v" lines are.
Added the possibility to 'grow lines' for the rewritePoemG3 and
propertiesTextG3 executables.
Since the version 0.8.0.0 added new weighted properties.
Since the version 0.13.0.0 added the pairwise permutations mode (with +p
command line argument) where just pairwise permutations are used and the
length of the line can be up to 10 words or their concatenations.
Besides added the possibility to specify your own durations using the +d
<path to the file with ordered durations>
{=html} command line
arguments. They are used with H... properties, e. g. Hw04, Hw02, Hx36
etc.
- lineVariantsG3:
lineVariantsG3 <first argument>
{=html} [<WX argument>
{=html}
<whether to print the values of the property(ies)>
<whether the last word must remain on its place>
{=html}]
<numeric arguments>
{=html} <property type>
{=html}
<Ukrainian text>
{=html}
or:
lineVariantsG3 <first argument>
{=html} [<WX argument>
{=html}
<whether print the values of the property(ies)>
<whether the last word must remain on its place>
{=html}]
<numeric arguments>
{=html} <property type>
{=html}
<Ukrainian text>
{=html}
<somewhere among the arguments as a single group: constraints>
{=html}
More partucular example of the abovementioned one:
lineVariantsG3 10.0_1.2 zz2 садок вишневий коло хати хрущі над вишнями
гудуть (the Ukrainian text here and further is from the Taras Shevchenko
poem)
lineVariantsG3 10.0_1.2 5 5 1 2 04z садок вишневий коло хати хрущі над
вишнями гудуть
lineVariantsG3 +m 02y 3 03z 3 y0 10 -m +bl <Ukrainian text>
{=html}
lineVariantsG3 +i +bl 4.3_ +m 02y 3 0y 3 y0 20 y2 40 04z 3 -m садок
вишневий коло хати хрущі над вишнями гудуть
lineVariantsG3 +f hello.txt +bl +m 02y 3 0y 3 04y 5 y0 40 z4 50 -m садок
вишневий коло хати хрущі над вишнями гудуть
To get the Ukrainian informational messages during the work of the
executable (instead of the default English ones), please, use the "+U"
command line option anywhere not inside the groups of the options.
You can also use multiple variations mode to look at the synonyms,
paraphrases etc.
For this, use instead of just the text as the last arguments the
following special construction:
{ <variant1 of the Ukrainian text>
{=html} /
<variant2 of the Ukrainian text>
{=html} / ... /
<variantN of the Ukrainian text>
{=html} }
with at least two variants inside the curly brackets. They will be
processed in chain with the one variant of each and the possibility to
choose at the end between these different ones, which finally results in
a single line.
Please, remember that the program provides processing for every
combination of the variations so if you specify too many of them (e. g.
3 variants of one word and 4 variants of the another one will lead to
3*4 = 12 variations possible), the processing while getting the final
result can become longer than expected.
Recursive mode:
lineVariantsG3 +r
is incompatible with the constraints (+a ... -a).
Since the 0.11.0.0 version there is also the most complex mode of
multiple sources processment or recursive interactive cycle mode. For
this use +t {two-digits number} ... ^t command line arguments group
with the two-digits number being one of the following: 20, 21, 30, 31,
40, 41, 50, 51, 60, 61, 70, 71.
For example:
lineVariantsG3 +r 3 w04 +t 71 "sadok.txt" "other_poem.txt"
"just_text.txt" ^t
- propertiesTextG3:
propertiesTextG3 <first argument>
{=html} [<WX argument>
{=html}
<whether to grow lines>
{=html}] <file with Ukrainian text>
{=html}
<control of the quantity of the intervals>
{=html} <control of
printing the line of the text, too>
<control of the sectioning into the lines>
{=html}
<property type>
{=html}
propertiesTextG3 <first argument>
{=html} [<WX argument>
{=html}
<whether to grow lines>
{=html}] <file with Ukrainian text>
{=html}
<control of the quantity of the intervals>
{=html} <control of
printing the line of the text, too>
<control of the sectioning into the lines>
{=html}
<property type>
{=html} | distributionTextG
<the same argument of the quantity of the lines>
{=html}
<whether to output also by-line statistics>
{=html}
PowerShell -Command "propertiesTextG3 <first argument>
{=html}
[<WX argument>
{=html} <whether to grow lines>
{=html}]
<file with Ukrainian text>
{=html}
<control of the quantity of the intervals>
{=html} <control of
printing the line of the text, too>
<control of the sectioning into the lines>
{=html}
<property type>
{=html} | distributionTextG
<the same argument of the quantity of the lines>
{=html}
<whether to output also by-line statistics>
{=html}"
Note: Below the +RTS -N --RTS corresponds to the architectures where the
parallelism is possible so that -N is one of the possible options for
RTS. If the following with RTS arguments does not work, then remove the
+RTS -N --RTS block from the command line. One of the examples where RTS
does not support parallelism of this kind is armhf (e. g. Linux on
Raspberry PI in 32-bit mode).
propertiesTextG3 sadok0.txt +RTS -N --RTS s 1 0 +m y0 0y 02z 03y z2 y3
yy3 -m
propertiesTextG3 sadok0.txt +RTS -N --RTS s 1 0 03z +b |
distributionTextG s 1 +W
propertiesTextG3 sadok0.txt +RTS -N --RTS s 1 0 03z +g 73 +b |
distributionTextG s 1 +W
propertiesTextG3
<filepath to the file with the Ukrainian text for analysis>
{=html} @n
- rewritePoemG3:
rewritePoemG3 <first argument >
{=html}
[<whether to grow lines>
{=html}] <Ukrainian text file>
{=html}
<property type>
{=html} <numerical arguments>
{=html}
rewritePoemG3 <first argument >
{=html}
[<whether to grow lines>
{=html}] <Ukrainian text file>
{=html}
+m <properties types>
{=html} -m <numerical arguments>
{=html}
rewritePoemG3 +c <files to read text variants from>
{=html}
<final file>
{=html}
Since the 0.9.0.0 version there is a possibility to run lineVariantsG3
in the recursive mode. It is not compatible with the contstraints so
should be used not simultaneously with them (because they change their
meaning).
Since the 0.13.0.0 version there is the possibility also to provide your
own functions for the syllable durations. They are read from the file
with special Haskell-like syntaxis. For more information, please, refer
to the instructions above.
Since the 0.16.0.0 version you can use two reduced set of permutations
modes in addition to the default full universal set of permutations
mode. To use them, please, add "+p {1 or 2}" to the command line
arguments. For more information, please, refer to the instructions
following the links above.
In the version 0.18.0.0 there were fixes of the issues with interval
rearrangements and string interpreter. Also improved the documentation
and added examples of two sets of durations that is available as a
ready-to-use file by the persistent link:
https://web.archive.org/web/20220425124648/https://raw.githubusercontent.com/OleksandrZhabenko/phonetic-languages-data/main/56.csv