ggInterval

ggInterval extends ggplot2 for interval-valued data. It provides plotting functions, data conversion helpers, and examples for symbolic data analysis workflows where each unit is described by lower and upper bounds rather than a single point.

The package was previously released as ggESDA. The current development line focuses on interval-valued visualization and companion tools for building interval data from classical tables.

Highlights in 0.2.5

Adds interval-valued correlation heatmaps through ggInterval_corrplot().
Adds ggInterval_lineplot() for interval time-series style displays, with ggInterval_tsplot() retained as a backward-compatible alias.
Updates histogram, 2D histogram, scatter, radar, PCA, and index-image examples and smoke tests.
Standardizes package citation metadata and dataset/reference documentation.
Includes tests for symbolic covariance and correlation method mappings.

Installation

Install the CRAN release:

install.packages("ggInterval")

Install the latest GitHub release:

# install.packages("remotes")
remotes::install_github("hanmingwu1103/ggInterval@v0.2.5")

Install the current development version:

# install.packages("remotes")
# remotes::install_github("hanmingwu1103/ggInterval")
install.packages("ggInterval", repos = c('https://hanmingwu1103.r-universe.dev', 'https://cloud.r-project.org'))

Quick Start

library(ggInterval)

# Load the built-in interval-valued face measurements
data(facedata)

# Scatter plot
ggInterval_scatterplot(facedata, aes(x = AD, y = BC))

# Histogram
ggInterval_hist(facedata, aes(x = AD), method = "equal-bin", bins = 10)

# 2D histogram with non-equidistant bins
ggInterval_2Dhist(
  facedata,
  aes(x = AD, y = BC),
  method = "unequal-bin"
)$plot

# Correlation heatmap
ggInterval_corrplot(facedata, method = "BG", triangle = "lower")

Main Functions

Visualization

Function	Description
`ggInterval_scatterplot()`	Scatter plot for two interval-valued variables
`ggInterval_scatterMatrix()`	Scatter plot matrix for interval-valued variables
`ggInterval_3Dscatterplot()`	3D scatter plot for three interval-valued variables
`ggInterval_hist()`	Histogram with equal-bin or unequal-bin construction
`ggInterval_2Dhist()`	2D histogram with equal-bin or unequal-bin construction
`ggInterval_2DhistMatrix()`	Matrix of 2D histograms
`ggInterval_MMplot()`	Min-max plot
`ggInterval_CRplot()`	Center-range plot
`ggInterval_indexplot()`	Index plot
`ggInterval_indexImage()`	Index image plot
`ggInterval_boxplot()`	Boxplot for interval-valued variables
`ggInterval_radarplot()`	Radar plot
`ggInterval_lineplot()`	Line plot for interval-valued data
`ggInterval_PCA()`	PCA display for interval-valued data
`ggInterval_corrplot()`	Correlation heatmap for interval-valued variables

Data Conversion

Function	Description
`classic2sym()`	Convert classical data to interval-valued data
`RSDA2sym()`	Convert RSDA symbolic objects to `ggInterval` format

Example Graphics

Representative figures generated from LaTeX/S2_File_ggInterval_examples.R.

Interval Scatter Plot _{ggInterval_scatterplot()}	Scatter Matrix _{ggInterval_scatterMatrix()}
2D Histogram Matrix _{ggInterval_2DhistMatrix()}	Index Image _{ggInterval_indexImage()}
Customized Index Plot _{ggInterval_indexplot() with k-means groups}	Radar Plot _{ggInterval_radarplot()}
PCA Display _{ggInterval_PCA() / PCA score intervals}	Correlation Heatmap _{ggInterval_corrplot()}
Interval-Valued Line Plot _{ggInterval_lineplot()}

Documentation

CRAN: https://CRAN.R-project.org/package=ggInterval
GitHub releases: https://github.com/hanmingwu1103/ggInterval/releases
Issues: https://github.com/hanmingwu1103/ggInterval/issues

Citation

Use the installed package citation metadata:

citation("ggInterval")

The package citation is shipped with inst/CITATION and points to the canonical CRAN package URL and DOI.

License

GPL (>= 2)