Installation Instructions ------------------------- 1. Click on the download link and save all files to a desired location on your computer or network. 2. From the location to which you saved the files, if you are installing LTAS.NET for the first time or are upgrading from a release older than 1.2, double-click on LTASsetup216.exe ** 3. If you are upgrading from LTAS.NET version 1.2 or later, double-click on LTASupgrade216.exe ** If you are running under a limited access account, please contact your LAN administrator (for CDC account users, contact ITSO) to perform the install. Be sure to ask them to perform the install under your account (with administrative privileges temporarily granted) and verify that your account has ownership of the LTAS program folder upon completion. Release Notes ------------- Version 2.0.16 includes the following changes: CM0032 - Added table that shows relationship between rate file and outcome file options to documentation. CM0031 - Corrected upgrade installation to properly restore custom rate files and cause maps. CM0030 - Corrected Personal Cumulative Dose report to show correct person time in diagnosis-based studies for persons having multiple history records A more detailed description of these changes can be found below. CM0032 - Added table that shows relationship between rate file and outcome file options to documentation. A table that shows the relationship between rate file and outcome file options has been added to the 'Outcome Import File' section of the documentation. CM0031 - Corrected upgrade installation to properly restore custom rate files and cause maps. Custom rate files that were imported before an upgrade to a new version of LTAS.NET did not work properly under the following conditions: * The custom rate file referenced a custom cause map * Two or more custom cause maps were imported prior to the upgrade * The custom cause maps were imported in an order other than alphabetical order After upgrading, users should re-import any custom rate files they are using. Even though the problem is now fixed and won't occur as a result of upgrading to this release, re-importing will eliminate the effects of previous upgrades. CM0030 - Corrected Personal Cumulative Dose report to show correct person time in diagnosis-based studies for persons having multiple history records For diagnosis-based studies, the Personal Cumulative Dose report was incorrectly including time after the date of diagnosis. This problem was partially fixed in CM0029, but still persisted in cases where a person has multiple history records. Version 2.0.15 includes the following changes: CM0029 - Corrected Personal Cumulative Dose report to show correct person time in diagnosis-based studies A more detailed description of these changes can be found below. CM0029 - Corrected Personal Cumulative Dose report to show correct person time in diagnosis-based studies For diagnosis-based studies, the Personal Cumulative Dose report was incorrectly including time after the date of diagnosis in person time totals. This problem was specific to the Person Cumulative Dose report and did not affect any other reports including analysis reports. Version 2.0.14 includes the following changes: CM0028 - Changed import and stratify logic to properly handle multiple cause studies A more detailed description of these changes can be found below. CM0028 - Changed import and stratify logic to properly handle multiple cause studies For multiple cause studies, the Import validation rules have been adjusted to exclude underlying outcomes. Stratify was also changed to handle cases of multiple outcome records for the same person. Version 2.0.13 includes the following changes: CM0027 - Updated NIOSH-119 rates and cause maps A more detailed description of these changes can be found below. CM0027 - Updated NIOSH-119 rates and cause map The NIOSH-119 UCOD and Proportion rate files have been updated with rate data for years 2003-2005. Additionally, the NIOSH-119 cause map file has changed slightly to correct the mapping for COPD in ICD Revision 8 along with a couple other minor remappings. Version 2.0.11 includes the following changes: CM0026 - Changed import validation logic to properly handle diagnosis-based studies CM0025 - Corrected end of risk accumulation logic for diagnosis-based studies CM0024 - Fixed problem causing incorrect results in SRR reports when all causes are selected A more detailed description of these changes can be found below. CM0026 - Changed import validation logic to properly handle diagnosis-based studies Two new import validation rules, OC60x and OC70x, have been added so that only the applicable outcome records are included based on the type of study. See the Outcome File Requirements section in the LTAS.NET User's Guide for details. CM0025 - Corrected end of risk accumulation logic for diagnosis-based studies Time at risk should not accumlate past the date of diagnosis for diagnosis-based studies. In addition to correcting the logic, the import wizard was changed to clarify the end of risk options for diagnosis-based studies. CM0024 - Fixed problem causing incorrect results in SRR reports when all causes are selected Selecting all causes for an SRR report caused incorrect results. In many cases, the same results were mistakenly reported for each cause. Version 2.0.10 includes the following changes: CM0023 - Changed stratify to handle underlying diagnosis for non-deceased persons CM0022 - Added ability to export observed diagnosis A more detailed description of these changes can be found below. CM0023 - Changed stratify to handle underlying diagnosis for non-deceased persons For studies using diagnosis based rates, stratify was only including the underlying outcome for deceased persons in the cohort. This has been resolved so that diagnosis for non-deceased persons are included. CM0022 - Added ability to export observed diagnosis After import, the only export option was to export observed deaths. For studies that use diagnosis-based rates, an option to export observed diagnosis was needed. Version 2.0.9 includes the following changes: CM0021 - Added support for diagnosis rates CM0020 - Added support for revisions in non-ICD cause maps A more detailed description of these changes can be found below. CM0021 - Added support for diagnosis rates LTAS.NET was not properly handling the diagnosis flag in the rate files in its validation logic for outcome records and was instead treating all rate files as death rates. CM0020 - Added support for revisions in non-ICD cause maps Revisions for non-ICD disease codes are now properly supported. Studies that are based on non-ICD codes can specify either a global revision or specify the revision in the outcome file. Version 2.0.8 includes the following changes: CM0019 - Inconsistent calculation error when running Major/Minor Summary report A more detailed description of these changes can be found below. CM0019 - Inconsistent calculation error when running Major/Minor Summary report Running a Major/Minor Summary report or any variant of an SMR List report that included Cause as the row variable generates an "Inconsistent calculation detected ..." error message. This problem was introduced by the consistency checks added in version 2.0.6 to detect incorrect SMR reporting (CM0017). In this particular case, the consistency checks were wrong and the reporting was correct. Version 2.0.7 includes the following changes: CM0018 - Updates to the NIOSH 119 cause map A more detailed description of these changes can be found below. CM0018 - Updates to the NIOSH 119 cause map A few minor changes have been made to the 119-cause mapping file that affected NIOSH minors 62, 73 and 119. For ICD revision 07, ICD code 289.3 was added and is now mapped to minor 119. For ICD revision 08, ICD codes 442-442.9 were added and mapped to minor 62 and ICD codes 550-550.9 were added and mapped to minor 73. For ICD revision 10, ICD codes E89.0-E89.3 E89.8 and E89.9 were added and mapped to minor 119. No changes were needed to the 92-cause mapping file. Version 2.0.6 includes the following changes: CM0017 - Fixed problem with SMR analysis reporting incorrect expected and observed values. CM0016 - Fixed rounding problem when stratifying Duration categories using Years for units. CM0015 - Fixed errant warnings in Import Exception reports when a global risk begin date is used. A more detailed description of these changes can be found below. CM0017 - Fixed problem with SMR analysis reporting incorrect expected and observed values. This problem only occurs under the following conditions: 1. Report must be an SMR report (either Grid or List layout) 2. Report must include at least two categories from an additional stratifier (any type) that is not used as an axis or row variable. 3. Report must contain a cell or row that has zero person time on a page for the first selected category of the additional stratifier. Furthermore, the same corresponding cell or row on the page for the last selected category of the additional stratifier must have non-zero person time. This can be verified by running a Distribution of Person Years report with the same stratifier selections. 4. Report must either not include the ‘All’ category for the additional stratifier (grayed checkbox) or include some but not all minor causes. Either of these conditions causes data from the last category to spill into the cells/rows that have zero person time in the first category. The likelihood of having incorrect observed and expected values being reported increases when more categories for additional stratifiers are added as finer splitting of the cohort results in more cells/rows with zero person time. CM0016 - Fixed rounding problem when stratifying Duration categories using Years for units. An internal calculation used during stratify was incorrectly rounding the duration value down to the nearest day when converting duration categories specified in Years. This caused the transition dates for these categories to be one day earlier. CM0015 - Fixed errant warnings in Import Exception reports when a global risk begin date is used. When a global date is selected for risk begin ‘Risk Begin < Birth Date’ warnings appear in the import exception reports after the import. These warnings are not correct. Version 2.0.5 includes the following changes: CM0014 - Fixed stratify error in calculating person time for lag category. CM0013 - Fixed import wizard to prevent partially unchecked genders from crashing LTAS. CM0012 - Fixed stratify wizard so that hitting the cancel button right after finish won't cause LTAS to crash. A more detailed description of these changes can be found below. CM0014 - Fixed stratify error in calculating person time for lag category. When exposure begins prior to risk begin AND a nonzero lag is specified AND a separate category for lagged out person-time is specified, person time that should be included in the first non-lag category is mistakenly included in the lag category. CM0013 - Fixed import wizard to prevent partially unchecked genders from crashing LTAS. The import wizard allowed a gender to be partially unchecked (gray). This left the gender is an unexpected state that caused the LTAS to crash during import. When you click on the Include box the first time, the check goes gray but does not clear completely. CM0012 - Fixed stratify wizard so that hitting the cancel button right after finish won't cause LTAS to crash. Hitting the cancel button right after finish from the stratify wizard would cause LTAS to crash. You can also just hit enter twice on the last page of the wizard to reproduce this. Version 2.0.4 includes the following changes: CM0011 - Fixed problem with rate import that corrupted the rate values. A more detailed description of these changes can be found below. CM0011 - Fixed problem with rate import that corrupted the rate values. A problem with the rate import causes the decimal point to be ignored on rate values. This results in large rate values being loaded. This problem was introduced by the changes for ticket #6 in release 2.0.2. Version 2.0.3 includes the following changes: CM0010 - Corrected upgrade install to preserve user-defined rate sets and cause maps. CM0009 - Fixed 'The process cannot access the file...' error that can occur when re-importing a rate set. CM0008 - Fixed 'Object reference not set ...' error that occurs during import when a project references an undefined rate set. CM0007 - Corrected install error that the log file for LTAS_System already exists. A more detailed description of these changes can be found below. CM0010 - Corrected upgrade install to preserve user-defined rate sets and cause maps. After upgrading to a new version of LTAS.NET, users had to re-import any special cause maps or rate sets that they are using. CM0009 - Fixed 'The process cannot access the file...' error that can occur when re-importing a rate set. Re-importing a rate file can sometimes fail with the error messsage 'The process cannot access the file ... because it is being used by another process. CM0008 - Fixed 'Object reference not set ...' error that occurs during import when a project references an undefined rate set. When upgrading to a release prior to 2.0.3 (see issue CM0010) or when copying a project database from one computer to another, it is possible that the rate set is unavailable. The import process wasn't validating this condition and giving the user a proper error message. CM0007 - Corrected install error that the log file for LTAS_System already exists. When a previous installation is uninstalled, it leaves the system database and log files in the data folder. A reinstall then fails because of log file conflicts. Version 2.0.2 includes the following changes: CM0006 - Fixed problem importing rate files on systems that had non-US regional settings. CM0005 - Corrected the cohort denominator value displayed on the Stratify Progress dialog. CM0004 - Increased query timeout that prevented large cohorts from stratifying. A more detailed description of these changes can be found below. CM0006 - Fixed problem importing rate files on systems that had non-US regional settings. Attempting to import a rate file onto a computer that had regional settings other than English (United States) could fail depending on the number format defined for that region. LTAS now properly imports the rate file regardless of the regional setting. CM0005 - Corrected the cohort denominator value displayed on the Stratify Progress dialog. If one or persons are rejected during the stratify process, the person years for the person rejected were incorrectly included in the cohort denominator value displayed in the Stratify Progress dialog. This problem only affected the progress display and did not affect any of the reports. LTAS now displays the correct value. CM0004 - Increased query timeout that prevented large cohorts from stratifying. Attempting to stratify large cohorts (greater than 1 million persons) could result in a database timeout error. To avoid this problem, the timeout value has been increased. Version 2.0.1 includes the following changes: CM0003 - Fixed problems that prevented TSLE from stratifying correctly. CM0002 - Analyze Wizard now saves and restores 'All Causes' setting properly. CM0001 - Added handling of study end dates that occur after the last rate period. A more detailed description of these changes can be found below. CM0003 - Fixed problems that prevented TSLE from stratifying correctly. A problem in the LTAS.NET handling of TSLE caused incorrect stratification that resulted in either persons being incorrectly rejected for 'No Exposure' and/or TSLE person time not accumulating properly. This problem only occurred if TSFE was not also included in the import of the exposure agent and the last history record for the person contained non-zero exposure. These problems have been resolved so that TSLE is handled correctly in all cases. CM0002 - Analyze Wizard now saves and restores 'All Causes' setting properly. The Analyze Wizard was not correctly restoring the 'All Causes' checkbox when no other causes are checked and you run the wizard multiple times. Instead of restoring just the 'All Causes' selection, all majors and minors were selected. The Analyze Wizard now restores the 'All Causes' selection properly. CM0001 - Added handling of study end dates that occur after the last rate period. Study end dates that occurred after the end of the last calendar period defined in the reference rates caused a 'Value does not fall within the expected range.' error to occur during stratification. LTAS.NET has been changed to support study end dates up to 5 years past the end of the last rate period by dynamically creating an additional calendar period that ends on the study end date and uses the same rates as the last calendar period.