SCORE-SeqTDS is a command-line program written in the C language to implement the methods described in Lin *et al.* (2013) for analyzing primary and secondary quantitative traits under trait-dependent sampling. The primary trait is the trait that is used to select subjects for sequencing, and all other traits are treated as secondary. Each quantitative trait is related to a genetic variable and possibly covariates through a linear regression model. Both the maximum likelihood estimation (MLE) and standard least-squares (LS) methods are available. The MLE method properly accounts for trait-dependent sampling whereas the LS method does not. The LS method is the ideal choice for random sampling and is approximately correct for analyzing secondary quantitative traits in case-control or case-only studies with rare diseases. SCORE-SeqTDS performs the LS analysis on secondary quantitative traits for random sampling, case-control and case-only sampling. For random sampling, all traits are treated as secondary (because the sampling does not depend on any particular trait.) The sampling scheme is specified through the option -sampling. A table in the OPTIONS section below summarizes the available analysis options for different sampling schemes.

The genetic variable pertains to the genotype in the single-variant analysis and to the burden score in the rare-variant analysis. The burden score may be determined externally (default) or internally. Use the option -gfile to specify the file that contains the external genetic variables. Otherwise, use the options -gfile and -mfile to specify the genotype file and the mapping file, respectively, for the internal creation of the burden scores. Use the option -test to request one of the six tests (T1, T5, MB, VT, SKAT, and customized test) under the additive genetic model (default). The T1, T5, VT, and SKAT tests under the dominant (recessive) genetic model can be obtained by using the option -dominant (-recessive). There are options for the minor allele frequency (MAF) upper bound, the minor allele count (MAC) lower bound and the call rate (CR) lower bound. Under the additive or dominant (recessive) model, MAC is defined as the number of subjects with at least one (two) observed mutation. A genetic variable is excluded from analysis if its MAC is smaller than the MAC lower bound or its CR is smaller than the CR lower bound. When the burden score is created internally, a variant is deleted if its MAF is greater than the MAF upper bound or its CR is smaller than the CR lower bound. By default, the MAF upper bound is 0.05, the MAC lower bound is 1 and the CR lower bound is 0. The MAFs may be determined internally (i.e., calculated from the genotype file) or externally (i.e., input in the mapping file). The MAF thresholds in the VT test can be determined internally (i.e., based on the unique MAFs among the aggregating variants) or externally (i.e., input in the mapping file).

If the quantitative trait of interest is measured in multiple studies, either as primary or secondary trait, then SCORE-SeqTDS can be used to analyze the trait of interest for one study at a time, and the results can be combined through meta-analysis. For T1, T5 and MB, SCORE-SeqTDS outputs the score statistics and their variance estimates. For the VT, SKAT and customized tests, SCORE-SeqTDS outputs the score vector and the information matrix. The results from multiple studies can be combined through the accompanying program MASS.

**SCORE-SeqTDS** [**-sampling** `sampling`] [**-method** `method`] [**-nsec** `nsec`] [**-pfile_seq** `phenofile.seq`] [**-cov** `cov`] [**-pfile_nonseq** `phenofile.nonseq`] [**-rounding** `NMAX`] [**-gfile** `genofile`] [**-mfile** `mapfile`] [**-wfile** `wfile`] [**-test** `test`] [**-dominant** `] [`**-recessive** `][`**-ofile** `outfile`] [**-msglog** `msglog`] [**-MAF** `MAF_UB`] [**-MAC** `MAC_LB`] [**-CR** `CR_LB`] [**-log** `] [`**-INT** `] [`**-R-INT** `SD_TYPE`]

Option | Parameter | Default | Description |
---|---|---|---|

-sampling | {sampling} |
TDS | Specify the sampling design of the study. There are three options: “TDS” (trait dependent sampling), “CC” (case-control sampling), and “random” (case-only or random sampling). The default is “TDS”. |

-method | {method} |
MLE | Specify the method to be used. There are two options: MLE and LS. For trait-dependent sampling, the default is MLE. For random sampling, case-control and case-only sampling, this option is invalid because only the LS method is applicable. |

-nsec | {nsec} |
0 for trait-dependent sampling;
1 for random sampling, case-control and case-only sampling |
Specify the number of secondary traits (nsec) to be analyzed. nsec = 0 means to analyze the primary trait only. For random-sampling, case-control and case-only sampling, nsec should be set to an integer ≥ 1 since only secondary traits are analyzed. |

-pfile_seq | {phenofile.seq} |
`pheno_seq.txt` |
Specify the file that contains the trait(s) and covariates (if any) for the sequenced subjects. |

