Rural simulation through API, propagation model questions

Roland Sipos

Hello,

1 have 3 questions regarding propagation models when doing Rural simulation through the API both with pixel and vector databases (the purpose is to actually change the propagation model parameters). 

Regarding  pixel databases, OutdoorPlugIn_ComputePoints().
1:
For WinProp_ParaMain::PredictionModelRural, the API reference guide, (and engine.h ) says only 5 propagation models are available (eg. PREDMODEL_RURAL_ITU526 , PREDMODEL_RURAL_ITU1546 are missing). Am I correct to assume that all (8) prediction models can be passed here as defined in API reference under "Outdoor Wave Propagation"->„Defines and Constants”  -> "Selection of rural prediction model." (and OutdooPlugin.h defines)?
2:
For most prediction models they have a dedicated structure for their paramters like Model_RuralITU1546 , Model_DetTwoRay , Model_RuralITU526 , Model_RuralITM , Model_RuralPE, Model_DPM.
I'm not sure where I have to pass these to  OutdoorPlugIn_ComputePoints() function, for Urban models there is the  "ParameterModelUrban" parameter, but it says "urban"... Is this paramter used to pass Rural structures as well?  

Regarding vector databases, WinProp_Predict_Points()
3: 
For WinProp_Antenna:model,  API reference and antenna.h says only 5 propagation models are available, missing some ray tracing options, like vertical/rural ray tracing, bounving raxys. 
Am I correct to assume that all (7) prediction models can be passed here as defined in API guide under "WinProp Wave Propagation Interface"->„Defines and Constants”  -> "Selection of simulation models." and (engine.h defines), including WINPROP_MODEL_VRT and WINPROP_MODEL_SBR?

Thank you very much.

 

reinerh

Hello Roland,

please find here my feedback on your questions:

For Q1 indeed 8 rural prediction models can be selected for OutdoorPlugIn_ComputePoints() or OutdoorPlugIn_ComputePrediction():
PREDMODEL_RURAL_HATA                                
PREDMODEL_RURAL_2RAY_EMP  
PREDMODEL_RURAL_2RAY_DET                            
PREDMODEL_RURAL_RDP                                 
PREDMODEL_RURAL_PE                                  
PREDMODEL_RURAL_ITU1546                            
PREDMODEL_RURAL_ITU526                              
PREDMODEL_RURAL_ITM                                
We will correct the API reference guide on page 402 where only 4 models are listed so far.

For Q2 the rural prediction model to be used needs to be defined under WinProp_ParaMain.PredictionModelRural
with the model parameters provided as 5th argument (void* ParameterModelUrban) to fct. OutdoorPlugIn_ComputePrediction() or 3rd argument to fct. OutdoorPlugIn_ComputePoints()
in case there is a dedicated structure (Model_RuralITU1546, Model_RuralITU526, Model_RuralITM, Model_RuralPE, Model_DPM). 
Only for PREDMODEL_RURAL_HATA, PREDMODEL_RURAL_2RAY_EMP, and PREDMODEL_RURAL_2RAY_DET the model parameters of the rural prediction model are considered from WinProp_ParaRural* ParameterRural which is passed as 7th argument to fct. OutdoorPlugIn_ComputePrediction() or 4th argument to fct. OutdoorPlugIn_ComputePoints().

For Q3 when using vector databases indeed the following 8 prediction models can be selected:
WINPROP_MODEL_FREESPACE
WINPROP_MODEL_COST231 
WINPROP_MODEL_DPM
WINPROP_MODEL_IRT  
WINPROP_MODEL_SRT
WINPROP_MODEL_VRT  
WINPROP_MODEL_SBR
WINPROP_MODEL_MOTLEYKEENAN
We will correct the API reference guide on page 50 where only 5 models are listed so far.

Best regards,
Reiner