most-queue 2.4__tar.gz → 2.6__tar.gz

{most_queue-2.4 → most_queue-2.6}/.gitignore

@@ -162,4 +162,11 @@ cython_debug/
 
 .vscode
 
-works/negative_queues/results/*
+works/negative_queues/results/*
+
+# ignore all png files in tests/units folder
+tests/units/*.png
+
+# ignore all files in works/vacations/results
+works/vacations/results/*
+

most_queue-2.6/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: most_queue
+Version: 2.6
+Summary: Software package for calculation and simulation of queuing systems
+Project-URL: Homepage, https://github.com/xabarov/most-queue
+Author-email: Xabarov Roman <xabarov1985@gmail.com>
+License: Copyright (c) 2018 The Python Packaging Authority
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Requires-Dist: colorama
+Requires-Dist: graphviz
+Requires-Dist: matplotlib
+Requires-Dist: networkx
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: pyyaml
+Requires-Dist: scipy<2.0,>=1.13.0
+Requires-Dist: tqdm
+Description-Content-Type: text/markdown
+
+# Системы массового обслуживания: Симуляция и численные методы 🔄
+
+![Queue](assets/3.gif)
+
+Python-библиотека для симуляции и анализа систем массового обслуживания (СМО) и сетей очередей.
+
+![GitHub commit activity](https://img.shields.io/github/commit-activity/m/xabarov/most-queue)
+
+---
+
+## 📚 Документация
+
+**Подробная документация доступна:**
+
+- **[📖 Полная документация (Русский)](docs/README.md)** — Полное руководство на русском языке с подробными туториалами, примерами и теорией
+- **[🚀 Быстрый старт](docs/getting_started.md)** — Начните работу за несколько минут
+- **[📘 Основные концепции](docs/concepts.md)** — Основы теории массового обслуживания
+- **[🎮 Руководство по симуляции](docs/simulation.md)** — Имитационное моделирование
+- **[🧮 Руководство по расчетам](docs/calculation.md)** — Численные методы
+- **[📊 Каталог моделей](docs/models.md)** — Поддерживаемые модели СМО
+- **[🌐 Сети очередей](docs/networks.md)** — Сети СМО
+- **[⭐ Приоритетные системы](docs/priorities.md)** — Системы с приоритетами
+- **[💡 Примеры использования](docs/examples.md)** — Практические примеры
+
+---
+
+## 🔍 Основные возможности
+
+- **Симуляция**: Моделирование различных типов систем массового обслуживания и сетей
+- **Численные методы**: Решение стационарных задач теории массового обслуживания
+- **Метрики производительности**: Анализ времени ожидания, времени пребывания, коэффициентов загрузки и многое другое
+- **Широкая поддержка моделей**: FIFO, приоритеты, отпуска, отрицательные заявки, fork-join, сети и многое другое
+
+---
+
+## 📦 Установка
+
+```bash
+pip install most-queue
+```
+
+Или установка из репозитория:
+
+```bash
+git clone https://github.com/xabarov/most-queue.git
+cd most-queue
+pip install -e .
+```
+
+**Требования:** Python >= 3.9
+
+---
+
+## 🚀 Быстрый старт
+
+### Базовый пример: M/M/1 система
+
+```python
+from most_queue.sim.base import QsSim
+
+# Создание симулятора
+qs = QsSim(num_of_channels=1)
+
+# Настройка потока поступления (пуассоновский с интенсивностью λ = 0.5)
+qs.set_sources(0.5, "M")
+
+# Настройка обслуживания (экспоненциальное с интенсивностью μ = 1.0)
+qs.set_servers(1.0, "M")
+
+# Запуск симуляции
+results = qs.run(10000)
+
+# Получение результатов
+print(f"Среднее время ожидания: {results.w[0]:.4f}")
+print(f"Среднее время пребывания: {results.v[0]:.4f}")
+print(f"Коэффициент загрузки: {results.utilization:.4f}")
+```
+
+### Численный расчет
+
+```python
+from most_queue.theory.fifo.mmnr import MMnrCalc
+
+# Создание калькулятора
+calc = MMnrCalc(n=1)
+calc.set_sources(l=0.5)
+calc.set_servers(mu=1.0)
+
+# Выполнение расчета
+results = calc.run()
+print(f"Среднее время ожидания: {results.w[0]:.4f}")
+```
+
+**См. [Руководство по быстрому старту](docs/getting_started.md) для дополнительных примеров.**
+
+---
+
+## 📚 Структура проекта
+
+Most-Queue состоит из двух основных модулей:
+
+- **`most_queue.sim`** — Программы симуляции систем массового обслуживания
+- **`most_queue.theory`** — Численные методы для расчета моделей теории массового обслуживания
+
+---
+
+## 🧪 Поддерживаемые модели
+
+### FIFO системы
+- **M/M/c**, **M/M/c/r** — Многоканальные системы с пуассоновским потоком
+- **M/G/1**, **M/G/c** — Системы с произвольным распределением времени обслуживания
+- **GI/M/1**, **GI/M/c** — Системы с общим потоком поступления
+- **M/D/c**, **E_k/D/c** — Системы с детерминированным обслуживанием
+- **M/H₂/c** — Метод Такахаси-Таками с гиперэкспоненциальным обслуживанием
+
+### Системы с приоритетами
+- **M/G/1/PR**, **M/G/1/NP** — Одноканальные с прерываемым/непрерываемым приоритетом
+- **M/G/c/PR**, **M/G/c/NP** — Многоканальные с приоритетами
+- **M/Ph/c/PR** — Фазовое распределение обслуживания с приоритетами
+
+### Специализированные системы
+- **Отпуска** — Системы с отпусками серверов и прогревом
+- **Отрицательные заявки** — Модели RCS и disaster
+- **Fork-Join** — Системы параллельной обработки
+- **Пакетное поступление** — Системы M^x/M/1
+- **Нетерпеливые заявки** — Системы с уходом клиентов
+- **Engset** — Закрытые системы с конечным числом источников
+- **Сети** — Открытые и закрытые сети очередей
+
+**См. [Каталог моделей](docs/models.md) для полного списка и деталей.**
+
+---
+
+## 📌 Области применения
+
+- **Облачные вычисления**: Моделирование масштабируемости и производительности инфраструктуры
+- **Call-центры**: Оптимизация штата и времени ожидания клиентов
+- **Транспорт**: Улучшение транспортных потоков и логистики
+- **Сетевой трафик**: Анализ и прогнозирование потоков данных
+- **Производство**: Оптимизация производственных линий
+- **Здравоохранение**: Планирование ресурсов больниц
+
+**См. [Примеры использования](docs/examples.md) для практических кейсов.**
+
+---
+
+## 📖 Most-Queue 2.0 API
+
+Единый API для симуляции и расчета:
+
+```python
+# Численный расчет
+calc = MGnCalc(n=NUM_OF_CHANNELS)
+calc.set_sources(l=ARRIVAL_RATE)
+calc.set_servers(b=b)
+calc_results = calc.run()
+
+# Симуляция
+qs = QsSim(NUM_OF_CHANNELS)
+qs.set_sources(ARRIVAL_RATE, "M")
+qs.set_servers(gamma_params, "Gamma")
+sim_results = qs.run(NUM_OF_JOBS)
+```
+
+---
+
+## 📁 Ресурсы
+
+- **[Тесты](tests/)** — Примеры с сравнением теоретических и симуляционных результатов
+- **[Туториалы](tutorials/)** — Jupyter-ноутбуки с пошаговыми руководствами
+- **[Документация](docs/)** — Подробная документация на русском языке
+
+---
+
+## 🔍 Ключевые слова для поиска
+
+- Теория массового обслуживания
+- Симуляция
+- Численные методы
+- Сети очередей
+- Анализ производительности
+- Облачные вычисления
+- Оптимизация call-центров
+- Транспортные системы
+- Сетевой трафик
+- Python-пакет
+
+---
+
+## 👥 Участие в разработке
+
+Мы приветствуем ваш вклад!
+
+- Откройте [issue](https://github.com/xabarov/most-queue/issues) для сообщений об ошибках или предложений
+- Отправьте pull request для улучшений функциональности
+- Контакты: xabarov1985@gmail.com
+
+---
+
+## 📄 Лицензия
+
+См. файл [LICENSE](LICENSE) для деталей.
+
+---
+
+**Для подробной документации, примеров и туториалов см. [docs/README.md](docs/README.md)**

most_queue-2.6/README.md

@@ -0,0 +1,206 @@
+# Системы массового обслуживания: Симуляция и численные методы 🔄
+
+![Queue](assets/3.gif)
+
+Python-библиотека для симуляции и анализа систем массового обслуживания (СМО) и сетей очередей.
+
+![GitHub commit activity](https://img.shields.io/github/commit-activity/m/xabarov/most-queue)
+
+---
+
+## 📚 Документация
+
+**Подробная документация доступна:**
+
+- **[📖 Полная документация (Русский)](docs/README.md)** — Полное руководство на русском языке с подробными туториалами, примерами и теорией
+- **[🚀 Быстрый старт](docs/getting_started.md)** — Начните работу за несколько минут
+- **[📘 Основные концепции](docs/concepts.md)** — Основы теории массового обслуживания
+- **[🎮 Руководство по симуляции](docs/simulation.md)** — Имитационное моделирование
+- **[🧮 Руководство по расчетам](docs/calculation.md)** — Численные методы
+- **[📊 Каталог моделей](docs/models.md)** — Поддерживаемые модели СМО
+- **[🌐 Сети очередей](docs/networks.md)** — Сети СМО
+- **[⭐ Приоритетные системы](docs/priorities.md)** — Системы с приоритетами
+- **[💡 Примеры использования](docs/examples.md)** — Практические примеры
+
+---
+
+## 🔍 Основные возможности
+
+- **Симуляция**: Моделирование различных типов систем массового обслуживания и сетей
+- **Численные методы**: Решение стационарных задач теории массового обслуживания
+- **Метрики производительности**: Анализ времени ожидания, времени пребывания, коэффициентов загрузки и многое другое
+- **Широкая поддержка моделей**: FIFO, приоритеты, отпуска, отрицательные заявки, fork-join, сети и многое другое
+
+---
+
+## 📦 Установка
+
+```bash
+pip install most-queue
+```
+
+Или установка из репозитория:
+
+```bash
+git clone https://github.com/xabarov/most-queue.git
+cd most-queue
+pip install -e .
+```
+
+**Требования:** Python >= 3.9
+
+---
+
+## 🚀 Быстрый старт
+
+### Базовый пример: M/M/1 система
+
+```python
+from most_queue.sim.base import QsSim
+
+# Создание симулятора
+qs = QsSim(num_of_channels=1)
+
+# Настройка потока поступления (пуассоновский с интенсивностью λ = 0.5)
+qs.set_sources(0.5, "M")
+
+# Настройка обслуживания (экспоненциальное с интенсивностью μ = 1.0)
+qs.set_servers(1.0, "M")
+
+# Запуск симуляции
+results = qs.run(10000)
+
+# Получение результатов
+print(f"Среднее время ожидания: {results.w[0]:.4f}")
+print(f"Среднее время пребывания: {results.v[0]:.4f}")
+print(f"Коэффициент загрузки: {results.utilization:.4f}")
+```
+
+### Численный расчет
+
+```python
+from most_queue.theory.fifo.mmnr import MMnrCalc
+
+# Создание калькулятора
+calc = MMnrCalc(n=1)
+calc.set_sources(l=0.5)
+calc.set_servers(mu=1.0)
+
+# Выполнение расчета
+results = calc.run()
+print(f"Среднее время ожидания: {results.w[0]:.4f}")
+```
+
+**См. [Руководство по быстрому старту](docs/getting_started.md) для дополнительных примеров.**
+
+---
+
+## 📚 Структура проекта
+
+Most-Queue состоит из двух основных модулей:
+
+- **`most_queue.sim`** — Программы симуляции систем массового обслуживания
+- **`most_queue.theory`** — Численные методы для расчета моделей теории массового обслуживания
+
+---
+
+## 🧪 Поддерживаемые модели
+
+### FIFO системы
+- **M/M/c**, **M/M/c/r** — Многоканальные системы с пуассоновским потоком
+- **M/G/1**, **M/G/c** — Системы с произвольным распределением времени обслуживания
+- **GI/M/1**, **GI/M/c** — Системы с общим потоком поступления
+- **M/D/c**, **E_k/D/c** — Системы с детерминированным обслуживанием
+- **M/H₂/c** — Метод Такахаси-Таками с гиперэкспоненциальным обслуживанием
+
+### Системы с приоритетами
+- **M/G/1/PR**, **M/G/1/NP** — Одноканальные с прерываемым/непрерываемым приоритетом
+- **M/G/c/PR**, **M/G/c/NP** — Многоканальные с приоритетами
+- **M/Ph/c/PR** — Фазовое распределение обслуживания с приоритетами
+
+### Специализированные системы
+- **Отпуска** — Системы с отпусками серверов и прогревом
+- **Отрицательные заявки** — Модели RCS и disaster
+- **Fork-Join** — Системы параллельной обработки
+- **Пакетное поступление** — Системы M^x/M/1
+- **Нетерпеливые заявки** — Системы с уходом клиентов
+- **Engset** — Закрытые системы с конечным числом источников
+- **Сети** — Открытые и закрытые сети очередей
+
+**См. [Каталог моделей](docs/models.md) для полного списка и деталей.**
+
+---
+
+## 📌 Области применения
+
+- **Облачные вычисления**: Моделирование масштабируемости и производительности инфраструктуры
+- **Call-центры**: Оптимизация штата и времени ожидания клиентов
+- **Транспорт**: Улучшение транспортных потоков и логистики
+- **Сетевой трафик**: Анализ и прогнозирование потоков данных
+- **Производство**: Оптимизация производственных линий
+- **Здравоохранение**: Планирование ресурсов больниц
+
+**См. [Примеры использования](docs/examples.md) для практических кейсов.**
+
+---
+
+## 📖 Most-Queue 2.0 API
+
+Единый API для симуляции и расчета:
+
+```python
+# Численный расчет
+calc = MGnCalc(n=NUM_OF_CHANNELS)
+calc.set_sources(l=ARRIVAL_RATE)
+calc.set_servers(b=b)
+calc_results = calc.run()
+
+# Симуляция
+qs = QsSim(NUM_OF_CHANNELS)
+qs.set_sources(ARRIVAL_RATE, "M")
+qs.set_servers(gamma_params, "Gamma")
+sim_results = qs.run(NUM_OF_JOBS)
+```
+
+---
+
+## 📁 Ресурсы
+
+- **[Тесты](tests/)** — Примеры с сравнением теоретических и симуляционных результатов
+- **[Туториалы](tutorials/)** — Jupyter-ноутбуки с пошаговыми руководствами
+- **[Документация](docs/)** — Подробная документация на русском языке
+
+---
+
+## 🔍 Ключевые слова для поиска
+
+- Теория массового обслуживания
+- Симуляция
+- Численные методы
+- Сети очередей
+- Анализ производительности
+- Облачные вычисления
+- Оптимизация call-центров
+- Транспортные системы
+- Сетевой трафик
+- Python-пакет
+
+---
+
+## 👥 Участие в разработке
+
+Мы приветствуем ваш вклад!
+
+- Откройте [issue](https://github.com/xabarov/most-queue/issues) для сообщений об ошибках или предложений
+- Отправьте pull request для улучшений функциональности
+- Контакты: xabarov1985@gmail.com
+
+---
+
+## 📄 Лицензия
+
+См. файл [LICENSE](LICENSE) для деталей.
+
+---
+
+**Для подробной документации, примеров и туториалов см. [docs/README.md](docs/README.md)**

most_queue-2.6/docs/README.md

@@ -0,0 +1,108 @@
+# Документация библиотеки Most-Queue
+
+![Queue](../assets/3.gif)
+
+**Most-Queue** — это Python-библиотека для симуляции и численного анализа систем массового обслуживания (СМО) и сетей очередей.
+
+## 📚 Навигация по документации
+
+### Начало работы
+- **[Быстрый старт](getting_started.md)** — установка и первые примеры использования
+- **[Основные концепции](concepts.md)** — теория массового обслуживания и терминология
+
+### Основные разделы
+- **[Симуляция СМО](simulation.md)** — руководство по моделированию систем массового обслуживания
+- **[Численные методы](calculation.md)** — расчет характеристик СМО аналитическими методами
+- **[Распределения](distributions.md)** — справочник по поддерживаемым распределениям
+- **[Модели СМО](models.md)** — каталог поддерживаемых типов систем массового обслуживания
+
+### Специализированные темы
+- **[Сети очередей](networks.md)** — моделирование и расчет сетей СМО
+- **[Приоритетные системы](priorities.md)** — системы с приоритетным обслуживанием
+- **[Расширенные примеры](examples.md)** — практические кейсы и сложные сценарии
+
+## 🎯 Основные возможности
+
+### Симуляция
+- Моделирование различных типов СМО (M/M/c, M/G/1, GI/M/c и др.)
+- Поддержка различных распределений времени поступления и обслуживания
+- Системы с приоритетами, отпусками, отрицательными заявками
+- Fork-Join и Split-Join системы
+- Сети очередей
+
+### Численные методы
+- Аналитический расчет стационарных характеристик
+- Методы для различных типов СМО
+- Высокая точность расчетов
+- Быстрое получение результатов
+
+### Анализ результатов
+- Моменты времени ожидания и пребывания
+- Вероятности состояний системы
+- Коэффициент загрузки
+- Визуализация и таблицы результатов
+
+## 📦 Установка
+
+```bash
+pip install most-queue
+```
+
+Или установка из репозитория:
+
+```bash
+pip install -e .
+```
+
+## 🔍 Быстрый пример
+
+```python
+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/`](../tests/)
+- Jupyter-туториалы доступны в папке [`tutorials/`](../tutorials/)
+
+## 📝 Версия
+
+Текущая версия: **2.05**
+
+## 🔗 Полезные ссылки
+
+- [Репозиторий на GitHub](https://github.com/xabarov/most-queue)
+- [Issues и предложения](https://github.com/xabarov/most-queue/issues)
+
+## 👥 Контакты
+
+По вопросам и предложениям: xabarov1985@gmail.com
+
+---
+
+**Примечание**: Эта документация на русском языке. Для английской версии см. [README.md](../README.md) в корне проекта.
+