rl2sniff - Sniffer tool for RasterLite2
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.