NAME

       rl2sniff - Sniffer tool for RasterLite2

SYNOPSIS

       rl2sniff [ARGLIST]

DESCRIPTION

       rl2sniff  is  a  sniffer  tool  for  RasterLite2.  Sometimes handling a relevant number of
       raster  images  (may  be  of  different  origin   and   presenting   different   technical
       characteristics) isn't an easy task, most notably when your images are dispersed into many
       different folders.  The rl2sniff CLI tool is exactly intended to offer a significant  help
       in  organizing  and  planning  any  preliminary  activity  required in order to create and
       populate your RasterLite2's Coverages.

       rl2sniff will examine files containing a raster image,  and  will  then  create  a  report
       showing  the  more  relevant characteristics for each one; the supported arguments are the
       followings:

       • arguments specifying the intended target:

         • -src pathname: will examine just a single input raster image.

         • -dir pathname: will explore a whole directory aka folder.

         • Please note: -src and -dir are mutually exclusive options.

         • -ext extension: combined with -dir will restrict  the  search  to  a  specific  raster
           format.

         • if no target is explicitly selected (e.g. when there are no arguments at all) then the
           current working directory will be intended by default.

       • -wf: any georeferencing information will be always retrieved from a companion worldfile
         ⟨http://en.wikipedia.org/wiki/World_file⟩ .

         Please note: in this case any georeferencing found in the worldfile will always override
         any other information eventually found e.g. within a GeoTIFF image.

       • -md5: the output report will include an MD5 checksum  ⟨http://en.wikipedia.org/wiki/MD5⟩
         computed for each raster file.

         Please  note:  computing  the  MD5 checksums could require a substantial amount of time,
         most notably when many hundredth huge-sized files are to be scanned.

       the output report.  The report created by rl2sniff simply corresponds to a  TXT/TAB  being
       printed on the stdout file.  The report's columns are as follows:

       • columns always supported for both georeferenced and non-georeferenced rasters:

         • image_format: e.g. GeoTIFF, TIFF+TFW or ASCII Grid.

         • MD5_checksum: may be NULL is the corresponding option wasn't activated.

         • image_path: the absolute path leading to the raster file.

         • width and height: horizontal and vertical dimensions (in pixels).

         • sample_type, pixel_type and bands: e.g. UINT8, RGB, 3.

         • no_data:  value  corresponding  to  NO-DATA pixels (currently supported only for ASCII
           Grids).

         • compression: e.g. DEFLATE or FAX4; NONE if uncompressed.

       • columns supported only for raster of the georeferenced type:

         • srid: the declared SRID value; -1 if unknown / unspecified.

         • x_resolution and y_resolution: horizontal and vertical pixel resolution.

         • min_x, min_y, max_x and max_y: extreme points of the raster's bounding box aka BBOX.

OPTIONS

       -h, --help
              print usage information

       -src pathname, --src-path pathname
              single Image/Raster path

       -dir pathname, --dir-path pathname
              directory path

       -ext extension, --file-ext extension
              file extension (e.g. .tif)

       -wf, --worldfile
              requires a Worldfile

       -md5, --md5-checksum
              enabling MD5 checksums

                                        02 September 2023                             rl2sniff(1)