rl2tool(1)

📦
version 1.1.0~beta1 · 6 versions
, in ubuntu resolute, ubuntu stonking

💖 rl2tool 💖

okay bestie, so this is the manual for rl2tool, aka the CLI tool for RasterLite2, from section (1) of the manual pages. pull up a chair, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

rl2tool — CLI tool for RasterLite2

🫶 SYNOPSIS 🫶

rl2tool mode [ARGLIST]

so yeah, you pick a mode, you hand it some args, and it does the thing. that's the whole vibe ✨

🌸 DESCRIPTION 🌸

rl2tool is a CLI tool for RasterLite2. short, sweet, iconic. no notes. 👑

💅 OPTIONS 💅

every mode has its own little arglist, so let's go mode by mode, bestie. buckle up. 🌈

🎀 Mode: CREATE 🎀

will create a new RasterLite2 Raster Coverage. brand new baby coverage, obsessed.

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the Coverage's name
  • -smp keyword, --sample-type keyword — Sample Type keyword (go check the list below 👇)
  • -pxl keyword, --pixel-type keyword — Pixel Type keyword (also on the list 👇)
  • -bds integer, --num-bands integer — Number of Bands
  • -cpr keyword, --compression keyword — Compression keyword (yeah you guessed it, list below 👇)
  • -qty integer, --quality integer — Compression Quality [0-100]
  • -tlw integer, --tile-width integer — Tile Width, in [pixels]
  • -tlh integer, --tile-height integer — Tile Height, in [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. bye boo 👋

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the Coverage's name

🌟 Mode: IMPORT 🌟

will create a new Raster Section by importing an external image or raster file. bringing outside content into the group chat, love that for us.

  • -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 — the Coverage's name
  • -srid integer, --srid integer — optional: force SRID value
  • -wf>, --worldfile — requires a Worldfile
  • -pyr, --pyramidize — immediately build Pyramid levels
ok bestie yes, that one flag is literally printed as -wf> in the original page 💀 i did not make that up, i promise. no cap.

🧚 Mode: EXPORT 🧚

will export an external image from a Coverage. sending it out into the world, main character departure ✈️

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -dst pathname, --dst-path pathname — output Image/Raster path
  • -cov string, --coverage string — the 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
fr fr, read that checklist twice. it's giving "required", because it is. 🚨

🍓 Mode: DELETE 🍓

will delete a Raster Section. not me removing things 😭

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the Coverage's name
  • -sec string, --section string — the Section's name

👑 Mode: PYRAMIDIZE 👑

will (re)build all Pyramid levels supporting a Coverage. glow-up time, building levels on levels ✨

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the Coverage's name
  • -sec string, --section string — optional: the 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. same energy, monolithic edition 🗿

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the 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. de-influencing the pyramid levels, honestly iconic of it.

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the Coverage's name
  • -sec string, --section string — optional: the Section's name — default is "All Sections"

⭐ Mode: LIST ⭐

will list Raster Sections within a Coverage. show me the roster bestie 📋

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the Coverage's name
  • -sec string, --section string — optional: the Section's name — default is "All Sections"

🌈 Mode: MAP 🌈

will output a PNG Map representing all Raster Sections within a Coverage. a whole map!! aesthetic 🗺️✨

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the 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. the full guest list, no one left out 💅

  • -db pathname, --db-path pathname — RasterLite2 DB path

💖 Mode: HISTOGRAM 💖

will create a PNG showing a band Histogram. data visualization that ate fr 📊

  • -db pathname, --db-path pathname — RasterLite2 DB path
  • -cov string, --coverage string — the Coverage's name
  • -sec string, --section string — optional: the 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
⚠️ bestie, do not gloss over that last one. -jo / --journal-off is literally described as unsafe [but faster] mode. faster is cute, unsafe is not. know what you're signing up for. 🚩

and that's the whole page, top to bottom, nothing skipped, everything kept. periodt. 💜

this little love letter lives in the rl2tool(1) manual page, dated 06 February 2026 🎀✨ slay, read it, use it, hydrate 🫶🌈

📦 where this page comes from