《遙感產(chǎn)品算法測(cè)評(píng) 第3部分 遙感產(chǎn)品算法接口》

T/CARSAXXXXX—202X

ICS37.040

V00/09

團(tuán)體標(biāo)準(zhǔn)

T/CARSAXXXXX—202X

遙感產(chǎn)品算法測(cè)評(píng)

第3部分：遙感產(chǎn)品算法接口

AlgorithmTestofRemoteSensingProducts

Part3:SoftInterfaceSpecificationforAlgorithmsofRemoteSensingProducts

（征求意見(jiàn)稿）

（本稿完成時(shí)間：2023年4月3日）

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

中國(guó)遙感應(yīng)用協(xié)會(huì)發(fā)布

T/CARSAXXXXX—202X

遙感產(chǎn)品算法測(cè)評(píng)第3部分：遙感產(chǎn)品算法接口

1范圍

本文件規(guī)定了遙感產(chǎn)品算法開(kāi)發(fā)和測(cè)評(píng)時(shí)需遵循的算法調(diào)用過(guò)程、算法基本要求、算法接口以及其

它相關(guān)約束。

本文件適用于遙感產(chǎn)品算法的測(cè)評(píng)，包括但不限于幾何產(chǎn)品、輻射基礎(chǔ)產(chǎn)品、土地覆蓋/土地利用

產(chǎn)品、能量平衡參量產(chǎn)品、植被參量產(chǎn)品、水分參量產(chǎn)品等產(chǎn)品生產(chǎn)算法的測(cè)評(píng)。

2規(guī)范性引用文件

下列文件中的條款通過(guò)本標(biāo)準(zhǔn)的引用而構(gòu)成本標(biāo)準(zhǔn)的條款。凡是注日期的引用文件，其隨后所有的

修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本標(biāo)準(zhǔn)，然而，鼓勵(lì)根據(jù)本標(biāo)準(zhǔn)達(dá)成協(xié)議的各方研究

是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本標(biāo)準(zhǔn)。

GB3102.6-93光及有關(guān)電磁輻射的量和單位

GB/T8567-1988計(jì)算機(jī)軟件產(chǎn)品開(kāi)發(fā)文件編制指南

GB/T13502-1992信息處理程序構(gòu)造及其表示的約定

GB/T15853-1995軟件支持環(huán)境

GB/T36296-2018遙感產(chǎn)品真實(shí)性檢驗(yàn)導(dǎo)則

GB/T36299-2018光學(xué)遙感輻射傳輸基本術(shù)語(yǔ)

3術(shù)語(yǔ)和定義

GB3102.6-93、GB/T8567-1988、GB/T13502-1992、GB/T15853-1995、GB/T36299-2018、GB/T

36296-2018和界定的以及下列術(shù)語(yǔ)和定義適用于本標(biāo)準(zhǔn)

3.1

遙感產(chǎn)品算法algorithmofremotesensingproduct

面向遙感產(chǎn)品生產(chǎn)的，將原始遙感數(shù)據(jù)或遙感共性產(chǎn)品轉(zhuǎn)化為其它遙感產(chǎn)品的算法。

3.2

算法測(cè)評(píng)algorithmtest

利用一套指標(biāo)體系、標(biāo)準(zhǔn)輸入數(shù)據(jù)和測(cè)評(píng)技術(shù)，獨(dú)立地對(duì)算法開(kāi)展精度/不確定性、適用性、效率、

魯棒性等方面的綜合評(píng)價(jià)，定量化評(píng)價(jià)算法的性能。

4遙感產(chǎn)品算法接口

4.1算法調(diào)用過(guò)程

遙感產(chǎn)品算法應(yīng)采用以下調(diào)用過(guò)程，如圖4.1所示。

1

T/CARSAXXXXX—202X

圖4.1算法調(diào)用過(guò)程示意圖

具體流程如下：

a)遙感產(chǎn)品選擇：根據(jù)算法描述信息進(jìn)行算法解析，獲取算法需要輸入的關(guān)聯(lián)遙感產(chǎn)品，主要通

過(guò)數(shù)據(jù)查詢獲取數(shù)據(jù)列表；

