lastname

Статистический анализ текста. Склонение русских имен, фамилий и отчеств.

Установка

   npm install lastname

Вместе с библиотекой будет установлен coffee-script.

API модуля

Все обьекты, возвращаемые методами склонения и поиска людей имеют поле found в котором содержиться информация об исходном обьекте.

Склонение имен

Для методов doInclineFemaleName, doInclineMaleName склоняемые слова должны быть в именительном падеже.

   ln = require "lastname"
   console.log ln.plugins.ru.inclines.doInclineFemaleName "Василиса"
   console.log ln.plugins.ru.inclines.doInclineMaleName "Василий"
 
   console.log ln.plugins.ru.inclines.inclineName "Александром"
   console.log ln.plugins.ru.inclines.inclineName "Александрой"

Склонение отчеств

   ln = require "lastname"
   console.log ln.plugins.ru.inclines.inclineMaleMiddleName "Григорьевича"
   console.log ln.plugins.ru.inclines.inclineFemMiddleName "Арнольдовне"
 
   console.log ln.plugins.ru.inclines.inclineMiddleName "Вячеславовича"
   console.log ln.plugins.ru.inclines.inclineMiddleName "Андреевной"

Склонение фамилий

   ln = require "lastname"
   console.log ln.plugins.ru.inclines.inclineFemaleSurname "Летящая"
   console.log ln.plugins.ru.inclines.inclineFemaleSurname "Пробкиной"
   console.log ln.plugins.ru.inclines.inclineMaleSurname "Грибков"
   console.log ln.plugins.ru.inclines.inclineMaleSurname "Ильин"
 
   console.log ln.plugins.ru.inclines.inclineSurname "Чичикова"
   console.log ln.plugins.ru.inclines.inclineSurname "Кротких"

Подбор фамилий, имен и отчеств людей

Методу `findProperName` передается список из 1-3 слов. Допустимые комбинации
- Фамилия
- Имя Фамилия
- Фамилия Имя Отчество
- Имя Отчество Фамилия 
Падеж передаваемых слов должен быть согласован.

   ln = require "lastname"
   console.log ln.plugins.ru.inclines.findProperName ["Алина", "Жилина"]
   console.log ln.plugins.ru.inclines.findProperName ["Сольвьёв", "Василий"]
 
   console.log ln.plugins.ru.inclines.findProperName ["Петром", "Васильевичем", "Старостиным"]

• Все имена и фамилии в примерах являются плодами моей фантазии, любые совпадения случайны.

Анализ текста

Для анализа текста используется вызов функции lastname.analysis.analyse и передача ей
в качестве аргумента текста и списка плагинов для анализа текста. Если список плагинов пуст, используются анализаторы по умолчанию. В результате анализа возвращается объект, содержащий параметры текста. Набор параметров зависит от плагинов, подробности в описаниях.

   sys = require "util"
   lastname = require "lastname"
   text = """Любой текст для анализа, английский тоже подойдет"""
   console.log "#{sys.inspect lastname.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 },
      version: '0.3.XX }

Поиск в файле

   sys = require "util"
   lastname = require "lastname"
   console.log lastname.analyseFile "/tmp/sample.txt"

• Поиск в файле и по тексту возвращает пустой словарь {} если не было найдено ни одного совпадения.

Командная строка

Для добавление команды lastname необходимо установить пакет глобально:

        npm install lastname -g

lastname может анализировать файлы

        lastname -a file.txt

Склонять прилагательные

        lastname -i Стильные

осуществлять поиск имен, фамилий и отчеств

        lastname Василий
        lastname Василий Тёркин
        lastname Василия Тёркина
        lastname Василии Петровиче Тёркине

Плагины

Плагины размещаются в plugins.LANG относительно остальных модулей. LANG - язык для которого предназначен плагин, например, ru, en.

Плагин должен иметь функцию preFilter или postFilter. Функции preFilter и postFilter принимают 3 параметра:

1. text - Анализируемый текст. Текст не может быть модифицирован.

2. result - Результирующий объект. Каждый плагин может добавлять свои ключи к объекту. Перезапись данных других плагинов не рекомендуется.

3. opts - опции. Этот параметр содержит опции для всех плагинов. Плагины не должны модифицировать этот объект.

В процессе анализа текста вначале вызываются все функции preFilter, затем postFilter.

Плагины могут быть использованы самостоятельно либо собраны в цепочку, см. модуль lastname.analysis.

Встроенные плагины

plugins.ru.abbrevs Модуль для извлечения русских и английских аббревиатур из текста.

Функции:

a) preFilter - Извлекает аббревиатуры из текста и помещает словарь с аббревиатурами и частотой вхождения в result.ru.abbrevs.

b) extract Принимает текст в качестве параметра, возвращает список аббревиатур (с дубликатами).

    ln = require "lastname"
    ln.plugins.ru.abbrevs.extract "текст с НЕКОЙ аббревиатурой" #  [ 'НЕКОЙ' ]

plugins.ru.feelings Эмоциональная окраска, модуль надо переименовать.

plugins.ru.quotes Получение цитат из текста. Фактически извлекает любой текст в кавычках.

Функции:

preFilter - Извлекает цитаты из текста и помещает их в список result.quotes.

getQuotes - Принимает текст в качестве параметра, возвращает список цитат (с дубликатами).

    > ln  = require "lastname"
    > ln.plugins.ru.quotes.getQuotes ' "Ты всегда можешь найти утешение в примитиве." Поль Гоген'
    [ '"Ты всегда можешь найти утешение в примитиве."' ]

plugins.ru.dates Русские даты и интервалы дат.

Функции:

preFilter - Извлекает даты из текста и помещает их в словари result.dates и result.intervals. В result.data_sourses помещаются строки, соответствующие найденным датам.

extractDates - Принимает строку или список строк как параметр, возвращает объект с атрибутами dates, sources, intervals. Пример:

    > ln  = require "lastname"
    > z1  = ln.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  = ln.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.

    > ln.plugins.ru.dates.packDates z1.dates 
    { '12.09.2015': 1 }

packIntervals - "Упаковать" интервалы дат. Формирует компактное представление из интервалов дат, полученных с помощью extractDates.

    > ln.plugins.ru.dates.packDates z2.intervals
    { '01.09.2015-12.09.2015': 1 }

plugins.ru.inclines

plugins.ru.propernames

plugins.ru.ref

plugins.ru.words

plugins.ru.twitter

Как работает?

Модуль опирается на словарь мужских и женских полных имен и правила склонения русского языка. В данный момент в словарь насчитывает 2346 мужских и 507 женских имен.

lastname не обрабатывает двойные (Алим-Паша, Ахмед-оглы и т.п.) и уменьшительные имена (Юра, Вася, Петя, Лиза). Если полное имя отсутствует в модуле, напишите в issues.

В некоторых случаях может быть неверно определено окончание, если трактовка склонения зависит только от ударения в слове.

При поиске фамилий и имен может быть некорректно определен пол для случаев, зависящих от контекста.

Пример

"Валентина Петрова" - именительный падеж, женский род.
"Валентина Петрова" - родительный, винительный падежи, мужской род.

"Валентину Петрову" - винительный падеж, женский род.
"Валентину Петрову" - дательный падеж, мужской род.

Лицензия MIT

(The MIT License)

Copyright (c) 2011 Temnov Kirill <[e-mail]>

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.