Matlab與STK連接函數(shù)庫(重新整理)

1、沒譜青年重新整理2012年4月12日目 錄一、matlab/simulink、stk聯(lián)合仿真的優(yōu)勢1二、mexconnect函數(shù)詳細(xì)介紹22.1 stk服務(wù)器命令（stk server commands）22.1.1 stkdefaultconid22.1.2 stkdefaulthost22.1.3 stksetdefaulthost22.2 應(yīng)用命令（application commands）22.2.1 stkautosave22.2.2 stkhomedir22.2.3 stkcurrentdir22.2.4 stksetcurrentdir22.2.5 stkobjnames22.2

2、.6 stktimerstart32.2.7 stktimer32.3 普通對象命令（generic object commands）32.3.1 stkcentralbody32.3.2 stkloadobj32.3.3 stksaveobj32.3.4 stknewobj32.3.5 stkunload42.3.6 stkunloadchildren42.3.7 stkrename42.3.8 stktimeperiod42.3.9 stktimeperiodinsec52.3.10 stkvalidobj52.3.11 stkdescrip52.3.12 stksetdescrip52.

3、4 場景命令（scenario commands）62.4.1 stkanimtime62.4.2 stkepoch62.4.3 stksetepoch62.4.4 stksetepochinsec62.4.5 stksyncepoch62.4.6 stkconvertdate62.4.7 stksettimeperiod62.4.8 stksettimeperiodinsec72.4.9 stkscenfilepath72.4.10 stkvalidscen72.5 基本飛行器數(shù)據(jù)（basic vehicle data）72.5.1 stktimeperiod72.5.2 stktimepe

4、riodinsec72.5.3 stksettimeperiod72.6 衛(wèi)星運(yùn)動屬性（satellite propagators）82.6.1 stksetpropcart82.6.2 stksetpropclassical82.6.3 stksetpropequi92.6.4 stksetpropsgp492.6.5 stkpropagate102.7 飛行器位置與速度（vehicle position and velocity）102.7.1 stkposvelcbf102.7.2 stkposvelcbi102.7.3 stkephemeriscbf102.7.4 stkephemer

5、iscbi112.7.5 stksetephemeriscbf112.7.6 stksetephemeriscbi112.7.7 stkloadephemeris112.7.8 stksaveephemeriscbf122.7.9 stksaveephemeriscbi122.7.10 stksavedynstate122.7.11 stkdynstate122.8 飛行器姿態(tài)（vehicle attitude）122.8.1 stkattitudecbf122.8.2 stkattitudecbi132.8.3 stksetattitudecbf132.8.4 stksetattitudec

6、bi132.8.5 stkloadattitude142.8.6 stksaveattitudecbf142.8.7 stksaveattitudecbi142.9 基本飛行器姿態(tài)類型（basic vehicle attitude types）142.9.1 stksetattbasic142.9.2 stksetattspinsun152.9.3 stksetattspinnadir152.9.4 stksetattyawnadir152.9.5 stksetattspinning162.9.6 stksetattfixed162.9.7 stkattoffset172.10 飛機(jī)，車輛與船

7、艦屬性（aircraft, groundvehicle and ship propagators）172.10.1 stksetwaypoints172.10.2 stkloadwaypoints182.10.3 stksetgreatarcstart182.11 導(dǎo)彈運(yùn)動屬性（missile propagators）182.11.1 stksetpropballistic182.12 設(shè)備與目標(biāo)（facilities and targets）182.12.1 stkposvelcbf182.12.3 stksetfacposcbf182.12.3 stksetfacposlla192.13

8、區(qū)域目標(biāo)（area targets）192.13.1 area target boundary192.14 stk工具（stk tools）192.14.1 stkaccess192.14.2 stkreport192.14.3 stkaccreport202.14.4 stkfinddata212.15 連接命令（connect commands）212.15.1 stkopen212.15.2 stkclose212.15.3 stkexec212.15.4 stkconnect22三、aerotoolbox函數(shù)詳細(xì)介紹223.1 坐標(biāo)系中的歷元與數(shù)據(jù)函數(shù)coordinate system

