159 lines
5.6 KiB
Python
Executable File
159 lines
5.6 KiB
Python
Executable File
# Copyright 2017 The dm_control Authors.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
# ============================================================================
|
|
|
|
"""Planar Walker Domain."""
|
|
|
|
from __future__ import absolute_import
|
|
from __future__ import division
|
|
from __future__ import print_function
|
|
|
|
import collections
|
|
|
|
from dm_control import mujoco
|
|
from dm_control.rl import control
|
|
from local_dm_control_suite import base
|
|
from local_dm_control_suite import common
|
|
from dm_control.suite.utils import randomizers
|
|
from dm_control.utils import containers
|
|
from dm_control.utils import rewards
|
|
|
|
|
|
_DEFAULT_TIME_LIMIT = 25
|
|
_CONTROL_TIMESTEP = .025
|
|
|
|
# Minimal height of torso over foot above which stand reward is 1.
|
|
_STAND_HEIGHT = 1.2
|
|
|
|
# Horizontal speeds (meters/second) above which move reward is 1.
|
|
_WALK_SPEED = 1
|
|
_RUN_SPEED = 8
|
|
|
|
|
|
SUITE = containers.TaggedTasks()
|
|
|
|
|
|
def get_model_and_assets():
|
|
"""Returns a tuple containing the model XML string and a dict of assets."""
|
|
return common.read_model('walker.xml'), common.ASSETS
|
|
|
|
|
|
@SUITE.add('benchmarking')
|
|
def stand(time_limit=_DEFAULT_TIME_LIMIT, random=None, environment_kwargs=None):
|
|
"""Returns the Stand task."""
|
|
physics = Physics.from_xml_string(*get_model_and_assets())
|
|
task = PlanarWalker(move_speed=0, random=random)
|
|
environment_kwargs = environment_kwargs or {}
|
|
return control.Environment(
|
|
physics, task, time_limit=time_limit, control_timestep=_CONTROL_TIMESTEP,
|
|
**environment_kwargs)
|
|
|
|
|
|
@SUITE.add('benchmarking')
|
|
def walk(time_limit=_DEFAULT_TIME_LIMIT, random=None, environment_kwargs=None):
|
|
"""Returns the Walk task."""
|
|
physics = Physics.from_xml_string(*get_model_and_assets())
|
|
task = PlanarWalker(move_speed=_WALK_SPEED, random=random)
|
|
environment_kwargs = environment_kwargs or {}
|
|
return control.Environment(
|
|
physics, task, time_limit=time_limit, control_timestep=_CONTROL_TIMESTEP,
|
|
**environment_kwargs)
|
|
|
|
|
|
@SUITE.add('benchmarking')
|
|
def run(time_limit=_DEFAULT_TIME_LIMIT, random=None, environment_kwargs=None):
|
|
"""Returns the Run task."""
|
|
physics = Physics.from_xml_string(*get_model_and_assets())
|
|
task = PlanarWalker(move_speed=_RUN_SPEED, random=random)
|
|
environment_kwargs = environment_kwargs or {}
|
|
return control.Environment(
|
|
physics, task, time_limit=time_limit, control_timestep=_CONTROL_TIMESTEP,
|
|
**environment_kwargs)
|
|
|
|
|
|
class Physics(mujoco.Physics):
|
|
"""Physics simulation with additional features for the Walker domain."""
|
|
|
|
def torso_upright(self):
|
|
"""Returns projection from z-axes of torso to the z-axes of world."""
|
|
return self.named.data.xmat['torso', 'zz']
|
|
|
|
def torso_height(self):
|
|
"""Returns the height of the torso."""
|
|
return self.named.data.xpos['torso', 'z']
|
|
|
|
def horizontal_velocity(self):
|
|
"""Returns the horizontal velocity of the center-of-mass."""
|
|
return self.named.data.sensordata['torso_subtreelinvel'][0]
|
|
|
|
def orientations(self):
|
|
"""Returns planar orientations of all bodies."""
|
|
return self.named.data.xmat[1:, ['xx', 'xz']].ravel()
|
|
|
|
|
|
class PlanarWalker(base.Task):
|
|
"""A planar walker task."""
|
|
|
|
def __init__(self, move_speed, random=None):
|
|
"""Initializes an instance of `PlanarWalker`.
|
|
|
|
Args:
|
|
move_speed: A float. If this value is zero, reward is given simply for
|
|
standing up. Otherwise this specifies a target horizontal velocity for
|
|
the walking task.
|
|
random: Optional, either a `numpy.random.RandomState` instance, an
|
|
integer seed for creating a new `RandomState`, or None to select a seed
|
|
automatically (default).
|
|
"""
|
|
self._move_speed = move_speed
|
|
super(PlanarWalker, self).__init__(random=random)
|
|
|
|
def initialize_episode(self, physics):
|
|
"""Sets the state of the environment at the start of each episode.
|
|
|
|
In 'standing' mode, use initial orientation and small velocities.
|
|
In 'random' mode, randomize joint angles and let fall to the floor.
|
|
|
|
Args:
|
|
physics: An instance of `Physics`.
|
|
|
|
"""
|
|
randomizers.randomize_limited_and_rotational_joints(physics, self.random)
|
|
super(PlanarWalker, self).initialize_episode(physics)
|
|
|
|
def get_observation(self, physics):
|
|
"""Returns an observation of body orientations, height and velocites."""
|
|
obs = collections.OrderedDict()
|
|
obs['orientations'] = physics.orientations()
|
|
obs['height'] = physics.torso_height()
|
|
obs['velocity'] = physics.velocity()
|
|
return obs
|
|
|
|
def get_reward(self, physics):
|
|
"""Returns a reward to the agent."""
|
|
standing = rewards.tolerance(physics.torso_height(),
|
|
bounds=(_STAND_HEIGHT, float('inf')),
|
|
margin=_STAND_HEIGHT/2)
|
|
upright = (1 + physics.torso_upright()) / 2
|
|
stand_reward = (3*standing + upright) / 4
|
|
if self._move_speed == 0:
|
|
return stand_reward
|
|
else:
|
|
move_reward = rewards.tolerance(physics.horizontal_velocity(),
|
|
bounds=(self._move_speed, float('inf')),
|
|
margin=self._move_speed/2,
|
|
value_at_margin=0.5,
|
|
sigmoid='linear')
|
|
return stand_reward * (5*move_reward + 1) / 6
|