An instance of this class quantitatively models the multiple false targets that will be perceived by. More...

#include <WsfFalseTarget.hpp>

Inheritance diagram for WsfFalseTarget:

Collaboration diagram for WsfFalseTarget:

Classes
struct	JammerState
struct	BaseData
struct	ExtentPair

Public Types
enum	PlatformBehavior { cRANDOM_TO_MULTIPLE_PLATFORMS , cCONSISTENT_TO_MULTIPLE_PLATFORMS }
enum	RadarBehavior { cRANDOM_TO_MULTIPLE_RADARS , cCONSISTENT_TO_MULTIPLE_RADARS }
	"RadarBehavior" describes the observed time-variant behavior for the false-target blips among different radar sites: More...
enum	BlipBehavior { cRANDOM_SCAN_TO_SCAN , cCONSISTENT_SCAN_TO_SCAN }
enum	BlipDistribution { cRANDOM , cCIRCULAR , cSECTORED }
	"BlipDistribution" appearance describes how the false targets are spread over an area surrounding a radar site. More...
enum	RangeDistribution { cUNIFORM , cLOG , cEXPONENTIAL }
	"RangeDistribution" describes how the false targets are spread over the range from the radar site. More...
enum	OnOffState { cOn , cOff }
	OnOffState indicates what the state of this false target technique. More...
enum	ReferenceBearing { cJAMMER , cNORTH , cPROTECTED_ENTITY }
	ReferenceBearing indicates what the reference angle for zero azimuth is. More...
enum	BlipReference { cBR_NONE , cBR_JAMMER }
using	Blip = WsfFalseTargetBlip
using	RadarSnsrPair = std::pair<WsfStringInt, WsfStringInt>
using	ExtentData = std::vector<ExtentPair>
using	BaseLocsVec = std::vector<BaseData>
using	Blips = std::vector<WsfFalseTargetBlip*>
using	BlipsIterators = std::vector<Blips::iterator>
using	JammerIdToBlipsMap = std::map<unsigned int, Blips>
using	JammerIdToStateMap = std::map<unsigned int, JammerState>
using	ScreenerPtrJammerXmtrPtr = std::pair<WsfFalseTargetScreener, WsfEM_Xmtr>
using	BlipStateVec = std::vector<ScreenerPtrJammerXmtrPtr>
Public Types inherited from WsfObject
typedef std::vector< WsfStringId >	TypeList
	The list of types returned by GetTypeList.

Public Member Functions
	WsfFalseTarget (WsfScenario &aScenario)
	WsfFalseTarget (const WsfFalseTarget &aSrc)
WsfFalseTarget &	operator= (const WsfFalseTarget &)=delete
	~WsfFalseTarget () override
