R语言 SEER2R包 write.SeerStat()函数中文帮助文档(中英文对照)

loveR

write.SeerStat(SEER2R)
write.SeerStat()所属R语言包：SEER2R

                                         write data and dictionary information to files
                                         写数据和字典信息文件

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

write.SeerStat writes data and dictionary information to files in the format of SEER*STAT export files
write.SeerStat SEER * STAT导出文件的格式写入数据字典信息文件


用法----------Usage----------


write.SeerStat(myData, DICfileName, TXTfileName = NULL, UseVarLabelsInTxtFile = TRUE, LabVarsNames = NULL,...)



参数----------Arguments----------

参数：myData
:  A data.frame object to be output. It may have an attribute 'DICInfo'. If no 'DICInfo' defined, then a default 'DICInfo' will be created and used for generating the dic file.  
：一个要输出的数据框对象。它可能有属性“DICInfo”。如果没有“DICInfo”的定义，然后一个默认的DICInfo“将被创建并用于生成dic文件。


参数：DICfileName
: filename of the dic file. The default extention is 'dic'.  If 'DICfileName' does not contain at the end a string '.dic' (letter case does not matter), then '.dic' will be added.  
：dic文件的文件名。默认的延伸，是“DIC。如果DICfileName不包含在一个字符串的结束。“DIC”（字母大小写无所谓），然后是“DIC”将被添加。


参数：TXTfileName
: filename of the associated data file. If TXTfileName = NULL, then a string of  DICfileName with extention substituted by 'txt' (for uncompressed data file) or 'gz' (for gzip compressed data file) will be used (whether 'txt' or 'gz' depends on the attribute variable 'DICInfo' of the data.frame object 'myData').  
：文件名相关联的数据文件。如果TXTfileName = NULL，然后用一个字符串的DICfileName延伸取代txt结尾的（未压缩数据文件）或“广州”（gzip压缩的数据文件）将被使用（“TXT”或“广州”是否取决于属性变量的“DICInfo的数据框对象的MYDATA）。


参数：UseVarLabelsInTxtFile
:  a logic value. If true, then variable labels will be output into the associated data file. If false, then the numeric  values will be output. The variables, labels of which are to be output, are   all character or factor columns of 'myData' if LabVarsNames = NULL, otherwise they are defined by 'LabVarsNames'.  
：一个逻辑值。如果为true，则变量标签将被输出到相关的数据文件。如果为false，然后将输出的数值。的变量，其中的标签将被输出，当LabVarsNames = NULL，否则他们定义由LabVarsNames的所有字符或因子列“MYDATA。


参数：LabVarsNames
:  a name list of variables in the data.frame 'myData', labels of which will be output into the associated data file, instead of numeric values.  
：变量的名称列表中的数据框的MYDATA，标签将被输出到相关的数据文件，而不是数字值。


参数：...
: Arguments to be passed to write.table for writing to the associated data file.  
：参数要传递给write.table以书面形式向相关的数据文件。


Details

详细信息----------Details----------

“write.SeerStat” writes an object of data.frame to a SEER*Stat data file and  creates the associated dictionary file that is in the format of SEER*Stat dictionary files.  The variable names of the SEER*Stat data file are the same as the column names of the data.frame object.  The contents of sections of dictionary file are based on the attribute variable “DICInfo" of the data.frame object.  If users do not define an attribute variable “DICInfo" of the data.frame object, then default values will be used.
“write.SeerStat写道：”一个对象的数据框到SEER * Stat数据文件，并创建相关的字典文件，该文件是在SEER统计字典文件的格式。 SEER统计数据文件的变量名称相同的列名的数据框对象。词典文件的部分的内容的基础上的数据框对象的属性变量“DICInfo”。如果用户没有定义一个属性的变量“DICInfo”的数据框对象，则默认值将被使用。


值----------Value----------

The 'DICInfo' actually used for writing to the dictionary file and the associated data file will be returned.
“DICInfo实际用于写作的字典文件和相关的数据文件将被退回。


（作者）----------Author(s)----------



Jun Luo

Maintainer: Jun Luo <rpackages@gmail.com>




参考文献----------References----------



参见----------See Also----------

read.SeerStat, SEER2R
read.SeerStat，SEER2R


实例----------Examples----------



#load testing data: there are three data objects, i.e. SEER2RTestData1,SEER2RTestData2,SEER2RTestData3 [负载测试数据：数据对象有三个，即SEER2RTestData1，SEER2RTestData2，SEER2RTestData3]
data("SEER2RTestdata");

#create one SEER*STAT export dic and the associated text data file for testing purpose[创建一个SEER * STAT出口DIC和相关的文本数据文件，用于测试目的，]
dicinfoused = write.SeerStat(SEER2RTestData2, DICfileName = "testrun1.dic",UseVarLabelsInTxtFile=FALSE);

#usage of read.SeerStat[使用的read.SeerStat的]
mydata = read.SeerStat("testrun1.dic",UseVarLabelsInData=FALSE);
#get informatin inside the dic file[dic文件内得到informatin]
DICInfo = attr(mydata, "DICInfo");

#change names of columns whose names contains strings "site" or "sex"; [更改名称的列，其名称中包含字符串“网站”或“性”;]
#the order of strings does not matter[的字符串的顺序并不重要]
testdatanewnames = attr(mydata,"assignColNames")(mydata,c("sex","site"));

#extract columns whose names contains strings "site" or "sex";[提取列，其名称中包含字符串“网站”或“性”;]
testdata = attr(mydata,"getSubDataByVarName")(mydata,c("site","sex"));

#usage of write.SeerStat[使用的write.SeerStat的]
dicinfoused = write.SeerStat(mydata, DICfileName = "testrun2.dic", UseVarLabelsInTxtFile = FALSE);


转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。