'\" -*- 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 pprepair 1 "02 January 2019" "" ""
.SH NAME
pprepair \- planar partition repair tool
.SH SYNOPSIS
'nh
.fi
.ad l
\fBpprepair\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[
[\fB-i\fR \fIfilename\fR [\fIschemaindex\fR]]
[\fB-o\fR \fIfilename\fR]
[\fB-fix\fR]
[\fB-d\fR]
| \fB-p\fR
[\fB-i\fR \fIfilename\fR [ \fIschemaindex\fR]]
[\fB-t\fR]
[\fB-otnt\fR \fIfilename\fR]
[\fB-vh\fR]
[\fB-sr\fR \fIratio\fR]
[\fB-v\fR]
[\fB-au\fR]
[\fB-rtnn\fR]
[\fB-rtam\fR]
[\fB-rtlb\fR]
[\fB-rrlb\fR]
[\fB-rrrn\fR]
[\fB-rpl\fR \fIfilename\fR]
[\fB-rem\fR \fIfilename\fR]
[\fB-ot\fR \fIfilename\fR]
[\fB-otwp\fR \fIfilename\fR]
[\fB-bd\fR]
[\fB-rp\fR]
[\fB-owp\fR]
[\fB-o\fR \fIfilename\fR]
[\fB-pi\fR]
]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBpprepair\fR (planar partition repair) takes a set of
polygons and ensures that they form a valid planar partition, made of
valid polygons and having no gaps or overlaps.
It can be used as a validator, telling of problems in individual polygons
or in the planar partition, and also as an automatic repair tool,
outputting a set of polygons that do form a valid planar partition.
.SH OPTIONS
Basic options
.TP 
\*(T<\fB\-i\fR\*(T> \fIfilename\fR
Add this file to the triangulation using this schema index
.TP 
\*(T<\fB\-o\fR\*(T> \fIfilename\fR
Output the reconstructed polygons in this file
.TP 
\*(T<\fB\-fix\fR\*(T>
Automagically repair (same as \*(T<\fB\-rrlb\fR\*(T>
\*(T<\fB\-rrrn\fR\*(T>)
.TP 
\*(T<\fB\-d\fR\*(T>
Dissolve the boundaries between regions with the same tag
according to the schema index
.PP
Possible steps (in usual processing order)
.TP 
\*(T<\fB\-i\fR\*(T> \fIfilename\fR
Add this file to the triangulation using this schema index
.TP 
\*(T<\fB\-t\fR\*(T>
Tag the triangulation
.TP 
\*(T<\fB\-otnt\fR\*(T> \fIfilename\fR
Output the tagged triangulation with the number of tags to this
file
.TP 
\*(T<\fB\-vh\fR\*(T>
Consider holes as valid
.TP 
\*(T<\fB\-sr\fR\*(T> \fIration\fR
Split invalid regions at triangles with a higher aspect ratio than
this
.TP 
\*(T<\fB\-v\fR\*(T>
Validate
.TP 
\*(T<\fB\-au\fR\*(T>
Allow removing invalid regions (where convenient)
.TP 
\*(T<\fB\-rtnn\fR\*(T>
Repair triangles by assigning them to the neighbour present on
most sides
.TP 
\*(T<\fB\-rtam\fR\*(T>
Repair triangles by assigning them to a neighbour present on at
least 2 sides
.TP 
\*(T<\fB\-rtlb\fR\*(T>
Repair triangles by assigning them to the neighbour present along
the longest part of their boundary
.TP 
\*(T<\fB\-rrlb\fR\*(T>
Repair regions by assigning them to the neighbour present along
the longest part of their boundary
.TP 
\*(T<\fB\-rrrn\fR\*(T>
Repair regions by assigning them to a random neighbour
.TP 
\*(T<\fB\-rpl\fR\*(T> \fIfilename\fR
Repair by assigning according to the priority list in this file
.TP 
\*(T<\fB\-rem\fR\*(T> \fIfilename\fR
Repair for edge matching according to the priority list in this
file
.TP 
\*(T<\fB\-ot\fR\*(T> \fIfilename\fR
Output the triangulation to this file
.TP 
\*(T<\fB\-otwp\fR\*(T> \fIfilename\fR
Output the triangulation to this file, including the input file
where each triangle came from
.TP 
\*(T<\fB\-bd\fR\*(T>
Removes unnecessary vertices before reconstruction to support
larger data sets (try if you get a segmentation fault)
.TP 
\*(T<\fB\-rp\fR\*(T>
Reconstruct polygons
.TP 
\*(T<\fB\-o\fR\*(T> \fIfilename\fR
Output the reconstructed polygons in this file
.TP 
\*(T<\fB\-owp\fR\*(T> \fIfilename\fR
Output the reconstructed polygons in this file, including the
input file where they came from
.TP 
\*(T<\fB\-pi\fR\*(T>
Print triangulation information
.SH EXAMPLE
.nf
\*(T<
\fBpprepair\fR \fB\-i\fR "\fImyInput.shp\fR" \fB\-o\fR "\fImyOutput.shp\fR" \fB\-fix\fR
      \*(T>
.fi
.SH "SEE ALSO"
\fBprepair\fR(1)