9、 epoch and date functions）223.1.1 atbgetepoch223.1.2 atbsetepoch223.1.3 atbdatetoepochsec233.1.4 atbepochsectodate233.2 坐標(biāo)系轉(zhuǎn)換（coordinate conversions）243.2.1 atbcbftocbi243.2.2 atbcbftocbimtx243.2.3 atbcbftolhmtx243.2.4 atbcbftolla243.2.5 atbcbftollr253.2.6 atbcbftovvlhmtx253.2.7 atbcbitocbf253.2.8 a

10、tbcbitocbi263.2.9 atbcbitocbimtx263.2.10 atbllatocbf263.2.11 atbllrtocbf273.2.12 atbcbcoordinates273.2.13 atbcoordxform273.2.14 atbcoordxformmtx283.3 轉(zhuǎn)動與四元數(shù)（rotations and quaternions）283.3.1 atbalignvecquat283.3.2 atbeulertomtx283.3.3 atbeulertoquat293.3.4 atbminrotquat293.3.5 atbmtxtoeuler293.3.6 a

11、tbmtxtoquat293.3.7 atbmtxtoypr303.3.8 atbquattomtx303.3.9 atbquatxquat303.3.10 atbyprtomtx303.3.11 atbyprtoquat313.3.12 atbinterpquat313.4 中心對象操作與程序（central body operations and routines）313.4.1 atbcbephemeris313.4.2 atbcbgettangent313.4.3 atbcbgravparam323.4.4 atbcbgrazealt323.4.5 atbcbgrazeangle323

12、.4.6 atbcbintersect333.4.7 atbcblclradcen333.4.8 atbcblclraddet333.4.9 atbcbsurfdistcen343.4.10 atbcbsurfdistdet343.4.11 atbcbsurfnormcen343.4.12 atbcbsurfnormdet343.5 指向，星歷與姿態(tài)文件（waypoint, ephemeris and attitude files）353.5.1 atbreadattitudecbf353.5.2 atbreadattitudecbi353.5.3 atbwriteattitudecbf353

13、.5.4 atbwriteattitudecbi353.5.5 atbreadephemeriscbf363.5.6 atbreadephemeriscbi363.5.7 atbwriteephemeriscbf363.5.8 atbwriteephemeriscbi363.5.9 atbwritewaypointfile363.6 位置與速度函數(shù)（position and velocity functions）373.6.1 atbgeometry373.6.2 atbgengreatarc393.6.3 atbcreatedynstatecbf393.6.4 atbcreatedynsta

14、tecbi393.6.5 atblhquatcen403.6.6 atblhquatcbfdet403.6.7 atbflatten413.7 軌道要素轉(zhuǎn)換（orbit element set conversions）413.7.1 atborbcarttodel413.7.2 atborbcarttoequi413.7.3 atborbcarttomod423.7.4 atborbcarttosphere423.7.5 atborbcarttomixedsphere433.7.6 atborbdeltocart433.7.7 atborbequitocart433.7.8 atborbmod

15、tocart433.7.9 atborbspheretocart433.7.10 atborbmixedspheretocart433.8 軌道根數(shù)分量的轉(zhuǎn)換（orbit element parameter conversions）433.8.1 atborbecctotrue433.8.2 atborbtruetoecc443.8.3 atborbmeantotrue443.8.4 atborbtruetomean443.8.5 atborblantoraan443.8.6 atborbraantolan443.8.7 atborbperiradtoperiod443.8.8 atborbp

16、eriodtoperirad453.8.9 atborbperiradtosmajaxis453.8.10 atborbsmajaxistoperirad453.8.11 atborbtpantotrue453.8.12 atborbtruetotpan453.8.13 atborbtpptotrue463.8.14 atborbtruetotpp463.9 dted操作（dted operations）463.9.1 atbcblistdtedtypes463.9.2 atbcblistdted463.9.3 atbcbadddtedsource473.9.4 atbcbdtedsource

