im.export: Export a Raster to GeoTIFF, PNG, or JPG

In imageRy: Modify and Share Images

Export a Raster to GeoTIFF, PNG, or JPG

Description

This function saves a 'SpatRaster' object to disk in **GeoTIFF**, **PNG**, or **JPG** format.

Usage

im.export(x, filename, overwrite = TRUE)

Arguments

x	A 'SpatRaster' object representing the raster to be saved.
filename	A character string specifying the output file path with '.tif', '.png', or '.jpg' extension.
overwrite	A logical value indicating whether to overwrite an existing file (default: TRUE).

Details

- **GeoTIFF ('.tif')**: Uses 'terra::writeRaster()', preserving geospatial information. - **PNG/JPG ('.png', '.jpg', '.jpeg')**: Converts the raster to an image and saves it with 'png()' or 'jpeg()'. - **If the raster has multiple bands**, only the first band is saved in PNG/JPG format.

Value

No return value. The function writes the raster to disk.

See Also

[im.import()], [writeRaster()]

Examples

library(terra)

# Create a sample raster
r <- rast(nrows = 10, ncols = 10)
values(r) <- runif(ncell(r))

# Export as GeoTIFF to temporary file
tif_path <- tempfile(fileext = ".tif")
im.export(r, tif_path)

# Export as PNG to temporary file
png_path <- tempfile(fileext = ".png")
im.export(r, png_path)

imageRy documentation built on Aug. 8, 2025, 7:31 p.m.