GsymPoint-package: Estimation of the Generalized Symmetry Point, an Optimal...

GsymPoint-packageR Documentation

Estimation of the Generalized Symmetry Point, an Optimal Cutpoint in Continuous Diagnostic Tests

Description

Continuous biomarkers or diagnostic tests are often used to discriminate between healthy and diseased populations. In clinical practice, it is useful to select an appropriate cutpoint or discrimination value c which defines the positive and negative test results. Several methods for selecting optimal cutpoints in diagnostic tests in the sense of a specific optimality criterion have been proposed in the literature depending on the underlying reason for this choice (see for example, Youden, 1950; Pepe, 2003; Liu, 2012; Rota and Antolini, 2014). One of the best-known methods is based on the Symmetry point, also known in the literature as the point of equivalence (Greiner et al., 1995; Defreitas et al., 2004; Adlhoch et al., 2011), defined as the point where the sensitivity and specificity measures are equal. Taking into account the costs associated to the false positives and false negatives misclassifications, the Generalized Symmetry point can be defined. This package allows the user to compute the Generalized Symmetry point as the optimal cutpoint for a diagnostic test or continuous marker. The two methods introduced in López-Ratón et al. (2016) for estimating the Generalized Symmetry point and its sensitivity and specificity accuracy measures have been implemented in this package. One of them is based on the Generalized Pivotal Quantity (Weerahandi, 1993; 1995) and the other based on Empirical Likelihood (Thomas and Grunkemeier, 1975). Numerical and graphical outputs for these two methods are easily obtained.

Details

Package: GsymPoint
Type: Package
Version: 1.1.2
Date: 2023-10-31
License: GPL

The GsymPoint package only requires a data-entry file, which must, at minimum, contain the following variables: diagnostic marker; disease status (diseased/healthy); and whether adjustment is to be made for any categorical covariate of interest, a variable that indicates the levels of this covariate. A standard-type data input structure is used, with each row of the database indicating a patient/case and each column referring to a variable.

The most important functions are gsym.point(), control.gsym.point(), summary.gsym.point() and plot.gsym.point() functions. The gsym.point() function computes the Generalized Symmetry point and its corresponding sensitivity and specificity indexes, according to the method selected. The two methods can be chosen simultaneously for estimating the optimal cutpoint. The control.gsym.point() function is used to set several parameters that are specific of each method, such as the number of simulations or the constants needed for the Empirical Likelihood method. The summary.gsym.point() and plot.gsym.point() functions produce numerical and graphical outputs, respectively.

Author(s)

Mónica López-Ratón, Carmen Cadarso-Suárez, Elisa M. Molanes-López and Emilio Letón

Maintainer: Mónica López-Ratón <monica.lopez.raton@gmail.com>

References

Adlhoch, C., Kaiser, M., Hoehne, M., Mas Marques, A., Stefas, I., Veas, F. and Ellerbrok, H. (2011). Highly sensitive detection of the group A Rotavirus using Apolipoprotein H-coated ELISA plates compared to quantitative real-time PCR. Virology Journal 8, 63.

Defreitas, G.A., Zimmern, P.E., Lemack, G.E. and Shariat, S.F. (2004). Refining diagnosis of anatomic female bladder outlet obstruction: comparison of pressureflow study parameters in clinically obstructed women with those of normal controls. Urology 64, 675-679.

Greiner, M., Sohr, D. and Göbel, P. (1995). A modified ROC analysis for the selection of cut-off values and the definition of intermediate results of serodiagnostic tests. Journal of Immunological Methods 185, 123-132.

Liu, X. (2012). Classification accuracy and cut point selection. Statistics in Medicine 31(23), 2676-2686.

López-Ratón, M., Cadarso-Suárez, C., Molanes-López, E.M. and Letón, E. (2016). Confidence intervals for the Symmetry point: an optimal cutpoint in continuous diagnostic tests. Pharmaceutical Statistics 15(2), 178-192.

López-Ratón, M., Molanes-López, E.M., Letón, E. and Cadarso-Suárez, C. (2017). GsymPoint: An R Package to Estimate the Generalized Symmetry Point, an Optimal Cut-off Point for Binary Classification in Continuous Diagnostic Tests. The R Journal 9(1), 262-283.

Pepe, M.S. (2003). The statistical evaluation of medical tests for classification and prediction. Oxford University Press, New York.


GsymPoint documentation built on Nov. 2, 2023, 5:59 p.m.