hSrSSKrSSKJr SSKJr SSKJrJrJ r J r J r SSK J r JrJrJrJr SSKJr SSKJrJrJrJrJr SS KJr SS KJrJrJrJ r SS K!J"r"J#r#J$r$J%r%J&r&J'r'J(r(J)r)J*r*J+r+ SS K,J-r-J.r. /S Qr/SSSSS.r0SSSSS.r1S\24Sjr3g)a? Wrappers are a convenient way to modify an existing environment without having to alter the underlying code directly. Using wrappers will allow you to avoid a lot of boilerplate code and make your environment more modular. Importantly wrappers can be chained to combine their effects and most environments that are generated via :meth:`gymnasium.make` will already be wrapped by default. In order to wrap an environment, you must first initialize a base environment. Then you can pass this environment along with (possibly optional) parameters to the wrapper's constructor. >>> import gymnasium as gym >>> from gymnasium.wrappers import RescaleAction >>> base_env = gym.make("Hopper-v4") >>> base_env.action_space Box(-1.0, 1.0, (3,), float32) >>> wrapped_env = RescaleAction(base_env, min_action=0, max_action=1) >>> wrapped_env.action_space Box(0.0, 1.0, (3,), float32) You can access the environment underneath the **first** wrapper by using the :attr:`gymnasium.Wrapper.env` attribute. As the :class:`gymnasium.Wrapper` class inherits from :class:`gymnasium.Env` then :attr:`gymnasium.Wrapper.env` can be another wrapper. >>> wrapped_env >>>>> >>> wrapped_env.env >>>> If you want to get to the environment underneath **all** of the layers of wrappers, you can use the :attr:`gymnasium.Wrapper.unwrapped` attribute. If the environment is already a bare environment, the :attr:`gymnasium.Wrapper.unwrapped` attribute will just return itself. >>> wrapped_env >>>>> >>> wrapped_env.unwrapped # doctest: +SKIP There are three common things you might want a wrapper to do: - Transform actions before applying them to the base environment - Transform observations that are returned by the base environment - Transform rewards that are returned by the base environment Such wrappers can be easily implemented by inheriting from :class:`gymnasium.ActionWrapper`, :class:`gymnasium.ObservationWrapper`, or :class:`gymnasium.RewardWrapper` and implementing the respective transformation. If you need a wrapper to do more complicated tasks, you can inherit from the :class:`gymnasium.Wrapper` class directly. If you'd like to implement your own custom wrapper, check out `the corresponding tutorial <../../tutorials/gymnasium_basics/implementing_custom_wrappers>`_. N)vector)AtariPreprocessing) AutoresetOrderEnforcingPassiveEnvCheckerRecordEpisodeStatistics TimeLimit) AddWhiteNoiseHumanRendering ObstructView RecordVideoRenderCollection) StickyAction)DelayObservationFrameStackObservationMaxAndSkipObservationNormalizeObservationTimeAwareObservation)NormalizeReward) ClipActionDiscretizeAction RescaleActionTransformAction) AddRenderObservationDiscretizeObservationDtypeObservationFilterObservationFlattenObservationGrayscaleObservationRescaleObservationReshapeObservationResizeObservationTransformObservation) ClipRewardTransformReward)'rrrrrrrrrr#rrrr"r!r rrrrrrr$r%rr rrrrr r rr r ArrayConversion JaxToNumpy JaxToTorch NumpyToTorcharray_conversion jax_to_numpy jax_to_torchnumpy_to_torch)r&r'r(r)rrrzvector.DictInfoToList)AutoResetWrapper FrameStackPixelObservationWrapperVectorListInfo wrapper_namecU[;a-S[U3n[R"U5n[X 5$U[;a[ U<S[US35e[ S[ <SU<35e)aLoad a wrapper by name. This optimizes the loading of gymnasium wrappers by only loading the wrapper if it is used. Errors will be raised if the wrapper does not exist or if the version is not the latest. Args: wrapper_name: The name of a wrapper to load. Returns: The specified wrapper. Raises: AttributeError: If the wrapper does not exist. DeprecatedWrapper: If the version is not the latest. zgymnasium.wrappers.z! has been renamed with `wrappers.`zmodule z has no attribute )_wrapper_to_class importlib import_modulegetattr_renamed_wrapperAttributeError__name__)r2 import_stmtmodules U/home/james-whalen/.local/lib/python3.13/site-packages/gymnasium/wrappers/__init__.py __getattr__r?s"((+,=l,K+LM ((5v,, ) )?@PQ]@^?__` a   78,.@@PQ RR)4__doc__r6gymnasium.wrappersr&gymnasium.wrappers.atari_preprocessingrgymnasium.wrappers.commonrrrrr gymnasium.wrappers.renderingr r r r r"gymnasium.wrappers.stateful_actionr'gymnasium.wrappers.stateful_observationrrrrr"gymnasium.wrappers.stateful_rewardr#gymnasium.wrappers.transform_actionrrrr(gymnasium.wrappers.transform_observationrrrrrrr r!r"r##gymnasium.wrappers.transform_rewardr$r%__all__r5r9strr?r@r>rOs.b%E<?   L/ j*  $ $)5- ScSr@