b)確定輸入輸出：根據(jù)算法輸入輸出標(biāo)準(zhǔn)，將遙感產(chǎn)品作為輸入，按照用戶設(shè)定的產(chǎn)品生產(chǎn)相關(guān)

標(biāo)準(zhǔn)，傳遞輸入輸出參數(shù)，此外，還需填入算法輔助數(shù)據(jù)信息；

c)產(chǎn)品計(jì)算：系統(tǒng)依據(jù)輸入與輸出規(guī)范調(diào)用算法組件生成產(chǎn)品，同時(shí)需要進(jìn)行算法效率評(píng)估；

d)精度評(píng)估：算法結(jié)束后針對(duì)產(chǎn)品進(jìn)行相關(guān)精度評(píng)價(jià)。

4.2算法基本要求

遙感產(chǎn)品算法應(yīng)滿足以下基本要求：

a)算法的基礎(chǔ)運(yùn)行環(huán)境應(yīng)與批量產(chǎn)品生產(chǎn)的操作系統(tǒng)相匹配，宜采用Linux操作系統(tǒng)作為底層平

臺(tái),能夠批量執(zhí)行;

b)算法集成方式宜采用與操作系統(tǒng)耦合性低的集成模式，適用多種語(yǔ)言開(kāi)發(fā)的基礎(chǔ)運(yùn)行環(huán)境；

c)算法應(yīng)基于文件完成數(shù)據(jù)交換，并以算法組件的形式完成算法集成。例如采用Docker容器鏡像

的集成方式，運(yùn)行環(huán)境主要為L(zhǎng)inux系統(tǒng)。

4.3算法接口

4.3.1算法調(diào)用接口

算法調(diào)用接口可以參考軟件開(kāi)發(fā)規(guī)范（GB/T8567-1988），此部分內(nèi)容由算法開(kāi)發(fā)用戶與遙感產(chǎn)品

平臺(tái)約定。

4.3.2算法輸入接口

參數(shù)輸入需要由算法測(cè)評(píng)系統(tǒng)規(guī)定，基本輸入應(yīng)為該產(chǎn)品生產(chǎn)所需標(biāo)準(zhǔn)產(chǎn)品或者共性產(chǎn)品的全路

徑文件名。算法測(cè)評(píng)系統(tǒng)方面應(yīng)要求算法開(kāi)發(fā)者明確描述參數(shù)輸入形式以及參數(shù)內(nèi)容，主要包括算法的

參數(shù)輸入形式、輸入與輸出參數(shù)的描述。

2

T/CARSAXXXXX—202X

a)算法的參數(shù)輸入形式

所有產(chǎn)品算法的輸入應(yīng)只有數(shù)據(jù)全路徑文件名，關(guān)于該數(shù)據(jù)的描述信息，如數(shù)據(jù)大小、數(shù)據(jù)類型、

分辨率等屬性信息都由算法讀取文件得到；其他模型參數(shù)信息通過(guò)配置文件確定，應(yīng)與可執(zhí)行程序放在

同一路徑。遙感產(chǎn)品算法的輸入數(shù)據(jù)應(yīng)規(guī)定如下內(nèi)容：

1）波段組織方式，算法輸入應(yīng)在算法內(nèi)部實(shí)現(xiàn)波段選擇，傳給算法所用數(shù)據(jù)的文件名。

2）多數(shù)據(jù)文件組織方式，多數(shù)據(jù)文件組織方式可分為兩種：1）單個(gè)輸入?yún)?shù)的多文件情形，應(yīng)當(dāng)

對(duì)多個(gè)文件以時(shí)間有序進(jìn)行文件名組織，文件名之間以英文逗號(hào)“,”隔開(kāi)，算法自行進(jìn)行解析；2）多個(gè)

輸入?yún)?shù)的多文件情形，應(yīng)當(dāng)對(duì)單個(gè)輸入?yún)?shù)內(nèi)部以“,”隔開(kāi)，不同輸入?yún)?shù)間遵循操作系統(tǒng)規(guī)定，以空

格隔開(kāi)。算法的輸入?yún)?shù)應(yīng)采用統(tǒng)一標(biāo)準(zhǔn)輸入接口。

算法參數(shù)的輸入形式示例見(jiàn)附錄A.1。

