|
…
|
||
|---|---|---|
| .. | ||
| IRMissileSimulation.cpp | ||
| IRMissileSimulation.cs | ||
| README.md | ||
导弹仿真示例
本目录包含了使用ThreatSource仿真系统进行导弹仿真的示例代码。这些示例展示了如何配置和运行不同类型的导弹仿真。
关于本库
ThreatSource 是一个基于 .NET 8.0 的类库，提供了完整的导弹仿真功能，包括：
- 多种制导系统（激光、红外、毫米波等）
- 运动学仿真和物理建模
- 事件驱动的仿真架构
- 智能数据管理系统
- 外部系统集成支持
系统要求
C#/.NET 用户
- .NET 8.0 或更高版本
- 通过 NuGet 包管理器安装或直接引用 ThreatSource.dll
- Visual Studio 2019+ 或 Visual Studio Code
C++用户
本库是一个 .NET 类库，C++用户需要通过 C++/CLI 包装层来使用：
- Windows 操作系统
- Visual Studio 2019 或更高版本（支持C++/CLI）
- .NET 8.0 运行时
- 创建 C++/CLI 项目并引用 ThreatSource.dll
示例文件
C#示例 (IRMissileSimulation.cs)
红外成像制导导弹仿真示例，展示了：
- 如何使用SimulationManager管理仿真
- 如何从配置文件创建导弹实体
- 如何设置目标和仿真环境
- 如何订阅和处理仿真事件
- 如何运行仿真循环并获取结果
核心代码片段
using ThreatSource.Simulation;
using ThreatSource.Data;
using ThreatSource.Missile;
public class IRMissileSimulationExample
{
private ISimulationManager _simulationManager;
private ThreatSourceDataManager _dataManager;
public async Task RunSimulationExample()
{
// 1. 初始化仿真管理器
_simulationManager = new SimulationManager();
_dataManager = new ThreatSourceDataManager();
_simulationManager.StartSimulation(0.02); // 20ms时间步长
// 2. 创建目标实体
var target = new BaseEquipment("target_001")
{
KState = new KinematicState
{
Position = new Vector3(5000, 0, 1000), // 5km距离
Velocity = new Vector3(-50, 0, 0), // 50m/s移动
Orientation = new Orientation(0, 0, 0)
}
};
// 3. 从配置创建导弹
var missileData = _dataManager.GetMissile("IR_Missile_Example");
var missile = new InfraredImagingTerminalGuidanceMissile("missile_001", missileData)
{
KState = new KinematicState
{
Position = new Vector3(0, 0, 100),
Velocity = new Vector3(200, 0, 0),
Orientation = new Orientation(0, 0, 0)
}
};
// 4. 注册实体和事件
_simulationManager.RegisterEntity(target);
_simulationManager.RegisterEntity(missile);
_simulationManager.Subscribe<MissileExplodeEvent>(OnMissileExplode);
// 5. 运行仿真循环
while (simulationTime < maxTime && missile.IsActive)
{
_simulationManager.UpdateSimulation();
// 处理仿真状态...
}
}
}
C++示例 (IRMissileSimulation.cpp)
这是一个使用C++/CLI的示例代码，展示了如何在C++项目中使用本库：
- 如何创建C++/CLI包装层
- 如何配置导弹实体和目标
- 如何设置仿真参数
- 如何运行仿真并获取结果
核心代码片段
using namespace ThreatSource::Simulation;
using namespace ThreatSource::Data;
using namespace ThreatSource::Missile;
public ref class IRMissileSimulationWrapper
{
private:
ISimulationManager^ simulationManager;
ThreatSourceDataManager^ dataManager;
public:
void RunSimulationExample()
{
// 1. 初始化仿真系统
simulationManager = gcnew SimulationManager();
dataManager = gcnew ThreatSourceDataManager();
simulationManager->StartSimulation(0.02);
// 2. 创建目标
auto target = gcnew BaseEquipment("target_001");
target->KState = gcnew KinematicState();
target->KState->Position = Vector3(5000, 0, 1000);
// 3. 创建导弹
auto missileData = dataManager->GetMissile("IR_Missile_Example");
auto missile = gcnew InfraredImagingTerminalGuidanceMissile("missile_001", missileData);
// 4. 注册实体
simulationManager->RegisterEntity(target);
simulationManager->RegisterEntity(missile);
// 5. 运行仿真
while (simulationTime < maxTime && missile->IsActive)
{
simulationManager->UpdateSimulation();
// 处理仿真状态...
}
}
};
使用说明
基本仿真流程
-
初始化仿真管理器
var simulationManager = new SimulationManager(); var dataManager = new ThreatSourceDataManager(); simulationManager.StartSimulation(timeStep); -
创建仿真实体
// 从配置创建导弹 var missileData = dataManager.GetMissile("missile_type"); var missile = new InfraredImagingTerminalGuidanceMissile("id", missileData); // 创建目标 var target = new BaseEquipment("target_id"); -
配置实体状态
missile.KState = new KinematicState { Position = new Vector3(x, y, z), Velocity = new Vector3(vx, vy, vz), Orientation = new Orientation(yaw, pitch, roll) }; -
注册实体和事件
simulationManager.RegisterEntity(missile); simulationManager.RegisterEntity(target); simulationManager.Subscribe<MissileExplodeEvent>(OnMissileExplode); -
运行仿真循环
while (condition) { simulationManager.UpdateSimulation(); // 处理仿真状态和结果 }
配置文件要求
示例代码需要相应的TOML配置文件：
# data/missiles/IR_Missile_Example.toml
Type = "missile"
[Name]
zh = "红外成像制导导弹示例"
en = "IR Imaging Guided Missile Example"
[Properties]
MaxSpeed = 800.0
MaxAcceleration = 50.0
MaxFlightTime = 120.0
MaxFlightDistance = 8000.0
[InfraredImagingGuidanceConfig]
MaxDetectionRange = 5000.0
FieldOfView = 30.0
TargetRecognitionProbability = 0.9
C++/CLI项目配置
-
创建C++/CLI项目
- 在Visual Studio中选择"CLR空项目"
- 设置目标框架为.NET 8.0
-
添加引用
<Reference Include="ThreatSource"> <HintPath>path\to\ThreatSource.dll</HintPath> </Reference> -
编译设置
- 启用公共语言运行时支持 (/clr)
- 设置正确的.NET目标框架版本
注意事项
通用注意事项
- 单位系统：确保所有参数使用正确的单位（米、秒、弧度等）
- 时间步长：合理设置仿真时间步长，平衡精度和性能
- 资源管理：正确处理仿真资源的创建和释放
- 异常处理：添加适当的异常处理机制
C#特定注意事项
- 使用async/await处理异步操作
- 正确订阅和取消订阅事件
- 注意内存管理和垃圾回收
C++/CLI特定注意事项
- 平台限制：仅支持Windows平台
- 内存管理：注意托管和非托管资源的正确释放
- 类型转换：正确处理托管和原生类型之间的转换
- 异常处理：使用托管异常处理机制
扩展示例
添加自定义事件处理
// 订阅多种事件
simulationManager.Subscribe<FlightPhaseChangeEvent>(OnFlightPhaseChange);
simulationManager.Subscribe<TargetHitEvent>(OnTargetHit);
simulationManager.Subscribe<GuidanceActivationEvent>(OnGuidanceActivation);
private void OnFlightPhaseChange(FlightPhaseChangeEvent evt)
{
Console.WriteLine($"导弹 {evt.SenderId} 进入 {evt.NewPhase} 阶段");
}
多导弹仿真
// 创建多个导弹
for (int i = 0; i < missileCount; i++)
{
var missile = new InfraredImagingTerminalGuidanceMissile($"missile_{i:D3}", missileData);
// 设置不同的初始位置和参数
simulationManager.RegisterEntity(missile);
}
实时状态监控
// 在仿真循环中监控状态
while (simulationManager.IsRunning)
{
simulationManager.UpdateSimulation();
// 获取所有导弹状态
var missiles = simulationManager.GetEntitiesByType<BaseMissile>();
foreach (var missile in missiles)
{
var status = missile.GetStatusInfo();
// 处理状态信息
}
}