'\" -*- coding: us-ascii -*-
.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 osgearth_tfs 1 "03 January 2019" "" ""
.SH NAME
osgearth_tfs \- generate a TFS dataset from a feature source
.SH SYNOPSIS
'nh
.fi
.ad l
\fBosgearth_tfs\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
\fIfilename\fR [\fB--first-level\fR \fIlevel\fR | \fB--max-level\fR \fIlevel\fR | \fB--max-features\fR \fInumber\fR | \fB--out\fR \fIpath\fR | \fB--layer\fR \fIlayer\fR | \fB--description\fR \fIdescription\fR | \fB--expression\fR \fIexpression\fR | \fB--order-by\fR \fIorder\fR | \fB--crop\fR | \fB--dest-srs\fR \fISRS\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBosgearth_tfs\fR generates a TFS dataset from a feature
source such as a shapefile. By pre-processing your features into the
gridded structure provided by TFS you can significantly increase
performance of large datasets. In addition, the TFS package generated
can be served by any standard web server, web enabling your dataset.
.SH OPTIONS
.TP 
\fIfilename\fR
Shapefile (or other feature source data file)
.TP 
\*(T<\fB\-\-first\-level\fR\*(T> \fIlevel\fR
The first level where features will be added to the quadtree
.TP 
\*(T<\fB\-\-max\-level\fR\*(T> \fIlevel\fR
The maximum level of the feature quadtree
.TP 
\*(T<\fB\-\-max\-features\fR\*(T> \fInumber\fR
The maximum number of features per tile
.TP 
\*(T<\fB\-\-out\fR\*(T> \fIpath\fR
The destination directory
.TP 
\*(T<\fB\-\-layer\fR\*(T> \fIlayer\fR
The name of the layer to be written to the metadata document
.TP 
\*(T<\fB\-\-description\fR\*(T> \fIdescription\fR
The abstract/description of the layer to be written to the metadata document
.TP 
\*(T<\fB\-\-expression\fR\*(T> \fIexpression\fR
The expression to run on the feature source, specific to the feature source
.TP 
\*(T<\fB\-\-order\-by\fR\*(T> \fIorder\fR
Sort the features, if not already included in the expression.
Append DESC for descending order!
.TP 
\*(T<\fB\-\-crop\fR\*(T>
Crops features instead of doing a centroid check. Features can be
added to multiple tiles when cropping is enabled.
.TP 
\*(T<\fB\-\-dest\-srs\fR\*(T> \fISRS\fR
The destination SRS string in any format osgEarth can understand
(wkt, proj4, epsg). If none is specific the source data SRS will
be used.