View source for RadioPlan CoverageContours


The Radio Coverage Contour Generator processes radio signal data and produces polygonal representations of coverage areas.  It supports generating contours for:

* '''Individual radios'''
* '''Combined radios''' ''(combined coverage)''

The workflow is the same in both cases.


Using a marching squares algorithm, the system converts rasterized coverage data into vector polygons that clearly define:

* Areas '''with coverage'''
* Areas '''without coverage'''

The polygon lines are drawn at a specified received signal level threshold for the coverage for the cells selected for the contour. 
[[File:CoverageContours.png|center|766x766px|Coverage Contours for a VHF RadioNet]]

==== Settings ====
{| class="wikitable"
|+
!Property
!Type
!Description
|-
|Threshold
|Decibel
|Defines the signal strength cutoff for what is considered “coverage.”
|-
|Simplify
|bool
|Toggles simplification that controls how detailed the polygon shapes are.
|-
|SimplificationTolerance
|double
|Polygon point tolerance used for simplification. Controls how detailed the polygon shapes are.
|-
|MinPolygonAreaWithCoverage
|double
|Minimum size for '''coverage areas'''
''Note: Size is currently based on grid/pixel resolution.''
|-
|MinPolygonAreaWithNoCoverage
|double
|Minimum size for '''no coverage areas'''
''Note: Size is currently based on grid/pixel resolution.''
|-
|Fill
|bool
|Setting for enabling fill color on the polygons
|-
|NoCoverageColor
|Color
|Display color for no coverage
|-
|LineThickness
|double
|Line thickness for the rendered polygons
|}

==== Working with Coverage Contours (API) ====
The API lets you generate, access, and manage coverage polygons for both:

* '''Individual radios'''
* '''Combined radios''' ''(combined coverage)''

The workflow is the same in both cases.

General contour functions:

* Refresh All Coverage - Used when underlying radio or raidio net data changes
* Clear All Coverage - Resets the system completely

Calculating and handling contour lines are controlled via the interface '''IMariaRadioPlanLayer.[http://codedocs.maria.teleplanglobe.com/develop_gdk5/managed/interface_t_p_g_1_1_g_d_k_1_1_maria_1_1_contracts_1_1_i_radio_plan_coverage_contours.html IRadioPlanCoverageContours].'''
[[Category:RadioPlan]]