b)輸入與輸出參數(shù)的描述

對(duì)算法輸入與輸出參數(shù)的描述，應(yīng)滿足以下要求：

1）對(duì)于每項(xiàng)輸入?yún)?shù)，應(yīng)明確描述數(shù)據(jù)類型、空間分辨率、時(shí)間分辨率、覆蓋的時(shí)間跨度、時(shí)間

對(duì)齊方式、是否分幅、網(wǎng)格類型等，可參考附錄A.2；

2）對(duì)于每項(xiàng)輸出參數(shù)，一般需要描述數(shù)據(jù)類型、空間分辨率、時(shí)間分辨率、是否分幅、網(wǎng)格類型

等，可參考附錄A.3。

4.3.3算法輸出接口

算法輸出參數(shù)可根據(jù)算法測(cè)評(píng)系統(tǒng)的規(guī)定提供，應(yīng)包括算法輸出結(jié)果的完整文件路徑。

算法輸出需遵循以下約定：

a)格式約定。遵循一般遙感產(chǎn)品格式要求，內(nèi)部產(chǎn)品文件格式以GeoTIFF或HDF5格式為標(biāo)準(zhǔn)，

優(yōu)先考慮GeoTIFF格式。

b)分幅命名規(guī)范。分幅命名規(guī)范一般需要包含的要素包括產(chǎn)品級(jí)別、產(chǎn)品名稱、分辨率、版本號(hào)、

圖像分幅號(hào)、產(chǎn)品時(shí)間等要素，依據(jù)產(chǎn)品特點(diǎn)可部分修改。

c)分幅標(biāo)準(zhǔn)。為了保證多源多時(shí)相數(shù)據(jù)的空間一致處理，需采用與分辨率相應(yīng)的分幅規(guī)則。5公

里級(jí)全球產(chǎn)品一般采用等經(jīng)緯度投影，250米至1公里級(jí)全球產(chǎn)品可采用正弦投影（sinusoidal

projection），例如，采用MODIS分幅標(biāo)準(zhǔn)。針對(duì)中分辨率和高分辨率影像可采用UTM投影，

例如，采用美國(guó)與歐洲軍事格網(wǎng)參考系（MGRS）分幅。

d)產(chǎn)品文件內(nèi)容。產(chǎn)品應(yīng)明確輸出波段設(shè)置、波段名稱、放大比例因子。

算法輸出產(chǎn)品的描述方法示例見(jiàn)附錄A.4。

4.3.4算法其他輸入

算法所有其他輸入均由算法開(kāi)發(fā)者提供，如外來(lái)產(chǎn)品中成體系的共用產(chǎn)品一般可在明確算法輸入

數(shù)據(jù)查找規(guī)則的情況下由系統(tǒng)管理。算法單獨(dú)使用的查找表、輔助數(shù)據(jù)、DEM、底圖等數(shù)據(jù)，應(yīng)通過(guò)固

定地址由算法管理。

4.4其他相關(guān)約束

4.4.1編程開(kāi)發(fā)語(yǔ)言版權(quán)約定

算法開(kāi)發(fā)語(yǔ)言主要由集成方與用戶約定，原則上支持任意編程語(yǔ)言包括C/C++、Python、Java等，

但不應(yīng)支持任何盜版軟件或有版權(quán)風(fēng)險(xiǎn)的組件。

4.4.2算法執(zhí)行方式

算法可以批量化生產(chǎn)產(chǎn)品，在算法調(diào)用后，需自動(dòng)執(zhí)行直至完畢，中間不得有任何人工干預(yù)。算法

程序及其組件必須為基于命令行的后臺(tái)程序，不應(yīng)有人工交互過(guò)程或界面。

4.4.3松耦合組件化封裝

3

T/CARSAXXXXX—202X

算法應(yīng)以獨(dú)立松耦合的形式進(jìn)行組件化封裝，所有組件說(shuō)明文件與執(zhí)行程序等需要組織結(jié)構(gòu)保持

完全一致。插件應(yīng)包含軟件壓縮包、內(nèi)部需有可執(zhí)行程序、包含說(shuō)明文件與相應(yīng)程序執(zhí)行圖標(biāo)等輔助信

息。壓縮包名稱應(yīng)與算法插件描述文件一致。

