Single Target¶

Model of a radar channel featuring a single reflecting target.

The following minimal example outlines how to configure the channel model within the context of a Simulation:

# Initialize a single device operating at 78.5 GHz
simulation = Simulation(seed=42)
device = simulation.new_device(carrier_frequency=78.5e9)

# Create a radar channel modeling a single target at 10m distance
channel = SingleTargetRadarChannel(10, 1, attenuate=False)
simulation.set_channel(device, device, channel)

# Configure an FMCW radar with 5 GHz bandwidth illuminating the target
radar = Radar(FMCW(10, 5e9, 90 / 5e9, 100 / 5e9))
device.add_dsp(radar)

# Configure a simulation evluating the radar's operating characteristics
simulation.add_evaluator(ReceiverOperatingCharacteristic(radar, device, device, channel))
simulation.new_dimension('noise_level', dB(np.arange(0, -22, -2).tolist()), device)
simulation.num_samples = 1000

# Run simulation and plot resulting ROC curve
result = simulation.run()
result.plot()

class SingleTargetRadarChannel(target_range, radar_cross_section, target_azimuth=0.0, target_zenith=0.0, target_exists=True, velocity=0.0, decorrelation_distance=inf, attenuate=True, gain=1.0, seed=None)[source]¶

Bases: RadarChannelBase[SingleTargetRadarChannelRealization], Serializable

Model of a radar channel featuring a single reflecting target.

Parameters:

target_range (Union[float, Tuple[float, float]]) – Absolute distance of target and radar sensor in meters. Either a specific distance or a range of minimal and maximal target distance.
radar_cross_section (float) – Radar cross section (RCS) of the assumed single-point reflector in m**2
target_azimuth (Union[float, Tuple[float, float]]) – Target location azimuth angle in radians, considering spherical coordinates. Zero by default.
target_zenith (Union[float, Tuple[float, float]]) – Target location zenith angle in radians, considering spherical coordinates. Zero by default.
target_exists (bool) – True if a target exists, False if there is only noise/clutter (default 0 True)
velocity (Union[float, Tuple[float, float], ndarray]) – Velocity as a 3D vector (or as a float), in m/s (default = 0)
decorrelation_distance (float) – Distance at which channel samples are considered to be uncorrelated. \(\infty\) by default, i.e. the channel is considered to be fully correlated in space.
attenuate (bool) – If True, then signal will be attenuated depending on the range, RCS and losses. If False, then received power is equal to transmit power.

Raises:

ValueError – If radar_cross_section < 0. If carrier_frequency <= 0. If more than one antenna is considered.

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:: SingleTargetRadarChannel
Returns:: The deserialized object.

_realize()[source]¶

Generate a new channel realzation.

Abstract subroutine of realize. Each Channel is required to implement their own _realize() method.

Returns: A new channel realization.

Return type:: SingleTargetRadarChannelRealization

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

property decorrelation_distance: float¶

Decorrelation distance of the channel.

Raises:: ValueError – If the decorrelation distance is smaller than zero.

property radar_cross_section: float¶

Access configured radar cross section.

Returns:: radar cross section [m**2]
Return type:: float

property target_azimuth: float | Tuple[float, float]¶

Target position azimuth in spherical coordiantes.

Returns:: Azimuth angle in radians.

property target_exists: bool¶: Does an illuminated target exist?

property target_range: float | Tuple[float, float]¶

Absolute distance of target and radar sensor.

Returns: Target range in meters.

Raises:: ValueError – If the range is smaller than zero.

property target_velocity: float | Tuple[float, float] | ndarray¶

Perceived target velocity.

Returns: Velocity in m/s.

property target_zenith: float | Tuple[float, float]¶

Target position zenith in spherical coordiantes.

Returns:: Zenith angle in radians.

class SingleTargetRadarChannelRealization(consistent_realization, target_range_variable, target_azimuth_variable, target_zenith_variable, target_velocity_variable, target_phase_variable, target_range, target_azimuth, target_zenith, target_cross_section, target_velocity, attenuate, sample_hooks, gain)[source]¶

Bases: RadarChannelRealization

Realization of a single target radar channel.

Generated by realizing a SingleTargetRadarChannel.

Parameters:: gain (float) – Linear power gain factor a signal experiences when being propagated over this realization.