WsfFalseTarget *	Clone () const override
virtual bool	Initialize (WsfSimulation *aSimulationPtr)
bool	ProcessInput (UtInput &aInput) override
virtual void	Update (double aSimTime, WsfEM_Xmtr *aJammerXmtrPtr)
bool	Initialize (double aSimTime, WsfEM_Xmtr *aJammerXmtrPtr)
void	Reset ()
BlipBehavior	GetBlipBehavior () const
RadarBehavior	GetRadarBehavior () const
PlatformBehavior	GetPlatformBehavior () const
double	GetScanInterval () const
bool	GetNewBlipsState (WsfFalseTargetScreener aScreenerPtr, WsfEM_Xmtr aJammerXmtrPtr)
void	SetNewBlipsState (WsfFalseTargetScreener aScreenerPtr, WsfEM_Xmtr aJammerXmtrPtr, bool aState)
virtual void	ClearAllBlips ()
virtual void	ClearBlips (unsigned int aJammerId)
Blips &	GetBlips (unsigned int aJammerId)
Blip *	GetBlipPtr (WsfStringId aBlipNameId, unsigned int aJammerId)
Blip *	GetBlipPtr (size_t aBlipUniqueId, unsigned int aJammerId)
bool	GetBlipsCreated (unsigned int aJammerId)
void	CreateBlipNameId (Blip *aBlipPtr)
void	SetBlipBehavior (BlipBehavior aBlipBehavior)
void	SetRadarBehavior (RadarBehavior aRadarBehavior)
void	SetPlatformBehavior (PlatformBehavior aPlatformBehavior)
void	SetScanInterval (double aScanInterval)
void	SetPersistence (double aPersistence)
void	SetInitialNumberOfFTs (unsigned int aInitialNumberOfFTs, bool aIsExplicit=false)
void	SetAzimuthExtent (double aAzLower, double aAzUpper)
void	SetRangeExtent (double aRangeLower, double aRangeUpper)
void	SetBlipSpeeds (double aMinSpeed, double aMaxSpeed)
void	GetBlipSpeeds (double &aMinBlipSpeed, double &aMaxBlipSpeed) const
void	GetBlipHeadings (double &aMinBlipHeading, double &aMaxBlipHeading) const
void	SetBearingReference (ReferenceBearing aBearingReference)
ReferenceBearing	GetBearingReference () const
void	SetReferenceCentroid (double aLatitude, double aLongitude, double aAltitude)
void	GetReferenceCentroid (double &aLatitude, double &aLongitude, double &aAltitude)
WsfPlatform *	GetCentroidPlatform () const
virtual void	RemoveJammer (WsfEM_Xmtr *aJammerXmtrPtr)
bool	GetChanged () const
void	SetDebug (bool aDebug)
bool	GetDebug () const
unsigned int	GetInitialNumberOfFTs () const
double	GetPersistence () const
bool	GetRangeConstrained () const
void	SetRangeConstrained (bool aRangeConstrained)
void	SetState (OnOffState aState)
OnOffState	GetState () const
void	SetToggled (bool aToggled)
bool	GetToggled () const
void	DropTracks (RadarSnsrPair aIdKey, WsfEM_Xmtr *aJammerXmtrPtr)
bool	PowerSufficiencyCheck (double aSimTime, WsfEM_Xmtr aJammerXmtrPtr, WsfEM_Xmtr aRadarXmtrPtr, WsfEM_Rcvr *aRadarRcvrPtr)
void	SetBlips (int aJammerID, WsfFalseTarget::Blips &aBlips)
bool	ExplicitAzimuthExtent () const
bool	ExplicitNumberOfFTs () const
bool	ExplicitRangeConstraint () const
bool	ExplicitRangeExtent () const
bool	ExplicitReferenceCentroid () const
bool	ExplicitScanInterval () const
bool	ExplicitBlipSpeeds () const
Public Member Functions inherited from WsfObject
	WsfObject ()
	This is the constructor for the WsfObject class.
	~WsfObject () override
	This is the destructor for the WsfObject class.
const char *	GetScriptClassName () const override
const std::string &	GetType () const
WsfStringId	GetTypeId () const
	Get the string ID of the 'type' of the object.
void	SetType (WsfStringId aType)
const std::string &	GetBaseType () const
WsfStringId	GetBaseTypeId () const
const TypeList &	GetTypeList () const
bool	IsA_TypeOf (WsfStringId aType) const
WsfObject &	operator= (const WsfObject &aRhs)
	Assignment operator.
template<typename T>
void	Serialize (T &aBuff)
	For XIO (de)serialization.
const std::string &	GetName () const
WsfStringId	GetNameId () const
void	SetName (WsfStringId aName)

Static Public Member Functions
static void	ResetStatic ()
static size_t	AssignFT_BlipUniqueId ()

Protected Member Functions
WsfSimulation *	GetSimulation () const
virtual void	Rescan (double aSimTime, WsfEM_Xmtr *aJammerXmtrPtr)
	Produce a group of false target blips for a single scan of an observing sensor.
virtual void	UpdateBlipPositions (double aSimTime, unsigned int aJammerId)
void	UpdateBaseBlipPositions (double aSimTime)
void	UpdateCentroidPosition (double aSimTime)
	WsfObject (const WsfObject &aSrc)
	Copy constructor (for Clone()).

Friends
class	WsfFalseTargetBlip

Detailed Description

An instance of this class quantitatively models the multiple false targets that will be perceived by.

Electronic Attack (EA) techniques. Different instances of this type will be created if the randomness among multiple radar sites.

A per platform instance is used if this type is to be consistent among different radar sites but random to multiple platforms.
A single instance is used if this type is to be consistent among different radar sites and consistent to multiple platforms.

Member Typedef Documentation

◆ BaseLocsVec

using WsfFalseTarget::BaseLocsVec = std::vector<BaseData>

◆ Blip

using WsfFalseTarget::Blip = WsfFalseTargetBlip

◆ Blips

using WsfFalseTarget::Blips = std::vector<WsfFalseTargetBlip*>

◆ BlipsIterators

using WsfFalseTarget::BlipsIterators = std::vector<Blips::iterator>

◆ BlipStateVec

using WsfFalseTarget::BlipStateVec = std::vector<ScreenerPtrJammerXmtrPtr>

◆ ExtentData

using WsfFalseTarget::ExtentData = std::vector<ExtentPair>

◆ JammerIdToBlipsMap

using WsfFalseTarget::JammerIdToBlipsMap = std::map<unsigned int, Blips>

