Coverage for gws-app/gws/plugin/raster_layer/__init__.py: 100%

1"""Raster layers from georeferenced image files. 

2 

3This plugin provides the ``raster`` layer, which shows georeferenced image 

4files (e.g. GeoTIFF) from the file system. The images are rendered in 

5process by MapServer; no external service is involved. 

6 

7Submodules 

8---------- 

9 

10- ``provider`` - the image set (`provider.Object`). It lists the image 

11 files, given as ``paths`` or a glob ``pathPattern``, reads their bounds 

12 with GDAL and builds a shapefile tile index for MapServer. 

13- ``layer`` - the ``raster`` image layer. It configures the MapServer layer 

14 options (``processing`` directives, ``transparentColor``, SLD styling) 

15 and computes the layer extent from the image bounds, unless an extent is 

16 configured. 

17- ``grabber`` - the raster grabber, which renders boxes with MapServer. 

18 Boxes are requested in the target CRS, MapServer reprojects the images. 

19 

20All images of a layer must be in the same CRS; images in other CRS, and 

21images that cannot be opened, are skipped with a configuration warning. 

22Images without a CRS get the provider ``crs``, or the map CRS. 

23 

24Example:: 

25 

26 map.layers+ { 

27 title "Orthophotos" 

28 type "raster" 

29 display "tile" 

30 provider.pathPattern "/data/dop/*.tif" 

31 provider.crs 25832 

32 processing [ "BANDS=1,2,3" ] 

33 } 

34"""