Skip to content

Data Dictionary Release Notes

Version Date
v.3.3.0 September 30, 2024
v.3.1.0 May 30, 2024
v.3.0.0 October 30, 2023
v.2.6.6 June 16, 2023
v.2.6.0 February 2, 2023
v.2.5.0 July 8, 2022
v.2.4.1 August 23, 2021
v.2.4.0 June 21, 2021
v.2.3.0 January 5, 2021
v.2.2.0 July 2, 2020
v.2.1.0 March 10, 2020
v.2.0.0 January 30, 2020
v.1.18.1 November 6, 2019
v.1.18 July 31, 2019
v.1.17 June 5, 2019
v.1.16 April 17, 2019
v.1.15 December 18, 2018
v.1.14 September 27, 2018
v1.13 May 21, 2018
v1.12.1 April 26, 2018
v1.12 April 23, 2018
v1.11 January 20, 2018
v1.10.0 August 22, 2017
v1.7.1 March 16, 2017
v1.3.1 September 7, 2016

v3.3.0

  • GDC Product: GDC Data Dictionary
  • Release Date: September 30, 2024

New Features and Changes

  • Altered demographic Entity
    • New property: population_group
  • Altered diagnosis Entity
    • New property: ajcc_serum_tumor_markers
    • Changes made to method_of_diagnosis
      • New permissible value: Orchiectomy
    • Changes made to primary_diagnosis
      • New permissible value: Adenocarcinoma in tubulovillous adenoma
      • New permissible value: Myxofibrosarcoma
      • New deprecated value: Adenocarcinoma in tubolovillous adenoma
    • Changes made to sites_of_involvement
      • New permissible value: Breast, Left Lower Inner
      • New permissible value: Breast, Left Lower Outer
      • New permissible value: Breast, Left Upper Inner
      • New permissible value: Breast, Left Upper Outer
      • New permissible value: Breast, Right Lower Inner
      • New permissible value: Breast, Right Lower Outer
      • New permissible value: Breast, Right Upper Inner
      • New permissible value: Breast, Right Upper Outer
      • New permissible value: Eye, Choroid
      • New permissible value: Eye, Ciliary Body
      • New permissible value: Eye, Iris
      • New permissible value: Hilar Fat
      • New permissible value: Rete Testis
      • New permissible value: Scrotum
      • New permissible value: Skin, Extremities
      • New permissible value: Skin, Groin
      • New permissible value: Skin, Head and Neck
      • New permissible value: Skin, Trunk
      • New permissible value: Spermatic Cord
      • New permissible value: Tunica Albuginea
      • New permissible value: Tunica Vaginalis
  • Altered follow_up Entity
    • New property: histologic_progression
    • Changes made to evidence_of_progression_type
      • New permissible value: Biopsy with Histologic Confirmation
      • New permissible value: Physical Examination
      • New permissible value: Positive Biomarker(s)
    • Changes made to imaging_anatomic_site
      • New permissible value: Cervix Uteri
    • Changes made to imaging_findings
      • New permissible value: Bladder Involvement
      • New permissible value: Extra-Pelvic Metastatic Disease
      • New permissible value: Paraaortic Lymph Node Involvement
      • New permissible value: Parametrium Involvement
      • New permissible value: Pelvic Lymph Node Involvement
      • New permissible value: Supraclavicular Lymph Node Involvement
    • Changes made to timepoint_category
      • New permissible value: After Chemotherapy
      • New permissible value: After Study Enrollment
      • New permissible value: End of Consolidation Therapy
      • New permissible value: End of Treatment Course
      • New permissible value: End of Treatment Course 1
      • New permissible value: End of Treatment Course 2
      • New permissible value: First Complete Response
      • New permissible value: First Treatment
      • New permissible value: Post Initial Treatment
      • New permissible value: Prior to Chemotherapy
      • New permissible value: Prior to Procurement
      • New permissible value: Prior to Study Enrollment
      • New permissible value: Prior to Study Registration
      • New permissible value: Progression
      • New permissible value: Recurrence
      • New permissible value: Sample Procurement
  • Altered molecular_test Entity
    • Changes made to hpv_strain
      • New permissible value: HPV63
      • New permissible value: HPV70
    • Changes made to test_value_range
      • New permissible value: 1-4%
      • New permissible value: 5-9%
    • Changes made to timepoint_category
      • New permissible value: Adjuvant Therapy
      • New permissible value: Adolescence
      • New permissible value: Adulthood
      • New permissible value: After Chemotherapy
      • New permissible value: After Study Enrollment
      • New permissible value: Childhood
      • New permissible value: End of Treatment Course
      • New permissible value: First Complete Response
      • New permissible value: First Treatment
      • New permissible value: Follow-up
      • New permissible value: Last Contact
      • New permissible value: Post Adjuvant Therapy
      • New permissible value: Post Hormone Therapy
      • New permissible value: Post Initial Treatment
      • New permissible value: Post Secondary Therapy
      • New permissible value: Postoperative
      • New permissible value: Prior to Adjuvant Therapy
      • New permissible value: Prior to Chemotherapy
      • New permissible value: Prior to Diagnosis
      • New permissible value: Prior to Procurement
      • New permissible value: Prior to Study Enrollment
      • New permissible value: Prior to Study Registration
      • New permissible value: Progression
      • New permissible value: Recurrence
      • New permissible value: Recurrence/Progression
      • New permissible value: Within 2 Months After Completion of First-Course Treatment
      • New permissible value: Within 3 Months of Surgery
      • New permissible value: Other
  • Altered other_clinical_attribute Entity
    • New property: undescended_testis_corrected_age_range
    • Changes made to comorbidities
      • New permissible value: Adenomyosis
      • New permissible value: Adenosis (Atypical Adenomatous Hyperplasia)
      • New permissible value: Alcoholic Liver Disease
      • New permissible value: Allergy, Animal, NOS
      • New permissible value: Allergy, Ant
      • New permissible value: Allergy, Bee
      • New permissible value: Allergy, Cat
      • New permissible value: Allergy, Dairy or Lactose
      • New permissible value: Allergy, Dog
      • New permissible value: Allergy, Eggs
      • New permissible value: Allergy, Food, NOS
      • New permissible value: Allergy, Fruit
      • New permissible value: Allergy, Meat
      • New permissible value: Allergy, Mold or Dust
      • New permissible value: Allergy, Nuts
      • New permissible value: Allergy, Processed Foods
      • New permissible value: Allergy, Seafood
      • New permissible value: Allergy, Wasp
      • New permissible value: Alpha-1 Antitrypsin Deficiency
      • New permissible value: Altered Mental Status
      • New permissible value: Androgen Excess
      • New permissible value: Autoimmune Atrophic Chronic Gastritis
      • New permissible value: BAP1 Tumor Predisposition Syndrome
      • New permissible value: Benign Prostatic Hyperplasia
      • New permissible value: Birt-Hogg-Dube Syndrome
      • New permissible value: BK Virus
      • New permissible value: Chronic Kidney Disease
      • New permissible value: Colonization, Bacterial
      • New permissible value: Colonization, Fungal
      • New permissible value: Common Variable Immune Deficiency (CVID)
      • New permissible value: Cortisol Excess
      • New permissible value: Cowden Syndrome
      • New permissible value: Cyst(s)
      • New permissible value: Dementia
      • New permissible value: Diabetes, NOS
      • New permissible value: Diabetes, Type I
      • New permissible value: Diverticulosis
      • New permissible value: Endometriosis
      • New permissible value: Endosalpingiosis
      • New permissible value: Epithelial Dysplasia
      • New permissible value: Epithelial Hyperplasia
      • New permissible value: Estrogen Excess
      • New permissible value: Gastric Polyp(s)
      • New permissible value: Gilbert's Syndrome
      • New permissible value: Glomerular Disease
      • New permissible value: Hay Fever
      • New permissible value: Helicobacter pylori-Associated Gastritis
      • New permissible value: Hematologic Disorder, NOS
      • New permissible value: Hemochromatosis
      • New permissible value: Hepatic Encephalopathy
      • New permissible value: Hepatitis, NOS
      • New permissible value: Hereditary Breast Cancer
      • New permissible value: Hereditary Hemorrhagic Telangiectasia
      • New permissible value: Hereditary Kidney Oncocytoma
      • New permissible value: Hereditary Leiomyomatosis and Renal Cell Carcinoma
      • New permissible value: Hereditary Ovarian Cancer
      • New permissible value: Hereditary Papillary Renal Cell Carcinoma
      • New permissible value: Hereditary Prostate Cancer
      • New permissible value: Hereditary Renal Cell Carcinoma
      • New permissible value: High Grade Dysplasia
      • New permissible value: High-grade Prostatic Intraepithelial Neoplasia (PIN)
      • New permissible value: Human Herpesvirus-6 (HHV-6)
      • New permissible value: Human Herpesvirus-8 (HHV-8)
      • New permissible value: Inflammation
      • New permissible value: Inflammation, Hyperkeratosis
      • New permissible value: Inherited Genetic Syndrome, NOS
      • New permissible value: Intestinal Metaplasia
      • New permissible value: Low Grade Dysplasia
      • New permissible value: Mineralcorticoids Excess
      • New permissible value: Motor / Movement Change
      • New permissible value: Myelodysplastic Syndrome
      • New permissible value: Neurocystericerosis
      • New permissible value: Nevus of Ota
      • New permissible value: Nodular Prostatic Hyperplasia
      • New permissible value: Nonalcoholic Fatty Liver Disease
      • New permissible value: Parasitic Disease of Biliary Tract
      • New permissible value: Parkinson's Disease
      • New permissible value: Recurrent Pyogenic Cholangitis
      • New permissible value: Rubella
      • New permissible value: Scarlet Fever
      • New permissible value: Sensory Changes
      • New permissible value: Serous Tubal Intraepithelial Carcinoma (STIC)
      • New permissible value: Sialadenitis
      • New permissible value: Skin Rash
      • New permissible value: Squamous Metaplasia
      • New permissible value: Succinate Dehydrogenase-Deficient Renal Cell Carcinoma
      • New permissible value: Thyroid Nodular Hyperplasia
      • New permissible value: Tobacco, NOS
      • New permissible value: Tobacco, Smokeless
      • New permissible value: Tobacco, Smoking
      • New permissible value: Tuberous Sclerosis
      • New permissible value: Tubulointerstitial Disease
      • New permissible value: Tumor-Associated Lymphoid Proliferation
      • New permissible value: Undescended Testis
      • New permissible value: Vascular Disease
      • New permissible value: Vision Changes
      • New permissible value: Von Hippel-Lindau Syndrome
      • New deprecated value: Alpha-1 Antitrypsin
      • New deprecated value: Diabetes
      • New deprecated value: Gastroesophageal Reflux Disease
      • New deprecated value: Hepatitis
      • New deprecated value: Kidney Disease
      • New deprecated value: Smoking
    • Changes made to number_of_pregnancies
      • New permissible value: 0
    • Changes made to risk_factors
      • New permissible value: Adenocarcinoma
      • New permissible value: Adenomatous Polyposis Coli
      • New permissible value: Allergies
      • New permissible value: Arthritis
      • New permissible value: Atrial Fibrillation
      • New permissible value: Basal Cell Carcinoma
      • New permissible value: Biliary Disorder
      • New permissible value: Bronchitis
      • New permissible value: Calcium Channel Blockers
      • New permissible value: Cataracts
      • New permissible value: Celiac Disease
      • New permissible value: Cerebrovascular Disease
      • New permissible value: Chronic Fatigue Syndrome
      • New permissible value: Clonal Hematopoiesis
      • New permissible value: CNS Infection
      • New permissible value: Common Variable Immunodeficiency
      • New permissible value: Congestive Heart Failure (CHF)
      • New permissible value: Connective Tissue Disorder
      • New permissible value: COPD
      • New permissible value: Coronary Artery Disease
      • New permissible value: Crohn's Disease
      • New permissible value: Cryptogenic Organizing Pneumonia
      • New permissible value: Dyslipidemia
      • New permissible value: GERD
      • New permissible value: Glaucoma
      • New permissible value: Glycogen Storage Disease
      • New permissible value: Gout
      • New permissible value: Heart Disease
      • New permissible value: Hepatitis, Chronic
      • New permissible value: Hereditary Non-Polyposis Colon Cancer
      • New permissible value: Herpes
      • New permissible value: Herpes Simplex Virus
      • New permissible value: High Grade Liver Dysplastic Nodule
      • New permissible value: HIV/AIDS
      • New permissible value: Hyperglycemia
      • New permissible value: Hyperlipidemia
      • New permissible value: Inflammatory Bowel Disease
      • New permissible value: Interstitial Pneumonitis or ARDS
      • New permissible value: Intraductal Papillary Mucinous Neoplasm
      • New permissible value: Ischemic Heart Disease
      • New permissible value: ITP
      • New permissible value: Liver Cirrhosis (Liver Disease)
      • New permissible value: Low Grade Liver Dysplastic Nodule
      • New permissible value: Lupus
      • New permissible value: Myocardial Infarction
      • New permissible value: Neuroendocrine Tumor
      • New permissible value: Nevus of Ota
      • New permissible value: Organ Transplant (Site)
      • New permissible value: Osteoarthritis
      • New permissible value: Peptic Ulcer (Ulcer)
      • New permissible value: Peripheral Vascular Disease
      • New permissible value: Peutz-Jeghers Disease
      • New permissible value: Pregnancy in Patient or Partner
      • New permissible value: Psoriasis
      • New permissible value: Pulmonary Fibrosis
      • New permissible value: Renal Failure (Requiring Dialysis)
      • New permissible value: Renal Insufficiency
      • New permissible value: Rheumatologic Disease
      • New permissible value: Sleep Apnea
      • New permissible value: Staph Osteomyelitis
      • New permissible value: Thyroid Disease, Non-Cancer
      • New permissible value: Tyrosinemia
      • New permissible value: Urinary Tract Infection
      • New deprecated value: Chronic Hepatitis
      • New deprecated value: Cirrhosis
      • New deprecated value: HIV
      • New deprecated value: Reflux Disease
    • Changes made to timepoint_category
      • New permissible value: After Chemotherapy
      • New permissible value: After Study Enrollment
      • New permissible value: End of Consolidation Therapy
      • New permissible value: End of Treatment Course
      • New permissible value: End of Treatment Course 1
      • New permissible value: End of Treatment Course 2
      • New permissible value: First Complete Response
      • New permissible value: First Treatment
      • New permissible value: Post Initial Treatment
      • New permissible value: Prior to Adjuvant Therapy
      • New permissible value: Prior to Chemotherapy
      • New permissible value: Prior to Procurement
      • New permissible value: Prior to Study Enrollment
      • New permissible value: Prior to Study Registration
      • New permissible value: Progression
      • New permissible value: Recurrence
      • New permissible value: Within 2 Months After Completion of First-Course Treatment
    • New deprecated property: undescended_testis_corrected_age
  • Altered pathology_detail Entity
    • New property: epithelioid_cell_percent_range
    • New property: extraocular_nodule_size
    • New property: extrascleral_extension_present
    • New property: intratubular_germ_cell_neoplasia_present
    • New property: spindle_cell_percent_range
    • New property: timepoint_category
    • New property: tumor_basal_diameter
    • Changes made to lymph_node_dissection_site
      • New permissible value: Retroperitoneal
    • Changes made to lymph_node_involved_site
      • New permissible value: Intra-Abdominal, NOS
    • New deprecated property: epithelioid_cell_percent
    • New deprecated property: extrascleral_extension
    • New deprecated property: size_extraocular_nodule
    • New deprecated property: spindle_cell_percent
  • Altered sample Entity
    • Changes made to biospecimen_anatomic_site
      • New permissible value: Brainstem
      • New permissible value: Common Bile Duct
      • New deprecated value: Brain Stem
      • New deprecated value: Common Duct
    • Changes made to method_of_sample_procurement
      • New permissible value: Indeterminate
      • New deprecated value: Indeterminant
  • Altered treatment Entity
    • New property: margin_distance
    • New property: margin_status
    • New property: margins_involved_site
    • New property: pretreatment
    • Changes made to drug_category
      • New permissible value: Platinum
    • Changes made to therapeutic_agents
      • New permissible value: Cidofovir
      • New permissible value: Cyanocobalamin
      • New permissible value: Poly ICLC
    • Changes made to timepoint_category
      • New permissible value: Adjuvant Therapy
      • New permissible value: Adolescence
      • New permissible value: Adulthood
      • New permissible value: After Chemotherapy
      • New permissible value: After Study Enrollment
      • New permissible value: Childhood
      • New permissible value: End of Treatment Course 1
      • New permissible value: End of Treatment Course 2
      • New permissible value: Follow-up
      • New permissible value: Initial Diagnosis
      • New permissible value: Last Contact
      • New permissible value: Post Adjuvant Therapy
      • New permissible value: Post Hormone Therapy
      • New permissible value: Post Initial Treatment
      • New permissible value: Post Secondary Therapy
      • New permissible value: Prior to Adjuvant Therapy
      • New permissible value: Prior to Chemotherapy
      • New permissible value: Prior to Study Enrollment
      • New permissible value: Recurrence/Progression
      • New permissible value: Sample Procurement
      • New permissible value: Within 2 Months After Completion of First-Course Treatment
      • New permissible value: Within 3 Months of Surgery
      • New permissible value: Other
    • Changes made to treatment_anatomic_sites
      • New permissible value: Epiglottis
    • Changes made to treatment_intent_type
      • New permissible value: Re-Excision
      • New permissible value: Salvage
    • Changes made to treatment_type
      • New permissible value: Hysterectomy, NOS
    • New deprecated property: therapeutic_level_achieved

