SetMethods (version 2.1)

xy.plot.lat: Function producing enhanced XY plots with Lattice

Description

xy.plot.lat produces XY plots using the lattice package and provides values for consistency, Haesebrouck's consistency, coverage, RoN, and PRI. Several graphic parameters can be decided by the user.

Usage

xy.plot.lat(x, y, 
            ylim = c(-0.05, 1.05), xlim = c(-0.05, 1.05), 
            main = "", pch = 19, col = "black", cex.fit = 1, 
            ylab = "Outcome", xlab = "Condition", 
            pos.fit = "top", strip.cex = 0.8, 
            necessity = FALSE, show.fit = TRUE, case.lab = FALSE, 
            lab.pos = 4, labs = NULL, 
            show.hv = TRUE)

Arguments

x

vector containing the condition.

y

vector containing the outcome.

ylim

limits of y-axis. The default is c(-0.05, 1.05).

xlim

limits of x-axis. The default is c(-0.05, 1.05).

main

an overall title for the plot. The default is "". See ?xyplot.

pch

plotting "character". The default is 19. See ?pch or ?xyplot.

col

color for the plotting "character". The default is "black". See ?par or ?xyplot.

cex.fit

character expansion for the parameters of fit. The defaut is 0.6. See ?pch or ?text.

ylab

a title for the y-axis. The default is "Outcome". See ?title or ?xyplot.

xlab

a title for the x-axis. The default is "Condition". See ?title or ?xyplot.

pos.fit

character. Indicates the position of the parameters of fit. The positions are "top", which places the parameters of fit in a strip on top of the plotting area, or "corner", which places the parameters of fit in the corner of the plotting are. The default is pos.fit = "top".

strip.cex

character expansion for the parameters of fit when pos.fit = "top". The defaut is 0.8. See ?pch or ?text.

necessity

logical. Indicates if the parameters of fit are calculated for a sufficient or necessary condition. The default is FALSE, therefore it calculates the parameters of fit for sufficiency. To get the parameters of fit for necessary conditions set necessity as TRUE.

show.fit

logical. Indicates if parameters of fit have to be shown. The default is TRUE.

case.lab

logical. Indicates if cases have to be labeled. The default is TRUE.

lab.pos

a position specifier for the case labels. Values of 1, 2, 3 and 4, respectively indicate positions below, to the left of, above and to the right of the specified coordinates. The default is 4. See ?text.

labs

the vector of case labels. The default is NULL.

show.hv

logical. Indicates if horizontal and vertical lines at 0.5 have to be shown. The default is TRUE.

Value

It returns an enhanced XY plot using the lattice package.

References

Haesebrouck, T. (2015) Pitfalls in QCA's consistency measure. Journal of Comparative Politics 2:65-80.

Ragin, C. C. (2008) Redesigning Social Inquiry: Fuzzy Sets and Beyond, The Chicago University Press: Chicago and London.

Schneider, C. Q., Wagemann, C. (2012) Set-Theoretic Methods for the Social Sciences, Cambridge University Press: Cambridge.

Schneider, C. Q., Wagemann, C., Quaranta, M. (2012) How To... Use Software for Set-Theoretic Analysis. Online Appendix to "Set-Theoretic Methods for the Social Sciences". Available at www.cambridge.org/schneider-wagemann

Sarkar, D. (2008) Lattice: Multivariate Data Visualization with R, Springer: Berlin.

Examples

# NOT RUN {
# Generate fake data to have perfect necessity
set.seed(123)
x <- runif(60, 0, 1)
y <- runif(60, 0, 1)

for(i in 1:length(y)) {
    while(x[i] < y[i]) {
        y[i] <- runif(1, 0, 1)
        x[i] <- runif(1, 0, 1)
    }
}

# Default with blue dots and pch = 1
xy.plot.lat(x, y, pch = 1, col = "blue")

# Parameters of fit in the corners with blue dots and pch = 1
xy.plot.lat(x, y, pch = 1, col = "blue", pos.fit = "corner")
# }