Pong with Neural Network

Content:

1. The Software
2. Getting Started
3. Built with
4. Contributing
5. Developers
6. License
7. Acknowledgements

The software

This is a university project were we try to get a better understanding of machine learning and neural networks. We have made a basic pong game in Java. We will try and use a neural network to learn and play the game.

More information in the wiki.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

You need to have Java JDK installed. In addition to any IDE supporting java, we recommend: Netbeans or IntelliJ.

You find Java JDK 8 here: Oracle.com

You find Netbeans here: Netbeans.org

Or IntilliJ here: Jetbrains.com

Installation

A step by step guide for getting the project up and running.

1. Download the repository.

2. Download the neuroph 2.94 library from [here](http://neuroph.sourceforge.net/download.html).

3. Open the PongNnReborn project in your IDE of choice (we used Netbeans). 

4. Apply the needed libraries from the Neuroph download.

   Neuroph (Needed):

   * Neuroph-adapters
   * Neuroph-contrib
   * Neuroph-core
   * Neuroph-ocr

   Neuroph dependencies (Needed):

   * Ajt
   * Java-ML
   * Logback-core
   * Sfl4-API
   * Sfl4-NOP
   * Weka

   Neuroph (Optional):

   * Neuroph-samples
   * Neuroph-samples-Javadoc
   * Neuroph-adapters-Javadoc
   * Neuroph-contrib-Javadoc
   * Neuroph-core-Javadoc
   * Neuroph-ocr-Javadoc
   

5. Try starting the software by compiling it with the IDE.

6. Use 1-4 and space to change the setting in the pong start menu.

7. Start the game, and enjoy a neural network playing agains a bot, or a human.

8. You can now edit/change the program has much as you would like. You can even fork the project to create your own version.

9. Check out the contribution page for more information on cotribution to the official proram. 

Built With

NetBeans - Webpage

Neuroph 2.94 - Webpage

Java 8 - Webpage

Contributing

Contributing

Developers

Moe, Kim Arild

Sakseid, Vegar

Røren, Tønnes Tobias Pedersen

License

Collection of licenses applicable to the project.

Our

Licensed under MIT license.

3rd Party:

Neuroph - Apache 2.0 License

Neuroph uses:

• Abeel Java Toolkit (AJT) GNU Library or Lesser General Public License version 3.0 (LGPLv3)

• Java Machine Learning Library (Java-ML) GNU Library or Lesser General Public License version 3.0 (LGPLv3)

• Weka 3: Data Mining Software GNU Library or Lesser General Public License version 3.0 (LGPLv3)

• Logback - Eclipse Public License v1.0

Acknowledgements

• Hat tip to anyone who's code was used. 🎩

• Neuroph for having an open source neural network. 🤖

• Other thanks:

  • fabiorino for having an example on how to implement neural networks in pong, with java - Example. 😚
  • Neuroh again for having sample projects to help us with the program - Samples. 🌐

• License creators, for letting everyone use thier licenses free of charge. 📃