包概述

注意: 使用 Project 包必须拥有 OPNET Development Kit 的许可证。

Ets_Pj 包提供了一套 API,用于访问与项目中各场景关联的网络模型;用于复制、切换、重命名和销毁场景;以及用于在当前场景上启动或停止仿真运行。

一个项目由任意数量的场景组成,任一时刻只有一个场景处于活动状态。每个场景由一个网络模型、与该网络相关并决定网络在仿真下行为的各类数据,以及可能存在的仿真结果组成。项目中的场景可能具有相似的对象和拓扑、本质上是彼此的变体,但这并非必然。也可能出现相邻场景之间对象没有任何对应关系的情况,因此不应作任何此类假设。

本包中的大多数函数要求指定的项目已在 Project Editor 中打开(通过 Ets_Tool_Open() 以编程方式打开,或由用户从 GUI 打开)。但以下函数对通过 Ets_Model_Create() 或 Ets_Model_Read() "在幕后"打开的项目同样有效:

例如,下面的代码在 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);