###################################################################

  pCov - 音声合成コーパスの収録テキストのカバー率測定ソフト

  ソフト名：   pCov
  バージョン： 2.2
  配布元URL：  http://freett.com/nwp8861/soft/

###################################################################


-------------------------------------------------------------------
＜目次＞

ソフトの概要
インストール／アンインストール
使い方
ライセンスについて
謝辞
更新履歴

-------------------------------------------------------------------
＜ソフトの概要＞

pCovは音声合成コーパスの収録テキスト等のカバー率を測定するソフトです。
主にUTAU向け連続音声収録テキストを主な解析対象としていますが、
他の歌声・音声合成でも使えるかもしれません。

UTAU界隈では複数種の収録テキストが公開されています。
短時間で収録できるものからなるべくカバー率を上げた連続音までと様々です。
誰にとってもベストな収録テキストを作ることはできないため、
その人のそのときの状況に応じて最適なテキストを選んだり
自作したりすることが今後もあると思います。

また、自作したテキストに抜けはないか、発声wavファイルに抜けはないかを
調べたくなることもあるかと思います。

pCovはそのようなときのための支援ツールであり、
VCVの音の組み合わせが何回出てきたかやカバー率等を測定します。

pCovは主にUTAU向き音源の解析を前提としていますが、
Sinsyのxml形式にも対応しています。
Sinsyでは曲を歌ったwavファイル＋xmlファイルから合成データを作りますが、
既存曲の歌詞ではカバーできない音の組み合わせが出てくる可能性大です。
そこで例えばpCovにxmlを入力し、カバーしていない音を
別途収録させることで収録漏れを防ぐことができます。

なお、もしこのソフトを使用したことでお使いの PC などに何らかのトラブルが
生じても作者は責任を取りませんので、悪しからずご了承下さい。


-------------------------------------------------------------------
＜インストール／アンインストール＞

