rl2tool1

Cli tool for rasterlite2

Usage

FCrl2toolF [0] mode [ARGLIST]

Overview

rl2tool is a CLI tool for RasterLite2.

Options

Mode: CREATE

will create a new RasterLite2 Raster Coverage

`FC-dbF[0] pathname, FC--db-pathF[0] pathname`	RasterLite2 DB path
`FC-covF[0] string, FC--coverageF[0] string`	Coverage's name
`FC-smpF[0] keyword, FC--sample-typeF[0] keyword`	Sample Type keyword (see list)
`FC-pxlF[0] keyword, FC--pixel-typeF[0] keyword`	Pixel Type keyword (see list)
`FC-bdsF[0] integer, FC--num-bandsF[0] integer`	Number of Bands
`FC-cprF[0] keyword, FC--compressionF[0] keyword`	Compression keyword (see list)
`FC-qtyF[0] integer, FC--qualityF[0] integer`	Compression Quality [0-100]
`FC-tlwF[0] integer, FC--tile-widthF[0] integer`	Tile Width [pixels]
`FC-tlhF[0] integer, FC--tile-heightF[0] integer`	Tile Height [pixels]
`FC-sridF[0] integer, FC--sridF[0] integer`	SRID value
`FC-nosridF[0], FC--no-sridF[0]`	No SRID
`FC-resF[0] number, FC--resolutionF[0] number`	pixel resolution(X and Y)
`FC-xresF[0] number, FC--x-resolF[0] number`	pixel resolution(X specific)
`FC-yresF[0] number, FC--y-resolF[0] number`	pixel resolution(Y specific)
`FC-ndF[0] pixel, FC--no-dataF[0] 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

`FC-dbF[0] pathname, FC--db-pathF[0] pathname`	RasterLite2 DB path
`FC-covF[0] string, FC--coverageF[0] string`	Coverage's name

Mode: IMPORT

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

`FC-dbF[0] pathname, FC--db-pathF[0] pathname`	RasterLite2 DB path
`FC-srcF[0] pathname, FC--src-pathF[0] pathname`	input Image/Raster path
`FC-dirF[0] pathname, FC--dir-pathF[0] pathname`	input directory path
`FC-extF[0] string, FC--file-extF[0] string`	extension file extension (e.g. .tif)
`FC-covF[0] string, FC--coverageF[0] string`	Coverage's name
`FC-sridF[0] integer, FC--sridF[0] integer`	optional: force SRID value
`FC-wfF[0]>, FC--worldfileF[0]`	requires a Worldfile
`FC-pyrF[0], FC--pyramidizeF[0]`	immediately build Pyramid levels

Mode: EXPORT

will export an external image from a Coverage

`FC-dbF[0] pathname, FC--db-pathF[0] pathname`	RasterLite2 DB path
`FC-dstF[0] pathname, FC--dst-pathF[0] pathname`	output Image/Raster path
`FC-covF[0] string, FC--coverageF[0] string`	Coverage's name
`FC-resF[0] number, FC--resolutionF[0] number`	pixel resolution (X and Y)
`FC-xresF[0] number, FC--x-resolF[0] number`	pixel resolution (X specific)
`FC-yresF[0] number, FC--y-resolF[0] number`	pixel resolution (Y specific)
`FC-minxF[0] number, FC--min-xF[0] number`	X coordinate (lower-left corner)
`FC-minyF[0] number, FC--min-yF[0] number`	Y coordinate (lower-left corner)
`FC-maxxF[0] number, FC--max-xF[0] number`	X coordinate (upper-right corner)
`FC-maxyF[0] number, FC--max-yF[0] number`	Y coordinate (upper-left corner)
`FC-cxF[0] number, FC--center-xF[0] number`	X coordinate (center)
`FC-cyF[0] number, FC--center-yF[0] number`	Y coordinate (center)
`FC-outwF[0] number, FC--out-widthF[0] number`	image width (in pixels)
`FC-outhF[0] number, FC--out-heightF[0] number`	image height (in pixels)

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

- the intended resolution (FC-resF[0] OR FC-xresF[0] AND FC-yresF[0])

- the output image size (FC-outwF[0] AND FC-outhF[0])

- a single tie-point, defined as one of:

- Output Image Center point: FC-cxF[0] AND FC-cyF[0]

- Output Image LowerLeft corner: FC-minxF[0] AND FC-minyF[0]

- Output Image LowerRight corner: FC-maxxF[0] AND FC-minyF[0]

- Output Image UpperLeft corner: FC-minxF[0] AND FC-maxyF[0]

- Output Image UpperRight corner: FC-maxxF[0] AND FC-maxyF[0]

Mode: DELETE

will delete a Raster Section

`FC-dbF[0] pathname, FC--db-pathF[0] pathname`	RasterLite2 DB path
`FC-covF[0] string, FC--coverageF[0] string`	Coverage's name
`FC-secF[0] string, FC--sectionF[0] string`	Section's name

Mode: PYRAMIDIZE

will (re)build all Pyramid levels supporting a Coverage

FC-dbF[0] pathname, FC--db-pathF[0] pathname: RasterLite2 DB path

FC-covF[0] string, FC--coverageF[0] string: Coverage's name

FC-secF[0] string, FC--sectionF[0] string

optional: Section's name

default is "All Sections"

FC-fF[0], FC--forceF[0]: optional: rebuilds from scratch

Mode: PYRAMIDIZE-MONOLITHIC

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

FC-dbF[0] pathname, FC--db-pathF[0] pathname: RasterLite2 DB path

FC-covF[0] string, FC--coverageF[0] string: Coverage's name

FC-levF[0] number, FC--virt-levelsF[0] number

number of virt-levels

could be one of: 1, 2 or 3

Mode: DE-PYRAMIDIZE

will delete Pyramid levels

FC-dbF[0] pathname, FC--db-pathF[0] pathname: RasterLite2 DB path

FC-covF[0] string, FC--coverageF[0] string: Coverage's name

FC-secF[0] string, FC--sectionF[0] string

optional: Section's name

default is "All Sections"

Mode: LIST

will list Raster Sections within a Coverage

FC-dbF[0] pathname, FC--db-pathF[0] pathname: RasterLite2 DB path

FC-covF[0] string, FC--coverageF[0] string: Coverage's name

FC-secF[0] string, FC--sectionF[0] string

optional: Section's name

default is "All Sections"

Mode: MAP

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

`FC-dbF[0] pathname, FC--db-pathF[0] pathname`	RasterLite2 DB path
`FC-covF[0] string, FC--coverageF[0] string`	Coverage's name
`FC-dstF[0] pathname, FC--dst-pathF[0] pathname`	output Image/Raster path
`FC-outwF[0] number, FC--out-widthF[0] number`	image width (in pixels)
`FC-outhF[0] number, FC--out-heightF[0] number`	image height (in pixels)

Mode: CATALOG

will list all Coverages from within a RasterLite2 DB

FC-dbF[0] pathname, FC--db-pathF[0] pathname: RasterLite2 DB path

Mode: HISTOGRAM

will create a PNG showing a band Histogram

FC-dbF[0] pathname, FC--db-pathF[0] pathname: RasterLite2 DB path

FC-covF[0] string, FC--coverageF[0] string: Coverage's name

FC-secF[0] string, FC--sectionF[0] string

optional: Section's name

default is "All Sections"

FC-bndF[0] integer, FC--band-indexF[0] integer

a valid band index

default is band index 0

FC-dstF[0] pathname, FC--dst-pathF[0] pathname

output PNG path

default is FC./hist_cov_sec_idx.pngF[0]

optional DB specific settings:

`FC-csF[0] num, FC--cache-sizeF[0] num`	DB cache size (how many pages)
`FC-mF[0], FC--in-memoryF[0]`	using IN-MEMORY database
`FC-joF[0], FC--journal-offF[0]`	unsafe [but faster] mode

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.