Q (sonnet): In the MSK-CHORD study, is it possible to see which patients received radiation therapy?

▶ list_guides
{}

▶ get_study_guide
{
 "study_id": "msk_chord_2024"
}

◀ result
{"result":[{"uri":"cbioportal://mutation-frequency-guide","description":"Comprehensive guide for calculating gene mutation frequencies with gene-specific profiling denominators"},{"uri":"cbioportal://clinical-data-guide","description":"Guide for querying clinical data including patient vs sample level considerations"},{"uri":"cbioportal://sample-filtering-guide","description":"Guide for filtering samples and studies in cBioPortal queries"},{"uri":"cbioportal://common-pitfalls","description":"Guide to avoid common mistakes when querying cBioPortal data. If you already know which numbered pitfall applies, fetch just that section via read_guide(\"cbioportal://common-pitfalls#<number>\") (e.g. #16) instead of the full guide"},{"uri":"cbioportal://treatment-guide","description":"Guide for querying treatment/clinical event data including drug agents, timelines, and linking to genomic data"},{"uri":"cbioportal://faq-guide","description":"General cBioPortal FAQ: history, how to cite, data types, reference genome, abbreviations, GISTIC thresholds, API access"},{"uri":"cbioportal://statistical-tests-guide","description":"Statistical test selection guide — decision matrix for choosing Fisher's exact, Wilcoxon, chi-squared, t-test, ANOVA, etc. based on data type and group count"},{"uri":"cbioportal://gene-expression-guide","description":"Gene expression / copy-number / methylation analysis. Covers genetic_alteration_derived, profile_type discovery, and the gene_pair_coexpression view for Spearman correlation between two genes"},{"uri":"cbioportal://external-resources-guide","description":"Guide for finding external linked resources such as imaging, pathology, Minerva, HTAN, or other resource_* table links before declaring data unavailable"},{"uri":"cbioportal://gene-resolution-guide","description":"Guide for resolving ambiguous gene symbols, aliases, gene families, and shorthand such as CD3 before querying expression or alteration data"},{"uri":"cbioportal://study-resolution-guide","description":"Guide for resolving requested studies, avoiding silent substitute cohorts, and redirecting to known external cBioPortal instances when data is not in this deployment"},{"uri":"cbioportal://germline-guide","description":"Guide for querying germline variant data — storage columns, study discovery, query patterns, and somatic vs germline considerations"},{"uri":"cbioportal://study-guide/{study_id}","description":"Dynamic study-specific guide - use get_study_guide(study_id) tool to generate"}]}

◀ result
# MSK-CHORD (MSK, Nature 2024)

**Study ID:** `msk_chord_2024`

## Overview
Targeted sequencing via MSK-IMPACT panels. Clinical annotations include some derived from natural language processing (denoted NLP).

**Exactly five cancer types** (`CANCER_TYPE`, patients): Non-Small Cell Lung Cancer 7,809, Colorectal Cancer 5,543, Breast Cancer 5,368, Prostate Cancer 3,211, Pancreatic Cancer 3,109. There is **no melanoma** or any other cancer type; say so up front if asked, instead of substituting another type.

**No therapy-response variable.** There is no RECIST, objective response, or best-response attribute or event. For treatment-outcome questions (e.g. immunotherapy response), say this first; the only proxies are `OS_MONTHS`/`OS_STATUS`, or NLP radiology progression events (`Diagnosis` events with `SUBTYPE = 'Progression'`, key `PROGRESSION` = Y/N/Indeterminate), in patients with `Treatment` events of the relevant `SUBTYPE` (e.g. `Immuno`: 3,341 patients). Hand off the comparison to cBioPortal group comparison / survival.

**Nearly one sample per patient: 24,950 patients / 25,040 samples.** Only 90 patients have more than one sample, and all 90 have samples from two different cancer types (second primaries); only 26 have both a `Primary` and a `Metastasis` sample. There is no meaningful same-patient (paired) primary-vs-metastasis cohort. For "same patient" / paired questions, say this up front, then offer the **unpaired** comparison of all `Primary` vs `Metastasis` samples (`SAMPLE_TYPE`), labelled as unpaired.
```sql
SELECT countIf(n > 1) AS multi_sample_patients,         -- 90
       countIf(has_p AND has_m) AS primary_and_met      -- 26
FROM (SELECT patient_unique_id, count() AS n,
             has(groupArray(attribute_value), 'Primary') AS has_p,
             has(groupArray(attribute_value), 'Metastasis') AS has_m
      FROM clinical_data_derived
      WHERE cancer_study_identifier = 'msk_chord_2024' AND attribute_name = 'SAMPLE_TYPE'
      GROUP BY patient_unique_id);
```

