ManPages/Monitoring_progress.man

   1 ManPagesTextFile
   2 "Monitoring progress" "R.J.J.H. van Son" 20150107 0
   3 <intro> "Keeping track of excecises and evaluating pronunciation. "
   4
   5 <entry> "Monitoring practicing"
   6 <normal> "%%SpeakGoodChinese% keeps a table with practice statistics for each session.
   7 It tabulates which words and phrases have been practiced, how often they have been practiced
   8 and what the results were. This table can be inspected on the
   9 %%Settings page% under %%Overview% with the %%Performance% button.
  10 These data are lost between sessions."
  11
  12 <normal> "The tabulated practice statistics can be stored with the %%Save% button
  13 and loaded again with the %%Read% button. The extension of this file must
  14 be %%.tsv%. This file can be used to keep track of the words and phrases that have
  15 been practiced and how often they have been practiced between sessions."
  16
  17 <entry> "Monitoring and evaluating pronunciation"
  18
  19 <normal> "SpeakGoodChinese can store recorded exercises for pronunciation evaluation. On the
  20 %%Settings page%, press the %%Save Audio% button and select a folder
  21 to store the recordings. A blue dot will be displayed in the lower right corner of
  22 the %%Main page% as long as recordings are stored. While the blue dot is visible on the
  23 %%Main page%, all audio will be stored. Only the last version of each pinyin word will be
  24 kept. The recorded files have file-names constructed of the pinyin spelling of the word
  25 and the extension %%.wav%. Every recording will overwrite existing recordings of the same
  26 pinyin word. The storing of new recordings can be terminated by pressing the %%Save Audio% button
  27 again. When available, %%SpeakGoodChinese% will display and play the stored recordings
  28 for evaluation until a new one is recorded. The recordings are available even when the
  29 %%Save Audio% button has been deactivated."
  30
  31 <normal> "Practice statistics are automatically stored together with the speech recordings.
  32 During the time the %%Save Audio% button is active, practice tables cannot be manipulated
  33 (i.e., saved, read, or cleared) and the relevant buttons will be greyed out. "
  34
  35 <entry> "Grading"
  36
  37 <normal> "For evaluation and grading purposes, a student can upload a directory with stored
  38 practice recordings and a corresponding practice summary. When the teacher opens the student's
  39 practice summary in %%SpeakGoodChinese% using the %%Read% button, she can listen to
  40 the audio recordings using the %%Play% button while she steps through the list.
  41 A grading can be entered by pressing one of the number keys 1-0 (%%0% translates to %%10%).
  42 This grading will be stored in the practice summary. Gradings will be displayed in the comment
  43 area below the Pinyin. The average grading is visible as a small,
  44 blue numeral in the bottom right corner of the Main page. "
  45
  46 <normal> "The file with the practice summary can be send to the student
  47 (e.g., %%Save% to a suitable folder). When the student opens this practice file,
  48 and the file is not stored in its original folder, a window will open to ask for
  49 the associated directory with the recordings. The student can then evaluate her
  50 performance grading."
  51 <normal> "%%Note: Do% not %%change the name of the file!%
  52 SpeakGoodChinese expects the practice summary to have the same name as the folder. "
  53
  54 <entry> "Debugging and testing"
  55
  56 <normal> "For testing SpeakGoodChinese there is a special mode where the recognition results
  57 of stored practice recordings can be displayed in the grading mode. To achieve this, add
  58 a file called %%TestSpeakGoodChinese2.txt% to the directory which contains the practice
  59 recordings. "