EMF Planner 7.0

Software for EMF exposure modelling and analysis

User Manual

download pdf64.png
From the Developers

We made every effort to create a user-friendly and intuitive application. However, we recommend you spend some time reading this User Manual to get the most out of the EMF Planner application.

Features

EMF Planner is a simulation software designed for the modelling, analysis and visualization of EMF exposure from any radio transmitter - base stations of any standard, TV and radio broadcasting stations, satellite earth stations, PtP, PtMP, Wi-Fi, etc.

EMF Planner is an internationally adapted version of our SanZone software that we have been developing for over 20 years.

The software is intended for users involved in the design, operation and supervision of transmitting radio facilities.

Main Features:

  • Calculation of EMF level by point source method according to Recommendation ITU-T K.70 (2020) Mitigation techniques to limit human exposure to EMFs in the vicinity of radiocommunication stations;

  • Calculation and visualization of exposure areas in horizontal and vertical planes;

  • Calculation of electromagnetic field levels at control points;

  • Convenient interface that allows you to quickly enter the parameters of many radiating sources;

  • Choice of many exposure limits recommended by different countries and organizations;

  • Reports on the electromagnetic field and the total exposure in graphical and tabular form;

  • Accounting for the calculation of terrain and buildings;

  • Using maps from OpenStreetMap, Google, Bing and other map services as a base map;

  • If necessary - easy and visual calibration of the custom base map in any image format;

  • Import of a 3D plan model in vector format from the OpenStreetMap project database with buildings height information.

  • Quick creation of a terrain model from an automatically loaded Digital Elevation Model (DEM);

  • Built-in editor of vector objects (buildings, labels, contour lines and terrain elevations);

  • Generation of a full report according to a custom Microsoft Word template;

  • Export to DWG/DXF AutoCAD file

  • Greater computing speed due to optimization of the algorithm and the use of streaming calculations. Calculations are distributed among threads, which makes it possible to perform computing 4-24 times faster (depending on the number of threads supported by the processor).

  • Using MSI Planet and NSMA antenna pattern files;

  • Built-in automatic unit converter between W, mW, dBW, dBmW

  • Visualization of calculations in 3D, export to an interactive 3D pdf file;

Installation and Activation

PC software requirement:

1. Windows 7/8/8.1/10/11 64-bit,

2. To use all EMF Planner features, the Microsoft Word and Excel must be installed on the computer.

The minimum computer configuration is 64-bit Windows, Core i3 CPU, 4GB RAM, 200GB HDD, video card, and monitor with support for 1920x1080, although the program can be installed on a less productive computer.

The recommended computer configuration is 64-bit Windows, Core i5 CPU, 16GB RAM, 256GB SSD, video card, and monitor with support for 1920x1080.

Run the Setup_ EMF Planner.exe file. Select your language and press the Install to launch the installation process. Click Next. To continue the installation process, read and accept the License Agreement. Activate the checkbox "I accept the terms in the License Agreement" and press Next.

After installing EMF Planner, you will see a new line in the Start menu and a shortcut on the desktop.

During the 7-day trial period, you can try out all the features of the program (without the project save function). To use the software after the trial period, you must purchase a license and activate the software.

To buy EMF Planner, click on Help - Purchase, after which the purchase page will open in the browser. After making a purchase, you will immediately receive an activation ID code to your email. Then click Help - Enter your Activation ID code, enter your code and click on ACTIVATE.

Software Update

Periodically, we release free, ongoing updates that improve the functionality and stability of the software.

EMF Planner supports both manual and automatic update checks. The program will check for available updates each time it starts. To check for updates manually, click Help - Check for Updates. If there is an available update, a window will open with current and available versions. Download the update from the link and install it manually (close EMF Planner before installing the update).

Quick Start. How to work with the EMF Planner
  1. Create a new project (it is created by default when you start the software).

  2. Enter the data for each of the radiating sources (frequency, system type, transmitter power, attenuation, antenna pattern, etc.) - see the Radiation Sources section.

  3. Set the required transmitter power conversion factors for each transmitter type in the Conversion Factors menu

  4. Set the required EMF exposure limits in the EMF Limits menu

  5. If you have your own map image to overlay the calculation visualization on it, then calibrate it as described in the Calibrate Map Image section. If you are going to use one of the standard base maps then skip this.

  6. Set a point of origin and calculation grid on the map - see "Origin and Grid" section.

  7. Set a location of each radiation source's antenna on the basemap as described in the Antenna Locations section.

  8. If you want to take into account the terrain in your calculation, then load it from our Digital Elevation Model (DEM) or draw it manually – see Terrain section.

  9. Load from the database or draw/edit using the built-in editor the surrounding buildings and specify the height of the buildings and the base elevation for each building (if you use terrain) -see the Buildings section.

  10. If necessary, put additional borders and labels on the map - see the section Lines and Labels.

  11. Calculate the exposure in horizontal and vertical planes at different heights - see Sections Horizontal Sections and Vertical Sections

  12. Get graphs and tables of the total values of the EMF and its components from different radiating sources at the required azimuths.

  13. Perform calculation of EMF levels at control points on the ground, on the roofs of buildings and inside buildings.

  14. Generate of a full report on a custom Microsoft Word template.

 

The software package contains several sample projects. We advise you to start with these samples.

User interface

The main menu is located on the left side of the main program window. Selecting one of the menu items next to it opens the panel corresponding to that item. You can change the size of the panels as needed using the separator.

When entering some menus, the base map will also appear on the right. You can choose to display one of the preinstalled basemaps, or set up your own basemap (see Settings).

