样例字段语义
| 分组 | 字段 | 英文键 | 语义 |
|---|
| 队列定义 | 队列名称与定义版本 | cohort_name / version | 该队列的名称及其规则版本;改一条入排条件即换一个版本,两版结果可并存比对 |
| 入排条件 | 条件类型 | criterion_type | 纳入条件、排除条件还是键可用性条件,三类在筛选流程中的作用不同 |
| 入排条件 | 规则表达式 | rule_expression | 该条件的可执行表达式,使用方可据此在自己的数据上复算同一队列 |
| 候选索引事件 | 索引时点 | indextimeraw | 该候选据以定位的时间基准,如首次满足条件的实际入院时点;全部基线与随访窗以此为原点 |
| 候选索引事件 | 候选状态 | candidate_status | 该候选是否通过全部条件评价,未通过的候选保留在库内可查 |
| 条件评价 | 评价结论 | evaluation_status | 该候选在该条件下的结论取满足、不满足或未知;无证据时取未知 |
| 条件评价 | 证据时间 | evidencetimeraw | 该条评价所依据的临床事实发生时点 |
| 条件评价 | 证据首次可用时间 | available_time | 该证据首次可被读取的时点;索引后才确认的信息此项为未知,据此可判断该条件能否用于索引时点的预测任务 |
| 队列成员 | 成员状态与资格依据 | membershipstatus / membershipbasis | 该患者—索引组合是否成为成员及其依据;同一患者在不同定义或不同索引下可有多个成员实例 |
| 基线变量 | 变量名与取值 | variablename / valueraw | 基线窗内观测到的特征及其取值,如既往病史、基线检验值、合并用药 |
| 基线变量 | 基线覆盖状态 | coverage_status | 该变量的基线窗实际覆盖情况;目标窗为一年而实际可见历史仅数十天时标为部分覆盖 |
| 亚组归属 | 亚组名称与归属状态 | subgroupname / membershipstatus | 该成员是否属于某预设亚组,依据不足时取未知 |
| 队列流程步骤 | 步骤名与计数 | step_name / count | 筛选漏斗的每一步及其剩余数量,可直接绘制成研究流程图 |
样例记录
一个成人缺血性脑血管病回顾性队列的完整构造过程。含入排条件的规则表达式、候选索引住院、逐条条件评价及其证据时间与可用时间。成员资格依据、基线窗的目标长度与实际覆盖长度一并给出。
{
"样例性质": "真实记录·已脱敏",
"cohort_definition": {
"cohort_name": "retrospective ischemic cerebrovascular cohort",
"definition_id": "DEFINITION-0000001",
"version": "adult_ischemic_cerebrovascular_retrospective_v0.1"
},
"eligibility_criterion": [
{
"criterion_id": "CRITERION-0000001",
"criterion_type": "adult",
"definition_id": "DEFINITION-0000001",
"rule_expression": "age >= 18"
},
{
"criterion_id": "CRITERION-0000002",
"criterion_type": "actual_inpatient",
"definition_id": "DEFINITION-0000001",
"rule_expression": "actual inpatient source record"
},
{
"criterion_id": "CRITERION-0000003",
"criterion_type": "retrospective_discharge_confirmation",
"definition_id": "DEFINITION-0000001",
"rule_expression": "source discharge diagnosis confirms qualifying condition"
}
],
"candidate_index_event": {
"candidate_id": "CANDIDATE-0000001",
"candidate_status": "retrospective_candidate",
"definition_id": "DEFINITION-0000001",
"encounter_key": "ENCOUNTER-0000001",
"index_time_raw": "2021-09-30 10:20:00",
"patient_id": "PATIENT-0000001"
},
"criterion_evaluation": [
{
"available_time": "2021-09-30 10:20:00",
"candidate_id": "CANDIDATE-0000001",
"criterion_id": "CRITERION-0000001",
"evaluation_id": "EVALUATION-0000001",
"evaluation_status": "met_retrospectively",
"evidence_time_raw": "2021-09-30 10:20:00"
},
{
"available_time": "2021-09-30 10:20:00",
"candidate_id": "CANDIDATE-0000001",
"criterion_id": "CRITERION-0000002",
"evaluation_id": "EVALUATION-0000002",
"evaluation_status": "met_retrospectively",
"evidence_time_raw": "2021-09-30 10:20:00"
},
{
"available_time": null,
"candidate_id": "CANDIDATE-0000001",
"criterion_id": "CRITERION-0000003",
"evaluation_id": "EVALUATION-0000003",
"evaluation_status": "met_retrospectively",
"evidence_time_raw": "2021年10月05日 10:10"
}
],
"cohort_flow_step": [
{
"count": "1",
"definition_id": "DEFINITION-0000001",
"flow_id": "FLOW-0000001",
"step_name": "candidate_index"
},
{
"count": "1",
"definition_id": "DEFINITION-0000001",
"flow_id": "FLOW-0000002",
"step_name": "eligible_retrospectively"
},
{
"count": "1",
"definition_id": "DEFINITION-0000001",
"flow_id": "FLOW-0000003",
"step_name": "included_member"
}
],
"cohort_member": {
"candidate_id": "CANDIDATE-0000001",
"definition_id": "DEFINITION-0000001",
"member_id": "MEMBER-0000001",
"membership_basis": "post_index_discharge_diagnosis_available_time_unknown",
"membership_status": "included_retrospectively",
"patient_id": "PATIENT-0000001"
},
"baseline_variable": {
"coverage_status": "partial_target_365d",
"member_id": "MEMBER-0000001",
"value_raw": "33",
"variable_id": "VARIABLE-0000001",
"variable_name": "observed_baseline_coverage_days"
},
"quality_issue": {
"handling": "unknown is not false; confirmation cannot enter admission-time prediction",
"issue_code": "baseline_coverage_partial_and_confirmation_post_index",
"member_id": "MEMBER-0000001",
"quality_issue_id": "QUALITY_ISSUE-0000001"
}
}