-cov | {cov} |
No | Specify the file for selecting covariates. |

-pfile_nonseq | {phenofile.nonseq} |
`pheno_nonseq.txt` |
Specify the file that contains the primary trait for the non-sequenced subjects. |

-rounding | {NMAX} |
`500` |
Round the values of the primary trait such that the number of unique values is at most NMAX, which is any positive integer. It is suggested that NMAX be smaller than 500 to speed up computation. This option is only valid under TDS. |

-gfile | {genofile} |
`geno.txt` |
Specify the genotype file. The file content is described in the table of the INPUT FILES section. |

-mfile | {mapfile} |
`mapping.txt` |
Specify the gene-SNP mapping file. |

-wfile | {wfile} |
No | Specify the file that contains the customized weight matrix. |

-test | {test} |
Single variant test | Specify the rare-variant test to be performed. There are six options: T1, T5, MB, VT, SKAT, and customized. Refer to the Options section of the software SCORE-Seq for a detailed description of these tests. |

-dominant | No | Use the dominant genetic model for the T1, T5, VT, and SKAT tests. | |

-recessive | No | Use the recessive genetic model for the T1, T5, VT, and SKAT tests. | |

-ofile | {outfile} |
`output.txt` |
Specify the output file. |

-msglog | {msglog} |
`log` |
Specify the prefix for the names of log files. |

-MAF | {MAF_UB} |
0.05 | Specify the MAF upper bound, which is any number between 0 and 1. |

-MAC | {MAC_LB} |
1 | Specify the MAC lower bound, which is any integer. |

-CR | {CR_LB} |
0 | Specify the call rate lower bound, which is any number between 0 and 1. |

-log | No | Apply the natural logarithm to the primary trait. | |

-INT | No | Apply inverse normal transformation (INT) to the trait of interest. | |

-R-INT | {SD_TYPE} |
1 | Apply rescaled inverse normal transformation (R-INT) to the trait of interest using conventional standard deviation (if SD_TYPE=1) or the robust standard deviation (if SD_TYPE=2) described here http://en.wikipedia.org/wiki/Median_absolute_deviation. |

The MLE method is based on the maximum likelihood estimation of an observed-data likelihood that reflects trait-dependent sampling and thus is valid and efficient. Let `Y`_{1} be the primary trait and `Y`_{2} be the secondary trait. Also, let `G`_{1} and `G`_{2} denote the corresponding genetic variables and `Z _{1}` and

The LS method is based on the standard least-squares estimation. For studying the genetic effect on the primary trait, the LS method is applied to the linear regression model relating `Y`_{1} to (`G`_{1}, `Z`_{1}). For studying the genetic effect on the secondary trait, there are two versions of the LS method: LS-M is based on the linear regression of `Y`_{2} on (`G`_{2}, `Z`_{2}) and LS-C is based on the linear regression of `Y`_{2} on (`Y`_{1}, `G`_{2}, `Z`_{2}). All hypothesis tests are based on the score statistics.

Sampling design | MLE on the primary trait | MLE on secondary trait(s) | LS on the primary trait | LS on secondary trait(s) |
---|---|---|---|---|

Trait-dependent sampling | Option: (default) Output: MLE |
Option: -nsec nsec
Output: MLE |
Option: -method LS Output: LS |
Option: -method LS -nsec nsecOutput: LS-M, LS-C |

Case-control sampling | N/A | N/A | N/A | Option: -sampling CC-nsec nsecOutput: LS-M, LS-C |

Case-only sampling or random sampling |
N/A | N/A | N/A | Option: -sampling random-nsec nsecOutput: LS |

The input files consist of a phenotype file for the sequenced subjects, a phenotype file for the non-sequenced subjects, a genotype file for the sequenced subjects and a mapping file. In all input files, the field separator character should be tab-delimiter and missing values are denoted by “-999” or “NA”.

The 1^{st} row contains the header. The remaining rows represent sequenced subjects. Under trait dependent-sampling or case-control sampling, the 1^{st} column pertains to the primary trait. For trait-dependent sampling, the primary trait is quantitative. For case-control sampling, the primary trait takes the value 0 or 1. Under case-only or random sampling, the 1^{st} column is empty. If there are `nsec` secondary quantitative traits, then the 2^{nd} to the (`nsec` + 1)^{th} columns pertain to the secondary traits. The remaining columns are covariates if there are any. The order of subjects in the rows of this file should be identical to the order of subjects in the columns of the genotype file. No missing value is allowed on the primary trait and all variables should be numeric.

