docs

Документация библиотеки Most-Queue

Most-Queue — это Python-библиотека для симуляции и численного анализа систем массового обслуживания (СМО) и сетей очередей.

📚 Навигация по документации

Начало работы

• Быстрый старт — установка и первые примеры использования
• Основные концепции — теория массового обслуживания и терминология

Основные разделы

• Симуляция СМО — руководство по моделированию систем массового обслуживания
• Численные методы — расчет характеристик СМО аналитическими методами
• Распределения — справочник по поддерживаемым распределениям
• Модели СМО — каталог поддерживаемых типов систем массового обслуживания

Специализированные темы

• Сети очередей — моделирование и расчет сетей СМО
• Приоритетные системы — системы с приоритетным обслуживанием
• Disaster (отрицательные заявки): временные характеристики — подход к вычислению (W, V, V_{served}, V_{broken}) через LST
• RCS (отрицательные заявки): временные характеристики — подход к вычислению (W, V, V_{served}, V_{broken}) в модели RCS
• Расширенные примеры — практические кейсы и сложные сценарии

🎯 Основные возможности

Симуляция

• Моделирование различных типов СМО (M/M/c, M/G/1, GI/M/c и др.)
• Поддержка различных распределений времени поступления и обслуживания
• Системы с приоритетами, отпусками, отрицательными заявками
• Fork-Join и Split-Join системы
• Сети очередей

Численные методы

• Аналитический расчет стационарных характеристик
• Методы для различных типов СМО
• Высокая точность расчетов
• Быстрое получение результатов

Анализ результатов

• Моменты времени ожидания и пребывания
• Вероятности состояний системы
• Коэффициент загрузки
• Визуализация и таблицы результатов

📦 Установка

pip install most-queue

Или установка из репозитория:

pip install -e .

🔍 Быстрый пример

from most_queue.sim.base import QsSim

# Создаем симулятор M/M/1 системы
qs = QsSim(num_of_channels=1)

# Настраиваем поток поступления (пуассоновский с интенсивностью 0.5)
qs.set_sources(0.5, "M")

# Настраиваем обслуживание (экспоненциальное с интенсивностью 1.0)
qs.set_servers(1.0, "M")

# Запускаем симуляцию на 10000 заявок
results = qs.run(10000)

# Получаем результаты
print(f"Среднее время ожидания: {results.w[0]:.4f}")
print(f"Среднее время пребывания: {results.v[0]:.4f}")
print(f"Коэффициент загрузки: {results.utilization:.4f}")

📖 Структура библиотеки

Библиотека состоит из двух основных модулей:

• most_queue.sim — модуль симуляции СМО
• most_queue.theory — модуль численных методов расчета

🧪 Примеры и тесты

• Примеры использования находятся в папке tests/
• Jupyter-туториалы доступны в папке tutorials/

📝 Версия

Текущая версия: 2.7

🔗 Полезные ссылки

• Репозиторий на GitHub
• Issues и предложения

👥 Контакты

По вопросам и предложениям: [email protected]

---

Примечание: Эта документация на русском языке. Для английской версии см. README.md в корне проекта.