ginimap: Lorentz curve and map

View source: R/ginimap.R

ginimapR Documentation

Lorentz curve and map

Description

The function ginimap() computes a Lorentz curve from name.var and calculates the Gini Index associated to name.var.

Usage

ginimap(sf.obj, name.var, criteria = NULL,
  carte = NULL, identify = NULL, cex.lab = 0.8, pch = 16, col = "lightblue3",
  xlab = "", ylab = "", axes = FALSE, lablong = "", lablat = "")

Arguments

sf.obj

object of class sf

name.var

a character; attribute name or column number in attribute table

criteria

a vector of boolean of size the number of Spatial units, which permit to represent preselected sites with a cross, using the tcltk window

carte

matrix with 2 columns for drawing spatial polygonal contours : x and y coordinates of the vertices of the polygon

identify

if not NULL, the name of the variable for identifying observations on the map

cex.lab

character size of label

pch

16 by default, symbol for selected points

col

"lightblue3" by default, color of bars on the histogram

xlab

a title for the graphic x-axis

ylab

a title for the graphic y-axis

axes

a boolean with TRUE for drawing axes on the map

lablong

name of the x-axis that will be printed on the map

lablat

name of the y-axis that will be printed on the map

Details

Users have the possibility to choose a threshold by mouse clicking on the Lorentz curve or by specifying it in the menu. The corresponding pair (F,G) and the value of name.var are then printed on the graph and the sites with a value of name.var lower or equal to the threshold are then selected on the map.

Value

In the case where user click on save results button, a vector of integer is created as a global variable in last.select object. It corresponds to the number of spatial units selected just before leaving the Tk window.

Note

The Gini Index is given in the tcltk window (see function gini for the formula used to calculate it).

Author(s)

Thomas-Agnan C., Aragon Y., Ruiz-Gazen A., Laurent T., Robidou L.

References

Thibault Laurent, Anne Ruiz-Gazen, Christine Thomas-Agnan (2012), GeoXp: An R Package for Exploratory Spatial Data Analysis. Journal of Statistical Software, 47(2), 1-23.

See Also

gini

Examples

######
# data eire
require(sf)
eire <- st_read(system.file("shapes/eire.shp", package="spData")[1])

# a basic usage ...
ginimap(eire, "INCOME")

## Not run:  
# ... with options
ginimap(eire, "INCOME", criteria = (eire$pale == 1),
  identify = "names", pch = 5, col = "orange", 
  axes = TRUE, lablong = "X", lablat = "Y")

## End(Not run)

tibo31/GeoXp documentation built on April 8, 2023, 7:50 a.m.