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, attenuate=True, decorrelation_distance=inf, **kwargs)

Bases: RadarChannelBase[SingleTargetRadarChannelRealization], Serializable

Model of a radar channel featuring a single reflecting target.

Parameters:

• target_range (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 (float | Tuple[float, float]), optional) – Target location azimuth angle in radians, considering spherical coordinates. Zero by default.

• target_zenith (float | Tuple[float, float]), optional) – Target location zenith angle in radians, considering spherical coordinates. Zero by default.

• target_exists (bool, optional) – True if a target exists, False if there is only noise/clutter (default 0 True)

• velocity (float | Tuple[float, float] | np.ndarray , optional) – Velocity as a 3D vector (or as a float), in m/s (default = 0)

• attenuate (bool, optional) – 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.

_realize()

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

recall_realization(group)

Recall a realization of this channel type from its HDF serialization.

Parameters:

group (h5py.Group) – HDF group to which the channel realization was serialized.

Return type:

SingleTargetRadarChannelRealization

Returns: The recalled realization instance.

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)

Bases: RadarChannelRealization

Realization of a single target radar channel.

Generated by the realize method of SingleTargetRadarChannel.

Parameters:

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

static From_HDF(group, target_range_variable, target_azimuth_variable, target_zenith_variable, target_velocity_variable, target_phase_variable, sample_hooks)

Return type:

SingleTargetRadarChannelRealization

to_HDF(group)

Serialize the channel realization to HDF5.

Parameters:

group (Group) – HDF5 group to serialize the channel realization to.

Return type:

None