# Copyright 2022 DeepMind Technologies Limited # # 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. # ============================================================================== """Python bindings for the Simulate GUI.""" import atexit import code import inspect import math import os import threading import time from typing import Callable, Optional, Union import glfw import mujoco from mujoco import _simulate import numpy as np if not glfw._glfw: # pylint: disable=protected-access raise RuntimeError('GLFW dynamic library handle is not available') else: _simulate.setglfwdlhandle(glfw._glfw._handle) # pylint: disable=protected-access # Logarithmically spaced realtime slow-down coefficients (percent). PERCENT_REALTIME = ( 100, 80, 66, 50, 40, 33, 25, 20, 16, 13, 10, 8, 6.6, 5, 4, 3.3, 2.5, 2, 1.6, 1.3, 1, 0.8, 0.66, 0.5, 0.4, 0.33, 0.25, 0.2, 0.16, 0.13, 0.1 ) # Maximum time mis-alignment before re-sync. MAX_SYNC_MISALIGN = 0.1 # Fraction of refresh available for simulation. SIM_REFRESH_FRACTION = 0.7 CallbackType = Callable[[mujoco.MjModel, mujoco.MjData], None] LoaderType = Callable[[], tuple[mujoco.MjModel, mujoco.MjData]] # Loader function that also returns a file path for the GUI to display. _LoaderWithPathType = Callable[[], tuple[mujoco.MjModel, mujoco.MjData, str]] _InternalLoaderType = Union[LoaderType, _LoaderWithPathType] Simulate = _simulate.Simulate def _file_loader(path: str) -> _LoaderWithPathType: """Loads an MJCF model from file path.""" def load(path=path) -> tuple[mujoco.MjModel, mujoco.MjData, str]: m = mujoco.MjModel.from_xml_path(path) d = mujoco.MjData(m) return m, d, path return load def _physics_loop(simulate: Simulate, loader: Optional[_InternalLoaderType]): """Physics loop for the Simulate GUI, to be run in a separate thread.""" m: mujoco.MjModel = None d: mujoco.MjData = None ctrlnoise = np.array([]) reload = True # CPU-sim synchronization point. synccpu = 0.0 syncsim = 0.0 # Run until asked to exit. while not simulate.exitrequest: if simulate.droploadrequest: simulate.droploadrequest = 0 loader = _file_loader(simulate.dropfilename) reload = True if simulate.uiloadrequest: simulate.uiloadrequest_decrement() reload = True if reload and loader is not None: try: load_tuple = loader() except Exception as e: # pylint: disable=broad-except simulate.load_error = str(e) else: # Do not assign to m and d until simulate.load is done! # This is because simulate.load needs to clean up mjvScene and # mjrContext. This cleanup logic requires access to the old m and d. new_m, new_d = load_tuple[:2] # If the loader does not raise an exception then we assume that it # successfully created mjModel and mjData. This is specified in the type # annotation, but we perform a runtime assertion here as well to prevent # possible segmentation faults. assert new_m is not None and new_d is not None path = load_tuple[2] if len(load_tuple) == 3 else '' simulate.load(path, new_m, new_d) # We can now allow the old m and d to be deleted. m, d = new_m, new_d mujoco.mj_forward(m, d) ctrlnoise = np.zeros((m.nu,)) reload = False # Sleep for 1 ms or yield, to let main thread run. if simulate.run != 0 and simulate.busywait != 0: time.sleep(0) else: time.sleep(0.001) with simulate.lock(): if m is not None: assert d is not None if simulate.run: # Record CPU time at start of iteration. startcpu = glfw.get_time() elapsedcpu = startcpu - synccpu elapsedsim = d.time - syncsim # Inject noise. if simulate.ctrlnoisestd != 0.0: # Convert rate and scale to discrete time (Ornstein–Uhlenbeck). rate = math.exp(-m.opt.timestep / simulate.ctrlnoiserate) scale = simulate.ctrlnoisestd * math.sqrt(1 - rate * rate) for i in range(m.nu): # Update noise. ctrlnoise[i] = ( rate * ctrlnoise[i] + scale * mujoco.mju_standardNormal(None)) # Apply noise. d.ctrl[i] = ctrlnoise[i] # Requested slow-down factor. slowdown = 100 / PERCENT_REALTIME[simulate.real_time_index] # Misalignment: distance from target sim time > MAX_SYNC_MISALIGN. misaligned = abs(elapsedcpu / slowdown - elapsedsim) > MAX_SYNC_MISALIGN # Out-of-sync (for any reason): reset sync times, step. if (elapsedsim < 0 or elapsedcpu < 0 or synccpu == 0 or misaligned or simulate.speed_changed): # Re-sync. synccpu = startcpu syncsim = d.time simulate.speed_changed = False # Clear old perturbations, apply new. d.xfrc_applied[:, :] = 0 simulate.applyposepertubations(0) # Move mocap bodies only. simulate.applyforceperturbations() # Run single step, let next iteration deal with timing. mujoco.mj_step(m, d) # In-sync: step until ahead of cpu. else: measured = False prevsim = d.time refreshtime = SIM_REFRESH_FRACTION / simulate.refresh_rate # Step while sim lags behind CPU and within refreshtime. while (((d.time - syncsim) * slowdown < (glfw.get_time() - synccpu)) and ((glfw.get_time() - startcpu) < refreshtime)): # Measure slowdown before first step. if not measured and elapsedsim: simulate.measured_slowdown = elapsedcpu / elapsedsim measured = True # Clear old perturbations, apply new. d.xfrc_applied[:, :] = 0 simulate.applyposepertubations(0) # Move mocap bodies only. simulate.applyforceperturbations() # Call mj_step. mujoco.mj_step(m, d) # Break if reset. if d.time < prevsim: break else: # simulate.run is False: GUI is paused. # Apply pose perturbation. simulate.applyposepertubations(1) # Move mocap and dynamic bodies. # Run mj_forward, to update rendering and joint sliders. mujoco.mj_forward(m, d) def _launch_internal(model: Optional[mujoco.MjModel] = None, data: Optional[mujoco.MjData] = None, *, run_physics_thread: bool = True, loader: Optional[_InternalLoaderType] = None) -> None: """Internal API, so that the public API has more readable type annotations.""" if model is None and data is not None: raise ValueError('mjData is specified but mjModel is not') elif callable(model) and data is not None: raise ValueError( 'mjData should not be specified when an mjModel loader is used') elif loader is not None and model is not None: raise ValueError('model and loader are both specified') if loader is None and model is not None: def _loader(m=model, d=data) -> tuple[mujoco.MjModel, mujoco.MjData]: if d is None: d = mujoco.MjData(m) return m, d loader = _loader # The simulate object encapsulates the UI. simulate = Simulate() # Initialize GLFW. if not glfw.init(): raise mujoco.FatalError('could not initialize GLFW') atexit.register(glfw.terminate) if run_physics_thread: physics_thread = threading.Thread( target=_physics_loop, args=(simulate, loader)) physics_thread.start() simulate.renderloop() if run_physics_thread: physics_thread.join() def launch(model: Optional[mujoco.MjModel] = None, data: Optional[mujoco.MjData] = None, *, run_physics_thread: bool = True, loader: Optional[LoaderType] = None) -> None: """Launches the Simulate GUI.""" _launch_internal( model, data, run_physics_thread=run_physics_thread, loader=loader) def launch_from_path(path: str) -> None: """Launches the Simulate GUI from file path.""" _launch_internal(loader=_file_loader(path)) def launch_repl(model: mujoco.MjModel, data: mujoco.MjData) -> None: """EXPERIMENTAL FEATURE: Launches the Simulate GUI in REPL mode.""" try: import IPython # pylint: disable=g-import-not-at-top has_ipython = True except ImportError: has_ipython = False def start_shell(global_variables): if has_ipython and IPython.get_ipython() is not None: locals().update(global_variables) IPython.embed() else: code.InteractiveConsole(locals=global_variables).interact() repl_thread = threading.Thread( target=start_shell, args=(inspect.stack()[1][0].f_globals,)) repl_thread.start() launch(model, data, run_physics_thread=False) repl_thread.join() if __name__ == '__main__': from absl import app # pylint: disable=g-import-not-at-top from absl import flags # pylint: disable=g-import-not-at-top _MJCF_PATH = flags.DEFINE_string('mjcf', None, 'Path to MJCF file.') def main(argv) -> None: del argv if _MJCF_PATH.value is not None: launch_from_path(os.path.expanduser(_MJCF_PATH.value)) else: launch() app.run(main)