Creating Your Own Propagation Model
If the available propagation models do not meet your needs, you can develop your own custom propagation model. Use one of the standard propagation models as a model for creating your own code (they are located in the <reldir>/sys/utilities/tmm directory).
Each propagation model requires three files, as described in the following table.
Table 6: Propagation Model Files
| Name | Suffix | Description |
|---|---|---|
| Parameter file | .prop.p |
Contains parameter names and values. |
| Description file | .prop.d |
Contains the model name, default parameter file name, shared library file name, and model comments. |
| Source code file | .ex.c or .ex.cpp |
Contains the code defining the propagation model (C or C++) |
Both the parameter (.prop.p) and description (.prop.d) files are text formats that you can open with any text editor or the Edit > Open > Edit Pad menu item. The source code for a propagation model can call functions from the Terrain Modeling Module (TMM) library (described in Chapter 23 “TMM Package” on page 1) and the Prg library (described in the API reference manuals). Propagation models cannot use the Simulation Kernel library functions (KPs).
When compiling the source code file for your propagation model, follow these steps:
Procedure 15: Compiling Source Code for a Propagation Model
-
Use op_mko to build an object (
.objor.o) file. Alternatively, you can compile the source code by choosing File > Open > External Source from the Riverbed Modeler main window and then select Compile from the External Source editor menu item. -
Use op_mkso to create the necessary shared object file. You must specify the type of shared object to build and which simulation kernel (development or optimized) it will be used with, as follows:
For the development kernel (
.dev32dllor.dev32.sofiles):op_mkso -type tmm -kernel_type developmentFor the optimized kernel (
.opt32.dllor.opt32.sofiles):op_mkso -type tmm -kernel_type optimizedThe
tmmdirectory contains sample shell scripts for the commands that need to be issued.