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