README.txt - main - polyteach/Script4teacher

README.txt
84 строки4 KB
polyteach
update: README.txt
21 май 2026, 19:51
21 май 2026, 19:51ffc8435
Проект: Анализатор посещаемости учебных и проектных групп

Что делает проект
-----------------
Проект помогает преподавателю быстро понять, где посещаемость лучше, а где хуже.
Скрипт читает таблицу посещаемости и считает процент посещаемости:
1. По проектным группам — столбец "Проект".
2. По учебным группам — столбец "Группа".
3. Отдельно выводит лучшие и худшие результаты.

Правило подсчета:
- посещением считается только отметка "1";
- "0", пустая ячейка, прочерк и любые другие значения считаются отсутствием.

Состав репозитория
------------------
analyze_attendance.py   — исходный код проекта
requirements.txt        — зависимости Python
sample_attendance.csv   — пример входного файла для проверки
README.txt              — описание проекта и инструкция по запуску

Требования
----------
Python: 3.10 или новее
Зависимости:
- pandas
- openpyxl

Установка и запуск
------------------
1. Скачайте или клонируйте репозиторий.
2. Откройте терминал в папке проекта.
3. Создайте виртуальное окружение:

   python -m venv .venv

4. Активируйте виртуальное окружение.

   Windows:
   .venv\Scripts\activate

   macOS / Linux:
   source .venv/bin/activate

5. Установите зависимости:

   pip install -r requirements.txt

6. Запустите анализ на примере:

   python analyze_attendance.py sample_attendance.csv --output attendance_report.xlsx

После запуска появится файл attendance_report.xlsx.
В нем будут листы:
- "По проектам"
- "По учебным группам"
- "Лучшие и худшие"

Запуск на своем Excel-файле
---------------------------
Если у вас есть файл посещаемости Excel, положите его в папку проекта и запустите:

   python analyze_attendance.py attendance.xlsx --output attendance_report.xlsx

Если нужный лист в Excel называется, например, "2025-2026 уч. г., сем. 2", используйте:

   python analyze_attendance.py attendance.xlsx --sheet "2025-2026 уч. г., сем. 2" --output attendance_report.xlsx

Формат входной таблицы
----------------------
В таблице должны быть столбцы:
- Проект
- Группа
- ФИО желательно, но не обязательно
- далее столбцы занятий с отметками 0/1/пусто/прочерк

Пример структуры:
Проект | Группа | ФИО | 01.02.2026 | 08.02.2026 | 15.02.2026

Польза для учебного процесса
----------------------------
Преподаватель может использовать проект после каждого занятия или в конце модуля,
чтобы быстро увидеть группы с высокой и низкой посещаемостью. Это помогает вовремя
заметить проблемные группы, обсудить причины пропусков и принять управленческие решения.