From 33b763678d76dbf864e11da90d9d228e29c55ada Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D0=B5=D0=BC=D0=B8=D0=B9=20=D0=9A=D0=BE?= =?UTF-8?q?=D0=BB=D0=BE=D0=B1=D0=BE=D0=B2?= Date: Thu, 7 May 2026 14:44:36 +0500 Subject: [PATCH] =?UTF-8?q?=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=BB?= =?UTF-8?q?=D0=B5=D0=BD=D0=BE=20=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=82=D0=B8?= =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 139 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 79 insertions(+), 60 deletions(-) diff --git a/README.md b/README.md index 887710e..e920b8c 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ ## 🚀 Установка -### 1. Клонирование репозитория +### Клонирование репозитория ```bash git clone @@ -53,20 +53,22 @@ source venv/bin/activate # Linux/Mac # или venv\Scripts\activate # Windows ``` -3. Установка зависимостей +### Установка зависимостей ```bash pip install -r requirements.txt -▶️ Запуск +``` +### ▶️ Запуск Из командной строки -bash +```bash python3 main.py +``` Через скрипт -bash +``` bash chmod +x run.sh ./run.sh ``` -📁 Структура проекта -text +## 📁 Структура проекта +```text nutrient_medium_pyqt/ ├── main.py # Точка входа ├── run.sh # Скрипт запуска @@ -87,87 +89,104 @@ nutrient_medium_pyqt/ └── controllers/ # Контроллеры ├── medium_controller.py # Логика калькулятора └── experiment_controller.py # Логика планирования +``` +## Основные поля -## 🧪 Калькулятор питательных сред -### Основные поля -Поле Описание -Общее количество Общий объём/масса готовой среды -Растворитель Название растворителя (вода, буфер и т.д.) -Название Имя реагента -% Процентное содержание в среде -Единица Единица измерения реагента -Коэфф. Коэффициент пересчёта (например, для солей-гидратов) -Разбавление (x) Во сколько раз разбавлен исходный раствор -### Пример использования -Укажите общий объём среды (например, 1000 мл) +| Поле | Описание | +|:-----|:----------| +| **Общее количество** | Общий объём/масса готовой среды | +| **Растворитель** | Название растворителя (вода, буфер и т.д.) | +| **Название** | Имя реагента | +| **%** | Процентное содержание в среде | +| **Единица** | Единица измерения реагента | +| **Коэфф.** | Коэффициент пересчёта (например, для солей-гидратов) | +| **Разбавление (x)** | Во сколько раз разбавлен исходный раствор | -Добавьте реагенты с их процентным содержанием +## Пример использования -При необходимости укажите коэффициент пересчёта и разбавление +| Шаг | Действие | +|:----|:----------| +| 1 | Укажите общий объём среды (например, 1000 мл) | +| 2 | Добавьте реагенты с их процентным содержанием | +| 3 | При необходимости укажите коэффициент пересчёта и разбавление | +| 4 | Нажмите **"Рассчитать"** | +| 5 | В столбце **"Количество"** отобразятся необходимые объёмы/массы | -Нажмите "Рассчитать" +## 📈 Планирование эксперимента -В столбце "Количество" отобразятся необходимые объёмы/массы - -#📈 Планирование эксперимента ### Вкладка "Параметры эксперимента" -Факторы -Фактор — название независимой переменной -Нулевой уровень (0) — базовое значение +#### Факторы -Шаг — интервал варьирования +| Параметр | Описание | +|:---------|:----------| +| **Фактор** | Название независимой переменной | +| **Нулевой уровень (0)** | Базовое значение | +| **Шаг** | Интервал варьирования | +| **Верхний уровень (+1)** | Нулевой уровень + шаг *(вычисляется автоматически)* | +| **Нижний уровень (-1)** | Нулевой уровень – шаг *(вычисляется автоматически)* | +| **Единица измерения** | °C, pH, г/л и т.д. | -Верхний уровень (+1) = нулевой уровень + шаг (вычисляется автоматически) +#### Отклики -Нижний уровень (-1) = нулевой уровень – шаг (вычисляется автоматически) +| Параметр | Описание | +|:---------|:----------| +| **Зависимые переменные** | OD600, концентрация продукта и т.д. | -Единица измерения — °C, pH, г/л и т.д. +#### Настройки -### Отклики -Зависимые переменные (OD600, концентрация продукта и т.д.) +| Параметр | Описание | +|:---------|:----------| +| **Количество центральных точек** | Для оценки дисперсии воспроизводимости | +| **Рэндомизация порядка опытов** | Случайный порядок выполнения | -Настройки -Количество центральных точек — для оценки дисперсии воспроизводимости +--- -Рэндомизация порядка опытов — случайный порядок выполнения +### Вкладка "Матрица планирования" -Вкладка "Матрица планирования" -Отображает сгенерированный план эксперимента +| Функция | Описание | +|:---------|:----------| +| **Отображение плана** | Сгенерированный план эксперимента | +| **Факторные точки** | Помечены комбинацией уровней (+/–) | +| **Центральные точки** | Выделены жёлтым цветом | +| **Экспорт в CSV** | Сохраняет матрицу в файл | -Факторные точки помечены комбинацией уровней (+/–) - -Центральные точки выделены жёлтым цветом - -Кнопка "Экспорт в CSV" сохраняет матрицу в файл +--- ### Вкладка "Анализ результатов" -Введите результаты экспериментов в таблицу -Нажмите "Провести регрессионный анализ" +#### Порядок работы -Получите: +1. Введите результаты экспериментов в таблицу +2. Нажмите **"Провести регрессионный анализ"** -Среднее значение отклика +#### Результаты анализа -Общую дисперсию +| Показатель | Описание | +|:-----------|:----------| +| **Среднее значение отклика** | Центральная тенденция данных | +| **Общая дисперсия** | Разброс данных относительно среднего | +| **Стандартное отклонение** | Квадратный корень из дисперсии | +| **Коэффициент вариации (CV)** | Относительная мера разброса данных | +| **Дисперсия воспроизводимости** | Оценивается по центральным точкам | +| **Критерий Фишера (F-отношение)** | Проверка адекватности модели | -Стандартное отклонение +--- -Коэффициент вариации +## 💾 Сохранение и загрузка -Дисперсию воспроизводимости (по центральным точкам) +### Калькулятор питательных сред -Критерий Фишера для проверки адекватности модели +| Кнопка | Действие | +|:-------|:----------| +| **💾 Сохранить** | Сохранить рецепт в JSON-файл | +| **📂 Загрузить** | Загрузить сохранённый рецепт | -💾 Сохранение и загрузка - Калькулятор сред -💾 Сохранить — сохранить рецепт в JSON-файл +### Планирование эксперимента -📂 Загрузить — загрузить сохранённый рецепт - -Планирование эксперимента -📊 Экспорт в CSV — сохранить матрицу планирования +| Кнопка | Действие | +|:-------|:----------| +| **📊 Экспорт в CSV** | Сохранить матрицу планирования в CSV-файл | ## 📦 Требования Пакет Версия Назначение