Display a one-line Summary Statistics Report

Description

Displays a concise one-line summary statistics report, below a heading line, consisting of sample size, number of NAs in the input vector; minimum, maximum and quartiles; robust estimates of the standard deviation (MAD and interquartile based measure); mean, standard deviation and coefficient of variation (%); and the standard error, and lower and upper 95% confidence limits on the mean. See Details for the results of setting log = TRUE. Optionally the data may be logarithmically (base 10) transformed.

Usage

1
gx.summary1(xx, xname = deparse(substitute(xx)), log = FALSE)

Arguments

xx

name of the variable to be processed.

xname

by default the character string for xx is used for the title. An alternate title can be displayed with xname = "text string", see Examples.

log

if the summary statistics are required following a log10 transformation, set
log = TRUE.

Details

Setting log = TRUE results in a log transformation for the parametric statistical estimates. The maximum, minimum, quartiles and robust estimates of spread are estimated and reported in natural measurement units. Of the parametric statistics, the mean (the geometric mean) and 95%confidence are reported backtransformed into natural measurement units. If all the results are required following a log10, or some other transformation, this can be achieved by executing the transformation in the call, e.g., gx.summary1(log10(Cu)) or gx.summary1(sqrt(Cu)), and setting log = FALSE.

Note

Any less than detection limit values represented by negative values, or zeros or other numeric codes representing blanks in the data, must be removed prior to executing this function, see ltdl.fix.df.

Any NAs in the data vector will be removed prior to computation in function gx.stats.

For a more extensive summary statistics display, see gx.summary2. For summary graphical displays see shape or inset.

Author(s)

Robert G. Garrett

See Also

gx.summary, gx.stats, ltdl.fix.df, remove.na, gx.summary2

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
## Make test data available
data(kola.o)
attach(kola.o)

## Generates an initial display
gx.summary1(Cu)

## Provide a more informative display
gx.summary1(Cu, xname = "Cu (mg/kg) in <2 mm Kola O-horizon soil")

## As above but with a log10 transformation to display
## the geometric mean, etc.
gx.summary1(Cu, xname = "Cu (mg/kg) in <2 mm Kola O-horizon soil", log = TRUE)

## Detach test data
detach(kola.o)

Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.