Scroll to navigation

rl2tool(1) rl2tool(1)

NAME

rl2tool - CLI tool for RasterLite2

SYNOPSIS


rl2tool
mode [ARGLIST]

DESCRIPTION

rl2tool is a CLI tool for RasterLite2.

OPTIONS

Mode: CREATE

will create a new RasterLite2 Raster Coverage

RasterLite2 DB path
Coverage's name
Sample Type keyword (see list)
Pixel Type keyword (see list)
Number of Bands
Compression keyword (see list)
Compression Quality [0-100]
Tile Width [pixels]
Tile Height [pixels]
SRID value
No SRID
pixel resolution(X and Y)
pixel resolution(X specific)
pixel resolution(Y specific)
NO-DATA pixel value

SampleType Keywords:

1-BIT 2-BIT 4-BIT INT8 UINT8 INT16 UINT16 INT32 UINT32 FLOAT DOUBLE

PixelType Keywords:

MONOCHROME PALETTE GRAYSCALE RGB MULTIBAND DATAGRID

Compression Keywords:

NONE DEFLATE LZMA GIF PNG JPEG WEBP LL_WEBP FAX3 FAX4

Mode: DROP

will drop an existing RasterLite2 Raster Coverage

RasterLite2 DB path
Coverage's name

Mode: IMPORT

will create a new Raster Section by importing an external image or raster file

RasterLite2 DB path
input Image/Raster path
input directory path
extension file extension (e.g. .tif)
Coverage's name
optional: force SRID value
requires a Worldfile
immediately build Pyramid levels

Mode: EXPORT

will export an external image from a Coverage

RasterLite2 DB path
output Image/Raster path
Coverage's name
pixel resolution (X and Y)
pixel resolution (X specific)
pixel resolution (Y specific)
X coordinate (lower-left corner)
Y coordinate (lower-left corner)
X coordinate (upper-right corner)
Y coordinate (upper-left corner)
X coordinate (center)
Y coordinate (center)
image width (in pixels)
image height (in pixels)

In order to export a raster you are expected to specify:

Mode: DELETE

will delete a Raster Section

RasterLite2 DB path
Coverage's name
Section's name

Mode: PYRAMIDIZE

will (re)build all Pyramid levels supporting a Coverage

RasterLite2 DB path
Coverage's name
optional: Section's name

default is "All Sections"

optional: rebuilds from scratch

Mode: PYRAMIDIZE-MONOLITHIC

will (re)build all Pyramid levels (Monolithic) supporting a Coverage

RasterLite2 DB path
Coverage's name
number of virt-levels

could be one of: 1, 2 or 3

Mode: DE-PYRAMIDIZE

will delete Pyramid levels

RasterLite2 DB path
Coverage's name
optional: Section's name

default is "All Sections"

Mode: LIST

will list Raster Sections within a Coverage

RasterLite2 DB path
Coverage's name
optional: Section's name

default is "All Sections"

Mode: MAP

will output a PNG Map representing all Raster Sections within a Coverage

RasterLite2 DB path
Coverage's name
output Image/Raster path
image width (in pixels)
image height (in pixels)

Mode: CATALOG

will list all Coverages from within a RasterLite2 DB

RasterLite2 DB path

Mode: HISTOGRAM

will create a PNG showing a band Histogram

RasterLite2 DB path
Coverage's name
optional: Section's name

default is "All Sections"

a valid band index

default is band index 0

output PNG path

default is ./hist_cov_sec_idx.png

optional DB specific settings:

DB cache size (how many pages)
using IN-MEMORY database
unsafe [but faster] mode
05 August 2023