If the covariates are different among traits, a file with the selection indicators for covariates should be specified. This file contains one matrix with entries 0 or 1. The value of 1 indicates the covariate on the column is used by the trait on the row, the value of 0 indicates otherwise. The order of the traits on the rows and covariates on the columns in this file should be the same as the order in the phenotype file for sequenced subjects.

The first column contains the values of the primary trait for the non-sequenced subjects and the second column contains the frequencies of the trait values. If only the first column is provided, the trait values are all assumed to have frequencies of 1. No missing value is allowed. This file is not needed if the LS method is specified.

*Note: To speed up computation, it is suggested that the values of the primary trait (1 ^{st} column) in both phenotype files are rounded such that there is a total of at most 500 distinct values. If that is not the case, the program will automatically round the values to provide at most 500 unique values. *

The table below shows the option setup, genotype file, mapping file, and weight file for different scenarios.

Option | Genotype file | Mapping file and weight file | |
---|---|---|---|

Single-variant analysis | -gfile genofile |
The 1^{st} column contains the SNP ID. The remaining columns contain the genotypes. All genotype values are numeric. |
N/A |

Rare-variant analysis: burden scores provided by the user | -gfile genofile |
The 1^{st} column contains the gene ID. The remaining columns contain the burden scores. All scores are numeric. |
N/A |

Rare-variant analysis: T1, T5, MB, VT, or customized burden scores created internally | -test test
-gfile -mfile |
The 1^{st} column contains the SNP ID. The remaining columns contain the genotypes. The genotype takes the value 0, 1, or 2. |
The mapping file contains at least two columns. The first column is the gene ID, and the second column is the SNP ID. Each row represents a unique gene-SNP pair. The third column contains the external MAFs if they are to be used in the analysis. The fourth column contains the external MAF threshold indicators, which indicate by the values 1 vs 0, whether the thresholds will be used in the VT test. For each gene, the total number of thresholds cannot exceed 20. To perform the customized test, a weight file should be specified. The first two columns of the weight file contain the same information as that of the mapping file and the remaining columns contain vectors of weights. No missing values are allowed in either the mapping file or the weight file. |

- Tests with a single genetic variable (single-variant, T1, T5, or MB test)

The format is shown as follows:The 1^{st}column contains the gene ID and the remaining columns under each main header <Trait_Method> contain the test statistic, the p-value, the genetic effect estimate, its standard error estimate, and the warning message for each “Trait” and “Method” combination. For example, if the user wants to analyze two secondary traits, say BMI and BP, using the MLE method (option: “-nsec 2″), there will be 10 columns following the ID column in the output file, and the two main headers will be “BMI_MLE” and “BP_MLE”. If the user wants to analyze these two secondary traits using the LS method (option: “-method LS -nsec 2″), there will be 20 columns following the ID column since there are two versions of the LS method for the secondary trait(s), and the 4 main headers will be “BMI_LS-M”, “BMI_LS-C”, “BP_LS-M”, and “BP_LS-C”. Invalid values are denoted by “NA” in the output file.Different types of warning message are as follows:

Singular_covariates: Covariate matrix becomes singular after removing subjects with missing genetic variable or missing “Trait”.

Non-convergence: EM algorithm does not converge.

Low_MAC: MAC is smaller than MAC_LB after removing subjects with missing “Trait”.

Singular_score: The genetic variable contains only one distinct value after removing subjects with missing “Trait”.

Undefined_V: Variance estimate of the score statistic is undefined (numerically 0 or negative).

Pvalue_Fail: p-value calculation fails to obtain the desired level of accuracy.

Var_Null: No valid genetic variable for the test.

- Tests with multiple genetic variables (VT, SKAT, or customized test)The 1
^{st}column contains the gene ID and the remaining columns under each main header <Trait_Method> contain the test statistic, the p-value, and the warning message for each “Trait” and “Method” combination.

Log files include a set of files for each “Trait” and “Method” combination. These files contains the MAC, the score vector, the information matrix, and some other related information. The name of the file is *“log_trait_method”*: *log* is the name specified by the option -msglog; *method* is the method used to analyze the *trait*. For example, if the user wants to analyze two secondary traits (option “-nsec 2”) under trait dependent sampling (option “-sampling TDS”), say BMI and BP, using the MLE method (option “-method MLE”), there will be 2 log files with names “*log*_BMI_MLE” and “*log*_BP_MLE”. If the user wants to analyze these two secondary traits using the LS method (option “-method LS”), then there will be 4 log files with names “*log*_BMI_LS-M”, “*log*_BMI_LS-C”, “*log*_BP_LS-M”, and “*log*_BP_LS-C”. Invalid values in the output files are denoted by “NA”. The log files for multiples studies can be combined through the accompanying program MASS. We describe below the log file for each test.