◆ JammerIdToStateMap

using WsfFalseTarget::JammerIdToStateMap = std::map<unsigned int, JammerState>

◆ RadarSnsrPair

using WsfFalseTarget::RadarSnsrPair = std::pair<WsfStringInt, WsfStringInt>

◆ ScreenerPtrJammerXmtrPtr

using WsfFalseTarget::ScreenerPtrJammerXmtrPtr = std::pair<WsfFalseTargetScreener*, WsfEM_Xmtr*>

Member Enumeration Documentation

◆ BlipBehavior

enum WsfFalseTarget::BlipBehavior

"BlipBehavior" describes the observed time-variant behavior for the false-target blips for each radar site:

Enumerator
cRANDOM_SCAN_TO_SCAN	Perception changes randomly from scan to scan.
cCONSISTENT_SCAN_TO_SCAN	Relative to the true track geometry, perception is consistent from scan to scan.

◆ BlipDistribution

enum WsfFalseTarget::BlipDistribution

"BlipDistribution" appearance describes how the false targets are spread over an area surrounding a radar site.

Enumerator
cRANDOM
cCIRCULAR
cSECTORED

◆ BlipReference

enum WsfFalseTarget::BlipReference

Enumerator
cBR_NONE	Uses the input speed and heading for the false target blip movement.
cBR_JAMMER	Uses the jammer (i.e. transmitter) platform for the heading and speed of the blips.

◆ OnOffState

enum WsfFalseTarget::OnOffState

OnOffState indicates what the state of this false target technique.

Enumerator
cOn
cOff

◆ PlatformBehavior

enum WsfFalseTarget::PlatformBehavior

"PlatformBehavior" describes the observed time-variant behavior for the false-target blips among different jamming platforms, this behavior coupled with the "RadarBehavior" defines how cCONSISTENT_TO_MULTIPLE_RADARS are fused among different jamming platforms:

Enumerator
cRANDOM_TO_MULTIPLE_PLATFORMS	Perception from multiple platforms is uncorrelated.
cCONSISTENT_TO_MULTIPLE_PLATFORMS	Perception from multiple platforms is correlated.

◆ RadarBehavior

enum WsfFalseTarget::RadarBehavior

"RadarBehavior" describes the observed time-variant behavior for the false-target blips among different radar sites:

Enumerator
cRANDOM_TO_MULTIPLE_RADARS	Perception from multiple radars is uncorrelated.
cCONSISTENT_TO_MULTIPLE_RADARS	Perception from multiple radars is correlated.

◆ RangeDistribution

enum WsfFalseTarget::RangeDistribution

"RangeDistribution" describes how the false targets are spread over the range from the radar site.

Enumerator
cUNIFORM
cLOG
cEXPONENTIAL

◆ ReferenceBearing

enum WsfFalseTarget::ReferenceBearing

ReferenceBearing indicates what the reference angle for zero azimuth is.

Enumerator
cJAMMER
cNORTH
cPROTECTED_ENTITY

Constructor & Destructor Documentation

◆ WsfFalseTarget() [1/2]

WsfFalseTarget::WsfFalseTarget ( WsfScenario & aScenario )

explicit

References cBR_NONE, cNORTH, cOn, cRANDOM_SCAN_TO_SCAN, cRANDOM_TO_MULTIPLE_PLATFORMS, cRANDOM_TO_MULTIPLE_RADARS, cUNIFORM, and WsfObject::WsfObject().

Referenced by Clone(), operator=(), and WsfFalseTarget().

◆ WsfFalseTarget() [2/2]

WsfFalseTarget::WsfFalseTarget ( const WsfFalseTarget & aSrc )

References WsfPlatform::Clone(), WsfObject::GetNameId(), WsfFalseTarget(), and WsfObject::WsfObject().

◆ ~WsfFalseTarget()

WsfFalseTarget::~WsfFalseTarget ( )

override

Member Function Documentation

◆ AssignFT_BlipUniqueId()

size_t WsfFalseTarget::AssignFT_BlipUniqueId ( )

static

Referenced by CreateBlipNameId(), and WsfFalseTargetBlip.

◆ ClearAllBlips()

void WsfFalseTarget::ClearAllBlips ( )

virtual

Referenced by Reset().

◆ ClearBlips()

void WsfFalseTarget::ClearBlips ( unsigned int aJammerId )

virtual

Referenced by RemoveJammer(), and Rescan().

◆ Clone()

WsfFalseTarget * WsfFalseTarget::Clone ( ) const

overridevirtual

Return a copy of this object. Must be implemented by all derived types. If cloning is impossible, a WsfUncloneableException should be thrown.

