Add Raster to GeoPackage (Conversion)

Summary

Loads raster datasets into an OGC GeoPackage raster pyramid.

Usage

• The target GeoPackage can be created using the Create SQLite Database tool.

• The GeoPackage raster name cannot already exist in the GeoPackage.

• Raster data with an unknown coordinate reference will be created with a 6-level tiling scheme.

Parameters

Dialog

Label	Explanation	Data Type
Input Raster	The raster dataset to load into the OGC GeoPackage raster pyramid.	Raster Layer; Mosaic Layer
Target GeoPackage	The GeoPackage into which the raster dataset will be loaded.	Workspace
Raster Name	The name of the output GeoPackage raster pyramid.	String
Tiling Scheme (Optional)	Specifies the tiling scheme. Tiled—The spatial reference of the input raster will be maintained and tiles will be generated consistent with the GeoPackage standard. This is the default. ArcGIS Online— Raster tiles will be generated in a Web Mercator coordinate reference (the same scheme developed for the Army Geospatial Center). NSG Profile Scaled Transverse Mercator—A scaled transverse Mercator will be used. NSG Profile WGS84 Geographic—WGS84 Geographic will be used. Google Earth Web Mercator—Raster tiles will be created using the parameters in the Web Mercator coordinate reference. Custom tiling scheme file—A custom tiling scheme from a file with an XML schema definition created using the Generate Tile Cache Tiling Scheme tool will be used.	String
Tiling Scheme File (Optional)	A custom tiling scheme file that is required when Tiling Scheme is set to Custom tiling scheme file.	File
Area of Interest (Optional)	An area of interest used to limit the area of the raster to be loaded, rather than the entire dataset.	Feature Set

Derived Output

Label	Explanation	Data Type
Output GeoPackage	The updated GeoPackage.	Raster Dataset

Python

arcpy.conversion.AddRasterToGeoPackage(in_dataset, target_geopackage, raster_name, {tiling_scheme}, {tiling_scheme_file}, {area_of_interest})

Name	Explanation	Data Type
in_dataset	The raster dataset to load into the OGC GeoPackage raster pyramid.	Raster Layer; Mosaic Layer
target_geopackage	The GeoPackage into which the raster dataset will be loaded.	Workspace
raster_name	The name of the output GeoPackage raster pyramid.	String
tiling_scheme (Optional)	Specifies the tiling scheme. TILED—The spatial reference of the input raster will be maintained and tiles will be generated consistent with the GeoPackage standard. This is the default. ARCGISONLINE_SCHEME— Raster tiles will be generated in a Web Mercator coordinate reference (the same scheme developed for the Army Geospatial Center). NSGPROFILE_SCALED_TRANSVERSE_MERCATOR—A scaled transverse Mercator will be used. NSGPROFILE_WGS84_GEOGRAPHIC—WGS84 Geographic will be used. GOOGLE_EARTH_WEB_MERCATOR—Raster tiles will be created using the parameters in the Web Mercator coordinate reference. FROM_FILE—A custom tiling scheme from a file with an XML schema definition created using the Generate Tile Cache Tiling Scheme tool will be used.	String
tiling_scheme_file (Optional)	A custom tiling scheme file that is required when tiling_scheme is set to FROM_FILE.	File
area_of_interest (Optional)	An area of interest used to limit the area of the raster to be loaded, rather than the entire dataset.	Feature Set

Derived Output

Name	Explanation	Data Type
out_geopackage_raster	The updated GeoPackage.	Raster Dataset

Code sample

AddRasterToGeoPackage example 1 (Python window)

The following Python window script demonstrates how to use the AddRasterToGeoPackage function.

import arcpy
arcpy.conversion.AddRasterToGeoPackage("c:/data/san_diego.png", "c:/data/san_diego.gpkg", 
                                       "SanDiego", "TILED")

Environments

Compression, Pyramid