17、ui473.9.5 atbloadnimadted473.9.6 atbcbremdtedsource473.9.7 atbcbgetdtedsourceforpos473.9.8 atbgetdtedpatch483.9.9 atbcleardtedpatch483.9.10 atballdtedpatches483.9.11 atbdtedpatchinfo483.9.12 atbdtedelev483.9.13 atbdtedpatchelev493.9.14 atbazelmask493.9.15 atbdtedres493.9.16 atbdtedlosexist493.10 運(yùn)動屬

18、性（propagators）503.10.1 atblambertfixedtime503.10.2 atblambertminenergy503.10.3 atblambertmineccen503.10.4 atbkeplerprop503.10.5 atbj2prop513.10.6 atbj4prop513.10.7 atblaunchprop523.10.8 atbmissilepropdatafixedtime523.10.9 atbmissilepropdatafixedalt533.10.10 atbmissilepropdatafixeddelta533.10.11 atbm

19、issilepropdataminenergy533.10.12 atbtleread533.10.13 atbtlegetall543.10.14 atbtledelete543.10.15 atbtleprop543.10.16 atbtleepoch543.10.17 atbtleinfo543.11 導(dǎo)航精度（navigation accuracy）553.11.1 atbcomputedop553.12 地圖數(shù)據(jù)（map data）563.12.1 atbmapdetails563.12.2 atbplotmapdetails563.13 覆蓋網(wǎng)格（coverage grids）56

20、3.13.1 atbgetpolyhandle563.13.2 atbinsidepoly563.13.3 atbclearpolyhandle57四、stkexec使用總結(jié)574.1 場景動畫控制574.1.1 控制按鈕57五、示例574.1 衛(wèi)星編隊(duì)之構(gòu)型設(shè)計(jì)574.2 使用心得58一、matlab/simulink、stk聯(lián)合仿真的優(yōu)勢stk/matlab,simulink stk與matlab聯(lián)合實(shí)現(xiàn)可視化仿真集成，該方案可以適用于航空航天、航海、作戰(zhàn)模擬、電子對抗、衛(wèi)星導(dǎo)航定位、遙感遙測、衛(wèi)星通信等各個(gè)可視化仿真集成案例之中。stk/matlab接口為stk和matlab提供了雙向通

21、訊功能，在matlab工作區(qū)通過connect模塊以tcp/ip協(xié)議打開stk端口。 利用超過150個(gè)matlab命令增強(qiáng)stk的軌道、彈道、軌跡的分析能力，mexconnect還提供在matlab命令行直接使用任意 stk/connect 命令的功能。mexconnect工具可以建立各種不同級別的stk對象，進(jìn)行操作并生成報(bào)告。所有stk的數(shù)據(jù)，包括動態(tài)位置、速度和姿態(tài)數(shù)據(jù)，可以返 回到matlab工作空間，用于數(shù)學(xué)分析。宇航工具箱讓matlab用戶可以輸出多重坐標(biāo)系，以及符合stk格式的星歷和姿態(tài)文件用于vo模塊的三維可視 化。另外此工具還可以使用stk附加模塊的功能如stk/comm（通

22、信），stk/coverage （覆蓋）和stk/radar（雷達(dá)）。表1 stk模塊基本模塊基本版專業(yè)版三維顯示高級三維顯示satellite tool kit(stk)stk/professioal(stkpro)stk/visualization option(stk/vo)stk/advanced vo分析模塊軌道機(jī)動鏈路分析通信分析接近分析覆蓋分析攔截飛行工具導(dǎo)彈飛行工具精確定軌雷達(dá)分析空間環(huán)境stkastrogatorstkchainsstkcommstkconjunction analysis toolsstkcoveragestkinterceptor flight tool(

23、ift)stkmissile flight tool(mft)stkprecision orbit determinationsystem(pods)stkradarstkspace environment綜合數(shù)據(jù)高精度數(shù)字地圖高分辨率地球影像雷達(dá)高級環(huán)境全球三維地形stkhigh resolution mapsstkvo earth imagerystkradar advanced environment(rae)stkterrain擴(kuò)展與接口連接模塊網(wǎng)絡(luò)實(shí)時(shí)播放matllab接口分布式仿真地理信息接口程序開發(fā)庫stkconnect and stkserverstkwebcaststkmat