Implements WsfObject.

References WsfFalseTarget().

Referenced by WsfEW_FalseTargetEffect::FT_Data::FT_Data(), and WsfEW_FalseTargetEffect::FT_Data::Initialize().

◆ CreateBlipNameId()

void WsfFalseTarget::CreateBlipNameId ( Blip * aBlipPtr )

References AssignFT_BlipUniqueId(), WsfObject::GetName(), WsfFalseTargetBlip::SetNameId(), and WsfFalseTargetBlip::SetUniqueId().

Referenced by Rescan().

◆ DropTracks()

void WsfFalseTarget::DropTracks	(	RadarSnsrPair	aIdKey,
		WsfEM_Xmtr *	aJammerXmtrPtr )

References WsfUniqueId::GetUniqueId().

◆ ExplicitAzimuthExtent()

bool WsfFalseTarget::ExplicitAzimuthExtent ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::InitializeFT().

◆ ExplicitBlipSpeeds()

bool WsfFalseTarget::ExplicitBlipSpeeds ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::InitializeFT().

◆ ExplicitNumberOfFTs()

bool WsfFalseTarget::ExplicitNumberOfFTs ( ) const

inline

◆ ExplicitRangeConstraint()

bool WsfFalseTarget::ExplicitRangeConstraint ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::UpdateFT().

◆ ExplicitRangeExtent()

bool WsfFalseTarget::ExplicitRangeExtent ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::UpdateFT().

◆ ExplicitReferenceCentroid()

bool WsfFalseTarget::ExplicitReferenceCentroid ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::UpdateFT().

◆ ExplicitScanInterval()

bool WsfFalseTarget::ExplicitScanInterval ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::UpdateFT().

◆ GetBearingReference()

ReferenceBearing WsfFalseTarget::GetBearingReference ( ) const

inline

◆ GetBlipBehavior()

BlipBehavior WsfFalseTarget::GetBlipBehavior ( ) const

inline

Referenced by Rescan().

◆ GetBlipHeadings()

void WsfFalseTarget::GetBlipHeadings	(	double &	aMinBlipHeading,
		double &	aMaxBlipHeading ) const

◆ GetBlipPtr() [1/2]

WsfFalseTargetBlip * WsfFalseTarget::GetBlipPtr	(	size_t	aBlipUniqueId,
		unsigned int	aJammerId )

References WsfFalseTargetBlip.

◆ GetBlipPtr() [2/2]

WsfFalseTargetBlip * WsfFalseTarget::GetBlipPtr	(	WsfStringId	aBlipNameId,
		unsigned int	aJammerId )

References WsfFalseTargetBlip.

◆ GetBlips()

WsfFalseTarget::Blips & WsfFalseTarget::GetBlips ( unsigned int aJammerId )

◆ GetBlipsCreated()

bool WsfFalseTarget::GetBlipsCreated ( unsigned int aJammerId )

◆ GetBlipSpeeds()

void WsfFalseTarget::GetBlipSpeeds	(	double &	aMinBlipSpeed,
		double &	aMaxBlipSpeed ) const

◆ GetCentroidPlatform()

WsfPlatform * WsfFalseTarget::GetCentroidPlatform ( ) const

inline

◆ GetChanged()

bool WsfFalseTarget::GetChanged ( ) const

inline

◆ GetDebug()

bool WsfFalseTarget::GetDebug ( ) const

inline

Referenced by PowerSufficiencyCheck().

◆ GetInitialNumberOfFTs()

unsigned int WsfFalseTarget::GetInitialNumberOfFTs ( ) const

inline

◆ GetNewBlipsState()

bool WsfFalseTarget::GetNewBlipsState	(	WsfFalseTargetScreener *	aScreenerPtr,
		WsfEM_Xmtr *	aJammerXmtrPtr )

◆ GetPersistence()

double WsfFalseTarget::GetPersistence ( ) const

inline

◆ GetPlatformBehavior()

PlatformBehavior WsfFalseTarget::GetPlatformBehavior ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::FT_Data::Initialize().

◆ GetRadarBehavior()

RadarBehavior WsfFalseTarget::GetRadarBehavior ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::FT_Data::Initialize(), and WsfEW_FalseTargetEffect::FT_Data::ProcessInput().

◆ GetRangeConstrained()

bool WsfFalseTarget::GetRangeConstrained ( ) const

inline

◆ GetReferenceCentroid()

void WsfFalseTarget::GetReferenceCentroid	(	double &	aLatitude,
		double &	aLongitude,
		double &	aAltitude )

◆ GetScanInterval()

double WsfFalseTarget::GetScanInterval ( ) const