4.4.4算法自檢要求

算法提交之前需針對(duì)以下要素自檢：

a)算法可執(zhí)行程序的運(yùn)行環(huán)境與依賴情況是否滿足；

b)算法依賴庫(kù)是否封裝完整；

c)算法私有的輔助數(shù)據(jù)是否封裝完整。

算法運(yùn)行環(huán)境與依賴情況檢查表見(jiàn)附錄A.5。

4.4.5算法完整性要求

算法組件提交時(shí)，除自身組件包，還應(yīng)包含相應(yīng)描述文件，包括但不限于以下內(nèi)容：

a)可執(zhí)行算法組件及使用說(shuō)明；

b)算法輸入輸出參數(shù)描述文件；

c)算法名稱、簡(jiǎn)介、關(guān)鍵詞、作者、單位、原理圖與樣例圖、主要參考文獻(xiàn)等介紹信息。

算法描述manifest文件規(guī)范見(jiàn)附錄A.6。

4.4.6算法信息機(jī)制

算法執(zhí)行時(shí)，必須提供必要的系統(tǒng)消息，尤其是錯(cuò)誤處理與返回以及算法日志輸出。

a)錯(cuò)誤處理與返回

在算法程序?qū)崿F(xiàn)時(shí)，應(yīng)考慮程序中可能出現(xiàn)的錯(cuò)誤，需在控制臺(tái)輸出錯(cuò)誤提示性的文字并返回錯(cuò)誤

代碼，建議在程序中捕獲相應(yīng)錯(cuò)誤，防止程序崩潰，并返回錯(cuò)誤提示。返回碼應(yīng)當(dāng)統(tǒng)一，一般程序正常

執(zhí)行結(jié)束的情況下，統(tǒng)一返回表示一切正常的返回碼，例如：0，，不應(yīng)將0用作錯(cuò)誤碼。

b)算法日志

算法日志應(yīng)包括“進(jìn)度[PROGRESS]”、“結(jié)果輸出[OUTPUT]”，便于后續(xù)的查看和調(diào)試。對(duì)于算法執(zhí)

行中的過(guò)程信息應(yīng)輸出到控制臺(tái)，以便算法調(diào)度時(shí)由系統(tǒng)自動(dòng)捕獲程序日志。

4

T/CARSAXXXXX—202X

附錄A

（資料性）

算法接口的描述方法

A.1算法參數(shù)的輸入形式

所有產(chǎn)品算法的輸入應(yīng)只有數(shù)據(jù)全路徑文件名，關(guān)于該數(shù)據(jù)的描述信息，如數(shù)據(jù)大小、數(shù)據(jù)的數(shù)據(jù)

類型、分辨率等等屬性信息都由算法讀取文件得到；其他模型參數(shù)信息通過(guò)配置文件確定，應(yīng)與可執(zhí)行

程序放同一路徑。

以某個(gè)共性產(chǎn)品生產(chǎn)算法有5個(gè)參數(shù)為例，包括3個(gè)輸入和2個(gè)輸出；

則argv[1]~argv[3]為輸入產(chǎn)品的全路徑文件名；argv[4]~argv[5]為輸出產(chǎn)品的全路徑文件名

intmain(intargc,char*argv[])

{

*****

return0;

}

算法的輸入?yún)?shù)應(yīng)采用統(tǒng)一標(biāo)準(zhǔn)輸入接口，輸入?yún)?shù)格式為JSON字符串，如下：

C++:

stringargparam;

cin>>argparam;

python:

importsys

importjson

importos

algoName=sys.argv[1]

algoParam=raw_input("")

params=json.loads(algoParam)

A.2算法輸入?yún)?shù)的描述方法

按照算法程序?qū)嶋H的輸入?yún)?shù)依次填寫，一行一個(gè)參數(shù)，如果是值類型的參數(shù)，例如數(shù)字或字符串，

應(yīng)清楚描述如何取值；如果是數(shù)據(jù)實(shí)體類型的參數(shù)，可按照下表的內(nèi)容填寫。

附表A.2算法輸入?yún)?shù)情況表示例

輸入?yún)?shù)時(shí)間輸入?yún)?shù)數(shù)據(jù)來(lái)