## Gene Panels
This study uses multiple MSK-IMPACT panel versions:
- **IMPACT341**: Earlier version, 341 genes
- **IMPACT410**: 410 genes
- **IMPACT468**: 468 genes  
- **IMPACT505**: Latest version, 505 genes

**Important:** Different samples may have different gene coverage. Always use gene-specific denominators when calculating mutation frequencies.

## Clinical Attributes - Semantic Guide

### Cancer Classification
| Attribute | Description | Values |
|-----------|-------------|--------|
| `CANCER_TYPE` | Broad cancer category | e.g., "Non-Small Cell Lung Cancer", "Breast Cancer" |
| `CANCER_TYPE_DETAILED` | Specific subtype | e.g., "Lung Adenocarcinoma", "Invasive Ductal Carcinoma" |
| `ONCOTREE_CODE` | OncoTree classification code | Standardized cancer type codes |

### Sample Information
| Attribute | Description | Values |
|-----------|-------------|--------|
| `SAMPLE_TYPE` | Sample origin | Primary, Metastasis, Local Recurrence, Unknown |
| `SAMPLE_CLASS` | Sample … (5439 more chars)

▶ read_guide
{
 "uri": "cbioportal://treatment-guide"
}

◀ result
# Treatment Data Query Guide

## Overview

Treatment data in cBioPortal is stored in **clinical event tables**, separate from clinical attributes. This allows for timeline-based treatment records with start/stop dates.

## Start Here: Treatment Views

For "most common treatments / agents / regimens in study X", use the parameterized views (documented in `cbioportal://clinical-data-guide`, Study-View Chart Counts):

```sql
-- Patients per agent (the portal's Treatment chart), with type/subtype arrays
SELECT * FROM treatment_counts_in_study(study='msk_chord_2024') ORDER BY patients DESC LIMIT 20;

-- Same-day agent combinations (investigational, prior-medication and radiation events excluded)
SELECT * FROM treatment_regimens_in_study(study='msk_chord_2024') ORDER BY patients DESC LIMIT 20;
```

Write raw event queries (below) only for subgroups, timelines or keys the views do not expose.

## Key Tables

| Table | Description |
|-------|-------------|
| `clinical_event` | Event records with patient_id, event_type, start_date, stop_date |
| `clinical_event_data` | Key-value pairs linked to each clinical_event_id |

## Schema

```
clinical_event
├── clinical_event_id (PK)
├── patient_id (FK → patient.internal_id)
├── event_type (Treatment, TREATMENT, Diagnosis, SURGERY, etc.)
├── start_date (days from diagnosis)
└── stop_date (days from diagnosis)

clinical_event_data
├── clinical_event_id (FK)
├── key (AGENT, SUBTYPE, etc.)
└── value
```

## Event Types

Not all studies have all event types. Common ones include:

| Event Type | Description |
|------------|-------------|
| `Treatment` / `TREATMENT` | Drug/therapy administration |
| `SURGERY` | Surgical procedures |
| `Diagnosis` | Diagnosis events |
| `LAB_TEST` | Laboratory results |
| `Sequencing` | Sequencing events |
| `Sample acquisition` | Sample collection |
| `PATHOLOGY` / `Pathology` | Pathology reports |

## Basic Treatment Queries

### List Available Event Types in a Study

```sql
SELECT DISTINCT ce.event_type, COUNT(*) as event_count
FROM clinical_event ce
JOIN patient p ON ce.patient_id = p.internal_id
JOIN cancer_study cs ON p.cancer_study_id = cs.cancer_study_id
WHERE cs.cancer_study_identifier = 'your_study_id'
GROUP BY ce.event_type
ORDER BY event_count DESC;
```

### List Treatment Data Keys in a Study

```sql
SELECT DISTINCT ced.key, COUNT(*) as cnt
FROM clinical_event ce
JOIN clinical_event_data ced ON ce.clinical_event_id = ced.clinical_event_id
JOIN patient p ON ce.patient_id = p.internal_id
JOIN cancer_study cs ON p.cancer_study_id = cs.cancer_study_id
WHERE cs.cancer_study_identifier = 'your_study_id'
  AND ce.event_type IN ('Treatment', 'TREATMENT')
GROUP BY ced.key
ORDER BY cnt DESC;
```

