WSF
WsfEW_SLC_Effect Class Reference

WsfEW_SLC_Effect applies Sidelobe Canceler (SLC) effects of radars. More...

#include <WsfEW_SLC_Effect.hpp>

Inheritance diagram for WsfEW_SLC_Effect:
Collaboration diagram for WsfEW_SLC_Effect:

Classes

struct  CancelationData

Public Types

enum  CancelationMethod { cNONE , cSUM , cINCREMENTAL }
enum  CancelerState { cOFF , cCANCELING , cMAINLOBE , cSTALLED }
using CancelationMap = std::map<unsigned int, CancelationData>
using JNR_To_CR_PairVec = std::vector<std::pair<double, double>>
using CancelationTable = std::map<int, JNR_To_CR_PairVec>
Public Types inherited from WsfEW_RepeaterEffect
enum  ControlMethod { cCM_NONE = 1 , cCM_USE_REPEATER = cCM_NONE << 1 , cCM_USE_ACTUALS = cCM_NONE << 2 , cCM_USE_REPEATER_ACTUALS = cCM_NONE << 3 }
enum  GainControlType {
  cMG_NONE = 1 , cMG_DESIRED_RCS = cMG_NONE << 1 , cMG_MIN_J_TO_N = cMG_NONE << 2 , cMG_MIN_J_TO_S = cMG_NONE << 3 ,
  cMG_MIN_DETECT = cMG_NONE << 4 , cMG_MASKING = cMG_NONE << 5
}
Public Types inherited from WsfEW_RadiusEffect
enum  RadiusLimitType {
  cJRL_NONE = 0 , cJRL_INSIDE = 1 , cJRL_OUTSIDE = 2 , cJRL_BOTH = 3 ,
  cJRL_EQUAL = 4
}
using RadiusTypeToValueMap = std::map<RadiusLimitType, double>
Public Types inherited from WsfEW_Effect
enum  Behavior {
  cEB_UNDEFINED = 1 , cEB_DROP_TRACK = cEB_UNDEFINED << 1 , cEB_MAINTAIN_TRACK = cEB_UNDEFINED << 2 , cEB_TRACK_ERROR = cEB_UNDEFINED << 3 ,
  cEB_DROP_MESSAGE = cEB_UNDEFINED << 4 , cEB_MAINTAIN_MESSAGE = cEB_UNDEFINED << 5 , cEB_MESSAGE_ERROR = cEB_UNDEFINED << 6 , cEB_JAMMER_POWER_EFFECT = cEB_UNDEFINED << 7 ,
  cEB_SIGNAL_POWER_EFFECT = cEB_UNDEFINED << 8 , cEB_SLC_DEGRADE_EFFECT = cEB_UNDEFINED << 9 , cEB_FALSE_TARGET_EFFECT = cEB_UNDEFINED << 10 , cEB_PULSE_EFFECT = cEB_UNDEFINED << 11 ,
  cEB_AGILITY_EFFECT = cEB_UNDEFINED << 12 , cEB_REPEATER_EFFECT = cEB_UNDEFINED << 13 , cEB_REPEATER_UPDATE = cEB_UNDEFINED << 14 , cEB_FLOODED_BLOCKED = cEB_UNDEFINED << 15 ,
  cEB_FLOODED_MAINTAINED = cEB_UNDEFINED << 16 , cEB_JAM_STROBE_EFFECT = cEB_UNDEFINED << 17 , cEB_TARGET_REJECT_EFFECT = cEB_UNDEFINED << 18 , cEB_NEXT_FREE_MASK = cEB_UNDEFINED << 19
}
 The behavior the EW effect exhibits. More...
enum  Coherency {
  cEC_NONE = 1 , cEC_NONCOHERENT = cEC_NONE << 1 , cEC_COHERENT = cEC_NONE << 2 , cEC_NONCOHERENT_PULSE = cEC_NONE << 3 ,
  cEC_COHERENT_PULSE = cEC_NONE << 4
}
 The signal coherency the EW effect exhibits on the affected system. More...