24、lab interfacestkdistributed interactive simulation(dis)stkgeographic informationsystems(gis)stkprogrammers library(pl)二、mexconnect函數(shù)詳細(xì)介紹2.1 stk服務(wù)器命令（stk server commands）2.1.1 stkdefaultconid 作用：返回stk的默認(rèn)標(biāo)識2.1.2 stkdefaulthost作用：返回stk的默認(rèn)地址2.1.3 stksetdefaulthost作用：設(shè)置stk的新地址用法：stksetdefaulthost(host:po

25、rt)2.2 應(yīng)用命令（application commands）2.2.1 stkautosave作用：自動保存stk用法：stkautosave(onoff,directory, period) stkautosave(onoff)說明：onoff - on or off directory - string pathname of autosave directory(一連串路徑名的自動存儲目錄) period - seconds between saves2.2.2 stkhomedir作用：返回stk的安裝路徑用法：dir = stkhomedir2.2.3 stkcurrentdi

26、r作用：返回stk的當(dāng)前路徑用法：dir = stkcurrentdir2.2.4 stksetcurrentdir作用：設(shè)置stk的當(dāng)前路徑用法：stksetcurrentdir(directory)2.2.5 stkobjnames作用：返回stk中對象的名字用法：objnames = stkobjnames objnames = stkobjnames(classcell)說明：classcell - optional cell array of stk class names. objnames - cell array of stk object names 2.2.6 stktim

27、erstart作用：啟動計(jì)時(shí)器用法：stktimerstart2.2.7 stktimer作用：返回計(jì)時(shí)器時(shí)間用法：split, total = stktimer說明：split - elapsed time since last stktimer command total - elapsed time since last stktimerstart command2.3 普通對象命令（generic object commands）2.3.1 stkcentralbody作用：返回坐標(biāo)系的中心體用法：centbody = stkcentralbody(objpath)說明：objpath

28、 - string name of object obtained from stkobjnames. if ommitted, the scenario central body is returned.(從stkobjnames獲得對象 的字符串名稱。如果省略，返回場景的中央機(jī)構(gòu) ) centbody - string name of object coordinate system central body(對象的坐標(biāo)系統(tǒng) 的中央機(jī)構(gòu)的字符串名稱 ).備注：更多內(nèi)容參見stkobjnames、aerotoolbox。2.3.2 stkloadobj作用：導(dǎo)入對象文件用法：stkloado

29、bj(parentpath, class, filename) stkloadobj(scenariofilename)說明：parentpath - valid path(有效路徑), may be obtained from stkobjnames. class - valid class name（有效類名）. consult（查詢） stk documentation （文件） for alist of valid classes（有效地類類表）. names are case-sensitive（區(qū)分大小寫的）. filename - file path of object file

30、 （對象文件的文件路徑）2.3.3 stksaveobj作用：將對象保存用法：stksaveobj(objpath, dirname) stksaveobj(objpath)說明：objpath - valid path, may be obtained from stkobjnames. dirname - directory path of object file. when omitted, the default directory is used.（如果省略，則使用默認(rèn)目錄 ）2.3.4 stknewobj 作用：創(chuàng)建一個(gè)新對象用法：stknewobj(parentpath, cla

31、ss, name)說明：parentpath- valid path, may be obtained from stkobjnames. class- valid class name. consult stk documentation for a list of valid classes. names are case-sensitive. name - name of new object備注：創(chuàng)建場景時(shí)，語法為stknewobj(scenario, ,scenario1)2.3.5 stkunload作用：卸載對象用法：stkunload(objpath)說明：objpath- v

32、alid path, may be obtained from stkobjnames.2.3.6 stkunloadchildren作用：卸載對象的所有子對象用法：stkunloadchildren (objpath)說明：objpath- valid path, may be obtained from stkobjnames.2.3.7 stkrename作用：將對象重命名用法：stkrename(objpath, newname)說明：objpath- valid path, may be obtained from stkobjnames. newname - new instanc

