RadioPlan Development with MGDK
This document describes how to set up and run the RadioPlan Antenna Service and RadioPlan Radio Propagation Service together with MGDK. It also provides guidance on required data, configuration, and supporting resources.
Overview
Both services are configured by default to run using a developer certificate and require local copies of data and configuration files. The services are distributed as zip archives and include matching NuGet packages for client integration.
Prerequisites
Before starting, ensure you have access to the shared directories:
\\files\EXT-GEO\develop\RadioPlan
You should also have an MGDK installation with access to:
- Elevation data
- Building data
- Clutter data
These datasets must be available to MGDK services for optimal performance of the propagation calculations.
Antenna Service Setup
1. Download the Service
Copy and unzip the Antenna Service from:
\\files\EXT-GEO\develop\RadioPlan\AntennaService\<PICK A VERSION>\service
Place the extracted contents in any directory of your choice.
2. NuGet Packages
Matching NuGet packages for client applications are located here:
\\files\EXT-GEO\develop\RadioPlan\AntennaService<MATCH RUNNING VERSION>\nuget
Use the version that corresponds to the service version you are running.
3. Antenna Elements
A library of antenna element files can be found at:
\\files\EXT-GEO\develop\RadioPlan\Antennas
Unzip these into the folder specified in the service `appsettings.json`:
"AntennaFolder": "C:\\AstrixFiles\\ant"
The elements must be inside a folder called element located inside that path, ie: C:\AstrixFiles\ant\element
Radio Propagation Service Setup
1. Download the Service
Copy and unzip the Radio Propagation Service from:
\\files\EXT-GEO\develop\RadioPlan\RadioPropagationService\<PICK A VERSION>\service
Place the extracted files in any directory.
If you need to override default settings, create an `appsettings.Production.json` file with settings override.
Make sure the following settings match your setup:
"Services": {
"MariaGdkDataFolder": "C:\\MariaGeoData", // Map data: elevation, clutter and building
"AntennaServiceAddress": "https://localhost:16089"
}
2. NuGet Packages
Matching NuGet packages can be found here:
\\files\EXT-GEO\develop\RadioPlan\RadioPropagationService\<MATCH RUNNING VERSION>\nuget
Use the package version that matches your running service.
3. MGDK Data Requirements
To get accurate results from propagation calculations, make sure MGDK has access to:
- Elevation data
- Building data
- Clutter dataWithout these, results may be incomplete or inaccurate.
Propagation Models
A collection of available propagation models can be found at:
\\files\EXT-GEO\develop\RadioPlan\PropagationModels
Propagation models are provided as XML files.
When performing calculations, the client application must send the XML content as text to the service.
Map Symbols
RadioPlan uses custom MGDK SymbolPoint definitions.
Symbol files are stored here:
\\files\EXT-GEO\develop\RadioPlan\SymbolPoint
Refer to the MGDK documentation for details on configuring custom symbols:
Ensure your MGDK-based application is properly configured to load these symbol definitions.