enum  ModulationType {
  cEM_NONE = 1 , cEM_CW = cEM_NONE << 1 , cEM_COHPULSE = cEM_NONE << 2 , cEM_NONCOHPULSE = cEM_NONE << 3 ,
  cEM_LINEARFM = cEM_NONE << 4 , cEM_NONLINEARFM = cEM_NONE << 5 , cEM_PHASEKEY = cEM_NONE << 6 , cEM_PHASEMOD = cEM_NONE << 7 ,
  cEM_PHASECODE = cEM_NONE << 8 , cEM_ASK = cEM_NONE << 9 , cEM_FSK = cEM_NONE << 10 , cEM_PSK = cEM_NONE << 11 ,
  cEM_BPSK = cEM_NONE << 12 , cEM_QPSK = cEM_NONE << 13 , cEM_DPSK = cEM_NONE << 14 , cEM_QAM = cEM_NONE << 15
}
enum  TargetProtectionType { cTP_ALL , cTP_NON_SELF_PROTECT , cTP_SELF_PROTECT }
 The target protection type this effect is limited to. More...
enum  SystemFunction {
  cES_UNDEFINED = 1 , cES_COMM = cES_UNDEFINED << 1 , cES_SENSOR = cES_UNDEFINED << 2 , cES_JAMMER = cES_UNDEFINED << 3 ,
  cES_NEXT_FREE_MASK = cES_UNDEFINED << 4
}
 The type of system function types the EW effect can affect. More...
Public Types inherited from WsfObject
typedef std::vector< WsfStringIdTypeList
 The list of types returned by GetTypeList.

Public Member Functions

 WsfEW_SLC_Effect ()
WsfEW_SLC_Effectoperator= (const WsfEW_SLC_Effect &)=delete
 ~WsfEW_SLC_Effect () override
WsfEW_EffectClone () const override
bool Initialize (WsfSimulation &aSimulation) override
bool ProcessInput (UtInput &aInput) override
void ApplyUnmitigatedEffect (WsfEW_Effects &aEW_Effects) const override
void ApplyMitigatedEffect (WsfEW_Effect *aEW_EffectPtr, WsfEW_Effects &aEW_Effects) const override
void UpdateEffects (double aSimTime, const WsfEM_Interaction &aTargetInteraction, const WsfEM_Interaction &aJammerToTgtInteraction, const ut::optional< WsfEM_Interaction > &aTgtToJammerInteraction, WsfEW_Effects &aEW_Effects, WsfEW_Effect *aEW_EffectPtr=nullptr) override
void RemoveJammerXmtr (unsigned int aXmtrId) override
void RemoveJammerXmtr (WsfEM_Xmtr *aJammerXmtrPtr) override
Public Member Functions inherited from WsfEW_PowerEffect
 WsfEW_PowerEffect ()
WsfEW_PowerEffectoperator= (const WsfEW_PowerEffect &)=delete
 ~WsfEW_PowerEffect () override=default
double GetJammingPowerGain (WsfStringId aSystemTypeId) const
void SetJammingPowerGain (WsfStringId aSystemTypeId, double aJammingPowerGain)
double GetModulationGain (WsfStringId aSystemTypeId) const
void SetModulationGain (WsfStringId aSystemTypeId, double aModulaitonGain)
double GetSignalPowerGain (WsfStringId aSystemTypeId) const
void SetSignalPowerGain (WsfStringId aSystemTypeId, double aSignalPowerGain)
double GetRcvrNoiseGain (WsfStringId aSystemTypeId) const
void SetRcvrNoiseGain (WsfStringId aSystemTypeId, double aRcvrNoiseGain)
double GetJtoSGain (WsfStringId aSystemTypeId, Coherency aCoherencyType=cEC_NONE) const
size_t GetJtoSTableSize (WsfStringId aSystemTypeId) const
Public Member Functions inherited from WsfEW_RepeaterEffect
 WsfEW_RepeaterEffect ()
