本文介紹圖像分析處理(imageprocess)類目下的胸部CT肺結節(jié)檢測DetectLungNodule的語法及示例。
功能描述
胸部CT肺結節(jié)檢測能力可以對輸入的胸部常規(guī)CT形成的DICOM影像(如5mm的單個序列,API僅接受單序列),進行肺結節(jié)的輔助診斷。針對每一個結節(jié),主要通過以下方式進行描述:
- 結節(jié)的坐標(coordX,coordY,coordZ)、直徑(diameter_mm)。
- 結節(jié)在肺葉的位置,例如左肺或右肺,以及肺葉分段(左肺上下葉、右肺上中下葉),通過lung和lobe兩個參數共同確定。
- 結節(jié)分類及概率。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通圖像分析處理,若未開通服務請立即開通。
3. 創(chuàng)建AccessKey:請確保您已創(chuàng)建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發(fā)接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為圖像分析處理(imageprocess)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 示例代碼:該能力常用語言查詢異步任務結果的示例代碼,請參見查詢異步任務結果示例代碼。
7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 影像格式:DICOM。
- 影像分辨率:小于等于512×512像素。
- 單張DICOM影像大小不超過1 MB。
- 輸入最少20張,最多600張。
- URL中不能包含中文字符。
計費說明
關于胸部CT肺結節(jié)檢測的計費方式及報價,請參見計費介紹。
調用步驟
該能力為異步能力,需分兩步進行調用。
第一步調用DetectLungNodule接口提交任務,請求成功后,得到一個任務ID。
第二步調用GetAsyncJobResult接口查詢結果,根據任務ID查詢任務執(zhí)行狀態(tài)和結果。如果任務還在處理中,可稍等一段時間后再進行查詢。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DetectLungNodule | 系統規(guī)定參數。取值:DetectLungNodule。 |
DataFormat | String | 是 | DICOM | 圖像格式:DICOM。 |
OrgName | String | 是 | weiyi | 數據來源機構名稱。 |
OrgId | String | 是 | 0001 | 數據來源機構代碼。 |
URLList.N.URL | String | 是 | https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/000001.dcm | DICOM影像的圖像URL地址。長度小于600。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 說明 URLList.N.URL中的N為該圖像URL在當前List中的順序(從1開始)。當直接使用API請求時,輸入URLList的填充會以URLList.1.URL=url1,URLList.2.URL=url2,......的方式指定參數和參數值,參數對以&連接,其中url1、url2、......等具體值請根據實際情況進行替換;當使用SDK填充URLList時,可直接使用SDK提供的相應的方法。 |
Threshold | Float | 否 | 0.60 | 結點閾值。默認取值0.60,取值范圍 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 9889ef5b-b973-4dd0-9f26-3b9cc489c436 | 請求ID。 |
Data | Object | 返回的結果數據內容。 該數據需要在異步任務執(zhí)行成功后,通過調用GetAsyncJobResult接口,對其Result字段進行JSON反序列化之后得到。 |
|
Series | Array of Serie | 本次影像分析的分序列的結果,只支持單序列,故該jsonArray的長度為1。數組元素為單個序列的檢測結果,由analysisResult和seriesInstanceUid構成。 |
|
SeriesInstanceUid | String | 1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192 | 本次分析影像的序列ID。 |
Elements | Array of Element | 結節(jié)描述。 |
|
Z | Float | -46.81608170781766 | 結節(jié)在物理坐標系中的z軸坐標值。 |
Lobe | String | up | 肺葉分段。取值包括:up(上葉)、middle(中葉)、down(下葉)及unknown(未知)。 |
MeanValue | Float | 261.37589112119247 | 平均CT值,單位為HU。 |
ImageZ | Float | 20.434030793471255 | 結節(jié)在圖像坐標系中的z軸坐標值。 |
Lung | String | left | 結節(jié)在肺葉的位置。取值包括:left(左肺)、right(右肺)及unknown(未知)。 |
Confidence | Float | 0.7012705768508907 | 結節(jié)分類的置信度。 |
SOPInstanceUID | String | 1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013 | 結節(jié)中心位置所在幀的ID標識。 |
ImageX | Float | 308.9676976455463 | 結節(jié)在圖像坐標系中的x軸坐標值。 |
Y | Float | -32.23147700784307 | 結節(jié)在物理坐標系中的y軸坐標值。 |
Category | String | 1 | 結節(jié)分類,取值包括:
|
Volume | Float | 10959.220491175074 | 結節(jié)體積,單位為mm3。 |
ImageY | Float | 198.3552282631497 | 結節(jié)在圖像坐標系中的y軸坐標值。 |
Diameter | Float | 9.730626493692398 | 結節(jié)的直徑。 |
X | Float | 51.24291240631416 | 結節(jié)在物理坐標系中的x軸坐標值。 |
RecistSOPInstanceUID | String | 1.3.6.1.4.1.14519.5.2.1.6279.6001.468208655866166788627471660948 | 結節(jié)最大徑位置所在幀的ID標識。 |
MajorAxis | Array of Float | [178,212,185,217,6.0] | start_x, start_y, end_x, end_y, len五元組,其中start和end為圖像坐標系下長徑的起止點,len為長徑長度(mm)。 |
MinorAxis | Array of Float | [184,213,181,218,4.0] | start_x, start_y, end_x, end_y, len五元組,其中start和end為圖像坐標系下短徑的起止點,len為長徑長度(mm)。 |
Risk | Float | 0.173 | 結節(jié)為惡性的置信度。取值范圍0~1。 |
Origin | Array of Float | [-166.0,-171.6999969482422,-340.0] | 圖像坐標系原點在物理坐標系中的位置。 |
Report | String | 肺部見1個實性結節(jié),直徑約為25.60mm,體積為11512.06mm3,平均CT值為-6.90HU。 | 該DICOM序列經過AI分析后AI服務給出的參考報告。 |
Spacing | Array of Float | [0.703125,0.703125,14.34782600402832] | 每個像素的實際距離間隔。 |
Message | String | 該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執(zhí)行狀態(tài)和結果。 | 提交異步任務后的提示信息。 |
查詢結果
該接口為異步接口,當前并未返回真實的請求結果,您需要通過返回的RequestId調用GetAsyncJobResult接口來獲取該接口的真實請求結果。詳情請參見GetAsyncJobResult。
SDK參考
阿里云視覺AI圖像分析處理類目下的胸部CT肺結節(jié)檢測能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為圖像分析處理(imageprocess)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言查詢異步任務結果的示例代碼,請參見查詢異步任務結果示例代碼。
示例
請求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=DetectLungNodule //更多關于訪問域名(Endpoint)信息,請參見:http://m.bestwisewords.com/document_detail/143103.html
&DataFormat=DICOM
&OrgId=0001
&OrgName=weiyi
&URLList.1.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/000001.dcm
&URLList.2.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/000002.dcm
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetectLungNoduleResponse>
<RequestId>9889ef5b-b973-4dd0-9f26-3b9cc489c436</RequestId>
<Message>該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執(zhí)行狀態(tài)和結果。</Message>
</DetectLungNoduleResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "9889ef5b-b973-4dd0-9f26-3b9cc489c436",
"Message" : "該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執(zhí)行狀態(tài)和結果。"
}
返回示例補充說明
//查詢結果:請求示例
http(s)://videoenhan.cn-shanghai.aliyuncs.com/?Action=GetAsyncJobResult
&JobId=E75FE679-0303-4DD1-8252-1143B4FA8A27
&<公共請求參數>
//查詢結果:返回示例
{
"RequestId" : "43A0AEB6-45F4-4138-8E89-E1A5D63200E3",
"Data" : {
"Status" : "PROCESS_SUCCESS",
"JobId" : "186AC396-0EEC-46F1-AAA1-BF3585227427",
"Result" : {\"Series\":\"SeriesInstanceUid\":\"1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192\",\"Elements\":\"Z\":-46.81608170781766,\"Lobe\":\”up\",\"MeanValue\":261.37589112119247,-90,\"ImageZ\":20.434030793471255,\"Lung\": \"left\",\"0.7012705768508907\",\"SOPInstanceUID\":\"1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013\",\"ImageX\":308.9676976455463,\"Y\":-32.23147700784307,\"Category\":\"1\",\"Volume\":10959.220491175074,\"ImageY\":198.3552282631497,\"Diameter\":9.730626493692398,\"X\":51.24291240631416,\"RecistSOPInstanceUID\" : \"1.3.6.1.4.1.14519.5.2.1.6279.6001.468208655866166788627471660948\",\"MajorAxis\" : [178,212,185,217,6.0],\"MinorAxis\" : [184,213,181,218,4.0],\"Risk\" : 0.173,\"Origin\":[-166.0,-171.6999969482422,-340.0],\"Report\":\"肺部見1個實性結節(jié),直徑約為25.60mm,體積為11512.06mm3,平均CT值為-6.90HU。\",\"Spacing\":[0.703125,0.703125,14.34782600402832]}"
}
}
//Result反序列化
{
"Series" : [ {
"SeriesInstanceUid" : "1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192",
"Elements" : [ {
"Score" : 0.99,
"Z" : -46.81608170781766,
"Lobe" : "up",
"MeanValue" : 261.37589112119247,
"ImageZ" : 20.434030793471255,
"Lung" : "left",
"Confidence" : 0.7012705768508907,
"SOPInstanceUID" : "1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013",
"ImageX" : 308.9676976455463,
"Y" : -32.23147700784307,
"Category" : "1",
"Volume" : 10959.220491175074,
"ImageY" : 198.3552282631497,
"Diameter" : 9.730626493692398,
"X" : 51.24291240631416,
"RecistSOPInstanceUID" : "1.3.6.1.4.1.14519.5.2.1.6279.6001.468208655866166788627471660948",
"MajorAxis" : [178,212,185,217,6.0],
"MinorAxis" : [184,213,181,218,4.0],
"Risk" : 0.173
} ]
"Origin" : [-166.0,-171.6999969482422,-340.0],
"Report" : "肺部見1個實性結節(jié),直徑約為25.60mm,體積為11512.06mm3,平均CT值為-6.90HU。",
"Spacing" : [0.703125,0.703125,14.34782600402832]
} ]
}
錯誤碼
關于胸部CT肺結節(jié)檢測的錯誤碼。詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規(guī)。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。