# NLP: стилометрия реплик Stardew Valley

Репозиторий лабораторной работы по автоматическому анализу текстов.
Исследуется, можно ли стилометрически различить 34 персонажа Stardew Valley
по отдельным репликам, если все реплики написаны одним автором.

## Быстрый старт

```bash
cd lab1
cat RUNBOOK.md
```

Пошаговая инструкция для запуска полной серии экспериментов:
[`lab1/RUNBOOK.md`](lab1/RUNBOOK.md).

Краткая установка:

```bash
cd lab1
python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python scripts/download_nltk_data.py
python scripts/check_environment.py
python -m pytest -q
bash scripts/run_all_experiments.sh
```

## Структура

```text
nlp/
├── lab1/
│   ├── stylometry/          # код: чтение, признаки, LSA, модели, метрики
│   ├── tests/               # тесты
│   ├── data/                # корпус и метаданные
│   ├── configs/             # конфигурация
│   ├── scripts/             # проверка окружения, запуск серии, упаковка
│   ├── RUNBOOK.md           # инструкция для запуска
│   ├── EXPERIMENTS.md       # протокол экспериментов
│   ├── FEATURES.md          # описание признаков
│   ├── METRICS_AND_CLASSIFIERS.md
│   └── PRESENTATION_OUTLINE.md
└── .venv/                   # локальное окружение, не коммитится
```

## Основные документы

- [`lab1/RUNBOOK.md`](lab1/RUNBOOK.md) — как запускать всё с нуля.
- [`lab1/EXPERIMENTS.md`](lab1/EXPERIMENTS.md) — протокол экспериментов.
- [`lab1/METRICS_AND_CLASSIFIERS.md`](lab1/METRICS_AND_CLASSIFIERS.md) —
  методическое описание метрик и классификаторов.
- [`lab1/FEATURES.md`](lab1/FEATURES.md) — признаки и формулы.
- [`lab1/TUNING.md`](lab1/TUNING.md) — настройка параметров и перебор.
- [`lab1/RESULTS_ANALYSIS.md`](lab1/RESULTS_ANALYSIS.md) — анализ результатов
  follow-up серии и выводы.
- [`lab1/FINAL_REPORT.md`](lab1/FINAL_REPORT.md) — итоговый отчёт по всей
  работе и экспериментам.
- [`lab1/FINAL_RESULTS.csv`](lab1/FINAL_RESULTS.csv) — сводная таблица
  результатов.
- [`lab1/FOLLOWUP_EXPERIMENTS.md`](lab1/FOLLOWUP_EXPERIMENTS.md) — протокол
  follow-up экспериментов.
- [`lab1/PRESENTATION_OUTLINE.md`](lab1/PRESENTATION_OUTLINE.md) — структура
  презентации.
- [`lab1/presentation/README.md`](lab1/presentation/README.md) — готовая
  презентация, сборка и исходные изображения.