WsfEW_RepeaterEffectoperator= (const WsfEW_RepeaterEffect &)=delete
 ~WsfEW_RepeaterEffect () override=default
ControlMethod GetControlMethod (WsfStringId aSystemTypeId) const
void SetControlMethod (WsfStringId aSystemTypeId, ControlMethod aControlMethod)
double GetMinimumGainFactor (WsfStringId aSystemTypeId) const
double GetMaximumGainFactor (WsfStringId aSystemTypeId) const
void SetGainFactors (WsfStringId aSystemTypeId, double aMinimumGainFactor, double aMaximumGainFactor)
int GetGainControlTypeMask (WsfStringId aSystemTypeId) const
double GetDesiredJtoN (WsfStringId aSystemTypeId) const
void SetDesiredJtoN (WsfStringId aSystemTypeId, double aDesiredJtoN)
double GetDesiredJtoS (WsfStringId aSystemTypeId) const
void SetDesiredJtoS (WsfStringId aSystemTypeId, double aDesiredJtoS)
double GetDesiredFT_RCS (WsfStringId aSystemTypeId) const
void SetDesiredFT_RCS (WsfStringId aSystemTypeId, double aDesiredFT_MaskingRCS)
double GetMinDetectFactor (WsfStringId aSystemTypeId) const
void SetMinDetectFactor (WsfStringId aSystemTypeId, double aMinDetectFactor)
double GetMaskingFactor (WsfStringId aSystemTypeId) const
void SetMaskingFactor (WsfStringId aSystemTypeId, double aMaskingFactor)
Public Member Functions inherited from WsfEW_RadiusEffect
 WsfEW_RadiusEffect ()
WsfEW_RadiusEffectoperator= (const WsfEW_RadiusEffect &)=delete
 ~WsfEW_RadiusEffect () override=default
int GetRadiusLimitMask (WsfStringId aSystemTypeId) const
double GetRadiusFactor (WsfStringId aSystemTypeId) const
double GetRadiusFactor (WsfStringId aSystemTypeId, RadiusLimitType aJRL_Type) const
Public Member Functions inherited from WsfEW_Effect
 WsfEW_Effect ()=default
WsfEW_Effectoperator= (const WsfEW_Effect &)=delete
 ~WsfEW_Effect () override
virtual void ProcessUnmitigatedEffect (double aSimTime, const WsfEM_Interaction &aTargetInteraction, const WsfEM_Interaction &aJammerToTgtInteraction, const ut::optional< WsfEM_Interaction > &aTgtToJammerInteraction, WsfEW_Effects &aEW_Effects)
virtual void ProcessMitigatedEffect (double aSimTime, const WsfEM_Interaction &aTargetInteraction, const WsfEM_Interaction &aJammerToTgtInteraction, const ut::optional< WsfEM_Interaction > &aTgtToJammerInteraction, WsfEW_Effects &aEW_Effects, WsfEW_Effect *aEW_EffectPtr=nullptr)
void SetSystemFunctionMask (SystemFunction aSystemFunction)
 Set the system type.
void SetSystemFunctionMask (const std::string &aSystemFunctionId)
void AddSystemFunctionMask (SystemFunction aSystemFunction)
 Set the system type.
void AddSystemFunctionMask (const std::string &aSystemFunctionId)
unsigned int GetSystemFunctionMask () const
void SetCoherencyMask (Coherency aCoherency)
void AddCoherencyMask (Coherency aCoherency)
unsigned int GetCoherencyMask () const
void SetBehavior (Behavior aBehavior)
Behavior GetBehavior () const
void SetDebug (bool aDebug)
bool DebugEnabled () const
void SetEA_EP_Ptr (WsfEW_EA_EP *aPtr)
WsfEW_EA_EPGetEA_EP_Ptr () const
WsfEW_EAGetEA_Ptr () const
WsfEW_EPGetEP_Ptr () const
WsfEW_TechniqueGetTechniquePtr () const
void SetTechniquePtr (WsfEW_Technique *aPtr)
virtual double GetJammingPulseDensity () const
virtual double GetJammingPulseDensity (WsfEM_Xmtr *aXmtrPtr) const
virtual bool AllowTarget (WsfPlatform *aXmtrPlatform, WsfPlatform *aTargetPlatform) const
virtual void UpdateCurrentIds (WsfEM_Rcvr *aRcvrPtr, WsfEM_Xmtr *aXmtrPtr, WsfPlatform *aTargetPtr)
WsfSimulationGetSimulation () const
ut::Random & GetRandom ()
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 TypeListGetTypeList () const
bool IsA_TypeOf (WsfStringId aType) const
WsfObjectoperator= (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)