inline

Referenced by WsfEW_FalseTargetEffect::UpdateFT().

◆ GetSimulation()

WsfSimulation * WsfFalseTarget::GetSimulation ( ) const

inlineprotected

Referenced by UpdateBaseBlipPositions(), and UpdateBlipPositions().

◆ GetState()

OnOffState WsfFalseTarget::GetState ( ) const

inline

◆ GetToggled()

bool WsfFalseTarget::GetToggled ( ) const

inline

Referenced by WsfFalseTargetScreener::CheckFT_Toggle().

◆ Initialize() [1/2]

bool WsfFalseTarget::Initialize	(	double	aSimTime,
		WsfEM_Xmtr *	aJammerXmtrPtr )

References WsfEM_XmtrRcvr::GetPlatform(), WsfPlatform::GetSimulation(), WsfUniqueId::GetUniqueId(), Initialize(), ok, and Update().

◆ Initialize() [2/2]

bool WsfFalseTarget::Initialize ( WsfSimulation * aSimulationPtr )

virtual

References cCONSISTENT_TO_MULTIPLE_PLATFORMS, cCONSISTENT_TO_MULTIPLE_RADARS, cRANDOM_TO_MULTIPLE_RADARS, wsf::Terrain::GetElevInterp(), WsfObject::GetNameId(), WsfObject::GetTypeId(), and WsfObject::SetName().

Referenced by Initialize(), WsfFalseTargetTypes::InitializeType(), WsfFalseTargetTypes::LoadInstance(), and operator=().

◆ operator=()

WsfFalseTarget & WsfFalseTarget::operator= ( const WsfFalseTarget & )

delete

References Initialize(), Reset(), and WsfFalseTarget().

◆ PowerSufficiencyCheck()

bool WsfFalseTarget::PowerSufficiencyCheck	(	double	aSimTime,
		WsfEM_Xmtr *	aJammerXmtrPtr,
		WsfEM_Xmtr *	aRadarXmtrPtr,
		WsfEM_Rcvr *	aRadarRcvrPtr )

References WsfEM_Interaction::BeginGenericInteraction(), WsfEW_Effect::cEB_JAMMER_POWER_EFFECT, WsfRF_Jammer::ComputeJammerPowers(), WsfEM_Rcvr::ComputeSignalToNoise(), WsfEM_Interaction::ComputeUndefinedGeometry(), WsfEW_Result::Find(), WsfEM_XmtrRcvr::GetArticulatedPart(), GetDebug(), WsfEM_Rcvr::GetDetectionThreshold(), WsfObject::GetName(), WsfEM_XmtrRcvr::GetPlatform(), WsfEW_Effects::mEW_CoherentJammingEffect, WsfEW_Result::mEW_Effects, WsfEW_Effects::mEW_SignalEffect, WsfEW_Effects::EW_JammingEffect::mJtoXGain, WsfEW_Effects::mMask, WsfEW_Effects::EW_JammingEffect::mModulationGain, WsfEW_Effects::EW_JammingEffect::mRepeaterFactor, WsfEW_Effects::EW_SignalEffect::mSignalPowerGain, WsfEM_Interaction::SetReceiverBeamPosition(), and WsfEM_Interaction::SetTransmitterBeamPosition().

Referenced by WsfEW_SensorComponent::EW_Mode::UpdateFalseTargetInteractors().

◆ ProcessInput()

bool WsfFalseTarget::ProcessInput ( UtInput & aInput )

overridevirtual

Process input from a generic source.

Examine the current input command. If it is NOT one of the commands recognized by this class then it simply returns 'false'. If it is one of the commands recognized by this class then it processes the command and returns 'true'.

Parameters

aInput a reference to a UtInput object.

Returns: 'true' if the command was one recognized by the class or 'false' if not.

Exceptions

UtInput::ExceptionBase (or an object derived from it) if the command was recognized but contains some sort of error.

Note: If a derived class does not recognize the command (i.e.: the return value is false) then it should call the base class ProcessInput method. This chain should continue until either the command is recognized or the top-level base class is encountered.

Reimplemented from WsfObject.

References cBR_JAMMER, cBR_NONE, cCONSISTENT_SCAN_TO_SCAN, cCONSISTENT_TO_MULTIPLE_RADARS, cEXPONENTIAL, cJAMMER, cLOG, cNORTH, cRANDOM_SCAN_TO_SCAN, cRANDOM_TO_MULTIPLE_RADARS, cUNIFORM, WsfObject::GetNameId(), WsfFalseTarget::ExtentPair::mMax, WsfFalseTarget::ExtentPair::mMin, and SetReferenceCentroid().