Bugs Fixed Since Last Release

  • N/A

Known Issues and Workarounds

  • The enum Head - Face Or Neck, Nos has been deprecated for the property treatment_anatomic_sites on the treatment entity, but still appears in the Data Dictionary viewer. This will be resolved in a future release.

v3.1.0

  • GDC Product: GDC Data Dictionary
  • Release Date: May 30, 2024

New Features and Changes

  • New Entity: germline_mutation_index
  • New Entity: submitted_expression_array
  • Altered aggregated_somatic_mutation Entity
    • New property: platform
  • Altered aligned_reads Entity
    • Added minimum and/or maximum values to properties
      • average_base_quality
      • average_insert_size
      • average_read_length
      • contamination
      • contamination_error
      • mean_coverage
      • msi_score
      • pairs_on_diff_chr
      • proportion_base_mismatch
      • proportion_coverage_10x
      • proportion_coverage_30x
      • proportion_reads_duplicated
      • proportion_reads_mapped
      • proportion_targets_no_coverage
      • total_reads
      • tumor_ploidy
      • tumor_purity
  • Altered annotated_somatic_mutation Entity
    • New property: platform
  • Altered annotation Entity
    • Changes made to links
      • germline_mutation_indexes added to subgroup
      • submitted_expression_arrays added to subgroup
    • Changes made to properties
      • New property: germline_mutation_indexes
      • New property: submitted_expression_arrays
  • Altered copy_number_auxiliary_file Entity
    • Changes made to data_format
      • New permissible value: PDF
    • Changes made to data_type
      • New permissible value: CNV Model
  • Altered copy_number_segment Entity
    • New property: cancer_dna_fraction
    • New property: genome_doubling
    • New property: subclonal_genome_fraction
    • New property: tumor_ploidy
    • New property: tumor_purity
  • Altered demographic Entity
    • Added permissible values Unknown and/or Not Reported to properties
      • country_of_birth
      • country_of_residence_at_enrollment
      • education_level
      • marital_status
  • Altered diagnosis Entity
    • New property: calgb_risk_group
    • New property: tumor_of_origin
    • Changes made to classification_of_tumor
      • New permissible value: Subsequent Primary
    • Changes made to primary_diagnosis
      • New permissible value: Diffuse intrinsic pontine glioma, H3 K27M-mutant
      • Removed permissible value: Hairy cell leukaemia variant
    • Changes made to sites_of_involvement
      • New permissible value: Dura Mater
      • New permissible value: Esophagus, Lower Third
      • New permissible value: Esophagus, Middle Third
      • New permissible value: Esophagus, NOS
      • New permissible value: Esophagus, Upper Third
      • New permissible value: Lymph Node, Cervical
      • New permissible value: Lymph Node, Femoral
      • New permissible value: Lymph Node, Hilar
      • New permissible value: Lymph Node, Iliac-Common
      • New permissible value: Lymph Node, Iliac-External
      • New permissible value: Lymph Node, Mediastinal
      • New permissible value: Lymph Node, Mesenteric
      • New permissible value: Lymph Node, Para-Aortic
      • New permissible value: Lymph Node, Retroperitoneal
      • New permissible value: Lymph Node, Splenic
      • New permissible value: Lymph Node, Submandibular
      • New permissible value: Lymph Node, Supraclavicular
      • New permissible value: Pancreas Body
      • New permissible value: Pancreas Duct
      • New permissible value: Pancreas Head
      • New permissible value: Pancreas Tail
      • New permissible value: Pancreas, NOS
      • New permissible value: Parametrium, NOS
      • New deprecated value: Esophagus
      • New deprecated value: Pancreas
    • Added permissible values Unknown and/or Not Reported to properties
      • adrenal_hormone
      • ann_arbor_b_symptoms_described
      • best_overall_response
      • cancer_detection_method
      • clark_level
      • contiguous_organ_invaded
      • double_expressor_lymphoma
      • double_hit_lymphoma
      • ensat_clinical_m
      • ensat_pathologic_n
      • ensat_pathologic_stage
      • ensat_pathologic_t
      • gleason_grade_group
      • gleason_grade_tertiary
      • international_prognostic_index
      • margins_involved_site
      • masaoka_stage
      • melanoma_known_primary
      • pediatric_kidney_staging
      • primary_gleason_grade
      • secondary_gleason_grade
      • tumor_grade_category
      • ulceration_indicator
      • weiss_assessment_findings
      • weiss_assessment_score
  • Altered exposure Entity
    • Added permissible values Other, Unknown and/or Not Reported to properties
      • alcohol_frequency
      • asbestos_exposure_type
      • chemical_exposure_type
      • environmental_tobacco_smoke_exposure
      • exposure_source
      • exposure_type
      • occupation_type
      • parent_with_radiation_exposure
      • smoking_frequency
      • time_between_waking_and_first_smoke
      • type_of_smoke_exposure
  • Altered family_history Entity
    • Added permissible values Unknown to properties
      • relative_deceased
      • relative_smoker
  • Altered filtered_copy_number_segment Entity
    • New property: platform
  • Altered follow_up Entity
    • New property: treatment_emergent_adverse_event
    • Changes made to adverse_event
      • New permissible value: Cardiac Ischemia
      • New permissible value: Glomerular Filtration Rate Decreased
      • New permissible value: Joint Pain
      • New permissible value: Rash/Desquamation
      • New permissible value: Renal Failure
      • New permissible value: Ureteral Obstruction
      • New permissible value: Unknown
      • New permissible value: Not Reported
    • Changes made to first_event
      • New permissible value: Recurrence
      • New permissible value: Unknown
    • Changes made to imaging_anatomic_site
      • New permissible value: Pleura
      • New permissible value: Unknown
      • New permissible value: Not Reported
    • Changes made to imaging_findings
      • New permissible value: Distant Metastasis
      • New permissible value: Equivocal
      • New permissible value: Extraprostatic Extension, Localized
      • New permissible value: Extraprostatic Extension, Regional Lymphadenopathy
      • New permissible value: No Evidence of Extraprostatic Extension
      • New permissible value: Unknown
    • Changes made to imaging_type
      • New permissible value: Bone Scan, NOS
      • New permissible value: Unknown
      • New permissible value: Not Reported
    • Changes made to timepoint_category
      • New permissible value: Prior to Adjuvant Therapy
      • New permissible value: Within 2 Months After Completion of First-Course Treatment
      • New permissible value: Unknown
    • Added permissible values Unknown and/or Not Reported to properties
      • adverse_event_grade
      • evidence_of_progression_type
      • evidence_of_recurrence_type
      • history_of_tumor
      • history_of_tumor_type
      • peritoneal_washing_results
      • scan_tracer_used
    • New deprecated property: days_to_risk_factor
  • Altered gene_expression Entity
    • New property: platform
    • Changes made to experimental_strategy
      • New permissible value: Expression Array
  • Altered germline_mutation_calling_workflow Entity
    • Changes made to workflow_type
      • New permissible value: Strelka2 Germline
  • Altered masked_somatic_mutation Entity
    • New property: platform
  • Altered mirna_expression Entity
    • New property: platform
  • Altered molecular_test Entity
    • Changes made to chromosomal_translocation
      • New permissible value: t(4;11)
      • New permissible value: t(9;11)
      • New permissible value: t(9;22)
      • New permissible value: t(15;17)
    • Changes made to gene_symbol
      • New permissible value: MPO
      • New permissible value: RAS, NOS
    • Changes made to laboratory_test
      • New permissible value: Abnormal Cells
    • Changes made to molecular_analysis_method
      • New permissible value: Immunophenotyping, NOS
    • Changes made to second_gene_symbol
      • New permissible value: MPO
      • New permissible value: RAS, NOS
    • Changes made to test_units
      • New permissible value: IU
      • New permissible value: nmol/L
      • New permissible value: Seconds
      • New permissible value: x10^6 cells/mcL
    • Changes made to test_value_range
      • New permissible value: 0-25%
      • New permissible value: 26-50%
      • New permissible value: 51-75%
      • New permissible value: 76-100%
      • New permissible value: Unknown
      • New deprecated value: 0-25
      • New deprecated value: 26-50
      • New deprecated value: 51-75
      • New deprecated value: 76-100
    • Changes made to timepoint_category
      • New permissible value: Initial Diagnosis
      • New permissible value: Sample Procurement
      • New permissible value: Unknown
    • Added permissible values Unknown and/or Not Reported to properties
      • aneuploidy
      • chromosome_arm
      • clonality
      • hpv_strain
      • molecular_consequence
      • mutation_codon
      • pathogenicity
      • staining_intensity_scale
      • staining_intensity_value
      • variant_origin
  • Altered other_clinical_attribute Entity
    • New property: days_to_risk_factor
    • New property: hormonal_replacement_therapy_status
    • New property: number_of_pregnancies
    • New property: viral_hepatitis_serology_tests
    • Changes made to immunosuppressive_treatment_type
      • New permissible value: Immunoglobulin
      • New permissible value: Prednisone
    • Changes made to pregnancy_outcome
      • New permissible value: Full Term Birth, NOS
    • Changes made to risk_factors
      • New permissible value: BK Virus
      • New permissible value: Diverticulosis
      • New permissible value: Hypercholesterolemia
      • New permissible value: Hypertension
      • New permissible value: Scarlet Fever
      • New permissible value: Ulcerative Colitis
    • Changes made to timepoint_category
      • New permissible value: Sample Procurement
      • New permissible value: Unknown
    • Added permissible values Unknown and/or Not Reported to properties
      • eye_color
      • nononcologic_therapeutic_agents
      • oxygen_use_type
      • risk_factor_method_of_diagnosis
      • undescended_testis_corrected
      • undescended_testis_corrected_laterality
      • undescended_testis_corrected_method
      • undescended_testis_history
      • undescended_testis_history_laterality
    • Removed maximum value for properties
      • dlco_ref_predictive_percent
      • fev1_fvc_post_bronch_percent
      • fev1_ref_post_bronch_percent
      • fev1_fvc_pre_bronch_percent
      • fev1_ref_pre_bronch_percent
    • New deprecated property: pregnancy_count
    • New deprecated property: viral_hepatitis_serologies
  • Altered pathology_detail Entity
    • New property: prcc_type
    • New property: tumor_burden
    • Added permissible values Unknown and/or Not Reported to properties
      • consistent_pathology_review
      • extracapsular_extension
      • extracapsular_extension_present
      • extranodal_extension
      • extrathyroid_extension
      • lymph_node_dissection_site
      • lymph_nodes_removed
      • measurement_type
      • measurement_unit
      • morphologic_architectural_pattern
      • necrosis_present
      • residual_tumor
      • residual_tumor_measurement
      • rhabdoid_present
      • sarcomatoid_present
      • tumor_depth_descriptor
      • tumor_infiltrating_lymphocytes
      • tumor_infiltrating_macrophages
      • tumor_shape
      • zone_of_origin_prostate
  • Altered rna_expression_workflow Entity
    • Changes made to links
      • submitted_expression_arrays added to subgroup
    • New property: submitted_expression_arrays
    • Changes made to workflow_type
      • New permissible value: Expression Array Quantification
  • Altered sample Entity
    • New deprecated property: tumor_code
    • Updated definitions for properties
      • days_to_collection
      • days_to_sample_procurement
      • biospecimen_anatomic_site
  • Altered secondary_expression_analysis Entity
    • New property: platform
  • Altered simple_germline_variation Entity
    • Changes made to data_format
      • New permissible value: gVCF
    • Changes made to platform
      • New permissible value: Illumina
  • Altered simple_somatic_mutation Entity
    • New property: platform
  • Altered somatic_aggregation_workflow Entity
    • Changes made to workflow_type
      • New permissible value: Tumor-Only Somatic Variant Merging and Masking
  • Altered somatic_annotation_workflow Entity
    • Changes made to workflow_type
      • New permissible value: Manta Indel Annotation
      • New permissible value: Strelka2 Annotation
      • New permissible value: SvABA Indel Annotation
  • Altered somatic_copy_number_workflow Entity
    • Changes made to workflow_type
      • New permissible value: ABSOLUTE GATK4 CNV Auto
      • New permissible value: ABSOLUTE GATK4 CNV Curated
  • Altered somatic_mutation_calling_workflow Entity
    • Changes made to workflow_type
      • New permissible value: Manta Indel
      • New permissible value: Strelka2
      • New permissible value: SvABA Indel
  • Altered somatic_mutation_index Entity:
    • Updated definition for Entity
  • Altered structural_variant_calling_workflow Entity
    • Changes made to workflow_type
      • New permissible value: Manta
  • Altered structural_variation Entity
    • New property: platform
  • Altered treatment Entity
    • New property: prescribed_dose_units
    • Changes made to reason_treatment_not_given
      • New permissible value: Patient Ineligible
    • Changes made to treatment_type
      • New permissible value: Ablation or Embolization, NOS
    • Added permissible values Unknown and/or Not Reported to properties
      • drug_category
      • embolic_agent
      • protocol_identifier
      • reason_treatment_ended
      • residual_disease
      • therapeutic_target_level
      • timepoint_category
      • treatment_dose_units

