A dictionary release happens when there has been an update to the clinical dataset in the ARGO Data Dictionary. Dictionary releases happen whenever needed.
Release Date: September 23, 2022
- Added four new terms ('Hemithyroidectomy', 'Near-total thyroidectomy', 'Subtotal thyroidectomy' and 'Total thyroidectomy') to the controlled terminology for the
surgery_typefield in the Surgery table.
Release Date: June 16, 2022
A new clinical table has been added to the dictionary along with the file template download for submission:
- Surgery: The collection of data elements related to a donor's surgical treatment at a specific point in the clinical record. For treatment regimens that include surgery, these details can now be submitted in this table. Refer to Submitting data in Surgery file documentation for guidelines on how to submit clinical data in this table.
The following updates are also included:
- Addition of 'Unknown' and 'Not applicable' terms to controlled terminology for extended clinical fields. Refer to Submitting Missing Values for Extended Clinical Fields documentation on how to submit these values.
- Added new term ("Oral contraceptive pill") to controlled terminology for contraception_type field.
- Corrected Data Tier for family_relative_id to 'ID'.
Release Date: November 17, 2021
- The "AJCC 6th Edition" has been added to the controlled terminology for tumour staging systems. This will allow data submitters to submit TNM categories and stage groups for the AJCC 6th Edition.
- Optional clinical fields related to dose intensity reduction have been added to the Chemotherapy table. These include
- Optional clinical fields related to laterality have been added. These include the
lateralityfield in the Primary Diagnosis table and the
specimen_lateralityfield in the Specimen table.
- Removed the term "Unknown" from the controlled terminology of the core
vital_statusclinical field so it is consistent with other core clinical fields.
- Updated notes to clarify requirements for certain fields:
- Added clarification about why the comorbidity_type_code field is "Conditional".
- Updated description of age_at_menarche field to indicate it should be submitted in years.
- Updated notes for number_lymph_nodes_examined field to indicate it is only required if lymph_nodes_examined_status is 'Yes'.
- Updated notes for percent_proliferating_cells, percent_inflammatory_tissue, percent_stromal_cells and percent_necrosis fields in the Specimen table to indicate that they should only be submitted if the specimen is tumour.
- Added clarification on how to submit fields in Biomarker table.
radiation_therapy_dosageto accept number instead of integer.
- Updated controlled terminology for
sample_registrationfile to download templates from Dictionary Viewer page
Release Date: September 02, 2021
According to AJCC Guidelines 8th Ed. if TX or NX categories are used, such cases usually cannot be assigned a stage group. In such a case, the data submitter will be allowed to submit "Cannot be assessed" for the
stage_groupfield. However, there are exceptions according to the guidelines as follows:
Stage may be assigned when the TNM stage group results in Any T or Any N with M1, which includes TX or NX e.g. (
TX NX M1, or
TX N3 M1). These are classified as Stage IV.
Stage may be assigned when the TNM stage group results in Any T or Any N with M0, which includes TX or NX e.g. (
TX N1 M0Stage III in melanoma clinical stage or
T4 NX M0Stage III in pancreas).
pipeas a term to
- An incorrect abbreviation used in a field name in the Biomarker table. The biomarker is related to lactate dehydrogenase (LDH), not low-density lipoprotein (LDL), thus
biomarker.ldl_levelwas adjusted to
Release Date: July 21, 2021
A new clinical table has been added to the dictionary along with the file template downloads for submission:
- Biomarker: The collection of data elements describing a donor's biomarker tests. A biomarker is a biological molecule found in blood, other body fluids, or tissues that is indicative of the presence of cancer in the body.
survival_timefield is submitted,then all other interval times should be less than that. The
folowup.interval_of_followupfields are now being validated correctly against this rule.
Release Date: June 08, 2021
Two new clinical tables have been added to the dictionary along with the file template downloads for submission:
Exposure: A donor's clinically relevant information not immediately resulting from genetic predispositions (e.g diet, drug use, smoking).
Comorbidity: A donor's comorbidities are any medical condition that has existed or may occur during the clinical course of the donor who has the index disease under study (e.g diabetes, prior cancer malignancies).
immuotherapy.immunotherapy_typewas not marked as a required field. It is now correctly identified.
follow_up.anatomic_site_progression_or_recurrenceswas misnamed as a plural field; it has been corrected to
Release Date: May 10, 2021
- Integer fields now all contain validation based on the acceptable ranges allowed for those fields.
primary_sitenow accepts multiple values.
- Optional clinical fields detailing genetic disorders, hormone replacement therapy and contraception details have been added to the
- Validation was added to ensure that hematological_toxicity is only included for hematological toxicity types and non-hematological_toxicity is only included for non-hematological toxicity types:
|Hematological||Allowed to be submitted||Should not be submitted|
|Non-hematological||Should not be submitted||Allowed to be submitted|
- Validation was added to ensure that if a treatment has been marked as the
primary_treatment, it is not assigned an advanced
line of treatment:
|No||Allowed to have a value|
|Yes or Unknown||Should be left empty|
- Some fields/permissible values in the treatment table containing the word
hemotological. These have all been resolved.
bmican now be submitted as decimal values.
Release Date: April 27, 2021
Two new clinical tables have been added to the dictionary and the file template downloads for submission:
Immunotherapy: For treatment regimens that include immunotherapy, these details can now be submitted. Similar to the
immunotherapydrugs are recorded using the standardized vocabulary from the RxNorm database, provided by the NIH.
Family History: A donor's familial relationships and familial cancer history.
The following updates are also included:
- Validation has been added so that when the
treatment_type = No Treatment, non-applicable core fields do not need to be submitted.
Previously missing stage groups
Stage IVSfor Ann Arbor staging system has been added, as well as adding support for the
Stage II bulkyfor the Lugano staging system.
primary_diagnosistable, there was a misleading combination of fields indicating the status/number of lymph nodes examined during clinical diagnosis. When the
number_lymph_nodes_examinedis left blank, a value of 0 for
number_lymph_nodes_positivecould be misinterpreted as several things:
- an unknown number of lymph nodes were tested or
- none were found to be positive for cancer or
- no lymph nodes were examined.
To make this more accurate to clinical use cases, a new field
lymph_nodes_examined_status has been added to indicate if lymph nodes were examined. Depending on the status, the required
number_of_lymph_nodes_positive can now accurately reflect clinical use cases. For example:
|Yes||Optional: If left blank, this means unknown/missing. If number is submitted, it must be greater than 0||Required: If number_lymph_nodes_examined is > 0, then number_lymph_nodes_positive >= number_lymph_nodes_examined|
|No||0 or left blank||Should be left blank|
|Not applicable||0 or left blank||Should be left blank|
|No lymph nodes found in resected specimen||0 or left blank||Should be left blank|
|Cannot be determined||0 or left blank||Should be left blank|
Release Date: December 11, 2020
The following updates are included:
- Removed ID prefix restriction and all notes referencing this restriction.
Release Date: November 24, 2020
The following updates are included:
- Changed Attribute for percent_proliferating_cells, percent_inflammatory_tissue, percent_stromal_cells and percent_necrosis fields from Required to Conditional.
- Updated description for cumulative_drug_dosage field to indicate that the actual drug dose should be submitted.
- Added two new terms ("Swelling in the Neck" and "Not Reported") to controlled terminology for presenting_symptoms field.
Initial Dictionary Release 1.0
Release Date: June 19, 2020
ICGC ARGO is excited to announce its initial data dictionary release, established as the minimum set of clinical data elements that the ARGO Data Platform requires. This includes:
- Basic Donor, Specimen, and Sample data
- Donor clinical record information including Primary Diagnosis, Follow Up and Treatment data
Future releases will extend clinical data concepts and integrations of standard clinical data elements.