Draw Images of Raster Data and Related Adornments
Overview
Draw images easily, set up a plot with an image, specify where that image should be placed. Image plot by default reflects the index of the image data itself, or can be specified in simple extent terms 'xmin,xmax,ymin,ymax'. Numeric matrices, integer arrays, byte arrays, character arrays, and native rasters are (or will be) supported. A combination of image() and rasterImage() from the 'graphics' package with their good features in one place.
- New function
xtext()draws matrix values as labels at cell centres, in the same raster-order layout used byximage()(thanks to a draft in issue #22). Supports vapour and gdalraster reader-output lists. - New vignette "Array orientation: raster order and the R matrix" explains the raster-order convention, the
byrow = TRUEandas.vector(t(m))round trip, multi-bandaperm()recipes, and the cell-edge extent convention (#14). - Now support raw output of fastpng.
- Now support {gdalraster} output of
read_ds(, as_list = TRUE)or raw numeric, thanks to Chris Toney. ximage()now handlesbreaksargument to go withcol(for numeric input).image()now works with list output from gdalnara (same as gdal_raster_image but with nativeRaster).- Added suport for
xcontour()for the output output ofgdal_raster_data()in {vapour}.
Show all changes in 0.1.0Hide the rest of the changes in 0.1.0
ximage()can now plot sf::gdal_read objects.- Fixed default extent for an array/matrix, it was transposed (!).
- ximage now does what imfun in whatarelief did, i.e. with the output of gdal_raster_data, gdal_raster_dsn, gdal_raster_image do the obvious plot.
- Add 'mesh_plot' mode to
ximage(), not fully implemented. - Increase the default colour classes, 12 -> 96.
- Support 'raster' class as per as.raster.
- Added xcontour and xrect functions.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-04
- NOTE12 OK, 1 NOTE2026-08-01
- OK7 OK2026-07-22
Documentation
Documentation signals are not tracked yet for this package.
Downloads
Repository
- PRs merged (all time)
- 86%
- Median days to close, 50 most recently updated closed issues
- 881
- Median days to close, 50 most recently updated closed PRs
- 0
10 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/hypertidy/ximage on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-08-07 · The repository has a site deploy workflow
Show all practicesHide 2 practices
This repository shows signs of AI coding tools.
- GitHub Copilotfirst seen 2026-02-15Pull request: opened by its own accountCommits: 10 by its own account
- Claude Codefirst seen 2026-07-12Named in .Rbuildignore: .claude
Dependencies
Installing ximage adds no packages beyond those that come with R.
Code & Tests
Datasets
People & History
- 0.1.0Latest2026-07-21 · current release
- RR 4.6.0 released · 2026-04-24
Package metadata
- First published
- 2026-07-21
- Total releases
- 1 / 1 yrs
- License
- MIT + file LICENSE OSI
- Download size
- 1.4 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("ximage")This is what citation() produces when a package has no citation file of its own. If it prints something else, use that.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.