輸入?yún)?shù)跨度與對(duì)齊方輸入?yún)⑤斎雲(yún)?shù)輸入?yún)?shù)數(shù)源（當(dāng)前數(shù)據(jù)來(lái)源

輸入?yún)?/p>

序號(hào)產(chǎn)品類式（例如要求前數(shù)投影分景/剖分據(jù)格式及關(guān)與制備方法，系統(tǒng)備注填表人

數(shù)名稱

型后各五天，連續(xù)方式方式聯(lián)配套數(shù)據(jù)運(yùn)行時(shí)的數(shù)據(jù)來(lái)

十天內(nèi)的數(shù)據(jù)）源）

5

T/CARSAXXXXX—202X

A.3算法輸出參數(shù)的描述方法

附表A.2算法輸出參數(shù)情況表示例

輸出參數(shù)數(shù)據(jù)

序輸出參輸出參數(shù)空輸出參數(shù)時(shí)輸出參數(shù)輸出參數(shù)分

格式及關(guān)聯(lián)配備注填表人

號(hào)數(shù)名稱間分辨率間分辨率投影方式景/剖分方式

套數(shù)據(jù)

A.4算法輸出產(chǎn)品的描述方法（以地表反射率產(chǎn)品為例）

（1）產(chǎn)品命名

GF1_MSS1_E88.9_N27.2_20181027_L4_0003551596_REF.tif

（2）產(chǎn)品定義和量綱

地表反射率是指地表物體在某個(gè)方向上反射的太陽(yáng)總輻射通量與從某個(gè)方向到達(dá)該物體表面上的

總輻射通量之比，表征地表對(duì)太陽(yáng)輻射的吸收和反射能力。其值為地面反射輻射量與入射輻射量之比，

無(wú)量綱。

（3）輸入輸出及精度要求

附表A.3算法輸入?yún)?shù)情況表示例（地表反射率反演算法輸入項(xiàng)）

輸入?yún)?shù)名

輸入類型說(shuō)明（核心輸入需說(shuō)明精度要求）數(shù)據(jù)解析方法（單位，取值范圍）

稱

L1級(jí)輻射定表觀反射率或輻亮度影像，輻射定標(biāo)精度優(yōu)輻亮度數(shù)據(jù)（瓦/平方米球面度，

tif

標(biāo)遙感數(shù)據(jù)于85%，云量小于20%。W/m2Sr，取值>0）

包含觀測(cè)幾何條件、地理坐標(biāo)投

元數(shù)據(jù)文件xml產(chǎn)品描述信息

影信息

定標(biāo)類型數(shù)值可選擇：表觀輻亮度、表觀反射率

大氣校正參依據(jù)界面可設(shè)置參數(shù)選擇，能見(jiàn)

數(shù)值可設(shè)置大氣模式、氣溶膠類型、初始能見(jiàn)度

數(shù)度在0-100km之間。

氣溶膠的輸入提供3種方式：其它衛(wèi)星反演

的同時(shí)相同區(qū)域氣溶膠產(chǎn)品影像（軟件準(zhǔn)備高分?jǐn)?shù)據(jù)本身反演、地面觀測(cè)或

氣溶膠（多種歷史modis或landsat產(chǎn)品并支持用戶輸其它衛(wèi)星遙感數(shù)據(jù)反演產(chǎn)品（取

tif、float

方式選擇）入）、地面觀測(cè)的氣溶膠光學(xué)厚度值（用戶值在0-2之間，是一個(gè)無(wú)量綱的

輸入）、無(wú)輸入（直接基于影像本身進(jìn)行氣正值）。

溶膠反演，由系統(tǒng)準(zhǔn)備。

附表A.4算法輸出參數(shù)情況表示例（地表反射率反演算法輸出項(xiàng)）

輸出參數(shù)名

輸出類型輸出產(chǎn)品要求（核心輸出需說(shuō)明精度要求）數(shù)據(jù)解析方法

稱

氣溶膠產(chǎn)品影像范圍內(nèi)氣溶膠反演成果。大氣柱氣溶膠光

tif可選項(xiàng)，光學(xué)厚度值，一般>0。

（可選項(xiàng)）學(xué)厚度反演精度（2σ）＞70%。

