Software Products for Collaborative Staging Version 1 (CSv1)

Collaborative Staging Library - computer routines to derive stage and read the Collaborative Staging tables.  Calculates TNM and AJCC Stage Group according to AJCC 6th edition, SEER Summary Stage 1977, and SEER Summary Stage 2000.  Supplied as source code with build files for Microsoft Visual C++ version 6 and Makefile for gcc on Linux.  Compiled DLL provided for Windows.  Also a second DLL shell is provided to adapt library for Microsoft Visual Basic and some other programming environments.

cstage_dll_source_2008_03_20.zip - download a zipped file containing the C source code for the Collaborative Staging algorithm, including makefiles and related compiler files for Windows and Linux.  Also includes Collaborative Stage Application Program Interface documentation.

Windows DLL - a compiled Dynamic Link Library containing functions to calculate CS and to extract information from CS tables

Visual Basic DLL - "shell" DLL adapts CS for VB programs and other programming environments. Includes example code and Collaborative Stage Application Program Interface for VB documentation.

Collaborative Staging Tables - available in different formats

XML - download zipped file of XML tables. These tables are the fundamental repository of the Collaborative Staging system.

HTML - download zipped file of all the CS tables on this web site.

Testing the CS Algorithm - tools to ensure that your software program calculates stage correctly.

Test-O-Matic - an interactive Windows program that is useful for exploring Collaborative Staging tables and deriving stage.

Valid value tables - gives the valid storage values and corresponding labels for the derived CS fields for T, N, M and Stage and SEER Summary Stage.

CS Derived T, N, M and Stage Codes
SEER Summary Stage

Unknown Values for Death Certificate Only Cases - provides the default/unknown values for the CS schemas. It can be used by vendors to populate a DCO record, filling in unknown values.

            Default and unknown values for CS items (80K XLS)

Editing CS data fields

It is highly recommended that all CS fields be checked for validity before running the CS Algorithm

Valid and Invalid Codes Tables

Excel Spreadsheets are provided which show schema-specific valid and invalid values for each field for CS version 01.04.01.  An Excel spreadsheet is also included which contains the obsolete codes for version 01.04.01. These three spreadsheets are not mutually exclusive since the obsolete codes are also contained in the valid code list:

valids_v010401.xls
invalids_v010401.xls
obsolete_v010401.xls

These Excel spreadsheets are also provided by site/histology within schema name.  Please note that there are two rows each for lymphomas and hemeretic because of two histology codes that can be either lymphomas or leukemias depending on the site code.  In addition, the site codes and histology codes are given in ranges for ease of use and that this is not an indication that all codes in the range are valid sites or histologies.  The histology codes in these files have been corrected.

valids_sitehist_v010401.xls
invalids_sitehist_v010401.xls
obsolete_sitehist_v010401.xls

Test Cases for the Algorithm

Random input test files of valid and invalid codes were generated from the XML files and used as input to the corresponding version of the CS algorithm. The input and corresponding output files for each are attached.   Please note that the name of the schema is not included in output for v010400.

invalid.in.v010401.txt.zip
invalid.out.v010401.txt.zip

valid.in.v010401.txt.zip
valid.out.v010401.txt.zip

Verified file: For version 010100 a set of input values were run through the algorithm and the derived fields were verified by hand that the results were correct (verify.out.v010100.txt). The output values were then run through the subsequent versions of the algorithm and the derived fields updated (see verify.out file for specific CS version). Any differences in derived values between the last two versions have been verified.

verify.in.txt.zip
verify.out.v010100.txt.zip
verify.out.v010200.txt.zip
verify.out.v010300.txt.zip
verify.out.v010400.txt.zip
verify.out.v010401.txt.zip

Suggested Method for Editing CS Before Running the Algorithm

Below is a front end program that will allow the editing of each CS field before the algorithm is run so that error messages can be displayed on a specific field.

Windows.Validation.App.Zip
Contains the windows executable and readme for the Windows Validation Application.

console.app.zip
Contains the windows executable and readme for the Console Application.

There are readme files with each.  Please note that all of the executable files need to be in the same directory as the current version of the DLL.  The Zip files are password protected and the password is "cstage."

Questions or comments about these files should be sent to Lynn Ries at lynn_ries@nih.gov.

For Questions:

The CS algorithm is a very complex algorithm that has been extensively tested by the developers. As the CS algorithm is implemented and employed with real case scenarios, questions regarding the CS site-specific schema should be sent to Donna Gress, AJCC Technical Specialist at dgress@facs.org.

  

Online March 11, 2010

 

CSv2 Software Products

Collaborative Staging Home Page