EOD 1.1

Update EOD from 1.0 to 1.1. EOD 1.0 is no longer available.

Summary of changes:

• Bladder:

  • EOD Primary Tumor codes 130, 200 corrected (added Subserosa to 130, Superficial muscle - inner half indented in 200)
  • Summary Stage 2018 code 1 corrected (added Subserosa)

• Breast

  • EOD Regional Nodes Note 7 corrected to move last two entries into the list
  • EOD Regional Nodes Note 5 added (Codes 100-200 and 350)
  • EOD Mets Note and Summary Stage 2018 Note 9 corrected (… less than or equal to 0.2 mm are negative …)
  • ER Allred Score[#3828] and PR Allred Score[#3916] Note 3 was modified (bullet added)
  • Lymph Nodes Positive Axillary Level I-II[#3882]: default changed to 8
  • Oncotype DX Recurrence Score - DCIS[#3903]: Note 4 and Note 5 added
  • Oncotype DX Recurrence Score[#3904] Note 4 added
  • Oncotype DX Risk Level-DCIS[#3905]: Note 3 added

• Cervical Lymph Nodes and Unknown Primary Tumor of Head and Neck: Summary Stage 2018 site list limited to C760. This is the only site code in the schema and is to be used, by agreement, for unknown primaries of the head and neck.

• Colon and Rectum:

  • EOD Primary Tumor Note 2 revised, Note 3 added
  • Summary Stage 2018 Note 2 revised, Note 3 added

• Corpus Adenosarcoma; Corpus Sarcoma: Summary Stage 2018 code 0 removed

• Corpus Sarcoma: FIGO Stage[#3836] given a default of 98

• Cutaneous Squamous Cell Carcinoma of Head and Neck; Melanoma Skin; Skin Other: Summary Stage 2018 code 3 corrected (C006 added whenever C000-C002 are listed)

• Genital Male Other:

  • Schema Note 3 corrected for Merkel Cell Skin and Kaposi Sarcoma
  • Summary Stage 2018 Note 3 about C632 was corrected

• GIST: Summary Stage 2018 Note 2 corrected (C54 changed to C540)

• HemeRetic: Summary Stage 2018 Note 4 had 9740 removed

• Kaposi Sarcoma:

  • EOD Primary Tumor Note 2 corrected (Choice of EOD Primary Tumor for Kaposi sarcoma...)
  • Summary Stage 2018 code 3's first bullet corrected (...pathologically positive lymph node(s))

• Larynx Other: AJCC Chapter Calculation table had behavior added; /2 is not AJCC eligible

• Lung:

  • EOD Primary Tumor code 550 corrected (Chest wall (thoracic wall) (separate lesion-see SEER mets) removed)
  • EOD Regional Nodes code 700 corrected (Cervical added)

• Lymphoma and Lymphoma CLL/SLL: B Symptoms[#3812] default value changed to 8

• Melanoma Conjunctiva: EOD Primary Tumor code 100 corrected (Less than or equal to one quadrant)

• Melanoma Head and Neck:

  • EOD Primary Tumor and Summary Stage 2018 site code lists revised to match schema selection
  • Summary Stage 2018 had C000-C002, C006 removed

• Melanoma Skin:

  • Summary Stage 2018 C500 labeled "Nipple & areola (Breast)"
  • Breslow Thickness[#3817] default changed to XX.8
  • LDH Pretreatment Level[#3932] default set to XXXXX.8
  • Ulceration default[#3936] default changed to 8

• Melanoma Skin; Merkel Cell Skin: EOD Regional Nodes and Summary Stage 2018 had note added about ITCs

• Melanoma Skin; Merkel Cell Skin; Skin Other: EOD Regional Nodes Notes and Summary Stage 2018 code 7 were revised to be compatible

• Merkel Cell Skin

  • EOD Regional Nodes code 700 corrected (Cervical added)
  • Summary Stage 2018 chapter title changed to Merkel Cell Skin

• Mouth Other; Palate Hard; Tongue Anterior: EOD Primary Tumor code 400 corrected (less than or equal to 10 mm)

• Nasopharynx: EOD Primary Tumor code 300 corrected (2 bullets collapsed into single phrase)

• NET Adrenal Gland: Summary Stage 2018 site list now limits C755 to 8680, 8690, 8692-8693, 8700

• NET Colon and Rectum: EOD Regional Nodes code 300 corrected (C183 associated with Hepatic Flexure)

• Oral Cavity: EOD Primary Tumor Note 3's 2nd bullet changed to "greater than 5 mm to less than or equal to 10 mm"

  • Oral Cavity schema are Buccal Mucosa, Floor of Mouth, Gum, Lip, Mouth Other, Palate Hard, Tongue Anterior

• Parathyroid: Summary Stage 2018 Note 3 corrected (code 0 instead of 000)

• Penis; Vulva: Schema Note and Summary Stage 2018 Note for Merkel Cell corrected (8041, 8190, 8247)

• Plasma Cell Disorder: EOD Regional Nodes code 987 corrected (Single plasmacytoma occurring in bone (osseous or medullary) (9731) added)

• Plasma Cell Myeloma: Schema Discriminator 1 default changed to 0

• Pleural Mesothelioma: Summary Stage 2018: Note 3 corrected (to code EOD Mets removed)

• Primary Peritoneal Carcinoma: EOD Regional Nodes Note 2 corrected (See EOD Mets added)

• Skin Eyelid

  • EOD Regional Nodes Note 3 corrected (Infra-auricular added)
  • Summary Stage 2018 code 3 lymph node list aligned with EOD Regional Nodes Note 3

• Small Intestine: Summary Stage 2018 code 1 bullets reordered (subcategories of Invasion of)

• Soft Tissue Abdomen: C151-C152, C154-C155, C159 moved from Soft Tissue Other into Soft Tissue Abdomen

• Urethra; Urethra Prostatic: Schema Discriminator 1 default set to 1

• General:

  • Various typos corrected, including issues with spacing, formatting, spelling, parentheses, numbering, etc.
  • Various formatting issues corrected for consistency that did not change the meaning, such as
    • lists in text box or text strings converted to standard lists
    • titles and site lists added Summary Stage 2018
    • Summary Stage 2018 Note 1 modified to use the word chapter instead of schema
  • NAACCR item numbers were added for SSDIs references in other data item notes
  • Notes added to the schema and Summary Stage 2018 to indicate where other histologies for the primary sites can be found (8935-8936 -> GIST for example)
  • Various Summary Stage 2018 chapter name corrections
  • Derived Summary Stage 2018 [#762] starting value changed to blank. Derived EOD T, N and M starting values changed to 90.
    • The starting value is returned if a failures prevents that algorithms from executing

—————————————-
EOD Master Additional Changes:

• Breast: Post Therapy Stage Group value of 99 removed (only 88 is valid)

• Lung: Stage Group table corrected (M1b results in stage group IVA; M1c results in stage group IVB)

TNM 1.7

The TNM version was updated from 1.6 to 1.7. #47

• Colon and Rectum, Combined T table: When one of Clinical T or Path T is missing, the Combined T table for Colon and Rectum was not handling T4. T4 has been added.
• General: if Clin and Path T, N, M and Stage Group are all set to 88, then the Derived Combined T, N, M and Stage Group will be set to 88. This happened without error for most schemas, but Prostate was incorrectly returning an error messages.

BUG FIX: An internal context value was being returned on staging calls. #43

Bugfix release

The sex discriminator was not included in the EodSchemaLookup entity. It is required for certain schemas. A unit test was also added to verify that all discriminators are now included. #40

EOD

Added support for EOD 1.0 (see #39)

Extent of Disease (EOD) is a set of three data items that describe how far a cancer has spread at the time of diagnosis. EOD 2018 is effective for cases diagnosed in 2018 and later.

In each EOD schema, valid values, definitions, and registrar notes are provided for

• EOD Primary Tumor
• EOD Lymph Nodes
• EOD Mets
• Summary Stage 2018
• Site-Specific Data Items (SSDIs), including grade, pertinent to the schema

For cancer cases diagnosed January 1, 2018 and later, the NCI SEER program will collect Extent of Disease (EOD) revised for 2018 and Summary Stage 2018. The schemas have been developed to be compatible with the AJCC 8th Edition chapter definitions.

All of the standard setting organizations will collect the predictive and prognostic factors through Site Specific Data Items (SSDIs). Unlike the SSFs, these data items have formats and code structures specific to the data item.

Numeric range bugfix

The support for numeric ranges in the prior release had a bug in how it built the ranges. It was corrected in #37.

Support numeric range comparison

Prior to this change, the ranges supported by the algorithms has the requirement that each side was the same length. That is because we were using String comparisons. With upcoming algorithms there is a requirement to support numeric ranges. For example,

"0.1-99999.9"

The solution is that for numeric ranges we will compare as float values (even if integer):

• If the low and high values ranges are different and are both "numeric", then the value will be compared after converting to a Float (which will work for the Integer type fields as well).
• Otherwise it will be compared as a String but the strings must be the same length otherwise consider different

Note that as part of this change StagingStringRange was renamed to StagingRange to be more accurate.

For details see #36

TNM 1.6

TNM 1.6 was added to the library, and TNM 1.5 was removed.

TNM changes include:

• There was a bug in the calculation of Combined N for the Colon schema. This manifested only in the C++ library and resulted in errors being returned when the calculation of Combined N was attempted. It has been corrected.
• The Year of Diagnosis validation table was limited to 2016 and 2017.
• Messages were added to returned errors to aid in the identification of the conflict.
• SEER Primary Tumor, SEER Regional Nodes, SEER Mets and Summary Stage 2017 were removed (they were never defined for 2016-2017). While the fields and template calculation steps were included in the API, they were suppressed in production. These data items and calculation steps have been removed to streamline the API. There should be no impact on the validation tables or calculations being performed. The input tags seer_primary_tumor, seer_nodes and seer_mets are no longer valid and should not be passed into the algorithm.

Change to schema selection

This change was handled in #31.

This is the current way schema selection is handled:

• match on all selection tables using ONLY site/hist; completely ignores any other INPUT columns
  • if there is a single match, return it
  • else loop over all the matched tables
    • match table using ALL input columns.

The upcoming EOD algorithm will support multiple discriminators. I am simplifying the process to look like this:

• match on all selection tables using only the keys that were supplied in the lookup.

This change will allow lookups returning multiple results when only some of the discriminators are supplied.

This should have no affect on CS or TNM algorithms.

Dependency updates

Minor release to update various dependencies.

TNM 1.5

This release updates TNM to 1.5. The are as follows:

TNM v1.5 changes:

All schemas where Tis is valid: For Combined N, when neoadjuvant treatment was given (Surgery sequence = 2 or 4) and no nodes were examined (Regional LN Positive = 98), values other than blank (or pX) for Path N resulted in the error message “RN Pos = 98, Path N should be blank”. When Path T = pIS, edits require Path N to be c0. The Combined N logic has been changed to accept Path N = c0 for schemas where Tis is valid.