Device Focus¶

Device focus is only available during simulations and enables beamformers to automatically focus towards any simulated device of interest.

class DeviceFocus(focused_device)[source]¶

Bases: BeamFocus

Focus point targeting a device.

classmethod Deserialize(process)[source]¶

Deserialize an object’s state.

Objects cannot be deserialized directly, instead a Factory must be instructed to carry out the deserialization process.

Parameters:: process (DeserializationProcess) – The current stage of the deserialization process. This object is generated by the Factory and provides an interface to deserialization methods supporting multiple backends.
Return type:: DeviceFocus
Returns:: The deserialized object.

Create a copy of this focus point.

serialize(process)[source]¶

Serialize this object’s state.

Objects cannot be serialized directly, instead a Factory must be instructed to carry out the serialization process.

Parameters:: process (SerializationProcess) – The current stage of the serialization process. This object is generated by the Factory and provides an interface to serialization methods supporting multiple backends.
Return type:: None

spherical_angles(device)[source]¶

Compute azimuth and zenith angles in radians, towards a beam is focused.

Parameters:: device (State) – State of the device the beamformer is operating on.
Return type:: ndarray
Returns:: Numpy vector with the azimuth and zenith angles in radians from the device’s point of view.

property focused_device: SimulatedDevice¶: Device being focused by the beamformer.