joinpoint.seerdata: Read in and format SEER*Stat data

In JPSurv: Joinpoint Model for Relative and Cause-Specific Survival

Read in and format SEER*Stat data

Description

A function that reads in and format SEER*Stat data in a single step. Either numeric values or value labels can be imported.

Usage

joinpoint.seerdata(seerfilename,newvarnames,UseVarLabelsInData=FALSE)

Arguments

seerfilename	The file name of the seer files. Here one needs two files: the seer directory file with name extention 'dic' and the seer data file with the same name of the directory file but different name extention, i.e. 'txt'.
newvarnames	A list of key words used for referencing the variable in the seer directory file and data file.
UseVarLabelsInData	A logic value or character variables giving variable names. If true or the variable names, then variable labels read from the dic file will replace associated numeric values in the data.frame object, which stores data from the associated data file, for all vars in dic or those (names of which are given by UseVarLabelsInData). If false, then data read from the associated data file won't be changed.

Value

A data frame containing the SEER*Stat data read in.

Examples

# For this example we will be referencing the SEER*Stat session that was used to 
# create the breast.example data included with the package.
# If the "breast.example.txt" is the output data file from SEER*Stat, then joinpoint.seerdata 
# can be used to input the data quickly, while taking into account the relevant information
# in the accompanying dictionary file.
# Input data is stored in breast.example
# breast.data = joinpoint.seerdata(seerfilename="breast.example", 
#                    newvarnames=c("Age_groups","Breast_Stage","Year_of_diagnosis_1975"),
#                    UseVarLabelsInData=FALSE)
# breast.data = joinpoint.seerdata(seerfilename="breast.example", 
#                    newvarnames=c("Breast_Stage","Year_of_diagnosis_1975"),
#                    UseVarLabelsInData=c("Breast_Stage","Year_of_diagnosis_1975"))
# The breast.data object can immediately be used as input to the joinpoint modeling function.

JPSurv documentation built on June 8, 2025, 12:11 p.m.