eve-analytics 0.0.17

Analytics package for eve online

eve-analytics

eve-analytics is a Python package for parsing EVE Online combat logs and turning them into structured data and visual diagrams.

It helps you go from raw .txt logs → usable datasets → insights about fights, fleets, and pilot activity.

The package utilizing a SQLite DB to store log data and integrate Eve Online SDE.

---

Features

• Parse EVE combat log files into structured data
  • json & dfs
• Aggregate events like:
  • Damage (dmg)
  • Neutralizers / Nosferatu (neut, nos)
  • Repairs (reps, cap_reps)
  • Electronic warfare (jams, scrams)
  • Drones, reloads, links, and more
• Build datasets for analysis and visualization
• Designed to support diagram generation (fleet and pilot diagrams, timelines, etc.)

---

Installation

pip install eve-analytics

Quick Start

from eve_analytics import EveAnalytics

ea = EveAnalytics(log_directory="/path/to/logs")
ea.parse_logs()
ea.load_db()
ea.generate_analytics('a_match_id')
ea.save_analytics(save_dir="/path/to/save")

---

Setting the Log Directory

You can initialize with a directory:

ea = EveAnalytics(log_directory="/path/to/logs")

Or set it later:

ea = EveAnalytics()
ea.set_log_directory("/path/to/logs")

---

Supported Log Data

Each parsed log may include:

• dmg — damage events
• reps — repair events
• neut / nos — capacitor warfare
• jams — ECM events
• scrams — tackle events
• drones — drone activity
• reloads — weapon reloads
• links — command bursts
• cap_warning — capacitor warnings
• skipped — unparsed/ignored lines

---

Error Handling

The package includes custom exceptions:

• LogLocationError — invalid directory path
• LogDirectoryNotSetError — parsing attempted without setting a directory
• MissingSDEError -- sde files are missing

---

Project Structure

eve_analytics/
├── ingest/
│   └── splicer.py
├── exceptions/
│   └── file_errors.py
├── __init__.py

---

Roadmap

• Diagram generation (timeline / fleet engagement visuals)
• Aggregated fight summaries
• Pilot-level statistics
• Export to CSV / Pandas DataFrames
• Visualization integrations (matplotlib / web UI)

---

Contributing

Contributions are welcome. Open an issue or submit a PR.

---

License

MIT License

---

Disclaimer

EveAnalytics is a third-party tool and is not affiliated with CCP Games or EVE Online.