地表反射率1.為輸入衛(wèi)星數(shù)據(jù)的波段反射率產(chǎn)品和元數(shù)據(jù)地面反射輻射量與入射輻射

Tif/xml

及元信息信息。量之比，表征地面對(duì)太陽(yáng)輻射

6

T/CARSAXXXXX—202X

2.精度要求：主要用戶實(shí)驗(yàn)區(qū)內(nèi)，復(fù)雜下墊面的吸收和反射能力。（比值，

（城市和山區(qū)）地表反射率反演精度（1σ）達(dá)0-1）

到80%，其他下墊面地表反射率反演精度（1σ）

達(dá)到85%；

在薄云、霧、霾等復(fù)雜氣象條件下，復(fù)雜下墊

面地表目標(biāo)反射率反演精度（2σ）達(dá)到70%，

其他下墊面地表反射率反演精度（2σ）達(dá)到

75%；

3.波段定義：?jiǎn)尾ǘ屋敵?，有效像元?shù)量與待

檢測(cè)影像相同，保留投影信息。

每個(gè)像元的太陽(yáng)方位角、高度角和傳感器方位組成4個(gè)波段影像，單位度，

角度信息tif

角、高度角，4個(gè)角度組成四個(gè)波段。0-180°

（4）取值范圍和含義

通常物理取值范圍為0-1。表示地面反射輻射量與入射輻射量之比，表征地面對(duì)太陽(yáng)輻射的吸收和

反射能力。值越大，表示地面吸收太陽(yáng)輻射比例越少；值越小，表示地面吸收太陽(yáng)輻射比例越多。

（5）生成產(chǎn)品日期：20**年**月**日**（時(shí)）:**（分）；

（6）推薦查看工具：高分國(guó)產(chǎn)軟件V1.0、ENVI5.3；

（7）質(zhì)檢員：XXX。

A.5算法運(yùn)行環(huán)境與依賴情況檢查表

附表A.5算法運(yùn)行環(huán)境與依賴情況檢查表

是否需要

算法開(kāi)發(fā)語(yǔ)庫(kù)是否有

序庫(kù)是否有安裝或拷

言與運(yùn)行操庫(kù)名稱庫(kù)版本W(wǎng)indows備注填表人

號(hào)Linux版貝即可使

作系統(tǒng)版

用

A.6算法描述manifest文件規(guī)范

說(shuō)明該文件的存在目的，命名規(guī)范，以及內(nèi)部格式規(guī)范。文件中有主要的幾個(gè)值專門解釋如下：

command

base_image（基礎(chǔ)鏡像）

task及里面的batch（簡(jiǎn)要說(shuō)明參數(shù)組合的方式）

資源需求

參數(shù)類型（需要有個(gè)表說(shuō)明具體有哪些類型）

在說(shuō)明后加一個(gè)例子即可。

算法描述manifest文件是用來(lái)描述和定義算法的json格式的文件，其中包含算法標(biāo)識(shí)、名稱、執(zhí)行所

需硬件資源、算法的輸入和輸出參數(shù)等，平臺(tái)通過(guò)算法描述manifest文件來(lái)識(shí)別算法、構(gòu)建算法鏡像、

在流程中編排調(diào)度算法。

7

T/CARSAXXXXX—202X

附表A.6算法插件描述文件規(guī)范

序

屬性名稱描述備注

號(hào)

算法標(biāo)識(shí)建議以piesat開(kāi)頭,以算法的英文標(biāo)

識(shí)結(jié)尾，中間是算法的類型三段組成，每一段

1alg_id算法標(biāo)識(shí)

之間以“.”分隔，標(biāo)識(shí)樣例：

piesat.ortho.image_fusion

2version版本不包含字母v，例如：1.0、1.1、2.0

3type算法執(zhí)行類型cmd/python/tensorflow/pytorch/shell/java

可以為空、BatchJobTask、HumanTask、

4taskType任務(wù)類型WorkerTask，如果為空或者BatchJobTask需

要build鏡像，其他值不需要build鏡像

是否支持handler，如果是可以在主算法

5handlertrue/false

執(zhí)行前后配置執(zhí)行

6name算法名稱

7abbrev算法簡(jiǎn)稱