Data Accessors

virtual double GetCancelationLockRatio () const
virtual WsfEM_RcvrGetAuxRcvrPtr ()
 WsfEW_SLC_Effect (const WsfEW_SLC_Effect &aSrc)

External Services access.

These methods support the External Services and are not part of the WSF public interface.

virtual int GetNumberCancelers () const
virtual const CancelationTableGetCancelationTable () const
virtual double GetMainThresholds (unsigned int aIndex) const

Additional Inherited Members

static WsfEW_Effect::SystemFunction ConvertToEW_SystemFunction (WsfEM_Rcvr::RcvrFunction aRcvrFunction)
static WsfEW_Effect::SystemFunction ConvertToEW_SystemFunction (WsfEM_Xmtr::XmtrFunction aXmtrFunction)
static unsigned int ConvertCoherencyIdToMask (WsfStringId aCoherencyId)
using EffectDataMap = std::map<WsfStringId, EffectData*>
EffectDataNewEffectData () override
EffectDataPropagateEffectDataPtr (WsfStringId aSystemTypeId) override
 WsfEW_PowerEffect (const WsfEW_PowerEffect &aSrc)
EffectDataNewEffectData () override
EffectDataPropagateEffectDataPtr (WsfStringId aSystemTypeId) override
 WsfEW_RepeaterEffect (const WsfEW_RepeaterEffect &aSrc)
double GetRepeaterFactor ()
 Get the current repeater factor for last call to UpdateEffects(...) or UpdateRepeaterFactor(...).
void UpdateGainFactors (const WsfEM_Interaction &aTargetInteraction, const WsfEM_Interaction &aJammerToTgtInteraction, const ut::optional< WsfEM_Interaction > &aTgtToJammerInteraction, double aCurrentGains[])
 WsfEW_RadiusEffect (const WsfEW_RadiusEffect &aSrc)
bool ProcessEffectDataBlock (UtInputBlock &aInputBlock, WsfStringId aSystemTypeId)
virtual EffectDataGetEffectData (WsfStringId aSystemTypeId)
void ResetEffectData (WsfStringId aSystemTypeId)
bool EffectDataExists (WsfStringId aSystemTypeId) const
void InsertNewEffectData (WsfStringId aSystemTypeId, WsfEW_Types::EW_EffectData *aEffectPtr)
 WsfEW_Effect (const WsfEW_Effect &aSrc)
virtual void PrintUpdateMessage (ut::log::MessageStream &aStream, double aSimTime, WsfEW_Effect *aEW_EffectPtr=nullptr)
void ResetProtectionTypeFlag (WsfEM_Xmtr *aXmtrPtr, const WsfEM_Interaction &aTargetInteraction, WsfEW_Effects &aEW_Effects)
 WsfObject (const WsfObject &aSrc)
 Copy constructor (for Clone()).
unsigned int mSystemFunctionMask {cES_UNDEFINED}
 The system type mask that this EW effect can affect.
Behavior mBehavior {cEB_UNDEFINED}
 The behavior that this EW effect exhibits.
unsigned int mCoherencyMask {cEC_NONE}
 The coherency of this effect wrt to the affected system.
bool mDebug {false}
 The debug flag, 'true' for debug, false otherwise.
WsfStringId mCurrentTargetId {nullptr}
 Current target Id.
WsfStringId mCurrentXmtrPlatformId {nullptr}
 Current transmitting platform Id.