Bugs Fixed Since Last Release

Known Issues and Workarounds

  • The enum Head - Face Or Neck, Nos has been deprecated for the property treatment_anatomic_sites on the treatment entity, but still appears in the Data Dictionary viewer. This will be resolved in a future release.

v3.0.0

  • GDC Product: GDC Data Dictionary
  • Release Date: October 30, 2023

New Features and Changes

  • New Entity: other_clinical_attribute
  • Altered annotation Entity
    • Changes made to links
      • other_clinical_attributes added to subgroup
  • Altered demographic Entity
    • New deprecated property: premature_at_birth
    • New deprecated property: weeks_gestation_at_birth
  • Altered diagnosis Entity
    • Changes made to morphology
      • New permissible value: 8980/6
    • Changes made to primary_diagnosis
      • New permissible value: Diffuse Pediatric-type High Grade Glioma
    • Changes made to sites_of_involvement
      • New permissible value: Thyroid Gland Isthmus
    • Changes made to tumor_grade
      • Removed deprecated value: not reported
    • New deprecated property pregnant_at_diagnosis
    • Removed property: measurement_type
  • Altered exposure Entity
    • Changes made to exposure_source
      • New permissible value: Home
      • New permissible value: Social
      • New permissible value: Work
  • Altered follow_up Entity
    • Changes made to imaging_anatomic_site
      • New permissible value: Lymph Node
    • Changes made to imaging_type
      • New permissible value: Ultrasound
    • New deprecated property: aids_risk_factors
    • New deprecated property: bmi
    • New deprecated property: body_surface_area
    • New deprecated property: cd4_count
    • New deprecated property: cdc_hiv_risk_factors
    • New deprecated property: comorbidity_method_of_diagnosis
    • New deprecated property: comorbidities
    • New deprecated property: days_to_comorbidity
    • New deprecated property: diabetes_treatment_type
    • New deprecated property: dlco_ref_predictive_percent
    • New deprecated property: eye_color
    • New deprecated property: fev1_fvc_post_bronch_percent
    • New deprecated property: fev1_fvc_pre_bronch_percent
    • New deprecated property: fev1_ref_post_bronch_percent
    • New deprecated property: fev1_ref_pre_bronch_percent
    • New deprecated property: haart_treatment_indicator
    • New deprecated property: height
    • New deprecated property: hepatitis_sustained_virological_response
    • New deprecated property: hiv_viral_load
    • New deprecated property: hormonal_contraceptive_type
    • New deprecated property: hormonal_contraceptive_use
    • New deprecated property: hormone_replacement_therapy_type
    • New deprecated property: hysterectomy_margins_involved
    • New deprecated property: hysterectomy_type
    • New deprecated property: immunosuppressive_treatment_type
    • New deprecated property: menopause_status
    • New deprecated property: nadir_cd4_count
    • New deprecated property: pancreatitis_onset_year
    • New deprecated property: pregnancy_count
    • New deprecated property: pregnancy_outcome
    • New deprecated property: reflux_treatment_type
    • New deprecated property: risk_factor_method_of_diagnosis
    • New deprecated property: risk_factor_treatment
    • New deprecated property: risk_factors
    • New deprecated property: undescended_testis_corrected
    • New deprecated property: undescended_testis_corrected_age
    • New deprecated property: undescended_testis_corrected_laterality
    • New deprecated property: undescended_testis_corrected_method
    • New deprecated property: undescended_testis_history
    • New deprecated property: undescended_testis_history_laterality
    • New deprecated property: viral_hepatitis_serologies
    • New deprecated property: weight
  • Altered molecular_test Entity
    • New property: staining_intensity_value
    • Changes made to antigen
      • New permissible value: CD43
    • Changes made to molecular_analysis_method
      • New permissible value: Microscopy, NOS
    • Changes made to test_result
      • New permissible value: Mitotic Count Reported
      • New permissible value: Staining Intensity Value Reported
    • Changes made to test_units
      • Removed deprecated value: count x10^9/L
    • Changes made to timepoint_category
      • New permissible value: Prior to Treatment
  • Altered pathology_detail Entity
    • Changes made to lymph_node_involved_site
      • New permissible value: Cervical, Central
      • New permissible value: Cervical, Lateral
      • New permissible value: Cervical, NOS
      • New deprecated value: Cervical
    • Changes made to measurement_type
      • New permissible value: Echographic
    • New property: days_to_pathology_detail
    • New property: extracapsular_extension_present
    • New property: extrathyroid_extension
    • New property: histologic_progression_type
    • New property: micrometastasis_present
    • Removed property: tumor_measurement_method
  • Altered read_group Entity
    • Changes made to instrument_model
      • New permissible value: Illumina NovaSeq X
  • Altered sample Entity
    • Changes made to biospecimen_anatomic_site
      • New permissible value: Head, Face or Neck, NOS
      • New deprecated value: Head - Face Or Neck, Nos
  • Altered submitted_aligned_reads Entity
    • Changes made to experimental_strategy
      • New deprecated value: scRNA-Seq
  • Altered treatment Entity
    • Changes made to timepoint_category
      • New permissible value: First Treatment
      • New permissible value: Prior to Treatment
    • Changes made to treatment_anatomic_sites
      • New deprecated value: Head - Face Or Neck, Nos
      • New permissible value: Head, Face or Neck, NOS
    • New property: radiosensitizing_agent
    • New property: reason_treatment_not_given
    • New property: therapeutic_levels_achieved

Bugs Fixed Since Last Release

Known Issues and Workarounds

  • The enum Head - Face Or Neck, Nos has been deprecated for the property treatment_anatomic_sites on the treatment entity, but still appears in the Data Dictionary viewer. This will be resolved in a future release.

v2.6.6

  • GDC Product: GDC Data Dictionary
  • Release Date: June 16, 2023

New Features and Changes

  • Updated CDE links to point to newer version of caDSR website.
  • Altered aligned_reads Entity
    • New property: wgs_coverage
  • Altered case Entity
    • New required property: disease_type
    • New required property: primary_site
    • Changes made to primary_site
      • New permissible value: Not Applicable
  • Altered demographic Entity
    • New property: country_of_birth
    • New property: education_level
    • New property: marital_status
  • Altered diagnosis Entity
    • New deprecated property: metastasis_at_diagnosis_site
    • New property: clark_level
    • New property: contiguous_organ_invaded
    • New property: ensat_clinical_m
    • New property: ensat_pathologic_n
    • New property: ensat_pathologic_stage
    • New property: ensat_pathologic_t
    • New property: first_symptom_longest_duration
    • New property: measurement_type
    • New property: melanoma_known_primary
    • New property: tumor_burden
    • New property: ulceration_indicator
    • Changes made to sites_of_involvement
      • New permissible value: Ascites
      • New permissible value: Common or Superficial Femoral Vein
      • New permissible value: Distant Nodes
      • New permissible value: Distant Organ
      • New permissible value: Gastrointestinal Tract
      • New permissible value: Great Blood Vessel
      • New permissible value: Groin
      • New permissible value: Head, Face or Neck, NOS
      • New permissible value: Inferior Vena Cava
      • New permissible value: Lymph Node, Axillary
      • New permissible value: Lymph Node, Inguinal
      • New permissible value: Lymph Node, Regional
      • New permissible value: Lymph Node, Subcarinal
      • New permissible value: Mediastinum
      • New permissible value: Pelvic Vein, Common, External or Iliac
      • New permissible value: Peritoneal Cavity
      • New permissible value: Renal Vein
      • New permissible value: Scalp
      • New permissible value: Spinal Cord
      • New permissible value: Urethra
      • New permissible value: Vertebral Canal
      • New permissible value: Vulva, NOS
  • Altered exposure Entity
    • New property: exposure_duration_hrs_per_day
    • Changes made to exposure_type
      • New permissible value: Dust, NOS
  • Altered family_history Entity
    • New property: relative_deceased
    • New property: relative_smoker
  • Altered follow_up Entity
    • New property: discontiguous_lesion_count
    • Changes made to comorbidities
      • New permissible value: Pneumonia, NOS
    • Changes made to first_event
      • New permissible value: Presented with Metastases
    • Changes made to risk_factors
      • New permissible value: Pneumonia, NOS
    • Changes made to timepoint_category
      • New permissible value: Within 3 Months of Surgery
  • Altered masked_methylation_array Entity
    • Changes made to platform
      • New permissible value: Illumina Methylation Epic v2
  • Altered methylation_beta_value Entity
    • Changes made to platform
      • New permissible value: Illumina Methylation Epic v2
  • Altered molecular_test Entity
    • New property: staining_intensity_scale
    • Changes made to gene_symbol and second_gene_symbol
      • New permissible value: ACACA
      • New permissible value: BRD1
      • New permissible value: BTBD18
      • New permissible value: CBFA2T2
      • New permissible value: CEP164
      • New permissible value: CEP170B
      • New permissible value: CTDP1
      • New permissible value: DOT1L
      • New permissible value: FRYL
      • New permissible value: GLIS2
      • New permissible value: HMGB3
      • New permissible value: HNRNPH1
      • New permissible value: INO80D
      • New permissible value: JARID2
      • New permissible value: PHF23
      • New permissible value: PIM3
      • New permissible value: PTP4A1
      • New permissible value: RPS15
      • New permissible value: SETD1A
      • New permissible value: SLC66A2 (aka PQLC1)
      • New permissible value: TOP2B
      • New permissible value: UBB
      • New permissible value: ZEB2
    • Changes made to test_value_range
      • New permissible value: <10%
      • New permissible value: 10-19%
      • New permissible value: 20-29%
      • New permissible value: 30-39%
      • New permissible value: 40-49%
      • New permissible value: 50-59%
      • New permissible value: 60-69%
      • New permissible value: 70-79%
      • New permissible value: 80-89%
      • New permissible value: 90-99%
      • New permissible value: <1%
      • New permissible value: 1-49%
      • New permissible value: >=50%
    • Changes made to timepoint_category
      • New permissible value: Preoperative
  • Altered pathology_detail Entity
    • New property: epithelioid_cell_percent
    • New property: measurement_type
    • New property: measurement_unit
    • New property: spindle_cell_percent
    • New property: tumor_depth_descriptor
    • New property: tumor_depth_measurement
    • New property: tumor_infiltrating_lymphocytes
    • New property: tumor_infiltrating_macrophages
    • New property: tumor_length_measurement
    • New property: tumor_measurement_method
    • New property: tumor_shape
    • New property: tumor_width_measurement
    • Changes made to additional_pathology_findings
      • New permissible value: Extravascular Matrix Loops
      • New permissible value: Other Complex Extravascular Matrix Patterns
      • New permissible value: Poorly Differentiated
      • New permissible value: Well Differentiated
  • Altered raw_methylation_array Entity
    • Changes made to platform
      • New permissible value: Illumina Methylation Epic v2
  • Altered sample Entity
    • Changes made to preservation_method
      • New permissible value: EDTA
    • Changes made to specimen_type
      • New permissible value: Derived Cell Lines and Sorted Cells
  • Altered treatment Entity
    • New deprecated property: treatment_anatomic_site
    • New property: treatment_anatomic_sites
    • Changes made to protocol_identifier
      • New permissible value: P9407

Bugs Fixed Since Last Release

v2.6.0

  • GDC Product: GDC Data Dictionary
  • Release Date: February 2, 2023