8desc算法描述

9package算法分組

10icon算法圖標(biāo)

11owner提供單位

12command執(zhí)行命令

13args執(zhí)行參數(shù)

目前提供piebasic,ortho,sar等相關(guān)算法依賴的

pie_basic_base_image,ortho_base_image,

14base_image基礎(chǔ)鏡像

pie_sar_base_image,ortho6_base_image等幾

種基礎(chǔ)鏡像

15labels鏡像標(biāo)簽

可選屬性，算法默認(rèn)沒(méi)有此屬性，目前僅區(qū)域

網(wǎng)平差和鑲嵌算法需要此屬性且屬性值為

16tag算法特殊標(biāo)簽

"pipeline"，表示該算法和包含該算法的流程

不支持批量拆分任務(wù)。

17envs環(huán)境信息

18resourcecpuCPU要求，可以為"500m"、”0.5“、”1“、"2"等。

8

T/CARSAXXXXX—202X

19memory內(nèi)存要求，可以為”500Mi“、"1Gi"、"2Gi"等

可選屬性，內(nèi)存是否有限制，默認(rèn)不需要設(shè)置

此屬性，內(nèi)存的request和limit都設(shè)為memory

20memoryLimit

屬性對(duì)應(yīng)的值，如果此屬性值為off，則不對(duì)

內(nèi)存設(shè)置limit限制。

GPU要求，如果不為0則需要在GPU節(jié)點(diǎn)執(zhí)

21gpu行，GPU節(jié)點(diǎn)的label為

pie.cloud.node.gpu=true

22disk存儲(chǔ)要求

23os支持操作系統(tǒng)

24arch指令集

25type算法執(zhí)行類型，比如batch

并行參數(shù)拆分方式：none,parameter,multi-

parameter

none：表示不拆分

parameter：表示只通過(guò)一個(gè)參數(shù)進(jìn)行拆分，后

26method續(xù)會(huì)有一個(gè)parameter的節(jié)點(diǎn)來(lái)表示需要拆分

的參數(shù)和粒度

multi-parameter：表示通過(guò)多個(gè)參數(shù)進(jìn)行拆分，

后續(xù)會(huì)有一個(gè)multi-parameter的節(jié)點(diǎn)來(lái)表示

需要拆分的多個(gè)參數(shù)和粒度

需要拆分的參數(shù)名稱，如果method為multi-

parameter，則name的值為數(shù)組，如下所示：

"name":[

27taskparameter/multi-name

batch"input_file",

parameter"output_file"

],

28granularity拆分粒度，示例：granularity:1

拆分后用哪個(gè)參數(shù)來(lái)顯示任務(wù)（k8sjob任務(wù)）

的名稱，不唯一，一般情況用該任務(wù)要處理的

文件路徑表示，方便用戶查閱，尤其是出錯(cuò)后。

支持對(duì)json結(jié)構(gòu)體的屬性提取，例如identity:

29identity"image.path"標(biāo)識(shí)image這個(gè)輸入?yún)?shù)是一個(gè)

json結(jié)構(gòu)體，從這個(gè)json結(jié)構(gòu)體中提取path

屬性。

image:{"type":0,"pair":0,

"path":"/data/proj2020/GF2_XXXX_PAN.tif"}

9

T/CARSAXXXXX—202X

30name參數(shù)名稱

31label參數(shù)顯示名稱

32desc參數(shù)描述

可選參數(shù)，標(biāo)識(shí)該輸出參數(shù)一些附加信息，供

業(yè)務(wù)服務(wù)使用，例如：img_sum用于統(tǒng)計(jì)圖像

33tag處理景數(shù)，如果參數(shù)值是一個(gè)數(shù)組要根據(jù)數(shù)組

元素個(gè)數(shù)進(jìn)行疊加（考慮后續(xù)擴(kuò)展需求，預(yù)留

img_sum_single,img_sum_array）

表示當(dāng)前參數(shù)與哪個(gè)參數(shù)綁定，一般與select

34bindingname

組合，當(dāng)選擇某個(gè)select值時(shí)顯示該參數(shù)

35value對(duì)應(yīng)的selectvalue，例如：option1

參數(shù)類型名稱，int、string、select、boolean、

