本文是安諾尼 AARONIA SPECTRAN V6 實(shí)時(shí)頻譜分析儀配套 RTSA Suite 的專(zhuān)屬文件格式 ——RTSA File Format 的技術(shù)解析系列第一篇，核心講解該格式的設(shè)計(jì)定位、核心特性與整體文件架構(gòu)，是理解 RTSA 文件解析、讀寫(xiě)及 二次開(kāi)發(fā) 的基礎(chǔ)。本系列將逐章拆解 RTSA File Format 技術(shù)規(guī)范，為從事 AARONIA SPECTRAN V6 相關(guān)開(kāi)發(fā)的工程師提供專(zhuān)業(yè)、完整的技術(shù)參考。

1. 設(shè)計(jì)定位與核心特性（Features and Purpose）

RTSA File Format 專(zhuān)用于存儲(chǔ)由 RTSA Suite 生成的文件，采用二進(jìn)制塊式（binary, chunk-based） 架構(gòu)設(shè)計(jì)，與 PNG 文件格式的結(jié)構(gòu)邏輯相近。該格式針對(duì)頻譜測(cè)量數(shù)據(jù)的存儲(chǔ)特性開(kāi)發(fā)，其核心差異化特性均圍繞測(cè)量數(shù)據(jù)的存儲(chǔ)、傳輸、解析等實(shí)際應(yīng)用需求設(shè)計(jì)，具體如下：
Binary, compact and optionally compressed storage of measurement data  采用二進(jìn)制格式存儲(chǔ)測(cè)量數(shù)據(jù)，存儲(chǔ)形式緊湊且支持可選壓縮
Meta data storage (location, time, format etc.)  支持元 數(shù)據(jù)存儲(chǔ) ，可記錄測(cè)量位置、時(shí)間、數(shù)據(jù)格式等相關(guān)信息
Multi streams  支持多流存儲(chǔ)，適配復(fù)雜測(cè)量場(chǎng)景的多維度數(shù)據(jù)記錄需求
Interleaving of streams  支持流的交錯(cuò)存儲(chǔ)，滿(mǎn)足多源測(cè)量數(shù)據(jù)的融合存儲(chǔ)需求
Sequential stream read and write  支持流的順序讀寫(xiě)，適配測(cè)量數(shù)據(jù)的線(xiàn)性處理邏輯
Random access of complete files  支持對(duì)完整文件的隨機(jī)訪問(wèn)，可快速定位目標(biāo)測(cè)量數(shù)據(jù)
Preview storage of power spectra and power histogram  內(nèi)置功率譜和功率直方圖的預(yù)覽存儲(chǔ)，可快速查看數(shù)據(jù)概況

Extension of existing streams  支持對(duì)現(xiàn)有流的擴(kuò)展，適配測(cè)量數(shù)據(jù)維度的動(dòng)態(tài)擴(kuò)充需求

2. 文件整體結(jié)構(gòu)（File Structure）

2.1 核心架構(gòu)：基于 Chunk 的組合形式

整個(gè) RTSA 文件由獨(dú)立且支持遞歸的塊（individual and optionally recursive chunks） 組成，Chunk 是 RTSA File Format 的基礎(chǔ)結(jié)構(gòu)單元，每個(gè) Chunk 均由固定的塊頭（chunk header） 和可變的實(shí)際數(shù)據(jù)（actual data） 兩部分構(gòu)成。
Chunk 的實(shí)際數(shù)據(jù)部分類(lèi)型由 Chunk 類(lèi)型決定，可分為兩種形式：一是由多個(gè)子 Chunk 組成的遞歸結(jié)構(gòu)，二是直接存儲(chǔ)的二進(jìn)制測(cè)量原始數(shù)據(jù)。該設(shè)計(jì)讓 RTSA 文件具備良好的結(jié)構(gòu)可擴(kuò)展性和兼容性，適用于多類(lèi)型、多維度頻譜測(cè)量數(shù)據(jù)的存儲(chǔ)場(chǎng)景。

2.2 通用文件布局（Generic File Layout）

RTSA File Format 遵循標(biāo)準(zhǔn)化、固定的整體布局規(guī)則，文件段具備明確的起始和結(jié)束標(biāo)識(shí)，Chunk 內(nèi)部關(guān)聯(lián)遵循反向引用（backward reference） 原則，同時(shí)支持文件的流式傳輸和隨機(jī)訪問(wèn)，具體規(guī)則如下：

1）文件段起始與結(jié)束標(biāo)識(shí)

RTSA 文件以DSFH（File Head，文件頭） 塊起始，以DSFT（File Tail，文件尾） 塊結(jié)束。若對(duì)現(xiàn)有文件進(jìn)行擴(kuò)展，文件內(nèi)會(huì)生成多組 DSFH/DSFT 塊對(duì)，每組塊對(duì)對(duì)應(yīng) RTSA 文件的一個(gè)獨(dú)立數(shù)據(jù)段。

2） Chunk 訪問(wèn)規(guī)則

可通過(guò) Chunk 頭中的塊大小字段對(duì)文件內(nèi)的 Chunk 進(jìn)行正向順序讀取，也可通過(guò)其他 Chunk 中存儲(chǔ)的偏移量實(shí)現(xiàn)隨機(jī)訪問(wèn)。所有偏移量均為 64 位無(wú)符號(hào)整數(shù)，以文件起始位置為基準(zhǔn)且采用反向引用方式，無(wú)正向引用 設(shè)計(jì)確保 RTSA 文件無(wú)需預(yù)加載完整文件即可實(shí)現(xiàn)流暢的流式解析。

