'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH mapcache_detail 1 "06 February 2024" "" ""
.SH NAME
mapcache_detail \- coverage analysis tool for SQLite caches
.SH SYNOPSIS
'nh
.fi
.ad l
\*(T<\fBmapcache_detail\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fIoptions\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBmapcache_detail\fR is a coverage analysis tool for SQLite caches.
.SH OPTIONS
.TP 
\*(T<\fB\-c\fR\*(T>, \*(T<\fB\-\-config\fR\*(T> \fIfile\fR
Configuration file (/path/to/mapcache.xml)
.TP 
\*(T<\fB\-D\fR\*(T>, \*(T<\fB\-\-dimension\fR\*(T> \fIDIMENSION_NAME=VALUE\fR
Set the value of a dimension: format DIMENSIONNAME=VALUE. Can be used multiple times for multiple dimensions
.TP 
\*(T<\fB\-t\fR\*(T>, \*(T<\fB\-\-tileset\fR\*(T> \fIname\fR
Tileset to analyze
.TP 
\*(T<\fB\-g\fR\*(T>, \*(T<\fB\-\-grid\fR\*(T> \fIname\fR
Grid to analyze
.TP 
\*(T<\fB\-e\fR\*(T>, \*(T<\fB\-\-extent\fR\*(T> \fIminx,miny,maxx,maxy\fR
Extent to analyze: format minx,miny,maxx,maxy. Cannot be used with \*(T<\fB\-\-ogr\-datasource\fR\*(T>
.TP 
\*(T<\fB\-d\fR\*(T>, \*(T<\fB\-\-ogr\-datasource\fR\*(T> \fIdata source\fR
OGR data source to get features from. Cannot be used with \*(T<\fB\-\-extent\fR\*(T>.
.TP 
\*(T<\fB\-l\fR\*(T>, \*(T<\fB\-\-ogr\-layer\fR\*(T> \fIlayer\fR
OGR layer inside OGR data source. Cannot be used with \*(T<\fB\-\-ogr\-sql\fR\*(T>.
.TP 
\*(T<\fB\-w\fR\*(T>, \*(T<\fB\-\-ogr\-where\fR\*(T> \fIfilter\fR
Filter to apply on OGR layer features. Cannot be used with \*(T<\fB\-\-ogr\-sql\fR\*(T>.
.TP 
\*(T<\fB\-s\fR\*(T>, \*(T<\fB\-\-ogr\-sql\fR\*(T> \fISQL query\fR
SQL query to filter inside OGR data source. Cannot be used with \*(T<\fB\-\-ogr\-layer\fR\*(T> or \*(T<\fB\-\-ogr\-where\fR\*(T>.
.TP 
\*(T<\fB\-z\fR\*(T>, \*(T<\fB\-\-zoom\fR\*(T> \fIminzoom,maxzoom\fR
Set min and max zoom levels to analyze, separated by a comma, eg: 12,15
.TP 
\*(T<\fB\-q\fR\*(T>, \*(T<\fB\-\-query\fR\*(T> \fIvalue\fR
Set query for counting tiles in a rectangle. Default value works with default schema of SQLite caches.
.TP 
\*(T<\fB\-o\fR\*(T>, \*(T<\fB\-\-short\-output\fR\*(T>
Only existing SQLite files are reported, missing SQLite files are still taken into account for level and global coverage.
.SH EXAMPLE
Analyze tile coverage of tileset osm with the g grid. Default extent is the whole world and default zoom level is 0:
.PP
.nf
\*(T<
        mapcache_detail \-\-config mapcache.xml \-\-tileset osm \-\-grid g
      \*(T>
.fi
.PP
Same as beforehand, with explicit zoom levels 9 to 12 and explicit extent covering Switzerland:
.PP
.nf
\*(T<
        mapcache_detail \-\-config mapcache.xml \-\-tileset osm \-\-grid g \-\-zoom 9,12 \-\-extent 663000,5751230,1167680,6075050
      \*(T>
.fi