rl2tool(1)

NAME
rl2tool - CLI tool for RasterLite2

SYNOPSIS
\FCrl2tool\F[]
mode [ARGLIST]

DESCRIPTION
rl2tool is a CLI tool for RasterLite2.

OPTIONS
Mode: CREATE

will create a new RasterLite2 Raster Coverage

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-smp\F[] keyword, \FC--sample-type\F[] keyword
    Sample Type keyword (see list)

\FC-pxl\F[] keyword, \FC--pixel-type\F[] keyword
    Pixel Type keyword (see list)

\FC-bds\F[] integer, \FC--num-bands\F[] integer
    Number of Bands

\FC-cpr\F[] keyword, \FC--compression\F[] keyword
    Compression keyword (see list)

\FC-qty\F[] integer, \FC--quality\F[] integer
    Compression Quality [0-100]

\FC-tlw\F[] integer, \FC--tile-width\F[] integer
    Tile Width [pixels]

\FC-tlh\F[] integer, \FC--tile-height\F[] integer
    Tile Height [pixels]

\FC-srid\F[] integer, \FC--srid\F[] integer
    SRID value

\FC-nosrid\F[], \FC--no-srid\F[]
    No SRID

\FC-res\F[] number, \FC--resolution\F[] number
    pixel resolution(X and Y)

\FC-xres\F[] number, \FC--x-resol\F[] number
    pixel resolution(X specific)

\FC-yres\F[] number, \FC--y-resol\F[] number
    pixel resolution(Y specific)

\FC-nd\F[] pixel, \FC--no-data\F[] 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-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

Mode: IMPORT

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

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-src\F[] pathname, \FC--src-path\F[] pathname
    input Image/Raster path

\FC-dir\F[] pathname, \FC--dir-path\F[] pathname
    input directory path

\FC-ext\F[] string, \FC--file-ext\F[] string
    extension file extension (e.g. .tif)

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-srid\F[] integer, \FC--srid\F[] integer
    optional: force SRID value

\FC-wf\F[]>, \FC--worldfile\F[]
    requires a Worldfile

\FC-pyr\F[], \FC--pyramidize\F[]
    immediately build Pyramid levels

Mode: EXPORT

will export an external image from a Coverage

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-dst\F[] pathname, \FC--dst-path\F[] pathname
    output Image/Raster path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-res\F[] number, \FC--resolution\F[] number
    pixel resolution (X and Y)

\FC-xres\F[] number, \FC--x-resol\F[] number
    pixel resolution (X specific)

\FC-yres\F[] number, \FC--y-resol\F[] number
    pixel resolution (Y specific)

\FC-minx\F[] number, \FC--min-x\F[] number
    X coordinate (lower-left corner)

\FC-miny\F[] number, \FC--min-y\F[] number
    Y coordinate (lower-left corner)

\FC-maxx\F[] number, \FC--max-x\F[] number
    X coordinate (upper-right corner)

\FC-maxy\F[] number, \FC--max-y\F[] number
    Y coordinate (upper-left corner)

\FC-cx\F[] number, \FC--center-x\F[] number
    X coordinate (center)

\FC-cy\F[] number, \FC--center-y\F[] number
    Y coordinate (center)

\FC-outw\F[] number, \FC--out-width\F[] number
    image width (in pixels)

\FC-outh\F[] number, \FC--out-height\F[] number
    image height (in pixels)

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

- the intended resolution (\FC-res\F[] OR \FC-xres\F[] AND \FC-yres\F[])

- the output image size (\FC-outw\F[] AND \FC-outh\F[])

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

    - Output Image Center point: \FC-cx\F[] AND \FC-cy\F[]

    - Output Image LowerLeft corner: \FC-minx\F[] AND \FC-miny\F[]

    - Output Image LowerRight corner: \FC-maxx\F[] AND \FC-miny\F[]

    - Output Image UpperLeft corner: \FC-minx\F[] AND \FC-maxy\F[]

    - Output Image UpperRight corner: \FC-maxx\F[] AND \FC-maxy\F[]

Mode: DELETE

will delete a Raster Section

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-sec\F[] string, \FC--section\F[] string
    Section's name

Mode: PYRAMIDIZE

will (re)build all Pyramid levels supporting a Coverage

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-sec\F[] string, \FC--section\F[] string
    optional: Section's name

    default is "All Sections"

\FC-f\F[], \FC--force\F[]
    optional: rebuilds from scratch

Mode: PYRAMIDIZE-MONOLITHIC

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

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-lev\F[] number, \FC--virt-levels\F[] number
    number of virt-levels

    could be one of: 1, 2 or 3

Mode: DE-PYRAMIDIZE

will delete Pyramid levels

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-sec\F[] string, \FC--section\F[] string
    optional: Section's name

    default is "All Sections"

Mode: LIST

will list Raster Sections within a Coverage

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-sec\F[] string, \FC--section\F[] string
    optional: Section's name

    default is "All Sections"

Mode: MAP

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

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-dst\F[] pathname, \FC--dst-path\F[] pathname
    output Image/Raster path

\FC-outw\F[] number, \FC--out-width\F[] number
    image width (in pixels)

\FC-outh\F[] number, \FC--out-height\F[] number
    image height (in pixels)

Mode: CATALOG

will list all Coverages from within a RasterLite2 DB

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

Mode: HISTOGRAM

will create a PNG showing a band Histogram

\FC-db\F[] pathname, \FC--db-path\F[] pathname
    RasterLite2 DB path

\FC-cov\F[] string, \FC--coverage\F[] string
    Coverage's name

\FC-sec\F[] string, \FC--section\F[] string
    optional: Section's name

    default is "All Sections"

\FC-bnd\F[] integer, \FC--band-index\F[] integer
    a valid band index

    default is band index 0

\FC-dst\F[] pathname, \FC--dst-path\F[] pathname
    output PNG path

    default is \FC./hist_cov_sec_idx.png\F[]

optional DB specific settings:

\FC-cs\F[] num, \FC--cache-size\F[] num
    DB cache size (how many pages)

\FC-m\F[], \FC--in-memory\F[]
    using IN-MEMORY database

\FC-jo\F[], \FC--journal-off\F[]
    unsafe [but faster] mode