Matlab与STK连接函数库(最新整理)

整理者：龚德仁 2008年10月7日 1 目 录 一、Matlab/Simulink、STK联合仿真的优势 ............................. 1 二、mexConnect函数详细介绍 ......................................... 2 2.1 STK服务器命令（STK Server Commands） .................................................................. 2 2.1.1 stkDefaultConID ................................................................................................. 2 2.1.2 stkDefaultHost ................................................................................................... 2 2.1.3 stkSetDefaultHost ............................................................................................. 2 2.2 应用命令（Application Commands） ........................................................................... 2 2.2.1 stkAutoSave ......................................................................................................... 2 2.2.2 stkHomeDir ........................................................................................................... 2 2.2.3 stkCurrentDir ..................................................................................................... 2 2.2.4 stkSetCurrentDir ............................................................................................... 2 2.2.5 stkObjNames ......................................................................................................... 2 2.2.6 stkTimerStart ..................................................................................................... 3 2.2.7 stkTimer ............................................................................................................... 3 2.3 普通对象命令（Generic Object Commands） ............................................................. 3 2.3.1 stkCentralBody ................................................................................................... 3 2.3.2 stkLoadObj ........................................................................................................... 3 2.3.3 stkSaveObj ........................................................................................................... 3 2.3.4 stkNewObj ............................................................................................................. 3 2.3.5 stkUnload ............................................................................................................. 4 2.3.6 stkUnloadChildren ............................................................................................. 4 2.3.7 stkRename ............................................................................................................. 4 2.3.8 stkTimePeriod ..................................................................................................... 4 2.3.9 stkTimePeriodInSec ........................................................................................... 5 2.3.10 stkValidObj ....................................................................................................... 5 2.3.11 stkDescrip ......................................................................................................... 5 2.3.12 stkSetDescrip ................................................................................................... 5 2.4 场景命令（Scenario Commands） ................................................................................. 6 2.4.1 stkAnimTime ......................................................................................................... 6 2.4.2 stkEpoch ............................................................................................................... 6 2.4.3 stkSetEpoch ......................................................................................................... 6 2.4.4 stkSetEpochInSec ............................................................................................... 6 2.4.5 stkSyncEpoch ....................................................................................................... 6 2.4.6 stkConvertDate ................................................................................................... 6 2.4.7 stkSetTimePeriod ............................................................................................... 6 2.4.8 stkSetTimePeriodInSec ..................................................................................... 7 2.4.9 stkScenFilePath ................................................................................................. 7 2.4.10 stkValidScen ..................................................................................................... 7 2.5 基本飞行器数据（Basic Vehicle Data） ................................................................... 7 2.5.1 stkTimePeriod ..................................................................................................... 7 2.5.2 stkTimePeriodInSec ........................................................................................... 7 2.5.3 stkSetTimePeriod ............................................................................................... 7 2.6 卫星运动属性（Satellite Propagators） ................................................................. 8 I 2.6.1 stkSetPropCart ................................................................................................... 8 2.6.2 stkSetPropClassical ......................................................................................... 8 2.6.3 stkSetPropEqui ................................................................................................... 9 2.6.4 stkSetPropSGP4 ................................................................................................... 9 2.6.5 stkPropagate ..................................................................................................... 10 2.7 飞行器位置与速度（Vehicle Position and Velocity） ....................................... 10 2.7.1 stkPosVelCBF ..................................................................................................... 10 2.7.2 stkPosVelCBI ..................................................................................................... 10 2.7.3 stkEphemerisCBF ............................................................................................... 10 2.7.4 stkEphemerisCBI ............................................................................................... 11 2.7.5 stkSetEphemerisCBF ......................................................................................... 11 2.7.6 stkSetEphemerisCBI ......................................................................................... 11 2.7.7 stkLoadEphemeris ............................................................................................. 11 2.7.8 stkSaveEphemerisCBF ....................................................................................... 12 2.7.9 stkSaveEphemerisCBI ....................................................................................... 12 2.7.10 stkSaveDynState ............................................................................................. 12 2.7.11 stkDynState ..................................................................................................... 12 2.8 飞行器姿态（Vehicle Attitude） ............................................................................. 12 2.8.1 stkAttitudeCBF ................................................................................................. 12 2.8.2 stkAttitudeCBI ................................................................................................. 13 2.8.3 stkSetAttitudeCBF ........................................................................................... 13 2.8.4 stkSetAttitudeCBI ........................................................................................... 13 2.8.5 stkLoadAttitude ............................................................................................... 14 2.8.6 stkSaveAttitudeCBF ......................................................................................... 14 2.8.7 stkSaveAttitudeCBI ......................................................................................... 14 2.9 基本飞行器姿态类型（Basic Vehicle Attitude Types） ..................................... 14 2.9.1 stkSetAttBasic ................................................................................................. 14 2.9.2 stkSetAttSpinSun ............................................................................................. 15 2.9.3 stkSetAttSpinNadir ......................................................................................... 15 2.9.4 stkSetAttYawNadir ........................................................................................... 15 2.9.5 stkSetAttSpinning ........................................................................................... 16 2.9.6 stkSetAttFixed ................................................................................................. 16 2.9.7 stkAttOffset ..................................................................................................... 17 2.10 飞机，车辆与船舰属性（Aircraft, GroundVehicle and Ship Propagators） 17 2.10.1 stkSetWaypoints ............................................................................................. 17 2.10.2 stkLoadWaypoints ........................................................................................... 18 2.10.3 stkSetGreatArcStart ..................................................................................... 18 2.11 导弹运动属性（Missile Propagators） ................................................................. 18 2.11.1 stkSetPropBallistic ..................................................................................... 18 2.12 设备与目标（Facilities and Targets） ............................................................... 18 2.12.1 stkPosVelCBF ................................................................................................... 18 2.12.3 stkSetFacPosCBF ............................................................................................. 18 2.12.3 stkSetFacPosLLA ............................................................................................. 19 2.13 区域目标（Area Targets） ....................................................................................... 19 II 2.13.1 Area Target boundary ................................................................................... 19 2.14 STK工具（STK Tools） .............................................................................................. 19 2.14.1 stkAccess ......................................................................................................... 19 2.14.2 stkReport ......................................................................................................... 19 2.14.3 stkAccReport ................................................................................................... 20 2.14.4 stkFindData ..................................................................................................... 21 2.15 连接命令（Connect Commands） ............................................................................... 21 2.15.1 stkOpen ............................................................................................................. 21 2.15.2 stkClose ........................................................................................................... 21 2.15.3 stkExec ............................................................................................................. 21 2.15.4 stkConnect ....................................................................................................... 22 三、aeroToolbox函数详细介绍 ....................................... 22 3.1 坐标系中的历元与数据函数Coordinate System Epoch and Date functions） 22 3.1.1 atbGetEpoch ....................................................................................................... 22 3.1.2 atbSetEpoch ....................................................................................................... 22 3.1.3 atbDateToEpochSec ........................................................................................... 23 3.1.4 atbEpochSecToDate ........................................................................................... 23 3.2 坐标系转换（Coordinate Conversions） ................................................................. 24 3.2.1 atbCbfToCbi ....................................................................................................... 24 3.2.2 atbCbfToCbiMtx ................................................................................................. 24 3.2.3 atbCbfToLhMtx ................................................................................................... 24 3.2.4 atbCbfToLla ....................................................................................................... 24 3.2.5 atbCbfToLlr ....................................................................................................... 25 3.2.6 atbCbfToVvlhMtx ............................................................................................... 25 3.2.7 atbCbiToCbf ....................................................................................................... 25 3.2.8 atbCbiToCbi ....................................................................................................... 26 3.2.9 atbCbiToCbiMtx ................................................................................................. 26 3.2.10 atbLlaToCbf ..................................................................................................... 26 3.2.11 atbLlrToCbf ..................................................................................................... 27 3.2.12 atbCbCoordinates ........................................................................................... 27 3.2.13 atbCoordXForm ................................................................................................. 27 3.2.14 atbCoordXFormMtx ........................................................................................... 28 3.3 转动与四元数（Rotations and Quaternions） ....................................................... 28 3.3.1 atbAlignVecQuat ............................................................................................... 28 3.3.2 atbEulerToMtx ................................................................................................... 28 3.3.3 atbEulerToQuat ................................................................................................. 29 3.3.4 atbMinRotQuat ................................................................................................... 29 3.3.5 atbMtxToEuler ................................................................................................... 29 3.3.6 atbMtxToQuat ..................................................................................................... 29 3.3.7 atbMtxToYpr ....................................................................................................... 30 3.3.8 atbQuatToMtx ..................................................................................................... 30 3.3.9 atbQuatXquat ..................................................................................................... 30 3.3.10 atbYprToMtx ..................................................................................................... 30 3.3.11 atbYprToQuat ................................................................................................... 31 III 3.3.12 atbInterpQuat ................................................................................................. 31 3.4 中心对象操作与程序（Central Body Operations and Routines） ..................... 31 3.4.1 atbCbEphemeris ................................................................................................. 31 3.4.2 atbCbGetTangent ............................................................................................... 31 3.4.3 atbCbGravParam ................................................................................................. 32 3.4.4 atbCbGrazeAlt ................................................................................................... 32 3.4.5 atbCbGrazeAngle ............................................................................................... 32 3.4.6 atbCbIntersect ................................................................................................. 33 3.4.7 atbCbLclRadCen ................................................................................................. 33 3.4.8 atbCbLclRadDet ................................................................................................. 33 3.4.9 atbCbSurfDistCen ............................................................................................. 34 3.4.10 atbCbSurfDistDet ........................................................................................... 34 3.4.11 atbCbSurfNormCen ........................................................................................... 34 3.4.12 atbCbSurfNormDet ........................................................................................... 34 3.5 指向，星历与姿态文件（Waypoint, Ephemeris and Attitude Files） ............. 35 3.5.1 atbReadAttitudeCBF ......................................................................................... 35 3.5.2 atbReadAttitudeCBI ......................................................................................... 35 3.5.3 atbWriteAttitudeCBF ....................................................................................... 35 3.5.4 atbWriteAttitudeCBI ....................................................................................... 35 3.5.5 atbReadEphemerisCBF ....................................................................................... 36 3.5.6 atbReadEphemerisCBI ....................................................................................... 36 3.5.7 atbWriteEphemerisCBF ..................................................................................... 36 3.5.8 atbWriteEphemerisCBI ..................................................................................... 36 3.5.9 atbWriteWaypointFile ..................................................................................... 36 3.6 位置与速度函数（Position and Velocity Functions） ....................................... 37 3.6.1 atbGeometry ....................................................................................................... 37 3.6.2 atbGenGreatArc ................................................................................................. 39 3.6.3 atbCreateDynStateCBF ..................................................................................... 39 3.6.4 atbCreateDynStateCBI ..................................................................................... 39 3.6.5 atbLhQuatCen ..................................................................................................... 40 3.6.6 atbLhQuatCBFDet ............................................................................................... 40 3.6.7 atbFlatten ......................................................................................................... 41 3.7 轨道要素转换（Orbit Element Set Conversions） ............................................... 41 3.7.1 atbOrbCartToDel ............................................................................................... 41 3.7.2 atbOrbCartToEqui ............................................................................................. 41 3.7.3 atbOrbCartToMod ............................................................................................... 42 3.7.4 atbOrbCartToSphere ......................................................................................... 42 3.7.5 atbOrbCartToMixedSphere ............................................................................... 43 3.7.6 atbOrbDelToCart ............................................................................................... 43 3.7.7 atbOrbEquiToCart ............................................................................................. 43 3.7.8 atbOrbModToCart ............................................................................................... 43 3.7.9 atbOrbSphereToCart ......................................................................................... 43 3.7.10 atbOrbMixedSphereToCart ............................................................................. 43 3.8 轨道根数分量的转换（Orbit Element Parameter Conversions） ....................... 43 IV