Skip to content

german2285/Staticks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚗 Staticks

Python License Status

Staticks — система мониторинга и анализа автомобильных номеров по регионам Российской Федерации. Проект предназначен для сбора, обработки и визуализации статистики распределения автомобилей по регионам России.

📋 Описание проекта

Система состоит из трех основных модулей:

  • 🔄 Парсер данных (parcer.py) — автоматический сбор данных с сайта avtogram.org
  • 🗺️ Анализатор регионов (region.py) — обработка и сопоставление кодов регионов
  • 📊 Генератор рейтингов (reyting.py) — создание статистики и визуализации

✨ Возможности

  • Реальное время: Непрерывный мониторинг автомобильных номеров
  • 🗺️ Полная география: База всех регионов и автономных округов РФ
  • 📊 Визуализация: Автоматическое создание графиков топ-5 регионов
  • 💾 Экспорт данных: Сохранение результатов в CSV формате
  • 🎯 Точная статистика: Подсчет количества автомобилей по регионам

🚀 Установка

Требования

  • Python 3.7+
  • pip (менеджер пакетов Python)

Установка зависимостей

pip install requests beautifulsoup4 matplotlib

Клонирование репозитория

git clone https://github.com/german2285/Staticks.git
cd Staticks

📖 Использование

1. Сбор данных

Запустите парсер для начала сбора данных:

python parcer.py

Парсер будет:

  • Подключаться к сайту avtogram.org каждые 0.2 секунды
  • Извлекать номера автомобилей и коды регионов
  • Сохранять статистику в файл output.csv

2. Анализ регионов

Обработайте собранные данные:

python region.py

Скрипт выведет статистику в формате:

15 машин - Москва
12 машин - Санкт-Петербург
8 машин - Московская область
...

3. Создание рейтинга

Сгенерируйте топ-5 регионов с визуализацией:

python reyting.py

Введите данные в формате количество машин - регион и получите:

  • Сортированный список всех регионов
  • График топ-5 регионов (top5_regions.png)

📁 Структура проекта

Staticks/
├── parcer.py      # Основной парсер данных
├── region.py      # Анализатор регионов
├── reyting.py     # Генератор рейтингов
├── output.csv     # Файл с результатами (создается автоматически)
└── README.md      # Документация проекта

🗺️ Поддерживаемые регионы

Система поддерживает все регионы России, включая:

  • 🏛️ Республики (Татарстан, Башкортостан, Саха-Якутия и др.)
  • 🌲 Края (Краснодарский, Красноярский, Приморский и др.)
  • 🏘️ Области (Московская, Ленинградская, Свердловская и др.)
  • 🏙️ Города федерального значения (Москва, Санкт-Петербург)
  • 🎯 Автономные округа (Ханты-Мансийский, Ямало-Ненецкий и др.)

📊 Формат данных

Входные данные

  • Автоматический парсинг с сайта avtogram.org
  • Извлечение номеров в реальном времени

Выходные данные

  • output.csv — количество и коды регионов
  • top5_regions.png — график топ-5 регионов
  • Консольный вывод статистики

⚙️ Конфигурация

Настройка парсера

В файле parcer.py можно изменить:

  • Интервал опроса (по умолчанию 0.2 сек)
  • Headers для HTTP-запросов
  • URL источника данных

Настройка визуализации

В файле reyting.py можно настроить:

  • Количество топ-регионов (по умолчанию 5)
  • Стиль графика
  • Формат сохранения изображения

🤝 Вклад в проект

Приветствуется участие в развитии проекта! Для внесения изменений:

  1. Сделайте форк репозитория
  2. Создайте ветку для новой функции
  3. Внесите изменения и добавьте тесты
  4. Отправьте Pull Request

📄 Лицензия

Проект распространяется под лицензией MIT. Подробности в файле LICENSE.

👨‍💻 Автор

german2285

🐛 Сообщить об ошибке

Если вы нашли ошибку или у вас есть предложения по улучшению, создайте Issue в репозитории.


⭐ Поставьте звезду, если проект был полезен!

Made with ❤️ for automotive analytics

About

wdwd

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages