table of contents
| rl2tool(1) | rl2tool(1) |
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:
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
| 17 February 2022 |