3）基礎(chǔ) Chunk 序列

單段 RTSA 文件的標(biāo)準(zhǔn)基礎(chǔ)結(jié)構(gòu)如下，其中 SAMP 塊的數(shù)量由測(cè)量數(shù)據(jù)量決定，部分功能型 Chunk 的順序可根據(jù)實(shí)際測(cè)量場(chǎng)景調(diào)整：

DSFH (File Head) → STRM (Stream Head) → ANTA (Antenna) → SSTR (Sub Stream) → SAMP (Samples) → SAMP (Samples) → STRT (Stream Tail) → DSFT (File Tail)

2.3 帶 ID 對(duì)象的組織規(guī)則

RTSA 文件中所有帶有 64 位唯一 ID 的對(duì)象（如 Stream ID、Sub Stream ID、Antenna IDs）均遵循兩大核心組織規(guī)則，是保證文件解析和隨機(jī)訪問(wèn)正確性的基礎(chǔ)：
先定義后使用（Define before Use）
所有帶 ID 的對(duì)象必須在被使用前定義在文件中，即對(duì)應(yīng) ID 對(duì)象的 Chunk 必須先被解析，后續(xù)引用該 ID 的 Chunk 才能被正確解析。
基于反向鏈接鏈的檢索（Backward Linked Chains for Retrieval）
所有帶 ID 的對(duì)象均屬于反向鏈接鏈的一部分，鏈接鏈通過(guò) Chunk 中存儲(chǔ)的偏移量字段構(gòu)建，為文件的隨機(jī)訪問(wèn)提供快速索引，可通過(guò) ID 和對(duì)應(yīng)偏移量快速定位目標(biāo)數(shù)據(jù)。

3. 核心設(shè)計(jì)邏輯與實(shí)際應(yīng)用價(jià)值

3.1 核心設(shè)計(jì)邏輯

RTSA File Format 的核心設(shè)計(jì)基于標(biāo)準(zhǔn)化和可擴(kuò)展性雙重原則，并結(jié)合 AARONIA SPECTRAN V6 頻譜儀的測(cè)量數(shù)據(jù)實(shí)際特性打造：
標(biāo)準(zhǔn)化：統(tǒng)一 Chunk 頭結(jié)構(gòu)、通用數(shù)據(jù)類(lèi)型存儲(chǔ)規(guī)則和文件整體布局，確保不同版本 RTSA Suite、不同型號(hào) AARONIA SPECTRAN V6 頻譜儀生成的 RTSA 文件具備兼容性。
可擴(kuò)展性：采用基于 Chunk 的遞歸結(jié)構(gòu)和反向引用規(guī)則，支持新增 Chunk 類(lèi)型和擴(kuò)展現(xiàn)有流，適配實(shí)際頻譜測(cè)量中測(cè)量場(chǎng)景、數(shù)據(jù)類(lèi)型的動(dòng)態(tài)變化。

3.2 實(shí)際應(yīng)用價(jià)值

作為 AARONIA SPECTRAN V6 頻譜儀測(cè)量數(shù)據(jù)存儲(chǔ)的專(zhuān)屬文件格式，RTSA File Format 是設(shè)備的核心數(shù)據(jù)載體，其設(shè)計(jì)特性決定了其在實(shí)際使用和二次開(kāi)發(fā)中的重要應(yīng)用價(jià)值：
二進(jìn)制 + 可選壓縮的存儲(chǔ)方式，實(shí)現(xiàn)了大容量頻譜測(cè)量數(shù)據(jù)的緊湊存儲(chǔ)，降低存儲(chǔ)占用和傳輸帶寬開(kāi)銷(xiāo)；
順序讀寫(xiě)與隨機(jī)訪問(wèn)并存的特性，滿(mǎn)足全文件批量分析、局部目標(biāo)數(shù)據(jù)提取等不同的數(shù)據(jù)處理需求；
內(nèi)置功率譜和功率直方圖的預(yù)覽存儲(chǔ)，無(wú)需解析完整文件即可快速展示測(cè)量數(shù)據(jù)全貌，提升數(shù)據(jù)預(yù)處理和預(yù)覽效率；
完整的元數(shù)據(jù)存儲(chǔ) + 標(biāo)準(zhǔn)化的 Chunk 結(jié)構(gòu)，為 RTSA 文件的二次開(kāi)發(fā)提供清晰、專(zhuān)業(yè)的技術(shù)依據(jù)，且兼容主流 編程語(yǔ)言 和開(kāi)發(fā)環(huán)境；
流擴(kuò)展和多流交錯(cuò)存儲(chǔ)的支持，適配 AARONIA SPECTRAN V6 的多天線(xiàn)測(cè)量、多維度數(shù)據(jù)同步采集等復(fù)雜測(cè)量場(chǎng)景。

下期預(yù)告

下一篇將聚焦 RTSA File Format 的Chunk Structure（塊結(jié)構(gòu)） 和General Data Types（通用數(shù)據(jù)類(lèi)型） ，包括 Chunk 頭結(jié)構(gòu)（DSPStreamFileChunk）的統(tǒng)一定義、字節(jié)序、時(shí)間、偏移量、字符串等基礎(chǔ)數(shù)據(jù)類(lèi)型的存儲(chǔ)規(guī)則，這兩部分是解析 RTSA 文件所有 Chunk 的基礎(chǔ)技術(shù)規(guī)則，也是保證 RTSA 文件讀寫(xiě)、數(shù)據(jù)解析正確性的關(guān)鍵。