Specifying Materials
The path loss calculated for each voxel includes the effect of all materials the signal encounters between the transmitter and receiver. Your 3-D model should specify the material for each part of a structure (walls, floors, windows, and so on).
The Urban Propagation Module contains electromagnetic properties for several predefined materials. When UPM generates the material database, it uses these known properties for any materials in the 3-D model that match the name of a predefined material. Materials used in the 3-D model, but not recognized by the Urban Propagation Module, are defined in the material database as follows:
- Transparent materials such as glass are treated as totally transparent to RF (same parameters as "freespace").
- All other materials are treated as totally reflective of RF (same parameters as "ideal_reflector").
Table 2: Parameters of Built-in Materials
| Name | k | c | d |
|---|---|---|---|
| freespace | 1.0 | 0.0 | 0.0 |
| ideal_reflector | 0.0 | 10⁷ | 0.0 |
| concrete | 5.31 | 0.0326 | 0.8095 |
| brick | 3.75 | 0.038 | 0.0 |
| plasterboard | 2.94 | 0.0116 | 0.7076 |
| wood | 1.99 | 0.0047 | 1.0718 |
| thick_glass | 6.27 | 0.0043 | 1.1925 |
| glass | 1.0 | 0.0 | 0.0 |
| ceilingboard | 1.50 | 0.0005 | 1.1634 |
| chipboard | 2.58 | 0.0217 | 0.7800 |
| floorboard | 3.66 | 0.0044 | 1.3515 |
| metal | 0.0 | 10⁷ | 0.0 |
| water | 80.0 | 0.574911 | 1.16991 |
| dry_sandy_soil | 2.57 | 0.00101776 | 0.874001 |
Editing the Material Database
The material database lists the materials used in the 3-D model and specifies the electromagnetic properties of each for use in path loss calculations. The database is a text file with the extension .mtl that is created from information in the 3-D model.
Each line in the material database contains space-separated parameters that specify the name, display color, and electromagnetic properties of a single material. The format is:
code name red green blue propagation_flag k c d [comment]
Table 3: Material Database Parameters
| Parameter | Description |
|---|---|
| code | a unique printable ASCII character |
| name | name of the material, as given in the 3-D model (cannot contain spaces) |
| red | red value of the RGB display color (0–255) |
| green | green value of the RGB display color (0–255) |
| blue | blue value of the RGB display color (0–255) |
| propagation_flag | "1" if the material allows a radio signal to pass through it, "0" if not |
| k | relative dielectric constant |
| c | ITU parameter (described below) |
| d | ITU parameter (described below) |
| comment | an optional comment |
The ITU parameters c and d specify the conductivity of the material as a function of f (frequency in GHz), as given by this equation:

The calculation of material effects is based on the ITU recommended attenuation model described in this International Telecommunications Union document:
Recommendation ITU-R P.1238-7 (02/2012). Propagation data and prediction methods for the planning of indoor radio communication systems and radio local area networks in the frequency range 900 MHz to 100 GHz.
Procedure 1: Editing the Material Database
This procedure assumes that you have already run a simulation with the 3-D model and have existing material database and geometry database files for the scenario.
- Using any text editor, open the geometry database file you want to modify. This file will have a name of the form
<model>.dae.geom_<resolution>. (Because the contents of the material database are duplicated in the geometry database, you can edit the material information in the geometry database directly and save a few steps.) - Enter the new electromagnetic properties (propagation_flag, k, c, d) for each material you want to specify.
- Save the geometry database file.
Note: Delete or move all of the power database files for the scenario (with names of the form sim-data-<model>.dae-<res>-<x>-<y>-<z>.pdb) before rerunning the simulation.
End of Procedure 1