Navigation on the base map is carried out using the mouse. Use the mouse wheel to move the map (you need to click on the wheel) and change the scale (Zoom) of the map (scroll the wheel forward / backward). The current Zoom is displayed next to the basemap name. The desired Zoom can also be selected from the drop-down list.

User Interface.png

User Interface

At the bottom, under the main menu, there is a panel with options for displaying various elements on the basemap.

Main toolbar:

2022-07-25_15-43-23.png

-  Standard tools for working with files: Create, Open, Save. Project files have *.xemf extension.

2022-07-25_15-44-09.png

- Save the project

2022-07-25_15-44-48.png

- Help

2022-07-25_15-45-27.png

- The current base map zoom and name

2022-07-25_15-46-20.png

- The tool "ruler," which allows measuring the distance and azimuth between any two points. To perform a measurement, click on the ruler, then click on any two points of the map and you will see the distance between the points and the azimuth from first to second. To exit, right-click anywhere on the map.

Radiating Sources

Entering the initial data on EMF sources is performed in the Radiating Sources window, which opens by default when the software is launched. 

Some important definitions:
 

Active EMF source

To the left of each of the EMF sources there is a mark about the activity of this source, which can be set and removed with a mouse click. ATTENTION: If the source is not active (the label is missing), then it is not taken into account in the calculations. You can make all sources active at once or turn them off by clicking on the corresponding tool in the toolbar or by clicking on the top cell of the column.

Current source (string)

Selected sources (strings)

The line with the EMF source that was last clicked. It is marked with a black triangle on the left.

Selected (highlighted) rows with EMF sources. In the table, rows can be selected in a row or in random order using Ctrl. The selected rows are highlighted with a blue background.

Radiating Sources Menu.png

Radiating Sources Menu

04.png
05.png
06.png
07.png
08.png
09.png
10.png
11.png
12.png
13.png
14.png
15.png

-  Create a copy of the selected rows

- Move selected rows up one position

- Move selected rows down one position

- Move selected rows to the beginning of the table

- Move selected rows to the end of the table

- Inclusion/Exclusion of all sources in the calculation. You can also make all sources active at once or turn them off by clicking on the column heading.

- Copy selected lines to clipboard

- Paste lines from clipboard (after current line)

- Calculate antenna beamwidths for all sources based on antenna pattern files. The values of the antenna pattern width in the horizontal and vertical planes are calculated according to the loaded antenna pattern data for a level of -3 dB and may differ slightly from the data specified by the manufacturer.

- Calculate the value of the antenna beamwidth for the current source

- Radiating source report in MS Word

- Radiating source reports in MS Excel

16.png

- Row colors Using this tool, the user can highlight rows in the list of radiation sources with different colors, which greatly helps when working with large tables (for example, in this way it is possible to highlight radiation sources belonging to different operators). To change the color of rows - select them in the table and click on the required color.

Radiating sources parameters:


Radiating sources name: Name of the source or type of equipment;
Type of service: System type from drop down list
Frequency, MHz: Radiating source frequency;
Transmitter power, W: Transmitter power. 
Transmitter power (in W) can be entered directly into the table by clicking once on this cell. When you double-click on the cell with the transmitter power value, a unit converter appears, in which you can enter power, for example, in dBm, after which automatic conversion to W will be performed and when you click OK, this value will be saved in the table.

Transmitter Power Unit Conversion.png

Transmitter Power Unit Conversion

Number of TX: The number of combined transmitters;
Total atten., dB – Attenuation in the feeder path. There are two ways to enter attenuation in the feeder path in the program. The first way is to directly change the attenuation value in the table by single-clicking on the required cell. The second way is to double-click on the cell and enter data for each of the elements of the feeder path in the form that appears, and the program will automatically calculate the attenuation value at the frequency specified by the source.

Feeder path attenuation calculation.png

TX path attenuation calculation

 

The length and number of jumpers is set as the sum of the corresponding lengths in meters, for example, if there are two jumpers, one 2m long and the other 3m long, then 2+3 must be entered in the corresponding field. The number of jumpers can be any, the number of connectors is calculated automatically according to the number of jumpers. After pressing the OK button, the value of the total attenuation is copied into the "Total Attenuation" cell. The characteristics of the feeder path elements are stored in the project file.

Even if you filled out this form and calculated the attenuation, then you can always change the attenuation value with one mouse click on the "Total Attenuation" cell.

 

Antenna model: The name of the antenna model is automatically taken from the name of the antenna pattern file, but it can be corrected manually.

When a source is selected, the antenna pattern of that source will be shown on the right side of the screen. The antenna pattern file must be loaded for each of the radiating source by clicking on the corresponding icon at the top of the radiation pattern.

Antenna azimuth, degrees: Antenna azimuth;

Antenna gain, dBi: Antenna gain;

Antenna height, m: The height of the antenna radiation center from the ground level or base elevation of the building (see Antenna Locations);

Antenna size, m: Vertical antenna size, or diameter for aperture antennas;

Mechanical tilt, degree: Mechanical antenna tilt. Down - negative value;

Electrical Tilt, degrees: The "electrical tilt" of the antenna, in degrees, is used for reporting purposes only.

Antenna BW H-plane, degrees: The width of the horizontal antenna pattern, used only for the report;

Antenna BW V-plane, degrees: The width of the vertical antenna pattern, used only for the report;

Location (Tower/Roof/Facade): Antenna location. "Tower" - the height of the antenna will be measured from the terrain elevation at the tower location point; "Roof" and "Facade" - the height of the antenna will be counted from the base elevation of the building on which the antenna is installed. For more details, see the Terrain section.

