Minor internal changes

Changes were made to the library to help support its usage in SEER*API. None of these changes affect the usage of the library directly.

TNM 1.4

This release adds TNM 1.4 which includes the following changes:

1. Oral Cavity schemas and Larynx Glottic: Path Stage Group notes regarding combinations only found in SEER*RSA were corrected. Stage Group IVA should have referenced Tis in addition to T0.

2. NasoPharynx: Path Stage Group notes regarding combinations only found in SEER*RSA were corrected. Stage Group IV is only in SEER*RSA; Stage Group II and III Tis combination is only SEER*RSA.

3. Corpus Carcinoma: Clin N and Path N: N1 definition modified to replace text for FIGO IIIC with 'Statement of FIGO IIIC only' because it was confusing to have metastasis of para-aortic lymph nodes in both N1 and N2.

4. Rectum: The combined T table was replaced with the table used by Colon. The Colon table does NOT generate an error when both Clin T and Path T are pTis and Behavior = 3.

TNM 1.3 was removed from the library.

TNM v1.3

TNM 1.3 was released with the following differences since 1.2:

• Added 88 to the Derived Stage Group calculation tables in order to correctly process 88 in the T, N, M and Assigned Stage fields for Lymphoma, LymphomaOcularAdnexa, MelanomaSkin and the 4 MerkelCell schemas. 88 is the required value for a DCO case.
• Registrar Notes for Melanoma Skin Clin T and Path T were revised to clarify the definitions of T1a and T1b.

TNM 1.2 is not longer available in the library.

Context references

Context references are values that reference another value in the context. For example, the common way to set a value in the context is:

"outputs" : [ {
  "key" : "derived_version",
  "name" : "Derived Version",
  "default" : "1.2"
}

Will result in a a new key, derived_version being added to the context with a value of 1.2.

However there are system context values added automatically at the start of every staging execution. One of them is ctx_alg_version. It will be set to the version of the algorithm that is being run. So same example above can be accomplished with context references now:

"outputs" : [ {
  "key" : "derived_version",
  "name" : "Derived Version",
  "default" : "{{ctx_alg_version}}"
}

The final value will be 1.2 just like before but the default will not have to be changed every time a new version is released.

Also note that context references can reference any value in the context, just just system context values like ctx_alg_version.

Context references already were being using in processing table input and output values. Now they can be used for the following as well:

• initial context
• input defaults
• output defaults

TNM 1.2

TNM 1.2 was released with only a couple of minor differences since 1.1:

• Added 88 as a possible choice for the clin and path stage groups of Lymphoma, LymphomaOcularAdnexa, MelanomaSkin and the 4 MerkelCell schemas. 88 is the required value for a DCO case.
• Modified Nasopharynx schema selection for Site = C111 to remove SSF25 = 981. 981 should only be selected if Site = C110, C112, C113, C118, C119

TNM 1.1 is not longer available in the library.

CS 02.05.50 AJCC 6 Cleanup

There were extra tables in some of the CS 02.05.50 AJCC 6 mappings for certain schemas. They did not affect the final staging values but could sometimes produce a false error during staging. The error could be ignored but removing the tables is a better solution.

Here are the AJCC 6 mapping tables that were removed.

Schema                   Mapping          Table Removed
--------------------     -------------    -------------------------------------
cervix               ->  mapping_ajcc6 -> extension_size_ajcc7_xgi
cervix               ->  mapping_ajcc6 -> csextension_size_tablefor_ajcc6th_xba
gist_colon           ->  mapping_ajcc6 -> mitotic_rate_calculation_xpi
gist_esophagus       ->  mapping_ajcc6 -> mitotic_rate_calculation_xqe
gist_rectum          ->  mapping_ajcc6 -> mitotic_rate_calculation_xpi
gist_small_intestine ->  mapping_ajcc6 -> mitotic_rate_calculation_xqe
gist_stomach         ->  mapping_ajcc6 -> mitotic_rate_calculation_xqe
mycosis_fungoides    ->  mapping_ajcc6 -> ssf1_jaj

New loading cache implementation

Switched the loading cache implementation from Guava to Caffeine. Caffeine showed roughly a 20% performance increase in our heavily threaded integration tests.

Caffeine requires Java 8 so that will become the new minimum JDK requirement. In addition, since the loading cache was the main thing being used from Guava that dependency was removed from the library.

Encoding fix

The code which updated the schemas and tables from SEER*API was not handling encoding correctly. This caused issues with certain characters being converted incorrectly in some table notes. The code was corrected and the tables were also updated to fix the bad characters.

TNM v1.1

TNM v1.1 replaces TNM v1.0 in the library.

Changes to version 1.1 include:

• Added schema notes regarding differences between UICC and AJCC chapter definitions and describing SEER*RSA rules.
• Added schema notes related to Summary Stage 2000, including links to manual
• Added footnotes defining the difference among UICC, AJCC and SEER*RSA related to T, N and M
• Added notes defining the difference among UICC, AJCC and SEER*RSA related to directly assigned Stage Group
• Added registrar notes that 88 should be assigned for DCOs to T, N and M
• Corrected typographical errors in various parts of the system. Of import:
  • Liver, schema Note 1: changed to state that C221 with 8170-8175 is NOT TNM staged
  • Thyroid, Directly assigned stage groups: added T0, N1b, M0 -> IVA for Pap>=45 and Med
  • MelanomaConjunctiva, Path T, T1b: description was incorrect, the T1a description had been accidentally copied here
• Corrected Stage group calculation algorithm errors.
  • CorpusSarcoma, TNM Stage Calculation tables and Assigned Stage Group lookups: Changed T3, N1, M0 to map to IIIC
  • Testis, TNM Path Stage Calculation tables and Assigned Stage Group lookups: Changed Tis, (N0, NX), M0, (S0, SX) to map to 0. Only Tis, N0, M0, S0 had gone to 0
  • Combined T General and No TIS tables: where neo-adjuvant treatment was not given, added the combinations of Clin T (1C, 1D) with Path T (1A, 1B)
  • Combined T for Breast: where neo-adjuvant treatment was not given, added the combinations of Clin T (1MI, 1A-1C) with Path T (4, 4A-4D)
  • Combined N General: where neo-adjuvant treatment was given, added the combinations of Clin N (3A-3C) with Path N4
• Thyroid: Adjusted the algorithms, tables and notes to handle Anaplastic tumors with Clin T lower than T4. Clinical stage is calculated using Papillary and Follicular tables for such cases.
• LymphomaOcularAdnexa: Adjusted the algorithms to remove steps related to T, N and M since these are not defined in UICC

Note that the library only contains the latest version of TNM v1.x. If you want to use TNM v1.0 you will need to a prior version of the library.

TNM v1.0

TNM v1.0 is now available.

The TNM staging algorithm contains the data items and descriptions necessary to collect T, N and M stage components, as well as other data items required to calculate Clinical and Pathologic Stage Groups. In addition, this algorithm calculates a combined stage group. It also contains the data item definitions for the associated Predictive and Prognostic Factors on a schema specific basis. Staging information is collected for site and histology combinations that are not defined in TNM in order to support SEER Summary Stage calculations (these calculations will not be implemented for diagnosis year 2016).

The initial release includes Union for International Cancer Control (UICC) TNM Classification of Malignant Tumor 7th edition.