New Features and Changes

  • Altered aliquot Entity
    • New deprecated property: analyte_type_id
  • Altered analyte Entity
    • New deprecated property: analyte_type_id
  • Altered annotation Entity
    • Changes made to links
      • copy_number_auxiliary_files added to subgroup
    • New property: copy_number_auxiliary_files
  • Altered exposure Entity
    • New deprecated property: coal_dust_exposure
    • New property: alcohol_frequency
    • New property: chemical_exposure_type
    • New property: occupation_duration_years
    • New property: occupation_type
    • Changes made to exposure_type
      • New permissable value: Coal Dust
    • Changes made to tobacco_smoking_status
      • New permissable value: Current Reformed Smoker, Duration Not Specified
      • New permissable value: Current Reformed Smoker for < or = 15 yrs
      • New permissable value: Current Reformed Smoker for > 15 yrs
      • New permissable value: Current Smoker
      • New permissable value: Lifelong Non-Smoker
      • New permissable value: Smoker at Diagnosis
      • New permissable value: Smoking history not documented
      • New deprecated value: 1
      • New deprecated value: 2
      • New deprecated value: 3
      • New deprecated value: 4
      • New deprecated value: 5
      • New deprecated value: 6
      • New deprecated value: 7
  • Altered diagnosis Entity
    • New property: cancer_detection_method
    • New property: fab_morphology_code
    • New property: gleason_score
    • New property: pediatric_kidney_staging
    • New property: sites_of_involvement_count
    • New property: tumor_grade_category
    • New property: uicc_staging_system_edition
    • New property: weiss_assessment_findings
    • Changes made to inpc_grade
      • New permissable value: Undifferentiated or Poorly Differentiated
    • Changes made to sites_of_involvement
      • Changes made to items
        • New permissable value: Brain, Brain stem
        • New permissable value: Brain, Cerebellum, NOS
        • New permissable value: Brain, Cerebrum
        • New permissable value: Brain, Frontal lobe
        • New permissable value: Brain, Occipital lobe
        • New permissable value: Brain, Parietal
        • New permissable value: Brain, Temporal lobe
        • New permissable value: Brain, Ventricle, NOS
        • New permissable value: Central Lung
        • New permissable value: Gastrosplenic Ligament
        • New permissable value: Parametrium, Left
        • New permissable value: Parametrium, Right
        • New permissable value: Pelvic Lymph Node(s)
        • New permissable value: Peri-aortic Lymph Node(s)
        • New permissable value: Peripheral Lung
        • New permissable value: Thorax, NOS
  • Altered family_history Entity
    • Changes made to relationship_type
      • New permissable value: First Degree Relative, NOS
  • Altered follow_up Entity
    • New deprecated property: comorbidity
    • New deprecated property: risk_factor
    • New property: comorbidities
    • New property: days_to_first_event
    • New property: days_to_risk_factor
    • New property: evidence_of_progression_type
    • New property: first_event
    • New property: imaging_anatomic_site
    • New property: imaging_findings
    • New property: imaging_suv
    • New property: imaging_suv_max
    • New property: peritoneal_washing_results
    • New property: pregnancy_count
    • New property: risk_factors
    • New property: risk_factor_method_of_diagnosis
    • New property: timepoint_category
    • New property: year_of_follow_up
    • Changes made to evidence_of_recurrence_type
      • New permissable value: Histologic Confirmation
    • Changes made to history_of_tumor_type
      • New permissable value: Colorectal Cancer
      • New permissable value: Lower Grade Glioma
    • Changes made to pregnancy_outcome
      • New permissable value: Spontaneous Abortion
    • Changes made to progression_or_recurrence_type
      • New permissable value: Locoregional
  • Altered gene_expression Entity
    • Changes made to experimental_strategy
      • New permissable value: m6A MeRIP-Seq
  • Altered molecular_test Entity
    • New property: aneuploidy
    • New property: chromosomal_translocation
    • New property: chromosome_arm
    • New property: mutation_codon
    • New property: test_value_range
    • New property: timepoint_category
    • Changes made to antigen
      • New permissable value: Immunoglobulin, Cytoplasmic
      • New permissable value: Immunoglobulin, Surface
    • Changes made to laboratory_test
      • New permissable value: Blast Count
      • New permissable value: Metaphase Nucleus Count
      • New permissable value: Minimal Residual Disease
      • New permissable value: Monocytes
    • Changes made to test_result
      • New permissable value: Amplified
      • New permissable value: Elevated
      • New permissable value: Not Amplified
    • Changes made to variant_type
      • New permissable value: Fusion
      • New permissable value: Genetic Polymorphism
      • New permissable value: Internal Tandem Duplication
      • New permissable value: Mutation, NOS
  • Altered pathology_detail Entity
    • New property: extracapsular_extension
    • New property: extranodal_extension
    • New property: extrascleral_extension
    • New property: lymph_node_dissection_method
    • New property: lymph_node_dissection_site
    • New property: lymph_nodes_removed
    • New property: percent_tumor_nuclei
    • New property: residual_tumor_measurement
    • Changes made to additional_pathology_findings
      • New permissable value: Bone marrow concordant histology
      • New permissable value: Bone marrow discordant histology
    • Changes made to dysplasia_type
      • New permissable value: Esophageal Mucosa Columnar Dysplasia
    • Changes made to lymph_node_involved_site
      • New permissable value: Aortic
      • New permissable value: Pelvis, NOS
  • Altered read_group Entity
    • Changes made to target_capture_kit
      • New property: Custom SureSelect CGCI-BLGSP Panel - 7.8 Mb
  • Altered sample Entity
    • New required property: preservation_method
    • New required property: specimen_type
    • New required property: tumor_descriptor
    • New deprecated property: composition
    • New deprecated property: sample_type
    • New deprecated property: sample_type_id
    • New property: specimen_type
    • Changes made to tumor_descriptor
      • New permissable value: New Primary
  • Altered simple_germline_variation Entity
    • Changes made to experimental_strategy
      • New permissable value: Genotyping Array
  • Altered somatic_copy_number_workflow Entity
    • Changes made to workflow_type
      • New permissable value: ABSOLUTE LiftOver
      • New permissable value: ASCAT3
      • New permissable value: GATK4 CNV
  • Altered structural_variant_calling_workflow Entity
    • Changes made to workflow_type
      • New permissable value: SvABA
  • Altered submitted_genotyping_array Entity
    • Changed aliquot link from one-to-one to many-to-one
  • Altered treatment Entity
    • New property: residual_disease
    • New property: timepoint_category
    • New property: treatment_duration
    • New property: treatment_outcome_duration
    • New property: therapeutic_level_achieved
    • New property: therapeutic_target_level
    • Changes made to initial_disease_status
      • New permissable value: Persistent Disease
      • New permissable value: Refractory Disease
    • Changes made to protocol_identifier
      • New permissable value: 901
      • New permissable value: 911
      • New permissable value: 914
      • New permissable value: 925
      • New permissable value: 935
      • New permissable value: 937
      • New permissable value: 3881
      • New permissable value: 3891
      • New permissable value: 4941
      • New permissable value: 8605
      • New permissable value: 9047
      • New permissable value: 9082
      • New permissable value: 9340
      • New permissable value: 9341
      • New permissable value: 9342
      • New permissable value: 9343
      • New permissable value: 9464
      • New permissable value: 9640
      • New permissable value: 9906
      • New permissable value: 321P2
      • New permissable value: 321P3
      • New permissable value: 323P
      • New permissable value: A3961
      • New permissable value: A3973
      • New permissable value: AADM01P1
      • New permissable value: AALL0031
      • New permissable value: AALL0232
      • New permissable value: AALL0331
      • New permissable value: AALL03B1
      • New permissable value: AALL0434
      • New permissable value: AALL07P4
      • New permissable value: AALL08P1
      • New permissable value: AALL1131
      • New permissable value: AAML00P2
      • New permissable value: AAML03P1
      • New permissable value: AAML0531
      • New permissable value: AAML0631
      • New permissable value: AAML1031
      • New permissable value: AB9804
      • New permissable value: ACCL0331
      • New permissable value: ACCL0431
      • New permissable value: ACCL05C1
      • New permissable value: ACCL0934
      • New permissable value: ACCL1031
      • New permissable value: ADVL0018
      • New permissable value: ADVL0212
      • New permissable value: ADVL0214
      • New permissable value: ADVL0215
      • New permissable value: ADVL0421
      • New permissable value: ADVL0524
      • New permissable value: ADVL0525
      • New permissable value: ADVL06B1
      • New permissable value: ADVL0714
      • New permissable value: ADVL0812
      • New permissable value: ADVL0813
      • New permissable value: ADVL0821
      • New permissable value: ADVL0911
      • New permissable value: ADVL0912
      • New permissable value: ADVL0918
      • New permissable value: ADVL0921
      • New permissable value: ADVL1011
      • New permissable value: ADVL1111
      • New permissable value: ADVL1112
      • New permissable value: ADVL1115
      • New permissable value: ADVL1213
      • New permissable value: ADVL1412
      • New permissable value: AEPI07N1
      • New permissable value: ALTE03N1
      • New permissable value: ALTE05N1
      • New permissable value: ANBL0032
      • New permissable value: ANBL00B1
      • New permissable value: ANBL00P1
      • New permissable value: ANBL00P3
      • New permissable value: ANBL02P1
      • New permissable value: ANBL0321
      • New permissable value: ANBL0322
      • New permissable value: ANBL0421
      • New permissable value: ANBL0531
      • New permissable value: ANBL0532
      • New permissable value: ANBL0621
      • New permissable value: ANBL0931
      • New permissable value: ANBL09P1
      • New permissable value: ANBL1021
      • New permissable value: ANBL1221
      • New permissable value: ANUR1131
      • New permissable value: AOST0121
      • New permissable value: AOST0331
      • New permissable value: AOST06B1
      • New permissable value: AOST06P1
      • New permissable value: AREN03B2
      • New permissable value: B003
      • New permissable value: B903
      • New permissable value: B947
      • New permissable value: B954
      • New permissable value: B973
      • New permissable value: BCM
      • New permissable value: CCG2961
      • New permissable value: D9902
      • New permissable value: E04
      • New permissable value: E18
      • New permissable value: GBCTTO/99
      • New permissable value: GLATO 2006
      • New permissable value: I03
      • New permissable value: IHRT
      • New permissable value: INT-0133
      • New permissable value: N891
      • New permissable value: NWTS-4
      • New permissable value: NWTS-5
      • New permissable value: OSTEO 2006
      • New permissable value: Not Reported
      • New permissable value: P9462
      • New permissable value: P9641
      • New permissable value: P9754
      • New permissable value: P9851
      • New permissable value: P9906
      • New permissable value: P9963
      • New permissable value: R9702
      • New permissable value: S31
      • New permissable value: S921
      • New permissable value: STB
    • Changes made to treatment_anatomic_site
      • New permissable value: Locoregional Site
    • Changes made to treatment_intent_type
      • New permissable value: Consolidation Therapy
      • New permissable value: First-Line Therapy
      • New permissable value: Induction
      • New permissable value: Radiation Boost
    • Changes made to treatment_outcome
      • New permissable value: Normalization of Tumor Markers
    • Changes made to treatment_type
      • New permissable value: Biopsy, Excisional
      • New permissable value: Biopsy, Incisional
      • New permissable value: Distal Pancreatectomy
      • New permissable value: Surgery, NOS
      • New permissable value: Surgery, Minimally Invasive
      • New permissable value: Surgery, Open
      • New permissable value: Total Pancreatectomy
      • New permissable value: Whipple
      • New deprecated value: Cryoablation
      • New deprecated value: Surgery
    • Changes made to therapeutic_agents
      • New permissable value: TLR9 Agonist SD-101
  • New Entity: copy_number_auxiliary_file

Known Issues and Workarounds

  • The GDC Data Dictionary Viewer on the GDC Documentation Site does not currently display permissible values for array type properties. This does not impact submission of permissible values for these properties. Data submitters that would like to submit data for these properties can contact the GDC Helpdesk (support@nci-gdc.datacommons.io) for a list of permissible values for the affected properties. This will be addressed in a future release.

v2.5.0

  • GDC Product: GDC Data Dictionary
  • Release Date: July 8, 2022

New Features and Changes

  • Altered diagnosis Entity
    • New property: double_expressor_lymphoma
    • New property: double_hit_lymphoma
    • New property: max_tumor_bulk_site
    • New property: uicc_clinical_m
    • New property: uicc_clinical_n
    • New property: uicc_clinical_stage
    • New property: uicc_clinical_t
    • New property: uicc_pathologic_m
    • New property: uicc_pathologic_n
    • New property: uicc_pathologic_stage
    • New property: uicc_pathologic_t
    • Changes made to ajcc_pathologic_n
      • New permissible value: N2mi
    • Changes made to ajcc_pathologic_t
      • New permissible value: T1c2
    • Changes made to classification_of_tumor
      • New permissible value: Prior primary
      • New permissible value: Synchronous primary
    • Changes made to metastasis_at_diagnosis_site
      • New permissible value: Spleen
      • New permissible value: Stomach
    • Changes made to morphology
      • New permissible value: 8211/6
      • New permissible value: 8460/6
      • New permissible value: 8520/6
      • New permissible value: 9715/3
    • Changes made to primary_diagnosis
      • New permissible value: Breast implant-associated anaplastic large cell lymphoma
      • New permissible value: Indolent T-cell lymphoproliferative disorder of gastrointestinal tract
    • Changes made to sites_of_involvement
      • New permissible value: Abdomen
      • New permissible value: Adrenal gland, NOS
      • New permissible value: Adnexa
      • New permissible value: Anus, NOS
      • New permissible value: Appendix
      • New permissible value: Bladder, NOS
      • New permissible value: Bone, NOS
      • New permissible value: Bone marrow
      • New permissible value: Brain, NOS
      • New permissible value: Breast, NOS
      • New permissible value: Bronchus
      • New permissible value: Buccal mucosa
      • New permissible value: Central nervous system
      • New permissible value: Cerebrospinal fluid
      • New permissible value: Chest wall
      • New permissible value: Colon, NOS
      • New permissible value: Diaphragm
      • New permissible value: Ear
      • New permissible value: Epididymis
      • New permissible value: Esophagus
      • New permissible value: Eye
      • New permissible value: Gallbladder
      • New permissible value: Heart
      • New permissible value: Kidney, NOS
      • New permissible value: Larynx, NOS
      • New permissible value: Leptomeninges
      • New permissible value: Liver
      • New permissible value: Lower lobe, lung
      • New permissible value: Lung, NOS
      • New permissible value: Lymph node, NOS
      • New permissible value: Mandible
      • New permissible value: Maxilla
      • New permissible value: Mediastinal soft tissue
      • New permissible value: Mesentery
      • New permissible value: Middle lobe, lung
      • New permissible value: Mouth
      • New permissible value: Nasopharynx
      • New permissible value: Nasal soft tissue
      • New permissible value: Neck
      • New permissible value: Ocular orbits
      • New permissible value: Oropharynx
      • New permissible value: Pancreas
      • New permissible value: Parotid gland
      • New permissible value: Pelvis
      • New permissible value: Pericardium
      • New permissible value: Perineum
      • New permissible value: Peri-orbital soft tissue
      • New permissible value: Peripheral blood
      • New permissible value: Peripheral nervous system
      • New permissible value: Peritoneum, NOS
      • New permissible value: Pleura
      • New permissible value: Prostate
      • New permissible value: Rectum
      • New permissible value: Retroperitoneum
      • New permissible value: Salivary gland
      • New permissible value: Sigmoid colon
      • New permissible value: Sinus
      • New permissible value: Skin
      • New permissible value: Small intestine
      • New permissible value: Soft tissue
      • New permissible value: Spleen
      • New permissible value: Stomach
      • New permissible value: Testes
      • New permissible value: Thyroid
      • New permissible value: Tongue
      • New permissible value: Tonsil
      • New permissible value: Trachea
      • New permissible value: Transplanted kidney
      • New permissible value: Transverse colon
      • New permissible value: Upper lobe, lung
      • New permissible value: Vagina
      • New permissible value: Vertebrae
    • Changes made to tumor_depth
      • New property: minimum
  • Altered submitted_unaligned_reads Entity
    • Changes made to experimental_strategy
      • New permissible value: m6A MeRIP-Seq
      • Removed permissible value: m6A RNA Methylation
  • Altered pathology_detail Entity
    • New property: tumor_level_prostate
    • New property: zone_of_origin_prostate
    • Changes made to additional_pathology_findings
      • New permissible value: Percent follicular component <= 10%
      • New permissible value: Percent follicular component > 10%
  • Altered exposure Entity
    • New property: asbestos_exposure_type
    • New property: age_at_last_exposure
    • New property: exposure_source
    • New property: use_per_day
    • Removed property: marijuana_use_per_week
    • Removed property: smokeless_tobacco_quit_age
    • Removed property: tobacco_use_per_day
    • Changes made to alcohol_intensity
      • New permissible value: Social Drinker
    • Added maximum to exposure_duration_years
    • Changes made to exposure_type
      • New permissible value: Asbestos
      • New permissible value: Chemical
      • New permissible value: Radon
      • New permissible value: Respirable Crystalline Silica
      • New permissible value: Smokeless Tobacco
  • Altered case Entity
    • Added min/max to days_to_consent
  • Altered analyte Entity
    • Changes made to analyte_type
      • New permissible value: m6A Enriched RNA
  • Altered read_group Entity
    • Changes made to library_strategy
      • New permissible value: m6A MeRIP-Seq
      • Removed permissible value: m6A RNA Methylation
    • Changes made to target_capture_kit
      • New permissible value: Custom SeqCap EZ BeatAML Panel - 12.5 Mb
      • New permissible value: Custom Twist MP2PRT-WT Panel - 52 Kb
  • Altered aligned_reads Entity
    • Changes made to experimental_strategy
      • New permissible value: m6A MeRIP-Seq
  • Altered follow_up Entity
    • Changes made to comorbidity
      • New permissible value: CNS Infection
      • New permissible value: EBV Lymphoproliferation
      • New permissible value: Hodgkin Lymphoma
      • New permissible value: Lymphamatoid Papulosis
      • New permissible value: Methicillin-Resistant Staphylococcus aureus (MRSA)
      • New permissible value: Staph Osteomyelitis
      • New permissible value: Thyroid Disease, Non-Cancer
      • New permissible value: Urinary Tract Infection
    • Changes made to diabetes_treatment_type
      • New permissible value: Linagliptin
    • Changes made to risk_factor
      • New permissible value: Adenomyosis
      • New permissible value: Human Herpesvirus-6 (HHV-6)
      • New permissible value: Human Herpesvirus-8 (HHV-8)
    • Changes made to undescended_testis_corrected_age
      • New property: maximum
  • Altered molecular_test Entity
    • New property: hpv_strain
    • Changes made to antigen
      • New permissible value: TAG-72
    • Changes made to gene_symbol
      • New permissible value: TLR2
    • Changes made to laboratory_test
      • New permissible value: Erythrocyte Sedimentation Rate
      • New permissible value: Prothrombin Time
    • Changes made to second_gene_symbol
      • New permissible value: TLR2
    • Changes made to test_result
      • New permissible value: Stable
    • Changes made to test_units
      • New permissible value: cells/mL
      • New permissible value: mcg/L
      • New permissible value: mg/24 hr
  • Altered somatic_annotation_workflow Entity
    • Changes made to workflow_type
      • New permissible value: GATK4 MuTect2 Tumor-Only Annotation
  • Altered treatment Entity
    • New property: clinical_trial_indicator
    • New property: course_number
    • New property: drug_category
    • New property: embolic_agent
    • New property: lesions_treated_number
    • New property: number_of_fractions
    • New property: prescribed_dose
    • New property: protocol_identifier
    • New property: treatment_dose_max
    • route_of_administrationchanged to array type.
    • Changes made to treatment_dose_units
      • New permissible value: AUC
      • New permissible value: g/day
      • New permissible value: g/m2
      • New permissible value: IU/kg
      • New permissible value: IU/mg
      • New permissible value: mCi
      • New permissible value: mEq
      • New permissible value: mg/day
      • New permissible value: mg/dL
      • New permissible value: mg/kg
      • New permissible value: mg/kg/day
      • New permissible value: mg/m2
      • New permissible value: mg/m2/day
      • New permissible value: mg/m2/wk
      • New permissible value: mg/mL
      • New permissible value: mg/wk
      • New permissible value: mIU
      • New permissible value: mL
      • New permissible value: ug
      • New permissible value: ug/m2
      • New permissible value: Wafer
    • Changes made to treatment_type
      • New permissible value: Peptide Receptor Radionuclide Therapy (PRRT)
    • Changes made to therapeutic_agents
      • New permissible value: Canakinumab
      • New permissible value: Rivaroxaban
  • Altered somatic_mutation_calling_workflow Entity
    • Changes made to workflow_type
      • New permissible value: GATK4 MuTect2 Tumor-Only
  • Altered submitted_aligned_reads Entity
    • Changes made to experimental_strategy
      • New permissible value: m6A MeRIP-Seq
      • Removed permissible value: m6A RNA Methylation

