包概述
注意: 使用 Project 包必须拥有 OPNET Development Kit 的许可证。
Ets_Pj 包提供了一套 API,用于访问与项目中各场景关联的网络模型;用于复制、切换、重命名和销毁场景;以及用于在当前场景上启动或停止仿真运行。
一个项目由任意数量的场景组成,任一时刻只有一个场景处于活动状态。每个场景由一个网络模型、与该网络相关并决定网络在仿真下行为的各类数据,以及可能存在的仿真结果组成。项目中的场景可能具有相似的对象和拓扑、本质上是彼此的变体,但这并非必然。也可能出现相邻场景之间对象没有任何对应关系的情况,因此不应作任何此类假设。
本包中的大多数函数要求指定的项目已在 Project Editor 中打开(通过 Ets_Tool_Open() 以编程方式打开,或由用户从 GUI 打开)。但以下函数对通过 Ets_Model_Create() 或 Ets_Model_Read() "在幕后"打开的项目同样有效:
- Ets_Pj_Scenario_New()
- Ets_Pj_Scenario_Count_Get()
- Ets_Pj_Scenario_Current_Index_Get()
- Ets_Pj_Scenario_Destroy()
- Ets_Pj_Scenario_Duplicate()
- Ets_Pj_Scenario_Index_Get()
- Ets_Pj_Scenario_Index_Set()
- Ets_Pj_Scenario_Name_Get()
- Ets_Pj_Scenario_Name_Set()
- Ets_Pj_Scenario_Switch()
例如,下面的代码在 Project Editor 之外(因此不在用户视野内)对项目 ABCDE 进行操作。它先创建该项目(如有必要),然后对项目的各场景做各种修改。
EtsT_Model_Handle pj_model_hndl;
char path [1024];
EtsT_Compcode status;
if (prg_tfile_path_get ("ABCDE", PrgC_Tfile_Type_Project, path, 1024) != PrgC_Compcode_Success)
{
// Project doesn't exist, so create it and add some scenarios
pj_model_hndl = Ets_Model_Create (EtsC_Model_Pj);
Ets_Model_Name_Set (pj_model_hndl, "ABCDE");
Ets_Pj_Scenario_New (pj_model_hndl, "FGZ");
Ets_Pj_Scenario_New (pj_model_hndl, "QQQ");
Ets_Pj_Scenario_New (pj_model_hndl, "IJK");
Ets_Pj_Scenario_New (pj_model_hndl, "LMN");
}
else
{
// Project exists, so open it
pj_model_hndl = Ets_Model_Read (EtsC_Model_Pj, "ABCDE", &status);
}
// Make some changes to the scenarios
Ets_Pj_Scenario_Duplicate (pj_model_hndl, "OPQ");
Ets_Pj_Scenario_Name_Set (pj_model_hndl, 0, "FGH");
Ets_Pj_Scenario_Destroy(pj_model_hndl, 1);
Ets_Pj_Scenario_Duplicate (pj_model_hndl, "RST");
Ets_Pj_Scenario_New (pj_model_hndl, "UVW");
Ets_Pj_Scenario_Switch (pj_model_hndl, "IJK");
// Close the project
Ets_Model_Write (pj_model_hndl, VOSC_NIL);
Ets_Model_Destroy (pj_model_hndl);