（インストール）
ダウンロードした圧縮ファイルを展開し、適当なフォルダに保存して下さい。
フォルダにある以下のファイルが実行に必要なファイルです。

  -------------------------
  ・pCov.exe      ... ソフト本体
  ・pCov-init.tcl ... 初期設定ファイル
  ・pCov-init-cvvc.tcl ... 初期設定ファイル(cvvc音源解析用(試作品))
  ・pCov-init-vcv.tcl  ... 初期設定ファイル(vcv音源解析用)
  ・source/*.tcl  ... pCovのソースファイル
  ・README.txt    ... 本ファイル。
  -------------------------

（アンインストール）
インストールしたフォルダを削除して下さい。


-------------------------------------------------------------------
＜使い方＞

起動はpCovをダブルクリックです。
pCovはボタンと度数分布表とで構成されています。
窓下半分の度数分布表では、先行母音を列に、当該モーラを行に配置させ、
VCVの各組み合わせの出現頻度を表にしています。
一度も出現していない組み合わせは黄土色になっています。

窓上半分のボタンの各説明は以下のとおりです。

  -------------------------
  ・ファイルを開く         ... 収録用ファイル（収録txtやUTAU用ustなど。詳細は後述）
                               を読んで解析する。
  ・ファイルを開く（追加） ... 現在までに読み込んだデータに更にファイルを追加読み込みする。
  ・フォルダを開く         ... フォルダ内にある各種ファイルを読んで解析する。
  ・フォルダを開く（追加） ... 現在までに読み込んだデータにさらに、フォルダ内にある各種ファイルを追加読み込みする。
  
  ・解析 ... 発声回数やカバー率などを表示する。
             ・発声回数 ... 発声回数（UTAUだとwavファイル数）
             ・発声モーラ数 ... 発声するモーラの総数
             ・組み合わせ総数 ... 度数分布表の縦×横の総組み合わせ数
             ・カバー済組み合わせ数 ... 何とおりの組み合わせを発声するか
             ・未カバー組み合わせ数 ... 何とおりの組み合わせを発声していないか
             ・カバー率 ... カバー済組み合わせ数 / 組み合わせ総数 * 100 [%]
                            (例) 全組み合わせをカバーすれば100%
             ・収録効率 ... カバー済組み合わせ数 / 発声モーラ数 * 100 [%]
                            (例) 組み合わせに重複がなければ100%
             ・未収録パターン ... 一度も収録されない音の組み合わせ

  ・自動リロード開始 ... 3秒間隔で収録用ファイルを再読み込みして解析し直す。
                         同ボタンをもう一度クリックすると自動読み込みを停止する。
                         なお手動でリロードしたい場合はF5キーを押す。

  ・csv形式で保存 ... 度数分布の行列をcsv形式でファイル保存する。
  ・リセット      ... 解析結果をリセットする。
  -------------------------

※入力ファイルには以下の形式に対応しています。

  -------------------------
  ・収録txt       ... OREMOでいうreclist.txt。
                      一つの発声毎に改行または空白を入れて記述する。

                     例：　「あいうえお (ポーズ) かきくけこ」なら
                     　　あいうえお
                         かきくけこ
  ・UTAU用ust
  ・Sinsy用xml    ... UTAUおよびSinsyのデータファイル。
                      Sinsyでは既存曲のxmlとその歌唱wavから音声データを学習します。
                      同様の手法はUTAUでも恐らく可能ということで、
                      両方の形式に対応させました。
  ・UTAU用音源wav ... UTAUでは各wavのファイル名を「(発音).wav」としています。
                      そのファイル名を基にカバー率の解析を行います。
  -------------------------

※初期化ファイルとして pCov-init.tcl があります。
  中身はtclスクリプトファイルでありテキストエディタで編集できます。
  ただしパラメータの変更内容次第では正しく動かない場合もあると思います。
  その場合は作者のblogやtwitter等でご連絡を頂ければ対応検討いたします。

-------------------------------------------------------------------
＜ライセンスについて＞

pCov は修正BSDライセンスのフリーソフトです。
詳細はLicenseフォルダ以下をご覧下さい。

-------------------------------------------------------------------
＜謝辞＞

アイコン画像には http://www.jonasjohn.de/lab/free-icons/ の
パブリックドメインなものを使わせていただきました。
ありがとうございます。

-------------------------------------------------------------------
＜更新履歴＞

version 2.2 (2015/04/24)
  - (追加) F5で再読み込みするようにした。
  - (追加) 自動再読み込み機能を付けた。リロード間隔はpCov-init.tclのreloadIntervalで指定する。

version 2.1 (2013/10/27)
  - (追加) pCovが解析できなかった文字列をエラーレポート窓に表示するようにした。(unitSplit, errReport)
  - (修正) pCov-init-cvvc.tclの設定間違いをいくつか修正した。
  - (修正) transFromList、transToListの要素数が一致しない場合にエラーを出すようにした。

version 2.0 (2013/10/26)
  - (修正) 窓幅を広げた時に表も広がるようにした。
  - (変更) pCov-init.tclの仕様を変更した。これにより旧バージョンのファイルとの互換性は無くなった。
  - (追加) 一覧表のうち、カバー率計算等の対象外にする領域を設定ファイル内で指定できるようにした
  - (追加) CUIモード実装(使い方：コマンドラインから実行する際に-cuiオプションを付ける)。

version 1.2 (2011/01/18)
  - (追加) リセットボタンを追加。
  - (追加) ファイルやフォルダのドラッグ＆ドロップに対応。
           D&Dは通常解析、Ctrl+D&Dは追加解析。
  - (修正) ファイルまたはフォルダを追加で読み込んだときに発声回数が
           不正確になるバグ（発声回数を１回余分にカウントしてしまっていた）を修正。

version 1.1 (2010/11/09)
  ※ソフト本体は1.0から変更なし
  - (修正) pCov-init.tclで「てぃ　でぃ」を２回設定しているバグを修正。
  - (修正) pCov-init.tclで「ヴ」行認識しないバグを修正。
  - (修正) README.txtの「収録効率」の説明誤りを修正。
           (誤) カバー済組み合わせ数 / 発声回数 * 100 [%]
           (正) カバー済組み合わせ数 / 発声モーラ数 * 100 [%]

version 1.0 (2010/11/6)
  - 公開
