Bardo.Examples.Applications.Flatland.FlatlandSensor (Bardo v0.1.0)

View Source

Sensor implementation for the Flatland simulation.

This module provides sensors that agents can use to perceive the Flatland environment, including vision, smell, and energy sensors.

Summary

Functions

color_scanner(id, n, fanout, cortex_id, scape_name)

Create a color scanner sensor configuration.

distance_scanner(id, n, fanout, cortex_id, scape_name)

Create a distance scanner sensor configuration.

energy(resolution, cortex_id, scape_name)

Creates an energy sensor configuration.

init(params)

Initialize the sensor with provided parameters.

init(id, sensor_type, vl, fanout, cortex_pid, scape_pid, agent_id)

Initialize a new sensor for Flatland (deprecated version).

percept(sensor_type, arg)

Process sensor data to generate output signals.

read(state)

Read data from the sensor.

sense(sensor_type, arg)

Sense the environment for the agent.

smell(radius, types, cortex_id, scape_name)

Creates a smell sensor configuration.

terminate(reason, mod_state)

Terminate the sensor gracefully.

vision(angle_count, range, cortex_id, scape_name)

Creates a vision sensor configuration.

Functions

color_scanner(id, n, fanout, cortex_id, scape_name)

@spec color_scanner(integer(), integer(), integer(), atom(), atom()) :: map()

Create a color scanner sensor configuration.

Parameters:

  • id: Sensor ID
  • n: Number of rays (angles) to scan
  • fanout: Number of output elements
  • cortex_id: ID of the cortex
  • scape_name: Name of the scape

Returns a sensor specification map.

distance_scanner(id, n, fanout, cortex_id, scape_name)

@spec distance_scanner(integer(), integer(), integer(), atom(), atom()) :: map()

Create a distance scanner sensor configuration.

Parameters:

  • id: Sensor ID
  • n: Number of rays (angles) to scan
  • fanout: Number of output elements
  • cortex_id: ID of the cortex
  • scape_name: Name of the scape

Returns a sensor specification map.

energy(resolution, cortex_id, scape_name)

@spec energy(pos_integer(), binary() | atom(), atom()) :: map()

Creates an energy sensor configuration.

Parameters

  • resolution - The number of energy level ranges to detect
  • cortex_id - The ID of the cortex this sensor is connected to
  • scape_name - The name of the scape this sensor will read from

Returns

  • A sensor specification map

init(params)

Initialize the sensor with provided parameters.

Required by the Sensor behavior.

init(id, sensor_type, vl, fanout, cortex_pid, scape_pid, agent_id)

Initialize a new sensor for Flatland (deprecated version).

This function is kept for backward compatibility.

percept(sensor_type, arg)

Process sensor data to generate output signals.

Required by the Sensor behavior.

read(state)

Read data from the sensor.

This function sends a sensing request to the scape and processes the response.

sense(sensor_type, arg)

Sense the environment for the agent.

Required by the Sensor behavior.

smell(radius, types, cortex_id, scape_name)

@spec smell(pos_integer(), pos_integer(), binary() | atom(), atom()) :: map()

Creates a smell sensor configuration.

Parameters

  • radius - The radius of the smell detection area
  • types - The number of different object types to detect
  • cortex_id - The ID of the cortex this sensor is connected to
  • scape_name - The name of the scape this sensor will read from

Returns

  • A sensor specification map

terminate(reason, mod_state)

Terminate the sensor gracefully.

Called when the sensor is being stopped.

vision(angle_count, range, cortex_id, scape_name)

@spec vision(pos_integer(), pos_integer(), binary() | atom(), atom()) :: map()

Creates a vision sensor configuration.

Parameters

  • angle_count - The number of different angles to look in
  • range - The maximum vision range
  • cortex_id - The ID of the cortex this sensor is connected to
  • scape_name - The name of the scape this sensor will read from

Returns

  • A sensor specification map