Getting Started & Examples

First, see Installation to get the holoocean package and Ocean installed.

A minimal HoloOcean usage example is below:

import holoocean
import numpy as np

env = holoocean.make("PierHarbor-Hovering")

# The hovering AUV takes a command for each thruster
command = np.array([10,10,10,10,0,0,0,0])

for _ in range(180):
   state = env.step(command)

Notice that:

1. You pass the name of a scenario into holoocean.make

   See Packages for all of the different worlds and scenarios that are available.

2. The interface of HoloOcean is designed to be familiar to OpenAI Gym

You can access data from a specific sensor with the state dictionary:

dvl = state["DVLSensor"]

That’s it! HoloOcean is meant to be fairly simple to use.

Check out the different worlds that are available, read the API documentation, or get started on making your own custom scenarios.

Below are some snippets that show how to use different aspects of HoloOcean.

Contents:

• Visualizing RGBCamera Output
• Manually Controlling
• Manually Defining Dynamics
• Custom Scenario Configurations
• Multi Agent Example
• Multi-Agent Communications
• PD Controller
• Visualizing Imaging Sonar
• Visualizing Profiling Sonar
• Visualizing Sidescan Sonar
• Visualizing Singlebeam Sonar

There is also an examples.py in the root of the holoocean repo with more example code.

https://github.com/byu-holoocean/HoloOcean