xenial (1) rl2sniff.1.gz

Provided by: rasterlite2-bin_1.0.0~rc0+devel1-2build1_amd64 bug

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

                                                 27 October 2015                                     rl2sniff(1)