Man page - rl2tool(1)

Packages contains this manual

Package:  rasterlite2-bin
apt-get install rasterlite2-bin

Manuals in package:
• rl2tool(1)
• wmslite(1)
• rl2sniff(1)
Documentations in package:
• rasterlite2-bin

Manual

rl2tool

NAME
SYNOPSIS
DESCRIPTION
OPTIONS

---

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
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-smp keyword , --sample-type keyword

Sample Type keyword (see list)

-pxl keyword , --pixel-type keyword

Pixel Type keyword (see list)

-bds integer , --num-bands integer

Number of Bands

-cpr keyword , --compression keyword

Compression keyword (see list)

-qty integer , --quality integer

Compression Quality [0-100]

-tlw integer , --tile-width integer

Tile Width [pixels]

-tlh integer , --tile-height integer

Tile Height [pixels]

-srid integer , --srid integer

SRID value

-nosrid , --no-srid

No SRID

-res number , --resolution number

pixel resolution(X and Y)

-xres number , --x-resol number

pixel resolution(X specific)

-yres number , --y-resol number

pixel resolution(Y specific)

-nd pixel , --no-data pixel

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
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

Mode: IMPORT

will create a new Raster Section by importing an external image or raster file
-db pathname , --db-path pathname

RasterLite2 DB path

-src pathname , --src-path pathname

input Image/Raster path

-dir pathname , --dir-path pathname

input directory path

-ext string , --file-ext string

extension file extension (e.g. .tif)

-cov string , --coverage string

Coverage’s name

-srid integer , --srid integer

optional: force SRID value

-wf >, --worldfile

requires a Worldfile

-pyr , --pyramidize

immediately build Pyramid levels

Mode: EXPORT

will export an external image from a Coverage
-db pathname , --db-path pathname

RasterLite2 DB path

-dst pathname , --dst-path pathname

output Image/Raster path

-cov string , --coverage string

Coverage’s name

-res number , --resolution number

pixel resolution (X and Y)

-xres number , --x-resol number

pixel resolution (X specific)

-yres number , --y-resol number

pixel resolution (Y specific)

-minx number , --min-x number

X coordinate (lower-left corner)

-miny number , --min-y number

Y coordinate (lower-left corner)

-maxx number , --max-x number

X coordinate (upper-right corner)

-maxy number , --max-y number

Y coordinate (upper-left corner)

-cx number , --center-x number

X coordinate (center)

-cy number , --center-y number

Y coordinate (center)

-outw number , --out-width number

image width (in pixels)

-outh number , --out-height number

image height (in pixels)

In order to export a raster you are expected to specify:
- the intended resolution ( -res OR -xres AND -yres )
- the output image size ( -outw AND -outh )
- a single tie-point, defined as one of:

- Output Image Center point: -cx AND -cy
- Output Image LowerLeft corner: -minx AND -miny
- Output Image LowerRight corner: -maxx AND -miny
- Output Image UpperLeft corner: -minx AND -maxy
- Output Image UpperRight corner: -maxx AND -maxy

Mode: DELETE

will delete a Raster Section
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-sec string , --section string

Section’s name

Mode: PYRAMIDIZE

will (re)build all Pyramid levels supporting a Coverage
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-sec string , --section string

optional: Section’s name

default is "All Sections"

-f , --force

optional: rebuilds from scratch

Mode: PYRAMIDIZE-MONOLITHIC

will (re)build all Pyramid levels (Monolithic) supporting a Coverage
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-lev number , --virt-levels number

number of virt-levels

could be one of: 1, 2 or 3

Mode: DE-PYRAMIDIZE

will delete Pyramid levels
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-sec string , --section string

optional: Section’s name

default is "All Sections"

Mode: LIST

will list Raster Sections within a Coverage
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-sec string , --section string

optional: Section’s name

default is "All Sections"

Mode: MAP

will output a PNG Map representing all Raster Sections within a Coverage
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-dst pathname , --dst-path pathname

output Image/Raster path

-outw number , --out-width number

image width (in pixels)

-outh number , --out-height number

image height (in pixels)

Mode: CATALOG

will list all Coverages from within a RasterLite2 DB
-db pathname , --db-path pathname

RasterLite2 DB path

Mode: HISTOGRAM

will create a PNG showing a band Histogram
-db pathname , --db-path pathname

RasterLite2 DB path

-cov string , --coverage string

Coverage’s name

-sec string , --section string

optional: Section’s name

default is "All Sections"

-bnd integer , --band-index integer

a valid band index

default is band index 0

-dst pathname , --dst-path pathname

output PNG path

default is ./hist_cov_sec_idx.png

optional DB specific settings:
-cs num , --cache-size num

DB cache size (how many pages)

-m , --in-memory

using IN-MEMORY database

-jo , --journal-off

unsafe [but faster] mode

---