Module HOUND
Hound
Elint system for DCS
Info:
- Copyright: uri_ba 2020-2024
- Author: uri_ba
-
HOUND
-
Global settings and paramters
Fields:
- VERSION
Hound Version
- DEBUG
Hound will do extended debug output to log (for development)
- ELLIPSE_PERCENTILE
Defines the percentile of datapoints used to calculate uncertenty ellipse
- DATAPOINTS_NUM
Number of datapoints per platform a contact keeps (FIFO)
- DATAPOINTS_INTERVAL
Time between stored data points
- CONTACT_TIMEOUT
Timout for emitter to be silent before being dropped from contacts
- MAX_ANGULAR_RES_DEG
The maximum (worst) platform angular resolution acceptable
- ANTENNA_FACTOR
Global factor of antenna size (bigger antenna == better accuracy). Allows mission builder to quickly nerf or boost hound performace (default 1.0).
- MGRS_PRECISION
Number of digits in MGRS conversion
- EXTENDED_INFO
Hound will add more in depth uncertenty info to controller messages (default is true)
- FORCE_MANAGE_MARKERS
Force Hound to use internal counter for markIds (default is true).
- USE_LEGACY_MARKERS
Force Hound to use normal markers for radar positions (default is true)
- MARKER_MIN_ALPHA
Minimum opacity for area markers
- MARKER_MAX_ALPHA
Maximum opacity for area markers
- MARKER_LINE_OPACITY
Opacity of the line around the area markers
- MARKER_TEXT_POINTER
Char/string used as pointer on text markers
- TTS_ENGINE
Hound will use the table to determin TTS engine priority
- MENU_PAGE_LENGTH
Number of Items Hound will put in a menu before starting a new menu page
- ENABLE_BETTER_SCORE
If true, will use better scoring algorithm for contacts (default is true)
- REF_DIST
Reference distance for contact scoring. Used to calculate the weight of datap
- ENABLE_WLS
If true, will use WLS algorithm for contact scoring (currently not implemented, default is false)
- ENABLE_KALMAN
If true, will use Kalman filter for contact scoring (currently not implemented, default is false)
- AUTO_ADD_PLATFORM_BY_PAYLOAD
If true, will automatically add platforms that have ELINT payloads (currently, due to DCS limits, only works for units spawning with the required pods)
-
MARKER
-
Map Markers ENUM
Fields:
- NONE
no markers are drawn
- SITE_ONLY
only site markers are drawn
- POINT
only draw point marker for emitters
- CIRCLE
a circle of uncertenty will be drawn
- DIAMOND
a diamond will be drawn with 4 points representing uncertenty ellipse
- OCTAGON
ellipse will be drawn with 8 points (diamon with midpoints)
- POLYGON
ellipse will be drawn as a 16 sides polygon
-
EVENTS
-
Hound Events
Fields:
- NO_CHANGE
nothing changed in the object
- HOUND_ENABLED
Hound Event
- HOUND_DISABLED
Hound Event
- PLATFORM_ADDED
Hound Event
- PLATFORM_REMOVED
Hound Event
- PLATFORM_DESTROYED
Hound Event
- RADAR_NEW
Hound Event
- RADAR_DETECTED
Hound Event
- RADAR_UPDATED
Hound Event
- RADAR_DESTROYED
Hound Event
- RADAR_ALIVE
Hound Event
- RADAR_ASLEEP
Hound Event
- SITE_NEW
Hound Event
- SITE_CREATED
Hound Event
- SITE_UPDATED
Hound Event
- SITE_CLASSIFIED
Hound Event
- SITE_REMOVED
Hound Event
- SITE_ALIVE
Hound Event
- SITE_ASLEEP
Hound Event
- SITE_LAUNCH
Hound Event
-
EVENTS.EVENT
-
Event structure
Fields:
- id
event enum from HOUND.EVENTS
- houndId
Hound Instace ID that emitted the event
- coalition
coalition ID of the Hound Instance that emitted the event
- initiator
DCS Unit or HoundContact Subclass that triggered the event
- time
of event
-
INSTANCES
-
Hound Instances
every instance created will be added to this list with it's HoundId as key.
-
getInstance (InstanceId)
-
Get instance
get hound instance by ID
Parameters:
- InstanceId
number
instance ID to get
Returns:
Hound Instance object or nil
-
setMgrsPresicion (value)
-
set default MGRS presicion for grid calls
Parameters:
- value
(Int) Requested value. allowed values 1-5, default is 3
-
showExtendedInfo (value)
-
set detailed messages to include or exclude extended tracking data
if true, will read and display extended ellipse info and tracking times. (default)
if false, will skip that information. only the shortened info will be used
Parameters:
- value
(Bool) Requested state
-
addEventHandler (handler)
-
register new event handler (global)
Parameters:
- handler
handler to register
See also:
-
removeEventHandler (handler)
-
deregister event handler (global)
Parameters:
- handler
handler to remove
See also:
-
inheritsFrom (baseClass)
-
helper code for class inheritance
Parameters:
- baseClass
Base class to inherit from
-
Length (T)
-
get Length of a table
Parameters:
Returns:
length of T
-
setContains (set, key)
-
check if set contains a provided key (case sensitive)
Parameters:
- set
Hash table to check
- key
to check
Returns:
bool
True if key exists in set
-
setContainsValue (set, value)
-
check if table contains a provided
Parameters:
- set
Table to check
- value
Value to check
Returns:
bool
True if value exists in set
-
setIntersection (a, b)
-
return set intersection product
Parameters:
Returns:
Table
-
Gaussian (mean, sigma)
-
return Gaussian random number
Parameters:
- mean
Mean value (i.e center of the gausssian curve)
- sigma
amount of variance in the random value
Returns:
random number in gaussian space
-
reverseLookup (tbl, value)
-
reverse table lookup
Parameters:
- tbl
table
- value
to search
Returns:
the key wher value was found
-
string.split (str[, delim])
-
Split String on delimited
Parameters:
- str
Input string
- delim
Delimited (default is space)
(optional)
Returns:
table of substrings