WsfStringId mCurrentRcvrPlatformId {nullptr}
 Current receiving platform Id.
int mCurrentXmtrUniqueId {0}
 Current transmitter unique Id.
int mCurrentRcvrUniqueId {0}
 Current receiver unique Id.
WsfStringId mEffectedSystemId {nullptr}
 The type Id of the system being effected, changes with each call to UpdateEffects(...) or UpdateCurrentIds(...).
WsfStringId mEffectingSystemId {nullptr}
 The type Id of the system doing the effecting, changes with each call to UpdateEffects(...) or UpdateCurrentIds(...).
bool mUpdatingEffect {true}
 Variable to prevent infinite recursion in UpdateEffect.
EffectDataMap mEffectDataMap
 Map of the System Type Id to the data required for this effect.

Detailed Description

WsfEW_SLC_Effect applies Sidelobe Canceler (SLC) effects of radars.

Member Typedef Documentation

◆ CancelationMap

using WsfEW_SLC_Effect::CancelationMap = std::map<unsigned int, CancelationData>

◆ CancelationTable

◆ JNR_To_CR_PairVec

using WsfEW_SLC_Effect::JNR_To_CR_PairVec = std::vector<std::pair<double, double>>

Member Enumeration Documentation

◆ CancelationMethod

Enumerator
cNONE 
cSUM 
cINCREMENTAL 

◆ CancelerState

Enumerator
cOFF 

canceler off

cCANCELING 

canceler functioning

cMAINLOBE 

Jammer signal in mainlobe or power in Aux is less than main.

cSTALLED 

canceler stalled, no longer canceling

Constructor & Destructor Documentation

◆ WsfEW_SLC_Effect() [1/2]

◆ ~WsfEW_SLC_Effect()

WsfEW_SLC_Effect::~WsfEW_SLC_Effect ( )
override

◆ WsfEW_SLC_Effect() [2/2]

WsfEW_SLC_Effect::WsfEW_SLC_Effect ( const WsfEW_SLC_Effect & aSrc)
protected

Member Function Documentation

◆ ApplyMitigatedEffect()

◆ ApplyUnmitigatedEffect()

void WsfEW_SLC_Effect::ApplyUnmitigatedEffect ( WsfEW_Effects & aEW_Effects) const
overridevirtual

◆ Clone()

WsfEW_Effect * WsfEW_SLC_Effect::Clone ( ) const
overridevirtual

Clone this object.

Returns
a pointer to the new object.

Reimplemented from WsfEW_PowerEffect.

References WsfEW_SLC_Effect().

◆ GetAuxRcvrPtr()

virtual WsfEM_Rcvr * WsfEW_SLC_Effect::GetAuxRcvrPtr ( )
inlinevirtual

◆ GetCancelationLockRatio()

virtual double WsfEW_SLC_Effect::GetCancelationLockRatio ( ) const
inlinevirtual

◆ GetCancelationTable()

virtual const CancelationTable & WsfEW_SLC_Effect::GetCancelationTable ( ) const
inlinevirtual

◆ GetMainThresholds()

virtual double WsfEW_SLC_Effect::GetMainThresholds ( unsigned int aIndex) const
inlinevirtual

◆ GetNumberCancelers()

virtual int WsfEW_SLC_Effect::GetNumberCancelers ( ) const
inlinevirtual

◆ Initialize()

bool WsfEW_SLC_Effect::Initialize ( WsfSimulation & aSimulation)
overridevirtual

◆ operator=()

WsfEW_SLC_Effect & WsfEW_SLC_Effect::operator= ( const WsfEW_SLC_Effect & )
delete

References WsfEW_SLC_Effect().

◆ ProcessInput()

bool WsfEW_SLC_Effect::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
aInputa 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 WsfEW_PowerEffect.

References cINCREMENTAL, WsfEM_Rcvr::cRF_SENSOR, cSUM, WsfObjectTypeList< T >::Find(), WsfScenario::FromInput(), WsfAntennaPatternTypes::Get(), WsfObject::GetName(), WsfEM_Antenna::ProcessInput(), WsfEW_PowerEffect::ProcessInput(), WsfEM_Rcvr::ProcessInputBlock(), and WsfEM_XmtrRcvr::SetAntenna().

