Gymnasium 핵심 API — Env 클래스

Gymnasium 핵심 API: Env

gymnasium.Env 는 강화학습 에이전트 환경을 구현하는 메인 클래스입니다. step()reset() 을 통해 환경의 동역학을 캡슐화합니다.

출처: Env — 공식문서

핵심 메서드

  • step(action) — 에이전트 행동으로 환경을 한 타임스텝 진행. 다음 관찰, 보상, 종료 여부, 정보를 반환.
  • reset(seed=None, options=None) — 환경을 초기 상태로 리셋. 에피소드의 첫 관찰과 정보를 반환. seed 로 재현 가능한 샘플링.
  • render() — 환경을 시각화. human/rgb_array/ansi 모드.
  • close() — 환경 정리(렌더링 창, DB·HTTP 연결 닫기).

속성

  • action_space — 유효한 행동을 담는 Space(예: Discrete(2)).
  • observation_space — 유효한 관찰을 담는 Space(예: Box).
  • metadata{'render_modes': [...], 'render_fps': 30} 등 렌더링 메타.
  • specgym.make() 로 환경 초기화에 쓰이는 EnvSpec.
  • unwrapped — 래퍼를 벗긴 기본 환경.

step() 반환값

step(observation, reward, terminated, truncated, info) 를 반환합니다. v0.26 부터 기존 doneterminated(MDP 상 자연 종료)와 truncated(타임리밋 등 외부 제약)로 분리해 RL 부트스트래핑 정확성을 높였습니다.

더 알아보기