33、e name.2.3.8 stktimeperiod作用：獲取對象起止時(shí)間用法：timeperiod = stktimeperiod(dateformat) timeperiod = stktimeperiod(objpath, dateformat)說明： objpath - valid vehicle object path, defaults to scenario path.timeperiod - structure array with start and stop fields. each field contains a string date value.dateformat

34、 - valid date format. options are: epochsec epochsecond epochmin epochminute epochhr epochhour epochday gmt zulu gmtsystem greglcl gregorianlocal gregorianlcl gregutc gregorianutc gregtai gregoriantai gregtdt gregoriantdt greggpstime greggps gregoriangpstime gpstime gps juldate juliandate jullcl jul

35、ianlocal julianlcl julutc julianutc jul4 julian4 julian4utc jdateoff jdateoffset juldateoffset julephemdate julianephemerisdate julianephem jultai juliantai miselap missionelapsed modjuldate modifiedjuliandate yyddd yyddd.ddd yyyyddd yyyyddd.hhmmss yyyymmdd yyyymmdd.ddd yyyy/mm/ddtime yyyy/mm/dd 備注：

36、更對內(nèi)容參見stkconvertdate、stkobjnames2.3.9 stktimeperiodinsec作用：獲取對象起止時(shí)間，以s為單位用法：start, stop = stktimeperiodinsec(objpath) start, stop = stktimeperiodinsec說明：objpath - valid object path, see stkobjnames. when not provided, the scenario time period is returned（如果不提供，場景一段時(shí) 間，則返回 ）. start, stop - time in se

37、conds2.3.10 stkvalidobj作用：檢查對象的有效性用法：result = stkvalidobj(path)說明：path- object path name result - 1 if valid, 0 otherwise2.3.11 stkdescrip作用：獲取對象的描述用法：description = stkdescrip(objpath, shortlong)說明：objpath- valid path, may be obtained from stkobjnames. shortlong - type of description to get, short o

38、r long.2.3.12 stksetdescrip作用：設(shè)置對象的描述用法：stksetdescrip(objpath, shortlong, description)說明：objpath- valid path, may be obtained from stkobjnames. shortlong - type of description to set, short or long. description - description text(說明文本).2.4 場景命令（scenario commands）2.4.1 stkanimtime作用：返回當(dāng)前動畫時(shí)間用法：time =

39、 stkanimtime說明：time - current stk animation time (sec)（當(dāng)前stk動畫時(shí)間）2.4.2 stkepoch作用：返回當(dāng)前場景歷元用法：epoch = stkepoch(dateformat)說明：dateformat- valid date format（有效的日期格式）.epoch - string representation of scenario epoch（場景歷元的字符串表示形式）. 2.4.3 stksetepoch作用：設(shè)置場景歷元用法：stksetepoch(epoch, dateformat)說明：dateformat-

40、valid date format.epoch - string representation of scenario epoch.2.4.4 stksetepochinsec作用：設(shè)置場景歷元用法：stksetepochinsec(newepoch)說明：newepoch - number of seconds elapsed between current epoch and the desired epoch（當(dāng)前歷元和所需歷元之間經(jīng)歷的秒數(shù)）.2.4.5 stksyncepoch作用：aerotoolbox與stk場景有同樣的歷元用法：stksyncepoch備注：stk and ae

41、rotoolbox maintain separate scenario epochs. this function should be called anytime the stk epoch is changed through mexconnect or via the stk gui.（stk和航空工具箱保持獨(dú)立的場景歷 元。 這個(gè)函數(shù)應(yīng)該被調(diào)用任何時(shí)間更改通過mexconnect或通過stk gui的 stk歷元 ）2.4.6 stkconvertdate作用：轉(zhuǎn)換日期格式用法：newdate = stkconvertdate(date, format, newformat)2.4.

