Handbook contents
Reference

Dataset and model directory

Source families, folders and representative outputs. Use this directory to find candidates, then read each model's description, SQL and tests.

The data lesson explains the source families and identifiers. Finding models explains how to judge whether a candidate fits your question. Names below are examples, not a complete or automatically updated catalogue.

Common outputs

What the project createsModels to recogniseWhat they provide
Person spines and descriptive dimensionsdim_person_demographics, dim_person_demographics_historical, dim_person_pseudoCurrent and historical OLIDS demographics, registration, geography, and the bridge used where cross-dataset linkage is available
Clinical populationsfct_person_*_registerReusable definitions of diabetes, asthma, COPD, CKD and other clinical registers, with the evidence behind membership
Condition historiesfct_person_condition_episodesDiagnosis-based episodes with start and end dates, including repeated cycles where a condition can resolve and recur
Latest clinical statesint_*_latestOne selected HbA1c, blood pressure, eGFR, smoking status or other qualifying result per person
Activity factsfct_person_sus_*_recent, fct_person_gp_recentRecent urgent care, admitted care, outpatient and GP activity at a documented person grain
Waiting-list facts and summariesint_wl_current, fct_person_wl_current_count_*, fct_provider_wl_current_count_totalThe current open-pathway population and supported counts by person, provider and treatment function
Wide analytical martsperson_month_analysis_base, obt_person_activity, fct_person_resource_indexPerson-month population-health history and other related reporting facts composed at convenient analytical grains
Data-quality outputsdq_*Records that fail a documented quality expectation and need investigation rather than ordinary analysis
Products for named usesmodels/published/Tables and views composed for specific dashboards, reports, extracts and operational processes

OLIDS model folders

FolderWhat it holdsExample
modelling/olids/observationsClinical measurements as _all/_latest pairsint_hba1c_latest
modelling/olids/medicationsDrug-class order histories and polypharmacy int_statin_medications_all
modelling/olids/diagnosesDiagnosis and resolution evidence per condition int_diabetes_diagnoses_all
modelling/olids/person_attributesEthnicity, smoking, housebound, registrationsint_ethnicity_all
modelling/olids/risk_stratificationFrailty and case-management scoresint_efi2_scores
modelling/olids/programme/*Programme logic composing the shared blocks (including immunisations, screening, LTC case-finding, SMI…)programme/flu
reporting/olids/person_demographicsThe person spine, current and historicaldim_person_demographics
reporting/olids/person_statusCare home, housebound, carer, opt-out and other statusesdim_person_care_home
reporting/olids/disease_registersQOF registers, each with a pit_ point-in-time twin, further registers, condition episodesfct_person_diabetes_register
reporting/olids/measuresCare-process and control measuresfct_person_bp_control
reporting/olids/data_qualityRecords failing a documented quality expectationdq_hba1c_issues
reporting/olids/person_analyticsThe person-month analysis martperson_month_analysis_base

OLIDS search patterns

What you needSearch forExample
Every recorded value of a measurementint_*_allint_hba1c_all
The latest qualifying value per personint_*_latestint_egfr_latest
Medication orders for a drug classint_*_medications_allint_sglt2_medications_all
Diagnosis evidence for a conditionint_*_diagnoses_allint_ckd_diagnoses_all
Current register membershipfct_person_*_registerfct_person_diabetes_register
A register as at a reference datepit_*_registerpit_diabetes_register
A person attribute or statusdim_person_*dim_person_care_home
Records failing a quality expectationdq_*dq_hba1c_issues

Commissioning source folders

FolderWhat we use it forExamples downstream
susAdmitted care, outpatients and urgent and emergency carefct_person_sus_apc_recent, fct_person_sus_op_recent, fct_person_sus_uec_recent
wlReferral-to-treatment waiting-list snapshotsint_wl_current, fct_provider_wl_current_count_total
epdPrimary-care prescribing in the English Prescribing DatasetPractice- and organisation-level prescribing analysis
csdsCommunity services referrals, contacts and activityCommunity-service pathway and activity models
mhsdsMental-health referrals, contacts, spells and ward staysMental-health pathway and activity models
slamProvider contract-monitoring activity and actual costs from cumulative submissionsint_cost_index_slam_activity_monthly, fct_person_resource_index
ersNHS e-Referral Service referrals and actionsReferral models linked through UBRN and person keys
asc_cldAdult social care client-level recordsAdult social care analysis

Commissioning model folders

FolderWhat it holdsExamples
modelling/commissioning/encountersSUS, CSDS and MHSDS activity standardised into encounters and spells — including merging and imputing admitted-patient spellsint_sus_apc_merged_spells
int_csds_encounters
int_mhsds_spell_encounters
modelling/commissioning/demographicsA person view assembled from PDS and other national datasetsint_person_pmi_combined
int_person_pds_demographics
modelling/commissioning/activitiesNamed activity groupings defined onceint_comm_ambulatory_sensitive_nel
int_comm_cancer
int_comm_maternity
modelling/commissioning/cost_indexMonthly costed activity per person across the activity feedsint_person_cost_index_actual_monthly
int_cost_index_csds_activity_monthly
int_cost_index_mhsds_activity_monthly
reporting/commissioning/person_levelPerson-grain recent-activity facts and current waiting-list countsfct_person_sus_apc_recent
fct_person_gp_recent
fct_person_wl_current_count_total
reporting/commissioning/eventsEvent-grain wide tables for admitted, outpatient and emergency careobt_encounter_apc
obt_encounter_uec
obt_appointment_op
reporting/commissioning/person_historyMonthly person-level activity historyfct_person_activity_by_month
reporting/commissioning/resource_indexActual versus expected resource use, with area, deprivation and borough breakdownsfct_person_resource_index
fct_resource_index_by_area
fct_resource_index_by_imd_quintile