org.ggp.base.util.statemachine.sancho.GameCharacteristics Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of alloy-ggp-base Show documentation
A modified version of the GGP-Base library for Alloy.
The newest version!
package org.ggp.base.util.statemachine.sancho;

/**
 * Represents the fixed characteristics of a game, as derived either by static analysis or simulation during
 * meta-gaming.
 */
public class GameCharacteristics
{
//  private static final Logger LOGGER = LogManager.getLogger();

  /**
   * Whether it is ever legal for multiple roles to have the same non-noop move available in any given turn.
   */
  boolean isSimultaneousMove             = false;

  /**
   * Number of roles in the game.
   */
  int     numRoles;

  /**
   * Whether the game always offers the same move choices every turn.
   */
  boolean isIteratedGame                 = false;

  /**
   * Whether these characteristics are based on adequate sampling, or should be considered unreliable
   */
  boolean hasAdequateSampling            = false;

  /**
   * Whether it is ever legal for multiple roles to have non-noop moves in the same turn.  Note that this does not
   * imply that this will be the case in every turn necessarily.
   */
  boolean isPseudoSimultaneousMove       = false;

  /**
   * Whether play strictly alternates between roles, never giving the same role two turns in a row.
   */
  boolean isStrictlyAlternatingPlay      = false;

  /**
   * In a factorized game whether it is possible to have non-noop moves available in more than one factor in any given
   * move.
   */
  boolean moveChoicesFromMultipleFactors = false;

  /**
   * Whether the game may be treated as a puzzle.  This will include all 1-player games,
   * but also multi-player games where actually only our moves have any impact on the
   * state relevant to us
   */
  boolean isPseudoPuzzle                 = false;

  /**
   * Constructor.
   */
  protected GameCharacteristics()
  {
  }

  /**
   * Dump a description of the game characteristics to output logging
   */
  public void report()
  {
//    LOGGER.info("Fixed characteristics");
//
//    if (isIteratedGame)
//    {
//      LOGGER.info("  May be an iterated game");
//    }
//
//    if (isPseudoPuzzle)
//    {
//      LOGGER.info("  Game is a pseudo puzzle");
//    }
//
//    if (isSimultaneousMove)
//    {
//      LOGGER.info("  Game is a simultaneous turn game");
//    }
//    else if (isPseudoSimultaneousMove)
//    {
//      LOGGER.info("  Game is pseudo-simultaneous (factorizable?)");
//    }
//    else
//    {
//      LOGGER.info("  Game is not a simultaneous turn game");
//    }
//
//    if (numRoles == 1)
//    {
//      LOGGER.info("  Game is a 1-player puzzle");
//    }
//    else if (numRoles > 2)
//    {
//      LOGGER.info("  Game is a 3+-player game");
//    }
//    else
//    {
//      LOGGER.info("  Is 2 player game");
//    }
  }
}