Organizing your raster data

To make a large collection of raster data quickly available in Felt, we recommend storing it in Cloud Optimized Geotiff format in a cloud storage bucket, with relevant metadata about your files encoded in regular patterns in their paths.

This feature is only available to customers on the Enterprise plan. To upgrade, contact sales.

Storage

The easiest way to connect your raster data to Felt is to host it in a cloud storage bucket using one of the following options:

• Amazon S3

• Google Cloud Storage

• Azure Blob Storage

Format

Cloud Optimized GeoTIFFs (COGs, for short) are raster files optimized for being read from a remote server, structured in a way that enables efficient cloud workflows.

While Felt can process many raster data formats, COGs will ensure that only the data you actually want to visualize on the map is read. To learn more about how to create COGs that can be streamed efficiently by Felt, click here.

Structure

Storing your files in cloud storage with a well-defined, strict naming pattern is the best way of making your data discoverable:

• Use folders to organize your files into projects.

• Encode properties that you'd like to search by into the file path.

Here's an example of a naming pattern:

s3://my-bucket/{project}/{type}_{YYYYMMDD}_r{resolution}.tiff

A file following that pattern would look like this:

s3://my-bucket/fire_hazards/dem_20250515_r35.tiff

Extracting properties with regex

Using regular expressions, Felt can extract metadata properties from the path to files in a cloud storage bucket. Here's a set of regular expressions that can be used to extract the properties defined in the template above.

In this example, the properties project, type, date and resolution will be extracted during bucket inspection, and can be later used to filter and search for objects.

STAC

If your metadata storage needs go beyond a string pattern, or if the number of objects stored is either very large, or very dynamic, using a Spatio-Temporal Asset Catalog allows storage of metadata (including spatial and temporal extents) in an explicit format. Both static STACs in JSON format or dynamic STAC APIs can be added to Felt as sources.

Felt can load data directly from cloud storage, or from any other storage location that exposes the data over HTTPS. The closer your data is to your Felt instance (if you are using a VPC), the less latency you will have in tile serving.

If you wish to stream your data without importing the entire file into Felt, the data storage location must support range requests.