WsfSA_EntityPerception¶
-
WsfSA_EntityPerceptionConstruction:
WsfSA_EntityPerception newObj = WsfSA_EntityPerception();Clone:WsfSA_EntityPerception newObj = WsfSA_EntityPerception(other);
Overview¶
The WsfSA_EntityPerception provides a representation of a perceived entity, which may be a platform (asset) or track (bogie/bandit). Entity perceptions are a key component of the situation awareness component of the cognitive model, provided by the WsfSA_Processor.
Entity perceptions are used within the “perception” and “assessment” modules of the WsfSA_Processor (SAP). The SAP uses these entity perceptions to form various lists.
The first group of lists involve assets (friendly), bogies (unknown), and bandits (enemy). These lists are not prioritized, although they may be limited due to range and/or scoring parameters when limited perception is enabled.
The next group of lists provide an assessment of the prioritized threats and targets, which are composed of bandits and bogies. These lists are prioritized, from highest threat to lowest threat and from the best target to the least attractive target. Threats are perceived entities that present an adverse condition (a threat) to the platform, while targets are perceived entities that the platform may wish to attack.
In addition, the SAP provides lists of perceived groups (WsfSA_Group), and each group may contain a list of WsfSA_EntityPerception that make up the “elements” of the group.
Entity perceptions may be perceived as a missile. The default assumption, however, is that an entity is an aircraft. Thus, it is quite possible that an entity may actually be a missile, but is not yet perceived as such.
Methods¶
- int EntityPlatformIndex()¶
Returns the index of the entity platform. This may be zero (0) if the true platform is unknown.
- double Lat()¶
Returns the latitude (deg) of the entity.
- double Lon()¶
Returns the longitude (deg) of the entity.
- double Altitude()¶
Returns the altitude (meters) of the entity.
- double Bearing()¶
Returns the bearing (deg) of the entity.
- double Speed()¶
Returns the speed (meters/sec) of the entity.
- double Heading()¶
Returns the heading (deg) of the entity.
- double ThreatLevel()¶
Returns the threat level of the entity. This is a normalized value between 0.0 and 1.0.
- double TargetValue()¶
Returns the target value of the entity. This is a normalized value between 0.0 and 1.0.
- double Risk()¶
Returns the risk posed by the entity. This is a normalized value between 0.0 and 1.0.
- double Defensiveness()¶
Returns the defensiveness induced by the entity. This is a normalized value between 0.0 and 1.0.
- double Urgency()¶
Returns the sense of urgency imposed by the entity. This is a normalized value between 0.0 and 1.0.
- int PerceivedIndex()¶
Returns the perceived platform index of the entity.
- int FlightId()¶
Returns the flight id of the entity.
- int Identification()¶
Returns the identification of the entity.
Value |
Identification |
|---|---|
0 |
Unknown |
1 |
Friendly |
2 |
Neutral |
3 |
Bogie |
4 |
Bandit |
- bool FriendlyAsset()¶
Returns true if the entity is a friendly asset.
- bool AngleOnly()¶
Returns true if the entity is defined by an angle-only track.
- bool IdIffFriend()¶
Returns true if the entity has been identified as friendly via IFF.
- bool IdIffFoe()¶
Returns true if the entity has been identified as foe (enemy) via IFF.
- bool IdIffNeutral()¶
Returns true if the entity has been identified as neutral via IFF.
- bool IdIffUnknown()¶
Returns true if the entity has not been identified via IFF.
- bool IdAuxFriend()¶
Returns true if the entity has been identified as friendly via aux data.
- bool IdAuxFoe()¶
Returns true if the entity has been identified as foe (enemy) via aux data.
- bool IdAuxNeutral()¶
Returns true if the entity has been identified as neutral via aux data.
- bool IdAuxUnknown()¶
Returns true if the entity has not been identified via aux data.
- bool IdSideFriend()¶
Returns true if the entity has been identified as friendly via side data.
- bool IdSideFoe()¶
Returns true if the entity has been identified as foe (enemy) via side data.
- bool IdSideNeutral()¶
Returns true if the entity has been identified as neutral via side data.
- bool IdSideUnknown()¶
Returns true if the entity has not been identified via side data.
- bool IdTypeFriend()¶
Returns true if the entity has been identified as friendly via type data.
- bool IdTypeFoe()¶
Returns true if the entity has been identified as foe (enemy) via type data.
- bool IdTypeNeutral()¶
Returns true if the entity has been identified as neutral via type data.
- bool IdTypeUnknown()¶
Returns true if the entity has not been identified via type data.
- bool IsHostile()¶
Returns true if the entity has been identified as hostile.
- bool IsMissile()¶
Returns true if the entity is perceived as a missile.
- bool AltitudeValid()¶
Returns true if the entity altitude is valid.
- bool SpeedValid()¶
Returns true if the entity speed is valid.
- bool HeadingValid()¶
Returns true if the entity heading is valid.
- double SelectionScore()¶
Returns the current selection score of the entity.
- double EstimatedTimeToIntercept(WsfPlatform aTarget)¶
Returns the estimated time for this entity to intercept the specified target platform. If no intercept is possible, -1.0 is returned. If the entity is angle-only, or if it lacks speed data, no intercept will be calculated and -1.0 will be returned.
