Tennis¶

This environment is part of the Atari environments. Please read that page first for general information.

Import	`from pettingzoo.atari import tennis_v3`
Actions	Discrete
Parallel API	Yes
Manual Control	No
Agents	`agents= ['first_0', 'second_0']`
Agents	2
Action Shape	(1,)
Action Values	[0,17]
Observation Shape	(210, 160, 3)
Observation Values	(0,255)

A competitive game of positioning and prediction. Goal: Get the ball past your opponent. Don’t let the ball get past you. When a point is scored (by the ball exiting the area), you get +1 reward and your opponent gets -1 reward. Unlike normal tennis matches, the number of games won is not directly rewarded.

Serves are timed: If the player does not serve within 3 seconds of receiving the ball, they receive -1 points, and the timer resets. This prevents one player from indefinitely stalling the game, but also means it is no longer a purely zero-sum game.

Official tennis manual

Environment parameters¶

Environment parameters are common to all Atari environments and are described in the base multi-agent environment documentation.

Action Space¶

In any given turn, an agent can choose from one of 18 actions.

Value	Meaning	Value	Meaning	Value	Meaning
`0`	`NOOP`	`1`	`FIRE`	`2`	`UP`
`3`	`RIGHT`	`4`	`LEFT`	`5`	`DOWN`
`6`	`UPRIGHT`	`7`	`UPLEFT`	`8`	`DOWNRIGHT`
`9`	`DOWNLEFT`	`10`	`UPFIRE`	`11`	`RIGHTFIRE`
`12`	`LEFTFIRE`	`13`	`DOWNFIRE`	`14`	`UPRIGHTFIRE`
`15`	`UPLEFTFIRE`	`16`	`DOWNRIGHTFIRE`	`17`	`DOWNLEFTFIRE`

See environment specification to see more information on the action meaning.

Version History¶

v3: Minimal Action Space (1.18.0)
v2: No action timer (1.9.0)
v1: Breaking changes to entire API (1.4.0)
v0: Initial versions release (1.0.0)