Software Products for Collaborative Stage Data Collection System

CSv02.04 Production Release  Now Available
The Collaborative Staging Data Collection System workgroups announce the availability of the production release for version 02.04 of the Collaborative Stage systems. 

The production release for version 02.04 of the Collaborative Stage systems is available from the CDC FTP site using the following link CSv2_Production_Release_Version_02_04_40_Release_Date_2011_12_05.zip
 
Release history of Collaborative Stage version 2

02.00.00

Reserved for cases processed by CSv2 conversion utility

02.00.01

Initial release – January 2010

02.01.00

February 2010

02.02.00

April 2010

02.03.02

December 2010 The fourth production version of CSv2 was released on 12/8/2010 (Build/Version Number: 02.03.02).

02.4.40

December 2011 (current):  The fifth production version of CSv2 was released on 12/5/2011 (Build/Version Number: 02.04.40).  This is the version that should be used for current software installations to calculate Collaborative Stage v2. 

Timeline for Implementation

CSv2 version 02.04.40 must be used to code all cases diagnosed on or after January 1, 2012. Once version 02.04.40 is implemented in a registry, it should be used to code all newly abstracted cases diagnosed from 2004 forward. (2004 was the first year for which Collaborative Stage was collected.) Therefore, the item CS Version Input Original [NAACCR item number 2935] must be 020440 or greater for cases diagnosed in 2012 or abstracted using version 02.04.40. Once version 02.04.40 is implemented in a registry, and existing CS data have been converted according to specifications provided, all cases with CS data coded in prior versions should have all output stage fields re-derived using the algorithm of the new version 02.04.40. Therefore, all cases with CS data will be expected to have CS Version Derived [NAACCR item number 2936] of 020440 after implementation and conversion.

Contents of Release

Collaborative Stage Data Collection System version 02.04.40 was authorized to correct typographical errors, to resolve problems affecting stage output, and to address other issues as time permitted.  The code changes in v02.04 are much smaller in number and review requirements are fewer than were the changes for v02.03.   The last two digits of the version number are 40 because lower numbers have been designated to mark cases undergoing conversion to version 02.04.40. Instructions for applying the version numbers are provided in the conversion documentation and Implementation Guide portions of the release materials.

Detailed descriptions of the changes in v02.04 are provided in a Release Notes document available within the following link: CSv2_Production_Release_Version_02_04_40_Release_Date_2011_12_05.zip 

The contents of the zip file include the following in separate folders:

  • Release Notes for v02.04
  • CS Manuals, Parts I and Part II PDF Version
  • CS Manuals, Parts I and Part II HTML Help
  • Collaborative Stage Tables
  • Collaborative Stage Library (DLL)
  • Implementation Information
  • General Information and Testing Files
  • Release Announcement for V02.04

Implementing Version 02.04.40

If you have not yet implemented CS version 02.00.01 (released in January 2010), 02.01.00 (released in February 2010),  02.02.00 (released in April 2010),  or 02.03.02 (released December 2010) you must do so before implementing this new release. All conversion specifications and implementation instructions published for the initial version 2 releases must be followed prior to conversion to v02.04.40.  An Implementation Guide has been provided which documents the steps required to implement v02.04:

CDC has provided Northcon12 and a DLL that will perform the conversions and derivations from CS version 02.0x to CS version 02.04. See the section “Program to Convert from Collaborative Stage Version 02.03 to Version 02.04” below.
Conversion Specifications v02.03 to v02.04
A data conversion will be required to implement v02.04.  The set of conversion documents listed below, along with the Implementation Guide above, provides the information required for the conversion of cases from version 02.03 to version 02.04.  Please note that all case data must be converted to v02.03 before applying these conversion specifications to v02.04.

A conversion program is to convert cases from v02.03 to v02.04 has been provided.  See the section Program to Convert from Collaborative Stage v02.03 to v02.04 below.

Conversion Specifications V.02.02 to V.02.03

The conversion specifications, document with release notes and rules-based conversions, and spreadsheets with schema/code-specific instructions, comprise the guide for release 02.03.02. No other implementation guides are provided for this release.

Three updates to the initial conversion specifications have been issued and are published here. Changes to the conversion specifications and release notes in the PDF file are cumulative through the May 12, 2011 update. An update log is included at the beginning of the document, and changes in the text are highlighted accordingly. Changes to the spreadsheets are noted in red, and the red lettering is cumulative in the April 19, 2011 update. No changes to the spreadsheet were required for the May 12, 2011 update.

Changes noted in the February 15, 2011 specifications: Review criteria for MyelomaPlasmaCellDisorder, Testis, and GIST and NET schemas modified; rules supplied for converting blank values in most site-specific factors to 988; conversion from CSv1 to CSv2 before conversion to CSv3 emphasized; prostate conversion and possible review before conversion clarified; generation of lists for manual review by conversion program emphasized.

Changes noted in the April 19, 2011 specifications: Rules supplied for converting obsolete values mapping to ERROR in SSF25 for EsophagusGEJunction/Stomach and LacrimalGland/LacrimalSac; review described for converted code 015 in SSF25 for LacrimalGland/LacrimalSac.

