Skip to content

Commit

Permalink
style(model-based): fix mypy and polish api docstring (#244)
Browse files Browse the repository at this point in the history
  • Loading branch information
Gaiejj authored May 26, 2023
1 parent 651cb0e commit 74e9527
Show file tree
Hide file tree
Showing 37 changed files with 1,404 additions and 542 deletions.
33 changes: 33 additions & 0 deletions docs/source/baserlapi/model_based.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
Base Model-based Algorithms
===========================

.. currentmodule:: omnisafe.algorithms.model_based.base


LOOP
----

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: LOOP
:members:
:private-members:

PETS
----

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: PETS
:members:
:private-members:
24 changes: 24 additions & 0 deletions docs/source/envs/adapter.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,16 @@ OmniSafe Adapter

.. currentmodule:: omnisafe.adapter

OmniSafe provides a set of adapters to adapt the environment to the framework.

.. autosummary::

OnlineAdapter
OnPolicyAdapter
OffPolicyAdapter
SauteAdapter
SimmerAdapter
ModelBasedAdapter

Online Adapter
--------------
Expand Down Expand Up @@ -73,3 +83,17 @@ Simmer Adapter
.. autoclass:: SimmerAdapter
:members:
:private-members:

Model-based Adapter
-------------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: ModelBasedAdapter
:members:
:private-members:
18 changes: 18 additions & 0 deletions docs/source/envs/mujoco_env.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
Mujoco Environment
==================

.. currentmodule:: omnisafe.envs.mujoco_env

MujocoEnv Interface
-------------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: MujocoEnv
:members:
:private-members:
16 changes: 16 additions & 0 deletions docs/source/envs/safety_gymnasium.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,3 +16,19 @@ Safety Gymnasium Interface
.. autoclass:: SafetyGymnasiumEnv
:members:
:private-members:

.. currentmodule:: omnisafe.envs.safety_gymnasium_modelbased

Safety Gymnasium World Model
----------------------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: SafetyGymnasiumModelBased
:members:
:private-members:
13 changes: 13 additions & 0 deletions docs/source/envs/wrapper.rst
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,19 @@ Action Scale
:members:
:private-members:

Action Repeat
-------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: ActionRepeat
:members:
:private-members:

Unsqueeze Wrapper
-----------------
Expand Down
5 changes: 5 additions & 0 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -395,6 +395,7 @@ this project, don't hesitate to ask your question on `the GitHub issue page <htt

baserlapi/on_policy
baserlapi/off_policy
baserlapi/model_based

.. toctree::
:hidden:
Expand All @@ -405,6 +406,7 @@ this project, don't hesitate to ask your question on `the GitHub issue page <htt
saferlapi/second_order
saferlapi/lagrange
saferlapi/penalty_function
saferlapi/model_based

.. toctree::
:hidden:
Expand Down Expand Up @@ -439,6 +441,8 @@ this project, don't hesitate to ask your question on `the GitHub issue page <htt
model/actor
model/critic
model/actor_critic
model/modelbased_model
model/modelbased_planner

.. toctree::
:hidden:
Expand All @@ -448,6 +452,7 @@ this project, don't hesitate to ask your question on `the GitHub issue page <htt
envs/core
envs/wrapper
envs/safety_gymnasium
envs/mujoco_env
envs/adapter


Expand Down
85 changes: 85 additions & 0 deletions docs/source/model/modelbased_model.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
OmniSafe Model-based Model
==========================

.. currentmodule:: omnisafe.algorithms.model_based.base.ensemble

Standard Scaler
---------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: StandardScaler
:members:
:private-members:

Initialize Weight
-----------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autofunction:: init_weights

Unbatched Forward
-----------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autofunction:: unbatched_forward

Ensemble Fully-Connected Layer
------------------------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: EnsembleFC
:members:
:private-members:

Ensemble Model
--------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: EnsembleModel
:members:
:private-members:


Ensemble Dynamics Model
-----------------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: EnsembleDynamicsModel
:members:
:private-members:
89 changes: 89 additions & 0 deletions docs/source/model/modelbased_planner.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
OmniSafe Model-based Planner
============================

.. currentmodule:: omnisafe.algorithms.model_based.planner

ARC Planner
-----------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: ARCPlanner
:members:
:private-members:

CAP Planner
-----------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: CAPPlanner
:members:
:private-members:

CCE Planner
-----------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: CCEPlanner
:members:
:private-members:

CEM Planner
-----------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: CEMPlanner
:members:
:private-members:

RCE Planner
-----------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: RCEPlanner
:members:
:private-members:


SafeARC Planner
---------------

.. card::
:class-header: sd-bg-success sd-text-white
:class-card: sd-outline-success sd-rounded-1

Documentation
^^^

.. autoclass:: SafeARCPlanner
:members:
:private-members:
2 changes: 0 additions & 2 deletions docs/source/saferlapi/first_order.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,8 @@ First Order Algorithms
FOCOPS
CUP


.. _focopsapi:


FOCOPS
------

Expand Down
Loading

0 comments on commit 74e9527

Please sign in to comment.