- Tests with a single genetic variable (single-variant, T1, T5, or MB test)

The 1^{st}column contains the gene ID and the 2^{nd}column contains the MAC. The remaining columns contain the score statistic and its variance estimate. - VT test

For each gene,*“log_trait_method”*contains the MAF thresholds, the MACs, the (vector-valued) score statistic, and the information matrix. The following is an example for two genes: - SKAT test

For a set of SNPs within a gene,*“log_trait_method”*contains the SNP IDs, the MAFs, the MACs, the number of non-missing genotypes, the counts of homozygous reference, heterozygous, and homozygous alternative, the (vector-valued) score statistic, and the information matrix. The following is an example for two genes: - Customized test

For a set of genetic scores based on the customized weight matrix within a gene,*“log_trait_method”*contains the weight identifiers, the MACs, the score statistic and the information matrix. The following is an example for two genes:

The example includes a phenotype file for the sequenced subjects “

” , a phenotype file for the non-sequenced subjects “`ldl_seq.txt`

” and a genotype file “`ldl_nonseq.txt`

“. We want to apply the MLE method to two secondary traits BMI and BP (-nsec 2), apply the MAC lower bound of 2 (-MAC 2) and perform the log-transformation on the primary trait (-log). Enter the command`ldl_geno100.txt`

$ SCORE-SeqTDS -nsec 2 -pfile_seq ldl_seq.txt -pfile_nonseq ldl_nonseq.txt -gfile ldl_geno100.txt -ofile ldl_output.txt -MAC 2 -log

to obtain the results given in the output file “

” , and the log files “log_BMI_MLE” and “log_BP_MLE” .`ldl_output.txt`

Alternatively, we can use “

” as the phenotype file for the non-sequenced subjects and obtain the same results by entering the command`ldl_nonseq2.txt`

$ SCORE-SeqTDS -nsec 2 -pfile_seq ldl_seq.txt -pfile_nonseq ldl_nonseq2.txt -gfile ldl_geno100.txt -ofile ldl_output.txt -MAC 2 -log

If there are a large number of genetic variables, it is preferable to use multiple CPUs. To this end, the user can divide the genotype file into several files, each of which contains a subset of the original genetic variables. Then the software can be run separately for each genotype file on a different CPU. In this way, it takes approximately 1/`K` (`K` is the number of jobs that are split into) of the original time to complete the whole set of analysis. We provide a R script to illustrate this approach. In that example, 100 genotype files are created from the original genotype file and 100 jobs are submitted simultaneously to multiple CPUs.

Dan-Yu Lin, Donglin Zeng, and Zheng-Zheng Tang (2013). Quantitative Trait Analysis in Sequencing Studies Under Trait-Dependent Sampling. Proceedings of the National Academy of Sciences of the United States of America, 110, 12247-12252.

executable (zip archive) **»**SCORE-SeqTDS-7.1-linux64-static.zip

zip archive **»**SCORE-SeqTDS-4.1-example.zip

Version | Date | Description |
---|---|---|

1 | May 23, 2012 | First version released |

2 | Sep 04, 2012 | Added the option “-sampling” to specify the type of sampling design.
Added the option “-rounding” to reduce the number of unique values on the primary trait. Added the variable threshold (VT) test. |

3 | Mar 20, 2013 | Added the SKAT test.
Added the customized test. Allowed the covariates of traits to be different. |

4 | Nov 27, 2013 | Changed the format of the phenotype file for non-sequenced subjects.
Changed the format of the output and the log files. Changed the name of the option “-burden” to “-test”. |

4.1 | Feb 23, 2014 | Added the number of observation for each SNP in the SKAT log file. |

5 | June 01, 2015 | Added the options –INT and –R-INT. |

7 | July 29, 2015 | Added number of samples (#Samples) in the heading for the all the log files.
In the SNP log output, added columns for counts of homozygous reference, heterozygous, and homozygous alternative. |

7.1 | November 18, 2015 | Output statistics for monophonic sites in the SNP log file.
In the SNP log file, calculate MAC under the additive model instead of the dominant model. For the secondary trait analysis, the quality-control statistics are based on the subjects with non-missing secondary trait. Modify the covariance estimator for score statistics when the trait is continuous. |

University Operator: (919) 962-2211 | © 2020 The University of North Carolina at Chapel Hill |