Changes noted in the May 12, 2011 specifications: Clarifications have been added to emphasize that the schema names utilized in the document and associated spreadsheet are based on definitions and schema names for CSv0203. Also, the specifications which refer to the fifth spreadsheet tab (Obsolete Reviewed) were enhanced.

A conversion program to convert cases from CSv0202 to CSv0203 is now available (see the next sections).
NOTE: Facilities that have created their own conversion programs for v0202 to v0203 based on the specifications posted from December 2010 through April 2011 will need to apply the revised conversion specifications as of May 12, 2011 to their data. The following document details considerations that these facilities should note when updating their data according to the May 12, 2011 specifications.

Program to Convert from Collaborative Stage Version 01.xx to Version 02.02

CDC has released Northcon12, a freestanding Windows-based utility program that converts a file of cancer registry records in NAACCR11 record layout format to the NAACCR 12 record layout. Conversion of Collaborative Stage (CS) data from version 1 to version 2 is embedded in this program. The CS conversion is based on the published specifications and has been extensively tested. When the conversion is run, the user has the option to derive the Collaborative Stage version 2 stage outputs on appropriate records. For more information or to download the program, see the CDC-NPCR Web page at: http://www.cdc.gov/cancer/npcr/tools/registryplus/up_download.htm.

Instructions for accessing the program’s underlying dynamic link libraries (DLLs) are available on within the download package. These can be used by anyone who wishes to perform the conversions using another program.

Program to Convert from Collaborative Stage Version 02.02 to 02.03

CDC provides a conversion program and function library to convert data from NAACCR 12.0 to NAACCR 12.1. The conversion of Collaborative Stage (CS) data field-by-field from version 02.02.xx to 02.03.xx is embedded in the program. The program, Northcon121.exe, uses a new Windows Dynamic Link Library function library (DLL), nconv121.dll, to do its work. Instructions for using the DLL are included in the setup package. Download from the CDC-NPCR Web page, http://www.cdc.gov/cancer/npcr/tools/registryplus/up_download.htm.

Program to Convert from Collaborative Stage Version 02.03 to 02.04

CDC provides a conversion program and function library to convert data from NAACCR 12.1 to NAACCR 12.2. The conversion of Collaborative Stage (CS) data field-by-field from version 02.03.xx to 02.04.xx is embedded in the program. The program, Northcon122.exe, uses a new Windows Dynamic Link Library function library (DLL), nconv122.dll, to do its work. Instructions for using the DLL and a sample program are included in the setup package. Download from the CDC-NPCR Web page, http://www.cdc.gov/cancer/npcr/tools/registryplus/up_download.htm.

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

Test-O-Matic  – is an interactive Windows program that is useful for exploring Collaborative Stage tables and deriving stage. For more detailed information, please refer to CSv1 Test-o-Matic description.

Support Files and Test Files

CS Defaults version 020440 Dated 2011_12_05.xls (120K XLS) An Excel spreadsheet which provides the default values for the CSv0204 data fields for Death Certificate Only (DCO) cases originally coded under CS v02.04.40. The spreadsheet is organized by schema and is for cases which have a behavior code of 3. Instructions are included.

CSv2_Valid_Invalid_&_Obsolete_Code_Tables_v020440.2011_12_05.zip (140K ZIP) Valid, Invalid, and Obsolete Codes Tables: Excel Spreadsheets are provided which show schema-specific valid and invalid values for each field for CS version 02.04.40. An Excel spreadsheet is also included which contains the obsolete codes for version 02.04.40. Please note that the obsolete spreadsheet has a table for each obsolete code type and one of all obsolete codes combined. These three spreadsheets are not mutually exclusive since the obsolete codes are also contained in the valid code list.

NAACCRv12_Valid_Invalid_v020440_2011_12_05.zip (1380K ZIP) Test Cases for the Algorithm: Vendors have expressed an interest in obtaining test records which have a known behavior when the CS algorithm is run on them. Two sets of random test cases, one for valid CS codes (valid.NAACCRv12.in.v020440.txt) and one set with one and only one CS invalid code (invalid.NAACCRv12.in.v020440.txt) in each record were generated from the XML files. These input files (.in.) are in NAACCR v12 format (LRECL = 3339) and only contain the CS input fields and other fields necessary for the DLL to successfully run. On the input file, the record is un-staged, i.e., all derived CS fields are blank. These files can be used as input to the corresponding version of the CS algorithm (v020440). The output files (.out.) contain the staging results generated by the CSv2 algorithm. When staging the Valid “in” file, no errors should be generated by the algorithm. When staging the Invalid “in” file, one specific error message should be generated per data record. Please note that each record of the invalid “out” file contains the first 200 characters of the error message generated by the CSv2 algorithm. The error message has been written to column 1236 (Reserved 05).

For Questions:

As the CSv2 algorithm is implemented and employed with real case scenarios, questions regarding the CS site-specific schemas should be sent to csv2@facs.org. If you would like to receive vendor/software developer e-mails, you can sign up by e-mailing csv2@facs.org

For questions and comments on CSv2 production version software, please e-mail csv2@facs.org

Software Archives

Software Products for Collaborative Staging Version 1 (CSv1)

Revised December 5, 2011

 

Collaborative Staging Home Page