The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.


R-package SMILES

.

Sequential Methods In Leading Evidence Synthesis
[Version] [Date] Lifecycle: stable

.


Table of content:


About SMILES

SMILES is an R package which is to provide a useful collection of functions designed to apply sequential method in data synthesis and evidence evaluation.


Dependencies and installation

Package SMILES is developed based on various packages using R (version 4.2.2). Therefore, those packages are concurrently installed with package SMILES. The main dependency of package SMILES is package meta (note: meta version 7.0-0).


Formal released package SMILES can be installed from CRAN via R with following syntax:

install.packages("SMILES")


Flow and functions

[Functions]

Users can import their data and do relevant tests or graphics using functions in package SMILES. The present package consists of two functions listed as follows.


Steps for squential analysis and visualization:


Examples

3. Sequential analysis

The following syntax demonstrates how user can carry out sequential analysis (example of the study by Fleiss 1993 in package meta)

DoTSA(Fleiss1993bin, 
     source = study, 
     time = year,
     r1 = d.asp, 
     n1 = n.asp, 
     r2 = d.plac, 
     n2 = n.plac, 
     measure = "RR",
     PES = 0.1,
     RRR = 0.2,
     group = c("Aspirin", "Placebo"))

Then, the returns are listed as follows:

#> Summary of sequential analysis (main information)
#>  Acquired sample size: 28003
#>  Required sample size (heterogeneity adjusted): 21344
#>  Cumulative z score: -2.035
#>  Alpha-spending boundary: 1.711 and -1.711
#>  Adjusted confidence interval is not necessary to be performed.
#> 
#> Summary of sequential analysis (additional information)
#>  1. Assumed information
#>  1.1. Defined type I error: 0.05
#>  1.2. Defined type II error: 0.2
#>  1.3. Defined power: 0.8
#>  1.4. Presumed effect: 0.025
#>       (risks in group 1 and 2 were 9.87315825% (expected) and 12.34144781% respectively; RRR = 0.2)
#>  1.5. Presumed variance: 0.101
#> 
#>  2. Meta-analysis
#>  2.1. Setting of the meta-analysis
#>  Data were pooled using inverse variance approach in random-effects model with DL method.
#>  2.2. Result of the meta-analysis 
#>  Log RR: -0.113 (95% CI: -0.222 to -0.004)
#>  
#>  3. Adjustment factor 
#>  The required information size is calculated with adjustment factor based on diversity (D-squared). Relevant parameters are listed as follows.
#>  3.1. Heterogeneity (I-squared): 39.6%
#>  3.2. Diversity (D-squared): 76%
#>  3.3. Adjustement factor: 4.103

Users could simply visualize the result of sequential analysis using argument TRUE for parameter plot in the function DoTSA().


Coding conventions

There are some rules for version numbering in package SMILES (June 20, 2023). Basically, version number consists of three integers with a period between them (eg. version 1.0.0).

  1. Updating the first integer refers to package update(s) with new methodological impact.

  2. Changing the second integer refers to package update(s) with new function(s) without new methodological impact.

  3. Updating the third integer refers to formal modification(s) of existed function(s).


This package is mainly written according to Google’s R style. For readers, details of naming rules are listed as follows:

  1. .R file is named using lower case with underscore “_” between words (e.g. do_sequential_analysis.R).

  2. function is named using verb or verb with noun, and the first character of each word is written in capital letter (e.g. DoTSA()).

  3. object is named using noun with the first word in lower case, but the first character of rest words is written using capital letter (e.g. dataCases).

  4. variable is named using noun written in lower case. Words of variable name are separated by “.” if a variable name consists of more than two words (e.g. data$RIS).


Common-used prefix in package SMILES are listed as follows:

  1. angl... refers angle of text.

  2. clr... refers to color.

  3. lgc... refers to logic value.

  4. szFnt... refers to font size.

  5. szLn... refers to line width.

  6. szPnt... refers to point size.

  7. txt... refers text (string).

  8. typLn... refers type of line.

  9. typPnt... refers type of point.


License and disclamer

This package is developing by Enoch Kang and licensed under the GPL-3 License.


DISCLAIMER
Last updated July 26, 2024


To do list

Task force will keep update package SMILES for relevant issues.

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.