Known Issues and Workarounds

  • The mitotic_count field in diagnosis is erroneously set as "deprecated" and does not appear in the dictionary viewer. This field can be uploaded successfully without issue and will appear in the dictionary viewer at a later release.

v2.4.1

  • GDC Product: GDC Data Dictionary
  • Release Date: August 23, 2021

New Features and Changes

  • Altered pathology_detail Entity
    • Changes made to additional_pathology_findings
      • New permissible value: Adenomyosis
      • New permissible value: Atrophic endometrium
      • New permissible value: Atypical hyperplasia/Endometrial intraepithelial neoplasia (EIN)
      • New permissible value: Autoimmune atrophic chronic gastritis
      • New permissible value: Asbestos bodies
      • New permissible value: Benign endocervical polyp
      • New permissible value: Bilateral ovaries with endometriotic cyst and surface adhesions
      • New permissible value: Carcinoma in situ
      • New permissible value: Cirrhosis
      • New permissible value: Clostridioides difficile (c. diff)
      • New permissible value: Colonization; bacterial
      • New permissible value: Colonization; fungal
      • New permissible value: Cyst(s)
      • New permissible value: Diffuse and early nodular diabetic glomerulosclerosis
      • New permissible value: Dysplasia; high grade
      • New permissible value: Dysplasia; low grade
      • New permissible value: Endometrial polyp
      • New permissible value: Endometriosis
      • New permissible value: Endometroid carcinoma with local mucinous differentiation
      • New permissible value: Endosalpingiosis
      • New permissible value: Epithelial dysplasia
      • New permissible value: Epithelial hyperplasia
      • New permissible value: Gallbladder adenomyomatosis
      • New permissible value: Glomerular disease
      • New permissible value: Hyperkeratosis
      • New permissible value: Inflammation
      • New permissible value: Intestinal metaplasia
      • New permissible value: Keratinizing dysplasia; mild
      • New permissible value: Keratinizing dysplasia; moderate
      • New permissible value: Keratinizing dysplasia; severe (carcinoma in situ)
      • New permissible value: Leiomyoma
      • New permissible value: Leiomyomata w/ degenerative changes
      • New permissible value: Nonkeratinizing dysplasia; mild
      • New permissible value: Nonkeratinizing dysplasia; moderate
      • New permissible value: Nonkeratinizing dysplasia; severe (carcinoma in situ)
      • New permissible value: Other
      • New permissible value: PD-L1 CPS (223C LDT) - 20%
      • New permissible value: Platinum-resistant
      • New permissible value: Pleural plaque
      • New permissible value: Pulmonary interstitial fibrosis
      • New permissible value: Sialadenitis
      • New permissible value: Sinonasal papilloma
      • New permissible value: Squamous metaplasia
      • New permissible value: Squamous papilloma; solitary
      • New permissible value: Squamous papillomatosis
      • New permissible value: Tubular (papillary) adenoma(s)
      • New permissible value: Tumor-associated lymphoid proliferation
      • New permissible value: Tumor has rough spikey edges
      • Removed permissible value: Pleurodesis, Talc
      • Removed permissible value: Pleurodesis, NOS
  • Altered diagnosis Entity
    • primary_disease field changed to diagnosis_is_primary_disease for clarity.
  • Altered treatment Entity
    • Changes made to treatment_type
      • New permissible value: Pleurodesis, Talc
      • New permissible value: Pleurodesis, NOS
  • Altered molecular_test Entity
    • Changes made to test_units
      • New permissible value: mm^2
      • New permissible value: ng/mL
      • New permissible value: percent
      • New permissible value: count x10^9/L

Known Issues and Workarounds

  • The mitotic_count field in diagnosis is erroneously set as "deprecated" and does not appear in the dictionary viewer. This field can be uploaded successfully without issue and will appear in the dictionary viewer at a later release.

v2.4.0

  • GDC Product: GDC Data Dictionary
  • Release Date: June 21, 2021

New Features and Changes

  • Added min-max limitations on property values in demographic, portion, aliquot, family_history, slide, follow_up, read_group, sample, analyte, exposure, diagnosis, treatment, molecular_test
  • Altered submitted_unaligned_reads, submitted_aligned_reads, annotated_somatic_mutation, simple_somatic_mutation, masked_somatic_mutation, submitted_genomic_profile, aligned_reads, aggregated_somatic_mutation, simple_germline_variation Entities
    • Changes made to experimental_strategy
      • Removed permissible value: Low Pass WGS
  • Altered follow_up Entity
    • New property: eye_color
    • New property: history_of_tumor
    • New property: history_of_tumor_type
    • New property: undescended_testis_corrected
    • New property: undescended_testis_corrected_age
    • New property: undescended_testis_corrected_laterality
    • New property: undescended_testis_corrected_method
    • New property: undescended_testis_history
    • New property: undescended_testis_history_laterality
    • Changes made to comorbidity
      • New permissible value: Dermatomyosis
      • New permissible value: Herpes Zoster
      • New permissible value: Varicella Zoster Virus
    • Changes made to risk_factor
      • New permissible value: Dermatomyosis
      • New permissible value: Herpes Zoster
      • New permissible value: Varicella Zoster Virus
  • Altered read_group Entity
    • Changes made to instrument_model
      • New permissible value: Illumina NovaSeq 6000
    • Changes made to single_cell_library
      • New permissible value: Chromium scATAC v1 Library
    • Changes made to target_capture_kit
      • New permissible value: Twist Human Comprehensive Exome
  • Altered somatic_aggregation_workflow Entity
    • Added link: simple_somatic_mutations
    • Changes made to workflow_type
      • New permissible value: CaVEMan Variant Aggregation and Masking
  • Altered sample Entity
    • Changes made to sample_type
      • New permissible value: Next Generation Cancer Model Expanded Under Non-conforming Conditions
    • Changes made to sample_type_id
      • New permissible value: 87
  • Altered germline_mutation_calling_workflow Entity
    • New link: submitted_genotyping_arrays
    • Changes made to workflow_type
      • New permissible value: Birdseed
  • Altered slide_image Entity
    • Changes made to data_format
      • New permissible value: JPEG 2000
  • Altered exposure Entity
    • New property: exposure_duration_years
    • New property: parent_with_radiation_exposure
    • Changes made to exposure_type
      • New permissible value: Radiation
  • Altered simple_germline_variation Entity
    • New property: platform
    • Changes made to data_format
      • New permissible value: TSV
  • Altered pathology_detail Entity
    • New property: consistent_pathology_review
    • New property: residual_tumor
    • New property: size_extraocular_nodule
    • New property: tumor_thickness
  • Altered diagnosis Entity
    • New property: adrenal_hormone
    • New property: primary_disease
    • Changes made to ajcc_pathologic_stage
      • New permissible value: Stage IIIA1
      • New permissible value: Stage IIIA2
    • Changes made to metastasis_at_diagnosis_site
      • New permissible value: Bladder
      • New permissible value: Bronchus
      • New permissible value: Head, Face or Neck, NOS
      • New permissible value: Lymph Node, Regional
      • New permissible value: Lymph Node, Subcarinal
    • Changes made to method_of_diagnosis
      • New permissible value: Exoresection
    • Changes made to morphology
      • New permissible value: 8246/6
      • New permissible value: 8380/6
      • New permissible value: 8461/6
      • New permissible value: 8522/6
    • Changes made to sites_of_involvement
      • New permissible value: Mesothelium
  • Altered treatment Entity
    • New property: route_of_administration
    • Changes made to treatment_arm
      • New permissible value: A081801
    • Changes made to therapeutic_agents
      • New permissible value: Interferon Alfa-2B
      • New permissible value: Levoleucovorin Calcium
      • New permissible value: Mistletoe Extract
  • Altered somatic_mutation_calling_workflow Entity
    • Changes made to workflow_type
      • New permissible value: Strelka2 RNA
  • Altered molecular_test Entity
    • New property: days_to_test
    • New link: diagnoses
    • Changes made to antigen
      • New permissible value: FMC-7
      • New permissible value: Kappa, Surface
      • New permissible value: Lambda, Surface
    • Changes made to gene_symbol
      • New permissible value: AQP1
      • New permissible value: CALB2
      • New permissible value: DNTT
      • New permissible value: EPCAM
      • New permissible value: GCET1
      • New permissible value: PDPN
      • New permissible value: PTGS2
    • Changes made to laboratory_test
      • New permissible value: BG8
      • New permissible value: Circulating Endothelial Cells
      • New permissible value: Cytokeratin 5
      • New permissible value: Cytokeratin 6
      • New permissible value: Dopamine-Secreting
      • New permissible value: Epinephrine-Secreting
      • New permissible value: Metanephrine-Secreting
      • New permissible value: Methoxytyramine-Secreting
      • New permissible value: Microsatellite Instability
      • New permissible value: Norepinephrine-Secreting
      • New permissible value: Normetanephrine-Secreting
      • New permissible value: Serum Mesothelin
      • New permissible value: TAG-72

Known Issues and Workarounds

  • The mitotic_count field in diagnosis is erroneously set as "deprecated" and does not appear in the dictionary viewer. This field can be uploaded successfully without issue and will appear in the dictionary viewer at a later release.

v2.3.0

  • GDC Product: GDC Data Dictionary
  • Release Date: January 5, 2021

New Features and Changes

  • Altered submitted_unaligned_reads Entity
    • Changes made to experimental_strategy
      • New permissible value: HiChIP
      • New permissible value: m6A RNA Methylation
      • New permissible value: scATAC-Seq
    • Changes made to read_pair_number
      • New permissible value: R3
  • Altered submitted_aligned_reads Entity
    • Changes made to experimental_strategy
      • New permissible value: HiChIP
      • New permissible value: m6A RNA Methylation
      • New permissible value: scATAC-Seq
  • Altered follow_up Entity
    • Changes made to comorbidity
      • New permissible value: Abnormal Glucose Level
      • New permissible value: Chronic Fatigue Syndrome
      • New permissible value: Clonal Hematopoiesis
      • New permissible value: Fibromyalgia
      • New permissible value: Gastritis
    • Changes made to risk_factor
      • New permissible value: Abnormal Glucose Level
      • New permissible value: Chronic Kidney Disease
      • New permissible value: Escherichia coli
      • New permissible value: Gastritis
      • New permissible value: Skin Rash
  • New Entity: masked_methylation_array
  • Altered read_group Entity
    • New property: chipseq_antibody
    • New property: fragmentation_enzyme
    • Removed property: RIN
    • Changes made to library_strategy
      • New permissible value: HiChIP
      • New permissible value: m6A RNA Methylation
      • New permissible value: scATAC-Seq
  • Altered sample Entity
    • New property: sample_ordinal
    • Changes made to composition
      • New permissible value: Mixed Adherent Suspension
  • Altered analyte Entity
    • New property: experimental_protocol_type
    • New property: rna_integrity_number
  • Altered pathology_detail Entity
    • New property: additional_pathology_findings
    • New property: necrosis_percent
    • New property: necrosis_present
    • New property: rhabdoid_percent
    • New property: rhabdoid_present
    • New property: sarcomatoid_percent
    • New property: sarcomatoid_present
    • Changes made to dysplasia_degree
      • New permissible value: Mild
      • New permissible value: Moderate
      • New permissible value: Severe
    • Changes made to dysplasia_type
      • New permissible value: Epithelial
      • New permissible value: Keratinizing
      • New permissible value: Nonkeratinizing
    • Changes made to lymph_node_involvement
  • Altered diagnosis Entity
    • New property: ann_arbor_b_symptoms_described
    • Changes made to ajcc_clinical_stage
      • New permissible value: Stage IA3
    • Changes made to ajcc_pathologic_m
      • New permissible value: M1d
    • Changes made to metastasis_at_diagnosis_site
      • New permissible value: Gastrointestinal Tract
      • New permissible value: Heart
      • New permissible value: Neck
      • New permissible value: Retroperitoneum
      • New permissible value: Urethra
      • New permissible value: Uterine Adnexa
      • New permissible value: Vertebral Canal
      • New permissible value: Vulva, NOS
    • Changes made to morphology
      • New permissible value: 8249/6
      • New permissible value: 8800/6
    • Changes made to supratentorial_localization
      • New permissible value: Frontal lobe
      • New permissible value: Occipital lobe
      • New permissible value: Parietal lobe
      • New permissible value: Temporal lobe
  • Altered treatment Entity
    • Changes made to treatment_dose_units
      • New permissible value: mg
    • Changes made to treatment_type
      • New permissible value: Radiation, Hypofractionated
      • New permissible value: Radiation, Mixed Photon Beam
      • New permissible value: Radiation, Photon Beam
    • Changes made to therapeutic_agents
      • Updated enum list.
  • Altered case Entity
    • Updated disease_type and primary_site enum values.
  • Altered rna_expression_workflow Entity
    • Changes made to workflow_type
      • New permissible value: STAR - Smart-Seq2 Raw Counts
      • New permissible value: STAR - Smart-Seq2 Filtered Counts
  • Altered molecular_test Entity
    • New link: slides
    • Changes made to antigen
      • New permissible value: Ki67
    • Changes made to gene_symbol
      • New permissible value: CHGA
      • New permissible value: SYP
    • Changes made to molecular_consequence
      • New permissible value: Exon Variant
    • Changes made to second_gene_symbol
      • New permissible value: CHGA
      • New permissible value: SYP
  • Altered aligned_reads Entity
    • Changes made to experimental_strategy
      • New permissible value: HiChIP
      • New permissible value: scATAC-Seq

