Power TAC is a competitive simulation designed to support the study of retail electric power markets, especially as they relate to managing distributed renewable power sources. For more information, see http:https://www.powertac.org.

Go to the Power TAC developer's wiki at https://github.com/powertac/powertac-server/wiki for information on design, development, and deployment of the Power TAC simulation server.

PowerTAC is automatically built by Travis CI on new commits and pull requests. Furthermore, maven reports are generated for releases (tags) and commits to the master branch. These reports can subsequently be found at

https://powertac.github.io/index.html

These reports include the JavaDocs, at

https://powertac.github.io/master/apidocs/index.html (replace master with a specific tag if you want a particular release).

This is a multi-module structure, using maven for dependency management and build automation, and using git submodules to tie the pieces together and help create the correct directory structure in a development environment. This module is the root. It contains the parent pom, and the core server module. Other modules include server-interface, accounting, auctioneer, default-broker, distribution-utility, genco, and household-customer.

To populate a development environment, simply clone this repo, then populate the submodules. You can do this with submodule init followed by submodule update (the Pro Git book has a good overview), or you can use the script src/main/scripts/submodule-setup.sh, which lets you specify a remote and branch (typically origin and master). Note that the submodule definitions are contained in the file .gitmodules that the current version of that file contains read-only urls for the modules, and that those may be out-of-date. If you plan to work on the code, you can simply change the URL for an individual module, as in git remote set-url origin [email protected]:powertac/auctioneer.git.

To update your development environment, you can always do

git submodule foreach git pull origin master

Note that some modules, such as common and the Sample Broker, are not submodules of powertac-server. If you need sources for those, you will need to pull them down separately.