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

                                        02 September 2023                              rl2tool(1)