脂肪肝檢測
本文介紹圖像分析處理(imageprocess)類目下的脂肪肝檢測DetectLiverSteatosis的語法及示例。
功能描述
脂肪肝檢測算法可以根據(jù)輸入的胸部或腹部CT成像進行肝脾定位分割,以及肝脾全局或局部密度統(tǒng)計測量,最終根據(jù)測量結(jié)果和深度模型計算,判斷有無脂肪肝以及脂肪肝的嚴重程度。
- 您可以進入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。
應(yīng)用場景
體檢篩查:支持輸入胸腹部平掃CT評估脂肪肝風險,可輸出分類結(jié)果和病灶分割結(jié)果。
特色優(yōu)勢
- 脂肪肝風險評估:給出有無脂肪肝的概率,并評估脂肪肝的嚴重程度。
- 病灶可視化:并輸出脂肪肝體積及對應(yīng)的分割結(jié)果(以NIFTI文件標識)。
接入指引
1. 注冊阿里云賬號:打開阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通圖像分析處理,若未開通服務(wù)請立即開通。
3. 創(chuàng)建AccessKey:請確保您已創(chuàng)建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權(quán)限,具體操作,請參見RAM授權(quán)。
4. 在線調(diào)試(可選):您可以通過OpenAPI Explorer在線調(diào)試能力,查看完整的調(diào)用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發(fā)接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應(yīng)語言的SDK文檔中找到AI類目為圖像分析處理(imageprocess)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調(diào)用。
6. 示例代碼:該能力常用語言查詢異步任務(wù)結(jié)果的示例代碼,請參見查詢異步任務(wù)結(jié)果示例代碼。
7. 客戶端直接調(diào)用:該能力常用的客戶端調(diào)用方式包括以下幾種。
輸入限制
- 如果SourceType字段為
HTTP_FILES
且DataFormat字段為DICOM
,URLList長度大于20且小于600(即每個序列的slice張數(shù)最少20張,最大支持600張),每個URL需通過HTTP協(xié)議可訪問。 - 如果SourceType字段為
HTTP_NII
且DataFormat字段為NIFTI
,URLList長度須僅為1且可訪問。
調(diào)用步驟
該能力為異步能力,需分兩步進行調(diào)用。
第一步調(diào)用DetectLiverSteatosis接口提交任務(wù),請求成功后,得到一個任務(wù)ID。
第二步調(diào)用GetAsyncJobResult接口查詢結(jié)果,根據(jù)任務(wù)ID查詢?nèi)蝿?wù)執(zhí)行狀態(tài)和結(jié)果。如果任務(wù)還在處理中,可稍等一段時間后再進行查詢。
計費說明
脂肪肝檢測能力目前處于公測期,可免費調(diào)用。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DetectLiverSteatosis | 系統(tǒng)規(guī)定參數(shù)。取值:DetectLiverSteatosis。 |
DataFormat | String | 是 | DICOM | 圖片的格式。支持DICOM或NIFTI。 |
OrgName | String | 是 | 測試組織 | 當前渠道(即主賬號)下的子渠道(即機構(gòu),如醫(yī)院)名稱。 |
OrgId | String | 是 | 7ff51bfe-e73d-11ea-827d-506b4b3f3cf6 | 當前渠道(即主賬號)下的子渠道(即機構(gòu),如醫(yī)院)標識。 |
SourceType | String | 是 | HTTP_FILES | 輸入數(shù)據(jù)的類型,支持HTTP_FILES和HTTP_NII。
|
URLList.N.URL | String | 是 | https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/0001.dcm | DICOM序列文件URL列表或NIFTI文件URL列表["url","url",......]。 推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 說明 URLList.N.URL中的N為該圖像URL在當前List中的順序(從1開始)。當直接使用API請求時,輸入URLList的填充會以URLList.1.URL=url1,URLList.2.URL=url2,......的方式指定參數(shù)和參數(shù)值,參數(shù)對以&連接,其中url1、url2、......等具體值請根據(jù)實際情況進行替換;當使用SDK填充URLList時,可直接使用SDK提供的相應(yīng)的方法。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 39C848F7-D814-1A06-AE0D-AFC706B9700F | 請求ID。 |
Data | Object | 該數(shù)據(jù)需要在異步任務(wù)執(zhí)行成功后,通過調(diào)用GetAsyncJobResult接口,對其Result字段進行JSON反序列化之后得到。 |
|
Detections | Array of Detections | 脂肪肝檢出結(jié)果。 |
|
ROI1Center | Array of Long | [98,193] | 肝臟ROI1中心坐標。 |
ROI2Center | Array of Long | [182,166] | 肝臟ROI2中心坐標。 |
ROI3Center | Array of Long | [182,296] | 肝臟ROI3中心坐標。 |
SpleenCenter | Array of Long | [433,346] | 脾臟ROI中心坐標。 |
Radius | Long | 1.0 | 圓形ROI半徑。 |
LiverSlice | Float | 12.0 | 肝臟ROI對應(yīng)的slice坐標。 |
SpleenSlice | Float | 9.0 | 脾臟ROI對應(yīng)的slice坐標。 |
LiverVolume | Float | 1059.4175610625439 | 肝臟體積測量。單位:cm3(立方厘米)。 |
SpleenVolume | Float | 156.01873229470647 | 脾臟體積測量。單位:cm3(立方厘米)。 |
LiverHU | Float | 62.07644147383561 | 肝臟衰減值。 |
SpleenHU | Float | 53.86993919857013 | 脾臟衰減值。 |
LiverROI1 | Float | 63.50222396850586 | 肝臟局部ROI1衰減值。 |
LiverROI2 | Float | 62.23713684082031 | 肝臟局部ROI2衰減值。 |
LiverROI3 | Float | 59.78181838989258 | 肝臟局部ROI3衰減值。 |
SpleenROI | Float | 50.553409576416016 | 脾臟局部ROI衰減值。 |
LiverSpleenDifference | Float | 8.206502275265478 | 肝脾衰減差。 |
LiverSpleenRatio | Float | 1.15233917834983 | 肝脾衰減比。 |
Prediction | String | Mod | 檢測結(jié)果等級,包括無,輕,中,重。 |
Probability | Float | 0.9457855224609375 | 脂肪肝概率。 |
Spacing | Array of Float | [3.75,0.576172,0.576172] | 每個像素之間的物理距離間隔。 |
Origin | Array of Float | [-325.0,-155.300003,-146.699997] | 像素坐標系原點在物理坐標系中的位置。 |
Message | String | 該調(diào)用為異步調(diào)用,任務(wù)已提交成功,請以requestId的值作為jobId參數(shù)調(diào)用同類目下GetAsyncJobResult接口查詢?nèi)蝿?wù)執(zhí)行狀態(tài)和結(jié)果。 | 提交異步任務(wù)后的提示信息。 |
查詢結(jié)果
該接口為異步接口,當前并未返回真實的請求結(jié)果,您需要通過返回的RequestId調(diào)用GetAsyncJobResult接口來獲取該接口的真實請求結(jié)果。詳情請參見GetAsyncJobResult。
SDK參考
阿里云視覺AI圖像分析處理類目下的脂肪肝檢測能力推薦使用SDK調(diào)用,支持多種編程語言,調(diào)用時請選擇AI類目為圖像分析處理(imageprocess)的SDK包,文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言查詢異步任務(wù)結(jié)果的示例代碼,請參見查詢異步任務(wù)結(jié)果示例代碼。
示例
請求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=DetectLiverSteatosis //更多關(guān)于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&URLList.1.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/0001.dcm
&URLList.2.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/0002.dcm
&公共請求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetectLiverSteatosisResponse>
<RequestId>39C848F7-D814-1A06-AE0D-AFC706B9700F</RequestId>
<Message>該調(diào)用為異步調(diào)用,任務(wù)已提交成功,請以requestId的值作為jobId參數(shù)調(diào)用同類目下GetAsyncJobResult接口查詢?nèi)蝿?wù)執(zhí)行狀態(tài)和結(jié)果。</Message>
</DetectLiverSteatosisResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "39C848F7-D814-1A06-AE0D-AFC706B9700F",
"Message" : "該調(diào)用為異步調(diào)用,任務(wù)已提交成功,請以requestId的值作為jobId參數(shù)調(diào)用同類目下GetAsyncJobResult接口查詢?nèi)蝿?wù)執(zhí)行狀態(tài)和結(jié)果。"
}
返回示例補充說明
//查詢結(jié)果:請求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=GetAsyncJobResult
&JobId=C8F0466D-A9E1-1C63-85E5-E920D8452FEE
&<公共請求參數(shù)>
//查詢結(jié)果:返回示例
{
"RequestId" : "39C848F7-D814-1A06-AE0D-AFC706B9700F",
"Data" : {
"Status" : "PROCESS_SUCCESS",
"JobId" : "186AC396-0EEC-46F1-AAA1-BF3585227427",
"Result" : {\"Detections\":[{\"LiverVolume\":1059.4175610625439,\"ROI1Center\":[98,193],\"ROI2Center\":[182,166],\"ROI3Center\":[182,296],\"SpleenCenter\":[433,346],\"LiverSlice\":12.0,\"SpleenSlice\":9.0,\"Radius\":10,\"SpleenVolume\":156.01873229470647,\"LiverHU\":62.07644147383561,\"SpleenHU\":53.86993919857013,\"LiverROI1\":63.50222396850586,\"LiverROI2\":62.23713684082031,\"LiverROI3\":59.78181838989258,\"SpleenROI\":50.553409576416016,\"LiverSpleenDifference\":8.206502275265478,\"LiverSpleenRatio\":1.15233917834983,\"Prediction\":\"Mod\",\"Probability\":0.9457855224609375}],\"Spacing\":[3.75,0.576172,0.576172],\"Origin\":[-325.0,-155.300003,-146.699997]}"
}
}
//Result反序列化
{
"Detections" : [ {
"ROI1Center" : [98,193],
"ROI2Center" : [182,166],
"ROI3Center" : [182,296],
"SpleenCenter" : [433,346],
"Radius" : 1.0,
"LiverSlice" : 12.0,
"SpleenSlice" : 9.0,
"LiverVolume" : 1059.4175610625439,
"SpleenVolume" : 156.01873229470647,
"LiverHU" : 62.07644147383561,
"SpleenHU" : 53.86993919857013,
"LiverROI1" : 63.50222396850586,
"LiverROI2" : 62.23713684082031,
"LiverROI3" : 59.78181838989258,
"SpleenROI" : 50.553409576416016,
"LiverSpleenDifference" : 8.206502275265478,
"LiverSpleenRatio" : 1.15233917834983,
"Prediction" : Mod,
"Probability" : 0.9457855224609375,
} ]
"Spacing" : [3.75,0.576172,0.576172],
"Origin" : [-325.0,-155.300003,-146.699997]
}
錯誤碼
關(guān)于脂肪肝檢測的錯誤碼。詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
- 通過體驗調(diào)試上傳的臨時文件有效期為1小時,在24小時后會被系統(tǒng)自動清理刪除。