NAME
rl2tool - CLI tool for RasterLite2
SYNOPSIS
FCrl2toolF[0] mode [ARGLIST]
DESCRIPTION
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