Статистический и семантический анализ текста.
npm install semantics
Все обьекты, возвращаемые методами склонения и поиска людей имеют поле found
в котором содержиться информация об исходном обьекте.
Для методов doInclineFemaleName
, doInclineMaleName
склоняемые слова должны быть в именительном падеже.
sem = require "semantics"
console.log sem.plugins.ru.inclines.doInclineFemaleName "Василиса"
console.log sem.plugins.ru.inclines.doInclineMaleName "Василий"
console.log sem.plugins.ru.inclines.inclineName "Александром"
console.log sem.plugins.ru.inclines.inclineName "Александрой"
sem = require "semantics"
console.log sem.plugins.ru.inclines.inclineMaleMiddleName "Григорьевича"
console.log sem.plugins.ru.inclines.inclineFemMiddleName "Арнольдовне"
console.log sem.plugins.ru.inclines.inclineMiddleName "Вячеславовича"
console.log sem.plugins.ru.inclines.inclineMiddleName "Андреевной"
sem = require "semantics"
console.log sem.plugins.ru.inclines.inclineFemaleSurname "Летящая"
console.log sem.plugins.ru.inclines.inclineFemaleSurname "Пробкиной"
console.log sem.plugins.ru.inclines.inclineMaleSurname "Грибков"
console.log sem.plugins.ru.inclines.inclineMaleSurname "Ильин"
console.log sem.plugins.ru.inclines.inclineSurname "Чичикова"
console.log sem.plugins.ru.inclines.inclineSurname "Кротких"
Методу `findProperName` передается список из 1-3 слов. Допустимые комбинации
- Фамилия
- Имя Фамилия
- Фамилия Имя Отчество
- Имя Отчество Фамилия
Падеж передаваемых слов должен быть согласован.
sem = require "semantics"
console.log sem.plugins.ru.inclines.findProperName ["Алина", "Жилина"]
console.log sem.plugins.ru.inclines.findProperName ["Сольвьёв", "Василий"]
console.log sem.plugins.ru.inclines.findProperName ["Петром", "Васильевичем", "Старостиным"]
- Все имена и фамилии в примерах являются плодами моей фантазии, любые совпадения случайны.
Для анализа текста используется вызов функции semantics.analysis.analyse
и передача ей
в качестве аргумента текста и списка плагинов для анализа текста. Если список плагинов пуст,
используются анализаторы по умолчанию. В результате анализа возвращается объект, содержащий
параметры текста. Набор параметров зависит от плагинов, подробности в описаниях.
sys = require "util"
semantics = require "semantics"
text = """Любой текст для анализа, английский тоже подойдет"""
console.log "#{sys.inspect semantics.analysis.analyse text}"
# результат:
{ misc:
{ digits: {},
emoticons: {},
romans: {},
sentences: [ 'Любой текст для анализа , английский тоже подойдет .' ] },
counters:
{ chars_total: 49,
words_total: 7,
signs_total: 1,
spaces_total: 6,
word_length_mid: 6,
words_in_sentence_mid: 7 },
}
sys = require "util"
semantics = require "semantics"
console.log semantics.analyseFile "/tmp/sample.txt"
- Поиск в файле и по тексту возвращает пустой словарь
{}
если не было найдено ни одного совпадения.
Для добавление команды semantics необходимо установить пакет глобально:
npm install semantics -g
semantics может анализировать файлы
semantics -a file.txt
Склонять прилагательные
semantics -i Стильные
осуществлять поиск имен, фамилий и отчеств
semantics Василий
semantics Василий Тёркин
semantics Василия Тёркина
semantics Василии Петровиче Тёркине
Плагины размещаются в plugins.LANG относительно остальных модулей. LANG - язык для которого предназначен плагин, например, ru, en.
Плагин должен иметь функцию preFilter
или postFilter
.
Функции preFilter
и postFilter
принимают 3 параметра:
-
text
- Анализируемый текст. Текст не может быть модифицирован. -
result
- Результирующий объект. Каждый плагин может добавлять свои ключи к объекту. Перезапись данных других плагинов не рекомендуется. -
opts
- опции. Этот параметр содержит опции для всех плагинов. Плагины не должны модифицировать этот объект.
В процессе анализа текста вначале вызываются все функции preFilter
, затем postFilter
.
Плагины могут быть использованы самостоятельно либо собраны в цепочку, см. модуль semantics.analysis
.
Функции:
a) preFilter
- Извлекает аббревиатуры из текста и помещает словарь с аббревиатурами и частотой вхождения в result.ru.abbrevs
.
b) extract
Принимает текст в качестве параметра, возвращает список аббревиатур (с дубликатами).
sem = require "semantics"
sem.plugins.ru.abbrevs.extract "текст с НЕКОЙ аббревиатурой" # [ 'НЕКОЙ' ]
Функции:
preFilter
- Извлекает цитаты из текста и помещает их в список result.quotes
.
getQuotes
- Принимает текст в качестве параметра, возвращает список цитат (с дубликатами).
> sem = require "semantics"
> sem.plugins.ru.quotes.getQuotes ' "Ты всегда можешь найти утешение в примитиве." Поль Гоген'
[ '"Ты всегда можешь найти утешение в примитиве."' ]
Функции:
preFilter
- Извлекает даты из текста и помещает их в словари result.dates
и result.intervals
. В result.data_sourses
помещаются строки, соответствующие найденным датам.
extractDates
- Принимает строку или список строк как параметр, возвращает объект с атрибутами dates
, sources
, intervals
. Пример:
> sem = require "semantics"
> z1 = sem.plugins.ru.dates.extractDates "Сегодня, 12 сентября 2015 года, я из лесу вышел."
{ intervals: {},
dates: { '12.09.2015': { count: 1, value: { y: 2015, d: 12, m: 8 } } },
sources: [ '12 сентября 2015', [length]: 1 ] }
> z2 = sem.plugins.ru.dates.extractDates "Сегодня, 12 сентября 2015 года, я из лесу вышел. Был в походе с 1 сентября по 12 сентября 2015 года."
{ intervals:
{ '01.09.2015-12.09.2015':
{ to_value: { y: 2015, d: 12, m: 8 },
from_value: { y: 2015, d: 1, m: 8 },
from: '01.09.2015',
count: 1,
to: '12.09.2015' } },
dates: {},
sources: [ ' 1 сентября по 12 сентября 2015 ', [length]: 1 ] }
packDates
- "Упаковать" даты. Формирует компактное представление из дат, полученных с помощью extractDates
.
> sem.plugins.ru.dates.packDates z1.dates
{ '12.09.2015': 1 }
packIntervals
- "Упаковать" интервалы дат. Формирует компактное представление из интервалов дат, полученных с помощью extractDates
.
> sem.plugins.ru.dates.packDates z2.intervals
{ '01.09.2015-12.09.2015': 1 }
Модуль опирается на словарь мужских и женских полных имен и правила склонения русского языка. В данный момент в словарь насчитывает 2346 мужских и 507 женских имен.
semantics пока не обрабатывает двойные (Алим-Паша, Ахмед-оглы и т.п.) и уменьшительные имена (Юра, Вася, Петя, Лиза). Если полное имя отсутствует в модуле, напишите в issues.
В некоторых случаях может быть неверно определено окончание, если трактовка склонения зависит только от ударения в слове.
При поиске фамилий и имен может быть некорректно определен пол для случаев, зависящих от контекста.
"Валентина Петрова" - именительный падеж, женский род.
"Валентина Петрова" - родительный, винительный падежи, мужской род.
"Валентину Петрову" - винительный падеж, женский род.
"Валентину Петрову" - дательный падеж, мужской род.
(The MIT License)
Copyright (c) 2011-2013 Temnov Kirill <allselead@gmail.com>
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.