New or Existing: The radiating source status (used only for the report);

Owner: The name of the company that owns this radiating source (only used for reporting purposes). The name can be entered directly into the corresponding table cell (to do this, click on Specify manually), or you can select from the list that appears. This list can be edited in the Settings menu.

 

Some handy features when working with the radiating source table:

 

1. The order of the columns in the table can be changed, to do this, simply drag the column by its heading to a new position. The order of the columns is remembered when the program is closed.

2. The width of some columns can be changed at will, the width of the other part of the columns is set automatically.

3. In the table, you can select multiple rows in a row or individual rows with Ctrl

4. Selected lines can be moved, deleted and copied, as well as their color can be changed using the corresponding icons in the toolbar.

5. The copied lines can be pasted both in the same project and in another open in another instance of the application. The location of the antennas on the base map in the project to which the sources are copied will remain unchanged, since their location is tied to geographic coordinates.

6. To delete the selected rows, press the Delete key

7. You can enter one numeric value at the same time in all selected cells in one column. To do this, select the desired cells in one column in a row or individual cells using Ctrl and enter the desired numerical value.

8. To select all cells in a column, click on the column heading

9. To change the activity status of all sources, click on the heading of the first column

10. You can insert a column of data from Microsoft Word or Excel into the table via the clipboard using the keyboard shortcuts Ctrl+C/Ctrl+V or Ctrl+Insert/Shift+Insert

11. Antenna azimuth can be "0÷360" for which it is enough to enter any non-numeric character. The text "0÷360" will be included in the report and the azimuth 0° will be used for the calculation.

In the right part of the "Radiating Sources" window there is an antenna pattern of the current radiation source and tools for working with this antenna pattern.

17.png
18.png

-  Load antenna pattern in MSI or NSMA format

- Select antenna pattern from the list. Allows you to select an antenna from the antenna catalog with a preview. The path to the folder with antenna patterns is specified in the Settings menu. When you first click on the button Select antenna pattern from the list after starting the program, the directory of pattern files is scanned, which can take tens of seconds, depending on the number of files.

19.png

- Save the antenna pattern file in MSI format of the current source. This function is useful when you want to save a antenna pattern file from a third party project.

20.png
21.png
22.png