Bugs Fixed Since Last Release

  • None

v2.2.0

  • GDC Product: GDC Data Dictionary
  • Release Date: July 2, 2020

New Features and Changes

  • Added NCIt codes associated with enumeration values in diagnosis entity type
  • Added pathology_detail entity
  • Modified treatment entity
    • Added new enumerations for therapeutic_agents property
      • Itraconazole
      • Tipiracil
      • Tipiracil Hydrochloride
      • Zirconium Zr 89 Panitumumab
      • Estradiol mustard
      • Progestational IUD
      • PD-1 Inhibitor
      • IGF-1R Inhibitor
      • CDK4/6 Inhibitor
      • ALK Inhibitor
  • Modified annotation entity
    • Added many_to_many link to copy_number_estimate entity
  • Modified diagnosis entity
    • Added new properties:
      • eln_risk_classification
      • satellite_nodule_present
      • who_cns_grade
      • who_nte_grade
      • sites_of_involvement
    • Added new permissible values to ajcc_pathologic_stage property
      • Stage IA3
    • Added new permissible values to classification_of_tumor property
      • Progression
    • Added new permissible values to metastasis_at_diagnosis_site property
      • Esophagus
    • Added new permissible values to morphology property
    • Removed properties as required
      • days_to_last_follow_up
      • tumor_grade
      • progression_or_recurrence
      • days_to_recurrence
      • days_to_last_known_disease_status
      • last_known_disease_status
    • Deprecated properties
      • mitotic_count
      • papillary_renal_cell_type
      • micropapillary_features
      • non_nodal_regional_disease
      • non_nodal_tumor_deposits
  • Modified sample entity
    • Changed description of properties
      • days_to_collection
      • days_to_sample_procurement
    • Deprecated properties
      • is_ffpe
      • oct_embedded
    • Added new permissible values to sample_type property
      • Mixed Adherent Suspension Saliva
  • Modified follow_up entity
    • Added new properties
      • procedures_performed
      • hormonal_contraceptive_type
      • hormone_replacement_therapy_type
    • Added new permissible values to comorbidity property
    • Added new permissible values to risk_factor property
    • Added new permissible values to evidence_of_recurrence_type property
    • Added new permissible values to aids_risk_factors property
  • Modified exposure entity
    • Added new properties
      • smokeless_tobacco_quit_age
      • alcohol_type
    • Added new permissible values to exposure_type property
      • Wood Dust
      • Smoke
    • Added new permissible value to type_of_smoke_exposure property
      • Tobacco smoke, NOS
  • Modified submitted_unaligned_reads property
    • Removed permissible value from read_pair_number property
      • I1
  • Modified aliquot entity
    • Added new permissible value to analyte_type property
      • Nuclei RNA
  • Modified rna_expression_workflow entity
    • Removed permissible value from workflow_type property
      • STAR - Smart-Seq2 Counts
    • Added new permissible values to workflow_type property
      • STAR - Smart-Seq2 Gene Counts
      • STAR - Smart-Seq2 GeneFull Counts
  • Modified molecular_test entity
    • Added new properties
      • mitotic_count
      • mitotic_total_area
      • biospecimen_volume
    • Added new permissible values to gene_symbol property
    • Added new permissible values to second_gene_symbol property
    • Added new permissible values to antigen property
    • Added new permissible values to laboratory_test property

Bugs Fixed Since Last Release

  • None

v2.1.0

  • GDC Product: GDC Data Dictionary
  • Release Date: March 10, 2020

New Features and Changes

  • Added NCIt codes associated with enumeration values in exposure, family_history, and demographic entity types
  • Restructured dictionary for consistency across types
  • read_group entity
  • Added 5 new target capture kits
    • Custom Twist Broad PanCancer Panel - 396 Genes
    • Nextera DNA Exome
    • Custom Twist Broad Exome v1.0 - 35.0 Mb
    • Custom SureSelect CGCI-HTMCP-CC KMT2D And Hotspot Panel - 37.0 Kb
    • TruSeq RNA Exome
  • Add one new enum to library_strategy
    • scRNA-Seq
  • structural_variation entity
  • Added VCF to data_format property
  • Added links to structural_variation from somatic_mutation_index
  • Added links to aligned_reads from somatic_copy_number workflow
  • copy_number_segment entity
  • Added new permissible values to experimental_strategy property
    • WGS
    • WXS
  • Added new enum to experimental_strategy
    • WGS
  • aligned_reads entity
  • Added 2 new properties
    • tumor_ploidy
    • tumor_purity
  • treatment entity
  • Added enumeration to therapeutic_agent property
  • copy_number_estimate entity
  • Added new enum to data_format
    • TSV
  • demographic entity
  • Added new property country_of_residence_at_enrollment
  • family_history entity
  • Added new permissible values to relationship_primary_diagnosis property
  • follow_up entity
  • Added new properties
    • body_surface_area
    • recist_targeted_regions_number
    • recist_targeted_regions_sum
    • adverse_event_grade
    • cd4_count
    • imaging_type
    • scan_tracer_used
    • nadir_cd4_count
    • hiv_viral_load
    • aids_risk_factors
    • haart_treatment_indicator
    • immunosuppressive_treatment_type
    • evidence_of_recurrence_type
    • imaging_result
    • hormonal_contraceptive_use
    • pregnancy_outcome
    • hysterectomy_type
    • hysterectomy_margins_involved
    • days_to_imaging
    • cdc_hiv_risk_factors
    • risk_factor
  • Added new enum to days_to_follow_up
    • null
  • molecular_test entity
  • Added new permissible values to various properties
    • laboratory_test
    • second_gene_symbol
    • molecular_consequence
    • biospecimen_type
    • molecular_analysis_method
    • gene_symbol
    • clonality
  • sample entity
  • Added new permissible values to various properties
    • method_of_sample_procurement
    • biospecimen_anatomic_site
    • tumor_descriptor
  • Added new property
    • tissue_collection_type
  • treatment entity
  • Added new properties
    • treatment_arm
    • reason_treatment_ended
    • number_of_cycles
    • treatment_effect_indicator
    • treatment_dose
    • treatment_dose_units
    • treatment_frequency
    • chemo_concurent_to_radiation
  • Added new permissible values to various properties
    • therapeutic_agent
    • treatment_effect
    • treatment_intent_type
  • slide entity
  • Added new properties
    • percent_sarcomatoid_features
    • percent_rhabdoid_features
    • prostatic_chips_total_count
    • prostatic_chips_positive_count
    • prostatic_involvement_percent
    • bone_marrow_malignant_cells
    • percent_follicular_component
    • tissue_microarray_coordinates
  • diagnosis entity
  • Added new properties
    • tumor_depth
    • margin_distance
    • transglottic_extension
    • margins_involved_site
    • gleason_grade_tertiary
    • papillary_renal_cell_type
    • gleason_patterns_percent
    • greatest_tumor_dimension
    • lymph_node_involved_site
    • pregnant_at_diagnosis
    • figo_staging_edition_year
  • Added new permissible values to various properties
    • classification_of_tumor
    • figo_stage
    • tumor_grade
    • metastasis_at_diagnosis_site
    • gleason_grade_group
    • tissue_or_organ_of_origin
    • morphology
  • exposure entity
  • Added new properties
    • secondhand_smoke_as_child
    • exposure_type
    • type_of_tobacco_used
    • exposure_duration
    • tobacco_use_per_day
    • age_at_onset
    • marijuana_use_per_week
    • tobacco_smoking_status
  • case entity
  • Added new properties
    • consent_type
    • days_to_consent
  • Added new permissible values to index_date
  • Added scRNA-Seq as new enum to experimental_strategy in 4 entities
    • submitted_unaligned_reads
    • submitted_aligned_reads
    • aligned_reads
    • gene_expression
  • Added 3 new permissible values to workflow_type in alignment_workflow
    • CellRanger - 10x Chromium
    • STAR - Smart-Seq2
    • zUMIs - Smart-Seq2
  • Added 4 new permissible values to workflow_type in rna_expression_workflow
    • CellRanger - 10x Raw Counts
    • CellRanger - 10x Filtered Counts
    • STAR - Smart-Seq2 Counts
    • zUMIs - Smart-Seq2 Counts
  • Add one new integer property to read_group
    • number_expect_cells
  • Add one new enum to read_pair_number in submitted_unaligned_reads
    • I1
  • Add one new enum property in read_group node
    • Chromium 3' Gene Expression v2 Library
    • Chromium 3' Gene Expression v3 Library
    • Smart-Seq2
  • Created new node expression_analysis_workflow
  • Created new node secondary_expression_analysis
  • Add one new enum to data_format in gene_expression
    • MEX

Bugs Fixed Since Last Release

  • None

v2.0.0

  • GDC Product: GDC Data Dictionary
  • Release Date: January 30, 2020

New Features and Changes

  • The API that includes the GDC data dictionary now uses Python 3.

Bugs Fixed Since Last Release

  • None

v.1.18.1

  • GDC Product: GDC Data Dictionary
  • Release Date: November 6, 2019

New Features and Changes

  • Added new permissible value deleted to property file_state

Bugs Fixed Since Last Release

  • None

v.1.18

  • GDC Product: GDC Data Dictionary
  • Release Date: July 31, 2019

New Features and Changes

  • Added new entities
    • protein_expression_quantification
    • submitted_genotyping_array
    • somatic_copy_number_workflow
  • Add links in data model to somatic_copy_number_workflow from copy_number_segment
  • Add links in data model to somatic_copy_number_workflow from copy_number_estimate
  • Add links in data model from annotated_somatic_mutation to genomic_profile_harmonization_workflow
  • Modified copy_number_segment entity
    • Add new data type
      • Allele-specific Copy Number Segment
  • Update data dictionary to support new annotation classifications
  • Fixed typo in sample entity schema
  • Unrequired project link for aliquot level MAFs
  • Added NCIt codes for gender values
  • Changed description of masked_somatic_mutation and aggregated_somatic_mutation nodes to be the same
  • Modified archive entity
    • Set downloadable property to true
  • Modified publication entity
    • Set downloadable property to true
  • Modified filtered_copy_number_segment entity
    • Set downloadable property to true
  • Modified aligned_reads entity
    • Added MSI properties as new property
  • Modified read_group entity
    • Added Custom SureSelect Human All Exon v1.1 Plus 3 Boosters as new permissible value for target_capture_kit field
    • Added SeqCap EZ Human Exome v3.0 as new permissible value for target_capture_kit field
    • Added new permissible values for instrument_model
      • Unknown
      • Not Reported
      • Ion Torrent S5
  • Modified biospecimen_supplement entity
    • Added CDC JSON as new permissible data format
  • Modified demographic entity
    • Added new property
      • age_is_obfuscated
  • Modified demographic entity
    • Added new properties
      • cause_of_death_source
      • occupation_duration_years
  • Modified diagnosis entity
    • Added new properties
      • non_nodal_regional_disease
      • non_nodal_tumor_deposits
      • ovarian_specimen_status
      • ovarian_surface_involvement
      • percent_tumor_invasion
      • peritoneal_fluid_cytological_status
      • breslow_thickness
      • international_prognostic_index
      • largest_extrapelvic_peritoneal_focus
      • mitotic_count
    • Removed permissible values from primary_diagnosis
    • Removed permissible values from site_of_resection_or_biopsy
    • Removed tumor_stage as required property
    • Added new permissible values for
      • ajcc_pathologic_stage
      • metastasis_at_diagnosis_site
    • Migrated values not part of permissible values to Not Reported for following properties
      • primary_diagnosis
      • site_of_resection_or_biopsy
      • tumor_grade
      • tissue_or_organ_of_origin
    • Removed permissible values from
      • tissue_or_organ_of_origin
      • morphology
  • Modified structural_variant_calling_workflow entity
    • Added new workflow_type
  • Modified structural_variant entity
    • Added BEDPE to data_format as permissible value
  • Modified molecular_test entity
    • Added new permissible values for gene_symbol
    • Added new permissible values for test_result
    • Added new permissible values for antigen
    • Added new property pathogenicity
  • Modified follow_up entity
    • Added new permissible value for risk_factor
  • Modified sample entity
    • Added new permissible values for method_of_sample_procurement
  • Modified genomic_profile_harmonization_workflow entity
    • Added new workflow_type permissible values
  • Modified somatic_mutation_calling_workflow entity
    • Added new workflow_type permissible values
    • Modified somatic_annotation_workflow entity
    • Added new workflow_type permissible values
  • Modified case entity
    • Added new permissible value to disease_type
      • Not Applicable
  • Modified copy_number_estimate entity
    • Added new permissible value to experimental_strategy
      • WXS
  • Modified family_history entity
    • Added new property
      • relatives_with_cancer_history_count
  • Modified sample entity
    • Added new permissible values
      • sample_type
      • sample_type_id

Bugs Fixed Since Last Release

  • None

v.1.17

  • GDC Product: GDC Data Dictionary
  • Release Date: June 5, 2019

New Features and Changes

  • Deleted vital status, days_to_birth, and days_to_death from Diagnosis node. Data submission and data requests should all be directed to the corresponding properties on the Demographic Node.

Bugs Fixed Since Last Release

  • None

v.1.16

  • GDC Product: GDC Data Dictionary
  • Release Date: April 17, 2019

New Features and Changes

  • Updates to the Data Dictionary Search Tool
  • Added new bioinformatics workflow for methylation arrays (Sesame)
  • Changed somatic_mutation_calling_workflow link from one_to_many to many_to_many
  • Modified read_group entity
    • Added SeqCap EZ Human Exome v2.0 as new permissible value for target_capture_kit field
    • Added Custom SureSelect Human All Exon v1.1 Plus 3 Boosters as new permissible value target_capture_kit field
    • Added Custom SureSelect CGCI-HTMCP-CC Panel - 19.7 Mb as new permissible value target_capture_kit field
  • Modified case entity
    • Updated the description for the primary_site field
    • Added new permissible value to lost_to_followup field
  • Modified molecular_test entity
    • Removed properties with genomic coordinates
    • Add new permissible values to test_result
    • Added second_exon as new property
  • Modified aligned_reads_index entity
    • Made these files not submittable
  • Modified somatic_mutation_index entity
    • Made these files not submittable
  • Modified sample entity
    • Added new permissible values for sample_type
      • Blood Derived Cancer - Bone Marrow
      • Blood Derived Cancer - Peripheral Blood
    • Added new permissible values to sample_type_id
  • Modified diagnosis entity
    • Added 6 new staging and grading properties for TCGA
      • igcccg_stage
      • masaoka_stage
      • gleason_grade_group
      • primary_gleason_grade
      • secondary_gleason_grade
      • weiss_assessment_score
    • Made vital_status an optional field
    • Removed deprecated properties
      • days_to_death
      • days_to_birth
      • cause_of_death
      • hiv_positive
      • days_to_hiv_diagnosis
      • ldh_normal_range_upper
      • new_event_type
      • hpv_status
      • hpv_positive_type
      • colon_polyps_history
      • progression_free_survival
      • progression_free_survival_event
      • overall_survival
      • days_to_treatment
      • ldh_level_at_diagnosis
    • Added vital_status property to deprecated list
  • Modified somatic_aggregation_workflow entity
    • Added Aliquot Ensemble Somatic Variant Merging and Masking as new permissible value to workflow_type
  • Modified slide entity
    • Updated the description for the magnification field
  • Modified aliquot entity
    • Updated the the description for several fields
      • selected_normal_low_pass_wgs
      • selected_normal_targeted_sequencing
      • selected_normal_wgs
      • selected_normal_wxs
  • Modified follow-up entity
    • Added new field days_to_progression_free
  • Modified demographic entity
    • Made vital_status a required field
  • Modified exposure entity
    • Added new properties
      • environmental_tobacco_smoke_exposure
      • respirable_crystalline_silica_exposure
      • coal_dust_exposure
      • type_of_smoke_exposure
      • type_of_tobacco_used
      • smoking_frequency
      • time_between_waking_and_first_smoke
    • Removed cigarettes_per_day property from deprecated list
  • Modified annotation entity
    • Modified permissible values to status
      • Approved
      • Rescinded

