GDAL - TileDB Embedded Docs

Installation
​GDAL is a translator library for raster and vector datasets, there has been a supported TileDB raster driver since GDAL 3.0. You can run the GDAL code as follows:
1
docker run -it --rm -u 0 -v /local/path:/data tiledb/tiledb-geospatial /bin/bash
Copied!
To confirm that the TileDB driver is available, run:
1
gdalinfo --formats | grep TileDB
2
TileDB -raster- (rw+vs): TileDB
Copied!
Here are the supported options of the TileDB driver:
1
gdalinfo --format TileDB        
2
Format Details:
3
  Short Name: TileDB
4
  Long Name: TileDB
5
  Supports: Raster
6
  Help Topic: frmt_tiledb.html
7
  Supports: Subdatasets
8
  Supports: Open() - Open existing dataset.
9
  Supports: Create() - Create writable dataset.
10
  Supports: CreateCopy() - Create dataset by copying another.
11
  Supports: Virtual IO - eg. /vsimem/
12
  Creation Datatypes: Byte UInt16 Int16 UInt32 Int32 Float32 Float64 CInt16 CInt32 CFloat32 CFloat64
13
​
14
<CreationOptionList>
15
  <Option name="COMPRESSION" type="string-select" description="image compression to use" default="NONE">
16
    <Value>NONE</Value>
17
    <Value>GZIP</Value>
18
    <Value>ZSTD</Value>
19
    <Value>LZ4</Value>
20
    <Value>RLE</Value>
21
    <Value>BZIP2</Value>
22
    <Value>DOUBLE-DELTA</Value>
23
    <Value>POSITIVE-DELTA</Value>
24
  </Option>
25
  <Option name="COMPRESSION_LEVEL" type="int" description="Compression level" />
26
  <Option name="BLOCKXSIZE" type="int" description="Tile Width" />
27
  <Option name="BLOCKYSIZE" type="int" description="Tile Height" />
28
  <Option name="STATS" type="boolean" description="Dump TileDB stats" />
29
  <Option name="TILEDB_CONFIG" type="string" description="location of configuration file for TileDB" />
30
  <Option name="TILEDB_ATTRIBUTE" type="string" description="co-registered file to add as TileDB attributes" />
31
</CreationOptionList>
32
​
33
<OpenOptionList>
34
  <Option name="STATS" type="boolean" description="Dump TileDB stats" />
35
  <Option name="TILEDB_ATTRIBUTE" type="string" description="Attribute to read from each band" />
36
  <Option name="TILEDB_CONFIG" type="string" description="location of configuration file for TileDB" />
37
</OpenOptionList>
Copied!
Ingesting Data
Download this simple GeoTIFF image. Simply run:
1
gdal_translate -OF TileDB UTM2GTIF.TIF <array-name>
Copied!
This will create a new TileDB array called <array-name> and ingest the GeoTIFF image as a TileDB 2D dense array with a simple attribute that will store the greyscale value of each pixel. Note that the array name can be an S3 URI path as well. In that case, you would need to create an aws.config file, and add your S3 keys in the following way:
1
vfs.s3.aws_access_key_id xxxxxx
2
vfs.s3.aws_secret_access_key xxxxxx
Copied!
Then, you can ingest directly into a TileDB array on S3 as follows:
1
gdal_translate -OF TileDB UTM2GTIF.TIF -CO TILEDB_CONFIG=aws.config <array-name>
Copied!
After ingesting the array, you can get its info with:
1
gdalinfo <array-name>
2
# or, gdalinfo -OO TILEDB_CONFIG=aws.config <array-name>, if the array is on S3
Copied!
Finally, you can check if the values in the TileDB array are the same as in the original GeoTIFF file:
1
gdallocationinfo <array-name> 10 10
2
Report:
3
  Location: (10P,10L)
4
  Band 1:
5
    Value: 156
6
​
7
gdallocationinfo UTM2GTIF.TIF 10 10 
8
Report:
9
  Location: (10P,10L)
10
  Band 1:
11
    Value: 156
Copied!
If everything worked correctly, the values in the TileDB array must be identical to those in the original GeoTIFF file.

PDAL

Rasterio

Last modified 3mo ago

Copy link

Contents

Installation

Ingesting Data