42、7 stksettimeperiod作用：設(shè)置場景或衛(wèi)星的時(shí)間周期用法：stksettimeperiod(start, stop, dateformat) stksettimeperiod(satpath, start, stop, dateformat)說明：satpath - satellite path name, defaults to scenario（衛(wèi)星的路徑名，默認(rèn)到場景 ） start, stop- string dates(字符串日期)2.4.8 stksettimeperiodinsec作用：設(shè)置場景的時(shí)間周期用法：stktimeperiodinsec(start, st

43、op)說明：start, stop - time in seconds2.4.9 stkscenfilepath作用：返回場景文件的路徑用法：path = stkscenfilepath說明：path - current stk scenario directory（當(dāng)前stk場景目錄）2.4.10 stkvalidscen作用：檢查可用的場景用法：result = stkvalidscen說明：result - 1 if valid, 0 otherwise2.5 基本飛行器數(shù)據(jù)（basic vehicle data）2.5.1 stktimeperiod作用：獲取對象的時(shí)間周期用法：tim

44、eperiod = stktimeperiod(dateformat) timeperiod = stktimeperiod(objpath, dateformat)說明：objpath - valid vehicle object path（有效地交通工具對象路徑）, defaults to scenario path. timeperiod - structure array with start and stop fields. each field contains a string date value（起始和終止域的結(jié)構(gòu)數(shù)組。 每個(gè)字段包含一個(gè)字符串的日期值。 ）.2.5.2 st

45、ktimeperiodinsec作用：獲取對象的時(shí)間周期用法：start, stop = stktimeperiodinsec(objpath) start, stop = stktimeperiodinsec說明：objpath - valid object path, see stkobjnames. when not provided, the scenario time period is returned. start, stop - time in seconds2.5.3 stksettimeperiod作用：設(shè)置場景或?qū)ο蟮臅r(shí)間周期用法：stksettimeperiod(sta

46、rt, stop, dateformat) stksettimeperiod(satpath, start, stop, dateformat)說明：satpath - satellite path name, defaults to scenario start, stop- string dates2.6 衛(wèi)星運(yùn)動屬性（satellite propagators）2.6.1 stksetpropcart作用：設(shè)置笛卡爾坐標(biāo)系下衛(wèi)星運(yùn)動的參數(shù)用法：stksetpropcart(objpath, propagator, coordsystem, . tstart, tstop, dt, orb

47、itepoch, pos, vel, coordepoch)說明：objpath - valid path, may be obtained from stkobjnames. propagator - twobody, j2perturbation, j4perturbation, hpop or pods this parameter is case sensitive!（區(qū)分大小寫） coordsystem - string name of coordinate system（坐標(biāo)的字符串名稱）, valid choices are:fixed, j2000, meanofdate, m

48、eanofepoch, trueofdate, trueofepoch, b1950, temeofdate, temeofepoch, alignmentatepoch. this parameter is case sensitive! tstart, tstop - times in epoch seconds. dt - time step in seconds. orbitepoch - reference time of orbit data, in scenario epoch seconds pos - 3x1 vector of positions at reference

49、time, meters(3x1位置矢量在參考時(shí)間， 米 ) vel - 3x1 vector of velocity at reference time, meters/sec(3x1位置矢量在參考時(shí)間， 米每秒 ) coordepoch - coordinate system epoch, required by all .ofepoch coordinate systems.2.6.2 stksetpropclassical作用：設(shè)置經(jīng)典軌道根數(shù)描述下衛(wèi)星運(yùn)動的參數(shù)用法：stksetpropclassical(objpath, propagator, coordsystem, . tst

50、art, tstop, dt, orbitepoch, semimajoraxis, eccentricity,. inclination, argofperigree, raan, meananomaly, coordepoch)說明：objpath - valid path, may be obtained from stkobjnames. propagator - twobody, j2perturbation, j4perturbation, hpop or pods this parameter is case sensitive! coordsystem(坐標(biāo)系統(tǒng)) - string name of coordinate system, valid choices are: fixed, j2000, meanofdate, meanofepoch, trueofdate, trueofepoch, b1950, teme