WSF_SENSOR_COVERAGE¶
- coverage WSF_SENSOR_COVERAGE¶
coverage <name> WSF_SENSOR_COVERAGE grid ... assets ... moe ... start_time ... end_time ... start_epoch ... end_epoch ... output_dir ... raw_data_file ... overlay_file ... interval_constraint ... end_coverage
Overview¶
Sensor coverage monitors sensor interactions between the specified grid and free assets. Relevant devices for sensor coverage are any sensors. Further, only one asset in each grid asset-free asset pair needs to have a device specified; the other asset should use ‘none’ as the device name.
Grid Asset Specification¶
- grid <grid-name>¶
Use the coverage grid with the given name as the grid over which this coverage will be computed.
Free Asset Specification¶
assets platform <platform-name> <device-name> platform_type <platform-type> <device-name> category <category-name> <device-name> group <group-name> <device-name> end_assets
- assets … end_assets¶
Specify the free assets to use for this coverage.
- platform <platform-name> <device-name>¶
Specify the platform with the given name is to be included among the free assets for this coverage. Unless ‘none’ is supplied as the device name, the given platform must have a relevant device with the given name.
- platform_type <platform-type> <device-name>¶
Specify that all platforms with the given type are to be included among the free assets for this coverage. Unless ‘none’ is supplied as the device name, the given platform type must have a relevant device with the given name.
- category <category-name> <device-name>¶
Specify that any platforms in the given category with a relevant device are to be included among the free assets for this coverage. If ‘none’ is specified as the device name, then all platforms in this category will be added to the set of free assets for this coverage.
- group <group-name> <device-name>¶
Specify that any platform in the given group with a relevant device are to be included among the free assets for this coverage. If ‘none’ is specified as the device name, then all platforms in this group will be added to the set of free assets for this coverage.
Measures of Effectiveness¶
moe <name> <measure-type> ... end_moe
- moe … end_moe¶
Specify a measure of effectiveness (MOE) to be computed by the coverage. See Predefined Measures of Effectiveness for a list of available MOEs.
Coverage Interval Commands¶
- start_time <time-value>¶
Set the start of the coverage interval to the given simulation time. Either this command or start_epoch can be used to specify the coverage interval’s start time. If no start time is specified the coverage interval’s start is set to the simulation’s start time.
- end_time <time-value>¶
Set the end time of the coverage interval to the given simulation time. Either this command or end_epoch can be used to specify the coverage interval’s end time. If no end time is specified the coverage interval’s end is set to the simulation’s end time.
- start_epoch <month> <day-of-month> <year> <hh:mm:ss>¶
Set the start of the coverage interval to the given date and time. Either this command or start_time can be used to specify the coverage interval’s start time. If no start time is specified the coverage interval’s start is set to the simulation’s start time.
- end_epoch <month> <day-of-month> <year> <hh:mm:ss>¶
Set the end of the coverage interval to the given date and time. Either this command or end_time can be used to specify the coverage interval’s end time. If no end time is specified the coverage interval’s end time is set to the simulation’s end time.
Data Output Commands¶
- output_dir <path-value>¶
Set the directory into which all file produced by this coverage will be generated. The default output directory is the working directory.
- raw_data_file <file-name>¶
If this filename is set, the coverage computation will store raw access intervals and write those intervals to the named file at the end of the coverage computation.
- overlay_file <file-name>¶
If this filename is set, the coverage computation will produce a data file with the given name that can be displayed by the CoverageOverlay plugin. This command will append the canonical extension for these files, “.cvg”, to the specified filename.
Interval Constraint Commands¶
interval_constraint output_file <file-name> platform <platform-name> <constraint-type> <time-value> [<time-value>] platform_type <platform-type> <constraint-type> <time-value> [<time-value>] device <device-name> <constraint-type> <time-value> [<time-value>] device_type <device-type> <constraint-type> <time-value> [<time-value>] end_interval_constraint
- interval_constraint … end_interval_constraint¶
Specifying an interval constraint for a coverage computation allows intervals that are too short or long in duration to be excluded from the computation. There are a number of ways to specify for which assets these constraints apply. Multiple specifications can be included in a single interval constraint block, and multiple interval constraint blocks can be specified for a single coverage computation.
- output_file <file-name>¶
Specify the name of the file into which the intervals that were filtered out of the coverage computation will be written. The format of these files will match the output from raw_data_file produced files.
- platform <platform-name> <constraint-type> <time-value> [<time-value>]¶
Specify that access intervals involving the named platform will be filtered according to the given <constraint-type>, which can take on the following values:
minimum - Access intervals with a duration shorter than the given value will be removed from the coverage computation.
maximum - Access intervals with a duration longer than the given value will be removed from the coverage computation.
interval - Access intervals shorter than the first given time, or longer than the second given time will be removed from the coverage computation.
- platform_type <platform-type> <constraint-type> <time-value> [<time-value>]¶
Specify that access intervals involving platforms of the given <platform-type> will be filtered according to the given <constraint-type>.
- device <device-name> <constraint-type> <time-value> [<time-value>]¶
Specify that access intervals involving the named device will be filtered according to the given <constraint-type>.
- device_type <device-type> <constraint-type> <time-value> [<time-value>]¶
Specify that access intervals involving devices with the given <device-type> will be filtered according to the given <constraint-type>.
