Software Open Access

outlineR: An R package to derive outline shapes from (multiple) artefacts on JPEG images

David N. Matzig


This package is a helpful wrapper around functions from mainly the Momocs (Bonhomme et al. 2014), EBImage (Pau et al. 2010), and imager (Barthelme et al. 2020) packages. It is designed for the fast and easy extraction of single outline shapes of, for example, stone tools from images containing multiple thereof, such as the ones present in archaeological publications.

This release is provided with a testing dataset, using the Morar Quartz Industry image (Credit: Wellcome Collection,, distributed under CC BY 4.0).

A brief explanation of the workflow and the package functions can be found on


Barthelme et al. 2020: Barthelme, S., Tschumperle, D., Wijffels, J., Assemlal, H. E., & Ochi, S. (2020). imager: Image Processing Library Based on “CImg” (0.42.3) [Computer software].

Bonhomme et al. 2014: Bonhomme, V., Picq, S., Gaucherel, C., & Claude, J. (2014). Momocs: Outline Analysis Using R. Journal of Statistical Software, 56(13).

Pau et al. 2010: Pau, G., Fuchs, F., Sklyar, O., Boutros, M., & Huber, W. (2010). EBImage—An R package for image processing with applications to cellular phenotypes. Bioinformatics, 26(7), 979–981.

Files (4.2 MB)
Name Size
4.2 MB Download
All versions This version
Views 214214
Downloads 1313
Data volume 54.4 MB54.4 MB
Unique views 191191
Unique downloads 1313


Cite as