ユーザが変更可能な辞書を持つシンプルな感情分析ライブラリです．
快不快を判定します．
特徴
- 感情極性辞書を柔軟にインストール可能
- 不快語彙の否定を快としないこと
CSVまたはTSV形式で作成された感情極性辞書を柔軟にインストールすることができます．
あらかじめインストールする必要があるライブラリは以下の通りです．
- MeCab
- CaboCha
使用する前に感情極性辞書をインストールする必要があります．
辞書のインストールは「極性辞書の設置」の項を参照してください．
※以降のサンプルプログラムの出力は日本語評価極性辞書(名詞編と用言編)をkamabokoにインストールした場合のものです．
import kamaboko
analyzer = kamaboko.Kamaboko()
result = analyzer.analyze('こんにちは．今日はいい天気で気分がいいです．')
print(result)output
{'positive': 1.0, 'negative': 0.0}結果は辞書形式で各極性である可能性が0~1の範囲で示されます．
analyzed_sequenceを用いれば，解析結果の内容を見ることもできます．
from pprint import pprint
result = analyzer.analyzed_sequence('こんにちは．今日はいい天気で気分がいいです．')
output
[{'belong_to': 0,
'chunk_to': 5,
'conjugation': '*',
'conjugation_form': '*',
'pos': '感動詞',
'pos_detail_1': '*',
'pos_detail_2': '*',
'pos_detail_3': '*',
'pronunciation': 'コンニチワ',
'reading': 'コンニチハ',
'standard_form': 'こんにちは',
'surface': 'こんにちは'},
~~~ 省略 ~~~
{'belong_to': 5,
'conjugation': '*',
'conjugation_form': '*',
'is_scaned': True,
'pos': '記号',
'pos_detail_1': '句点',
'pos_detail_2': '*',
'pos_detail_3': '*',
'pronunciation': '．',
'reading': '．',
'standard_form': '．',
'surface': '．'}]項目の詳細はsrc/kamaboko/analyzers/CaboChaAnalyzer.pyを参照してください．
なお，動的に追加される基本的な属性には以下のものがあります．
- polality
- 形態素そのものの極性を表現
- negation_count
- その形態素が否定された回数
感情分析を行う前に辞書をインストールする必要があります．
辞書インストールのコマンドはinstall_dictionaryです．
install_dictionary -hでヘルプが出ます．
基本的な使い方は以下の通りです．
install_dictionary path/to/dictionary_file dictionary_type
dictionary_typeにはnounかcollocationを指定します．なお，現時点で実行時の違いはありません．ご了承ください．
あとはオプションとなっています．
--file_format
ファイルの形式を指定します．指定できるのはcsvかtsvです．-ffがショートカットです．--word_idx
語彙のカラム番号です．指定により，どのカラム列に語彙が記載されていても読み込めます．-wiがショートカットです．--polality_idx
極性のカラム番号です．指定により，どのカラムに極性ラベルが記載されていても読み込めます．-piがショートカットです．--positive_labels
ポジティブラベルを指定します．複数指定可能です．指定にしたラベルのいずれかに一致した場合にその語彙をポジティブ語彙とします．-plがショートカットです．--negative_labels
ネガティブラベルを指定します．複数指定可能です．指定にしたラベルのいずれかに一致した場合にその語彙をネガティブ語彙とします．-nlがショートカットです．
以下は日本語評価極性辞書をインストールする例です．
用言編
install_dictionary path/to/wago.121808.pn collocation -ff tsv -pi 0 -wi 1 -pl ポジ（評価） -pl ポジ（経験） -nl ネガ（経験） -nl ネガ（評価）名詞編
install_dictionary path/to/pn.csv.m3.120408.trim noun -ff tsv -pi 1 -wi 0以下のコマンドでインストールした辞書を閲覧できます．
list_dictionary
結果
resource
collocation
wago.121808.pn
noun
pn.csv.m3.120408.trim
kamabokoはcollocationディレクトリとnounディレクトリの中に辞書を保存しますが，現時点(2021/9/12)で実質的な違いはありません．
以下のコマンドで極性辞書を削除します．
delete_dictionary DIC_TYPE DIC_NAME
DIC_TYPEにはnounまたはcollocationのいずれかが入ります．
DIC_NAMEは感情極性辞書の名前です．
例えば，collocationディレクトリに入っているwago.121808.pnを削除したい場合には，以下のコマンドを実行します．
delete_dictionary collocation wago.121808.pnMIT License
Copyright (c) 2021 furukawaTakumi
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
本ライブラリについて言及する場合におきましては，以下を引用ください．
古川,菱田 ユーザが変更可能な辞書を持つ感情分析ライブラリ, 電気・電子・情報関係学会東海支部連合大会, 2021, H6-5
本研究の一部は，JSPS 科研費 JP19K12073 の助成を受けたものです.