### Get Most Common Treatment Agents

```sql
SELECT 
    ced.value as agent,
    COUNT(DISTINCT ce.patient_id) as patient_count
FROM clinical_event ce
JOIN clinical_event_data ced ON ce.clinical_event_id = ced.clinical_event_id
JOIN patient p ON ce.patient_id = p.internal_id
JOIN cancer_stud … (6220 more chars)

▶ clickhouse_run_select_query
{
 "query": "SELECT 
    agent.value as agent,
    COUNT(DISTINCT ce.patient_id) as patients
FROM clinical_event ce
JOIN clinical_event_data agent ON ce.clinical_event_id = agent.clinical_event_id AND agent.key = 'AGENT'
JOIN clinical_event_data subtype ON ce.clinical_event_id = subtype.clinical_event_id AND subtype.key = 'SUBTYPE'
JOIN patient p ON ce.patient_id = p.internal_id
JOIN cancer_study cs ON p.cancer_study_id = cs.cancer_study_id
WHERE cs.cancer_study_identifier = 'msk_chord_2024'
  AND ce.event_type IN ('Treatment', 'TREATMENT')
  AND subtype.value = 'Radiation Therapy'
GROUP BY agent.value
ORDER BY patients DESC
LIMIT 20"
}

◀ result
{"rows":[]}

▶ clickhouse_run_select_query
{
 "query": "SELECT COUNT(DISTINCT ce.patient_id) as patients_with_radiation
FROM clinical_event ce
JOIN clinical_event_data subtype ON ce.clinical_event_id = subtype.clinical_event_id AND subtype.key = 'SUBTYPE'
JOIN patient p ON ce.patient_id = p.internal_id
JOIN cancer_study cs ON p.cancer_study_id = cs.cancer_study_id
WHERE cs.cancer_study_identifier = 'msk_chord_2024'
  AND ce.event_type IN ('Treatment', 'TREATMENT')
  AND subtype.value = 'Radiation Therapy'"
}

◀ result
{"rows":[{"patients_with_radiation":12318}]}

▶ clickhouse_run_select_query
{
 "query": "SELECT ced.key, COUNT(*) as cnt
FROM clinical_event ce
JOIN clinical_event_data ced ON ce.clinical_event_id = ced.clinical_event_id
JOIN clinical_event_data subtype ON ce.clinical_event_id = subtype.clinical_event_id AND subtype.key = 'SUBTYPE'
JOIN patient p ON ce.patient_id = p.internal_id
JOIN cancer_study cs ON p.cancer_study_id = cs.cancer_study_id
WHERE cs.cancer_study_identifier = 'msk_chord_2024'
  AND ce.event_type IN ('Treatment', 'TREATMENT')
  AND subtype.value = 'Radiation Therapy'
GROUP BY ced.key
ORDER BY cnt DESC"
}

▶ clickhouse_run_select_query
{
 "query": "SELECT p.stable_id as patient_id, ce.start_date, ce.stop_date
FROM clinical_event ce
JOIN clinical_event_data subtype ON ce.clinical_event_id = subtype.clinical_event_id AND subtype.key = 'SUBTYPE'
JOIN patient p ON ce.patient_id = p.internal_id
JOIN cancer_study cs ON p.cancer_study_id = cs.cancer_study_id
WHERE cs.cancer_study_identifier = 'msk_chord_2024'
  AND ce.event_type IN ('Treatment', 'TREATMENT')
  AND subtype.value = 'Radiation Therapy'
LIMIT 10"
}

◀ result
{"rows":[{"ced.key":"SUBTYPE","cnt":29158}]}

◀ result
{"rows":[{"patient_id":"P-0023588","start_date":408},{"patient_id":"P-0025225","start_date":180},{"patient_id":"P-0025225","start_date":158},{"patient_id":"P-0027079","start_date":1605},{"patient_id":"P-0027079","start_date":1106},{"patient_id":"P-0027079","start_date":1604},{"patient_id":"P-0027079","start_date":1981},{"patient_id":"P-0027079","start_date":1742},{"patient_id":"P-0027079","start_date":2057},{"patient_id":"P-0027079","start_date":1910}]}

▶ resolve_and_route
{
 "studyIds": [
  "msk_chord_2024"
 ]
}

◀ result
{"success":true,"message":"Found 1 study. Use the metadata to call the appropriate navigation tool(s).","data":{"totalCount":1,"studiesWithMetadata":[{"studyId":"msk_chord_2024","name":"MSK-CHORD (MSK, Nature 2024)","sampleCount":25040,"studyViewUrl":"https://www.cbioportal.org/study?id=msk_chord_2024","metadata":{"clinicalAttributeIds":["ADRENAL_GLANDS","BONE","CANCER_TYPE","CANCER_TYPE_DETAILED","CLINICAL_GROUP","CLINICAL_SUMMARY","CNS_BRAIN","CURRENT_AGE_DEID","DIAGNOSIS_DESCRIPTION","ETHNICITY","FRACTION_GENOME_ALTERED","GENDER","GENE_PANEL","GLEASON_FIRST_REPORTED","GLEASON_HIGHEST_REPORTED","GLEASON_SAMPLE_LEVEL","HER2","HISTORY_OF_PDL1","HR","ICD_O_HISTOLOGY_DESCRIPTION","INTRA_ABDOMINAL","LIVER","LUNG","LYMPH_NODES","METASTATIC_SITE","MSI_COMMENT","MSI_SCORE","MSI_TYPE","MUTATION_COUNT","NUM_ICDO_DX","ONCOTREE_CODE","OS_MONTHS","OS_STATUS","OTHER","PATHOLOGICAL_GROUP","PDL1_POSITIVE","PLEURA","PRIMARY_SITE","PRIOR_MED_TO_MSK","RACE","REPRODUCTIVE_ORGANS","SAMPLE_CLASS","SAMPLE_COUNT","SAMPLE_COVERAGE","SAMPLE_TYPE","SMOKING_PREDICTIONS_3_CLASSES","SOMATIC_STATUS","STAGE_HIGHEST_RECORDED","TMB_NONSYNONYMOUS","TUMOR_PURITY"],"molecularProfileIds":["msk_chord_2024_cna","msk_chord_2024_mutations","msk_chord_2024_structural_variants"],"availableComparisonTabs":["overlap","clinical","survival","alterations","mutations"]}}]}}

▶ navigate_to_study_view
{
 "studyIds": [
  "msk_chord_2024"
 ]
}

◀ result
{"success":true,"message":"Navigating to https://www.cbioportal.org/study/summary?id=msk_chord_2024","url":"https://www.cbioportal.org/study/summary?id=msk_chord_2024","data":{"studyIds":["msk_chord_2024"],"studies":[{"studyId":"msk_chord_2024","name":"MSK-CHORD (MSK, Nature 2024)","sampleCount":25040}],"tab":"summary","hasFilters":false,"hasPlotsConfig":false,"pageDescription":"Overview of all study data displayed as interactive charts summarizing available clinical and genomic data. Click within a chart to filter. Additional charts may be available in the Charts menu."}}

═ answer (success)
## Yes — radiation therapy data is available in MSK-CHORD

MSK-CHORD includes detailed treatment event data (not a simple clinical attribute, but timeline-based clinical events). Radiation therapy is recorded as a treatment `SUBTYPE = 'Radiation Therapy'` in the `clinical_event_derived` table, with individual events including start/stop dates (in days from diagnosis).

**Key finding:**
- **12,318 patients** have at least one recorded Radiation Therapy event (29,158 total radiation events across the cohort — many patients received multiple courses/fractions recorded as separate events).

**Notes:**
- Unlike drug treatments (e.g., chemo, immunotherapy), radiation events in this dataset do **not** carry an `AGENT` value — only `SUBTYPE` — so you can identify *who* received radiation and *when* (via `start_date`/`stop_date`), but not a specific radiation modality/dose from this field alone.
- As with all MSK-CHORD treatment data, we cannot distinguish "no radiation" from "not recorded" — so this should be read as "at least 12,318 patients have a documented radiation event," not as a percentage of the full cohort.
- Patient-level identifiers (e.g., `P-0023588`, `P-0025225`, `P-0027079`, etc.) are directly queryable if you need the specific patient list.

**Explore interactively:**

[MSK-CHORD Study View](https://www.cbioportal.org/study/summary?id=msk_chord_2024)

Overview of all study data displayed as interactive charts summarizing available clinical and genomic data. In the Study View, use the **Charts** menu to add the **Treatment** chart (grouped by SUBTYPE/AGENT) — filtering to "Radiation Therapy" there will let you select and browse that patient subset directly (e.g., via "View selected cases" into Patient View for individual timelines).