文档

CVD心血管不良事件检测

更新时间:

本文介绍图像分析处理(imageprocess)类目下的CVD心血管不良事件检测PredictCVD的语法及示例。

功能描述

基于平扫胸部(胸腹部)CT(门控或非门控都可以),实现冠脉钙化积分、主动脉钙化积分、心外膜脂肪等13种指标的量化值,并给出该患者发生心血管不良事件的概率。

说明
  • 您可以进入在线咨询获取在线人工帮助。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

接入指引

1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

2. 开通能力:请确保您已开通图像分析处理,若未开通服务请立即开通

3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权

4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。

5. 开发接入步骤:

  • SDK总览中选择您要接入使用的SDK语言。
  • 在对应语言的SDK文档中找到AI类目为图像分析处理(imageprocess)的SDK包进行安装。
  • 参考文档中提供的示例代码进行适当修改后调用。

6. 示例代码:该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

输入限制

URLList长度大于20且小于600(即每个序列的slice张数最少20张,最大支持600张),每个URL需通过HTTP协议可访问。

调用步骤

该能力为异步能力,需分以下几步进行调用。

第一步调用PredictCVD接口提交任务,请求成功后,得到一个任务ID。

第二步调用GetAsyncJobResult接口查询结果,根据任务ID查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。

计费说明

CVD心血管不良事件检测能力目前处于公测期,可免费调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String PredictCVD

系统规定参数。取值:PredictCVD

DataFormat String DICOM

图片的格式。支持DICOM或NIFTI。

OrgName String 测试组织

当前渠道(即主账号)下的子渠道(即机构,如医院)名称。

OrgId String 7ff51bfe-e73d-11ea-827d-506b4b3f3cf6

当前渠道(即主账号)下的子渠道(即机构,如医院)标识。

DataSourceType String HTTP_FILES

输入数据的类型,支持HTTP_FILES。HTTP_FILES为序列文件。

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,......的方式指定参数和参数值,参数对以&连接,其中url1、url2、......等具体值请根据实际情况进行替换;当使用SDK填充URLList时,可直接使用SDK提供的相应的方法。

返回数据

名称

类型

示例值

描述

RequestId String 7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4

请求ID。

Data Object

该数据需要在异步任务执行成功后,通过调用GetAsyncJobResult接口,对其Result字段进行JSON反序列化之后得到。

Lesion Object

病灶描述。

FeatureScore Object

特征值描述。

MyoEpiRatio Array of double 72.34564319505104, 0.19550363719463348

心肌/心外膜比率。

AscAoMaxDiam Array of double 0.5903897218571467, 0.02410123310983181

升主动脉最大直径。

CoronaryCalciumVol Array of double 142.48924255371094, 0.013891000300645828

冠状动脉钙化体积(单位:cm³)。

EatVolume Array of double 172452.69470214844, 0.02982756681740284

心脏表面和心包之间的脂肪组织体积(单位:cm³)。

AortaCalciumScore Array of double 273.66981506347656, 0.0013405405916273594

主动脉钙化评分。

CardioThoracicRatio Array of double 0.5422740524781341, 0.0005164738977327943

心胸比。

EatHUMean Array of double -85.05931303116148, 0.01098276674747467

心外脂肪组织的平均Hounsfield单位数值。

EatHUSTD Array of double 27.468474279178704, 0.09224013239145279

心外脂肪组织的Hounsfield单位数值的标准差。

RightLungLowattRatio Array of double 0.0002497813107143641, 0.028977323323488235

右肺低密度区域比值。

AscendAortaLength Array of double 90.40661132335663, 0.01413580309599638

升主动脉长度。

LeftLungLowattRatio Array of double 0.0009580087202916068, 0.0066444058902561665

左肺低密度区域比值。

DeepFeature Array of double 0.5462655425071716

深度特征值。

AortaCalciumVolume Array of double 251.05247497558594, 0.014336814172565937

主动脉钙化体积(单位:cm³)。

CoronaryCalciumScore Array of double 144.7509765625, 0.021236803382635117

冠状动脉钙化评分。

CVDProbability Float 0.5