- Launch the installed Antenna Pattern Editor utility (https://www.wireless-planning.com/antenna-pattern-editor). With the Antenna Pattern Editor, you can view, edit, transform, normalize, digitize the antenna pattern from the image, etc.

- Rotate the vertical antenna pattern up 1 degree

- Rotate the vertical antenna pattern down 1 degree

Antenna pattern toolbar.png

Antenna pattern toolbar

Selecting antenna pattern from the catalog.png

Selecting antenna pattern from the catalog

In the lower right corner of the Radiating Sources panel there is a universal calculator that allows you to quickly calculate the value of the three quantities - transmitter power, attenuation in the feeder, or power at the antenna connector from two known values. Powers can be set in any units (W, mW, dB, dBW, dBmW).

Universal Calculator.png

Universal Calculator

EMF Exposure Limits

In this menu, you can select the EMF exposure limits recommended by some organizations and state administrations. In addition, up to 4 custom EMF exposure limits can be set.

 

Exposure limits are set using the coefficients E and A in the equation:

 

Limit=E*F^A

 

where F - frequency in MHz

 

These coefficients may be different depending on the frequency range.

Exposure Limits.png

Exposure Limits

Conversion Factors

This menu sets the conversion factor for different types of services. This is the factor by which the rated power of the transmitter is multiplied when calculating the electromagnetic field strength.

 

Using the toolbar, you can set the conversion factors in accordance with the Rec. ITU-T K.70 recommendation or make all the conversion factors equal to 1. The user can change these factors in the table manually.

 

If you set a conversion factor equal to zero in a table cell, then the conversion factor will be calculated according to the following equation:

 

K=(1+(n-1)*αPC* αDTX)/n

 

where:

n is the number of GSM carriers

𝛼𝑃𝐶 is 0.7 (power control)

𝛼𝐷𝑇𝑋 is 0.7 (discontinuous transmission)

Conversion Factor.png

Conversion Factors

Calibrate Map Image

It is assumed that the user will use one of the standard basemaps (OpenStreetMap, Google Sat, Bing, and others), and in this case, it is not necessary to calibrate the map image.

In cases where the base map at the site location is of poor quality or does not contain the necessary information, the user can use a custom raster image (png, jpg, bmp, tif, gif) as the base map. Anchoring and scaling a custom bitmap is done in the "Calibrate Map Image" menu.

After calibrating a raster image, work with it is carried out in the same way as with one of the map servers - in the list of servers, you only need to select "Calibrated Map Image" (the first one in the list).

Toolbar:

23.png
24.png
25.png
26.png
27.png

-  Load Image

- Delete Image

- Set the reference point and line on the image to the screen center

- Set the reference point and line on the base map to the screen center

- Refresh the pyramid of tiles

Navigation both on the image and on the base map is carried out by pressing the mouse scroll wheel, zooming in and out - by scrolling the wheel in one direction or another (like in AutoCAD, NanoCAD, etc.).

The user has two ways to calibrate a raster image - by a reference point and one reference line, or by two reference lines.

 

Calibration of a raster image by line and reference point

With this method, the user sets the same place on the raster image and the map (reference point), then, for scaling, sets the length of the known (reference) segment on the raster image.

Select the "Use line and reference point" method. Set the reference point on the raster image by dragging the appeared sign with the mouse. On the selected map on the right, you should also indicate the reference point in the same place. Then specify the known distance between two any points on the bitmap by dragging the ends of the reference segment to these points (shown in yellow) with the mouse. This can be any distance or overall size known to you - for example, the wall length of a building.

Now you can select in the right from the list of maps the very first "Calibrated map image" - this is the result of the binding. If you have performed the calibration again, then you should click on the toolbar "Refresh the pyramid of tiles".

Calibration of a raster image by line and reference point.png

Calibration of a raster image by line and reference point

Calibration of a raster image by two lines

 

With this method, the user specifies the same reference lines on the raster image and on the base map on the right. Thus, both scaling and georeferencing are performed at once.

Select the "Use two lines" method. After loading a raster image, specify the reference line on it, and then set the line corresponding to it on the base map. After that, you should select the base map "Calibrated map image" - this will be the result of the binding. If you have performed the calibration again, then you should click on the toolbar "Refresh the pyramid of tiles".

Calibration of a raster image by two lines.png

Calibration of a raster image by two lines

Setting the Origin and Calculation Grid

The origin is a point with coordinates X=0 and Y=0, relative to which the coordinates of all radiation sources and control points are indicated (in meters). The location of the origin point can be changed at any time, while the location of antennas and control points on the base map will not change, since they are tied to geographic coordinates. Only the coordinates of the antennas and control (in meters) points relative to the origin will change, which will not affect the calculation results. You can choose any point as the origin of coordinates. For example, it could be one of the antennas, the center of a tower, or the corner of a building. Moving the origin of coordinates is carried out by dragging the mouse. You can also set the origin of coordinates by right-clicking the mouse.

Origin and Grid.png

Origin and Grid

Toolbar

25.png
26.png
28.png

-  Show origin point at screen center

- Set origin point in the screen center

- Set the size of the calculation grid relative to the origin

- Site coordinate for the report

Site coordinate

25.png

- Display the site at the screen center

29.png

- Insert origin point coordinates

After setting the origin of coordinates, be sure to specify the calculation grid dimensions. The grid is set relative to the origin using the appropriate tool on the toolbar. Do not make the grid size too larger than the expected size of the exposure area, you can increase it later at any time. The grid size can also be changed by moving its borders with the mouse.

Calculation Grid.png

Calculation Grid

Grid dimensions.png

Grid dimensions

Enabling/disabling the display of the origin and grid on the map is performed in the "Display Options" panel under the main menu.

Antenna Locations

In this menu, the placement of antennas of radiation sources on the situational plan is carried out.

Antenna Locations.png

Antenna Locations

The antenna location can be set in one of the following ways:

1. Input in the table the X and Y antenna coordinates relative to the origin (in meters).
2. Move the antenna to the desired location on the base map using drag and drop.
3. Select the desired antennas in the table, then right-click on the desired location and select "Move selected antennas" from the context menu.
4. Move the antenna using the toolbar.

 

Toolbar:
 

25.png

-  Position the map to a point with a selected antenna

26.png

- Move selected antennas to the screen center

30.png

- Move all selected antennas to the current antenna point

31.png

- Move all selected antennas to the origin

32.png

- Move origin to current antenna point

Maximum capture distance is the conditional distance at which the antennas are "attracted" during mouse dragging.

The parameters for displaying antennas on the situational plan are controlled in the "Display parameters" panel, located under the main menu.

Buildings

In this menu, the user can create and edit a buildings layer. These buildings will then be taken into account when performing calculations and preparing all types of reports.

Buildings.png

Buildings

Toolbar:

33.png

Select a building

34.png
35.png
04.png

Load building polygons within the screen from the OpenStreetMap database

Add building. Building drawing tool. The last segment will appear automatically when you click the right mouse button. After drawing, specify the parameters of the building.

Create a copy of the selected building

37.png
38.png
39.png
40.png

Delete selected building

Delete all buildings

Add node. Adds a node to the outline of the selected building.

Import building polygons from a KML file

41.png

Fill in all building's base elevation based on the terrain data. In this case, you can choose how the base elevation of buildings will be determined - by the minimum, maximum or average value of the elevations of the corners of the buildings.

42.png
43.png
undo.png
redo.png
44.png
move.png

Square building corners

Delete node. Removes a node from the outline of the selected building.

Undo

Redo

Move the selected building to the back

Move all buildings by one pixel

Building parameters

Text: in this field, you can enter a label that will be displayed on the building;

Building height, m: Building height in meters;

Base elevation, m: Building base elevation in meters relative to sea level; If the project takes into account the terrain, then building base elevation must be specified for all buildings that fall into the calculation area (by default, they are all equal to 0). Building base elevation is the surface of any structural element of a building or structure (for example, the floor level of the 1st floor, the top of the foundation, etc.). Building base elevation is needed to correctly take into account the relative position of the antennas that are located on the roofs and facades of various buildings. Since when placing antennas on a building or antenna support, designers set the antenna suspension heights relative to the base elevation of this particular building or antenna support.
For a quick initial filling of zero values for buildings, use the button "Fill in all buildings base elevation based on the terrain data".

 

Take into account attenuation inside building: Enable/disable ability to apply custom attenuation to this building.
Show on horizontal cut: Enabling/disabling the display of this building on horizontal cuts.

 

Calculation Parameters

Do not use buildings in the calculation. If this option is active, then buildings do not affect the calculation in any way.


Complete EMF shielding by buildings. Shielding means the complete absence of the level of the electromagnetic field at a given point from the source, if the line of sight from this source to this point is closed by the building.


Take into account attenuation inside buildings. With this option, the user can set the loss for the penetration of the electromagnetic field into the building for two frequency bands. In this case, outside buildings, the EMF level will be calculated for line-of-sight conditions (without shielding).

Building display options

Select the thickness and color of the lines with which the buildings will be displayed, as well as the font size for the labels on the buildings.

The parameters for displaying buildings on the map are configured on the "Display Options" panel located in the main menu.


In EMF Planner, there are three ways to create a building layer:

1.    Import of buildings from the database of OpenStreetMap (OSM) open project www.openstreetmap.org with the possibility of further additions/editing if necessary. A layer of buildings with height and number of floors is imported, which allows you to quickly get a 3D map model, bypassing the routine stage of manually drawing buildings. This greatly speeds up the data preparation stage.

2.    Import building from a KML file

3.    Drawing buildings - Manual digitization of the building's contours from the base map, with manual input of the height of buildings.


Import from OpenStreetMap Database

To import a layer of buildings from the OpenStreetMap database within the screen boundaries, click on the button "Load building polygons within the screen area from the OSM database". You should not select an area with a size much larger than necessary for calculations, as this may slow down the speed of work. A window will appear warning that all missing buildings within the screen will be loaded from the OSM database. This is done in order to be able to supplement the previously loaded buildings, the height parameters of which have already been edited by the user. If a building has already been loaded earlier, then, provided that the contours of the building have not changed, it will not be loaded from the database (because the height, number of floors and the base elevation mark of the building can be already edited). Then a window will appear with a choice of parameters for the height of buildings. The database of the OpenStreetMap project more often contains information about the number of floors of a building than information about its height in meters, so if the height of the building is not explicitly specified in the OSM database, then during import it is determined by the number of floors and the height of one floor. In the same window, you must specify the height for buildings whose information about the number of floors is not available in the OSM project database. In addition, here you can enter the base elevation for all imported buildings.

Building height selection options.png

Building height selection options

Import from KML file


The software also allows you to import a building layer from a custom dataset via the KML format. In order to get building heights and labels, they must be specified in the name of each building polygon in the format: height; label.

Building polygons in KML.png

Building polygons in KML

Drawing buildings

Use Building drawing tool. The last segment will appear automatically when you click the right mouse button. After drawing, specify the parameters of the building.

Terrain

If the area around the site has a terrain with a significant difference in elevation, then it should be taken into account in the calculations.
In the Terrain menu, EMF Planner allows you to digitize the terrain using a fairly simple built-in toolkit. It allows you to specify the parameters of contour lines and elevation points on the map, after which a digital elevation model will be built using the triangulation method.
Strictly speaking, it is impossible to turn off the use of terrain in the EMF Planner, but by default the height of all terrain points is 0, that is, all buildings are located, as it were, on "flat" terrain with one elevation equal to 0, and if you do not need to take into account the height difference on the map, then you can not enter the Terrain menu.

Terrain Menu.png

Terrain Menu

Toolbar:

33.png
45.png
46.png
DEM.png
04.png
47.png
48.png
undo.png
redo.png
49.png
39.png
43.png

Select object (elevation point or elevation contour)

Add elevation

Add elevation contour

Use DEM data as terrain elevation

Create a copy of the selected object

Delete selected object

Delete all objects

Undo

Redo

Show triangulation result

Add node on selected elevation contour

Delete node on selected elevation contour

To draw a contour line, press the button "Add terrain contour line" and draw the contour line with a mouse click (to finish drawing, click the right mouse button). Then you need to specify the elevation of the contour. To complete the work of drawing contour lines on the situational plan, double-click with the right mouse button, and you will switch to the Object Selection tool.


In addition to terrain contours, you can add terrain elevation points to the map. To do this, press the button "Add terrain elevation", then specify the location with the mouse and enter the value of the elevation.


Both contour lines and point elevations can be selected, moved with the mouse, and deleted with Delete.


The program allows you to quickly create a terrain model from an automatically loaded DEM. To do this, set the screen area of the desired size (the elevations will be loaded within the screen boundaries) and click the button. After that, the entire existing terrain on the situational plan will be deleted (if it has already been created by that moment) and elevation data will be loaded onto the entire screen area. These elevations can be manipulated as if they were manually created – they can be moved, edited and deleted.
After all the necessary horizontals and (or) individual elevations of the terrain are marked, click on the button "Show triangulation result", after which a digital elevation model of the terrain will be built, triangulation triangles will appear on the situational plan, and at the bottom in the status bar, along with current coordinates will display information about the height of the terrain at the location of the mouse pointer. Triangulation is also performed automatically when you exit the terrain panel.
Enabling/disabling the display of terrain contours on the map is performed in the "Display Options" panel located under the main menu.

Lines and Labels

In this menu, you can add linear objects (roads, barriers) and point objects to the map - labels and a schematic representation of antenna towers.

Toolbar:

33.png
34.png
add road.png
add barrier.png
add a label.png
04.png
47.png
48.png
undo.png
redo.png
39.png

Select object (line or label)

Load polylines of roads and railings within the screen from the OpenStreetMap database

Add road

 

Add a barrier

Add a label

Create a copy of the selected object

Delete selected object

Delete all objects

Undo

Redo

Add node on selected elevation contour

43.png

Delete node on selected elevation contour

break knot.png
move.png

Break knot on selected line

Move all objects by one pixel

EMF Planner allows download roads and barriers from the OpenStreetMap database. To do this, set the desired area of the screen and click on the download tool on the toolbar.

To draw a road or a barrier manually, click on the corresponding tool and draw the object with a mouse click (to finish drawing the object, click the right mouse button). Then enter the parameters of the object - the type and thickness of the lines. In the selected object, you can drag nodes with the mouse. In the selected object, you can also delete, break, and also add nodes - to do this, click on the corresponding tool, and then on the desired node on the object or on the place on the object where you want to add a node.

Road Drawing.png

Road Drawing

In addition to lines, labels can be added to the situational plan. To do this, click the button   (Add label), then point the mouse at the place and enter the text. If you now click somewhere else on the screen, this label will also appear there. In the window that appears, you can change the label parameters.

Using the toolbar, you can also delete, duplicate selected objects, and move all objects.

The parameters for displaying lines and labels on the map are controlled in the "Display Options" panel located under the main menu.

 

Drawing antenna towers on the map

 

EMF Planner allows to map antenna towers - towers / masts located on the ground or supports on the roofs of buildings, after which these structures will appear on vertical cuts and 3D visualization.

In order to install the antenna support, you need to create a label in this place with a special code like Tower/H1/H2/L1/L2, where H1,H2,L1,L2 are the parameters of the antenna tower:

antenna tower parameters.png

Antenna tower parameters

If H2=0, then the antenna tower takes the form of a rectangular prism. If the antenna tower falls into the contour of a building, it will mean that it is located on the roof of this building.

Drawing antenna towers on the map.png

Drawing antenna towers on the map

Antenna tower on the ground in a vertical cut.png

Antenna tower on the ground in a vertical cut

Performing calculations
Vertical Cuts

The calculation is performed for cuts marked as active in the list. You can select multiple checkboxes at once with the mouse and then enable or disable them.

Vertical Cut.png

Vertical Cut

Toolbar:

50.png
51.png
52.png
53.png
54.png
55.png
56.png
57.png
58.png
59.png
60.png
14.png

Fill in the list of vertical Cuts by azimuths of antennas of active radiating sources

Fill in the list of vertical Cuts according to the azimuths of the active radiating sources antennas, taking into account bidirectional antennas, for which the direction of the Cut will be determined by the radiation pattern maximums

Add additional vertical cuts in a range of angles from the origin

Sort Cuts by azimuth

Calculation of all active vertical Cuts with grid №1

Calculation of all active vertical Cuts with grid №2

Calculation of the selected vertical Cut with grid № 1

Calculation of the selected vertical Cut with grid № 2

Reduce the length of the Cuts according to the results of the calculation

Reduce the height of the Cuts according to the results of the calculation

Delete all dimension lines for all Cuts

Reports for vertical Cuts

Display Options: Set Display Options for Vertical Sections

The list of vertical cuts can be generated automatically for each of the radiation sources by pressing the button "Fill the list of vertical cuts with the azimuths of antennas of active radiation sources". The planes of each of these cuts pass through the corresponding source in the direction of its radiation. The list itself, as well as individual parameters of each of the cuts, can be edited. At the bottom of the window there is a figure explaining the cuts parameters.

Using the buttons on the toolbar, you can perform the calculation in all or in individual cuts with different grid (1 or 2) at once. The calculation results for the cut will be displayed on the right when you click on the line of the corresponding cut.

After changing the vertical cut calculation parameters in the table, recalculation does not occur automatically so that the parameters are applied - perform the calculation in this cut (or cuts).

On the image of cuts, the characteristic measurement lines (dimensions) will be shown in red. The display of these lines can be controlled on the left in the Display Options menu. The user can add additional measurement points using the context menu that appears when the right mouse button is clicked on the image of the vertical cut.

Horizontal Cuts

There are two types of calculation for horizontal cuts:

1.    Calculation for one exposure limit for different heights. In this case, the user can select the color and line type for cuts at different heights.

2.    Calculation for several exposure limits for the same height or for the projection of a cut set at the terrain. In this case, the cut color is given by the color of the corresponding exposure limit. If one height is given, then the cut will be made exactly at that height. If several heights are specified, then the maximum impact area from this range of heights will be projected onto the terrain.

Calculation for one exposure limit for different heights.png

Calculation for one exposure limit for different heights

Toolbar:

 

Display the calculation area in the center of the screen

25.png
26.png
28.png

Move the calculation area to the center of the screen

Set the size of the calculation grid relative to the origin

50.png

Fill in the list of horizontal cuts with the heights of antennas of active radiating sources

61.png

Add to the list of horizontal cuts the heights of the maxima of vertical cuts (if a calculation has already been performed in vertical cuts)

62.png

Add to the list of horizontal cuts the heights of the maxima of vertical cuts + addition (if the calculation has already been performed in vertical 

52.png

Add cuts with heights in the specified range

53.png

Sort the list of cuts by height

63.png

Set one color for the selected Cuts (the color is taken first in the selected list)

64.png

Set different colors for all cuts

65.png

Set different line types for all cuts

66.png
54.png

Set vertical Cut along the ruler (if the ruler is active)

Calculation of horizontal cuts with grid №1

55.png
14.png

Calculation of horizontal cuts with grid №2

Reports for horizontal cuts

The calculation is performed for cuts marked as active in the list. You can select multiple checkboxes at once with the mouse and then enable or disable them.

Calculation for several exposure limits for the same height or for the projection of a cut

Calculation for several exposure limits for the same height or for the projection of a cut set at the terrain

The blue color on the map shows the boundaries of the grid in which the calculations of horizontal cuts will be performed. Resizing this grid is done by shifting its borders with the left mouse button or using the "Set the size of the calculation grid relative to the origin" tool. For the correct display of the background of the cuts, it is necessary that this section be entirely in the calculation grid.

 

The table "Parameters of horizontal cuts" contains a list of heights for which calculations will be performed. The calculation will be performed only for cuts marked as active. The number of cuts, their heights, as well as the background color and line type for cut contours can be changed in the table. To delete several cuts in the table at once, select them with the mouse pointer and press Delete. Click on the button "Fill in the list of horizontal cuts with the heights of antennas of active radiating sources" to generate this list automatically by the heights of active radiating sources. The heights of the cuts are indicated from the origin. Before performing a calculation in horizontal cuts, it is recommended to first perform a calculation in vertical cuts so that you can use the tools  "Add to the list of horizontal cuts the heights of the maxima of vertical cuts" or  "Add to the list of horizontal cuts the heights of the maxima of vertical cuts + addition ". The list of horizontal cuts formed using these tools will include heights with maxima in the area of exceeding the exposure limit.

Make a projection of the lower cuts onto the upper ones – an option that allows you to get the maximum exposure area in the drawing with the image of the horizontal cut without taking into account the possible reduction in the area of the upper sections.

 

Merge cuts of the same color - an option in which cuts of the same color, going in a row, overlap each other and shift to the height of the smallest cut.

The options “Make a projection of the lower cuts onto the upper ones”, as well as “Merge cuts of the same color” are needed to visually represent areas with exceeded exposure limits in the drawing of horizontal cuts. For more accurate display of cuts, as well as for further 3D visualization, these options should be disabled.

Calculation result with disabled options Make a projection of the lower cuts onto the uppe

Calculation result with disabled options " Make a projection of the lower cuts onto the upper ones ", and " Merge cuts of the same color"

Calculation result with the option Merge cuts of the same color enabled.png

Calculation result with the option " Merge cuts of the same color " enabled

Calculation result with the option Make a projection of the lower cuts onto the upper ones

Calculation result with the option “Make a projection of the lower cuts onto the upper ones”

It should be taken into account that changing the state of activity of rows in the "Parameters of horizontal cuts" table, as well as the colors and types of the cut lines after the calculation, not only changes the display of the cuts, but also is the initial data for the next calculation. Therefore, we recommend that after changing the parameters in the "Parameters of horizontal sections" table, always perform a new calculation. After the calculation is completed, the result may change, because when using the options "Make a projection of the lower cuts onto the upper ones", and "Merge cuts of the same color", some sections affect others.

The parameters for displaying horizontal cuts on the map are controlled in the "Display Options" panel located under the main menu.

On the map, purple dashed lines show the projections of vertical cuts for which the calculation was performed. To quickly view the cut, click on the corresponding line, and a pop-up window with this vertical cut will appear on the screen.

Quick view of vertical cut.png

Quick view of vertical cut

Tables and Graphs

In this menu, you can get graphs and tables with the results of calculating the levels of the electromagnetic field and exposure based on the forms of standard aliases.

Tables and Graphs.png

Tables and Graphs

Toolbar:

14.png

Create a report in Microsoft Word

Point Calculations

In this menu, you can get the result of calculating the EMF level and exposure at control points.

Control Points.png

Control Points

Toolbar:

25.png
26.png
67.png
05.png
06.png
68.png
69.png
70.png
14.png

Position the map to the selected point

Move selected points to the center of the screen

Create a point in the center of the screen

Move Selected Point Group Up

Move Selected Point Group Down

Move points that are less than 2 meters away from the antenna azimuth line exactly on the antenna azimuth line. The control points will appear exactly on the corresponding vertical cuts.

Calculation at all points

Calculation at a selected point for a range of heights

Point reports

You can combine control points into several groups. This is done for convenience when working with large maps to separate control points located, for example, near different buildings. Groups can be made active or inactive (then they will be excluded from the calculation).

A control point can have one of three location types - Ground, Building, or Window. For Building or Window locations, the height of the control point will be referenced from the base elevation of this building. For the "Ground" location, the height of the control point will be measured from the terrain elevation at this point.

When calculating for control points of the "Building" or "Earth" types, the level of the electromagnetic field will be determined from all radiating sources that are not shielded by neighboring buildings, taking into account the set attenuation. If the control point is of type "Building", then the shielding of the building in which this control point is not taken into account.

For points of type "Window", the level of exposure will also be determined from all radiating sources that are not shielded by neighboring buildings, taking into account attenuation. Additionally, the location of this point inside the building near the window is modeled. This is done as follows - during the calculation, the wall of the building closest to this point is determined, and this wall is made "transparent" for those radiating sources whose direct rays enter the given point through this wall.

A control point can be created using the corresponding button on the toolbar or using the context menu on the base map. The control point can be moved by dragging it with the left mouse button, or removed by selecting it with the right mouse button on the situation plan. You can also change the location of the control point by entering the appropriate X and Y coordinates in the table. Control points can be deleted by selecting them in the table and clicking Delete. 

Calculation at all points.png

Calculation at all points

Calculation at a selected point for a range of heights.png

Calculation at a selected point for a range of heights

You can control the display of Control Points in the "Display Options" panel under the main menu.

Report by Template

In this menu, with one click of the mouse, you can get a complete report that includes everything you need - initial data, calculation results in the form of tables and graphics, as well as an explanatory note. 

Local reports can be quickly obtained in the respective menus - Radiating Sources, Point Calculations, Horizontal cuts, Vertical cuts, Tables and Graphs. Local reports are alias, which are prepared by the developers of the EMF Planner. These are various versions of tables with initial data, as well as tables, graphs and drawings with calculation results. The specification of these bookmarks is given in Appendix 1. The list of aliases is constantly updated at the request of users.

The general report is generated based on a Microsoft Word template and can contain both standard and custom aliases.

Custom are aliases with the syntax of the form {Base station No.}, {Object placement address}, and so on. These are variables that the user places in the text of the report template, so that later, after the report is generated, they can be replaced with values from a specific project. The user himself determines what the alias name corresponds to in each project in the correspondence table {Alias name} = Alias text.

A Microsoft Word template (*.dot extension) is a document used as a template for creating new documents. A template can contain its own style, formatting, arbitrary text, and embedded aliases.

Custom aliases.png

Custom aliases

Toolbar:

14.png
71.png

Create a general report from a Microsoft Word template

Show a list of standard aliases for a general report

Path to the report template file. If the template file is located in the folder with the project file, then you can only specify the file name with the extension.

 

Custom aliases Toolbar:

72.png
73.png
74.png

Copy alias set to clipboard

Paste a set of aliases from the clipboard

Restore the original set of custom aliases

The procedure for preparing a general report:

1.    In the "Custom aliases" table, specify the names and corresponding text for custom aliases. Custom aliases can be copied from project to project using the corresponding toolbar buttons.
2.     Familiarize yourself with the specification of standard aliases in the menu Report by template - List of standard aliases (see Appendix 1).
3.    Create a report template with the *.dot extension, placing the names of custom and standard aliases in the template at your discretion. When generating a report, instead of these aliases, the EMF Planner will insert the corresponding data. Along with the program distribution kit, in the Templates folder, there are several *.dot templates prepared by us, on the basis of which the user can create his own templates.
4.    Specify the path to the template file
5.    Click the Create report button

Export to CAD

EMF Planner allows you to export the results of calculations in horizontal cuts to a DWG or DXF AutoCAD file with separation by layers.

Export to DWG_DXF CAD file.png

Export to CAD

Toolbar:

19.png

Scale

Size

Export horizontal cuts drawing to DWG/DXF file

Selecting the drawing scale from the drop-down list

Selecting the paper size

Select the layers you need, sheet format, drawing scale and click "Export drawing to DWG / DXF file". The selected elements will be saved in different layers of the CAD file.
When exporting, the base map will be saved in the drawing file with the current zoom, so in order to get a high-quality image of the base map, you should set a large zoom (it may take additional time to load the base map).

3D visualization

EMF Planner allows you to perform 3D visualization of the calculation results of exposure area cuts, maps with buildings, roads, terrain and antenna supports. 3D visualization allows the user to view the shape of the exposure area in detail from different sides, taking into account all the surrounding structures. The resulting 3D visualization can be exported to PDF format.

To create a 3D visualization, perform the calculation in vertical and horizontal cuts and then go to the 3D visualization menu. When calculating in horizontal cuts, the options "Make a projection of the lower cuts onto the upper ones" and "Merge cuts of the same color" must be disabled.

In order for the 3D visualization of the expose area to look more voluminous, the horizontal cuts must be evenly and quite often distributed over the heights.

The 3D visualization controls are at the top. Rotation of a 3D visualization is most conveniently performed using the ViewCube in the upper right corner. The ViewCube is a cube-shaped widget placed in an up right corner of the window. When used as an orientation controller, the ViewCube can be dragged, or the faces, edges, or corners can be clicked on, to easily orient the scene to the corresponding view. When acting as an orientation indicator, the ViewCube turns to reflect the current view direction as the user re-orients the scene using other tools.


To export 3D visualization to an interactive pdf file, click on "Export to PDF".

Please pay attention! If you are unable to make a 3D visualization, then most likely due to the fact that there are elements of the old project that are far from the calculation area. This often happens when the user makes his project based on a sample. Please remove these elements using the tool on the top toolbar:

3D visualization.png

3D visualization

Settings

This menu allows you to configure some project and application settings.

Settings.png

Settings

Reflection coefficient k=1-1.6

Electric field strength reflection coefficient k=1-1.6

Maximum matrix size

The maximum size of the matrix side, which is reserved in memory for calculations in cuts (50...1000). Small matrix size - for rough (fast) calculation, large size - for precise calculation (slower)

Path to the map cache folder

The path to the folder where downloaded base map tiles will be saved for quick access. This will speed up the application. The downloaded maps will remain on your computer and you will be able to view them when you do not have an Internet connection. This folder is created automatically when the application is launched for the first time. You can change this folder.

Path to the folder with antenna pattern files (to display the list of antenna patterns)

Path to the folder with antenna patterns. When selecting the antenna pattern from the list, the user will have the opportunity to familiarize himself with the pattern of any antenna before selecting it.

Proxy Settings

If you are using a proxy server to access the Internet, enter its IP-address and port number. If the proxy server requires authentication, enter the username and password.

Owner list

List of owners of radiating sources for quick selection. This list will appear when you click in the "Owner" column in the "Radiating Sources" windows.

Coordinate Format

Geographic coordinate format:
- Decimal Degrees (N44.345678 W134.567893)
- Degrees, Minutes, Seconds (N440 34’ 23.7’’ W1340 29’ 23,4’’)
- Degrees, Decimal Minutes (N440 34.2356’ W1340 29.2354’)

Base map settings

You can configure your own custom base map by specifying a tile server URL.