19 Stars
Updated Last
1 Year Ago
Started In
March 2014


Stable Dev

This package provides a convenient Julia interface for loading standard named test images and example images for the internal usage in JuliaImages. This can be used in conjunction with the Images package.


Full documentation and description of the images available in TestImages.jl can be found here.


Just like all normal Julia packages, you can use Pkg to install it:

pkg> add TestImages # hit ] to enter Pkg mode


using TestImages

img = testimage("cameraman.tif") # fullname
img = testimage("cameraman") # without extension works
img = testimage("cam") # with only partial name also works

img = testimage_dip3e("fig0905") # load figure 9.5: wirebond-mask from the DIP3E textbook
img = testimage_dip3e("wirebond-mask") # same as above

phantom = TestImages.shepp_logan(256) # generate the Shepp-Logan phantom image

testimage_dip3e loads an image from the DIP3E textbook, "Digital Image Processing, 3rd edition" by Rafael C. Gonzalez and Richard E. Woods. Permission is required from the owner of a © image if the image is used for other than personal educational or research purposes. See copyright file.

Images will be automatically downloaded into artifact folders when you load the image for the first time.


For users with Julia < v1.3.0, TestImages v0.6.z will still be under maintenance. However, newly added test images will not be available in those versions.


A detailed guide on contributing to TestImages.jl can be found in the documentation mentioned above.

Related packages

  • The MLDatasets.jl package includes several image collections.
  • The ImagePhantoms package has additional versions of the Shepp-Logan phantom, as well as other phantoms like focus charts, and can compute sinograms and spectra of such phantoms.