Metadata-Version: 2.0
Name: AtoD
Version: 0.0.2
Summary: Easy access to DotA2 internal data.
Home-page: https://github.com/gasabr/AtoD
Author: Abroskin Gleb
Author-email: abroskingleb@gmail.com
License: MIT
Keywords: games data DotA2 ml
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Games/Entertainment
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: dota2api
Requires-Dist: pandas
Requires-Dist: sklearn
Requires-Dist: SQLAlchemy
Requires-Dist: yamjam
Requires-Dist: scipy

====
AtoD
====
DotA2 data for ML.

Goals
=====
- create an API to get any DotA related data as easy as possible and ready for ML experiments
- create hero recommendation engine
- create web interface with interactive representation of the info

What and why
============
First of all it's educational project which is created to learn some staff, hope someone will find it useful.

DotA2 API gives you a lot of information about matches, leagues, players,
but there's no way to get the data about game itself: heroes, their abilities etc.
This library helps with this task. And there is short summary of features:

- tools to extract data from in-game files (heroes attributes, abilities specs)
- classes Hero, Ability... to represent the data
- some examples of usage

Usage
=====
Module can be installed through pip:

    pip install atod

To use Match class you should get your own DotA2 API key here_ and add it to
YamJam_ config file which can be found at `~/.yamjam/config.yaml`. If you don't have one
just create it with

    touch ~/.yamjam/config.yaml

.. _here http://steamcommunity.com/dev/apikey
.. _YamJam http://yamjam.readthedocs.io/en/latest/

Examples
========
Please, take a look at jupyter notebooks in `examples/` folder to see how the lib can be used.
Create a hero from name and get some basic info.

    >>> from atod import Hero
    >>> am = Hero.from_name('Anti-Mage')
    >>> am.str
    22
    >>> print(am.abilities)
    <Abilities [<Ability name=mana_break>, <Ability name=blink>, <Ability name=spell_shield>, <Ability name=mana_void>, ]>
    >>> am.lvl = 15
    >>> am.str
    43


The code above creates Anti-Mage, which has some basic attributes: strength (str),
agility, armor all of them are counted at the run-time, so if you will change the
level of hero, attributes will change too.

Other examples of usage of the Hero class can be found at `examples/hero_data.ipynb.`
Auto generated docs can be found at ``docs/doxygen/html/index.html``.