取值(0,1)之间,描述该特征在cvd风险预测中的权重。

ResultURL Array of String http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/screen_gc/gc_11949981_stomach.nii.gz?Expires=1680678697&OSSAccessKeyId=LTAI4GC2dJzdf8ZvnC16****&Signature=EpKCTEPipWO0AiB3Uip85c%2BuMg****

病灶Mask,以HTTP地址给出。

说明 有效时间为30分钟,30分钟后链接失效,需要重新生成。
Message String 该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。

提交异步任务后的提示信息。

查询结果

该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见GetAsyncJobResult

SDK参考

阿里云视觉AI图像分析处理类目下的CVD心血管不良事件检测能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为图像分析处理(imageprocess)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览

示例代码

该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

示例

请求示例

http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=PredictCVD      //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&DataFormat=DICOM
&OrgName=测试组织
&OrgId=7ff51bfe-e73d-11ea-827d-506b4b3f3cf6
&DataSourceType=HTTP_FILES
&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
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<PredictCVDResponse>
    <RequestId>7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4</RequestId>
    <Message>该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>
</PredictCVDResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4",
  "Message" : "该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。"
}

返回示例补充说明

//查询结果:请求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=GetAsyncJobResult
&JobId=C8F0466D-A9E1-1C63-85E5-E920D8452FEE
&<公共请求参数>

//查询结果:返回示例
{
  "RequestId" : "39C848F7-D814-1A06-AE0D-AFC706B9700F",
  "Data" : {
    "Status" : "PROCESS_SUCCESS",
    "JobId" : "186AC396-0EEC-46F1-AAA1-BF3585227427",
    "Result" : {\"Lesion\":FeatureScore\:"MyoEpiRatio\":72.34564319505104,\"AscAoMaxDiam\":0.5903897218571467,\"CoronaryCalciumVol\":142.489242553710,\"EatVolume\":172452.69470214844,\"AortaCalciumScore\":273.66981506347656,\"CardioThoracicRatio\":0.5422740524781341,\"EatHUMean\":-85.05931303116148,\"EatHUSTD\":27.468474279178704, 0.09224013239145279,\"RightLungLowattRatio\":0.0002497813107143641,\"AscendAortaLength\":90.40661132335663,\"LeftLungLowattRatio\":0.0009580087202916068,\"DeepFeature\":0.5462655425071716,\"CoronaryCalciumScore\":144.7509765625, 0.021236803382635117,\"CVDProbability\":0.5,\"ResultURL\":\"http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/screen_gc/gc_11949981_stomach.nii.gz?Expires=1680678697&OSSAccessKeyId=LTAI4GC2dJzdf8ZvnC16****&Signature=EpKCTEPipWO0AiB3Uip85c%2BuMg****\"
  }
}

//Result反序列化
{
    "Lesion" : [ {
      "MyoEpiRatio" : 72.34564319505104,
      "AscAoMaxDiam" : 0.5903897218571467, 
      "CoronaryCalciumVol" : 142.48924255371094,
      "EatVolume" : 172452.69470214844,
      "AortaCalciumScore" : 273.66981506347656,
      "CardioThoracicRatio" : 0.5422740524781341,
      "EatHUMean" : -85.05931303116148,
      "EatHUSTD" : 27.468474279178704,
      "RightLungLowattRatio" : 0.0002497813107143641,
      "AscendAortaLength" : 90.40661132335663,
      "LeftLungLowattRatio : 0.0009580087202916068,	
      "DeepFeature" : 0.5462655425071716,
      "AortaCalciumVolume" : 251.05247497558594,
      "MyoEpiRatio" : 72.34564319505104,	
      "CoronaryCalciumScore" : 144.7509765625
    } ]
    "CVDProbability" : 0.5,
    "ResultURL" : "http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/screen_gc/gc_11949981_stomach.nii.gz?Expires=1680678697&OSSAccessKeyId=LTAI4GC2dJzdf8ZvnC16****&Signature=EpKCTEPipWO0AiB3Uip85c%2BuMg****"
}

错误码

关于CVD心血管不良事件检测的错误码。详情请参见常见错误码

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。