Bugs Fixed Since Last Release

  • None

v.1.15

  • GDC Product: GDC Data Dictionary
  • Release Date: December 18, 2018

New Features and Changes

  • Removed Raw Sequencing Data and Sequencing Data as permissible values from submitted_aligned_reads, submitted_unaligned_reads, and aligned_reads
  • Deleted aligned_reads_metrics entity
  • Created new raw_methylation_array entity
  • Add regex validation to property md5sum for following entities:
    • slide_image
    • analysis_metadata
    • clinical_supplement
    • experiment_metadata
    • pathology_report
    • run_metadata
    • biospecimen_supplement
    • submitted_aligned_reads
    • submitted_genomic_profile
    • submitted_methylation_beta_value
    • submitted_tangent_copy_number
    • submitted_unaligned_reads
  • Modified molecular_test entity
    • Migrated data from blood_test to laboratory_test and biospecimen_type for all entities
    • Added new property intron
    • Deleted blood_test entity
    • Added new permissible values for gene_symbol
    • Added new permissible values for antigen
    • Added new permissible values for molecular_analysis_method
    • Added new permissible values for variant_type
    • Added new permissible values for test_result
    • Added new permissible values for molecular_consequence
    • Added regex validation to property transcript
    • Added regex validation to property locus
    • Changed data type of exon property to be string with regex validation
  • Modified diagnosis entity
    • Added new fields
    • tumor_focality
    • tumor_regression_grade
    • lymph_nodes_tested
    • Added new permissible value for primary_diagnosis field
    • Added min and max values to time-based properties
    • Added new permissible value for morphology field
  • Modified follow_up entity
    • Added new permissible values for ecog_performance_status
    • Added new permissible values for comorbidity
    • Added new permissible values for disease_response
    • Added new permissible values for risk_factor
    • Added min and max values to time-based properties
    • Added new property:
    • hepatitis_sustained_virological_response
    • Updated CDE, CDE version, description and URL for comorbidity
    • Added a CDE for days_to_comorbidity
    • Removed reflux_treatment property
    • Add a new property:
    • risk_factor_treatment
  • Modified aligned_reads entity
  • Added new contamination properties
    • contamination
    • contamination_error
  • Modified read_group entity
  • Added new permissible values for target_capture_kit
  • Updated description for property instrument_model
  • Added new permissible values for target_capture_kit
  • Added new permissible values for library_strategy
  • Added regex validation to property adapter_sequence
  • Added regex validation to property multiplex_barcode
  • Allow users to enter null for property read_length
  • Allow users to enter null for property is_paired_end
  • Modified family_history entity
  • Added new permissible values for relationship_primary_diagnosis
  • Added min and max values to properties
  • Modified case entity
  • Add min and max values to properties
  • Delete permissible value from primary_site
    • Unknown Primary Site
  • Modified analyte entity
  • Corrected the description for fields analyte_volume to include microliters as unit
  • Modified exposure entity
  • Added new properties
    • asbestos_exposure
    • radon_exposure
  • Modified sample entity
  • Added new permissible values to method_of_sample_procurement
  • Added regex validation to pathology_report_uuid
  • Change type from string to number for properties:
    • intermediate_dimension
    • longest_dimension
    • shortest_dimension
    • time_between_clamping_and_freezing
    • time_between_excision_and_freezing
  • Add min and max to properties on the sample node
  • Populated sample nodes that have no value for tissue_type to "Not Reported"
  • Modified treatment entity
  • Added a new property
    • prior_treatment_effect
  • Add min and max values to properties
  • Modified aliquot entity
  • Corrected the description for fields analyte_volume to include microliters as unit
  • Modified demographic entity
  • Added min and max to properties

Bugs Fixed Since Last Release

  • Fixed value of pathology_report_uuid on sample entity 7b29b034-86e4-4266-8657-036e96e04430 to satisfy regex requirements
  • Migrated a few unsupported values for sample.pathology_report_uuid, read_group.adapter_sequence, read_group.multiplex_barcode

v.1.14

  • GDC Product: GDC Data Dictionary
  • Release Date: September 27, 2018

New Features and Changes

  • Added description and type information to generic properties
  • Modify the dictionary viewer to be case sensitive for deprecated fields
  • Deleted sample_level_maf entity
  • Added new field for all nodes:
    • previous_versions_downloadable
  • Modified molecular_test entity
    • Migrated data from blood_test to laboratory_test and biospecimen_type
    • Added new fields:
      • laboratory_test
      • biospecimen_type
    • Added new permissible values for gene_symbol fields
      • Not Applicable
    • Deleted field blood_test
    • Added new permissible values for antigen field
    • Added new permissible values to molecular_analysis_method
    • Added new permissible values for variant_type field
    • Added new permissible values to test_result
  • Modified case entity
    • Modified permissible values on index_date
      • Added new value Initial Genomic Sequencing
    • Updated CDE codes for properties
    • Add new permissible value to index_date
      • Sample Procurement
  • Modified aliquot entity
    • Changed exclusive to True
  • Modified read_group_qc entity
    • Made following fields not required and added Unknown/Not Reported as permissible values:
      • adapter_content
      • basic_statistics
      • encoding
      • kmer_content
      • overrepresented_sequences
      • per_base_sequence_quality
      • per_tile_sequence_quality
      • per_sequence_quality_score
      • per_base_sequence_content
      • per_sequence_gc_content
      • per_base_n_content
      • percent_gc_content
      • sequence_length_distribution
      • sequence_duplication_levels
      • total_sequences
  • Modified aligned_reads entity
    • Added new permissible values to experimental_strategy field
      • Targeted Sequencing
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
  • Modified read_group entity
    • Added new field days_to_sequencing
    • Add new permissible values to target_capture_kit
      • Custom Personalis ACEcp VAREPOP-APOLLO Panel v2
      • xGen Exome Research Panel v1.0
      • SureSelect Human All Exon v5 + UTR
  • Modified treatment entity
    • Updated CDE codes for properties
    • Updated description for treatment_or_therapy
    • Updated description for therapeutic_agents
    • Added new field:
      • initial_disease_status
    • Updated permissible values for treatment_type
    • Added new permissible values for treatment_outcome
      • No Measurable Disease
      • Persistent Disease
    • Deleted values from treatment_intent_type
  • Modified annotated_somatic_mutation entity
    • Added new permissible values to experimental_strategy field
      • RNA-Seq
      • miRNA-Seq
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
    • Add new permissible value to data_format
      • MAF
    • Add new permissible value to data_type
      • Masked Annotated Somatic Mutation
  • Modified masked_somatic_mutation entity
    • Added new permissible values to experimental_strategy field
      • RNA-Seq
      • miRNA-Seq
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
    • Removed Validation as permissible from experimental_strategy
  • Modified simple_germlne_variation entity
    • Added new permissible values to experimental_strategy field
      • RNA-Seq
      • miRNA-Seq
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
  • Modified simple_somatic_mutation entity
    • Added new permissible values to experimental_strategy field
      • RNA-Seq
      • miRNA-Seq
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
  • Modified submitted_genomic_profile entity
    • Added new permissible values to experimental_strategy field
      • WXS
      • Low Pass WGS
      • RNA-Seq
      • miRNA-Seq
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
  • Modified diagnosis entity
    • Updated CDE codes for properties
    • Corrected the reference to ubiquitous_properties
    • Deleted permissible values from vascular_invasion_present field
      • Extramural
      • Intramural
    • Added permissible value to ajcc_clinical_stage
      • Stage IIIC1
    • Added permissible values to method_of_diagnosis
      • Imaging
      • Physical Exam
      • Pathologic Review
    • Added permissible value to vascular_invasion_type
      • Extramural
      • Intramural
    • Added permissible value to metastasis_at_diagnosis_site
    • Updated deprecated values list
    • Deleted field ldh_level
  • Modified follow_up entity
    • Updated CDE codes for properties
    • Added permissible value to progression_or_recurrence_type
      • Biochemical
    • Added permissible values to hpv_positive_type
      • 63
      • 70
    • Added permissible value to disease_response
      • BED-Biochemical Evidence of Disease
      • PDM-Persistent Distant Metastasis
      • PLD-Persistent Locoregional Disease
      • TF-Tumor Free
      • WT-With Tumor
    • Added permissible value to comorbidity
      • Hepatitis A Infection
      • Herpes
    • Added permissible values to risk_factor field
  • Modified demographic entity
    • Updated CDE codes for properties
    • Modified permissible values for cause_of_death field
      • Cardiovascular Disorder, NOS
      • Renal Disorder, NOS
      • Surgical Complications
    • Updated days_to descriptions
  • Modified family_history entity
    • Updated CDE codes for properties
    • Added new fields:
      • relationship_primary_diagnosis
      • relationship_gender
    • Updated CDE for field relative_with_cancer_history
  • Modified submitted_unaligned_reads entity
    • Make field read_pair_number required
    • Added permissible values to read_pair_number
      • Not Applicable
  • Modified aligned_reads entity
    • Added new fields:
      • average_base_quality
      • average_insert_size
      • average_read_length
      • mean_coverage
      • pairs_on_diff_chr
      • proportion_base_mismatch
      • proportion_coverage_10X
      • proportion_coverage_30X
      • proportion_reads_duplicated
      • proportion_reads_mapped
      • proportion_targets_no_coverage
      • total_reads
    • Changed nodes with experimental_strategy as Validation to Targeted Sequencing
  • Modified sample entity
    • Made tissue_type a required field
    • Populated tissue_type with Not Reported for all nodes with no value
  • Modified alignment_workflow entity
    • Added new field to workflow_type
      • STAR 2-Pass Chimeric
  • Modified rna_expression_workflow entity
    • Added new field to workflow_type
      • STAR - FPKM
  • Modified gene_expression entity
    • Add new permissible value to data_type
      • Splice Junction Quantification
  • Modified aggregated_somatic_mutation entity
    • Updated field experimental_strategy
  • Modified somatic_mutation_calling_workflow entity
    • Added workflow_type field
  • Modified somatic_annotation_workflow entity
    • Added workflow_type field

Bugs Fixed Since Last Release

  • None

v.1.13

  • GDC Product: GDC Data Dictionary
  • Release Date: May 21, 2018

New Features and Changes

  • Submitted Genomic Profile to Read Group relationship is updated to be many-to-many
  • Added requirement for submitter_id on additional nodes

Bugs Fixed Since Last Release

  • None

v.1.12.1

  • GDC Product: GDC Data Dictionary
  • Release Date: April 26, 2018

New Features and Changes

  • None

Bugs Fixed Since Last Release

  • Moved read_pair_number from Read Group to Submitted Unaligned Reads node

v.1.12

  • GDC Product: GDC Data Dictionary
  • Release Date: April 23, 2018