◆ RemoveJammerXmtr() [1/2]

void WsfEW_SLC_Effect::RemoveJammerXmtr ( unsigned int aXmtrId)
overridevirtual

Remove the specified jammer from the cancelation map.

Parameters
aXmtrIdThe unique Id of the jammer transmitter.

Reimplemented from WsfEW_Effect.

References WsfObject::GetName(), and WsfEW_Effect::mDebug.

Referenced by UpdateEffects().

◆ RemoveJammerXmtr() [2/2]

void WsfEW_SLC_Effect::RemoveJammerXmtr ( WsfEM_Xmtr * aJammerXmtrPtr)
overridevirtual

Remove the specified jammer from the cancelation map.

Parameters
aJammerXmtrPtrThe pointer to the jammer transmitter.

Reimplemented from WsfEW_Effect.

References WsfObject::GetName(), WsfUniqueId::GetUniqueId(), and WsfEW_Effect::mDebug.

◆ UpdateEffects()

void WsfEW_SLC_Effect::UpdateEffects ( double aSimTime,
const WsfEM_Interaction & aTargetInteraction,
const WsfEM_Interaction & aJammerToTgtInteraction,
const ut::optional< WsfEM_Interaction > & aTgtToJammerInteraction,
WsfEW_Effects & aEW_Effects,
WsfEW_Effect * aEW_EffectPtr = nullptr )
overridevirtual

Allows the effect to update any parameters needed before running an apply effect method.

Parameters
aSimTime[input] The current simulation time.
aTargetInteraction[input] The target interaction for the detection attempt.
aJammerToTgtInteraction[input] The jammer interaction for the jammer Xmtr to victim Rcvr.
aTgtToJammerInteraction[input] Optional jammer interaction for the Victim Xmtr to jammer Rcvr. This will have no value if the jammer Rcvr doesn't exist.
aEW_Effects[input] The current effect that is being updated.
aEW_EffectPtr[input] The currently processing EW effect pointer to prevent recursion in EW effect processing loops.

Reimplemented from WsfEW_PowerEffect.

References WsfEM_Interaction::BeginOneWayInteraction(), cCANCELING, cINCREMENTAL, cMAINLOBE, cOFF, WsfRF_Jammer::ComputeJammerPower(), WsfEM_Rcvr::ComputeSignalToNoise(), WsfEM_Types::cPOL_DEFAULT, cSTALLED, WsfEM_XmtrRcvr::GetAntenna(), WsfEM_XmtrRcvr::GetArticulatedPart(), WsfEM_XmtrRcvr::GetBandwidth(), WsfEM_XmtrRcvr::GetFrequency(), WsfEW_Effect::GetJammingPulseDensity(), WsfEW_PolModEffect::GetPolarizationSwitchingRate(), WsfEM_Xmtr::GetPulseRepetitionInterval(), WsfEM_Xmtr::GetPulseWidth(), WsfEM_Interaction::GetReceiver(), WsfEW_Effect::GetSimulation(), WsfEW_SLC_DegradeEffect::GetSLC_ChannelsSaturated(), WsfEW_SLC_DegradeEffect::GetSLC_DegradationValue(), WsfEM_Interaction::GetTransmitter(), WsfEM_Interaction::mClutterPower, WsfEW_Effect::mCurrentXmtrUniqueId, WsfEW_Effect::mDebug, WsfEW_Effect::mEffectingSystemId, WsfEM_Interaction::mFailedStatus, WsfEM_Interaction::mRcvrBeam, WsfEM_Interaction::Print(), RemoveJammerXmtr(), WsfEM_Interaction::SetReceiverBeamPosition(), WsfEM_Interaction::SetTransmitterBeamPosition(), and WsfEW_PowerEffect::UpdateEffects().


The documentation for this class was generated from the following files:
Copyrights Multiple, All Rights Reserved