float、file、date、dir（目錄）、spatialref、

36name

input-typeimage_pair、project_image、json_object等。

parametersproject_image示例：{"img_type":0,"pair_id":0}

37plural是否為多值，比如數(shù)組，false為單值

38extensions文件擴(kuò)展名的約束條件

枚舉類型值，參數(shù)類型為select的時(shí)候用到，

格式為key:value，其中key用來(lái)前端界面顯

示，value是算法需要的參數(shù)值，舉例：

39values"values":{"影像日期":"GF3_ImageDate","自定

constraint義名字":"GF3_CustomName","原始影像名

":"GF3_OriginalName","影像日期和時(shí)間

":"GF3_ImageDateAndTime"}

40min最小值

41max最大值

42default參數(shù)默認(rèn)值

43display是否顯示，true為顯示

44name參數(shù)名稱

45label參數(shù)顯示名稱

output-

46parametersdesc參數(shù)描述

可選參數(shù)，標(biāo)識(shí)該輸出參數(shù)是影像產(chǎn)品

47tag

product或者質(zhì)檢報(bào)告check-report等

10

T/CARSAXXXXX—202X

48operate可選參數(shù)，and、or、not

49name參數(shù)類型名稱，同input-parameters的type

type

50plural是否為多值，比如數(shù)組，false為單值

類型分為兩種input、task、output，input表示

輸出參數(shù)對(duì)應(yīng)的值來(lái)自輸入?yún)?shù)，task表示輸

51type出參數(shù)的值來(lái)自算法執(zhí)行過(guò)程中的

OUTPUT，output表示輸出參數(shù)的值來(lái)自輸出

source參數(shù)。

輸出參數(shù)對(duì)應(yīng)參數(shù)的名稱，例如：如果type為

input，此值可以對(duì)應(yīng)輸入?yún)?shù)的name，如果

52name

type為task，此值可以對(duì)應(yīng)算法output結(jié)果中

的某個(gè)key值。

用法示例源碼如下：

{

"alg_id":"piesat.modelName.algName",

"version":"1.0",

"type":"command",

"name":"算法名稱xxx",

"abbrev":"算法名稱簡(jiǎn)寫xxx",

"desc":"算法描述xxx",

"package":"a.b",

"icon":"/icon/xxx.png",

"owner":"算法著作權(quán)人xxx",

"command":"/lib64/command",

"args":"",

"base_image":"ortho_base_image:1.0",

"labels":"",

"envs":{

"ALGORITHM_ID":"alg_unique_identify",

"ALGORITHM_NAME":"/lib64/command",

"ALGORITHM_KIND":"command"

},

"resource":{

"cpu":"1",

"memory":"2Gi",

"gpu":0

},

"os":"linux",

"arch":"amd64",

11

T/CARSAXXXXX—202X

"task":{

"type":"batch",

"batch":{

"method":"multi-parameter",

"identity":"InputIMGFile",

"multi-parameter":{

"granularity":1,

"name":[

"InputIMGFile",

"InputXMLFile",

"OutputFile"

]

}

},

"input-parameters":[

{

"name":"InputIMGFile",

"constraint":{

"extensions":"*.img;*.tif;*.tiff;"

},

"tag":"img_sum",

"label":"初始影像",

"type":{

"plural":true,

"name":"file"

},

"desc":"初始影像"

},

{

"name":"InputXMLFile",

"constraint":{

"extensions":"*.xml;"

},

"label":"Xml文件",

"type":{

"plural":true,

"name":"file"

},

"desc":"Xml文件"

},

{

"default":100,

"name":"CalibrationType",

12

T/CARSAXXXXX—202X

"constraint":{

"values":{

"表觀輻亮度":100,

"表觀反射率":200

}

},

"label":"定標(biāo)類型",

"type":{

"plural":false,

"name":"select"

},

"desc":"表觀輻亮度值為100，表觀反射率值為200"

},

{

"name":"OutputFile",

"constraint":{

"extensions":"*.img;*.tif;"

},

"label":"輸出文件",

"type":{

"plural":true,

"name":"file"

},

"desc":"輸出文件"

}

],

"output-parameters":[

{

"name":"OutputFile",

"label":"輸出影像文件",

"source":{

"name