New Features and Changes

  • Updates to data dictionary viewer:
    • Data dictionary viewer displays true/false instead of boolean
    • Updated md5 description in data dictionary viewer to be more complete
  • Creation of new entities:
    • Copy Number Estimate entity for copy number variation data
    • Copy Number Variation Workflow entity for copy number variation pipeline metadata
    • Molecular Test entity
  • Updates to all entities:
    • Updated all entities to include batch_id field for submission
    • Updated all entities to include downloadable field
    • Modified all file entities file_size field to be an integer
    • Added support for creation of annotations on all entities in data model
  • Added new links / updated links between entities:
    • Created optional link between follow_up and diagnosis entities
    • Created many-to-many link between genomic_profile_harmonization_workflows and masked_somatic_mutations
    • Remove the restriction that prevents having alignment workflows to point to both submitted_aligned_reads and submitted_unaligned_reads
  • Updated the BCR XML endpoint to support submission of new entity relationships
  • Fixed description of prior_malignancy on diagnosis entity
  • Modified sample entity
    • Added new fields
      • growth_rate
      • passage_count
      • catalog_reference
      • distributor_reference
      • distance_normal_to_tumor
      • biospecimen_laterality
    • Added new permissible values to composition field
      • Sorted Cells
    • Added new permissible value to sample_type field
      • Next Generation Cancer Model
    • Added new permissible values to method_of_sample_procurement field
      • Pancreatectomy
      • Whipple Procedure
      • Paracentesis
    • Added new permissible values to biospecimen_anatomic_site field
      • Esophageal; Distal
      • Esophageal; Mid
      • Esophageal; Proximal
      • Hepatic Flexure
      • Rectosigmoid Junction
    • Removed permissible values on sample_type
      • 2D Classical Conditionally Reprogrammed Cells
      • 2D Modified Conditionally Reprogrammed Cells
      • 3D Organoid
      • 3D Air-Liquid Interface Organoid
      • 3D Neurosphere
      • Adherent Cell Line
      • Liquid Suspension Cell Line
  • Modified aliquot entity
    • Added new fields
      • no_matched_normal_wxs
      • no_matched_normal_wgs
      • no_matched_normal_targeted_sequencing
      • no_matched_normal_low_pass_wgs
  • Modified read_group entity
    • Updated descriptions on read_group entity
    • Added new field
      • target_capture_kit
    • Made library_selection a required field
    • Removed duplicate validators field
    • Modified permissible values on library_selection field
      • Replaced Affinity_Enrichment with Affinity Enrichment
      • Replaced Poly-T_Enrichment with Poly-T Enrichment
      • Replaced Hybrid_Selection with Hybrid Selection
      • Replaced RNA_Depletion with rRNA Depletion
      • Replaced Targeted Sequencing with Hybrid Selection for FM-AD
    • Added new permissible value on library_strand field
      • Not Applicable
    • Removed permissible values in library_strategy field
      • Amplicon
      • Validation
      • Other
  • Modified diagnosis entity
    • Added new fields
      • ajcc_staging_system_edition
      • anaplasia_present
      • anaplasia_present_type
      • child_pugh_classification
      • cog_neuroblastoma_risk_group
      • cog_rhabdomyosarcoma_risk_group
      • enneking_msts_grade
      • enneking_msts_metastasis
      • enneking_msts_stage
      • enneking_msts_tumor_site
      • esophageal_columnar_dysplasia_degree
      • esophageal_columnar_metaplasia_present
      • first_symptom_prior_to_diagnosis
      • gastric_esophageal_junction_involvement
      • goblet_cells_columnar_mucosa_present
      • inpc_grade
      • inss_stage
      • irs_group
      • ishak_fibrosis_score
      • micropapillary_features
      • meduloblastoma_molecular_classification
      • metastasis_at_diagnosis
      • mitosis_karyorrhexis_index
      • peripancreatic_lymph_nodes_positive
      • peripancreatic_lymph_nodes_tested
      • synchronous_malignancy
      • supratentorial_localization
      • tumor_confined_to_organ_of_origin
    • Added new permissible values to vascular_invasion_present field
      • Extramural
      • Intramural
    • Updated ann_arbor_clinical_stage and ann_arbor_pathologic_stage fields
  • Modified aliquot entity
    • Added new fields
      • selected_normal_wxs
      • selected_normal_wgs
      • selected_normal_targeted_sequencing
      • selected_normal_low_pass_wgs
  • Modified project entity
    • Added new fields
      • request_submission
      • in_review
      • submission_enabled
    • Removed duplicate intended_release_date field
    • Made fields not required
      • disease_type
      • primary_site
  • Modified case entity
    • Updated descriptions
      • disease_type
      • primary_site
  • Modified demographic entity
    • Added new fields
      • premature_at_birth
      • weeks_gestation_at_birth
    • Made submitter_id a required field
    • Changed type of year_of_birth from number to integer
    • Changed type of year_of_death from number to integer
  • Modified treatment entity
    • Updated CDE code for treatment_anatomic_site
    • Modified permissible values to treatment_anatomic_site field
    • Made submitter_id a required field
    • Added new permissible value to treatment_intent_type
      • Neoadjuvant
    • Added new permissible value to treatment_outcome
      • Very Good Partial Response
      • Mixed Response
      • No Response
    • Added new permissible value to treatment_type
      • Brachytherapy, High Dose
      • Brachytherapy, Low Dose
      • Radiation, 2D Conventional
      • Radiation, 3D Conformal
      • Radiation, Intensity-Modulated Radiotherapy
      • Radiation, Proton Beam
      • Radiation, Stereotactic Body
      • Radiation Therapy, NOS
      • Stereotactic Radiosurgery
    • Removed field
      • days_to_treatment
    • Removed permissible values for treatment_type
      • Radiation
      • Radiation Therapy
  • Modified analyte entity
    • Removed duplicate project field
  • Modified follow_up entity
    • Added new permissible values to comorbidity field
    • Added new fields
      • progression_or_recurrence_type
      • diabetes_treatment_type
      • reflux_treatment_type
      • barretts_esophagus_goblet_cells_present
      • karnofsky__performance_status
      • menopause_status
      • viral_hepatitis_serologies
      • reflux_treatment
      • pancreatitis_onset_year
      • comorbidity_method_of_diagnosis
      • risk_factor
    • Removed fields
      • absolute_neutrophil
      • albumin
      • beta_2_microglobulin
      • bun
      • calcium
      • cea_level
      • colon_polyps_history
      • creatinine
      • crp
      • days_to_hiv_diagnosis
      • estrogen_receptor_percent_positive_ihc
      • estrogen_receptor_result_ihc
      • glucose
      • hemoglobin
      • her2_erbb2_percent_positive_ihc
      • her2_erbb2_result_fish
      • her2_erbb2_result_ihc
      • hiv_positive
      • hpv_status
      • iga
      • igg
      • igl_kappa
      • igl_lambda
      • igm
      • ldh_level
      • ldh_normal_range_upper
      • m_protein
      • microsatellite_instability_abnormal
      • platelet_count
      • progesterone_receptor_percent_positive_ihc
      • progesterone_receptor_result_ihc
      • total_protein
      • wbc
  • Modified exposure entity
    • Added new fields
      • alcohol_days_per week
      • alcohol_drinks_per_day
  • Added molecular_test entity
    • Added new fields
      • gene_symbol
      • second_gene_symbol
      • test_analyte_type
      • test_result
      • molecular_analysis_method
      • variant_type
      • molecular_consequence
      • chromosome
      • cytoband
      • exon
      • transcript
      • locus
      • dna_change
      • aa_change
      • rna_change
      • zygosity
      • histone_family
      • histone_variant
      • copy_number
      • antigen
      • test_value
      • test_units
      • specialized_molecular_test
      • ploidy
      • cell_count
      • loci_count
      • loci_abnormal_count
      • mismatch_repair_mutation
      • blood_test
      • blood_test_normal_range_upper
      • blood_test_normal_range_lower
  • Modified biospecimen_supplement entity
    • Added new permissible values to data_format field
      • TSV
      • BCR Biotab
      • BCR SSF XML
      • BCR PPS XML
      • FoundationOne XML
      • BCR Auxiliary XML
    • Removed permissible values on data_format field
      • SSF
      • PPS
  • Modified clinical_supplement entity
    • Added new permissible values to data_format field
      • TSV
      • BCR OMF XML
      • BCR Biotab
    • Removed field
      • data_format
  • Modified submitted_aligned_reads entity
    • Added new permissible values to experimental_strategy field
      • Targeted Sequencing
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
    • Removed permissible values from experimental_strategy field
      • Validation
      • Total RNA-Seq
  • Modified submitted_unaligned_reads entity
    • Added new field
      • read_pair_number
    • Added new permissible values to experimental_strategy field
      • Targeted Sequencing
      • Bisulfite-Seq
      • ChIP-Seq
      • ATAC-Seq
  • Modified alignment_workflow entity
    • Added new permissible values to workflow_type field
      • BWA with Mark Duplicates and BQSR
      • BWA with BQSR
  • Modified copy_number_segment entity
    • Removed permissible values for data_type field
      • Gene Level Copy Number
      • Gene Level Copy Number Scores
  • Modified submitted_genomic_profile entity
    • Added new permissible values for data_type
      • Raw GCI Variant
    • Added new permissible values for data_category
      • Combined Nucleotide Variation
    • Added new permissible values for experimental_strategy
      • WGS
    • Added new permissible values for data_format
      • VCF
  • Modified genomic_profile_harmonization_workflow entity
    • Added new permissible value for workflow_type
      • VCF LiftOver
  • Modified simple_somatic_mutation entity
    • Added new permissible values for data_type
      • Raw GCI Variant
    • Added new permissible values for data_category
      • Combined Nucleotide Variation
  • Modified masked_somatic_mutations entity
    • Added new permissible value for experimental_strategy
      • Targeted Sequencing
    • Removed permissible value for experimental_strategy
      • Validation

Bugs Fixed Since Last Release

  • Fixed issue when file_size is specified as a float in submitted json file

v.1.11

  • GDC Product: GDC Data Dictionary
  • Release Date: January 20, 2018

New Features and Changes

  • Added a link between the sample and analyte entities in the data model
  • Added a link between the sample entity and other sample entities in the data model
  • Created structural_variant_calling_workflow entity
  • Created structural_variation entity
  • Removed clinical_test entity
  • Removed exon_expression entity
  • Modified relationships of entities
    • Changed relationship between submitted_genomic_profile and read_group to one-to-many
    • Changed relationship between projects and masked_somatic_mutations from one-to-one to many_to_one
    • Changed relationship between projects and aggregated_somatic_mutations from one-to-one to many_to_one
    • Changed relationship of rna_expression_workflow to downstream entities from one-to-one to one-to-many
    • Changed relationship of alignment_workflow to downstream entities from many-to-one to many-to-many
  • Modified project entity
    • Added new state
      • processed
    • Added new fields
      • release_requested
      • awg_review
      • is_legacy
  • Modified clinical_supplement entity
    • Added new data_format field
      • CDC JSON
  • Modified case entity
    • Enumerated primary_site field
  • Modified diagnosis entity
    • Enumerated fields
      • primary_diagnosis
      • tissue_or_organ_of_origin
      • site_of_resection_or_biopsy
      • tumor_grade
      • morphology
      • ajcc_clinical_stage
      • ajcc_pathologic_stage
      • laterality
      • method_of_diagnosis
    • Changed type of fields
      • year_of_diagnosis: changed type to int
      • age_at_diagnosis: changed type to int
    • Added new permissible values to fields
      • figo_stage
        • Stage IIC
      • lymphatic_invasion_present
        • Not Reported
      • perineural_invasion_present
        • Not Reported
      • ann_arbor_clinical_stage
        • Not Reported
        • Unknown
      • residual_disease
        • Not Reported
        • Unknown
      • vascular_invasion_type
        • Macro
        • Micro
        • No Vascular Invasion
        • Not Reported
        • Unknown
  • Modified exposure entity
    • Enumerated fields
      • alcohol_intensity
      • alcohol_history
      • cause_of_death
    • Removed 6 as a valid field from tobacco_smoking_status
  • Modified demographic entity
    • Enumerated field
      • comorbidity
    • Added new permissible values to field
      • cause_of_death
        • Infection
        • Toxicity
        • Spinal Muscular Atrophy
        • End-stage Renal Disease
  • Modified family history entity
    • Enumerated fields
      • relationship_primary_diagnosis
      • relationship_type
  • Modified treatment entity
    • Enumerated fields
      • treatment_anatomic_site
      • treatment_type
    • Changed type of fields
      • days_to_treatment: changed type to int
      • days_to_treatment_end: changed type to int
      • days_to_treatment_start: changed type to int
  • Modified follow_up entity
    • Enumerated field
      • comorbidity
    • Removed None as valid field from comorbidity
  • Modified demographic entity
    • Added new field
      • age_at_index
  • Modified read_group entity
    • Added new fields
      • fragment_minimum_length
      • fragment_maximum_length
      • fragment_mean_length
      • fragment_standard_deviation_length
  • Modified slide image entity
    • Added new data_formats
      • JPEG and TIFF
    • Added new data_type
      • Cell Culture
    • Added new experimental strategy
      • Cell Culture
    • Added new property
      • Magnification
    • Added new field
      • date_time
  • Modified sample entity
    • Added new permissible values to fields
      • method_of_sample_procurement
        • Autopsy
      • sample_type
        • 2D Classical Conditionally Reprogrammed Cells
        • 2D Modified Conditionally Reprogrammed Cells
        • 3D Organoid
        • 3D Air-Liquid Interface Organoid
        • 3D Neurosphere
        • Adherent Cell Line
        • Liquid Suspension Cell Line
      • composition
        • 2D Classical Conditionally Reprogrammed Cells
        • 2D Modified Conditionally Reprogrammed Cells
        • 3D Organoid
        • 3D Air-Liquid Interface Organoid
        • 3D Neurosphere
        • Adherent Cell Line
        • Liquid Suspension Cell Line
  • Modified genomic_profile_harmonization_workflow entity
    • Added new permissible values to field
      • workflow_type
        • GENIE Simple Somatic Mutation
        • GENIE Copy Number Variation
  • Modified somatic_mutation_calling_workflow entity
    • Added new permissible values to field
      • workflow_type
        • Pindel
  • Modified rna_expression_workflow entity
    • Added new permissible values to field
      • workflow_type
        • RSEM - Quantification
        • STAR - Counts
        • RNA-SeQC - Counts
        • RNA-SeQC - FPKM
        • Kallisto - Quantification
        • Kallisto - HDF5
  • Modified somatic_aggregation_workflow
    • Added new permissible values to field
      • workflow_type
        • Pindel Variant Aggregation and Masking
        • GENIE Variant Aggregation and Masking
  • Modified gene_expression entity
    • Added new data_types
      • Isoform Expression Quantification
      • Exon Expression Quantification
    • Added new data_format
      • HDF5

Bugs Fixed Since Last Release

  • Fixed issue when submitting tobacco_smoking_status via tsv

Known Issues and Workarounds

Release with API v1.10.0

  • GDC Product: GDC Data Dictionary
  • Release Date: August 22, 2017

New Features and Changes

  • Created follow_up entity to support longitudinal clinical data
  • Deprecated clinical_test entity
  • Modified acceptable values for Read Group properties
    • library_selection : "Hybrid Selection, Affinity Enrichment, Poly-T Enrichment, Random, rRNA Depletion, miRNA Size Fractionation, Targeted Sequencing"
    • library_strategy : "Targeted Sequencing"
  • Modified Diagnosis entity
    • Added field iss_stage
    • Added field best_overall_response
    • Added field days_to_best_overall_response
    • Added field progression_free_survival
    • Added field progression_free_survival_event
    • Added field overall_survival
    • Added field days_to_diagnosis
  • Modified Treatment entity
    • Added field regimen_or_line_of_therapy
  • Modified Demographic entity
    • Added field cause_of_death
    • Added field days_to_birth
    • Added field days_to_death
    • Added field vital_status
  • Modified Case entity
    • Added field days_to_lost_to_followup
    • Added field lost_to_followup
    • Added field index_date
  • Added new tumor code, tumor id, and sample types to Sample entity to support OCG
    • tumor_code : "Acute leukemia of Ambiguous Lineage (ALAL), Lymphoid Normal, Tumor Adjacent Normal - Post Neo Adjuvant Therapy"
    • tumor_code_id : "15, 17, 18"
  • Created somatic_mutation_index entity
  • Updated caDSR CDE links in data dictionary
  • Added new sample_type : tumor to sample entity
  • Made classification_of_tumor on diagnosis entity non-required
  • Added support for FM-AD to Genomic Profile Harmonization Workflow entity
  • Added data_type : Gene Level Copy Number Scores to Copy Number Segment entity

Bugs Fixed Since Last Release

None

Known Issues and Workarounds

  • Portion weight property is incorrectly described in the Data Dictionary as the weight of the patient in kg, should be described as the weight of the portion in mg

Release with API v1.7.1

  • GDC Product: GDC Data Dictionary
  • Release Date: March 16, 2017

New Features and Changes

  • Added "submittable" property to all entities
  • Changed Read Group to category biospecimen
  • Added many new clinical properties available for submission
  • Added sample codes from Office of Cancer Genomics (OCG) to analyte and aliquot
  • Slides can now be attached to sample rather than just portion
  • sample_type_id is no longer required when submitting sample entities
  • analyte_type_id is no longer required when submitting aliquot and analyte entities
  • Clinical Test Entity is created for storing results of a variety of potential clinical tests related to the diagnosis -
  • Genomic Profiling Report entity created for storing particular derived sequencing results
  • Structural Variation entity created
  • Project entity includes new field "Intended Release Date"
  • Project entity includes new field "Releasable"

Bugs Fixed Since Last Release

None

Known Issues and Workarounds

None

Release with API v1.3.1

  • GDC Product: GDC Data Dictionary
  • Release Date: September 7, 2016

New Features and Changes

  • Clinical Supplement entities can have data_format set to OMF.
  • Biospecimen Supplement entities can have data_format set to SSF or PPS.
  • Read group instrument_model can be set to "Illumina HiSeq 4000".
  • Category of Slide entities in the GDC Data Model has changed from data_bundle to biospecimen.

Bugs Fixed Since Last Release

None

Known Issues and Workarounds

None