Skip to content
Snippets Groups Projects
README.rst 2.03 KiB
Newer Older
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
========
Flatland
========
spmohanty's avatar
spmohanty committed



.. image:: https://gitlab.aicrowd.com/flatland/flatland/badges/master/pipeline.svg
     :target: https://gitlab.aicrowd.com/flatland/flatland/pipelines
     :alt: Test Running
.. image:: https://gitlab.aicrowd.com/flatland/flatland/badges/master/coverage.svg
     :target: https://gitlab.aicrowd.com/flatland/flatland/pipelines
maljx's avatar
maljx committed
     :alt: Test Coverage
spmohanty's avatar
spmohanty committed



Multi Agent Reinforcement Learning on Trains

Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
Getting Started
===============

Generate Docs
--------------
spmohanty's avatar
spmohanty committed

Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
The docs have a lot more details about how to interact with this codebase.  
spmohanty's avatar
spmohanty committed

Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
**TODO**: Mohanty to add atleast a neat outline herefor the contents to the docs here ::
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
    git clone git@gitlab.aicrowd.com:flatland/flatland.git
    cd flatland
    pip install -r requirements_dev.txt
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
* On, Linux and macOS ::
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
    make docs
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
* On, Windows ::
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
    python setup.py develop (or)
    python setup.py install
    python make_docs.py
spmohanty's avatar
spmohanty committed
Features
--------

Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
TODO
spmohanty's avatar
spmohanty committed

Vaibhav Agrawal's avatar
Vaibhav Agrawal committed

Installation
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
============

Stable Release
--------------

To install flatland, run this command in your terminal ::

    pip install flatland-rl
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
This is the preferred method to install flatland, as it will always install the most recent stable release.
Vaibhav Agrawal's avatar
Vaibhav Agrawal committed
If you don’t have `pip <https://pip.pypa.io/en/stable/>`_ installed, this `Python installation guide <https://docs.python-guide.org/starting/installation/>`_ can guide you through the process.


From Sources
------------
The sources for flatland can be downloaded from the `Gitlab repo <https://gitlab.aicrowd.com/flatland/flatland>`_.

You can clone the public repository ::

    $ git clone git@gitlab.aicrowd.com:flatland/flatland.git

Once you have a copy of the source, you can install it with ::

    $ python setup.py install
    
    
Usage
=====
To use flatland in a project ::
    
    import flatland
spmohanty's avatar
spmohanty committed
Authors
--------
* Sharada Mohanty <mohanty@aicrowd.com>
spiglerg's avatar
spiglerg committed
* Giacomo Spigler <giacomo.spigler@gmail.com>
* Mattias Ljungström <ml@mljx.io>
hagrid67's avatar
hagrid67 committed
* Jeremy Watson
Erik Nygren's avatar
Erik Nygren committed
* Erik Nygren <erik.nygren@sbb.ch>
adrian_egli's avatar
adrian_egli committed
* Adrian Egli <adrian.egli@sbb.ch>
maljx's avatar
maljx committed
<please fill yourself in>