Base class

class Scenario

A scenario describes a distribution of World that can be sampled to perform an experiment.

class Group

A group of agents that can be generated and added to the world.

add_to_world(world: navground.sim.NativeWorld, seed: int | None = None) → None

Generate and add agents to the world.

Parameters:

• world – The world

• seed – An optional random seed

add_init(initializer: Callable) → str

Adds a world initializer.

Parameters:

initializer – The initializer

Returns:

The associated key

clear_inits() → None

Removed all initializers

dump(::sim::Scenario) → str

Dumps the object to a YAML-string.

Returns:

The YAML representation

Return type:

str

get(name: str) → bool | int | float | str | Vector2 | list[bool] | list[int] | list[float] | list[str] | list[Vector2]

Gets the value of the specified property.

Parameters:

name – The name of the property

Raise:

std::runtime_error A runtime error if no property is found.

Returns:

The value of the property

static has_type(name: str) → bool

Check whether a type name has been registered.

Parameters:

type – The associated type name.

Returns:

True if the type name has been registered.

init_world(world: navground.sim.NativeWorld, seed: int | None = None) → None

Initializes the world.

Parameters:

• world – The world

• seed – The random seed

static load(value: str) → object

Load a scenario modulation from a YAML string.

Returns:

The loaded scenario or None if loading fails.

Return type:

Scenario| None

static make_type(name: str) → object

Create an object of a sub-class selected by name.

Parameters:

type – The associated type name.

Returns:

An object of a registered sub-class or None in case the desired name is not found.

make_world(seed: int | None = None) → navground.sim.NativeWorld

Creates and initialize a world.

Parameters:

seed – The random seed

static register_schema() → object

Returns the json-schema that includes registered components.

Returns:

“anyOf” json-schema of all registered components.

Return type:

dict[str, typing.Any]

remove_init(key: str) → None

Remove the last added world initializer.

Parameters:

key – The key

static schema(reference_register_schema: bool = True, type: str | None = None) → object

Returns the json-schema of a component

Returns an empty dictionary if a not registered type is requested.

Parameters:

• reference_register_schema – Whether to reference registered components schema in the base class schema.

• type (str) – An optional registered type. If not specified, it returns the schema of the base class.

Returns:

A json-schema of the registered class

Return type:

dict[str, typing.Any]

set(name: str, value: bool | int | float | str | Vector2 | list[bool] | list[int] | list[float] | list[str] | list[Vector2]) → None

Set the value of a named property. Fails silently if no property can be found or if the value has a non-compatible type.

Parameters:

• name – The name of the property

• value – The desired value for the property

set_init(key: str, initializer: Callable) → None

Sets a world initializer.

Parameters:

• key – The key

• initializer – The initializer

set_yaml(value: str) → None

Sets the yaml representation

property bounding_box

Type:

Optional[navground.sim.BoundingBox]

An optional bounding box

property groups

Type:

list[navground.sim.Scenario.Group]

Groups

property inits

Type:

dict[str, Callable[[navground.sim.NativeWorld, Optional[int]], None]]

The world initializers.

property obstacles

Type:

list[navground.core.Disc]

Obstacles

property properties

Type:

dict[str, navground.core.Property]

The registered properties

property type

Type:

str

The name associated to the type of an object

property walls

Type:

list[navground.core.LineSegment]

Walls to add