unienv_interface.wrapper.frame_stack¶
Classes:
| Name | Description |
|---|---|
FrameStackWrapper |
Stack the last |
FrameStackWrapper
¶
FrameStackWrapper(
env: Env[
BArrayType,
ContextType,
ObsType,
ActType,
RenderFrame,
BDeviceType,
BDtypeType,
BRNGType,
],
obs_stack_size: int = 0,
action_stack_size: int = 0,
action_default_value: Optional[ActType] = None,
latest_only_keys: Optional[Sequence[str]] = None,
)
Bases: ContextObservationWrapper[ContextType, Union[Dict[str, Any], Any], BArrayType, ContextType, ObsType, ActType, RenderFrame, BDeviceType, BDtypeType, BRNGType]
Stack the last obs_stack_size + 1 observations (and optionally past actions) along a new time axis.
latest_only_keys (dict observations): top-level keys kept at their latest frame only, with a time axis of
length 1, so obs[key][..., -1]-style indexing still works while large entries (e.g. camera images whose
history the consumer never reads) are not copied obs_stack_size + 1 times.
Methods:
| Name | Description |
|---|---|
reverse_map_context |
|
map_observation |
|
reverse_map_observation |
|
reset |
|
step |
|
render |
|
close |
|
sample_space |
Sample from |
sample_action |
Sample one action from |
sample_observation |
Sample one observation from |
sample_context |
Sample one context value if |
update_observation_post_reset |
Merge masked reset observations back into a full batched observation. |
update_context_post_reset |
Merge masked reset contexts back into a full batched context. |
has_wrapper_attr |
Checks if the given attribute is within the wrapper or its environment. |
get_wrapper_attr |
Gets an attribute from the wrapper and lower environments if |
set_wrapper_attr |
Sets an attribute on this wrapper or lower environment if |
map_context |
Convert wrapped context into the wrapper-facing representation. |
Attributes:
| Name | Type | Description |
|---|---|---|
action_stack_size |
|
|
obs_stack_size |
|
|
action_deque |
|
|
action_default_value |
|
|
latest_only_keys |
|
|
obs_deque |
|
|
latest_deque |
|
|
observation_space |
|
|
metadata |
Dict[str, Any]
|
Returns the :attr: |
render_mode |
Optional[WrapperRenderFrame]
|
|
render_fps |
Optional[int]
|
|
backend |
ComputeBackend[Any, WrapperBDeviceT, Any, WrapperBRngT]
|
|
device |
Optional[WrapperBDeviceT]
|
|
batch_size |
Optional[int]
|
|
action_space |
Space[WrapperActT, WrapperBDeviceT, Any, WrapperBRngT]
|
|
context_space |
Optional[Space[WrapperContextT, WrapperBDeviceT, Any, WrapperBRngT]]
|
|
rng |
WrapperBRngT
|
Returns the :attr: |
unwrapped |
Env
|
Returns the base environment of the wrapper. |
prev_wrapper_layer |
Env[BArrayType, ContextType, ObsType, ActType, RenderFrame, BDeviceType, BDtypeType, BRNGType]
|
|
env |
|
action_deque
instance-attribute
¶
action_deque = SpaceDataQueue(env.action_space, env.batch_size, action_stack_size)
action_space
property
writable
¶
action_space: Space[WrapperActT, WrapperBDeviceT, Any, WrapperBRngT]
context_space
property
writable
¶
context_space: Optional[Space[WrapperContextT, WrapperBDeviceT, Any, WrapperBRngT]]
unwrapped
property
¶
unwrapped: Env
Returns the base environment of the wrapper.
This will be the bare :class:gymnasium.Env environment, underneath all layers of wrappers.
prev_wrapper_layer
property
¶
prev_wrapper_layer: Env[
BArrayType,
ContextType,
ObsType,
ActType,
RenderFrame,
BDeviceType,
BDtypeType,
BRNGType,
]
reverse_map_observation
¶
reverse_map_observation(observation: Union[Dict[str, Any], Any]) -> ObsType
reset
¶
reset(
*args, mask: Optional[BArrayType] = None, seed: Optional[int] = None, **kwargs
) -> Tuple[ContextType, Union[Dict[str, Any], Any], Dict[str, Any]]
step
¶
step(
action: ActType,
) -> Tuple[
Union[Dict[str, Any], Any],
Union[SupportsFloat, BArrayType],
Union[bool, BArrayType],
Union[bool, BArrayType],
Dict[str, Any],
]
sample_context
¶
sample_context() -> Optional[ContextType]
Sample one context value if context_space is defined.
update_observation_post_reset
¶
update_observation_post_reset(
old_obs: ObsType, newobs_masked: ObsType, mask: BArrayType
) -> ObsType
Merge masked reset observations back into a full batched observation.
update_context_post_reset
¶
update_context_post_reset(
old_context: ContextType, new_context: ContextType, mask: BArrayType
) -> ContextType
Merge masked reset contexts back into a full batched context.
has_wrapper_attr
¶
Checks if the given attribute is within the wrapper or its environment.
get_wrapper_attr
¶
Gets an attribute from the wrapper and lower environments if name doesn't exist in this object.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
The variable name to get |
required |
Returns:
| Type | Description |
|---|---|
Any
|
The variable with name in wrapper or lower environments |
set_wrapper_attr
¶
Sets an attribute on this wrapper or lower environment if name is already defined.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
The variable name |
required |
value
|
Any
|
The new variable value |
required |
map_context
¶
map_context(context: WrapperContextT) -> ContextType
Convert wrapped context into the wrapper-facing representation.