- 28 Jun 2025
- 18 Minutes to read
- Print
- DarkLight
[DM/URSA-CKD] Data Mart for URSA-CKD Patient Timelines
- Updated on 28 Jun 2025
- 18 Minutes to read
- Print
- DarkLight
Object Description
One row per patient-period during which the patient met the criteria for CKD (of any stage, or with an unknown stage).
Metadata
- Table Name: ursa.dm_ursa_ckd_001
- Layer: DATA_MART
- Object Type: Single Stack
- Temporal Class: Interval (Timeline)
- Case ID: Patient ID
- Interval Start Date: Period Start Date
- Interval End Date: Period End Date
- Primary Key: Patient ID, Period Start Date, Period End Date
Published Fields
Data Model Keys
- Patient ID -- The internal database identifier (used, e.g., for joins and primary keys) for the patient. This value is typically mastered, i.e., all records for the same patient, regardless of the source data system from which that record originated, should have the same Patient ID value. (Note that while the mastered Patient ID value might resemble a local identifier used in one of the upstream data sources, this does not indicate any special priority of that source system in determining the characteristics of the patient.) (See also [URSA-CORE] Patient)
- Primary Plan ID
- Primary Payor ID -- The internal database identifier (used, e.g., for joins and primary keys) for the Primary Payor. (See also [URSA-CORE] Primary Payor)
- Primary Plan Attributee Provider ID
- Empirical Attributee Individual Nephrology Provider ID
- Empirical Attributee Nephrology Group Provider ID
- Empirical Attributee Primary Care Individual Provider ID
- Empirical Attributee Primary Care Provider Group Provider ID
Date Fields
- Period Start Date
- Period End Date
- Current Continuous Primary Payor Membership Episode Start Date -- The start date of the Continuous Primary Payor Membership Episode in effect as of the (potentially historical) period covered by the record. (See also [URSA-CORE] Continuous Primary Payor Membership Episode)
- Current Continuous Primary Payor Membership Episode End Date -- The end date of the Continuous Primary Payor Membership Episode in effect as of the (potentially historical) period covered by the record. Values follow the standard exclusive convention for Period End Dates. (See also [URSA-CORE] Continuous Primary Payor Membership Episode, [URSA-CORE] Period End Date)
- Current Dialysis Episode Start Date
- Current Dialysis Episode End Date
- Last Continuous Primary Payor Membership Episode End Date -- The end date of the most recent prior completed Continuous Primary Payor Membership Episode as of the (potentially historical) period covered by the record. Values follow the standard exclusive convention for Period End Dates. (See also [URSA-CORE] Continuous Primary Payor Membership Episode, [URSA-CORE] Period End Date)
- Last Continuous Primary Payor Membership Episode Start Date -- The start date of the most recent prior completed Continuous Primary Payor Membership Episode as of the (potentially historical) period covered by the record. (See also [URSA-CORE] Continuous Primary Payor Membership Episode)
- Current Continuous Medical Claim Data Coverage Episode End Date -- The end date of the Continuous Medical Claim Data Coverage Episode in effect as of the (potentially historical) period covered by the record. Values follow the standard exclusive convention for Period End Dates. (See also [URSA-CORE] Continuous Medical Claim Data Coverage Episode, [URSA-CORE] Period End Date)
- Current Continuous Medical Claim Data Coverage Episode Start Date -- The start date of the Continuous Medical Claim Data Coverage Episode in effect as of the (potentially historical) period covered by the record. (See also [URSA-CORE] Continuous Medical Claim Data Coverage Episode)
- Current CKD Stage Start Date
- Current CKD Stage End Date
- Patient Date of Birth -- The patient's date of birth. On the Patients Natural Object, this field reflects the "best" known value for the patient available from all data sources; on other Natural Objects, e.g., MMR Member-Months, the value faithfully reflects the date of birth found on that particular type of record in the source data.
Module Fields
- CKD Stage Category
- Is CKD Stage 1 -- The stage of a patient’s chronic kidney disease (CKD), for stage 1 through stage 5 and ESRD. Stage is only calculated for patients already meeting the criteria for CKD. Stage is determined by a combination of the following: (1) ICD-10-CM codes specific to a particular stage; (2) eGFR lab results within certain bands associated with a stage (see below); (3) identification of the patient in a CMS Monthly Membership Report as an ESRD beneficiary; (4) documentation of a prior kidney transplantation surgery; and/or (5) status as a chronic dialysis patient. The patient’s CKD stage can change over time, so a patient timeline data structure is appropriate.
The following eGFR bands are used:
GFR >= 90: Stage 1;
60 <= GFR < 90: Stage 2;
30 <= GFR < 60: Stage 3;
15 <= GFR < 30: Stage 4;
GFR < 15: Stage 5.
The appropriate race-specific eGFR lab is used when the patient's race is known. (See also [URSA-CKD] Is Chronic Dialysis Patient, [URSA-CKD] Kidney Transplantation Surgery Encounter)
Is CKD Stage 2
Is CKD Stage 3
Is CKD Stage 4
Is CKD Stage 5
Is ESRD
Is CKD Stage Unknown
Is CKD Stage 3 or Higher
Is CKD Stage 4 or Higher
Is Chronic Dialysis Patient -- Indicates that the patient has either (1) documentation in the last 12 months of a chronic dialysis status code; or (2) is currently undergoing regular episode as part of an episode that contains at least one non-inpatient dialysis encounter.
Is History of Kidney Transplantation
CKD Physician Management Category
Patient Fields
- Is Patient Alive
- Patient Age Integer -- Patient age, expressed as an integer, as of a reference date or interval.
- Patient Age Category Tier 1 -- Non-overlapping ranges of the patient age in years into three categories; [01] Pediatrics < 19, [02] Adults 19 - 64, and [03] Older Adults >= 65. Coarser grain to the Patient Age Category Tier 2. (See also [URSA-CORE] Patient Age Category Tier 2)
- Patient Age Category Tier 2 -- Non-overlapping ranges of the patient age in years representing finer grain categories than the Patient Age Category Tier 1. This field incorporates findings from publications on defining meaningful age groups in the context of disease. These ranges closely, but not exactly, align with standard age ranges such as those defined by the Medical Subject Headings (MeSH). See results of K-Means simple clustering method at: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC3825015/ (See also [URSA-CORE] Patient Age Category Tier 1)
- Patient Sex Category
- Count Hospital Inpatient Admissions in Last 12 Months
- Count ED Visits Without Inpatient Admissions in Last 12 Months
Provider Fields
- Plan Attributee Provider Description
- Count Nephrology Provider Visits in Last 12 Months
- Empirical Attributee Individual Nephrology Provider Description
- Empirical Attributee Nephrology Group Provider Description
- Count Primary Care Visits for CKD in Last 12 Months
- Primary Care Engagement Category
- Count Primary Care Visits in Last 36 Months
- Empirical Attributee Primary Care Provider Group Description
- Empirical Attributee Individual Primary Care Provider Description
- Count Nephrology Provider Visits in Last 6 Months
- Count Visits with Attributee Individual Primary Care Provider in Last 36 Months
- Count Visits with Attributee Primary Care Provider Group in Last 36 Months
- Empirical Attributee Individual Nephrology Provider Practice Zip Code
- Practice Address ZIP Code 5-Digit
Patient Observation Fields
- Last GFR Result Date
- Last Race-Adjusted GFR Result Numeric
- Is Last Race-Adjusted GFR in CKD Stage 1 Range
- Is Last Race-Adjusted GFR in CKD Stage 2 Range
- Is Last Race-Adjusted GFR in CKD Stage 3 Range
- Is Last Race-Adjusted GFR in CKD Stage 3a Range
- Is Last Race-Adjusted GFR in CKD Stage 3b Range
- Is Last Race-Adjusted GFR in CKD Stage 4 Range
- Is Last Race-Adjusted GFR in CKD Stage 5 Range
Clinical Services Fields
- Is Hospice in Last 12 Months -- Evidence of CMS hospice status or evidence of hospice services in the last 12 months. Typically used as a denominator exclusion.
- Is Last Dialysis Modality Hemodialysis
- Is Last Dialysis Modality Peritoneal Dialysis
Insurance Fields
- Is Any Current Plan Membership
- Primary Plan Description
- Is CMS ESRD Status -- Indicates the patient meets the Medicare ESRD eligibility criterion as of a particular date; can be derived from the CMS Medicare Beneficiary Status Code. (See also [URSA-CORE] CMS Medicare Beneficiary Status Code)
- Primary Plan Financial Class Description
Diagnosis Fields
- Count CCW Conditions -- The total of both Chronic Conditions and Potentially Disabling Events included in the CMS Chronic Condition Warehouse (CCW) library. (See also [URSA-CORE] CCW Comorbidity Category, [URSA-CORE] Count Potentially Disabling Events, [URSA-CORE] CMS Chronic Condition Warehouse (CCW), [URSA-CORE] Count Chronic Conditions)
- Is CCW System Behavioral Health -- Indicates the patient has one or more of the following CCW conditions; ADHD, Conduct Disorders, and Hyperkinetic Syndrome, Anxiety Disorders, Autism Spectrum Disorder, Bipolar Disorder, Depression, Depressive Disorders, Personality Disorders, PTSD, Schizophrenia, or Schizophrenia and Other Psychotic Disorders.
- Is CCW System Cardiovascular -- Indicates the patient has one or more of the following CCW conditions; Acute Myocardial Infarction (AMI), Atrial Fibrillation, Heart Failure, Hypertension, Ischemic Heart Disease, or Peripheral Vascular Disease (PVD).
- Is CCW System Genitourinary -- Indicates the patient has one or more of the following CCW conditions; Benign Prostatic Hyperplasia or Chronic Kidney Disease (CKD).
- Is CCW System Musculoskeletal -- Indicates the patient has one or more of the following CCW conditions; Hip or Pelvic Fracture, Rheumatoid Arthritis or Osteoarthritis, or Osteoporosis.
- Is CCW System Pulmonary -- Indicates the patient has one or more of the following CCW conditions; Asthma, or Chronic Obstructive Pulmonary Disease (COPD) and Bronchiectasis.
- Is CCW Acquired Hypothyroidism -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Acute Myocardial Infarction -- At least 1 inpatient claim with one or more of the DX codes from the corresponding CCW value set as the first or second diagnosis position in the prior 1 year.
- Is CCW Alzheimers Disease -- At least 1 inpatient, SNF, HHA, HOP, or Carrier claim with one or more of the DX codes from the corresponding CCW value set in the prior 3 years.
- Is CCW Anemia -- At least 1 inpatient, SNF, HHA, HOP, or Carrier claim with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Anxiety Disorders -- At least 1 inpatient OR 2 other nondrug claims of any service type with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW Asthma -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Atrial Fibrillation -- At least 1 inpatient OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set as the first or second diagnosis position in the prior 1 year.
- Is CCW Benign Prostatic Hyperplasia -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year. Exclusion: If any of the qualifying claims also have an ICD-10 DX of D29.1, then it is excluded.
- Is CCW Bipolar Disorder -- At least 1 inpatient OR 2 other nondrug claims of any service type with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW Breast Cancer -- At least 1 inpatient, SNF OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in prior 1 year.
- Is CCW Cataract -- At least 1 HOP or Carrier claim with one or more of the DX codes from the corresponding CCW value set as the principal diagnosis position in the prior 1 year.
- Is CCW CKD -- Indicates that the patient meets the CMS Chronic Condition Warehouse criteria for chronic kidney disease; i.e., 2 or more qualifying outpatient or professional ICD codes in the prior 2 years, or 1 or more non-outpatient institutional claim ICD codes in the prior 2 years.
- Is CCW COPD and Bronchiectasis -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Colorectal Cancer -- At least 1 inpatient, SNF OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Depression -- At least 1 inpatient, SNF, HHA, HOP, or Carrier claim with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Depressive Disorders -- At least 1 inpatient OR 2 other nondrug claims of any service type with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW Diabetes -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW Endometrial Cancer -- At least 1 inpatient, SNF OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Glaucoma -- At least 1 Carrier claim with one or more of the DX codes from the corresponding CCW value set as the principal diagnosis position in the prior 1 year.
- Is CCW Heart Failure -- At least 1 inpatient, HOP, or Carrier claim with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW Ischemic Heart Disease -- At least 1 inpatient, SNF, HHA, HOP, or Carrier claim with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW Hip or Pelvic Fracture -- At least 1 inpatient or SNF claim with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Hyperlipidemia -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Hypertension -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Lung Cancer -- At least 1 inpatient, SNF OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Osteoporosis -- At least 1 inpatient, SNF, HHA OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Prostate Cancer -- At least 1 inpatient, SNF OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
- Is CCW Rheumatoid Arthritis or Osteoarthritis -- At least 2 inpatient, SNF, HHA, HOP, or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW Stroke or Transient Ischemic Attack -- At least 1 inpatient OR 2 HOP or Carrier claims with one or more of the DX codes from the corresponding CCW value set in the prior 1 year.
EXCLUSIONS: If any of the qualifying claims have : 800 <= DX Code <=
804.9, 850 <= DX Code <= 854.1 in any DX position OR DX V57xx as the principal DX Code, then the claim is excluded. - Is CCW Schizophrenia or Other Psychotic Disorders -- At least 1 inpatient OR 2 other nondrug claims of any service type with one ore more of the DX codes from the corresponding CCW value set in the prior 2 years.
- CCW Count Category
- Is CCW Alzheimers Disease and Related Disorders or Senile Dementia -- At least 1 inpatient, SNF, HHA, HOP, or Carrier claim with one or more of the DX codes from the corresponding CCW value set in the prior 3 years.
- Is CCW Obesity -- At least 1 inpatient OR 2 non-inpatient claims with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- Is CCW PVD -- At least 1 inpatient OR 2 non-inpatient claims with one or more of the DX codes from the corresponding CCW value set in the prior 2 years.
- CCW Systems Category
- Count CCW Systems -- The count of distinct systems of the body with one or more active CCW Condition. CCW Systems are as a parent category to the individual CCW Conditions grouping them based primarily on the human body system they impact such as; Behavioral Health, Cancers, Cardiovascular, Cerebrovascular, Endocrine, Genitourinary, Musculoskeletal, and Pulmonary. (See also [URSA-CORE] CMS Chronic Condition Warehouse (CCW))
- Is CCW System Congenital -- Indicates the patient has one or more of the following CCW conditions; Cerebral Palsy, Cystic Fibrosis and Other Metabolic Disorder, Intellectual Disability, Learning Disability, Muscular Dystrophy, or Other Developmental Delays.
- Is CCW System Endocrine/Metabolic -- Indicates the patient has one or more of the following CCW conditions; Diabetes, Acquired Hypothyroidism, Hyperlipidemia, or Obesity.
- Is CCW System Hematologic -- Indicates the patient has one or more of the following CCW conditions; Anemia.
- Is CCW System Neurological -- Indicates the patient has one or more of the following CCW conditions; Alzheimer's Disease, Alzheimer's Disease and Related Disorders or Senile Dementia, Stroke or Transient Ischemic Attack, Epilepsy, Migraine and Chronic Headache, Mobility Impairment, Multiple Sclerosis, or Deafness and Hearing Impairment.
- Is CCW System Oncologic -- Indicates the patient has one or more of the following CCW conditions; Breast Cancer, Colorectal Cancer, Endometrial Cancer, Lung Cancer, Prostate Cancer, or Leukemia.
- Is CCW System Ophthalmologic -- Indicates the patient has one or more of the following CCW conditions; Cataract, Glaucoma, or Blindness and Visual Impairment.
- Is CCW System Other -- Indicates the patient has one or more of the following CCW conditions; Fibromyalgia and Chronic Pain and Fatigue, Pressure or Chronic Ulcer.
Location Fields
- Patient State Abbreviation
- Patient ZIP Code 5-Digit
- Patient County Description
- UW HIP ADI Quintile Category -- The UW HIP Area Deprivation Index National Percentile grouped into 5 levels, each spanning 20 percentile points (ADI 1 is percentile scores from 1 to 20 while ADI 5 is scores from 81 to 100). Higher scores indicate more deprivation, so ADI 1 is the least deprived while ADI 5 is the most deprived. Quintiles are frequently used in health research. They give larger sample sizes per group and are easier to plot and interpret. Quintiles also carry less information and group more dissimilar patients. Quintiles are good for descriptive analyses while the original percentile measure is preferable for predictive modeling. (See also [URSA-CORE] UW HIP Area Deprivation Index National Percentile)
- UW HIP ADI Decile Category
- CDC SVI Overall Quintile Category -- The CDC SVI Overall National Percentile grouped into 5 levels, each spanning 20 percentile points (the first quintile is percentile scores from 1 to 20 while the fifth is scores from 81 to 100). Higher scores indicate more vulnerability, so the first quintile is the least vulnerable while the fifth is the most vulnerable. Quintiles are frequently used in health research. They give larger sample sizes per group and are easier to plot and interpret. Quintiles also carry less information and group more dissimilar patients. Quintiles are good for descriptive analyses while the original percentile measure is preferable for predictive modeling.
- CDC SVI Socioeconomic Quintile Category -- The CDC SVI Socioeconomic Theme National Percentile grouped into 5 levels, each spanning 20 percentile points (the first quintile is percentile scores from 1 to 20 while the fifth is scores from 81 to 100). Higher scores indicate more vulnerability, so the first quintile is the least vulnerable while the fifth is the most vulnerable. (See also [URSA-CORE] CDC SVI Socioeconomic Theme National Percentile )
- CDC SVI Household / Disability Quintile Category -- The CDC SVI Household/Disability Theme National Percentile grouped into 5 levels, each spanning 20 percentile points (the first quintile is percentile scores from 1 to 20 while the fifth is scores from 81 to 100). Higher scores indicate more vulnerability, so the first quintile is the least vulnerable while the fifth is the most vulnerable. (See also [URSA-CORE] CDC SVI Household / Disability Theme National Percentile )
- CDC SVI Minority / Language Quintile Category -- The CDC SVI Minority/Language Theme National Percentile grouped into 5 levels, each spanning 20 percentile points (the first quintile is percentile scores from 1 to 20 while the fifth is scores from 81 to 100). Higher scores indicate more vulnerability, so the first quintile is the least vulnerable while the fifth is the most vulnerable. (See also [URSA-CORE] CDC SVI Minority / Language Theme National Percentile)
- CDC SVI Housing / Transportation Quintile Category -- The CDC SVI Housing/Transportation Theme National Percentile grouped into 5 levels, each spanning 20 percentile points (the first quintile is percentile scores from 1 to 20 while the fifth is scores from 81 to 100). Higher scores indicate more vulnerability, so the first quintile is the least vulnerable while the fifth is the most vulnerable. (See also [URSA-CORE] CDC SVI Housing / Transportation Theme National Percentile)
Metadata Fields
- Is Medical Claim Data Coverage -- Indicates data coverage for medical claims (i.e., institutional and professional claims) from at least one data source for the patient and time period specified on the record. (See also [URSA-CORE] Data Coverage)
- Random Integer 1 to 1000
Foreign Keys
- primary_plan_id → ursa.no_ursa_core_struct_005.plan_id
- primary_payor_id → ursa.no_ursa_core_struct_004.payor_id
- pat_id → ursa.no_ursa_core_pat_001.pat_id
- primary_plan_attributee_prov_id → ursa.no_ursa_core_prov_001.prov_id
- empirical_attributee_primary_care_prov_group_prov_id → ursa.no_ursa_core_prov_001.prov_id
- empirical_attributee_primary_care_individual_prov_id → ursa.no_ursa_core_prov_001.prov_id
- empirical_attributee_individual_nephrology_prov_id → ursa.no_ursa_core_prov_001.prov_id
- empirical_attributee_nephrology_group_prov_id → ursa.no_ursa_core_prov_001.prov_id