TmmT_Path_Loss_Calc_Method

注意: 需要地形建模模块(Terrain Modeling Module)功能。

摘要

回调:按需调用,为传播模型执行路径损耗计算。

语法

<path_loss_calc_method_name> (model_ptr, tda_state_ptr, tx_position_ptr, rx_position_ptr, center_frequency, bandwidth, verbose, status_ptr, message_buffer_v)
参数 类型 说明
model_ptr TmmT_Propagation_Model * 与此方法关联的传播模型。
tda_state_ptr void * 从流水线阶段(pipeline stage)传入的参数(见详情)。
tx_position_ptr TmmT_Position * 发射机的位置(纬度、经度和海拔米数)。
rx_position_ptr TmmT_Position * 接收机的位置(纬度、经度和海拔米数)。
center_frequency double 路径损耗计算的中心频率,单位为赫兹(Hz)。
bandwidth double 路径损耗计算的信号带宽,单位为赫兹(Hz)。
verbose int 错误消息使用的 verbose 模式,OPC_TRUE(详细输出)或 OPC_FALSE。
status_ptr TmmT_Loss_Status * 路径损耗计算的状态,为 TmmC_Loss_Valid、TmmC_Loss_Error 或 TmmC_Loss_No_Closure 之一。
message_buffer_v char 用于填写文本消息的区域(见详情)。

返回类型

double

计算得到的路径损耗,以信号增益表示,单位为分贝(dB)。该值为 0.0(近场)或负值。

头文件

tmm.h

详情

该回调为 model_ptr 指定的传播模型执行路径损耗计算。在初始化传播模型时,应将此回调指定为该模型的 path_loss_calc_method。

tda_state_ptr 参数供你的流水线阶段在需要时向路径损耗计算函数传递参数(与仿真 Packet 提供 TDA 的方式类似)。当 Project Editor 调用传播模型时,该参数为 OPC_NIL。

message_buffer_v 参数为路径损耗计算提供报告计算损耗值过程中任何问题或错误文本消息的位置。该变量是一个二维数组,由五个 512 字符缓冲区组成。

用途

用于为传播模型执行路径损耗计算的回调。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com