[SCM] mapserver branch, master, updated. upstream/6.2.1-72-ga226f0d
Bas Couwenberg
sebastic at xs4all.nl
Fri Jul 5 21:22:01 UTC 2013
The following commit has been merged in the master branch:
commit 0b25b4651ec80601e3ddec28549971a5c6856c5e
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Fri Jul 5 19:29:46 2013 +0200
Add man page for shptreetst.
diff --git a/debian/changelog b/debian/changelog
index a2bbba5..cfe8431 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -25,6 +25,7 @@ mapserver (6.2.1-3) UNRELEASED; urgency=low
- scalebar
- shp2img
- shptree
+ - shptreetst
- shptreevis
-- Bas Couwenberg <sebastic at xs4all.nl> Fri, 14 Jun 2013 22:00:07 +0200
diff --git a/debian/man/shptree.1.xml b/debian/man/shptree.1.xml
index 0aaaa81..4556443 100644
--- a/debian/man/shptree.1.xml
+++ b/debian/man/shptree.1.xml
@@ -187,6 +187,11 @@ shptree us_states.shp
<title>SEE ALSO</title>
<citerefentry>
+ <refentrytitle>shptreetst</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+
+ <citerefentry>
<refentrytitle>shptreevis</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>
diff --git a/debian/man/shptreetst.1.xml b/debian/man/shptreetst.1.xml
new file mode 100644
index 0000000..2a9988b
--- /dev/null
+++ b/debian/man/shptreetst.1.xml
@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='shptreetst'>
+
+ <refmeta>
+ <refentrytitle>shptreetst</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>shptreetst</refname>
+ <refpurpose>execute a spatial query on an existing spatial index</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>shptreetst</command>
+ <arg choice='plain'><replaceable>shapefile</replaceable></arg>
+ <arg choice='opt'><replaceable>minx</replaceable> <replaceable>miny</replaceable> <replaceable>maxx</replaceable> <replaceable>maxy</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>shptreetst</command> executes a spatial query on an existing
+ spatial index (.qix), that was created by the
+ <citerefentry>
+ <refentrytitle>shptree</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ utility. This utility is useful to understand how a search of a Shape data
+ set and its <emphasis>qix</emphasis> index works.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><replaceable>shapefile</replaceable></term>
+ <listitem>
+ <para>The name of the .shp file index.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable>minx</replaceable> <replaceable>miny</replaceable> <replaceable>maxx</replaceable> <replaceable>maxy</replaceable></term>
+ <listitem>
+ <para>Extents to render</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </refsect1>
+
+ <refsect1 id='example'>
+ <title>EXAMPLE</title>
+
+ <informalexample>
+ <screen>
+shptreetst esp 879827.480246 4317203.699447 884286.289767 4321662.508967
+
+ This new LSB index supports a shapefile with 48 shapes, 4 depth
+ shapes 6, node 4, -13702.315770,3973784.599548,1127752.921471,4859616.714055
+ shapes 5, node 3, -13702.315770,3973784.599548,614098.064712,4460992.262527
+ shapes 1, node 1, -13702.315770,3973784.599548,331587.893495,4241748.814186
+ shapes 1, node 0, 141678.278400,3973784.599548,331587.893495,4121164.917599
+ shapes 1, node 0, 268807.855447,4193028.047889,614098.064712,4460992.262527
+ shapes 1, node 0, 268807.855447,3973784.599548,614098.064712,4241748.814186
+ shapes 7, node 4, -13702.315770,4372409.051076,614098.064712,4859616.714055
+ shapes 1, node 0, -13702.315770,4372409.051076,331587.893495,4640373.265714
+ shapes 3, node 1, -13702.315770,4591652.499417,331587.893495,4859616.714055
+ shapes 1, node 0, -13702.315770,4712236.396004,176207.299326,4859616.714055
+ shapes 2, node 0, 268807.855447,4372409.051076,614098.064712,4640373.265714
+ shapes 3, node 2, 268807.855447,4591652.499417,614098.064712,4859616.714055
+ shapes 2, node 0, 424188.449617,4712236.396004,614098.064712,4859616.714055
+ shapes 1, node 0, 424188.449617,4591652.499417,614098.064712,4739032.817468
+ shapes 2, node 1, 499952.540988,3973784.599548,1127752.921471,4460992.262527
+ shapes 2, node 0, 499952.540988,4193028.047889,845242.750254,4460992.262527
+ shapes 5, node 3, 499952.540988,4372409.051076,1127752.921471,4859616.714055
+ shapes 1, node 1, 499952.540988,4372409.051076,845242.750254,4640373.265714
+ shapes 1, node 0, 655333.135158,4372409.051076,845242.750254,4519789.369127
+ shapes 1, node 0, 499952.540988,4591652.499417,845242.750254,4859616.714055
+ read entire file now at quad box rec 20 file pos 1084
+ result of rectangle search was
+ 8, 10, 36, 37, 38, 39, 42, 46,
+ </screen>
+
+ Result:
+ <blockquote>
+ <para>
+ The above output from the shptreetst command tells us that the
+ existing <emphasis>.qix</emphasis> index is for a Shape data set that
+ contains 48 shapes; indeed the Shape data set used in this example,
+ <emphasis>esp.shp</emphasis>, contains 48 polygons of Spain. The
+ command also tells us that <emphasis>qix</emphasis> file has a
+ quadtree depth of 4.
+ </para>
+
+ <para>
+ Most importantly, the resulting shape IDs (or feature IDs) that were
+ contained in the bounding box that we passed in our example were
+ returned at the bottom of the output: "8, 10, 36, 37, 38, 39, 42, 46".
+ You can use a tool such as QGIS to view those feature IDs and check
+ what shapes MapServer is querying when a user clicks within that
+ bounding box.
+ </para>
+ </blockquote>
+ </informalexample>
+ </refsect1>
+
+ <refsect1 id='see-also'>
+ <title>SEE ALSO</title>
+
+ <citerefentry>
+ <refentrytitle>shptree</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+
+ <citerefentry>
+ <refentrytitle>shptreevis</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/shptreevis.1.xml b/debian/man/shptreevis.1.xml
index 116de7d..0ea961e 100644
--- a/debian/man/shptreevis.1.xml
+++ b/debian/man/shptreevis.1.xml
@@ -78,6 +78,11 @@ This new LSB index supports a shapefile with 2895 shapes, 10 depth
<citerefentry>
<refentrytitle>shptree</refentrytitle>
<manvolnum>1</manvolnum>
+ </citerefentry>,
+
+ <citerefentry>
+ <refentrytitle>shptreetst</refentrytitle>
+ <manvolnum>1</manvolnum>
</citerefentry>
</refsect1>
diff --git a/debian/mapserver-bin.manpages b/debian/mapserver-bin.manpages
index 9dfe116..59398b3 100644
--- a/debian/mapserver-bin.manpages
+++ b/debian/mapserver-bin.manpages
@@ -3,4 +3,5 @@ debian/man/msencrypt.1
debian/man/scalebar.1
debian/man/shp2img.1
debian/man/shptree.1
+debian/man/shptreetst.1
debian/man/shptreevis.1
--
Mapserver
More information about the Pkg-grass-devel
mailing list