Skip to content

Добавить ноутбук о сложности текста по ступеням обучения - #62

Merged
SergeyShk merged 3 commits into
masterfrom
examples/complexity-by-grade
Sep 19, 2026
Merged

SergeyShk merged 3 commits into
masterfrom
examples/complexity-by-grade

Conversation

@SergeyShk

Copy link
Copy Markdown
Owner

Что сделано

Второй ноутбук галереи - examples/02_text_complexity_by_grade.ipynb. Набор TextsByGrade (68 текстов с меткой класса от 1 до 17) используется как одна ось сложности, на которую по очереди накладываются все группы статистик; признаки считаются одним проходом nlp.pipe с компонентами ruTS в таблицу, мера согласия везде - ρ Спирмена с меткой.

  • Удобочитаемость: все одиннадцать формул на ρ = 0.75-0.82, сводный класс 0.81; для формул, выдающих класс, - MAE в классах и медиана (3-4 класса, точнее всех по величине Колман-Лиау); диаграмма сводного класса против метки; три пресета коэффициентов (plainrussian, fiction, academic) - по рангам неотличимы, academic чуть точнее по величине, с оговоркой, что plainrussian подбирался на этом наборе.
  • Лексика: меры разнообразия (MTLD, HD-D, MATTR, MTLD по окнам) дают ρ ≈ 0; лексическая сложность по словарю - плотность и полосы топ-5000/10000 растут (0.5), доля слов вне топ-10000 падает (−0.47), с объяснением про имена и уменьшительные формы в детских текстах.
  • Синтаксис и морфология: диаграмма ρ по 18 признакам - именная нагрузка (модификаторов на именную группу 0.79), длина клаузы (0.79), отглагольные существительные (0.75), глубина дерева (0.75), пассив (0.73), производные предлоги, причастные обороты, расщеплённые сказуемые; падают доля глаголов (−0.78), частиц (−0.66), местоимений. Ящики по четырём ступеням обучения; отдельно отмечено, что основной контраст - проза против документов, внутри школы ступени перекрываются.
  • Связность: коннекторы (особенно противительные, −0.66) и местоимения падают, повтор знаменательных слов между предложениями растёт.
  • Проверка на независимом наборе: хрестоматия SovChLit для первого класса, 115 текстов от 50 слов - медиана сводного класса 2.5, 79 % текстов не выше 4 класса, гистограмма и describe_grade.

Таблица формул в docs/datasets/textsbygrade.md (ru/en) обновлена под текущие значения (после подсчёта букв через isalpha в 0.13.0 ρ и MAE сдвинулись на 0.01-0.2) со ссылкой на ноутбук; ноутбук добавлен на страницу примеров и в examples/README.md.

Пакет не меняется, версия без изменений.

Проверка

  • make notebooks - оба ноутбука выполняются (38 с), файл первого ноутбука после повторного прогона не изменился, во втором нет ошибок и предупреждений.
  • make lint, pre-commit run --all-files, tests/test_docs.py, mkdocs build --strict.

🤖 Generated with Claude Code

examples/02_text_complexity_by_grade.ipynb: 68 текстов TextsByGrade
с меткой класса как одна ось сложности - корреляция Спирмена всех
формул удобочитаемости с меткой и ошибка в классах, три пресета
коэффициентов, лексическое разнообразие против лексической сложности
по частотному словарю, синтаксис, морфология и связность, распределения
по ступеням и проверка на независимой хрестоматии SovChLit.

Таблица формул в документации TextsByGrade обновлена под подсчёт букв
0.13.0, ссылка на ноутбук в ней, на странице примеров и в examples/README.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@SergeyShk SergeyShk added documentation Improvements or additions to documentation enhancement New feature or request labels Sep 19, 2026

@SergeyShk SergeyShk left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Прогнал ноутбук и пересчитал цифры. Три замечания по существу, всё остальное сходится (диапазоны сводного класса по классам, ρ по синтаксису, скачок плотности на 15-17).

Comment thread docs/datasets/textsbygrade.md Outdated
Comment thread examples/02_text_complexity_by_grade.ipynb Outdated
Comment thread examples/02_text_complexity_by_grade.ipynb
SergeyShk and others added 2 commits September 19, 2026 19:07
…тбуке

Абзац о среднем сводном классе по группам пересчитан под 0.13.0;
подписи ящиков через set_xticks, чтобы ячейка работала на matplotlib
3.8; в проверке на хрестоматии выведены пять самых сложных текстов
с типом и длиной предложения, формулировка про басни убрана.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Ноутбуки заканчиваются выводами: у сквозного разбора появился раздел
«Итоги» вместо «Что дальше», у ноутбука о ступенях обучения убран
абзац со ссылками после итогов; ячейка с ruts.__version__ удалена.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@SergeyShk
SergeyShk merged commit 151ec2f into master Sep 19, 2026
11 of 12 checks passed
@SergeyShk
SergeyShk deleted the examples/complexity-by-grade branch September 19, 2026 18:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants