# that we could produce a large number of files (think chunked HTML)
#
-translations = it_IT pt_BR fr es
+translations = it_IT pt_BR fr es pl
POSTGIS_MAJOR_VERSION=@POSTGIS_MAJOR_VERSION@
POSTGIS_MINOR_VERSION=@POSTGIS_MINOR_VERSION@
--- /dev/null
+DOCSUFFIX=-pl
+include ../Makefile.local
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2014-10-14 22:30+0000\n"
+"PO-Revision-Date: 2014-10-14 22:34+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: extras.xml:3
+#, no-c-format
+msgid "PostGIS Extras"
+msgstr ""
+
+#. Tag: para
+#: extras.xml:5
+#, no-c-format
+msgid ""
+"This chapter documents features found in the extras folder of the PostGIS "
+"source tarballs and source repository. These are not always packaged with "
+"PostGIS binary releases, but are usually plpgsql based or standard shell "
+"scripts that can be run as is."
+msgstr ""
+
+#. Tag: chapter
+#: extras.xml:6
+#, no-c-format
+msgid "&extras_tigergeocoder;"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2014-10-10 23:07+0000\n"
+"PO-Revision-Date: 2014-10-13 18:05+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: extras_address_standardizer.xml:3
+#, no-c-format
+msgid "Address Standardizer"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:4
+#, no-c-format
+msgid ""
+"This is a fork of the <ulink url=\"http://www.pagcgeo.org/docs/html/pagc-11."
+"html\">PAGC standardizer</ulink> (original code for this portion was <ulink "
+"url=\"http://sourceforge.net/p/pagc/code/360/tree/branches/sew-refactor/"
+"postgresql\">PAGC PostgreSQL Address Standardizer</ulink>)."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:5
+#, no-c-format
+msgid ""
+"The address standardizer is a single line address parser that takes an input "
+"address and normalizes it based on a set of rules stored in a table and "
+"helper lex and gaz tables."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:6
+#, no-c-format
+msgid ""
+"The code is built into a single postgresql extension library called "
+"<code>address_standardizer</code> which can be installed with <code>CREATE "
+"EXTENSION address_standardizer;</code>."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:7
+#, no-c-format
+msgid ""
+"The code for this extension can be found in the PostGIS <filename>extensions/"
+"address_standardizer</filename> and is currently self-contained."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:8
+#, no-c-format
+msgid ""
+"For installation instructions refer to: <xref linkend="
+"\"installing_pagc_address_standardizer\"/>."
+msgstr ""
+
+#. Tag: title
+#: extras_address_standardizer.xml:9
+#, no-c-format
+msgid "How the Parser Works"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:10
+#, no-c-format
+msgid ""
+"The parser works from right to left looking first at the macro elements for "
+"postcode, state/province, city, and then looks micro elements to determine "
+"if we are dealing with a house number street or intersection or landmark. It "
+"currently does not look for a country code or name, but that could be "
+"introduced in the future."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:17
+#, no-c-format
+msgid "Country code"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:18
+#, no-c-format
+msgid ""
+"Assumed to be US or CA based on: postcode as US or Canada state/province as "
+"US or Canada else US"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:21
+#, no-c-format
+msgid "Postcode/zipcode"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:22
+#, no-c-format
+msgid ""
+"These are recognized using Perl compatible regular expressions. These regexs "
+"are currently in the parseaddress-api.c and are relatively simple to make "
+"changes to if needed."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:27
+#, no-c-format
+msgid "State/province"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:28
+#, no-c-format
+msgid ""
+"These are recognized using Perl compatible regular expressions. These regexs "
+"are currently in the parseaddress-api.c but could get moved into includes in "
+"the future for easier maintenance."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:37
+#, no-c-format
+msgid ""
+"This section lists the PostgreSQL data types installed by Address "
+"Standardizer extension. Note we describe the casting behavior of these which "
+"is very important especially when designing your own functions."
+msgstr ""
+
+#. Tag: title
+#: extras_address_standardizer.xml:42
+#, no-c-format
+msgid "Address Standardizer Types"
+msgstr ""
+
+#. Tag: refname
+#: extras_address_standardizer.xml:45
+#, no-c-format
+msgid "stdaddr"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_address_standardizer.xml:46
+#, no-c-format
+msgid ""
+"A composite type that consists of the elements of an address. This is the "
+"return type for <varname>standardize_address</varname> function."
+msgstr ""
+
+#. Tag: title
+#: extras_address_standardizer.xml:49 extras_address_standardizer.xml:152
+#: extras_address_standardizer.xml:214 extras_address_standardizer.xml:256
+#: extras_address_standardizer.xml:314 extras_address_standardizer.xml:373
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:50
+#, no-c-format
+msgid ""
+"A composite type that consists of elements of an address. This is the return "
+"type for <xref linkend=\"standardize_address\"/> function. Some descriptions "
+"for elements are borrowed from <ulink url=\"http://www.pagcgeo.org/docs/html/"
+"pagc-12.html#ss12.1\">PAGC Postal Attributes</ulink>."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:51
+#, no-c-format
+msgid ""
+"The token numbers denote the reference number in the <varname>rules</"
+"varname> table."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:52 extras_address_standardizer.xml:321
+#: extras_address_standardizer.xml:379
+#, no-c-format
+msgid "&address_standardizer_required;"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:55
+#, no-c-format
+msgid "building"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:57
+#, no-c-format
+msgid ""
+"is text (token number <code>0</code>): Refers to building number or name. "
+"Unparsed building identifiers and types. Generally blank for most addresses."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:60
+#, no-c-format
+msgid "house_num"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:62
+#, no-c-format
+msgid ""
+"is a text (token number <code>1</code>): This is the street number on a "
+"street. Example <emphasis>75</emphasis> in <code>75 State Street</code>."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:65
+#, no-c-format
+msgid "predir"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:66
+#, no-c-format
+msgid ""
+"is text (token number <code>2</code>): STREET NAME PRE-DIRECTIONAL such as "
+"North, South, East, West etc."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:68
+#, no-c-format
+msgid "qual"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:70
+#, no-c-format
+msgid ""
+"is text (token number <code>3</code>): STREET NAME PRE-MODIFIER Example "
+"<emphasis>OLD</emphasis> in <code>3715 OLD HIGHWAY 99</code>."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:73
+#, no-c-format
+msgid "pretype"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:75
+#, no-c-format
+msgid "is text (token number <code>4</code>): STREET PREFIX TYPE"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:78
+#, no-c-format
+msgid "name"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:80
+#, no-c-format
+msgid "is text (token number <code>5</code>): STREET NAME"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:83
+#, no-c-format
+msgid "suftype"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:85
+#, no-c-format
+msgid ""
+"is text (token number <code>6</code>): STREET POST TYPE e.g. St, Ave, Cir. A "
+"street type following the root street name. Example <emphasis>STREET</"
+"emphasis> in <code>75 State Street</code>."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:88
+#, no-c-format
+msgid "sufdir"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:90
+#, no-c-format
+msgid ""
+"is text (token number <code>7</code>): STREET POST-DIRECTIONAL A directional "
+"modifier that follows the street name.. Example <emphasis>WEST</emphasis> in "
+"<code>3715 TENTH AVENUE WEST</code>."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:93
+#, no-c-format
+msgid "ruralroute"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:95
+#, no-c-format
+msgid ""
+"is text (token number <code>8</code>): RURAL ROUTE . Example <emphasis>8</"
+"emphasis> in <code>RR 7</code>."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:98
+#, no-c-format
+msgid "extra"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:100
+#, no-c-format
+msgid "is text: Extra information like Floor number."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:103
+#, no-c-format
+msgid "city"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:105
+#, no-c-format
+msgid "is text (token number <code>10</code>): Example Boston."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:108
+#, no-c-format
+msgid "state"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:110
+#, no-c-format
+msgid ""
+"is text (token number <code>11</code>): Example <code>MASSACHUSETTS</code>"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:113
+#, no-c-format
+msgid "country"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:115
+#, no-c-format
+msgid "is text (token number <code>12</code>): Example <code>USA</code>"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:118
+#, no-c-format
+msgid "postcode"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:120
+#, no-c-format
+msgid ""
+"is text POSTAL CODE (ZIP CODE) (token number <code>13</code>): Example "
+"<code>02109</code>"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:123
+#, no-c-format
+msgid "<term>box</term>"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:125
+#, no-c-format
+msgid ""
+"is text POSTAL BOX NUMBER (token number <code>14 and 15</code>): Example "
+"<code>02109</code>"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:128
+#, no-c-format
+msgid "unit"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:130
+#, no-c-format
+msgid ""
+"is text Apartment number or Suite Number (token number <code>17</code>): "
+"Example <emphasis>3B</emphasis> in <code>APT 3B</code>."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:141
+#, no-c-format
+msgid ""
+"This section lists the PostgreSQL table formats used by the "
+"address_standardizer for normalizing addresses. Note that these tables do "
+"not need to be named the same as what is referenced here. You can have "
+"different lex, gaz, rules tables for each country for example or for your "
+"custom geocoder. The names of these tables get passed into the address "
+"standardizer functions."
+msgstr ""
+
+#. Tag: title
+#: extras_address_standardizer.xml:145
+#, no-c-format
+msgid "Address Standardizer Tables"
+msgstr ""
+
+#. Tag: refname
+#: extras_address_standardizer.xml:148
+#, no-c-format
+msgid "rules table"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_address_standardizer.xml:149
+#, no-c-format
+msgid ""
+"The rules table contains a set of rules that maps address input sequence "
+"tokens to standardized output sequence"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:153
+#, no-c-format
+msgid ""
+"A rules table must have at least the following columns, though you are "
+"allowed to add more for your own uses."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:157 extras_address_standardizer.xml:220
+#: extras_address_standardizer.xml:262
+#, no-c-format
+msgid "<term>id</term>"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:159 extras_address_standardizer.xml:222
+#: extras_address_standardizer.xml:264
+#, no-c-format
+msgid "Primary key of table"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:162
+#, no-c-format
+msgid "rule"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:164
+#, no-c-format
+msgid ""
+"text field denoting the rule. Details at <ulink url=\"http://www.pagcgeo.org/"
+"docs/html/pagc-12.html#--r-rec--\">PAGC Address Standardizer Rule records</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:165
+#, no-c-format
+msgid ""
+"A rule consists of a set of non-negative integers representing input tokens, "
+"terminated by a -1, followed by an equal number of non-negative integers "
+"representing postal attributes, terminated by a -1, followed by an integer "
+"representing a rule type, followed by an integer representing the rank of "
+"the rule. The rules are ranked from 0 (lowest) to 17 (highest)."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:166
+#, no-c-format
+msgid ""
+"So for example the rule <code>2 0 2 22 3 -1 5 5 6 7 3 -1 2 6</code> maps to "
+"sequence of tokens <emphasis>TYPE NUMBER TYPE DIRECT QUALIF</emphasis> to "
+"the output sequence <emphasis>STREET STREET SUFTYP SUFDIR QUALIF</emphasis>. "
+"The rule is an ARC_C rule of rank 6."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:171
+#, no-c-format
+msgid "Each rule has a rule type which is denoted by one of following:"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:174
+#, no-c-format
+msgid "MACRO_C"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:176
+#, no-c-format
+msgid "(token number = \"0\"). The class of rules for parsing MACRO clauses."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:180
+#, no-c-format
+msgid "MICRO_C"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:182
+#, no-c-format
+msgid ""
+"(token number = \"1\"). The class of rules for parsing full MICRO clauses "
+"(ie ARC_C plus CIVIC_C). These rules are not used in the build phase."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:186
+#, no-c-format
+msgid "ARC_C"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:188
+#, no-c-format
+msgid ""
+"(token number = \"2\"). The class of rules for parsing MICRO clauses, "
+"excluding the HOUSE attribute."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:192
+#, no-c-format
+msgid "CIVIC_C"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:194
+#, no-c-format
+msgid ""
+"(token number = \"3\"). The class of rules for parsing the HOUSE attribute."
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:198
+#, no-c-format
+msgid "EXTRA_C"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:200
+#, no-c-format
+msgid ""
+"(token number = \"4\"). The class of rules for parsing EXTRA attributes - "
+"attributes excluded from geocoding. These rules are not used in the build "
+"phase."
+msgstr ""
+
+#. Tag: refname
+#: extras_address_standardizer.xml:210
+#, no-c-format
+msgid "lex table"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_address_standardizer.xml:211
+#, no-c-format
+msgid ""
+"A lex table is used to classify alphanumeric input and associate that input "
+"with (a) input tokens ( See Input Tokens) and (b) standardized "
+"representations."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:215
+#, no-c-format
+msgid ""
+"A lex (short for lexicon) table is used to classify alphanumeric input and "
+"associate that input with <ulink url=\"http://www.pagcgeo.org/docs/html/"
+"pagc-12.html#--i-tok--\">(a) input tokens</ulink> and (b) standardized "
+"representations. Things you will find in these tables are <code>ONE</code> "
+"mapped to stdworkd: <code>1</code>."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:217
+#, no-c-format
+msgid "A lex has at least the following columns in the table. You may add"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:225 extras_address_standardizer.xml:267
+#, no-c-format
+msgid "<term>seq</term>"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:227 extras_address_standardizer.xml:269
+#, no-c-format
+msgid "integer: definition number?"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:231 extras_address_standardizer.xml:272
+#, no-c-format
+msgid "word"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:233 extras_address_standardizer.xml:274
+#, no-c-format
+msgid "text: the input word"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:236 extras_address_standardizer.xml:277
+#, no-c-format
+msgid "stdword"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:238 extras_address_standardizer.xml:279
+#, no-c-format
+msgid "text: the standardized replacement word"
+msgstr ""
+
+#. Tag: term
+#: extras_address_standardizer.xml:241 extras_address_standardizer.xml:282
+#, no-c-format
+msgid "token"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:243 extras_address_standardizer.xml:284
+#, no-c-format
+msgid ""
+"integer: the kind of word it is. Only if it is used in this context will it "
+"be replaced. Refer to <ulink url=\"http://www.pagcgeo.org/docs/html/pagc-12."
+"html#--i-tok--\">PAGC Tokens</ulink>."
+msgstr ""
+
+#. Tag: refname
+#: extras_address_standardizer.xml:252
+#, no-c-format
+msgid "gaz table"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_address_standardizer.xml:253
+#, no-c-format
+msgid ""
+"A gaz table is used to standardize place names and associate that input with "
+"(a) input tokens ( See Input Tokens) and (b) standardized representations."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:257
+#, no-c-format
+msgid ""
+"A gaz (short for gazeteer) table is used to classify place names and "
+"associate that input with <ulink url=\"http://www.pagcgeo.org/docs/html/"
+"pagc-12.html#--i-tok--\">(a) input tokens</ulink> and (b) standardized "
+"representations. For example if you are in US, you may load these with State "
+"Names and associated abbreviations."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:259
+#, no-c-format
+msgid ""
+"A gaz table has at least the following columns in the table. You may add "
+"more columns if you wish for your own purposes."
+msgstr ""
+
+#. Tag: title
+#: extras_address_standardizer.xml:295
+#, no-c-format
+msgid "Address Standardizer Functions"
+msgstr ""
+
+#. Tag: refname
+#: extras_address_standardizer.xml:298
+#, no-c-format
+msgid "parse_address"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_address_standardizer.xml:300
+#, no-c-format
+msgid "Takes a 1 line address and breaks into parts"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_address_standardizer.xml:305
+#, no-c-format
+msgid ""
+"<funcdef>record <function>parse_address</function></funcdef> "
+"<paramdef><type>text </type> <parameter>address</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:316
+#, no-c-format
+msgid ""
+"Returns takes as input an address, and returns a record output consisting of "
+"fields <emphasis>num</emphasis>, <emphasis>street</emphasis>, "
+"<emphasis>street2</emphasis>, <emphasis>address1</emphasis>, <emphasis>city</"
+"emphasis>, <emphasis>state</emphasis>, <emphasis>zip</emphasis>, "
+"<emphasis>zipplus</emphasis>, <emphasis>country</emphasis>."
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:320 extras_address_standardizer.xml:378
+#, no-c-format
+msgid "Availability: 2.2.0"
+msgstr ""
+
+#. Tag: title
+#: extras_address_standardizer.xml:326 extras_address_standardizer.xml:384
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_address_standardizer.xml:328
+#, no-c-format
+msgid ""
+"SELECT num, street, city, zip, zipplus FROM parse_address('1 Devonshire "
+"Place, Boston, MA 02109-1234');\n"
+" num | street | city | zip | zipplus\n"
+"-----+------------------+--------+-------+---------\n"
+" 1 | Devonshire Place | Boston | 02109 | 1234"
+msgstr ""
+
+#. Tag: title
+#: extras_address_standardizer.xml:338 extras_address_standardizer.xml:417
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: extras_address_standardizer.xml:346
+#, no-c-format
+msgid "standardize_address"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_address_standardizer.xml:348
+#, no-c-format
+msgid ""
+"Returns an stdaddr form of an input address utilizing lex, gaz, and rule "
+"tables."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: extras_address_standardizer.xml:352
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>stdaddr <function>standardize_address</function></"
+"funcdef> <paramdef><type>text </type> <parameter>lextab</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>gaztab</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>rultab</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>address</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>stdaddr "
+"<function>standardize_address</function></funcdef> <paramdef><type>text </"
+"type> <parameter>lextab</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>gaztab</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>rultab</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>micro</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>macro</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:375
+#, no-c-format
+msgid ""
+"Returns an <xref linkend=\"stdaddr\"/> form of an input address utilizing "
+"<xref linkend=\"lextab\"/> table name, <xref linkend=\"gaztab\"/>, and <xref "
+"linkend=\"rulestab\"/> table names and an address."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_address_standardizer.xml:386
+#, no-c-format
+msgid ""
+"SELECT * FROM standardize_address('tiger.pagc_lex', \n"
+" 'tiger.pagc_gaz', 'tiger.pagc_rules', 'One "
+"Devonshire Place, PH 301, Boston, MA 02109-1234');"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:389
+#, no-c-format
+msgid ""
+"Make easier to read we'll dump output using hstore extension CREATE "
+"EXTENSION hstore; you need to install"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_address_standardizer.xml:390
+#, no-c-format
+msgid ""
+"SELECT (each(hstore(p))).* \n"
+" FROM standardize_address('tiger.pagc_lex', 'tiger.pagc_gaz', \n"
+" 'tiger.pagc_rules', 'One Devonshire Place, PH 301, Boston, MA "
+"02109-1234') As p;"
+msgstr ""
+
+#. Tag: screen
+#: extras_address_standardizer.xml:393
+#, no-c-format
+msgid ""
+"key | value\n"
+"------------+-----------------\n"
+" box |\n"
+" city | BOSTON\n"
+" name | DEVONSHIRE\n"
+" qual |\n"
+" unit | # PENTHOUSE 301\n"
+" extra |\n"
+" state | MA\n"
+" predir |\n"
+" sufdir |\n"
+" country | USA\n"
+" pretype |\n"
+" suftype | PL\n"
+" building |\n"
+" postcode | 02109\n"
+" house_num | 1\n"
+" ruralroute |\n"
+"(16 rows)"
+msgstr ""
+
+#. Tag: para
+#: extras_address_standardizer.xml:419
+#, no-c-format
+msgid ""
+", <xref linkend=\"rulestab\"/>, <xref linkend=\"lextab\"/>, <xref linkend="
+"\"gaztab\"/>,"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: extras_historytable.xml:3
+#, no-c-format
+msgid "History Tracking"
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:6
+#, no-c-format
+msgid ""
+"Suppose you have a table of data that represents the current state of a "
+"particular geographic feature. A parcels table, or a roads table, or a fruit "
+"trees table, whatever. Generally, GIS tools understand a table as a single "
+"entity into which they can update, insert and delete rows from. How you do "
+"allow common GIS tools to work against your data, while maintaining an audit "
+"trail of what changes have been made, by whom, and what the past state of "
+"the data is?"
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:10
+#, no-c-format
+msgid ""
+"This <varname>history_table</varname> extra module provides some utility "
+"functions for creating and maintaining history."
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:14
+#, no-c-format
+msgid ""
+"The <varname>history_table</varname> was also packaged in PostGIS 1.5, but "
+"added to the documentation in PostGIS 2.0. This package is written in "
+"plpgsql and located in the <varname>extras/history_table</varname> of "
+"PostGIS source tar balls and source repository."
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:15
+#, no-c-format
+msgid ""
+"If you have a table 'roads', this module will maintain a 'roads_history' "
+"side table, which contains all the columns of the parent table, and the "
+"following additional columns:"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_historytable.xml:16
+#, no-c-format
+msgid ""
+"history_id | integer | not null default \n"
+" date_added | timestamp without time zone | not null default now()\n"
+" date_deleted | timestamp without time zone | \n"
+" last_operation | character varying(30) | not null\n"
+" active_user | character varying(90) | not null default "
+"\"current_user\"()\n"
+" current_version | text | not null"
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:20
+#, no-c-format
+msgid ""
+"When you insert a new record into 'roads' a record is automatically inserted "
+"into 'roads_history', with the 'date_added' filled in the 'date_deleted' set "
+"to NULL, a unique 'history_id', a 'last_operation' of 'INSERT' and "
+"'active_user' set."
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:23
+#, no-c-format
+msgid ""
+"When you delete a record in 'roads', the record in the history table is "
+"*not* deleted, but the 'date_deleted' is set to the current date."
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:26
+#, no-c-format
+msgid ""
+"When you update a record in 'roads', the current record has 'date_deleted' "
+"filled in and a new record is created with the 'date_added' set and "
+"'date_deleted' NULL."
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:30
+#, no-c-format
+msgid ""
+"With this information maintained, it is possible to retrieve the history of "
+"any record in the roads table:"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_historytable.xml:31
+#, no-c-format
+msgid "SELECT * FROM roads_history WHERE roads_pk = 111;"
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:33
+#, no-c-format
+msgid "Or, to retrieve a view of the roads table at any point in the past:"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_historytable.xml:34
+#, no-c-format
+msgid ""
+"SELECT * FROM roads_history \n"
+" WHERE date_added < 'January 1, 2001' AND \n"
+" ( date_deleted >= 'January 1, 2001' OR date_deleted IS NULL );"
+msgstr ""
+
+#. Tag: refname
+#: extras_historytable.xml:38
+#, no-c-format
+msgid "Postgis_Install_History"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_historytable.xml:39
+#, no-c-format
+msgid ""
+"Creates a table that will hold some interesting values for managing history "
+"tables."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_historytable.xml:44
+#, no-c-format
+msgid ""
+"<funcdef>void <function>Postgis_Install_History</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: title
+#: extras_historytable.xml:52 extras_historytable.xml:92
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:54
+#, no-c-format
+msgid ""
+"Creates a table that will hold some interesting values for managing history "
+"tables. Creates a table called <varname>historic_information</varname>"
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:58 extras_historytable.xml:100
+#, no-c-format
+msgid "Availability: 1.5.0"
+msgstr ""
+
+#. Tag: title
+#: extras_historytable.xml:63 extras_historytable.xml:105
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_historytable.xml:65
+#, no-c-format
+msgid "SELECT postgis_install_history();"
+msgstr ""
+
+#. Tag: title
+#: extras_historytable.xml:71 extras_historytable.xml:113
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: extras_historytable.xml:77
+#, no-c-format
+msgid "Postgis_Enable_History"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_historytable.xml:78
+#, no-c-format
+msgid ""
+"Registers a tablein the history_information table for tracking and also adds "
+"in side line history table and insert, update, delete rules on the table."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_historytable.xml:83
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>Postgis_Enable_History</function></funcdef> "
+"<paramdef><type>text </type> <parameter>p_schema</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>p_table</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:94
+#, no-c-format
+msgid ""
+"Registers a table in the history_information table for tracking and also "
+"adds in side line history table with same name as table but prefixed with "
+"<varname>history</varname> in the same schema as the original table. Puts in "
+"insert, update, delete rules on the table. Any inserts,updates,deletes of "
+"the geometry are recorded in the history table."
+msgstr ""
+
+#. Tag: para
+#: extras_historytable.xml:97
+#, no-c-format
+msgid ""
+"This function currently relies on a geometry column being registered in "
+"<varname>geometry_columns</varname> and fails if the geometry column is not "
+"present in <varname>geometry_columns</varname> table."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_historytable.xml:107
+#, no-c-format
+msgid ""
+"CREATE TABLE roads(gid SERIAL PRIMARY KEY, road_name varchar(150));\n"
+"SELECT AddGeometryColumn('roads', 'geom', 26986, 'LINESTRING', 2);\n"
+" \n"
+"SELECT postgis_enable_history('public', 'roads', 'geom') As register_table;\n"
+"register_table\n"
+"--------------\n"
+"t\n"
+"\n"
+"INSERT INTO roads(road_name, geom) \n"
+" VALUES('Test Street', ST_GeomFromText('LINESTRING(231660.5 832170,231647 "
+"832202,231627.5 832250.5)',26986));\n"
+"\n"
+"-- check transaction detail --\n"
+"SELECT date_added, last_operation, current_version \n"
+"FROM roads_history \n"
+"WHERE road_name = 'Test Street' ORDER BY date_added DESC;\n"
+"\n"
+" date_added | last_operation | current_version\n"
+"------------------------+----------------+-----------------\n"
+" 2011-02-07 12:44:36.92 | INSERT | 2"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-10-11 21:39+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: para
+#: extras_tigergeocoder.xml:6
+#, no-c-format
+msgid ""
+"A plpgsql based geocoder written to work with the <ulink url=\"http://www."
+"census.gov/geo/www/tiger/\">TIGER (Topologically Integrated Geographic "
+"Encoding and Referencing system ) / Line and Master Address database export</"
+"ulink> released by the US Census Bureau. In versions prior to 2008 the TIGER "
+"files were released in ASCII format. The older geocoder used to work with "
+"that format and is available in PostGIS source 1.5 and below in "
+"<varname>extras/tiger_geocoder/tiger_2006andbefore</varname>."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:8
+#, no-c-format
+msgid ""
+"There are four components to the geocoder: the data loader functions, the "
+"address normalizer, the address geocoder, and the reverse geocoder. The "
+"latest version updated to use the TIGER 2011 census data is located in the "
+"<varname>extras/tiger_geocoder/tiger_2011</varname> folder."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:9
+#, no-c-format
+msgid ""
+"Although it is designed specifically for the US, a lot of the concepts and "
+"functions are applicable and can be adapted to work with other country "
+"address and road networks."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:10
+#, no-c-format
+msgid ""
+"The script builds a schema called <varname>tiger</varname> to house all the "
+"tiger related functions, reusable lookup data such as road type prefixes, "
+"suffixes, states, various control tables for managing data load, and "
+"skeleton base tables from which all the tiger loaded tables inherit from."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:11
+#, no-c-format
+msgid ""
+"Another schema called <varname>tiger_data</varname> is also created which "
+"houses all the census data for each state that the loader downloads from "
+"Census site and loads into the database. In the current model, each set of "
+"state tables is prefixed with the state code e.g <varname>ma_addr</varname>, "
+"<varname>ma_edges</varname> etc with constraints to enforce only that state "
+"data. Each of these tables inherits from the tables <varname>addr</varname>, "
+"<varname>faces</varname>, <varname>edges</varname>, etc located in the "
+"<varname>tiger schema</varname>."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:13
+#, no-c-format
+msgid ""
+"All the geocode functions only reference the base tables, so there is no "
+"requirement that the data schema be called <varname>tiger_data</varname> or "
+"that data can't be further partitioned into other schemas -- e.g a different "
+"schema for each state, as long as all the tables inherit from the tables in "
+"the <varname>tiger</varname> schema."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:17
+#, no-c-format
+msgid ""
+"If you are using tiger geocoder (tiger_2010), you can upgrade the scripts "
+"using the accompanying upgrade_geocoder.bat / .sh scripts in tiger_2011. One "
+"major change between <varname>tiger_2010</varname> and <varname>tiger_2011</"
+"varname> is that the county and <varname>county</varname> and "
+"<varname>state</varname> tables are no longer broken out by state. We'll be "
+"refining the upgrade scripts until release. If you have data from tiger_2010 "
+"and want replace with tiger_2011 refer to <xref linkend="
+"\"upgrade_tiger_geocoder\"/>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:24
+#, no-c-format
+msgid "Design:"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:25
+#, no-c-format
+msgid ""
+"The goal of this project is to build a fully functional geocoder that can "
+"process an arbitrary United States address string and using normalized TIGER "
+"census data, produce a point geometry and rating reflecting the location of "
+"the given address and likeliness of the location. The higher the rating "
+"number the worse the result."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:27
+#, no-c-format
+msgid ""
+"The <varname>reverse_geocode</varname> function, introduced in PostGIS 2.0.0 "
+"is useful for deriving the street address and cross streets of a GPS "
+"location."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:28
+#, no-c-format
+msgid ""
+"The geocoder should be simple for anyone familiar with PostGIS to install "
+"and use, and should be easily installable and usable on all platforms "
+"supported by PostGIS."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:29
+#, no-c-format
+msgid ""
+"It should be robust enough to function properly despite formatting and "
+"spelling errors."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:30
+#, no-c-format
+msgid ""
+"It should be extensible enough to be used with future data updates, or "
+"alternate data sources with a minimum of coding changes."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:32
+#, no-c-format
+msgid ""
+"The <varname>tiger</varname> schema must be added to the database search "
+"path for the functions to work properly."
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:36
+#, no-c-format
+msgid "Tiger Geocoder"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:38
+#, no-c-format
+msgid ""
+"There are a couple other open source geocoders for PostGIS, that unlike "
+"tiger geocoder have the advantage of multi-country geocoding support"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:40
+#, no-c-format
+msgid ""
+"<ulink url=\"http://wiki.openstreetmap.org/wiki/Nominatim\">Nominatim</"
+"ulink> and uses OpenStreetMap gazeteer formatted data. It requires osm2pgsql "
+"for loading the data, PostgreSQL 8.4+ and PostGIS 1.5+ to function. It is "
+"packaged as a webservice interface and seems designed to be called as a "
+"webservice. Just like the tiger geocoder, it has both a geocoder and a "
+"reverse geocoder component. From the documentation, it is unclear if it has "
+"a pure SQL interface like the tiger geocoder, or if a good deal of the logic "
+"is implemented in the web interface."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:43
+#, no-c-format
+msgid ""
+"<ulink url=\"http://www.gisgraphy.com/\">GIS Graphy</ulink> also utilizes "
+"PostGIS and like Nominatim works with OpenStreetMap (OSM) data. It comes "
+"with a loader to load OSM data and similar to Nominatim is capable of "
+"geocoding not just US. Much like Nominatim, it runs as a webservice and "
+"relies on Java 1.5, Servlet apps, Solr. GisGraphy is cross-platform and also "
+"has a reverse geocoder among some other neat features."
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:48
+#, no-c-format
+msgid "Drop_Indexes_Generate_Script"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:50
+#, no-c-format
+msgid ""
+"<refpurpose>Generates a script that drops all non-primary key and non-unique "
+"indexes on tiger schema and user specified schema. Defaults schema to "
+"<varname>tiger_data</varname> if no schema is specified.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:55
+#, no-c-format
+msgid ""
+"<funcdef>text <function>Drop_Indexes_Generate_Script</function></funcdef> "
+"<paramdef choice=\"opt\"><type>text </type> "
+"<parameter>param_schema=tiger_data</parameter></paramdef>"
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:63 extras_tigergeocoder.xml:106
+#: extras_tigergeocoder.xml:148 extras_tigergeocoder.xml:204
+#: extras_tigergeocoder.xml:266 extras_tigergeocoder.xml:311
+#: extras_tigergeocoder.xml:351 extras_tigergeocoder.xml:390
+#: extras_tigergeocoder.xml:435 extras_tigergeocoder.xml:493
+#: extras_tigergeocoder.xml:550 extras_tigergeocoder.xml:605
+#: extras_tigergeocoder.xml:650 extras_tigergeocoder.xml:728
+#: extras_tigergeocoder.xml:775 extras_tigergeocoder.xml:847
+#: extras_tigergeocoder.xml:912
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:65
+#, no-c-format
+msgid ""
+"<para>Generates a script that drops all non-primary key and non-unique "
+"indexes on tiger schema and user specified schema. Defaults schema to "
+"<varname>tiger_data</varname> if no schema is specified.</para>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:66
+#, no-c-format
+msgid ""
+"This is useful for minimizing index bloat that may confuse the query planner "
+"or take up unnecessary space. Use in combination with <xref linkend="
+"\"Install_Missing_Indexes\"/> to add just the indexes used by the geocoder."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:69 extras_tigergeocoder.xml:154
+#: extras_tigergeocoder.xml:273 extras_tigergeocoder.xml:355
+#: extras_tigergeocoder.xml:398 extras_tigergeocoder.xml:453
+#: extras_tigergeocoder.xml:613 extras_tigergeocoder.xml:801
+#: extras_tigergeocoder.xml:873
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:76 extras_tigergeocoder.xml:118
+#: extras_tigergeocoder.xml:161 extras_tigergeocoder.xml:405
+#: extras_tigergeocoder.xml:460 extras_tigergeocoder.xml:518
+#: extras_tigergeocoder.xml:573 extras_tigergeocoder.xml:620
+#: extras_tigergeocoder.xml:696 extras_tigergeocoder.xml:738
+#: extras_tigergeocoder.xml:806
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:77
+#, no-c-format
+msgid ""
+"SELECT drop_indexes_generate_script() As actionsql;\n"
+"actionsql\n"
+"---------------------------------------------------------\n"
+"DROP INDEX tiger.idx_tiger_countysub_lookup_lower_name;\n"
+"DROP INDEX tiger.idx_tiger_edges_countyfp;\n"
+"DROP INDEX tiger.idx_tiger_faces_countyfp;\n"
+"DROP INDEX tiger.tiger_place_the_geom_gist;\n"
+"DROP INDEX tiger.tiger_edges_the_geom_gist;\n"
+"DROP INDEX tiger.tiger_state_the_geom_gist;\n"
+"DROP INDEX tiger.idx_tiger_addr_least_address;\n"
+"DROP INDEX tiger.idx_tiger_addr_tlid;\n"
+"DROP INDEX tiger.idx_tiger_addr_zip;\n"
+"DROP INDEX tiger.idx_tiger_county_countyfp;\n"
+"DROP INDEX tiger.idx_tiger_county_lookup_lower_name;\n"
+"DROP INDEX tiger.idx_tiger_county_lookup_snd_name;\n"
+"DROP INDEX tiger.idx_tiger_county_lower_name;\n"
+"DROP INDEX tiger.idx_tiger_county_snd_name;\n"
+"DROP INDEX tiger.idx_tiger_county_the_geom_gist;\n"
+"DROP INDEX tiger.idx_tiger_countysub_lookup_snd_name;\n"
+"DROP INDEX tiger.idx_tiger_cousub_countyfp;\n"
+"DROP INDEX tiger.idx_tiger_cousub_cousubfp;\n"
+"DROP INDEX tiger.idx_tiger_cousub_lower_name;\n"
+"DROP INDEX tiger.idx_tiger_cousub_snd_name;\n"
+"DROP INDEX tiger.idx_tiger_cousub_the_geom_gist;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_addr_least_address;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_addr_tlid;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_addr_zip;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_county_countyfp;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_county_lookup_lower_name;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_county_lookup_snd_name;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_county_lower_name;\n"
+"DROP INDEX tiger_data.idx_tiger_data_ma_county_snd_name;\n"
+":\n"
+":"
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:83 extras_tigergeocoder.xml:125
+#: extras_tigergeocoder.xml:168 extras_tigergeocoder.xml:235
+#: extras_tigergeocoder.xml:289 extras_tigergeocoder.xml:328
+#: extras_tigergeocoder.xml:368 extras_tigergeocoder.xml:412
+#: extras_tigergeocoder.xml:470 extras_tigergeocoder.xml:528
+#: extras_tigergeocoder.xml:582 extras_tigergeocoder.xml:627
+#: extras_tigergeocoder.xml:706 extras_tigergeocoder.xml:749
+#: extras_tigergeocoder.xml:821 extras_tigergeocoder.xml:889
+#: extras_tigergeocoder.xml:929
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:84 extras_tigergeocoder.xml:413
+#, no-c-format
+msgid ", <xref linkend=\"Missing_Indexes_Generate_Script\"/>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:90
+#, no-c-format
+msgid "Drop_Nation_Tables_Generate_Script"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:92
+#, no-c-format
+msgid ""
+"Generates a script that drops all tables in the specified schema that start "
+"with <varname>county_all</varname>, <varname>state_all</varname> or stae "
+"code followed by <varname>county</varname> or <varname>state</varname>."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:97 extras_tigergeocoder.xml:139
+#, no-c-format
+msgid ""
+"<funcdef>text <function>Drop_State_Tables_Generate_Script</function></"
+"funcdef> <paramdef><type>text </type> <parameter>param_state</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>param_schema=tiger_data</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:108
+#, no-c-format
+msgid ""
+"Generates a script that drops all tables in the specified schema that start "
+"with <varname>county_all</varname>, <varname>state_all</varname> or stae "
+"code followed by <varname>county</varname> or <varname>state</varname>. This "
+"is needed if you are upgrading from <varname>tiger_2010</varname> to "
+"<varname>tiger_2011</varname> data."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:111 extras_tigergeocoder.xml:316
+#: extras_tigergeocoder.xml:567 extras_tigergeocoder.xml:916
+#, no-c-format
+msgid "Availability: 2.1.0"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:119
+#, no-c-format
+msgid ""
+"SELECT drop_nation_tables_generate_script();\n"
+"DROP TABLE tiger_data.county_all;\n"
+"DROP TABLE tiger_data.county_all_lookup;\n"
+"DROP TABLE tiger_data.state_all;\n"
+"DROP TABLE tiger_data.ma_county;\n"
+"DROP TABLE tiger_data.ma_state;"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:132
+#, no-c-format
+msgid "Drop_State_Tables_Generate_Script"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:134
+#, no-c-format
+msgid ""
+"Generates a script that drops all tables in the specified schema that are "
+"prefixed with the state abbreviation. Defaults schema to "
+"<varname>tiger_data</varname> if no schema is specified."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:150
+#, no-c-format
+msgid ""
+"Generates a script that drops all tables in the specified schema that are "
+"prefixed with the state abbreviation. Defaults schema to "
+"<varname>tiger_data</varname> if no schema is specified. This function is "
+"useful for dropping tables of a state just before you reload a state in case "
+"something went wrong during your previous load."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:162
+#, no-c-format
+msgid ""
+"SELECT drop_state_tables_generate_script('PA');\n"
+"DROP TABLE tiger_data.pa_addr;\n"
+"DROP TABLE tiger_data.pa_county;\n"
+"DROP TABLE tiger_data.pa_county_lookup;\n"
+"DROP TABLE tiger_data.pa_cousub;\n"
+"DROP TABLE tiger_data.pa_edges;\n"
+"DROP TABLE tiger_data.pa_faces;\n"
+"DROP TABLE tiger_data.pa_featnames;\n"
+"DROP TABLE tiger_data.pa_place;\n"
+"DROP TABLE tiger_data.pa_state;\n"
+"DROP TABLE tiger_data.pa_zip_lookup_base;\n"
+"DROP TABLE tiger_data.pa_zip_state;\n"
+"DROP TABLE tiger_data.pa_zip_state_loc;"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:174
+#, no-c-format
+msgid "Geocode"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:176
+#, no-c-format
+msgid ""
+"Takes in an address as a string (or other normalized address) and outputs a "
+"set of possible locations which include a point geometry in NAD 83 long lat, "
+"a normalized address for each, and the rating. The lower the rating the more "
+"likely the match. Results are sorted by lowest rating first. Can optionally "
+"pass in maximum results, defaults to 10, and restrict_region (defaults to "
+"NULL)"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: extras_tigergeocoder.xml:181
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>setof record <function>geocode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>address</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>max_results=10</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>geometry </type> "
+"<parameter>restrict_region=NULL</parameter></paramdef> "
+"<paramdef><type>norm_addy </type> <parameter>OUT addy</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>OUT geomout</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>OUT rating</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>setof record "
+"<function>geocode</function></funcdef> <paramdef><type>norm_addy </type> "
+"<parameter>in_addy</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>max_results=10</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>geometry </type> "
+"<parameter>restrict_region=NULL</parameter></paramdef> "
+"<paramdef><type>norm_addy </type> <parameter>OUT addy</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>OUT geomout</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>OUT rating</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:206
+#, no-c-format
+msgid ""
+"Takes in an address as a string (or already normalized address) and outputs "
+"a set of possible locations which include a point geometry in NAD 83 long "
+"lat, a <varname>normalized_address</varname> (addy) for each, and the "
+"rating. The lower the rating the more likely the match. Results are sorted "
+"by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy "
+"string matching (soundex,levenshtein) and PostGIS line interpolation "
+"functions to interpolate address along the Tiger edges. The higher the "
+"rating the less likely the geocode is right. The geocoded point is defaulted "
+"to offset 10 meters from center-line off to side (L/R) of street address is "
+"located on."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:210
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 to support Tiger 2010 structured data and revised some logic "
+"to improve speed, accuracy of geocoding, and to offset point from centerline "
+"to side of street address is located on. New parameter max_results useful "
+"for specifying ot just return the best result."
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:216 extras_tigergeocoder.xml:279
+#: extras_tigergeocoder.xml:361
+#, no-c-format
+msgid "Examples: Basic"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:217
+#, no-c-format
+msgid ""
+"The below examples timings are on a 3.0 GHZ single processor Windows 7 "
+"machine with 2GB ram running PostgreSQL 9.1rc1/PostGIS 2.0 loaded with all "
+"of MA,MN,CA, RI state Tiger data loaded."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:218
+#, no-c-format
+msgid "Exact matches are faster to compute (61ms)"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:219
+#, no-c-format
+msgid ""
+"SELECT g.rating, ST_X(g.geomout) As lon, ST_Y(g.geomout) As lat, \n"
+" (addy).address As stno, (addy).streetname As street, \n"
+" (addy).streettypeabbrev As styp, (addy).location As city, (addy)."
+"stateabbrev As st,(addy).zip \n"
+" FROM geocode('75 State Street, Boston MA 02109') As g; \n"
+" rating | lon | lat | stno | street | styp | "
+"city | st | zip \n"
+"--------+-------------------+------------------+------+--------+------"
+"+--------+----+-------\n"
+" 0 | -71.0556722990239 | 42.3589914927049 | 75 | State | St | "
+"Boston | MA | 02109"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:220
+#, no-c-format
+msgid ""
+"Even if zip is not passed in the geocoder can guess (took about 122-150 ms)"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:221
+#, no-c-format
+msgid ""
+"SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n"
+" (addy).address As stno, (addy).streetname As street, \n"
+" (addy).streettypeabbrev As styp, (addy).location As city, (addy)."
+"stateabbrev As st,(addy).zip \n"
+" FROM geocode('226 Hanover Street, Boston, MA',1) As g; \n"
+" rating | wktlonlat | stno | street | styp | city | st | "
+"zip \n"
+"--------+---------------------------+------+---------+------+--------+----"
+"+-------\n"
+" 1 | POINT(-71.05528 42.36316) | 226 | Hanover | St | Boston | MA | "
+"02113"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:222
+#, no-c-format
+msgid ""
+"Can handle misspellings and provides more than one possible solution with "
+"ratings and takes longer (500ms)."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:223
+#, no-c-format
+msgid ""
+"SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n"
+" (addy).address As stno, (addy).streetname As street, \n"
+" (addy).streettypeabbrev As styp, (addy).location As city, (addy)."
+"stateabbrev As st,(addy).zip \n"
+" FROM geocode('31 - 37 Stewart Street, Boston, MA 02116') As g; \n"
+" rating | wktlonlat | stno | street | styp | city | st | "
+"zip \n"
+"--------+---------------------------+------+--------+------+--------+----"
+"+-------\n"
+" 70 | POINT(-71.06459 42.35113) | 31 | Stuart | St | Boston | MA | "
+"02116"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:225
+#, no-c-format
+msgid ""
+"Using to do a batch geocode of addresses. Easiest is to set "
+"<varname>max_results=1</varname>. Only process those not yet geocoded (have "
+"no rating)."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:226
+#, no-c-format
+msgid ""
+"CREATE TABLE addresses_to_geocode(addid serial PRIMARY KEY, address text,\n"
+" lon numeric, lat numeric, new_address text, rating "
+"integer);\n"
+"\n"
+"INSERT INTO addresses_to_geocode(address)\n"
+"VALUES ('529 Main Street, Boston MA, 02129'),\n"
+" ('77 Massachusetts Avenue, Cambridge, MA 02139'),\n"
+" ('25 Wizard of Oz, Walaford, KS 99912323'),\n"
+" ('26 Capen Street, Medford, MA'),\n"
+" ('124 Mount Auburn St, Cambridge, Massachusetts 02138'),\n"
+" ('950 Main Street, Worcester, MA 01610');\n"
+" \n"
+"-- only update the first 3 addresses (323-704 ms - there are caching and "
+"shared memory effects so first geocode you do is always slower) --\n"
+"-- for large numbers of addresses you don't want to update all at once\n"
+"-- since the whole geocode must commit at once \n"
+"-- For this example we rejoin with LEFT JOIN \n"
+"-- and set to rating to -1 rating if no match \n"
+"-- to ensure we don't regeocode a bad address \n"
+"UPDATE addresses_to_geocode\n"
+" SET (rating, new_address, lon, lat) \n"
+" = ( COALESCE((g.geo).rating,-1), pprint_addy((g.geo).addy),\n"
+" ST_X((g.geo).geomout)::numeric(8,5), ST_Y((g.geo).geomout)::"
+"numeric(8,5) )\n"
+"FROM (SELECT addid \n"
+" FROM addresses_to_geocode \n"
+" WHERE rating IS NULL ORDER BY addid LIMIT 3) As a\n"
+" LEFT JOIN (SELECT addid, (geocode(address,1)) As geo\n"
+" FROM addresses_to_geocode As ag\n"
+" WHERE ag.rating IS NULL ORDER BY addid LIMIT 3) As g ON a.addid = g."
+"addid\n"
+"WHERE a.addid = addresses_to_geocode.addid;\n"
+"\n"
+"result\n"
+"-----\n"
+"Query returned successfully: 3 rows affected, 480 ms execution time.\n"
+"\n"
+"SELECT * FROM addresses_to_geocode WHERE rating is not null;\n"
+"\n"
+" addid | address | lon | lat "
+"| new_address | rating \n"
+"-------+----------------------------------------------+-----------+----------"
+"+-------------------------------------------+--------\n"
+" 1 | 529 Main Street, Boston MA, 02129 | -71.07181 | 42.38359 "
+"| 529 Main St, Boston, MA 02129 | 0\n"
+" 2 | 77 Massachusetts Avenue, Cambridge, MA 02139 | -71.09428 | 42.35988 "
+"| 77 Massachusetts Ave, Cambridge, MA 02139 | 0\n"
+" 3 | 25 Wizard of Oz, Walaford, KS 99912323 | | "
+"| | -1"
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:229
+#, no-c-format
+msgid "Examples: Using Geometry filter"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:230
+#, no-c-format
+msgid ""
+"SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n"
+" (addy).address As stno, (addy).streetname As street, \n"
+" (addy).streettypeabbrev As styp, \n"
+" (addy).location As city, (addy).stateabbrev As st,(addy).zip \n"
+" FROM geocode('100 Federal Street, MA',\n"
+" 3, \n"
+" (SELECT ST_Union(the_geom) \n"
+" FROM place WHERE statefp = '25' AND name = 'Lynn')::"
+"geometry\n"
+" ) As g;\n"
+"\n"
+" rating | wktlonlat | stno | street | styp | city | st | "
+"zip\n"
+"--------+--------------------------+------+---------+------+------+----"
+"+-------\n"
+" 8 | POINT(-70.96796 42.4659) | 100 | Federal | St | Lynn | MA | "
+"01905\n"
+"Total query runtime: 245 ms."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:236
+#, no-c-format
+msgid ""
+", <xref linkend=\"Pprint_Addy\"/>, <xref linkend=\"ST_AsText\"/>, <xref "
+"linkend=\"ST_SnapToGrid\"/>, <xref linkend=\"ST_X\"/>, <xref linkend=\"ST_Y"
+"\"/>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:242
+#, no-c-format
+msgid "Geocode_Intersection"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:244
+#, no-c-format
+msgid ""
+"Takes in 2 streets that intersect and a state, city, zip, and outputs a set "
+"of possible locations on the first cross street that is at the intersection, "
+"also includes a point geometry in NAD 83 long lat, a normalized address for "
+"each location, and the rating. The lower the rating the more likely the "
+"match. Results are sorted by lowest rating first. Can optionally pass in "
+"maximum results, defaults to 10"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:250
+#, no-c-format
+msgid ""
+"<funcdef>setof record <function>geocode_intersection</function></funcdef> "
+"<paramdef><type>text </type> <parameter> roadway1</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter> roadway2</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter> in_state</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter> in_city</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> <parameter> in_zip</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>max_results=10</parameter></paramdef> <paramdef><type>norm_addy </"
+"type> <parameter>OUT addy</parameter></paramdef> <paramdef><type>geometry </"
+"type> <parameter>OUT geomout</parameter></paramdef> <paramdef><type>integer "
+"</type> <parameter>OUT rating</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:268
+#, no-c-format
+msgid ""
+"Takes in 2 streets that intersect and a state, city, zip, and outputs a set "
+"of possible locations on the first cross street that is at the intersection, "
+"also includes a point geometry in NAD 83 long lat, a normalized address for "
+"each location, and the rating. The lower the rating the more likely the "
+"match. Results are sorted by lowest rating first. Can optionally pass in "
+"maximum results, defaults to 10. Returns <varname>normalized_address</"
+"varname> (addy) for each, geomout as the point location in nad 83 long lat, "
+"and the rating. The lower the rating the more likely the match. Results are "
+"sorted by lowest rating first. Uses Tiger data (edges,faces,addr), "
+"PostgreSQL fuzzy string matching (soundex,levenshtein)"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:280
+#, no-c-format
+msgid ""
+"The below examples timings are on a 3.0 GHZ single processor Windows 7 "
+"machine with 2GB ram running PostgreSQL 9.0/PostGIS 1.5 loaded with all of "
+"MA state Tiger data loaded. Currently a bit slow (3000 ms)"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:281
+#, no-c-format
+msgid ""
+"Testing on Windows 2003 64-bit 8GB on PostGIS 2.0 PostgreSQL 64-bit Tiger "
+"2011 data loaded -- (41ms)"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:282
+#, no-c-format
+msgid ""
+"SELECT pprint_addy(addy), st_astext(geomout),rating \n"
+" FROM geocode_intersection( 'Haverford St','Germania "
+"St', 'MA', 'Boston', '02130',1); \n"
+" pprint_addy | st_astext | rating\n"
+"----------------------------------+----------------------------+--------\n"
+"98 Haverford St, Boston, MA 02130 | POINT(-71.101375 42.31376) | 0"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:283
+#, no-c-format
+msgid ""
+"Even if zip is not passed in the geocoder can guess (took about 3500 ms on "
+"the windows 7 box), on the windows 2003 64-bit 741 ms"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:284
+#, no-c-format
+msgid ""
+"SELECT pprint_addy(addy), st_astext(geomout),rating \n"
+" FROM geocode_intersection('Weld', 'School', "
+"'MA', 'Boston');\n"
+" pprint_addy | st_astext | rating\n"
+"-------------------------------+--------------------------+--------\n"
+" 98 Weld Ave, Boston, MA 02119 | POINT(-71.099 42.314234) | 3\n"
+" 99 Weld Ave, Boston, MA 02119 | POINT(-71.099 42.314234) | 3"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:290
+#, no-c-format
+msgid ", <xref linkend=\"Pprint_Addy\"/>, <xref linkend=\"ST_AsText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:296
+#, no-c-format
+msgid "Get_Geocode_Setting"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:298
+#, no-c-format
+msgid ""
+"Returns value of specific setting stored in tiger.geocode_settings table."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:303
+#, no-c-format
+msgid ""
+"<funcdef>text <function>Get_Geocode_Setting</function></funcdef> "
+"<paramdef><type>text </type> <parameter> setting_name</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:313
+#, no-c-format
+msgid ""
+"Returns value of specific setting stored in tiger.geocode_settings table. "
+"Settings allow you to toggle debugging of functions. Later plans will be to "
+"control rating with settings. Current list of settings are as follows:"
+msgstr ""
+
+#. Tag: screen
+#: extras_tigergeocoder.xml:314
+#, no-c-format
+msgid ""
+"name | category | "
+"short_desc \n"
+"----------------------------+----------"
+"+----------------------------------------------------------------------------------\n"
+" debug_geocode_address | debug | outputs debug information in notice "
+"log such as queries \n"
+" | when geocode_addresss is called if "
+"true\n"
+" debug_geocode_intersection | debug | outputs debug information in notice "
+"log such as queries \n"
+" | when geocode_intersection is "
+"called if true\n"
+" debug_normalize_address | debug | outputs debug information in notice "
+"log such as queries \n"
+" | and intermediate expressions when "
+"normalize_address is called if true\n"
+" debug_reverse_geocode | debug | if true, outputs debug information "
+"in notice log \n"
+" such as queries and intermediate "
+"expressions when reverse_geocode"
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:322 extras_tigergeocoder.xml:922
+#, no-c-format
+msgid "Example return debugging setting"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:323
+#, no-c-format
+msgid ""
+"SELECT get_geocode_setting('debug_geocode_address) As result;\n"
+"result\n"
+"---------\n"
+"false"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:335
+#, no-c-format
+msgid "Get_Tract"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:337
+#, no-c-format
+msgid ""
+"Returns census tract or field from tract table of where the geometry is "
+"located. Default to returning short name of tract."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:342
+#, no-c-format
+msgid ""
+"<funcdef>text <function>get_tract</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter> loc_geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter> output_field=name</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:353
+#, no-c-format
+msgid ""
+"Given a geometry will return the census tract location of that geometry. NAD "
+"83 long lat is assumed if no spatial ref sys is specified."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:362
+#, no-c-format
+msgid ""
+"SELECT get_tract(ST_Point(-71.101375, 42.31376) ) As tract_name;\n"
+"tract_name\n"
+"---------\n"
+"1203.01"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:363
+#, no-c-format
+msgid ""
+"--this one returns the tiger geoid\n"
+"SELECT get_tract(ST_Point(-71.101375, 42.31376), 'tract_id' ) As tract_id;\n"
+"tract_id\n"
+"---------\n"
+"25025120301"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:369
+#, no-c-format
+msgid "<para>></para>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:375
+#, no-c-format
+msgid "Install_Missing_Indexes"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:377
+#, no-c-format
+msgid ""
+"Finds all tables with key columns used in geocoder joins and filter "
+"conditions that are missing used indexes on those columns and will add them."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:382
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>Install_Missing_Indexes</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:392
+#, no-c-format
+msgid ""
+"Finds all tables in <varname>tiger</varname> and <varname>tiger_data</"
+"varname> schemas with key columns used in geocoder joins and filters that "
+"are missing indexes on those columns and will output the SQL DDL to define "
+"the index for those tables and then execute the generated script. This is a "
+"helper function that adds new indexes needed to make queries faster that may "
+"have been missing during the load process. This function is a companion to "
+"<xref linkend=\"Missing_Indexes_Generate_Script\"/> that in addition to "
+"generating the create index script, also executes it. It is called as part "
+"of the <filename>update_geocode.sql</filename> upgrade script."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:406
+#, no-c-format
+msgid ""
+"SELECT install_missing_indexes();\n"
+" install_missing_indexes\n"
+"-------------------------\n"
+" t"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:419
+#, no-c-format
+msgid "Loader_Generate_Census_Script"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:421
+#, no-c-format
+msgid ""
+"Generates a shell script for the specified platform for the specified states "
+"that will download Tiger census state tract, bg, and tabblocks data tables, "
+"stage and load into <varname>tiger_data</varname> schema. Each state script "
+"is returned as a separate record."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:426
+#, no-c-format
+msgid ""
+"<funcdef>setof text <function>loader_generate_census_script</function></"
+"funcdef> <paramdef><type>text[]</type> <parameter>param_states</parameter></"
+"paramdef> <paramdef><type>text</type> <parameter>os</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:437
+#, no-c-format
+msgid ""
+"Generates a shell script for the specified platform for the specified states "
+"that will download Tiger data census state <varname>tract</varname>, block "
+"groups <varname>bg</varname>, and <varname>tabblocks</varname> data tables, "
+"stage and load into <varname>tiger_data</varname> schema. Each state script "
+"is returned as a separate record."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:438
+#, no-c-format
+msgid ""
+"It uses unzip on Linux (7-zip on Windows by default) and wget to do the "
+"downloading. It uses <xref linkend=\"shp2pgsql_usage\"/> to load in the "
+"data. Note the smallest unit it does is a whole state. It will only process "
+"the files in the staging and temp folders."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:440 extras_tigergeocoder.xml:498
+#, no-c-format
+msgid ""
+"It uses the following control tables to control the process and different OS "
+"shell syntax variations."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:444 extras_tigergeocoder.xml:502
+#: extras_tigergeocoder.xml:558
+#, no-c-format
+msgid ""
+"<varname>loader_variables</varname> keeps track of various variables such as "
+"census site, year, data and staging schemas"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:447 extras_tigergeocoder.xml:505
+#, no-c-format
+msgid ""
+"<varname>loader_platform</varname> profiles of various platforms and where "
+"the various executables are located. Comes with windows and linux. More can "
+"be added."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:450 extras_tigergeocoder.xml:508
+#: extras_tigergeocoder.xml:564
+#, no-c-format
+msgid ""
+"<varname>loader_lookuptables</varname> each record defines a kind of table "
+"(state, county), whether to process records in it and how to load them in. "
+"Defines the steps to import data, stage data, add, removes columns, indexes, "
+"and constraints for each. Each table is prefixed with the state and inherits "
+"from a table in the tiger schema. e.g. creates <varname>tiger_data.ma_faces</"
+"varname> which inherits from <varname>tiger.faces</varname>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:454
+#, no-c-format
+msgid ""
+"includes this logic, but if you installed tiger geocoder prior to PostGIS "
+"2.0.0 alpha5, you'll need to run this on the states you have already done to "
+"get these additional tables."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:461
+#, no-c-format
+msgid ""
+"Generate script to load up data for select states in Windows shell script "
+"format."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:462
+#, no-c-format
+msgid ""
+"SELECT loader_generate_census_script(ARRAY['MA'], 'windows');\n"
+"-- result --\n"
+"set STATEDIR=\"\\gisdata\\www2.census.gov\\geo\\pvs\\tiger2010st"
+"\\25_Massachusetts\"\n"
+"set TMPDIR=\\gisdata\\temp\\\n"
+"set UNZIPTOOL=\"C:\\Program Files\\7-Zip\\7z.exe\"\n"
+"set WGETTOOL=\"C:\\wget\\wget.exe\"\n"
+"set PGBIN=C:\\projects\\pg\\pg91win\\bin\\\n"
+"set PGPORT=5432\n"
+"set PGHOST=localhost\n"
+"set PGUSER=postgres\n"
+"set PGPASSWORD=yourpasswordhere\n"
+"set PGDATABASE=tiger_postgis20\n"
+"set PSQL=\"%PGBIN%psql\"\n"
+"set SHP2PGSQL=\"%PGBIN%shp2pgsql\"\n"
+"cd \\gisdata\n"
+"\n"
+"%WGETTOOL% http://www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts/25/ --"
+"no-parent --relative --accept=*bg10.zip,*tract10.zip,*tabblock10.zip --"
+"mirror --reject=html\n"
+"del %TMPDIR%\\*.* /Q\n"
+"%PSQL% -c \"DROP SCHEMA tiger_staging CASCADE;\"\n"
+"%PSQL% -c \"CREATE SCHEMA tiger_staging;\"\n"
+"cd %STATEDIR%\n"
+"for /r %%z in (*.zip) do %UNZIPTOOL% e %%z -o%TMPDIR% \n"
+"cd %TMPDIR% \n"
+"%PSQL% -c \"CREATE TABLE tiger_data.MA_tract(CONSTRAINT pk_MA_tract PRIMARY "
+"KEY (tract_id) ) INHERITS(tiger.tract); \" \n"
+"%SHP2PGSQL% -c -s 4269 -g the_geom -W \"latin1\" tl_2010_25_tract10.dbf "
+"tiger_staging.ma_tract10 | %PSQL%\n"
+"%PSQL% -c \"ALTER TABLE tiger_staging.MA_tract10 RENAME geoid10 TO "
+"tract_id; SELECT loader_load_staged_data(lower('MA_tract10'), "
+"lower('MA_tract')); \"\n"
+"%PSQL% -c \"CREATE INDEX tiger_data_MA_tract_the_geom_gist ON tiger_data."
+"MA_tract USING gist(the_geom);\"\n"
+"%PSQL% -c \"VACUUM ANALYZE tiger_data.MA_tract;\"\n"
+"%PSQL% -c \"ALTER TABLE tiger_data.MA_tract ADD CONSTRAINT chk_statefp CHECK "
+"(statefp = '25');\"\n"
+":"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:463 extras_tigergeocoder.xml:521
+#, no-c-format
+msgid "Generate sh script"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:464
+#, no-c-format
+msgid ""
+"STATEDIR=\"/gisdata/www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts\" \n"
+"TMPDIR=\"/gisdata/temp/\"\n"
+"UNZIPTOOL=unzip\n"
+"WGETTOOL=\"/usr/bin/wget\"\n"
+"export PGBIN=/usr/pgsql-9.0/bin\n"
+"export PGPORT=5432\n"
+"export PGHOST=localhost\n"
+"export PGUSER=postgres\n"
+"export PGPASSWORD=yourpasswordhere\n"
+"export PGDATABASE=geocoder\n"
+"PSQL=${PGBIN}/psql\n"
+"SHP2PGSQL=${PGBIN}/shp2pgsql\n"
+"cd /gisdata\n"
+"\n"
+"wget http://www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts/25/ --no-"
+"parent --relative --accept=*bg10.zip,*tract10.zip,*tabblock10.zip --mirror --"
+"reject=html\n"
+"rm -f ${TMPDIR}/*.*\n"
+"${PSQL} -c \"DROP SCHEMA tiger_staging CASCADE;\"\n"
+"${PSQL} -c \"CREATE SCHEMA tiger_staging;\"\n"
+"cd $STATEDIR\n"
+"for z in *.zip; do $UNZIPTOOL -o -d $TMPDIR $z; done\n"
+":\n"
+":"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:477
+#, no-c-format
+msgid "Loader_Generate_Script"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:479
+#, no-c-format
+msgid ""
+"Generates a shell script for the specified platform for the specified states "
+"that will download Tiger data, stage and load into <varname>tiger_data</"
+"varname> schema. Each state script is returned as a separate record. Latest "
+"version supports Tiger 2010 structural changes and also loads census tract, "
+"block groups, and blocks tables."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:484
+#, no-c-format
+msgid ""
+"<funcdef>setof text <function>loader_generate_script</function></funcdef> "
+"<paramdef><type>text[]</type> <parameter>param_states</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>os</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:495
+#, no-c-format
+msgid ""
+"Generates a shell script for the specified platform for the specified states "
+"that will download Tiger data, stage and load into <varname>tiger_data</"
+"varname> schema. Each state script is returned as a separate record."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:496
+#, no-c-format
+msgid ""
+"It uses unzip on Linux (7-zip on Windows by default) and wget to do the "
+"downloading. It uses <xref linkend=\"shp2pgsql_usage\"/> to load in the "
+"data. Note the smallest unit it does is a whole state, but you can overwrite "
+"this by downloading the files yourself. It will only process the files in "
+"the staging and temp folders."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:511
+#, no-c-format
+msgid ""
+"Availability: 2.0.0 to support Tiger 2010 structured data and load census "
+"tract (tract), block groups (bg), and blocks (tabblocks) tables ."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:519
+#, no-c-format
+msgid ""
+"Generate script to load up data for 2 states in Windows shell script format."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:520
+#, no-c-format
+msgid ""
+"SELECT loader_generate_script(ARRAY['MA','RI'], 'windows') AS result;\n"
+"-- result --\n"
+"set STATEDIR=\"\\gisdata\\www2.census.gov\\geo\\pvs\\tiger2010st"
+"\\44_Rhode_Island\"\n"
+"set TMPDIR=\\gisdata\\temp\\\n"
+"set UNZIPTOOL=\"C:\\Program Files\\7-Zip\\7z.exe\"\n"
+"set WGETTOOL=\"C:\\wget\\wget.exe\"\n"
+"set PGBIN=C:\\Program Files\\PostgreSQL\\8.4\\bin\\\n"
+"set PGPORT=5432\n"
+"set PGHOST=localhost\n"
+"set PGUSER=postgres\n"
+"set PGPASSWORD=yourpasswordhere\n"
+"set PGDATABASE=geocoder\n"
+"set PSQL=\"%PGBIN%psql\"\n"
+"set SHP2PGSQL=\"%PGBIN%shp2pgsql\"\n"
+"\n"
+"%WGETTOOL% http://www2.census.gov/geo/pvs/tiger2010st/44_Rhode_Island/ --no-"
+"parent --relative --recursive --level=2 --accept=zip,txt --mirror --"
+"reject=html\n"
+":\n"
+":"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:522
+#, no-c-format
+msgid ""
+"SELECT loader_generate_script(ARRAY['MA','RI'], 'sh') AS result;\n"
+"-- result --\n"
+"STATEDIR=\"/gisdata/www2.census.gov/geo/pvs/tiger2010st/44_Rhode_Island\" \n"
+"TMPDIR=\"/gisdata/temp/\"\n"
+"UNZIPTOOL=unzip\n"
+"PGPORT=5432\n"
+"PGHOST=localhost\n"
+"PGUSER=postgres\n"
+"PGPASSWORD=yourpasswordhere\n"
+"PGDATABASE=geocoder\n"
+"PSQL=psql\n"
+"SHP2PGSQ=shp2pgsql\n"
+"\n"
+"wget http://www2.census.gov/geo/pvs/tiger2010st/44_Rhode_Island/ --no-parent "
+"--relative --recursive --level=2 --accept=zip,txt --mirror --reject=html\n"
+":\n"
+":"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:535
+#, no-c-format
+msgid "Loader_Generate_Nation_Script"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:537
+#, no-c-format
+msgid ""
+"Generates a shell script for the specified platform that loads in the county "
+"and state lookup tables."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:542
+#, no-c-format
+msgid ""
+"<funcdef>text <function>loader_generate_nation_script</function></funcdef> "
+"<paramdef><type>text</type> <parameter>os</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:552
+#, no-c-format
+msgid ""
+"Generates a shell script for the specified platform that loads in the "
+"<varname>county_all</varname>, <varname>county_all_lookup</varname>, "
+"<varname>state_all</varname> tables into <varname>tiger_data</varname> "
+"schema. These inherit respectively from the <varname>county</varname>, "
+"<varname>county_lookup</varname>, <varname>state</varname> tables in "
+"<varname>tiger</varname> schema."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:553
+#, no-c-format
+msgid ""
+"It uses unzip on Linux (7-zip on Windows by default) and wget to do the "
+"downloading. It uses <xref linkend=\"shp2pgsql_usage\"/> to load in the data."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:554
+#, no-c-format
+msgid ""
+"It uses the following control tables <varname>tiger.loader_platform</"
+"varname>, <varname>tiger.loader_variables</varname>, and <varname>tiger."
+"loader_lookuptables</varname> to control the process and different OS shell "
+"syntax variations."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:561
+#, no-c-format
+msgid ""
+"<varname>loader_platform</varname> profiles of various platforms and where "
+"the various executables are located. Comes with windows and linux/unix. More "
+"can be added."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:568
+#, no-c-format
+msgid ""
+"If you were running <varname>tiger_2010</varname> version and you want to "
+"reload as state with <varname>tiger_2011</varname>, you'll need to for the "
+"very first load generate and run drop statements <xref linkend="
+"\"Drop_Nation_Tables_Generate_Script\"/> before you run this script."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:574
+#, no-c-format
+msgid "Generate script script to load nation data Windows."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:575
+#, no-c-format
+msgid "SELECT loader_generate_nation_script('windows');"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:576
+#, no-c-format
+msgid "Generate script to load up data for Linux/Unix systems."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:577
+#, no-c-format
+msgid "SELECT loader_generate_nation_script('sh');"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:589
+#, no-c-format
+msgid "Missing_Indexes_Generate_Script"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:591
+#, no-c-format
+msgid ""
+"Finds all tables with key columns used in geocoder joins that are missing "
+"indexes on those columns and will output the SQL DDL to define the index for "
+"those tables."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:597
+#, no-c-format
+msgid ""
+"<funcdef>text <function>Missing_Indexes_Generate_Script</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:607
+#, no-c-format
+msgid ""
+"Finds all tables in <varname>tiger</varname> and <varname>tiger_data</"
+"varname> schemas with key columns used in geocoder joins that are missing "
+"indexes on those columns and will output the SQL DDL to define the index for "
+"those tables. This is a helper function that adds new indexes needed to make "
+"queries faster that may have been missing during the load process. As the "
+"geocoder is improved, this function will be updated to accommodate new "
+"indexes being used. If this function outputs nothing, it means all your "
+"tables have what we think are the key indexes already in place."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:621
+#, no-c-format
+msgid ""
+"SELECT missing_indexes_generate_script();\n"
+"-- output: This was run on a database that was created before many "
+"corrections were made to the loading script ---\n"
+"CREATE INDEX idx_tiger_county_countyfp ON tiger.county USING "
+"btree(countyfp);\n"
+"CREATE INDEX idx_tiger_cousub_countyfp ON tiger.cousub USING "
+"btree(countyfp);\n"
+"CREATE INDEX idx_tiger_edges_tfidr ON tiger.edges USING btree(tfidr);\n"
+"CREATE INDEX idx_tiger_edges_tfidl ON tiger.edges USING btree(tfidl);\n"
+"CREATE INDEX idx_tiger_zip_lookup_all_zip ON tiger.zip_lookup_all USING "
+"btree(zip);\n"
+"CREATE INDEX idx_tiger_data_ma_county_countyfp ON tiger_data.ma_county USING "
+"btree(countyfp);\n"
+"CREATE INDEX idx_tiger_data_ma_cousub_countyfp ON tiger_data.ma_cousub USING "
+"btree(countyfp);\n"
+"CREATE INDEX idx_tiger_data_ma_edges_countyfp ON tiger_data.ma_edges USING "
+"btree(countyfp);\n"
+"CREATE INDEX idx_tiger_data_ma_faces_countyfp ON tiger_data.ma_faces USING "
+"btree(countyfp);"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:628
+#, no-c-format
+msgid ", <xref linkend=\"Install_Missing_Indexes\"/>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:634
+#, no-c-format
+msgid "Normalize_Address"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:636
+#, no-c-format
+msgid ""
+"Given a textual street address, returns a composite <varname>norm_addy</"
+"varname> type that has road suffix, prefix and type standardized, street, "
+"streetname etc. broken into separate fields. This function will work with "
+"just the lookup data packaged with the tiger_geocoder (no need for tiger "
+"census data)."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:642
+#, no-c-format
+msgid ""
+"<funcdef>norm_addy <function>normalize_address</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>in_address</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:652
+#, no-c-format
+msgid ""
+"Given a textual street address, returns a composite <varname>norm_addy</"
+"varname> type that has road suffix, prefix and type standardized, street, "
+"streetname etc. broken into separate fields. This is the first step in the "
+"geocoding process to get all addresses into normalized postal form. No other "
+"data is required aside from what is packaged with the geocoder."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:654
+#, no-c-format
+msgid ""
+"This function just uses the various direction/state/suffix lookup tables "
+"preloaded with the tiger_geocoder and located in the <varname>tiger</"
+"varname> schema, so it doesn't need you to download tiger census data or any "
+"other additional data to make use of it. You may find the need to add more "
+"abbreviations or alternative namings to the various lookup tables in the "
+"<varname>tiger</varname> schema."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:656
+#, no-c-format
+msgid ""
+"It uses various control lookup tables located in <varname>tiger</varname> "
+"schema to normalize the input address."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:657
+#, no-c-format
+msgid ""
+"Fields in the <varname>norm_addy</varname> type object returned by this "
+"function in this order where () indicates a field required by the geocoder, "
+"[] indicates an optional field:"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:658
+#, no-c-format
+msgid ""
+"(address) [predirAbbrev] (streetName) [streetTypeAbbrev] [postdirAbbrev] "
+"[internal] [location] [stateAbbrev] [zip]"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:661
+#, no-c-format
+msgid "<varname>address</varname> is an integer: The street number"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:664
+#, no-c-format
+msgid ""
+"<varname>predirAbbrev</varname> is varchar: Directional prefix of road such "
+"as N, S, E, W etc. These are controlled using the <varname>direction_lookup</"
+"varname> table."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:667
+#, no-c-format
+msgid "<varname>streetName</varname> varchar"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:670
+#, no-c-format
+msgid ""
+"<varname>streetTypeAbbrev</varname> varchar abbreviated version of street "
+"type: e.g. St, Ave, Cir. These are controlled using the "
+"<varname>street_type_lookup</varname> table."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:673
+#, no-c-format
+msgid ""
+"<varname>postdirAbbrev</varname> varchar abbreviated directional suffice of "
+"road N, S, E, W etc. These are controlled using the "
+"<varname>direction_lookup</varname> table."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:676
+#, no-c-format
+msgid ""
+"<varname>internal</varname> varchar internal address such as an apartment or "
+"suite number."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:679
+#, no-c-format
+msgid ""
+"<varname>location</varname> varchar usually a city or governing province."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:682
+#, no-c-format
+msgid ""
+"<varname>stateAbbrev</varname> varchar two character US State. e.g MA, NY, "
+"MI. These are controlled by the <varname>state_lookup</varname> table."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:685
+#, no-c-format
+msgid "<varname>zip</varname> varchar 5-digit zipcode. e.g. 02109."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:688
+#, no-c-format
+msgid ""
+"<varname>parsed</varname> boolean - denotes if addess was formed from "
+"normalize process. The normalize_address function sets this to true before "
+"returning the address."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:697
+#, no-c-format
+msgid ""
+"Output select fields. Use <xref linkend=\"Pprint_Addy\"/> if you want a "
+"pretty textual output."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:698
+#, no-c-format
+msgid ""
+"SELECT address As orig, (g.na).streetname, (g.na).streettypeabbrev\n"
+" FROM (SELECT address, normalize_address(address) As na\n"
+" FROM addresses_to_geocode) As g;\n"
+" \n"
+" orig | streetname | "
+"streettypeabbrev \n"
+"-----------------------------------------------------+---------------"
+"+------------------\n"
+" 28 Capen Street, Medford, MA | Capen | St\n"
+" 124 Mount Auburn St, Cambridge, Massachusetts 02138 | Mount Auburn | St\n"
+" 950 Main Street, Worcester, MA 01610 | Main | St\n"
+" 529 Main Street, Boston MA, 02129 | Main | St\n"
+" 77 Massachusetts Avenue, Cambridge, MA 02139 | Massachusetts | Ave\n"
+" 25 Wizard of Oz, Walaford, KS 99912323 | Wizard of Oz |"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:707
+#, no-c-format
+msgid ", <xref linkend=\"Pprint_Addy\"/>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:713
+#, no-c-format
+msgid "Pprint_Addy"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:715
+#, no-c-format
+msgid ""
+"Given a <varname>norm_addy</varname> composite type object, returns a pretty "
+"print representation of it. Usually used in conjunction with "
+"normalize_address."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:720
+#, no-c-format
+msgid ""
+"<funcdef>varchar <function>pprint_addy</function></funcdef> "
+"<paramdef><type>norm_addy </type> <parameter>in_addy</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:730
+#, no-c-format
+msgid ""
+"Given a <varname>norm_addy</varname> composite type object, returns a pretty "
+"print representation of it. No other data is required aside from what is "
+"packaged with the geocoder."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:731
+#, no-c-format
+msgid "Usually used in conjunction with <xref linkend=\"Normalize_Address\"/>."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:739
+#, no-c-format
+msgid "Pretty print a single address"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:740
+#, no-c-format
+msgid ""
+"SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, "
+"Nevada 89101')) As pretty_address;\n"
+" pretty_address\n"
+"---------------------------------------\n"
+" 202 E Fremont St, Las Vegas, NV 89101"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:742
+#, no-c-format
+msgid "Pretty print address a table of addresses"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:743
+#, no-c-format
+msgid ""
+"SELECT address As orig, pprint_addy(normalize_address(address)) As "
+"pretty_address\n"
+" FROM addresses_to_geocode;\n"
+" \n"
+" orig | "
+"pretty_address\n"
+"-----------------------------------------------------"
+"+-------------------------------------------\n"
+" 529 Main Street, Boston MA, 02129 | 529 Main St, Boston "
+"MA, 02129\n"
+" 77 Massachusetts Avenue, Cambridge, MA 02139 | 77 Massachusetts Ave, "
+"Cambridge, MA 02139\n"
+" 28 Capen Street, Medford, MA | 28 Capen St, Medford, "
+"MA\n"
+" 124 Mount Auburn St, Cambridge, Massachusetts 02138 | 124 Mount Auburn St, "
+"Cambridge, MA 02138\n"
+" 950 Main Street, Worcester, MA 01610 | 950 Main St, "
+"Worcester, MA 01610"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:756
+#, no-c-format
+msgid "Reverse_Geocode"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:758
+#, no-c-format
+msgid ""
+"Takes a geometry point in a known spatial ref sys and returns a record "
+"containing an array of theoretically possible addresses and an array of "
+"cross streets. If include_strnum_range = true, includes the street range in "
+"the cross streets."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:763
+#, no-c-format
+msgid ""
+"<funcdef>record <function>Reverse_Geocode</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>pt</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>include_strnum_range=false</parameter></paramdef> "
+"<paramdef><type>geometry[] </type> <parameter>OUT intpt</parameter></"
+"paramdef> <paramdef><type>norm_addy[] </type> <parameter>OUT addy</"
+"parameter></paramdef> <paramdef><type>varchar[] </type> <parameter>OUT "
+"street</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:777
+#, no-c-format
+msgid ""
+"Takes a geometry point in a known spatial ref and returns a record "
+"containing an array of theoretically possible addresses and an array of "
+"cross streets. If include_strnum_range = true, includes the street range in "
+"the cross streets. include_strnum_range defaults to false if not passed in. "
+"Addresses are sorted according to which road a point is closest to so first "
+"address is most likely the right one."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:780
+#, no-c-format
+msgid ""
+"Why do we say theoretical instead of actual addresses. The Tiger data "
+"doesn't have real addresses, but just street ranges. As such the theoretical "
+"address is an interpolated address based on the street ranges. Like for "
+"example interpolating one of my addresses returns a 26 Court St. and 26 "
+"Court Sq., though there is no such place as 26 Court Sq. This is because a "
+"point may be at a corner of 2 streets and thus the logic interpolates along "
+"both streets. The logic also assumes addresses are equally spaced along a "
+"street, which of course is wrong since you can have a municipal building "
+"taking up a good chunk of the street range and the rest of the buildings are "
+"clustered at the end."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:785
+#, no-c-format
+msgid ""
+"Note: Hmm this function relies on Tiger data. If you have not loaded data "
+"covering the region of this point, then hmm you will get a record filled "
+"with NULLS."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:786
+#, no-c-format
+msgid "Returned elements of the record are as follows:"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:789
+#, no-c-format
+msgid ""
+"<varname>intpt</varname> is an array of points: These are the center line "
+"points on the street closest to the input point. There are as many points as "
+"there are addresses."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:792
+#, no-c-format
+msgid ""
+"<varname>addy</varname> is an array of norm_addy (normalized addresses): "
+"These are an array of possible addresses that fit the input point. The first "
+"one in the array is most likely. Generally there should be only one, except "
+"in the case when a point is at the corner of 2 or 3 streets, or the point is "
+"somewhere on the road and not off to the side."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:796
+#, no-c-format
+msgid ""
+"<varname>street</varname> an array of varchar: These are cross streets (or "
+"the street) (streets that intersect or are the street the point is projected "
+"to be on)."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:807
+#, no-c-format
+msgid ""
+"Example of a point at the corner of two streets, but closest to one. This is "
+"approximate location of MIT: 77 Massachusetts Ave, Cambridge, MA 02139 Note "
+"that although we don't have 3 streets, PostgreSQL will just return null for "
+"entries above our upper bound so safe to use. This includes street ranges"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:809
+#, no-c-format
+msgid ""
+"SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, "
+"pprint_addy(r.addy[3]) As st3, \n"
+" array_to_string(r.street, ',') As cross_streets \n"
+" FROM reverse_geocode(ST_GeomFromText('POINT(-71.093902 "
+"42.359446)',4269),true) As r;\n"
+" \n"
+" result\n"
+" ------\n"
+" st1 | st2 | st3 | "
+"cross_streets\n"
+"-------------------------------------------+-----+-----"
+"+----------------------------------------------\n"
+" 67 Massachusetts Ave, Cambridge, MA 02139 | | | 67 - 127 "
+"Massachusetts Ave,32 - 88 Vassar St"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:811
+#, no-c-format
+msgid ""
+"Here we choose not to include the address ranges for the cross streets and "
+"picked a location really really close to a corner of 2 streets thus could be "
+"known by two different addresses."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:813
+#, no-c-format
+msgid ""
+"SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, \n"
+"pprint_addy(r.addy[3]) As st3, array_to_string(r.street, ',') As cross_str\n"
+"FROM reverse_geocode(ST_GeomFromText('POINT(-71.06941 42.34225)',4269)) As "
+"r;\n"
+"\n"
+"result\n"
+"--------\n"
+" st1 | st2 | st3 | "
+"cross_str\n"
+"---------------------------------+---------------------------------+-----"
+"+------------------------\n"
+" 5 Bradford St, Boston, MA 02118 | 49 Waltham St, Boston, MA 02118 | | "
+"Waltham St"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:815
+#, no-c-format
+msgid ""
+"For this one we reuse our geocoded example from <xref linkend=\"Geocode\"/> "
+"and we only want the primary address and at most 2 cross streets."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:816
+#, no-c-format
+msgid ""
+"SELECT actual_addr, lon, lat, pprint_addy((rg).addy[1]) As int_addr1, \n"
+" (rg).street[1] As cross1, (rg).street[2] As cross2\n"
+"FROM (SELECT address As actual_addr, lon, lat,\n"
+" reverse_geocode( ST_SetSRID(ST_Point(lon,lat),4326) ) As rg\n"
+" FROM addresses_to_geocode WHERE rating > -1) As foo;\n"
+"\n"
+" actual_addr | lon | lat "
+"| int_addr1 | cross1 | cross2 \n"
+"-----------------------------------------------------+-----------+----------"
+"+-------------------------------------------+-----------------+------------\n"
+" 529 Main Street, Boston MA, 02129 | -71.07181 | 42.38359 "
+"| 527 Main St, Boston, MA 02129 | Medford St | \n"
+" 77 Massachusetts Avenue, Cambridge, MA 02139 | -71.09428 | 42.35988 "
+"| 77 Massachusetts Ave, Cambridge, MA 02139 | Vassar St | \n"
+" 26 Capen Street, Medford, MA | -71.12377 | 42.41101 "
+"| 9 Edison Ave, Medford, MA 02155 | Capen St | Tesla Ave\n"
+" 124 Mount Auburn St, Cambridge, Massachusetts 02138 | -71.12304 | 42.37328 "
+"| 3 University Rd, Cambridge, MA 02138 | Mount Auburn St | \n"
+" 950 Main Street, Worcester, MA 01610 | -71.82368 | 42.24956 "
+"| 3 Maywood St, Worcester, MA 01603 | Main St | Maywood Pl"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:823
+#, no-c-format
+msgid ", <xref linkend=\"Geocode\"/>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:829
+#, no-c-format
+msgid "Topology_Load_Tiger"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:831
+#, no-c-format
+msgid ""
+"Loads a defined region of tiger data into a PostGIS Topology and "
+"transforming the tiger data to spatial reference of the topology and "
+"snapping to the precision tolerance of the topology."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:837
+#, no-c-format
+msgid ""
+"<funcdef>text <function>Topology_Load_Tiger</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>topo_name</parameter></paramdef> "
+"<paramdef><type>varchar </type> <parameter>region_type</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>region_id</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:849
+#, no-c-format
+msgid ""
+"Loads a defined region of tiger data into a PostGIS Topology. The faces, "
+"nodes and edges are transformed to the spatial reference system of the "
+"target topology and points are snapped to the tolerance of the target "
+"topology. The created faces, nodes, edges maintain the same ids as the "
+"original Tiger data faces, nodes, edges so that datasets can be in the "
+"future be more easily reconciled with tiger data. Returns summary details "
+"about the process."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:852
+#, no-c-format
+msgid ""
+"This would be useful for example for redistricting data where you require "
+"the newly formed polygons to follow the center lines of streets and for the "
+"resulting polygons not to overlap."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:854
+#, no-c-format
+msgid ""
+"This function relies on Tiger data as well as the installation of the "
+"PostGIS topology module. For more information, refer to <xref linkend="
+"\"Topology\"/> and <xref linkend=\"installation_configuration\"/>. If you "
+"have not loaded data covering the region of interest, then no topology "
+"records will be created. This function will also fail if you have not "
+"created a topology using the topology functions."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:856
+#, no-c-format
+msgid ""
+"Most topology validation errors are a result of tolerance issues where after "
+"transformation the edges points don't quite line up or overlap. To remedy "
+"the situation you may want to increase or lower the precision if you get "
+"topology validation failures."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:858
+#, no-c-format
+msgid "Required arguments:"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:861
+#, no-c-format
+msgid ""
+"<varname>topo_name</varname> The name of an existing PostGIS topology to "
+"load data into."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:864
+#, no-c-format
+msgid ""
+"<varname>region_type</varname> The type of bounding region. Currently only "
+"<varname>place</varname> and <varname>county</varname> are supported. Plan "
+"is to have several more. This is the table to look into to define the region "
+"bounds. e.g <varname>tiger.place</varname>, <varname>tiger.county</varname>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:867
+#, no-c-format
+msgid ""
+"<varname>region_id</varname> This is what TIGER calls the geoid. It is the "
+"unique identifier of the region in the table. For place it is the "
+"<varname>plcidfp</varname> column in <varname>tiger.place</varname>. For "
+"county it is the <varname>cntyidfp</varname> column in <varname>tiger."
+"county</varname>"
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:876
+#, no-c-format
+msgid "Example: Boston, Massachusetts Topology"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:877
+#, no-c-format
+msgid ""
+"Create a topology for Boston, Massachusetts in Mass State Plane Feet (2249) "
+"with tolerance 0.25 feet and then load in Boston city tiger faces, edges, "
+"nodes."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:879
+#, no-c-format
+msgid ""
+"SELECT topology.CreateTopology('topo_boston', 2249, 0.25);\n"
+"createtopology\n"
+"--------------\n"
+" 15\n"
+"-- 60,902 ms ~ 1 minute on windows 7 desktop running 9.1 (with 5 states "
+"tiger data loaded) \n"
+"SELECT tiger.topology_load_tiger('topo_boston', 'place', '2507000'); \n"
+"-- topology_loader_tiger --\n"
+"29722 edges holding in temporary. 11108 faces added. 1875 edges of faces "
+"added. 20576 nodes added. \n"
+"19962 nodes contained in a face. 0 edge start end corrected. 31597 edges "
+"added. \n"
+" \n"
+"-- 41 ms --\n"
+"SELECT topology.TopologySummary('topo_boston');\n"
+" -- topologysummary--\n"
+"Topology topo_boston (15), SRID 2249, precision 0.25\n"
+"20576 nodes, 31597 edges, 11109 faces, 0 topogeoms in 0 layers\n"
+"\n"
+"-- 28,797 ms to validate yeh returned no errors --\n"
+"SELECT * FROM \n"
+" topology.ValidateTopology('topo_boston'); \n"
+" \n"
+" error | id1 | id2\n"
+"-------------------+----------+-----------"
+msgstr ""
+
+#. Tag: title
+#: extras_tigergeocoder.xml:883
+#, no-c-format
+msgid "Example: Suffolk, Massachusetts Topology"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:884
+#, no-c-format
+msgid ""
+"Create a topology for Suffolk, Massachusetts in Mass State Plane Meters "
+"(26986) with tolerance 0.25 meters and then load in Suffolk county tiger "
+"faces, edges, nodes."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:886
+#, no-c-format
+msgid ""
+"SELECT topology.CreateTopology('topo_suffolk', 26986, 0.25);\n"
+"-- this took 56,275 ms ~ 1 minute on Windows 7 32-bit with 5 states of tiger "
+"loaded\n"
+"-- must have been warmed up after loading boston\n"
+"SELECT tiger.topology_load_tiger('topo_suffolk', 'county', '25025'); \n"
+"-- topology_loader_tiger --\n"
+" 36003 edges holding in temporary. 13518 faces added. 2172 edges of faces "
+"added. \n"
+" 24761 nodes added. 24075 nodes contained in a face. 0 edge start end "
+"corrected. 38175 edges added. \n"
+"-- 31 ms --\n"
+"SELECT topology.TopologySummary('topo_suffolk');\n"
+" -- topologysummary--\n"
+" Topology topo_suffolk (14), SRID 26986, precision 0.25\n"
+"24761 nodes, 38175 edges, 13519 faces, 0 topogeoms in 0 layers\n"
+"\n"
+"-- 33,606 ms to validate --\n"
+"SELECT * FROM \n"
+" topology.ValidateTopology('topo_suffolk'); \n"
+" \n"
+" error | id1 | id2\n"
+"-------------------+----------+-----------\n"
+" coincident nodes | 81045651 | 81064553\n"
+" edge crosses node | 81045651 | 85737793\n"
+" edge crosses node | 81045651 | 85742215\n"
+" edge crosses node | 81045651 | 620628939\n"
+" edge crosses node | 81064553 | 85697815\n"
+" edge crosses node | 81064553 | 85728168\n"
+" edge crosses node | 81064553 | 85733413"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:890
+#, no-c-format
+msgid ""
+", <xref linkend=\"CreateTopoGeom\"/>, <xref linkend=\"TopologySummary\"/>, "
+"<xref linkend=\"ValidateTopology\"/>"
+msgstr ""
+
+#. Tag: refname
+#: extras_tigergeocoder.xml:896
+#, no-c-format
+msgid "Set_Geocode_Setting"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_tigergeocoder.xml:898
+#, no-c-format
+msgid "Sets a setting that affects behavior of geocoder functions."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_tigergeocoder.xml:903
+#, no-c-format
+msgid ""
+"<funcdef>text <function>Set_Geocode_Setting</function></funcdef> "
+"<paramdef><type>text </type> <parameter> setting_name</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter> setting_value</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:914
+#, no-c-format
+msgid ""
+"Sets value of specific setting stored in <varname>tiger.geocode_settings</"
+"varname> table. Settings allow you to toggle debugging of functions. Later "
+"plans will be to control rating with settings. Current list of settings are "
+"listed in <xref linkend=\"Get_Geocode_Setting\"/>."
+msgstr ""
+
+#. Tag: para
+#: extras_tigergeocoder.xml:923
+#, no-c-format
+msgid ""
+"If you run <xref linkend=\"Geocode\"/> when this function is true, the "
+"NOTICE log will output timing and queries."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_tigergeocoder.xml:924
+#, no-c-format
+msgid ""
+"SELECT set_geocode_setting('debug_geocode_address', 'true') As result;\n"
+"result\n"
+"---------\n"
+"true"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# Jakub Bobrowski <jb@5dstudio.pl>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-10-11 21:39+0000\n"
+"PO-Revision-Date: 2014-01-02 21:58+0000\n"
+"Last-Translator: Jakub Bobrowski <jb@5dstudio.pl>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: extras_topology.xml:3
+#, no-c-format
+msgid "Topology"
+msgstr "Topologia"
+
+#. Tag: para
+#: extras_topology.xml:4
+#, no-c-format
+msgid ""
+"The PostGIS Topology types and functions are used to manage topological "
+"objects such as faces, edges and nodes."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:5
+#, no-c-format
+msgid ""
+"Sandro Santilli's presentation at PostGIS Day Paris 2011 conference gives a "
+"good synopsis of PostGIS Topology and where it is headed <ulink url=\"http://"
+"strk.keybit.net/projects/postgis/Paris2011_TopologyWithPostGIS_2_0.pdf"
+"\">Topology with PostGIS 2.0 slide deck</ulink>."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:6
+#, no-c-format
+msgid ""
+"Vincent Picavet provides a good synopsis and overview of what is Topology, "
+"how is it used, and various FOSS4G tools that support it in <ulink url="
+"\"http://2010.foss4g.org/presentations/3555.pdf\">State of the art of FOSS4G "
+"for topology and network analysis</ulink>."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:7
+#, no-c-format
+msgid ""
+"An example of a topologically based GIS database is the <ulink url=\"http://"
+"www.census.gov/geo/www/tiger/overview.html\">US Census Topologically "
+"Integrated Geographic Encoding and Reference System (TIGER)</ulink> "
+"database. If you want to experiment with PostGIS topology and need some "
+"data, check out <xref linkend=\"Topology_Load_Tiger\"/>."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:8
+#, no-c-format
+msgid ""
+"The PostGIS topology module has existed in prior versions of PostGIS but was "
+"never part of the Official PostGIS documentation. In PostGIS 2.0.0 major "
+"cleanup is going on to remove use of all deprecated functions in it, fix "
+"known usability issues, better document the features and functions, add new "
+"functions, and enhance to closer conform to SQL-MM standards."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:10
+#, no-c-format
+msgid ""
+"Details of this project can be found at <ulink url=\"http://trac.osgeo.org/"
+"postgis/wiki/UsersWikiPostgisTopology\">PostGIS Topology Wiki</ulink>"
+msgstr ""
+"Szczegóły tego projektu można znaleźć pod adresem <ulink url=\"http://trac."
+"osgeo.org/postgis/wiki/UsersWikiPostgisTopology\">PostGIS Topology Wiki</"
+"ulink>"
+
+#. Tag: para
+#: extras_topology.xml:11
+#, no-c-format
+msgid ""
+"All functions and tables associated with this module are installed in a "
+"schema called <varname>topology</varname>."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:12
+#, no-c-format
+msgid ""
+"Functions that are defined in SQL/MM standard are prefixed with ST_ and "
+"functions specific to PostGIS are not prefixed."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:13
+#, no-c-format
+msgid ""
+"To build PostGIS 2.0 with topology support, compile with the --with-topology "
+"option as described in <xref linkend=\"postgis_installation\"/>. Some "
+"functions depend on GEOS 3.3+ so you should compile with GEOS 3.3+ to fully "
+"utilize the topology support."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:18
+#, no-c-format
+msgid ""
+"This section lists the PostgreSQL data types installed by PostGIS Topology. "
+"Note we describe the casting behavior of these which is very important "
+"especially when designing your own functions."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:23
+#, no-c-format
+msgid "Topology Types"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:27
+#, no-c-format
+msgid "getfaceedges_returntype"
+msgstr "getfaceedges_returntype"
+
+#. Tag: refpurpose
+#: extras_topology.xml:28
+#, no-c-format
+msgid ""
+"A composite type that consists of a sequence number and edge number. This is "
+"the return type for <varname>ST_GetFaceEdges</varname>"
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:31 extras_topology.xml:50 extras_topology.xml:99
+#: extras_topology.xml:138 extras_topology.xml:159 extras_topology.xml:236
+#: extras_topology.xml:283 extras_topology.xml:324 extras_topology.xml:363
+#: extras_topology.xml:400 extras_topology.xml:470 extras_topology.xml:518
+#: extras_topology.xml:566 extras_topology.xml:610 extras_topology.xml:658
+#: extras_topology.xml:704 extras_topology.xml:750 extras_topology.xml:805
+#: extras_topology.xml:851 extras_topology.xml:898 extras_topology.xml:955
+#: extras_topology.xml:1013 extras_topology.xml:1085 extras_topology.xml:1153
+#: extras_topology.xml:1219 extras_topology.xml:1273 extras_topology.xml:1321
+#: extras_topology.xml:1368 extras_topology.xml:1411 extras_topology.xml:1465
+#: extras_topology.xml:1559 extras_topology.xml:1654 extras_topology.xml:1696
+#: extras_topology.xml:1738 extras_topology.xml:1781 extras_topology.xml:1830
+#: extras_topology.xml:1874 extras_topology.xml:1926 extras_topology.xml:1984
+#: extras_topology.xml:2025 extras_topology.xml:2082 extras_topology.xml:2128
+#: extras_topology.xml:2219 extras_topology.xml:2281 extras_topology.xml:2329
+#: extras_topology.xml:2377 extras_topology.xml:2425 extras_topology.xml:2519
+#, no-c-format
+msgid "Description"
+msgstr "Opis"
+
+#. Tag: para
+#: extras_topology.xml:32
+#, no-c-format
+msgid ""
+"A composite type that consists of a sequence number and edge number. This is "
+"the return type for <varname>ST_GetFaceEdges</varname> function."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:35
+#, no-c-format
+msgid ""
+"<varname>sequence</varname> is an integer: Refers to a topology defined in "
+"the topology.topology table which defines the topology schema and srid."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:38
+#, no-c-format
+msgid "<varname>edge</varname> is an integer: The identifier of an edge."
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:46
+#, no-c-format
+msgid "topogeometry"
+msgstr "topogeometry"
+
+#. Tag: refpurpose
+#: extras_topology.xml:47
+#, no-c-format
+msgid ""
+"A composite type that refers to a topology geometry in a specific topology, "
+"layer, having specific type (1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:"
+"collection) with specific identifier id in the topology. The id uniquely "
+"defines the topogeometry in the topology."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:51
+#, no-c-format
+msgid ""
+"A composite type that refers to a topology geometry in a specific topology, "
+"layer, having specific type with specific id. The elements of a topogeometry "
+"are the properties: topology_id,layer_id,id integer,type integer."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:54
+#, no-c-format
+msgid ""
+"<varname>topology_id</varname> is an integer: Refers to a topology defined "
+"in the topology.topology table which defines the topology schema and srid."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:57
+#, no-c-format
+msgid ""
+"<varname>layer_id</varname> is an integer: The layer_id in the layers table "
+"that hte topogeometry belongs to. The combination of topology_id, layer_id "
+"provides a unique reference in the topology.layers table."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:60
+#, no-c-format
+msgid ""
+"<varname>type</varname> integer between 1 - 4 that defines the geometry "
+"type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:63
+#, no-c-format
+msgid ""
+"<varname>id</varname> is an integer: The id is the autogenerated sequence "
+"number that uniquely defines the topogeometry in the respective topology."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:69
+#, no-c-format
+msgid "Casting Behavior"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:70
+#, no-c-format
+msgid ""
+"This section lists the automatic as well as explicit casts allowed for this "
+"data type"
+msgstr ""
+
+#. Tag: entry
+#: extras_topology.xml:75
+#, no-c-format
+msgid "Cast To"
+msgstr ""
+
+#. Tag: entry
+#: extras_topology.xml:76
+#, no-c-format
+msgid "Behavior"
+msgstr ""
+
+#. Tag: entry
+#: extras_topology.xml:79
+#, no-c-format
+msgid "geometry"
+msgstr "geometry"
+
+#. Tag: entry
+#: extras_topology.xml:80
+#, no-c-format
+msgid "automatic"
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:88 extras_topology.xml:116 extras_topology.xml:148
+#: extras_topology.xml:169 extras_topology.xml:261 extras_topology.xml:301
+#: extras_topology.xml:341 extras_topology.xml:378 extras_topology.xml:419
+#: extras_topology.xml:495 extras_topology.xml:544 extras_topology.xml:583
+#: extras_topology.xml:632 extras_topology.xml:673 extras_topology.xml:719
+#: extras_topology.xml:765 extras_topology.xml:826 extras_topology.xml:873
+#: extras_topology.xml:929 extras_topology.xml:986 extras_topology.xml:1058
+#: extras_topology.xml:1126 extras_topology.xml:1193 extras_topology.xml:1241
+#: extras_topology.xml:1290 extras_topology.xml:1340 extras_topology.xml:1388
+#: extras_topology.xml:1437 extras_topology.xml:1483 extras_topology.xml:1537
+#: extras_topology.xml:1581 extras_topology.xml:1631 extras_topology.xml:1669
+#: extras_topology.xml:1711 extras_topology.xml:1753 extras_topology.xml:1803
+#: extras_topology.xml:1848 extras_topology.xml:1898 extras_topology.xml:1951
+#: extras_topology.xml:2000 extras_topology.xml:2059 extras_topology.xml:2102
+#: extras_topology.xml:2177 extras_topology.xml:2249 extras_topology.xml:2307
+#: extras_topology.xml:2343 extras_topology.xml:2396 extras_topology.xml:2443
+#: extras_topology.xml:2551
+#, no-c-format
+msgid "See Also"
+msgstr "Zobacz także"
+
+#. Tag: refname
+#: extras_topology.xml:95
+#, no-c-format
+msgid "validatetopology_returntype"
+msgstr "validatetopology_returntype"
+
+#. Tag: refpurpose
+#: extras_topology.xml:96
+#, no-c-format
+msgid ""
+"A composite type that consists of an error message and id1 and id2 to denote "
+"location of error. This is the return type for <varname>ValidateTopology</"
+"varname>"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:100
+#, no-c-format
+msgid ""
+"A composite type that consists of an error message and two integers. The "
+"<xref linkend=\"ValidateTopology\"/> function returns a set of these to "
+"denote validation errors and the id1 and id2 to denote the ids of the "
+"topology objects involved in the error."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:103
+#, no-c-format
+msgid "<varname>error</varname> is varchar: Denotes type of error."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:104
+#, no-c-format
+msgid ""
+"Current error descriptors are: coincident nodes, edge crosses node, edge not "
+"simple, edge end node geometry mis-match, edge start node geometry mismatch, "
+"face overlaps face,face within face,"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:107
+#, no-c-format
+msgid ""
+"<varname>id1</varname> is an integer: Denotes identifier of edge / face / "
+"nodes in error."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:110
+#, no-c-format
+msgid ""
+"<varname>id2</varname> is an integer: For errors that involve 2 objects "
+"denotes the secondary edge / or node"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:125
+#, no-c-format
+msgid ""
+"This section lists the PostgreSQL domains installed by PostGIS Topology. "
+"Domains can be used like object types as return objects of functions or "
+"table columns. The distinction between a domain and a type is that a domain "
+"is an existing type with a check constraint bound to it."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:130
+#, no-c-format
+msgid "Topology Domains"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:134
+#, no-c-format
+msgid "TopoElement"
+msgstr "TopoElement"
+
+#. Tag: refpurpose
+#: extras_topology.xml:135
+#, no-c-format
+msgid ""
+"An array of 2 integers generally used to identify a TopoGeometry component."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:139
+#, no-c-format
+msgid ""
+"An array of 2 integers used to represent the id and type of a topology "
+"primitive or the id and layer of a TopoGeometry. Sets of such pairs are used "
+"to define TopoGeometry objects (either simple or hierarchical)."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:142 extras_topology.xml:163 extras_topology.xml:254
+#: extras_topology.xml:294 extras_topology.xml:335 extras_topology.xml:373
+#: extras_topology.xml:413 extras_topology.xml:484 extras_topology.xml:534
+#: extras_topology.xml:577 extras_topology.xml:626 extras_topology.xml:819
+#: extras_topology.xml:866 extras_topology.xml:922 extras_topology.xml:979
+#: extras_topology.xml:1051 extras_topology.xml:1119 extras_topology.xml:1187
+#: extras_topology.xml:1235 extras_topology.xml:1382 extras_topology.xml:1431
+#: extras_topology.xml:1477 extras_topology.xml:1529 extras_topology.xml:1574
+#: extras_topology.xml:1623 extras_topology.xml:1663 extras_topology.xml:1705
+#: extras_topology.xml:1747 extras_topology.xml:1796 extras_topology.xml:1842
+#: extras_topology.xml:2053 extras_topology.xml:2096 extras_topology.xml:2171
+#: extras_topology.xml:2300 extras_topology.xml:2339 extras_topology.xml:2389
+#: extras_topology.xml:2436 extras_topology.xml:2542
+#, no-c-format
+msgid "Examples"
+msgstr "Przykłady"
+
+#. Tag: programlisting
+#: extras_topology.xml:143
+#, no-c-format
+msgid ""
+"SELECT ARRAY[1,2]::topology.topoelement;\n"
+" te\n"
+"-------\n"
+" {1,2}"
+msgstr ""
+"SELECT ARRAY[1,2]::topology.topoelement;\n"
+" te\n"
+"-------\n"
+" {1,2}"
+
+#. Tag: programlisting
+#: extras_topology.xml:144
+#, no-c-format
+msgid ""
+"--Example of what happens when you try to case a 3 element array to "
+"topoelement\n"
+"-- NOTE: topoement has to be a 2 element array so fails dimension check\n"
+"SELECT ARRAY[1,2,3]::topology.topoelement;\n"
+"ERROR: value for domain topology.topoelement violates check constraint "
+"\"dimensions\""
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:155
+#, no-c-format
+msgid "TopoElementArray"
+msgstr "TopoElementArray"
+
+#. Tag: refpurpose
+#: extras_topology.xml:156
+#, no-c-format
+msgid "An array of TopoElement objects"
+msgstr "Tablica obiektów TopoElement"
+
+#. Tag: para
+#: extras_topology.xml:160
+#, no-c-format
+msgid ""
+"An array of 1 or more TopoElement objects, generally used to pass around "
+"components of TopoGeometry objects."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:164
+#, no-c-format
+msgid ""
+"SELECT '{{1,2},{4,3}}'::topology.topoelementarray As tea;\n"
+" tea\n"
+"-------\n"
+"{{1,2},{4,3}}\n"
+"\n"
+"-- more verbose equivalent --\n"
+"SELECT ARRAY[ARRAY[1,2], ARRAY[4,3]]::topology.topoelementarray As tea;\n"
+"\n"
+" tea\n"
+"-------\n"
+"{{1,2},{4,3}}\n"
+"\n"
+"--using the array agg function packaged with topology --\n"
+"SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea\n"
+" FROM generate_series(1,4) As e CROSS JOIN generate_series(1,3) As t;\n"
+" tea\n"
+"--------------------------------------------------------------------------\n"
+"{{1,1},{1,2},{1,3},{2,1},{2,2},{2,3},{3,1},{3,2},{3,3},{4,1},{4,2},{4,3}}"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:165
+#, no-c-format
+msgid ""
+"SELECT '{{1,2,4},{3,4,5}}'::topology.topoelementarray As tea;\n"
+"ERROR: value for domain topology.topoelementarray violates check constraint "
+"\"dimensions\""
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:170
+#, no-c-format
+msgid ""
+", <xref linkend=\"GetTopoGeomElementArray\"/>, <xref linkend="
+"\"TopoElementArray_Agg\"/>"
+msgstr ""
+", <xref linkend=\"GetTopoGeomElementArray\"/>, <xref linkend="
+"\"TopoElementArray_Agg\"/>"
+
+#. Tag: para
+#: extras_topology.xml:182
+#, no-c-format
+msgid ""
+"This section lists the Topology functions for building new Topology schemas, "
+"validating topologies, and managing TopoGeometry Columns"
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:185
+#, no-c-format
+msgid "Topology and TopoGeometry Management"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:188
+#, no-c-format
+msgid "AddTopoGeometryColumn"
+msgstr "AddTopoGeometryColumn"
+
+#. Tag: refpurpose
+#: extras_topology.xml:189
+#, no-c-format
+msgid ""
+"Adds a topogeometry column to an existing table, registers this new column "
+"as a layer in topology.layer and returns the new layer_id."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: extras_topology.xml:193
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>AddTopoGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>topology_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>column_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>feature_type</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AddTopoGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>topology_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>column_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>feature_type</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>child_layer</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>text <function>AddTopoGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>topology_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>column_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>feature_type</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AddTopoGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>topology_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>column_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>feature_type</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>child_layer</parameter></"
+"paramdef> </funcprototype>"
+
+#. Tag: para
+#: extras_topology.xml:238
+#, no-c-format
+msgid ""
+"Each TopoGeometry object belongs to a specific Layer of a specific Topology. "
+"Before creating a TopoGeometry object you need to create its TopologyLayer. "
+"A Topology Layer is an association of a feature-table with the topology. It "
+"also contain type and hierarchy information. We create a layer using the "
+"AddTopoGeometryColumn() function:"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:240
+#, no-c-format
+msgid ""
+"This function will both add the requested column to the table and add a "
+"record to the topology.layer table with all the given info."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:241
+#, no-c-format
+msgid ""
+"If you don't specify [child_layer] (or set it to NULL) this layer would "
+"contain Basic TopoGeometries (composed by primitive topology elements). "
+"Otherwise this layer will contain hierarchical TopoGeometries (composed by "
+"TopoGeometries from the child_layer)."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:244
+#, no-c-format
+msgid ""
+"Once the layer is created (it's id is returned by the AddTopoGeometryColumn "
+"function) you're ready to construct TopoGeometry objects in it"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:245
+#, no-c-format
+msgid ""
+"Valid <varname>feature_type</varname>s are: POINT, LINE, POLYGON, COLLECTION"
+msgstr ""
+"Prawidłowymi <varname>feature_type</varname> są: POINT, LINE, POLYGON, "
+"COLLECTION"
+
+#. Tag: para
+#: extras_topology.xml:248 extras_topology.xml:289 extras_topology.xml:330
+#: extras_topology.xml:406 extras_topology.xml:479 extras_topology.xml:571
+#: extras_topology.xml:813 extras_topology.xml:860 extras_topology.xml:1228
+#: extras_topology.xml:1376 extras_topology.xml:1425 extras_topology.xml:1471
+#: extras_topology.xml:1658 extras_topology.xml:1742 extras_topology.xml:1836
+#: extras_topology.xml:2227 extras_topology.xml:2384 extras_topology.xml:2431
+#, no-c-format
+msgid "Availability: 1.?"
+msgstr "Dostępność: 1.?"
+
+#. Tag: programlisting
+#: extras_topology.xml:255
+#, no-c-format
+msgid ""
+"-- Note for this example we created our new table in the ma_topo schema \n"
+"-- though we could have created it in a different schema -- in which case "
+"topology_name and schema_name would be different \n"
+"CREATE SCHEMA ma;\n"
+"CREATE TABLE ma.parcels(gid serial, parcel_id varchar(20) PRIMARY KEY, "
+"address text);\n"
+"SELECT topology.AddTopoGeometryColumn('ma_topo', 'ma', 'parcels', 'topo', "
+"'POLYGON');"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:256
+#, no-c-format
+msgid ""
+"CREATE SCHEMA ri;\n"
+"CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);\n"
+"SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', "
+"'LINE');"
+msgstr ""
+"CREATE SCHEMA ri;\n"
+"CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);\n"
+"SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', "
+"'LINE');"
+
+#. Tag: para
+#: extras_topology.xml:263
+#, no-c-format
+msgid ", <xref linkend=\"CreateTopoGeom\"/>"
+msgstr ", <xref linkend=\"CreateTopoGeom\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:268
+#, no-c-format
+msgid "DropTopology"
+msgstr "DropTopology"
+
+#. Tag: refpurpose
+#: extras_topology.xml:270
+#, no-c-format
+msgid ""
+"Use with caution: Drops a topology schema and deletes its reference from "
+"topology.topology table and references to tables in that schema from the "
+"geometry_columns table."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:275
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>DropTopology</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>topology_schema_name</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>integer <function>DropTopology</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>topology_schema_name</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:285
+#, no-c-format
+msgid ""
+"Drops a topology schema and deletes its reference from topology.topology "
+"table and references to tables in that schema from the geometry_columns "
+"table. This function should be USED WITH CAUTION, as it could destroy data "
+"you care about. If the schema does not exist, it just removes reference "
+"entries the named schema."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:295
+#, no-c-format
+msgid ""
+"Cascade drops the ma_topo schema and removes all references to it in "
+"topology.topology and geometry_columns."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:296
+#, no-c-format
+msgid "SELECT topology.DropTopology('ma_topo');"
+msgstr "SELECT topology.DropTopology('ma_topo');"
+
+#. Tag: refname
+#: extras_topology.xml:307
+#, no-c-format
+msgid "DropTopoGeometryColumn"
+msgstr "DropTopoGeometryColumn"
+
+#. Tag: refpurpose
+#: extras_topology.xml:309
+#, no-c-format
+msgid ""
+"Drops the topogeometry column from the table named <varname>table_name</"
+"varname> in schema <varname>schema_name</varname> and unregisters the "
+"columns from topology.layer table."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:314
+#, no-c-format
+msgid ""
+"<funcdef>text <function>DropTopoGeometryColumn</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>schema_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>table_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>column_name</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>text <function>DropTopoGeometryColumn</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>schema_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>table_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>column_name</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:326
+#, no-c-format
+msgid ""
+"Drops the topogeometry column from the table named <varname>table_name</"
+"varname> in schema <varname>schema_name</varname> and unregisters the "
+"columns from topology.layer table. Returns summary of drop status. NOTE: it "
+"first sets all values to NULL before dropping to bypass referential "
+"integrity checks."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:336
+#, no-c-format
+msgid ""
+"SELECT topology.DropTopoGeometryColumn('ma_topo', 'parcel_topo', 'topo');"
+msgstr ""
+"SELECT topology.DropTopoGeometryColumn('ma_topo', 'parcel_topo', 'topo');"
+
+#. Tag: refname
+#: extras_topology.xml:348
+#, no-c-format
+msgid "TopologySummary"
+msgstr "TopologySummary"
+
+#. Tag: refpurpose
+#: extras_topology.xml:350
+#, no-c-format
+msgid ""
+"Takes a topology name and provides summary totals of types of objects in "
+"topology"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:355
+#, no-c-format
+msgid ""
+"<funcdef>text <function>TopologySummary</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>topology_schema_name</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>text <function>TopologySummary</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>topology_schema_name</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:365
+#, no-c-format
+msgid ""
+"Takes a topology name and provides summary totals of types of objects in "
+"topology."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:368 extras_topology.xml:529 extras_topology.xml:667
+#: extras_topology.xml:713 extras_topology.xml:759 extras_topology.xml:1700
+#: extras_topology.xml:1995 extras_topology.xml:2048 extras_topology.xml:2166
+#: extras_topology.xml:2334 extras_topology.xml:2537
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr "Dostępność: 2.0.0"
+
+#. Tag: programlisting
+#: extras_topology.xml:374
+#, no-c-format
+msgid ""
+"SELECT topology.topologysummary('city_data');\n"
+" topologysummary \n"
+"--------------------------------------------------------\n"
+" Topology city_data (329), SRID 4326, precision: 0\n"
+" 22 nodes, 24 edges, 10 faces, 29 topogeoms in 5 layers\n"
+" Layer 1, type Polygonal (3), 9 topogeoms\n"
+" Deploy: features.land_parcels.feature\n"
+" Layer 2, type Puntal (1), 8 topogeoms\n"
+" Deploy: features.traffic_signs.feature\n"
+" Layer 3, type Lineal (2), 8 topogeoms\n"
+" Deploy: features.city_streets.feature\n"
+" Layer 4, type Polygonal (3), 3 topogeoms\n"
+" Hierarchy level 1, child layer 1\n"
+" Deploy: features.big_parcels.feature\n"
+" Layer 5, type Puntal (1), 1 topogeoms\n"
+" Hierarchy level 1, child layer 2\n"
+" Deploy: features.big_signs.feature"
+msgstr ""
+"SELECT topology.topologysummary('city_data');\n"
+" topologysummary \n"
+"--------------------------------------------------------\n"
+" Topology city_data (329), SRID 4326, precision: 0\n"
+" 22 nodes, 24 edges, 10 faces, 29 topogeoms in 5 layers\n"
+" Layer 1, type Polygonal (3), 9 topogeoms\n"
+" Deploy: features.land_parcels.feature\n"
+" Layer 2, type Puntal (1), 8 topogeoms\n"
+" Deploy: features.traffic_signs.feature\n"
+" Layer 3, type Lineal (2), 8 topogeoms\n"
+" Deploy: features.city_streets.feature\n"
+" Layer 4, type Polygonal (3), 3 topogeoms\n"
+" Hierarchy level 1, child layer 1\n"
+" Deploy: features.big_parcels.feature\n"
+" Layer 5, type Puntal (1), 1 topogeoms\n"
+" Hierarchy level 1, child layer 2\n"
+" Deploy: features.big_signs.feature"
+
+#. Tag: refname
+#: extras_topology.xml:385
+#, no-c-format
+msgid "ValidateTopology"
+msgstr "ValidateTopology"
+
+#. Tag: refpurpose
+#: extras_topology.xml:387
+#, no-c-format
+msgid ""
+"Returns a set of validatetopology_returntype objects detailing issues with "
+"topology"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:392
+#, no-c-format
+msgid ""
+"<funcdef>setof validatetopology_returntype <function>ValidateTopology</"
+"function></funcdef> <paramdef><type>varchar </type> "
+"<parameter>topology_schema_name</parameter></paramdef>"
+msgstr ""
+"<funcdef>setof validatetopology_returntype <function>ValidateTopology</"
+"function></funcdef> <paramdef><type>varchar </type> "
+"<parameter>topology_schema_name</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:402
+#, no-c-format
+msgid ""
+"Returns a set of <xref linkend=\"validatetopology_returntype\"/> objects "
+"detailing issues with topology. Refer to <xref linkend="
+"\"validatetopology_returntype\"/> for listing of possible errors."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:408
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false "
+"positives that were existent in prior versions."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:414
+#, no-c-format
+msgid ""
+"SELECT * FROM topology.ValidateTopology('ma_topo');\n"
+" error | id1 | id2\n"
+"-------------------+-----+-----\n"
+"face without edges | 0 |"
+msgstr ""
+"SELECT * FROM topology.ValidateTopology('ma_topo');\n"
+" error | id1 | id2\n"
+"-------------------+-----+-----\n"
+"face without edges | 0 |"
+
+#. Tag: para
+#: extras_topology.xml:420
+#, no-c-format
+msgid ", <xref linkend=\"Topology_Load_Tiger\"/>"
+msgstr ", <xref linkend=\"Topology_Load_Tiger\"/>"
+
+#. Tag: para
+#: extras_topology.xml:428
+#, no-c-format
+msgid "This section covers the topology functions for creating new topologies."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:431
+#, no-c-format
+msgid "Topology Constructors"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:435
+#, no-c-format
+msgid "CreateTopology"
+msgstr "CreateTopology"
+
+#. Tag: refpurpose
+#: extras_topology.xml:436
+#, no-c-format
+msgid ""
+"Creates a new topology schema and registers this new schema in the topology."
+"topology table."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: extras_topology.xml:440
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>integer <function>CreateTopology</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>topology_schema_name</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>CreateTopology</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>topology_schema_name</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>integer <function>CreateTopology</"
+"function></funcdef> <paramdef><type>varchar </type> "
+"<parameter>topology_schema_name</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>tolerance</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>CreateTopology</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>topology_schema_name</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>tolerance</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>hasz</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>integer <function>CreateTopology</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>topology_schema_name</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>CreateTopology</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>topology_schema_name</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>integer <function>CreateTopology</"
+"function></funcdef> <paramdef><type>varchar </type> "
+"<parameter>topology_schema_name</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>tolerance</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>CreateTopology</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>topology_schema_name</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>tolerance</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>hasz</parameter></"
+"paramdef> </funcprototype>"
+
+#. Tag: para
+#: extras_topology.xml:472
+#, no-c-format
+msgid ""
+"Creates a new schema with name <varname>topology_name</varname> consisting "
+"of tables (<varname>edge_data</varname>,<varname>face</varname>,"
+"<varname>node</varname>, <varname>relation</varname> and registers this new "
+"topology in the topology.topology table. It returns the id of the topology "
+"in the topology table. The srid is the spatial reference identified as "
+"defined in spatial_ref_sys table for that topology. Topologies must be "
+"uniquely named. The tolerance is measured in the units of the spatial "
+"reference system. If the tolerance is not specified defaults to 0."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:476
+#, no-c-format
+msgid ""
+"This is similar to the SQL/MM <xref linkend=\"ST_InitTopoGeo\"/> but a bit "
+"more functional. <varname>hasz</varname> defaults to false if not specified."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:485
+#, no-c-format
+msgid ""
+"This example creates a new schema called ma_topo that will store edges, "
+"faces, and relations in Massachusetts State Plane meters. The tolerance "
+"represents 1/2 meter since the spatial reference system is a meter based "
+"spatial reference system"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:487
+#, no-c-format
+msgid "SELECT topology.CreateTopology('ma_topo',26986, 0.5);"
+msgstr "SELECT topology.CreateTopology('ma_topo',26986, 0.5);"
+
+#. Tag: para
+#: extras_topology.xml:489
+#, no-c-format
+msgid "Create Rhode Island topology in State Plane ft"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:490
+#, no-c-format
+msgid ""
+"SELECT topology.CreateTopology('ri_topo',3438) As topoid;\n"
+"topoid\n"
+"------\n"
+"2"
+msgstr ""
+"SELECT topology.CreateTopology('ri_topo',3438) As topoid;\n"
+"topoid\n"
+"------\n"
+"2"
+
+#. Tag: para
+#: extras_topology.xml:497
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_InitTopoGeo\"/>, <xref linkend=\"Topology_Load_Tiger\"/>"
+msgstr ""
+", <xref linkend=\"ST_InitTopoGeo\"/>, <xref linkend=\"Topology_Load_Tiger\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:503
+#, no-c-format
+msgid "CopyTopology"
+msgstr "CopyTopology"
+
+#. Tag: refpurpose
+#: extras_topology.xml:504
+#, no-c-format
+msgid ""
+"Makes a copy of a topology structure (nodes, edges, faces, layers and "
+"TopoGeometries)."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:509
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>CopyTopology</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>existing_topology_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> <parameter>new_name</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>CopyTopology</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>existing_topology_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> <parameter>new_name</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:520
+#, no-c-format
+msgid ""
+"Creates a new topology with name <varname>new_topology_name</varname> and "
+"SRID and precision taken from <varname>existing_topology_name</varname>, "
+"copies all nodes, edges and faces in there, copies layers and their "
+"TopoGeometries too."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:524
+#, no-c-format
+msgid ""
+"The new rows in topology.layer will contain synthesized values for "
+"schema_name, table_name and feature_column. This is because the TopoGeometry "
+"will only exist as a definition but won't be available in any user-level "
+"table yet."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:535
+#, no-c-format
+msgid "This example makes a backup of a topology called ma_topo"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:538
+#, no-c-format
+msgid "SELECT topology.CopyTopology('ma_topo', 'ma_topo_bakup');"
+msgstr "SELECT topology.CopyTopology('ma_topo', 'ma_topo_bakup');"
+
+#. Tag: para
+#: extras_topology.xml:546 extras_topology.xml:2060
+#, no-c-format
+msgid ", <xref linkend=\"CreateTopology\"/>"
+msgstr ", <xref linkend=\"CreateTopology\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:552
+#, no-c-format
+msgid "ST_InitTopoGeo"
+msgstr "ST_InitTopoGeo"
+
+#. Tag: refpurpose
+#: extras_topology.xml:553
+#, no-c-format
+msgid ""
+"Creates a new topology schema and registers this new schema in the topology."
+"topology table and details summary of process."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:558
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_InitTopoGeo</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>topology_schema_name</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>text <function>ST_InitTopoGeo</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>topology_schema_name</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:568
+#, no-c-format
+msgid ""
+"This is an SQL-MM equivalent of CreateTopology but lacks the spatial "
+"reference and tolerance options of CreateTopology and outputs a text "
+"description of creation instead of topology id."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:572
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.17"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:578
+#, no-c-format
+msgid ""
+"SELECT topology.ST_InitTopoGeo('topo_schema_to_create') AS topocreation;\n"
+" astopocreation\n"
+"------------------------------------------------------------\n"
+" Topology-Geometry 'topo_schema_to_create' (id:7) created."
+msgstr ""
+"SELECT topology.ST_InitTopoGeo('topo_schema_to_create') AS topocreation;\n"
+" astopocreation\n"
+"------------------------------------------------------------\n"
+" Topology-Geometry 'topo_schema_to_create' (id:7) created."
+
+#. Tag: refname
+#: extras_topology.xml:592
+#, no-c-format
+msgid "ST_CreateTopoGeo"
+msgstr "ST_CreateTopoGeo"
+
+#. Tag: refpurpose
+#: extras_topology.xml:594
+#, no-c-format
+msgid ""
+"<refpurpose>Adds a collection of geometries to a given empty topology and "
+"returns a message detailing success.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:601
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_CreateTopoGeo</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>acollection</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>text <function>ST_CreateTopoGeo</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>acollection</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:612
+#, no-c-format
+msgid ""
+"<para>Adds a collection of geometries to a given empty topology and returns "
+"a message detailing success.</para>"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:616
+#, no-c-format
+msgid "Useful for populating an empty topology."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:620 extras_topology.xml:916 extras_topology.xml:973
+#: extras_topology.xml:1045 extras_topology.xml:1113 extras_topology.xml:1283
+#: extras_topology.xml:1333 extras_topology.xml:1790 extras_topology.xml:1892
+#: extras_topology.xml:1946 extras_topology.xml:2297
+#, no-c-format
+msgid "Availability: 2.0"
+msgstr "Dostępność: 2.0"
+
+#. Tag: para
+#: extras_topology.xml:621
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details -- X.3.18"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:627
+#, no-c-format
+msgid ""
+"-- Populate topology --\n"
+"SELECT topology.ST_CreateTopoGeo('ri_topo', \n"
+" ST_GeomFromText('MULTILINESTRING((384744 236928,384750 236923,384769 "
+"236911,384799 236895,384811 236890,384833 236884,\n"
+" 384844 236882,384866 236881,384879 236883,384954 236898,385087 "
+"236932,385117 236938,\n"
+" 385167 236938,385203 236941,385224 236946,385233 236950,385241 "
+"236956,385254 236971,\n"
+" 385260 236979,385268 236999,385273 237018,385273 237037,385271 "
+"237047,385267 237057,\n"
+" 385225 237125,385210 237144,385192 237161,385167 237192,385162 "
+"237202,385159 237214,\n"
+" 385159 237227,385162 237241,385166 237256,385196 237324,385209 "
+"237345,385234 237375,\n"
+" 385237 237383,385238 237399,385236 237407,385227 237419,385213 "
+"237430,385193 237439,\n"
+" 385174 237451,385170 237455,385169 237460,385171 237475,385181 "
+"237503,385190 237521,\n"
+" 385200 237533,385206 237538,385213 237541,385221 237542,385235 "
+"237540,385242 237541,\n"
+" 385249 237544,385260 237555,385270 237570,385289 237584,385292 "
+"237589,385291 237596,385284 237630))',3438) \n"
+" );\n"
+"\n"
+" st_createtopogeo\n"
+"----------------------------\n"
+" Topology ri_topo populated\n"
+" \n"
+" \n"
+"-- create tables and topo geometries --\n"
+"CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);\n"
+"\n"
+"SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', "
+"'LINE');"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:633
+#, no-c-format
+msgid ", <xref linkend=\"CreateTopology\"/>, <xref linkend=\"DropTopology\"/>"
+msgstr ", <xref linkend=\"CreateTopology\"/>, <xref linkend=\"DropTopology\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:639
+#, no-c-format
+msgid "TopoGeo_AddPoint"
+msgstr "TopoGeo_AddPoint"
+
+#. Tag: refpurpose
+#: extras_topology.xml:641
+#, no-c-format
+msgid ""
+"Adds a point to an existing topology using a tolerance and possibly "
+"splitting an existing edge."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:648
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>TopoGeo_AddPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8 </type> <parameter>tolerance</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>TopoGeo_AddPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8 </type> <parameter>tolerance</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:660
+#, no-c-format
+msgid ""
+"Adds a point to an existing topology and return its identifier. The given "
+"point will snap to existing nodes or edges within given tolerance. An "
+"existing edge may be split by the snapped point."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:674
+#, no-c-format
+msgid ""
+", <xref linkend=\"TopoGeo_AddPolygon\"/>, <xref linkend=\"AddNode\"/>, <xref "
+"linkend=\"CreateTopology\"/>"
+msgstr ""
+", <xref linkend=\"TopoGeo_AddPolygon\"/>, <xref linkend=\"AddNode\"/>, <xref "
+"linkend=\"CreateTopology\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:685
+#, no-c-format
+msgid "TopoGeo_AddLineString"
+msgstr "TopoGeo_AddLineString"
+
+#. Tag: refpurpose
+#: extras_topology.xml:687
+#, no-c-format
+msgid ""
+"Adds a linestring to an existing topology using a tolerance and possibly "
+"splitting existing edges/faces."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:694
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>TopoGeo_AddLineString</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>aline</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8 </type> <parameter>tolerance</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>TopoGeo_AddLineString</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>aline</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8 </type> <parameter>tolerance</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:706
+#, no-c-format
+msgid ""
+"Adds a linestring to an existing topology and return a set of edge "
+"identifiers forming it up. The given line will snap to existing nodes or "
+"edges within given tolerance. Existing edges and faces may be split by the "
+"line."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:720
+#, no-c-format
+msgid ""
+", <xref linkend=\"TopoGeo_AddPolygon\"/>, <xref linkend=\"AddEdge\"/>, <xref "
+"linkend=\"CreateTopology\"/>"
+msgstr ""
+", <xref linkend=\"TopoGeo_AddPolygon\"/>, <xref linkend=\"AddEdge\"/>, <xref "
+"linkend=\"CreateTopology\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:731
+#, no-c-format
+msgid "TopoGeo_AddPolygon"
+msgstr "TopoGeo_AddPolygon"
+
+#. Tag: refpurpose
+#: extras_topology.xml:733
+#, no-c-format
+msgid ""
+"Adds a polygon to an existing topology using a tolerance and possibly "
+"splitting existing edges/faces."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:740
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>TopoGeo_AddPolygon</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>aline</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8 </type> <parameter>atolerance</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>TopoGeo_AddPolygon</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>aline</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8 </type> <parameter>atolerance</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:752
+#, no-c-format
+msgid ""
+"Adds a polygon to an existing topology and return a set of face identifiers "
+"forming it up. The boundary of the given polygon will snap to existing nodes "
+"or edges within given tolerance. Existing edges and faces may be split by "
+"the boundary of the new polygon."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:766
+#, no-c-format
+msgid ""
+", <xref linkend=\"TopoGeo_AddLineString\"/>, <xref linkend=\"AddFace\"/>, "
+"<xref linkend=\"CreateTopology\"/>"
+msgstr ""
+", <xref linkend=\"TopoGeo_AddLineString\"/>, <xref linkend=\"AddFace\"/>, "
+"<xref linkend=\"CreateTopology\"/>"
+
+#. Tag: para
+#: extras_topology.xml:781
+#, no-c-format
+msgid ""
+"This section covers topology functions for adding, moving, deleting, and "
+"splitting edges, faces, and nodes. All of these functions are defined by ISO "
+"SQL/MM."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:784
+#, no-c-format
+msgid "Topology Editors"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:788
+#, no-c-format
+msgid "ST_AddIsoNode"
+msgstr "ST_AddIsoNode"
+
+#. Tag: refpurpose
+#: extras_topology.xml:790
+#, no-c-format
+msgid ""
+"Adds an isolated node to a face in a topology and returns the nodeid of the "
+"new node. If face is null, the node is still created."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:795
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_AddIsoNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>aface</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_AddIsoNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>aface</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:807
+#, no-c-format
+msgid ""
+"Adds an isolated node with point location <varname>apoint</varname> to an "
+"existing face with faceid <varname>aface</varname> to a topology "
+"<varname>atopology</varname> and returns the nodeid of the new node."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:808
+#, no-c-format
+msgid ""
+"If the spatial reference system (srid) of the point geometry is not the same "
+"as the topology, the <varname>apoint</varname> is not a point geometry, the "
+"point is null, or the point intersects an existing edge (even at the "
+"boundaries) then an exception is thrown. If the point already exists as a "
+"node, an exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:810
+#, no-c-format
+msgid ""
+"If <varname>aface</varname> is not null and the <varname>apoint</varname> is "
+"not within the face, then an exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:814
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X+1.3.1"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:827
+#, no-c-format
+msgid ""
+", <xref linkend=\"CreateTopology\"/>, <xref linkend=\"DropTopology\"/>, "
+"<xref linkend=\"ST_Intersects\"/>"
+msgstr ""
+", <xref linkend=\"CreateTopology\"/>, <xref linkend=\"DropTopology\"/>, "
+"<xref linkend=\"ST_Intersects\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:833
+#, no-c-format
+msgid "ST_AddIsoEdge"
+msgstr "ST_AddIsoEdge"
+
+#. Tag: refpurpose
+#: extras_topology.xml:835
+#, no-c-format
+msgid ""
+"<refpurpose>Adds an isolated edge defined by geometry <varname>alinestring</"
+"varname> to a topology connecting two existing isolated nodes "
+"<varname>anode</varname> and <varname>anothernode</varname> and returns the "
+"edge id of the new edge.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:840
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_AddIsoEdge</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anothernode</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>alinestring</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_AddIsoEdge</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anothernode</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>alinestring</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:853
+#, no-c-format
+msgid ""
+"<para>Adds an isolated edge defined by geometry <varname>alinestring</"
+"varname> to a topology connecting two existing isolated nodes "
+"<varname>anode</varname> and <varname>anothernode</varname> and returns the "
+"edge id of the new edge.</para>"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:854
+#, no-c-format
+msgid ""
+"If the spatial reference system (srid) of the <varname>alinestring</varname> "
+"geometry is not the same as the topology, any of the input arguments are "
+"null, or the nodes are contained in more than one face, or the nodes are "
+"start or end nodes of an existing edge, then an exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:856
+#, no-c-format
+msgid ""
+"If the <varname>alinestring</varname> is not within the face of the face the "
+"<varname>anode</varname> and <varname>anothernode</varname> belong to, then "
+"an exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:857
+#, no-c-format
+msgid ""
+"If the <varname>anode</varname> and <varname>anothernode</varname> are not "
+"the start and end points of the <varname>alinestring</varname> then an "
+"exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:861
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.4"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:874
+#, no-c-format
+msgid ", <xref linkend=\"ST_IsSimple\"/>, <xref linkend=\"ST_Within\"/>"
+msgstr ", <xref linkend=\"ST_IsSimple\"/>, <xref linkend=\"ST_Within\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:880
+#, no-c-format
+msgid "ST_AddEdgeNewFaces"
+msgstr "ST_AddEdgeNewFaces"
+
+#. Tag: refpurpose
+#: extras_topology.xml:882
+#, no-c-format
+msgid ""
+"Add a new edge and, if in doing so it splits a face, delete the original "
+"face and replace it with two new faces."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:887
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_AddEdgeNewFaces</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anothernode</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>acurve</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_AddEdgeNewFaces</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anothernode</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>acurve</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:900
+#, no-c-format
+msgid ""
+"Add a new edge and, if in doing so it splits a face, delete the original "
+"face and replace it with two new faces. Returns the id of the newly added "
+"edge."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:906 extras_topology.xml:964 extras_topology.xml:1027
+#: extras_topology.xml:1095
+#, no-c-format
+msgid "Updates all existing joined edges and relationships accordingly."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:910 extras_topology.xml:968
+#, no-c-format
+msgid ""
+"If any arguments are null, the given nodes are unknown (must already exist "
+"in the <varname>node</varname> table of the topology schema) , the "
+"<varname>acurve</varname> is not a <varname>LINESTRING</varname>, the "
+"<varname>anode</varname> and <varname>anothernode</varname> are not the "
+"start and endpoints of <varname>acurve</varname> then an error is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:913 extras_topology.xml:971 extras_topology.xml:1166
+#, no-c-format
+msgid ""
+"If the spatial reference system (srid) of the <varname>acurve</varname> "
+"geometry is not the same as the topology an exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:917
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:937
+#, no-c-format
+msgid "ST_AddEdgeModFace"
+msgstr "ST_AddEdgeModFace"
+
+#. Tag: refpurpose
+#: extras_topology.xml:939
+#, no-c-format
+msgid ""
+"Add a new edge and, if in doing so it splits a face, modify the original "
+"face and add a new face."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:944
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_AddEdgeModFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anothernode</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>acurve</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_AddEdgeModFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anothernode</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>acurve</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:957
+#, no-c-format
+msgid ""
+"Add a new edge and, if in doing so it splits a face, modify the original "
+"face and add a new face. Unless the face being split is the Universal Face, "
+"the new face will be on the right side of the newly added edge. Returns the "
+"id of the newly added edge."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:974
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:994
+#, no-c-format
+msgid "ST_RemEdgeNewFace"
+msgstr "ST_RemEdgeNewFace"
+
+#. Tag: refpurpose
+#: extras_topology.xml:996
+#, no-c-format
+msgid ""
+"<refpurpose>Removes an edge and, if the removed edge separated two faces, "
+"delete the original faces and replace them with a new face.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1004
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_RemEdgeNewFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_RemEdgeNewFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1015
+#, no-c-format
+msgid ""
+"<para>Removes an edge and, if the removed edge separated two faces, delete "
+"the original faces and replace them with a new face.</para>"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1020
+#, no-c-format
+msgid ""
+"Returns the id of a newly created face or NULL, if no new face is created. "
+"No new face is created when the removed edge is dangling or isolated or "
+"confined with the universe face (possibly making the universe flood into the "
+"face on the other side)."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1031 extras_topology.xml:1099
+#, no-c-format
+msgid ""
+"Refuses to remove an edge partecipating in the definition of an existing "
+"TopoGeometry. Refuses to heal two faces if any TopoGeometry is defined by "
+"only one of them (and not the other)."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1038 extras_topology.xml:1106
+#, no-c-format
+msgid ""
+"If any arguments are null, the given edge is unknown (must already exist in "
+"the <varname>edge</varname> table of the topology schema), the topology name "
+"is invalid then an error is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1046
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1066
+#, no-c-format
+msgid "ST_RemEdgeModFace"
+msgstr "ST_RemEdgeModFace"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1068
+#, no-c-format
+msgid ""
+"Removes an edge and, if the removed edge separated two faces, delete one of "
+"the them and modify the other to take the space of both."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1076
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_RemEdgeModFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_RemEdgeModFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1087
+#, no-c-format
+msgid ""
+"Removes an edge and, if the removed edge separated two faces, delete one of "
+"the them and modify the other to take the space of both. Preferentially "
+"keeps the face on the right, to be symmetric with ST_AddEdgeModFace also "
+"keeping it. Returns the id of the face remaining in place of the removed "
+"edge."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1114
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1134
+#, no-c-format
+msgid "ST_ChangeEdgeGeom"
+msgstr "ST_ChangeEdgeGeom"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1136
+#, no-c-format
+msgid ""
+"<refpurpose>Changes the shape of an edge without affecting the topology "
+"structure.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1143
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_ChangeEdgeGeom</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>acurve</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_ChangeEdgeGeom</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>acurve</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1155
+#, no-c-format
+msgid ""
+"<para>Changes the shape of an edge without affecting the topology structure."
+"</para>"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1158
+#, no-c-format
+msgid ""
+"If any arguments are null, the given edge does not exist in the "
+"<varname>node</varname> table of the topology schema, the <varname>acurve</"
+"varname> is not a <varname>LINESTRING</varname>, the <varname>anode</"
+"varname> and <varname>anothernode</varname> are not the start and endpoints "
+"of <varname>acurve</varname> or the modification would change the underlying "
+"topology then an error is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1167
+#, no-c-format
+msgid ""
+"If the new <varname>acurve</varname> is not simple, then an error is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1169
+#, no-c-format
+msgid ""
+"If moving the edge from old to new position would hit an obstacle then an "
+"error is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1175
+#, no-c-format
+msgid "Availability: 1.1.0"
+msgstr "Dostępność: 1.1.0"
+
+#. Tag: para
+#: extras_topology.xml:1178
+#, no-c-format
+msgid "Enhanced: 2.0.0 adds topological consistency enforcement"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1182
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1188
+#, no-c-format
+msgid ""
+"SELECT topology.ST_ChangeEdgeGeom('ma_topo', 1, \n"
+" ST_GeomFromText('LINESTRING(227591.9 893900.4,227622.6 "
+"893844.3,227641.6 893816.6, 227704.5 893778.5)', 26986) );\n"
+" ----\n"
+" Edge 1 changed"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1202
+#, no-c-format
+msgid "ST_ModEdgeSplit"
+msgstr "ST_ModEdgeSplit"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1204
+#, no-c-format
+msgid ""
+"Split an edge by creating a new node along an existing edge, modifying the "
+"original edge and adding a new edge."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1209
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_ModEdgeSplit</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+msgstr ""
+"<funcdef>text <function>ST_ModEdgeSplit</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1221
+#, no-c-format
+msgid ""
+"Split an edge by creating a new node along an existing edge, modifying the "
+"original edge and adding a new edge. Updates all existing joined edges and "
+"relationships accordingly."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1229
+#, no-c-format
+msgid "Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1230 extras_topology.xml:1284 extras_topology.xml:1334
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1236
+#, no-c-format
+msgid ""
+"-- Add an edge --\n"
+" SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227592 "
+"893910, 227600 893910)', 26986) ) As edgeid;\n"
+" \n"
+"-- edgeid-\n"
+"3\n"
+"\n"
+"\n"
+"-- Split the edge --\n"
+"SELECT topology.ST_ModEdgeSplit('ma_topo', 3, "
+"ST_SetSRID(ST_Point(227594,893910),26986) ) As result;\n"
+" result\n"
+"-------------------------\n"
+"7"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1242
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_ModEdgeHeal\"/>, <xref linkend=\"ST_NewEdgeHeal\"/>, "
+"<xref linkend=\"AddEdge\"/>"
+msgstr ""
+", <xref linkend=\"ST_ModEdgeHeal\"/>, <xref linkend=\"ST_NewEdgeHeal\"/>, "
+"<xref linkend=\"AddEdge\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1253
+#, no-c-format
+msgid "ST_ModEdgeHeal"
+msgstr "ST_ModEdgeHeal"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1255
+#, no-c-format
+msgid ""
+"Heal two edges by deleting the node connecting them, modifying the first "
+"edge and deleting the second edge. Returns the id of the deleted node."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1263
+#, no-c-format
+msgid ""
+"<funcdef>int <function>ST_ModEdgeHeal</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anotheredge</parameter></paramdef>"
+msgstr ""
+"<funcdef>int <function>ST_ModEdgeHeal</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anotheredge</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1275
+#, no-c-format
+msgid ""
+"Heal two edges by deleting the node connecting them, modifying the first "
+"edge and deleting the second edge. Returns the id of the deleted node. "
+"Updates all existing joined edges and relationships accordingly."
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1300
+#, no-c-format
+msgid "ST_NewEdgeHeal"
+msgstr "ST_NewEdgeHeal"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1302
+#, no-c-format
+msgid ""
+"Heal two edges by deleting the node connecting them, deleting both edges, "
+"and replacing them with an edge whose direction is the same as the first "
+"edge provided."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1311
+#, no-c-format
+msgid ""
+"<funcdef>int <function>ST_NewEdgeHeal</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anotheredge</parameter></paramdef>"
+msgstr ""
+"<funcdef>int <function>ST_NewEdgeHeal</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anotheredge</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1323
+#, no-c-format
+msgid ""
+"Heal two edges by deleting the node connecting them, deleting both edges, "
+"and replacing them with an edge whose direction is the same as the first "
+"edge provided. Returns the id of the new edge replacing the healed ones. "
+"Updates all existing joined edges and relationships accordingly."
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1351
+#, no-c-format
+msgid "ST_MoveIsoNode"
+msgstr "ST_MoveIsoNode"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1353
+#, no-c-format
+msgid ""
+"Moves an isolated node in a topology from one point to another. If new "
+"<varname>apoint</varname> geometry exists as a node an error is thrown. "
+"REturns description of move."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1358
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_MoveIsoNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+msgstr ""
+"<funcdef>text <function>ST_MoveIsoNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1370
+#, no-c-format
+msgid ""
+"Moves an isolated node in a topology from one point to another. If new "
+"<varname>apoint</varname> geometry exists as a node an error is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1371
+#, no-c-format
+msgid ""
+"If any arguments are null, the <varname>apoint</varname> is not a point, the "
+"existing node is not isolated (is a start or end point of an existing edge), "
+"new node location intersects an existing edge (even at the end points) then "
+"an exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1372
+#, no-c-format
+msgid ""
+"If the spatial reference system (srid) of the point geometry is not the same "
+"as the topology an exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1377
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.2"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1383
+#, no-c-format
+msgid ""
+"-- Add an isolated node with no face --\n"
+"SELECT topology.ST_AddIsoNode('ma_topo', NULL, "
+"ST_GeomFromText('POINT(227579 893916)', 26986) ) As nodeid;\n"
+" nodeid\n"
+"--------\n"
+" 7\n"
+"-- Move the new node --\n"
+"SELECT topology.ST_MoveIsoNode('ma_topo', 7, "
+"ST_GeomFromText('POINT(227579.5 893916.5)', 26986) ) As descrip; \n"
+" descrip\n"
+"----------------------------------------------------\n"
+"Isolated Node 7 moved to location 227579.5,893916.5"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1394
+#, no-c-format
+msgid "ST_NewEdgesSplit"
+msgstr "ST_NewEdgesSplit"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1396
+#, no-c-format
+msgid ""
+"Split an edge by creating a new node along an existing edge, deleting the "
+"original edge and replacing it with two new edges. Returns the id of the new "
+"node created that joins the new edges."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1401
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NewEdgesSplit</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>ST_NewEdgesSplit</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anedge</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1413
+#, no-c-format
+msgid ""
+"Split an edge with edge id <varname>anedge</varname> by creating a new node "
+"with point location <varname>apoint</varname> along current edge, deleting "
+"the original edge and replacing it with two new edges. Returns the id of the "
+"new node created that joins the new edges. Updates all existing joined edges "
+"and relationships accordingly."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1421
+#, no-c-format
+msgid ""
+"If the spatial reference system (srid) of the point geometry is not the same "
+"as the topology, the <varname>apoint</varname> is not a point geometry, the "
+"point is null, the point already exists as a node, the edge does not "
+"correspond to an existing edge or the point is not within the edge then an "
+"exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1426
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.8"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1432
+#, no-c-format
+msgid ""
+"-- Add an edge --\n"
+"SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227575 "
+"893917,227592 893900)', 26986) ) As edgeid;\n"
+"-- result-\n"
+"edgeid\n"
+"------\n"
+" 2\n"
+"-- Split the new edge --\n"
+"SELECT topology.ST_NewEdgesSplit('ma_topo', 2, "
+"ST_GeomFromText('POINT(227578.5 893913.5)', 26986) ) As newnodeid; \n"
+" newnodeid\n"
+"---------\n"
+" 6"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1449
+#, no-c-format
+msgid "ST_RemoveIsoNode"
+msgstr "ST_RemoveIsoNode"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1451
+#, no-c-format
+msgid ""
+"<refpurpose>Removes an isolated node and returns description of action. If "
+"the node is not isolated (is start or end of an edge), then an exception is "
+"thrown.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1456
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_RemoveIsoNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef>"
+msgstr ""
+"<funcdef>text <function>ST_RemoveIsoNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1467
+#, no-c-format
+msgid ""
+"<para>Removes an isolated node and returns description of action. If the "
+"node is not isolated (is start or end of an edge), then an exception is "
+"thrown.</para>"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1472
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1478
+#, no-c-format
+msgid ""
+"-- Add an isolated node with no face --\n"
+"SELECT topology.ST_RemoveIsoNode('ma_topo', 7 ) As result;\n"
+" result\n"
+"-------------------------\n"
+" Isolated node 7 removed"
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:1490
+#, no-c-format
+msgid "Topology Accessors"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1493
+#, no-c-format
+msgid "GetEdgeByPoint"
+msgstr "GetEdgeByPoint"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1495
+#, no-c-format
+msgid "Find the edge-id of an edge that intersects a given point"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1500
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>GetEdgeByPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>tol</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>GetEdgeByPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>tol</parameter></paramdef>"
+
+#. Tag: title
+#: extras_topology.xml:1511
+#, no-c-format
+msgid "Retrieve the id of an edge that intersects a Point"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1513
+#, no-c-format
+msgid ""
+"The function returns an integer (id-edge) given a topology, a POINT and a "
+"tolerance. If tolerance = 0 then the point has to intersect the edge."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1514 extras_topology.xml:1562
+#, no-c-format
+msgid ""
+"If the point is the location of a node, then an exception is thrown. To "
+"avoid this run the GetNodeByPoint function."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1515
+#, no-c-format
+msgid "If the point doesn't intersect an edge, returns 0 (zero)."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1516
+#, no-c-format
+msgid ""
+"If use tolerance > 0 and there is more than one edge near the point then an "
+"exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1521
+#, no-c-format
+msgid ""
+"If tolerance = 0, the function use ST_Intersects otherwise uses ST_DWithin."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1524 extras_topology.xml:1571 extras_topology.xml:1618
+#, no-c-format
+msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0."
+msgstr "Dostępność: 2.0.0 - wymaga GEOS >= 3.3.0."
+
+#. Tag: para
+#: extras_topology.xml:1530 extras_topology.xml:1624
+#, no-c-format
+msgid "These examples use edges we created in <xref linkend=\"AddEdge\"/>"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1531
+#, no-c-format
+msgid ""
+"SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology."
+"GetEdgeByPoint('ma_topo',geom,0) As withnotol\n"
+"FROM ST_GeomFromEWKT('SRID=26986;POINT(227622.6 893843)') As geom;\n"
+" with1mtol | withnotol\n"
+"-----------+-----------\n"
+" 2 | 0"
+msgstr ""
+"SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology."
+"GetEdgeByPoint('ma_topo',geom,0) As withnotol\n"
+"FROM ST_GeomFromEWKT('SRID=26986;POINT(227622.6 893843)') As geom;\n"
+" with1mtol | withnotol\n"
+"-----------+-----------\n"
+" 2 | 0"
+
+#. Tag: programlisting
+#: extras_topology.xml:1532
+#, no-c-format
+msgid ""
+"SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As nearnode\n"
+"FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n"
+"\n"
+"-- get error --\n"
+"ERROR: Two or more edges found"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1539
+#, no-c-format
+msgid ", <xref linkend=\"GetNodeByPoint\"/>"
+msgstr ", <xref linkend=\"GetNodeByPoint\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1545
+#, no-c-format
+msgid "GetFaceByPoint"
+msgstr "GetFaceByPoint"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1546
+#, no-c-format
+msgid "Find the face-id of a face that intersects a given point"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1550
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>GetFaceByPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>tol</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>GetFaceByPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>tol</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1560
+#, no-c-format
+msgid "Retrieve the id of a face that intersects a Point."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1561
+#, no-c-format
+msgid ""
+"The function returns an integer (id-face) given a topology, a POINT and a "
+"tolerance. If tolerance = 0 then the point has to intersect the face."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1563
+#, no-c-format
+msgid "If the point doesn't intersect a face, returns 0 (zero)."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1564
+#, no-c-format
+msgid ""
+"If use tolerance > 0 and there is more than one face near the point then an "
+"exception is thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1568
+#, no-c-format
+msgid ""
+"If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1575
+#, no-c-format
+msgid "These examples use edges faces created in <xref linkend=\"AddFace\"/>"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1576
+#, no-c-format
+msgid ""
+"SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology."
+"GetFaceByPoint('ma_topo',geom,0) As withnotol\n"
+" FROM ST_GeomFromEWKT('POINT(234604.6 899382.0)') As geom;\n"
+" \n"
+" with1mtol | withnotol\n"
+" -----------+-----------\n"
+" 1 | 0"
+msgstr ""
+"SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology."
+"GetFaceByPoint('ma_topo',geom,0) As withnotol\n"
+" FROM ST_GeomFromEWKT('POINT(234604.6 899382.0)') As geom;\n"
+" \n"
+" with1mtol | withnotol\n"
+" -----------+-----------\n"
+" 1 | 0"
+
+#. Tag: programlisting
+#: extras_topology.xml:1577
+#, no-c-format
+msgid ""
+"SELECT topology.GetFaceByPoint('ma_topo',geom, 1) As nearnode\n"
+" FROM ST_GeomFromEWKT('POINT(227591.9 893900.4)') As geom;\n"
+" \n"
+"-- get error --\n"
+"ERROR: Two or more faces found"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1582
+#, no-c-format
+msgid ""
+", <xref linkend=\"GetNodeByPoint\"/>, <xref linkend=\"GetEdgeByPoint\"/>"
+msgstr ""
+", <xref linkend=\"GetNodeByPoint\"/>, <xref linkend=\"GetEdgeByPoint\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1588
+#, no-c-format
+msgid "GetNodeByPoint"
+msgstr "GetNodeByPoint"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1590
+#, no-c-format
+msgid "Find the id of a node at a point location"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1595
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>GetNodeByPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>point</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>tol</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>GetNodeByPoint</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>point</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>tol</parameter></paramdef>"
+
+#. Tag: title
+#: extras_topology.xml:1606
+#, no-c-format
+msgid "Retrieve the id of a node at a point location"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1608
+#, no-c-format
+msgid ""
+"The function return an integer (id-node) given a topology, a POINT and a "
+"tolerance. If tolerance = 0 mean exactly intersection otherwise retrieve the "
+"node from an interval."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1609
+#, no-c-format
+msgid "If there isn't a node at the point, it return 0 (zero)."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1610
+#, no-c-format
+msgid ""
+"If use tolerance > 0 and near the point there are more than one node it "
+"throw an exception."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1615
+#, no-c-format
+msgid ""
+"If tolerance = 0, the function use ST_Intersects otherwise will use "
+"ST_DWithin."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1625
+#, no-c-format
+msgid ""
+"SELECT topology.GetNodeByPoint('ma_topo',geom, 1) As nearnode \n"
+" FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n"
+" nearnode\n"
+"----------\n"
+" 2"
+msgstr ""
+"SELECT topology.GetNodeByPoint('ma_topo',geom, 1) As nearnode \n"
+" FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n"
+" nearnode\n"
+"----------\n"
+" 2"
+
+#. Tag: programlisting
+#: extras_topology.xml:1626
+#, no-c-format
+msgid ""
+"SELECT topology.GetNodeByPoint('ma_topo',geom, 1000) As too_much_tolerance\n"
+" FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n"
+" \n"
+" ----get error--\n"
+" ERROR: Two or more nodes found"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1633
+#, no-c-format
+msgid ", <xref linkend=\"GetEdgeByPoint\"/>"
+msgstr ", <xref linkend=\"GetEdgeByPoint\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1639
+#, no-c-format
+msgid "GetTopologyID"
+msgstr "GetTopologyID"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1641
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the id of a topology in the topology.topology table "
+"given the name of the topology.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1646 extras_topology.xml:1688
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>GetTopologyID</function></funcdef> "
+"<paramdef><type>varchar</type> <parameter>toponame</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>GetTopologyID</function></funcdef> "
+"<paramdef><type>varchar</type> <parameter>toponame</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1656
+#, no-c-format
+msgid ""
+"<para>Returns the id of a topology in the topology.topology table given the "
+"name of the topology.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1664
+#, no-c-format
+msgid ""
+"SELECT topology.GetTopologyID('ma_topo') As topo_id;\n"
+" topo_id\n"
+"---------\n"
+" 1"
+msgstr ""
+"SELECT topology.GetTopologyID('ma_topo') As topo_id;\n"
+" topo_id\n"
+"---------\n"
+" 1"
+
+#. Tag: para
+#: extras_topology.xml:1670
+#, no-c-format
+msgid ""
+", <xref linkend=\"DropTopology\"/>, <xref linkend=\"GetTopologyName\"/>, "
+"<xref linkend=\"GetTopologySRID\"/>"
+msgstr ""
+", <xref linkend=\"DropTopology\"/>, <xref linkend=\"GetTopologyName\"/>, "
+"<xref linkend=\"GetTopologySRID\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1681
+#, no-c-format
+msgid "GetTopologySRID"
+msgstr "GetTopologySRID"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1683
+#, no-c-format
+msgid ""
+"Returns the SRID of a topology in the topology.topology table given the name "
+"of the topology."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1698
+#, no-c-format
+msgid ""
+"Returns the spatial reference id of a topology in the topology.topology "
+"table given the name of the topology."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1706
+#, no-c-format
+msgid ""
+"SELECT topology.GetTopologySRID('ma_topo') As SRID;\n"
+" SRID\n"
+"-------\n"
+" 4326"
+msgstr ""
+"SELECT topology.GetTopologySRID('ma_topo') As SRID;\n"
+" SRID\n"
+"-------\n"
+" 4326"
+
+#. Tag: para
+#: extras_topology.xml:1712
+#, no-c-format
+msgid ""
+", <xref linkend=\"DropTopology\"/>, <xref linkend=\"GetTopologyName\"/>, "
+"<xref linkend=\"GetTopologyID\"/>"
+msgstr ""
+", <xref linkend=\"DropTopology\"/>, <xref linkend=\"GetTopologyName\"/>, "
+"<xref linkend=\"GetTopologyID\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1723
+#, no-c-format
+msgid "GetTopologyName"
+msgstr "GetTopologyName"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1725
+#, no-c-format
+msgid "Returns the name of a topology (schema) given the id of the topology."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1730
+#, no-c-format
+msgid ""
+"<funcdef>varchar <function>GetTopologyName</function></funcdef> "
+"<paramdef><type>integer</type> <parameter>topology_id</parameter></paramdef>"
+msgstr ""
+"<funcdef>varchar <function>GetTopologyName</function></funcdef> "
+"<paramdef><type>integer</type> <parameter>topology_id</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1740
+#, no-c-format
+msgid ""
+"Returns the topology name (schema) of a topology from the topology.topology "
+"table given the topology id of the topology."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1748
+#, no-c-format
+msgid ""
+"SELECT topology.GetTopologyName(1) As topo_name;\n"
+" topo_name\n"
+"-----------\n"
+" ma_topo"
+msgstr ""
+"SELECT topology.GetTopologyName(1) As topo_name;\n"
+" topo_name\n"
+"-----------\n"
+" ma_topo"
+
+#. Tag: para
+#: extras_topology.xml:1754
+#, no-c-format
+msgid ""
+", <xref linkend=\"DropTopology\"/>, <xref linkend=\"GetTopologyID\"/>, <xref "
+"linkend=\"GetTopologySRID\"/>"
+msgstr ""
+", <xref linkend=\"DropTopology\"/>, <xref linkend=\"GetTopologyID\"/>, <xref "
+"linkend=\"GetTopologySRID\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1765
+#, no-c-format
+msgid "ST_GetFaceEdges"
+msgstr "ST_GetFaceEdges"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1767
+#, no-c-format
+msgid ""
+"Returns a set of ordered edges that bound <varname>aface</varname> includes "
+"the sequence order."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1772
+#, no-c-format
+msgid ""
+"<funcdef>getfaceedges_returntype <function>ST_GetFaceEdges</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>atopology</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>aface</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>getfaceedges_returntype <function>ST_GetFaceEdges</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>atopology</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>aface</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1783
+#, no-c-format
+msgid ""
+"Returns a set of ordered edges that bound <varname>aface</varname> includes "
+"the sequence order. Each output consists of a sequence and edgeid. Sequence "
+"numbers start with value 1."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1785
+#, no-c-format
+msgid ""
+"Enumeration of each ring edges start from the edge with smallest identifier."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1791
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1797
+#, no-c-format
+msgid ""
+"-- Returns the edges bounding face 1\n"
+"SELECT (topology.ST_GetFaceEdges('tt', 1)).*;\n"
+"-- result --\n"
+" sequence | edge\n"
+"----------+------\n"
+" 1 | -4\n"
+" 2 | 5\n"
+" 3 | 7\n"
+" 4 | -6\n"
+" 5 | 1\n"
+" 6 | 2\n"
+" 7 | 3\n"
+"(7 rows)"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1798
+#, no-c-format
+msgid ""
+"-- Returns the sequenc, edge id\n"
+"-- , and geometry of the edges that bound face 1\n"
+"-- If you just need geom and seq, can use ST_GetFaceGeometry\n"
+"SELECT t.seq, t.edge, geom\n"
+"FROM topology.ST_GetFaceEdges('tt',1) As t(seq,edge)\n"
+" INNER JOIN tt.edge AS e ON abs(t.edge) = e.edge_id;"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1804
+#, no-c-format
+msgid ", <xref linkend=\"AddFace\"/>, <xref linkend=\"ST_GetFaceGeometry\"/>"
+msgstr ", <xref linkend=\"AddFace\"/>, <xref linkend=\"ST_GetFaceGeometry\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1814
+#, no-c-format
+msgid "ST_GetFaceGeometry"
+msgstr "ST_GetFaceGeometry"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1816
+#, no-c-format
+msgid "Returns the polygon in the given topology with the specified face id."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1821
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_GetFaceGeometry</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>aface</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_GetFaceGeometry</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>aface</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1832
+#, no-c-format
+msgid ""
+"Returns the polygon in the given topology with the specified face id. Builds "
+"the polygon from the edges making up the face."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1837
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:1843
+#, no-c-format
+msgid ""
+"-- Returns the wkt of the polygon added with AddFace\n"
+"SELECT ST_AsText(topology.ST_GetFaceGeometry('ma_topo', 1)) As facegeomwkt;\n"
+"-- result --\n"
+" facegeomwkt\n"
+"\n"
+"--------------------------------------------------------------------------------\n"
+" POLYGON((234776.9 899563.7,234896.5 899456.7,234914 899436.4,234946.6 "
+"899356.9,\n"
+"234872.5 899328.7,234891 899285.4,234992.5 899145,234890.6 899069,\n"
+"234755.2 899255.4,234612.7 899379.4,234776.9 899563.7))"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1855
+#, no-c-format
+msgid "GetRingEdges"
+msgstr "GetRingEdges"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1857
+#, no-c-format
+msgid "Returns an ordered set of edges forming a ring with the given edge ."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1864
+#, no-c-format
+msgid ""
+"<funcdef>getfaceedges_returntype <function>GetRingEdges</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>aring</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>max_edges=null</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>getfaceedges_returntype <function>GetRingEdges</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>aring</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>max_edges=null</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1876
+#, no-c-format
+msgid ""
+"Returns an ordered set of edges forming a ring with the given edge. Each "
+"output consists of a sequence and a signed edge id. Sequence numbers start "
+"with value 1. A negative edge identifier means that the given edge is taken "
+"backward. You can pass a negative edge id to start walking backward."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1884
+#, no-c-format
+msgid ""
+"If <varname>max_edges</varname> is not null no more than those records are "
+"returned by that function. This is meant to be a safety parameter when "
+"dealing with possibly invalid topologies."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1899
+#, no-c-format
+msgid ", <xref linkend=\"GetNodeEdges\"/>"
+msgstr ", <xref linkend=\"GetNodeEdges\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:1908
+#, no-c-format
+msgid "GetNodeEdges"
+msgstr "GetNodeEdges"
+
+#. Tag: refpurpose
+#: extras_topology.xml:1910
+#, no-c-format
+msgid "Returns an ordered set of edges incident to the given node."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1917
+#, no-c-format
+msgid ""
+"<funcdef>getfaceedges_returntype <function>GetNodeEdges</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef>"
+msgstr ""
+"<funcdef>getfaceedges_returntype <function>GetNodeEdges</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>atopology</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>anode</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1928
+#, no-c-format
+msgid ""
+"Returns an ordered set of edges incident to the given node. Each output "
+"consists of a sequence and a signed edge id. Sequence numbers start with "
+"value 1. A positive edge starts at the given node. A negative edge ends into "
+"the given node. Closed edges will appear twice (with both signs). Order is "
+"clockwise starting from northbound."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1939
+#, no-c-format
+msgid ""
+"This function computes ordering rather than deriving from metadata and is "
+"thus usable to build edge ring linking."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1952
+#, no-c-format
+msgid ", <xref linkend=\"ST_Azimuth\"/>"
+msgstr ", <xref linkend=\"ST_Azimuth\"/>"
+
+#. Tag: para
+#: extras_topology.xml:1965
+#, no-c-format
+msgid ""
+"This section covers the functions for processing topologies in non-standard "
+"ways."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:1968
+#, no-c-format
+msgid "Topology Processing"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:1971
+#, no-c-format
+msgid "Polygonize"
+msgstr ""
+
+#. Tag: refpurpose
+#: extras_topology.xml:1972
+#, no-c-format
+msgid "Find and register all faces defined by topology edges"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:1976
+#, no-c-format
+msgid ""
+"<funcdef>text <function>Polygonize</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef>"
+msgstr ""
+"<funcdef>text <function>Polygonize</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:1986
+#, no-c-format
+msgid "Register all faces that can be built out a topology edge primitives."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1987
+#, no-c-format
+msgid "The target topology is assumed to contain no self-intersecting edges."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1988
+#, no-c-format
+msgid ""
+"Already known faces are recognized, so it is safe to call Polygonize "
+"multiple times on the same topology."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:1989 extras_topology.xml:2142
+#, no-c-format
+msgid ""
+"This function does not use nor set the next_left_edge and next_right_edge "
+"fields of the edge table."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2001
+#, no-c-format
+msgid ", <xref linkend=\"ST_Polygonize\"/>"
+msgstr ", <xref linkend=\"ST_Polygonize\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:2007
+#, no-c-format
+msgid "AddNode"
+msgstr "AddNode"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2009
+#, no-c-format
+msgid ""
+"Adds a point node to the node table in the specified topology schema and "
+"returns the nodeid of new node. If point already exists as node, the "
+"existing nodeid is returned."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:2014
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>AddNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>allowEdgeSplitting=false</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>boolean </type> <parameter>computeContainingFace=false</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>AddNode</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apoint</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>allowEdgeSplitting=false</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>boolean </type> <parameter>computeContainingFace=false</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:2027
+#, no-c-format
+msgid ""
+"Adds a point node to the node table in the specified topology schema. The "
+"<xref linkend=\"AddEdge\"/> function automatically adds start and end points "
+"of an edge when called so not necessary to explicitly add nodes of an edge."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2034
+#, no-c-format
+msgid ""
+"If any edge crossing the node is found either an exception is raised or the "
+"edge is splitted, depending on the <varname>allowEdgeSplitting</varname> "
+"parameter value."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2040
+#, no-c-format
+msgid ""
+"If <varname>computeContainingFace</varname> is true a newly added node would "
+"get the correct containing face computed."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2045
+#, no-c-format
+msgid ""
+"If the <varname>apoint</varname> geometry already exists as a node, the node "
+"is not added but the existing nodeid is returned."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2054
+#, no-c-format
+msgid ""
+"SELECT topology.AddNode('ma_topo', ST_GeomFromText('POINT(227641.6 "
+"893816.5)', 26986) ) As nodeid;\n"
+"-- result --\n"
+"nodeid\n"
+"--------\n"
+" 4"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:2066
+#, no-c-format
+msgid "AddEdge"
+msgstr "AddEdge"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2068
+#, no-c-format
+msgid ""
+"Adds a linestring edge to the edge table and associated start and end points "
+"to the point nodes table of the specified topology schema using the "
+"specified linestring geometry and returns the edgeid of the new (or "
+"existing) edge."
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:2073
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>AddEdge</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>aline</parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>AddEdge</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>aline</parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:2084
+#, no-c-format
+msgid ""
+"Adds an edge to the edge table and associated nodes to the nodes table of "
+"the specified <varname>toponame</varname> schema using the specified "
+"linestring geometry and returns the edgeid of the new or existing record. "
+"The newly added edge has \"universe\" face on both sides and links to itself."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2086
+#, no-c-format
+msgid ""
+"If the <varname>aline</varname> geometry crosses, overlaps, contains or is "
+"contained by an existing linestring edge, then an error is thrown and the "
+"edge is not added."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2087
+#, no-c-format
+msgid ""
+"The geometry of <varname>aline</varname> must have the same <varname>srid</"
+"varname> as defined for the topology otherwise an invalid spatial reference "
+"sys error will be thrown."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2091
+#, no-c-format
+msgid "Availability: 2.0.0 requires GEOS >= 3.3.0."
+msgstr "Dostępność: 2.0.0 wymaga GEOS >= 3.3.0."
+
+#. Tag: programlisting
+#: extras_topology.xml:2097
+#, no-c-format
+msgid ""
+"SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227575.8 "
+"893917.2,227591.9 893900.4)', 26986) ) As edgeid;\n"
+"-- result-\n"
+"edgeid\n"
+"--------\n"
+" 1\n"
+" \n"
+"SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227591.9 "
+"893900.4,227622.6 893844.2,227641.6 893816.5,\n"
+" 227704.5 893778.5)', 26986) ) As edgeid;\n"
+"-- result --\n"
+"edgeid\n"
+"--------\n"
+" 2\n"
+" \n"
+" SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227591.2 "
+"893900, 227591.9 893900.4,\n"
+" 227704.5 893778.5)', 26986) ) As edgeid;\n"
+" -- gives error --\n"
+" ERROR: Edge intersects (not on endpoints) with existing edge 1"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2103
+#, no-c-format
+msgid ", <xref linkend=\"spatial_ref_sys\"/>"
+msgstr ", <xref linkend=\"spatial_ref_sys\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:2109
+#, no-c-format
+msgid "AddFace"
+msgstr "AddFace"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2111
+#, no-c-format
+msgid ""
+"<refpurpose>Registers a face primitive to a topology and get it's identifier."
+"</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:2118
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>AddFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apolygon</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>force_new=false</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>integer <function>AddFace</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>apolygon</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>force_new=false</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:2130
+#, no-c-format
+msgid ""
+"<para>Registers a face primitive to a topology and get it's identifier.</"
+"para>"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2134
+#, no-c-format
+msgid ""
+"For a newly added face, the edges forming its boundaries and the ones "
+"contained in the face will be updated to have correct values in the "
+"left_face and right_face fields. Isolated nodes contained in the face will "
+"also be updated to have a correct containing_face field value."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2146
+#, no-c-format
+msgid ""
+"The target topology is assumed to be valid (containing no self-intersecting "
+"edges). An exception is raised if: The polygon boundary is not fully defined "
+"by existing edges or the polygon overlaps an existing face."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2148
+#, no-c-format
+msgid ""
+"If the <varname>apolygon</varname> geometry already exists as a face, then: "
+"if <varname>force_new</varname> is false (the default) the face id of the "
+"existing face is returned; if <varname>force_new</varname> is true a new id "
+"will be assigned to the newly registered face."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2156
+#, no-c-format
+msgid ""
+"When a new registration of an existing face is performed (force_new=true), "
+"no action will be taken to resolve dangling references to the existing face "
+"in the edge, node an relation tables, nor will the MBR field of the existing "
+"face record be updated. It is up to the caller to deal with that."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2163
+#, no-c-format
+msgid ""
+"The <varname>apolygon</varname> geometry must have the same <varname>srid</"
+"varname> as defined for the topology otherwise an invalid spatial reference "
+"sys error will be thrown."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2172
+#, no-c-format
+msgid ""
+"-- first add the edges we use generate_series as an iterator (the below \n"
+"-- will only work for polygons with < 10000 points because of our max in "
+"gs) \n"
+"SELECT topology.AddEdge('ma_topo', ST_MakeLine(ST_PointN(geom,i), "
+"ST_PointN(geom, i + 1) )) As edgeid\n"
+" FROM (SELECT ST_NPoints(geom) AS npt, geom\n"
+" FROM \n"
+" (SELECT ST_Boundary(ST_GeomFromText('POLYGON((234896.5 "
+"899456.7,234914 899436.4,234946.6 899356.9,234872.5 899328.7,\n"
+" 234891 899285.4,234992.5 899145, 234890.6 899069,234755.2 "
+"899255.4,\n"
+" 234612.7 899379.4,234776.9 899563.7,234896.5 899456.7))', "
+"26986) ) As geom\n"
+" ) As geoms) As facen CROSS JOIN generate_series(1,10000) As i\n"
+" WHERE i < npt;\n"
+"-- result --\n"
+" edgeid\n"
+"--------\n"
+" 3\n"
+" 4\n"
+" 5\n"
+" 6\n"
+" 7\n"
+" 8\n"
+" 9\n"
+" 10\n"
+" 11\n"
+" 12\n"
+"(10 rows)\n"
+"-- then add the face -\n"
+" \n"
+"SELECT topology.AddFace('ma_topo', \n"
+" ST_GeomFromText('POLYGON((234896.5 899456.7,234914 899436.4,234946.6 "
+"899356.9,234872.5 899328.7,\n"
+" 234891 899285.4,234992.5 899145, 234890.6 899069,234755.2 899255.4,\n"
+" 234612.7 899379.4,234776.9 899563.7,234896.5 899456.7))', 26986) ) As "
+"faceid;\n"
+"-- result --\n"
+"faceid\n"
+"--------\n"
+" 1"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2178
+#, no-c-format
+msgid ""
+", <xref linkend=\"CreateTopology\"/>, <xref linkend=\"spatial_ref_sys\"/>"
+msgstr ""
+", <xref linkend=\"CreateTopology\"/>, <xref linkend=\"spatial_ref_sys\"/>"
+
+#. Tag: para
+#: extras_topology.xml:2188
+#, no-c-format
+msgid ""
+"This section covers the topology functions for creating new topogeometries."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:2191
+#, no-c-format
+msgid "TopoGeometry Constructors"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:2194
+#, no-c-format
+msgid "CreateTopoGeom"
+msgstr "CreateTopoGeom"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2196
+#, no-c-format
+msgid ""
+"Creates a new topo geometry object from topo element array - tg_type: 1:"
+"[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: extras_topology.xml:2200
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>topogeometry <function>CreateTopoGeom</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>toponame</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>tg_type</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>layer_id</parameter></"
+"paramdef> <paramdef><type>topoelementarray</type> <parameter>tg_objs</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>topogeometry "
+"<function>CreateTopoGeom</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>toponame</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>tg_type</parameter></paramdef> <paramdef><type>integer</"
+"type> <parameter>layer_id</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>topogeometry <function>CreateTopoGeom</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>toponame</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>tg_type</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>layer_id</parameter></"
+"paramdef> <paramdef><type>topoelementarray</type> <parameter>tg_objs</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>topogeometry "
+"<function>CreateTopoGeom</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>toponame</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>tg_type</parameter></paramdef> <paramdef><type>integer</"
+"type> <parameter>layer_id</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: extras_topology.xml:2221 extras_topology.xml:2283
+#, no-c-format
+msgid ""
+"Creates a topogeometry object for layer denoted by layer_id and registers it "
+"in the relations table in the <varname>toponame</varname> schema."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2222
+#, no-c-format
+msgid ""
+"tg_type is an integer: 1:[multi]point (punctal), 2:[multi]line (lineal), 3:"
+"[multi]poly (areal), 4:collection. layer_id is the layer id in the topology."
+"layer table."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2223
+#, no-c-format
+msgid ""
+"punctal layers are formed from set of nodes, lineal layers are formed from a "
+"set of edges, areal layers are formed from a set of faces, and collections "
+"can be formed from a mixture of nodes, edges, and faces."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2225
+#, no-c-format
+msgid ""
+"Omitting the array of components generates an empty TopoGeometry object."
+msgstr ""
+
+#. Tag: title
+#: extras_topology.xml:2232
+#, no-c-format
+msgid "Examples: Form from existing edges"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2233
+#, no-c-format
+msgid ""
+"Create a topogeom in ri_topo schema for layer 2 (our ri_roads), of type (2) "
+"LINE, for the first edge (we loaded in <varname>ST_CreateTopoGeo</varname>."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2234
+#, no-c-format
+msgid ""
+"INSERT INTO ri.ri_roads(road_name, topo) VALUES('Unknown', topology."
+"CreateTopoGeom('ri_topo',2,2,'{{1,2}}'::topology.topoelementarray);"
+msgstr ""
+"INSERT INTO ri.ri_roads(road_name, topo) VALUES('Unknown', topology."
+"CreateTopoGeom('ri_topo',2,2,'{{1,2}}'::topology.topoelementarray);"
+
+#. Tag: title
+#: extras_topology.xml:2239
+#, no-c-format
+msgid "Examples: Convert an areal geometry to best guess topogeometry"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2240
+#, no-c-format
+msgid ""
+"Lets say we have geometries that should be formed from a collection of "
+"faces. We have for example blockgroups table and want to know the topo "
+"geometry of each block group. If our data was perfectly aligned, we could do "
+"this:"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2242
+#, no-c-format
+msgid ""
+"-- create our topo geometry column --\n"
+"SELECT topology.AddTopoGeometryColumn(\n"
+" 'topo_boston', \n"
+" 'boston', 'blockgroups', 'topo', 'POLYGON');\n"
+" \n"
+"-- addtopgeometrycolumn --\n"
+"1\n"
+" \n"
+"-- update our column assuming \n"
+"-- everything is perfectly aligned with our edges\n"
+"UPDATE boston.blockgroups AS bg\n"
+" SET topo = topology.CreateTopoGeom('topo_boston'\n"
+" ,3,1\n"
+" , foo.bfaces)\n"
+"FROM (SELECT b.gid, topology.TopoElementArray_Agg(ARRAY[f.face_id,3]) As "
+"bfaces\n"
+" FROM boston.blockgroups As b\n"
+" INNER JOIN topo_boston.face As f ON b.geom && f.mbr\n"
+" WHERE ST_Covers(b.geom, topology.ST_GetFaceGeometry('topo_boston', f."
+"face_id))\n"
+" GROUP BY b.gid) As foo\n"
+"WHERE foo.gid = bg.gid;"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2244
+#, no-c-format
+msgid ""
+"--the world is rarely perfect allow for some error\n"
+"--count the face if 50% of it falls \n"
+"-- within what we think is our blockgroup boundary\n"
+"UPDATE boston.blockgroups AS bg\n"
+" SET topo = topology.CreateTopoGeom('topo_boston'\n"
+" ,3,1\n"
+" , foo.bfaces)\n"
+"FROM (SELECT b.gid, topology.TopoElementArray_Agg(ARRAY[f.face_id,3]) As "
+"bfaces\n"
+" FROM boston.blockgroups As b\n"
+" INNER JOIN topo_boston.face As f ON b.geom && f.mbr\n"
+" WHERE ST_Covers(b.geom, topology.ST_GetFaceGeometry('topo_boston', f."
+"face_id))\n"
+" OR\n"
+" ( ST_Intersects(b.geom, topology.ST_GetFaceGeometry('topo_boston', f."
+"face_id))\n"
+" AND ST_Area(ST_Intersection(b.geom, topology."
+"ST_GetFaceGeometry('topo_boston', f.face_id) ) ) > \n"
+" ST_Area(topology.ST_GetFaceGeometry('topo_boston', f."
+"face_id))*0.5\n"
+" )\n"
+" GROUP BY b.gid) As foo\n"
+"WHERE foo.gid = bg.gid; \n"
+"\n"
+"-- and if we wanted to convert our topogeometry back\n"
+"-- to a denomalized geometry aligned with our faces and edges \n"
+"-- cast the topo to a geometry\n"
+"-- The really cool thing is my new geometries\n"
+"-- are now aligned with my tiger street centerlines\n"
+"UPDATE boston.blockgroups SET new_geom = topo::geometry;"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2250
+#, no-c-format
+msgid ""
+", <xref linkend=\"toTopoGeom\"/> <xref linkend=\"ST_CreateTopoGeo\"/>, <xref "
+"linkend=\"ST_GetFaceGeometry\"/>, <xref linkend=\"topoelementarray\"/>, "
+"<xref linkend=\"TopoElementArray_Agg\"/>"
+msgstr ""
+", <xref linkend=\"toTopoGeom\"/> <xref linkend=\"ST_CreateTopoGeo\"/>, <xref "
+"linkend=\"ST_GetFaceGeometry\"/>, <xref linkend=\"topoelementarray\"/>, "
+"<xref linkend=\"TopoElementArray_Agg\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:2263
+#, no-c-format
+msgid "toTopoGeom"
+msgstr "toTopoGeom"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2265
+#, no-c-format
+msgid "Creates a new topo geometry from a simple geometry"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:2270
+#, no-c-format
+msgid ""
+"<funcdef>topogeometry <function>toTopoGeom</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>layer_id</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8</type> <parameter>tolerance</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>topogeometry <function>toTopoGeom</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>varchar </type> <parameter>toponame</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>layer_id</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>float8</type> <parameter>tolerance</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:2287
+#, no-c-format
+msgid ""
+"Topological primitives required to represent the input geometry will be "
+"added, possibly splitting existing ones. Pre-existing TopoGeometry objects "
+"will retain their shapes."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2292
+#, no-c-format
+msgid ""
+"When <varname>tolerance</varname> is given it will be used to snap the input "
+"geometry to existing primitives."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2301
+#, no-c-format
+msgid "This is a full self-contained workflow"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2302
+#, no-c-format
+msgid ""
+"-- do this if you don't have a topology setup already\n"
+"-- creates topology not allowing any tolerance\n"
+"SELECT topology.CreateTopology('topo_boston_test', 2249);\n"
+"-- create a new table\n"
+"CREATE TABLE nei_topo(gid serial primary key, nei varchar(30));\n"
+"--add a topogeometry column to it\n"
+"SELECT topology.AddTopoGeometryColumn('topo_boston_test', 'public', "
+"'nei_topo', 'topo', 'MULTIPOLYGON') As new_layer_id;\n"
+"new_layer_id\n"
+"-----------\n"
+"1\n"
+"\n"
+"--use new layer id in populating the new topogeometry column\n"
+"-- we add the topogeoms to the new layer with 0 tolerance\n"
+"INSERT INTO nei_topo(nei, topo)\n"
+"SELECT nei, topology.toTopoGeom(geom, 'topo_boston_test', 1)\n"
+"FROM neighborhoods\n"
+"WHERE gid BETWEEN 1 and 15;\n"
+"\n"
+"--use to verify what has happened --\n"
+"SELECT * FROM \n"
+" topology.TopologySummary('topo_boston_test'); \n"
+" \n"
+"-- summary--\n"
+"Topology topo_boston_test (5), SRID 2249, precision 0\n"
+"61 nodes, 87 edges, 35 faces, 15 topogeoms in 1 layers\n"
+"Layer 1, type Polygonal (3), 15 topogeoms\n"
+" Deploy: public.nei_topo.topo"
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2308
+#, no-c-format
+msgid ""
+",<xref linkend=\"AddTopoGeometryColumn\"/>, <xref linkend=\"CreateTopoGeom\"/"
+">, <xref linkend=\"TopologySummary\"/>"
+msgstr ""
+",<xref linkend=\"AddTopoGeometryColumn\"/>, <xref linkend=\"CreateTopoGeom\"/"
+">, <xref linkend=\"TopologySummary\"/>"
+
+#. Tag: refname
+#: extras_topology.xml:2315
+#, no-c-format
+msgid "TopoElementArray_Agg"
+msgstr "TopoElementArray_Agg"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2316
+#, no-c-format
+msgid ""
+"Returns a <varname>topoelementarray</varname> for a set of element_id, type "
+"arrays (topoelements)"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:2321
+#, no-c-format
+msgid ""
+"<funcdef>topoelementarray <function>TopoElementArray_Agg</function></"
+"funcdef> <paramdef><type>topoelement set</type> <parameter>tefield</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>topoelementarray <function>TopoElementArray_Agg</function></"
+"funcdef> <paramdef><type>topoelement set</type> <parameter>tefield</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:2331
+#, no-c-format
+msgid ""
+"Used to create a <xref linkend=\"topoelementarray\"/> from a set of <xref "
+"linkend=\"topoelement\"/>."
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2340
+#, no-c-format
+msgid ""
+"SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea\n"
+" FROM generate_series(1,3) As e CROSS JOIN generate_series(1,4) As t;\n"
+" tea\n"
+"--------------------------------------------------------------------------\n"
+"{{1,1},{1,2},{1,3},{1,4},{2,1},{2,2},{2,3},{2,4},{3,1},{3,2},{3,3},{3,4}}"
+msgstr ""
+"SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea\n"
+" FROM generate_series(1,3) As e CROSS JOIN generate_series(1,4) As t;\n"
+" tea\n"
+"--------------------------------------------------------------------------\n"
+"{{1,1},{1,2},{1,3},{1,4},{2,1},{2,2},{2,3},{2,4},{3,1},{3,2},{3,3},{3,4}}"
+
+#. Tag: para
+#: extras_topology.xml:2344 extras_topology.xml:2397
+#, no-c-format
+msgid ", <xref linkend=\"topoelementarray\"/>"
+msgstr ", <xref linkend=\"topoelementarray\"/>"
+
+#. Tag: title
+#: extras_topology.xml:2350
+#, no-c-format
+msgid "TopoGeometry Accessors"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:2354
+#, no-c-format
+msgid "GetTopoGeomElementArray"
+msgstr "GetTopoGeomElementArray"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2356
+#, no-c-format
+msgid ""
+"Returns a <varname>topoelementarray</varname> (an array of topoelements) "
+"containing the topological elements and type of the given TopoGeometry "
+"(primitive elements)"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:2361
+#, no-c-format
+msgid ""
+"<funcdef>topoelementarray <function>GetTopoGeomElementArray</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>toponame</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>layer_id</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>tg_id</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>topoelementarray <function>GetTopoGeomElementArray</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>toponame</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>layer_id</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>tg_id</parameter></"
+"paramdef>"
+
+#. Tag: funcprototype
+#: extras_topology.xml:2369
+#, no-c-format
+msgid ""
+"<funcdef>topoelementarray topoelement <function>GetTopoGeomElementArray</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>topoelementarray topoelement <function>GetTopoGeomElementArray</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:2379
+#, no-c-format
+msgid ""
+"Returns a <xref linkend=\"topoelementarray\"/> containing the topological "
+"elements and type of the given TopoGeometry (primitive elements). This is "
+"similar to GetTopoGeomElements except it returns the elements as an array "
+"rather than as a dataset."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2381 extras_topology.xml:2428
+#, no-c-format
+msgid ""
+"tg_id is the topogeometry id of the topogeometry object in the topology in "
+"the layer denoted by <varname>layer_id</varname> in the topology.layer table."
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:2402
+#, no-c-format
+msgid "GetTopoGeomElements"
+msgstr "GetTopoGeomElements"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2404
+#, no-c-format
+msgid ""
+"Returns a set of <varname>topoelement</varname> objects containing the "
+"topological element_id,element_type of the given TopoGeometry (primitive "
+"elements)"
+msgstr ""
+
+#. Tag: funcprototype
+#: extras_topology.xml:2409
+#, no-c-format
+msgid ""
+"<funcdef>setof topoelement <function>GetTopoGeomElements</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>toponame</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>layer_id</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>tg_id</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>setof topoelement <function>GetTopoGeomElements</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>toponame</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>layer_id</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>tg_id</parameter></"
+"paramdef>"
+
+#. Tag: funcprototype
+#: extras_topology.xml:2417
+#, no-c-format
+msgid ""
+"<funcdef>setof topoelement <function>GetTopoGeomElements</function></"
+"funcdef> <paramdef><type>topogeometry </type> <parameter>tg</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>setof topoelement <function>GetTopoGeomElements</function></"
+"funcdef> <paramdef><type>topogeometry </type> <parameter>tg</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: extras_topology.xml:2427
+#, no-c-format
+msgid ""
+"Returns a set of element_id,element_type (topoelements) for a given "
+"topogeometry object in <varname>toponame</varname> schema."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2444
+#, no-c-format
+msgid ", <xref linkend=\"topoelement\"/>"
+msgstr ", <xref linkend=\"topoelement\"/>"
+
+#. Tag: title
+#: extras_topology.xml:2451
+#, no-c-format
+msgid "TopoGeometry Outputs"
+msgstr ""
+
+#. Tag: refname
+#: extras_topology.xml:2454
+#, no-c-format
+msgid "AsGML"
+msgstr "AsGML"
+
+#. Tag: refpurpose
+#: extras_topology.xml:2456
+#, no-c-format
+msgid "Returns the GML representation of a topogeometry."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: extras_topology.xml:2460
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>AsGML</function></funcdef> "
+"<paramdef><type>topogeometry </type> <parameter>tg</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>AsGML</function></"
+"funcdef> <paramdef><type>topogeometry </type> <parameter>tg</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>nsprefix_in</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>text <function>AsGML</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef> <paramdef><type>regclass </type> "
+"<parameter>visitedTable</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AsGML</function></funcdef> "
+"<paramdef><type>topogeometry </type> <parameter>tg</parameter></paramdef> "
+"<paramdef><type>regclass </type> <parameter>visitedTable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>nsprefix</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>text <function>AsGML</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>nsprefix_in</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>precision</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>options</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>text "
+"<function>AsGML</function></funcdef> <paramdef><type>topogeometry </type> "
+"<parameter>tg</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>nsprefix_in</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>precision</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>options</parameter></paramdef> <paramdef><type>regclass </"
+"type> <parameter>visitedTable</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AsGML</function></funcdef> "
+"<paramdef><type>topogeometry </type> <parameter>tg</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>nsprefix_in</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>precision</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>options</parameter></paramdef> "
+"<paramdef><type>regclass </type> <parameter>visitedTable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>idprefix</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>text <function>AsGML</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>nsprefix_in</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>precision</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>options</"
+"parameter></paramdef> <paramdef><type>regclass </type> "
+"<parameter>visitedTable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>idprefix</parameter></paramdef> <paramdef><type>int </type> "
+"<parameter>gmlversion</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>text <function>AsGML</function></funcdef> "
+"<paramdef><type>topogeometry </type> <parameter>tg</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>AsGML</function></"
+"funcdef> <paramdef><type>topogeometry </type> <parameter>tg</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>nsprefix_in</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>text <function>AsGML</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef> <paramdef><type>regclass </type> "
+"<parameter>visitedTable</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AsGML</function></funcdef> "
+"<paramdef><type>topogeometry </type> <parameter>tg</parameter></paramdef> "
+"<paramdef><type>regclass </type> <parameter>visitedTable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>nsprefix</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>text <function>AsGML</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>nsprefix_in</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>precision</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>options</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>text "
+"<function>AsGML</function></funcdef> <paramdef><type>topogeometry </type> "
+"<parameter>tg</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>nsprefix_in</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>precision</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>options</parameter></paramdef> <paramdef><type>regclass </"
+"type> <parameter>visitedTable</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AsGML</function></funcdef> "
+"<paramdef><type>topogeometry </type> <parameter>tg</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>nsprefix_in</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>precision</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>options</parameter></paramdef> "
+"<paramdef><type>regclass </type> <parameter>visitedTable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>idprefix</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>text <function>AsGML</"
+"function></funcdef> <paramdef><type>topogeometry </type> <parameter>tg</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>nsprefix_in</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>precision</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>options</"
+"parameter></paramdef> <paramdef><type>regclass </type> "
+"<parameter>visitedTable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>idprefix</parameter></paramdef> <paramdef><type>int </type> "
+"<parameter>gmlversion</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: extras_topology.xml:2521
+#, no-c-format
+msgid ""
+"Returns the GML representation of a topogeometry in version GML3 format. If "
+"no <varname>nsprefix_in</varname> is specified then <varname>gml</varname> "
+"is used. Pass in an empty string for nsprefix to get a non-qualified name "
+"space. The precision (default: 15) and options (default 1) parameters, if "
+"given, are passed untouched to the underlying call to ST_AsGML."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2523
+#, no-c-format
+msgid ""
+"The <varname>visitedTable</varname> parameter, if given, is used for keeping "
+"track of the visited Node and Edge elements so to use cross-references "
+"(xlink:xref) rather than duplicating definitions. The table is expected to "
+"have (at least) two integer fields: 'element_type' and 'element_id'. The "
+"calling user must have both read and write privileges on the given table. "
+"For best performance, an index should be defined on <varname>element_type</"
+"varname> and <varname>element_id</varname>, in that order. Such index would "
+"be created automatically by adding a unique constraint to the fields. "
+"Example:"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2529
+#, no-c-format
+msgid ""
+"CREATE TABLE visited (\n"
+" element_type integer, element_id integer,\n"
+" unique(element_type, element_id)\n"
+");"
+msgstr ""
+"CREATE TABLE visited (\n"
+" element_type integer, element_id integer,\n"
+" unique(element_type, element_id)\n"
+");"
+
+#. Tag: para
+#: extras_topology.xml:2532
+#, no-c-format
+msgid ""
+"The <varname>idprefix</varname> parameter, if given, will be prepended to "
+"Edge and Node tag identifiers."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2534
+#, no-c-format
+msgid ""
+"The <varname>gmlver</varname> parameter, if given, will be passed to the "
+"underlying ST_AsGML. Defaults to 3."
+msgstr ""
+
+#. Tag: para
+#: extras_topology.xml:2543
+#, no-c-format
+msgid ""
+"This uses the topo geometry we created in <xref linkend=\"CreateTopoGeom\"/>"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2544
+#, no-c-format
+msgid ""
+"SELECT topology.AsGML(topo) As rdgml \n"
+" FROM ri.roads \n"
+" WHERE road_name = 'Unknown';\n"
+" \n"
+"-- rdgml--\n"
+"<![CDATA[<gml:TopoCurve>\n"
+" <gml:directedEdge>\n"
+" <gml:Edge gml:id=\"E1\">\n"
+" <gml:directedNode orientation=\"-\">\n"
+" <gml:Node gml:id=\"N1\"/>\n"
+" </gml:directedNode>\n"
+" <gml:directedNode></gml:directedNode>\n"
+" <gml:curveProperty>\n"
+" <gml:Curve srsName=\"urn:ogc:def:crs:EPSG::3438\">\n"
+" <gml:segments>\n"
+" <gml:LineStringSegment>\n"
+" <gml:posList srsDimension=\"2\">384744 236928 "
+"384750 236923 384769 236911 384799 236895 384811 236890 \n"
+" 384833 236884 384844 236882 384866 236881 384879 "
+"236883 384954 236898 385087 236932 385117 236938 \n"
+" 385167 236938 385203 236941 385224 236946 385233 "
+"236950 385241 236956 385254 236971 \n"
+" 385260 236979 385268 236999 385273 237018 385273 "
+"237037 385271 237047 385267 237057 385225 237125 \n"
+" 385210 237144 385192 237161 385167 237192 385162 "
+"237202 385159 237214 385159 237227 385162 237241 \n"
+" 385166 237256 385196 237324 385209 237345 385234 "
+"237375 385237 237383 385238 237399 385236 237407 \n"
+" 385227 237419 385213 237430 385193 237439 385174 "
+"237451 385170 237455 385169 237460 385171 237475 \n"
+" 385181 237503 385190 237521 385200 237533 385206 "
+"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n"
+" 385249 237544 385260 237555 385270 237570 385289 "
+"237584 385292 237589 385291 237596 385284 237630</gml:posList>\n"
+" </gml:LineStringSegment>\n"
+" </gml:segments>\n"
+" </gml:Curve>\n"
+" </gml:curveProperty>\n"
+" </gml:Edge>\n"
+" </gml:directedEdge>\n"
+"</gml:TopoCurve>]]>"
+msgstr ""
+"SELECT topology.AsGML(topo) As rdgml \n"
+" FROM ri.roads \n"
+" WHERE road_name = 'Unknown';\n"
+" \n"
+"-- rdgml--\n"
+"<![CDATA[<gml:TopoCurve>\n"
+" <gml:directedEdge>\n"
+" <gml:Edge gml:id=\"E1\">\n"
+" <gml:directedNode orientation=\"-\">\n"
+" <gml:Node gml:id=\"N1\"/>\n"
+" </gml:directedNode>\n"
+" <gml:directedNode></gml:directedNode>\n"
+" <gml:curveProperty>\n"
+" <gml:Curve srsName=\"urn:ogc:def:crs:EPSG::3438\">\n"
+" <gml:segments>\n"
+" <gml:LineStringSegment>\n"
+" <gml:posList srsDimension=\"2\">384744 236928 "
+"384750 236923 384769 236911 384799 236895 384811 236890 \n"
+" 384833 236884 384844 236882 384866 236881 384879 "
+"236883 384954 236898 385087 236932 385117 236938 \n"
+" 385167 236938 385203 236941 385224 236946 385233 "
+"236950 385241 236956 385254 236971 \n"
+" 385260 236979 385268 236999 385273 237018 385273 "
+"237037 385271 237047 385267 237057 385225 237125 \n"
+" 385210 237144 385192 237161 385167 237192 385162 "
+"237202 385159 237214 385159 237227 385162 237241 \n"
+" 385166 237256 385196 237324 385209 237345 385234 "
+"237375 385237 237383 385238 237399 385236 237407 \n"
+" 385227 237419 385213 237430 385193 237439 385174 "
+"237451 385170 237455 385169 237460 385171 237475 \n"
+" 385181 237503 385190 237521 385200 237533 385206 "
+"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n"
+" 385249 237544 385260 237555 385270 237570 385289 "
+"237584 385292 237589 385291 237596 385284 237630</gml:posList>\n"
+" </gml:LineStringSegment>\n"
+" </gml:segments>\n"
+" </gml:Curve>\n"
+" </gml:curveProperty>\n"
+" </gml:Edge>\n"
+" </gml:directedEdge>\n"
+"</gml:TopoCurve>]]>"
+
+#. Tag: para
+#: extras_topology.xml:2545
+#, no-c-format
+msgid "Same exercise as previous without namespace"
+msgstr ""
+
+#. Tag: programlisting
+#: extras_topology.xml:2546
+#, no-c-format
+msgid ""
+"SELECT topology.AsGML(topo,'') As rdgml \n"
+" FROM ri.roads \n"
+" WHERE road_name = 'Unknown';\n"
+" \n"
+"-- rdgml--\n"
+"<![CDATA[<TopoCurve>\n"
+" <directedEdge>\n"
+" <Edge id=\"E1\">\n"
+" <directedNode orientation=\"-\">\n"
+" <Node id=\"N1\"/>\n"
+" </directedNode>\n"
+" <directedNode></directedNode>\n"
+" <curveProperty>\n"
+" <Curve srsName=\"urn:ogc:def:crs:EPSG::3438\">\n"
+" <segments>\n"
+" <LineStringSegment>\n"
+" <posList srsDimension=\"2\">384744 236928 384750 "
+"236923 384769 236911 384799 236895 384811 236890 \n"
+" 384833 236884 384844 236882 384866 236881 384879 "
+"236883 384954 236898 385087 236932 385117 236938 \n"
+" 385167 236938 385203 236941 385224 236946 385233 "
+"236950 385241 236956 385254 236971 \n"
+" 385260 236979 385268 236999 385273 237018 385273 "
+"237037 385271 237047 385267 237057 385225 237125 \n"
+" 385210 237144 385192 237161 385167 237192 385162 "
+"237202 385159 237214 385159 237227 385162 237241 \n"
+" 385166 237256 385196 237324 385209 237345 385234 "
+"237375 385237 237383 385238 237399 385236 237407 \n"
+" 385227 237419 385213 237430 385193 237439 385174 "
+"237451 385170 237455 385169 237460 385171 237475 \n"
+" 385181 237503 385190 237521 385200 237533 385206 "
+"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n"
+" 385249 237544 385260 237555 385270 237570 385289 "
+"237584 385292 237589 385291 237596 385284 237630</posList>\n"
+" </LineStringSegment>\n"
+" </segments>\n"
+" </Curve>\n"
+" </curveProperty>\n"
+" </Edge>\n"
+" </directedEdge>\n"
+"</TopoCurve>]]>"
+msgstr ""
+"SELECT topology.AsGML(topo,'') As rdgml \n"
+" FROM ri.roads \n"
+" WHERE road_name = 'Unknown';\n"
+" \n"
+"-- rdgml--\n"
+"<![CDATA[<TopoCurve>\n"
+" <directedEdge>\n"
+" <Edge id=\"E1\">\n"
+" <directedNode orientation=\"-\">\n"
+" <Node id=\"N1\"/>\n"
+" </directedNode>\n"
+" <directedNode></directedNode>\n"
+" <curveProperty>\n"
+" <Curve srsName=\"urn:ogc:def:crs:EPSG::3438\">\n"
+" <segments>\n"
+" <LineStringSegment>\n"
+" <posList srsDimension=\"2\">384744 236928 384750 "
+"236923 384769 236911 384799 236895 384811 236890 \n"
+" 384833 236884 384844 236882 384866 236881 384879 "
+"236883 384954 236898 385087 236932 385117 236938 \n"
+" 385167 236938 385203 236941 385224 236946 385233 "
+"236950 385241 236956 385254 236971 \n"
+" 385260 236979 385268 236999 385273 237018 385273 "
+"237037 385271 237047 385267 237057 385225 237125 \n"
+" 385210 237144 385192 237161 385167 237192 385162 "
+"237202 385159 237214 385159 237227 385162 237241 \n"
+" 385166 237256 385196 237324 385209 237345 385234 "
+"237375 385237 237383 385238 237399 385236 237407 \n"
+" 385227 237419 385213 237430 385193 237439 385174 "
+"237451 385170 237455 385169 237460 385171 237475 \n"
+" 385181 237503 385190 237521 385200 237533 385206 "
+"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n"
+" 385249 237544 385260 237555 385270 237570 385289 "
+"237584 385292 237589 385291 237596 385284 237630</posList>\n"
+" </LineStringSegment>\n"
+" </segments>\n"
+" </Curve>\n"
+" </curveProperty>\n"
+" </Edge>\n"
+" </directedEdge>\n"
+"</TopoCurve>]]>"
+
+#. Tag: para
+#: extras_topology.xml:2552
+#, no-c-format
+msgid ", <xref linkend=\"ST_CreateTopoGeo\"/>"
+msgstr ", <xref linkend=\"ST_CreateTopoGeo\"/>"
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: faq.xml:3
+#, no-c-format
+msgid "PostGIS Frequently Asked Questions"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:8
+#, no-c-format
+msgid ""
+"My applications and desktop tools worked with PostGIS 1.5,but they don't "
+"work with PostGIS 2.0. How do I fix this?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:12
+#, no-c-format
+msgid ""
+"A lot of deprecated functions were removed from the PostGIS code base in "
+"PostGIS 2.0. This has affected applications in addition to third-party tools "
+"such as Geoserver, MapServer, QuantumGIS, and OpenJump to name a few. There "
+"are a couple of ways to resolve this. For the third-party apps, you can try "
+"to upgrade to the latest versions of these which have many of these issues "
+"fixed. For your own code, you can change your code to not use the functions "
+"removed. Most of these functions are non ST_ aliases of ST_Union, ST_Length "
+"etc. and as a last resort, install the whole of <varname>legacy.sql</"
+"varname> or just the portions of <varname>legacy.sql</varname> you need."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:18
+#, no-c-format
+msgid ""
+"The <varname>legacy.sql</varname> file is located in the same folder as "
+"postgis.sql. You can install this file after you have installed postgis.sql "
+"and spatial_ref_sys.sql to get back all the 200 some-odd old functions we "
+"removed."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:24
+#, no-c-format
+msgid ""
+"I'm running PostgreSQL 9.0 and I can no longer read/view geometries in "
+"OpenJump, Safe FME, and some other tools?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:28
+#, no-c-format
+msgid ""
+"In PostgreSQL 9.0+, the default encoding for bytea data has been changed to "
+"hex and older JDBC drivers still assume escape format. This has affected "
+"some applications such as Java applications using older JDBC drivers or .NET "
+"applications that use the older npgsql driver that expect the old behavior "
+"of ST_AsBinary. There are two approaches to getting this to work again."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:32
+#, no-c-format
+msgid ""
+"You can upgrade your JDBC driver to the latest PostgreSQL 9.0 version which "
+"you can get from <ulink url=\"http://jdbc.postgresql.org/download.html"
+"\">http://jdbc.postgresql.org/download.html</ulink>"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:34
+#, no-c-format
+msgid ""
+"If you are running a .NET app, you can use Npgsql 2.0.11 or higher which you "
+"can download from <ulink url=\"http://pgfoundry.org/frs/?"
+"group_id=1000140\">http://pgfoundry.org/frs/?group_id=1000140</ulink> and as "
+"described on <ulink url=\"http://fxjr.blogspot.com/2010/11/npgsql-2011-"
+"released.html\">Francisco Figueiredo's NpgSQL 2.0.11 released blog entry</"
+"ulink>"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:38
+#, no-c-format
+msgid ""
+"If upgrading your PostgreSQL driver is not an option, then you can set the "
+"default back to the old behavior with the following change:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:39
+#, no-c-format
+msgid "ALTER DATABASE mypostgisdb SET bytea_output='escape';"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:46
+#, no-c-format
+msgid ""
+"I tried to use PgAdmin to view my geometry column and it is blank, what "
+"gives?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:50
+#, no-c-format
+msgid ""
+"PgAdmin doesn't show anything for large geometries. The best ways to verify "
+"you do have data in your geometry columns are?"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:53
+#, no-c-format
+msgid ""
+"-- this should return no records if all your geom fields are filled "
+"in \n"
+"SELECT somefield FROM mytable WHERE geom IS NULL;"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:55
+#, no-c-format
+msgid ""
+"-- To tell just how large your geometry is do a query of the form\n"
+"--which will tell you the most number of points you have in any of your "
+"geometry columns\n"
+"SELECT MAX(ST_NPoints(geom)) FROM sometable;"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:61
+#, no-c-format
+msgid "What kind of geometric objects can I store?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:65
+#, no-c-format
+msgid ""
+"You can store point, line, polygon, multipoint, multiline, multipolygon, and "
+"geometrycollections. In PostGIS 2.0 and above you can also store TINS and "
+"Polyhedral Surfaces in the basic geometry type. These are specified in the "
+"Open GIS Well Known Text Format (with XYZ,XYM,XYZM extensions). There are "
+"three data types currently supported. The standard OGC geometry data type "
+"which uses a planar coordinate system for measurement, the geography data "
+"type which uses a geodetic coordinate system (not OGC, but you'll find a "
+"similar type in Microsoft SQL Server 2008+). Only WGS 84 long lat "
+"(SRID:4326) is supported by the geography data type. The newest family "
+"member of the PostGIS spatial type family is raster for storing and "
+"analyzing raster data. Raster has its very own FAQ. Refer to <xref linkend="
+"\"RT_FAQ\"/> and <xref linkend=\"RT_reference\"/> for more details."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:78
+#, no-c-format
+msgid "I'm all confused. Which data store should I use geometry or geography?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:82
+#, no-c-format
+msgid ""
+"Short Answer: geography is a new data type that supports long range "
+"distances measurements, but most computations on it are currently slower "
+"than they are on geometry. If you use geography -- you don't need to learn "
+"much about planar coordinate systems. Geography is generally best if all you "
+"care about is measuring distances and lengths and you have data from all "
+"over the world. Geometry data type is an older data type that has many more "
+"functions supporting it, enjoys greater support from third party tools, and "
+"operations on it are generally faster -- sometimes as much as 10 fold faster "
+"for larger geometries. Geometry is best if you are pretty comfortable with "
+"spatial reference systems or you are dealing with localized data where all "
+"your data fits in a single <link linkend=\"spatial_ref_sys\">spatial "
+"reference system (SRID)</link>, or you need to do a lot of spatial "
+"processing. Note: It is fairly easy to do one-off conversions between the "
+"two types to gain the benefits of each. Refer to <xref linkend="
+"\"PostGIS_TypeFunctionMatrix\"/> to see what is currently supported and what "
+"is not."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:93
+#, no-c-format
+msgid ""
+"Long Answer: Refer to our more lengthy discussion in the <xref linkend="
+"\"PostGIS_GeographyVSGeometry\"/> and <link linkend="
+"\"PostGIS_TypeFunctionMatrix\">function type matrix</link>."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:101
+#, no-c-format
+msgid ""
+"I have more intense questions about geography, such as how big of a "
+"geographic region can I stuff in a geography column and still get reasonable "
+"answers. Are there limitations such as poles, everything in the field must "
+"fit in a hemisphere (like SQL Server 2008 has), speed etc?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:105
+#, no-c-format
+msgid ""
+"Your questions are too deep and complex to be adequately answered in this "
+"section. Please refer to our <xref linkend=\"PostGIS_Geography_AdvancedFAQ\"/"
+">."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:112
+#, no-c-format
+msgid "How do I insert a GIS object into the database?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:116
+#, no-c-format
+msgid ""
+"First, you need to create a table with a column of type \"geometry\" or "
+"\"geography\" to hold your GIS data. Storing geography type data is a little "
+"different than storing geometry. Refer to <xref linkend=\"Geography_Basics\"/"
+"> for details on storing geography."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:120
+#, no-c-format
+msgid ""
+"For geometry: Connect to your database with <filename>psql</filename> and "
+"try the following SQL:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:124
+#, no-c-format
+msgid ""
+"CREATE TABLE gtest ( ID int4, NAME varchar(20) );\n"
+"SELECT AddGeometryColumn('', 'gtest','geom',-1,'LINESTRING',2);"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:126
+#, no-c-format
+msgid ""
+"If the geometry column addition fails, you probably have not loaded the "
+"PostGIS functions and objects into this database. See the <xref linkend="
+"\"PGInstall\"/>."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:130
+#, no-c-format
+msgid ""
+"Then, you can insert a geometry into the table using a SQL insert statement. "
+"The GIS object itself is formatted using the OpenGIS Consortium \"well-known "
+"text\" format:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:134
+#, no-c-format
+msgid ""
+"INSERT INTO gtest (ID, NAME, GEOM) \n"
+"VALUES (\n"
+" 1, \n"
+" 'First Geometry', \n"
+" ST_GeomFromText('LINESTRING(2 3,4 5,6 5,7 8)', -1)\n"
+");"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:136
+#, no-c-format
+msgid ""
+"For more information about other GIS objects, see the <link linkend="
+"\"RefObject\">object reference</link>."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:139
+#, no-c-format
+msgid "To view your GIS data in the table:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:141
+#, no-c-format
+msgid "SELECT id, name, ST_AsText(geom) AS geom FROM gtest;"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:143
+#, no-c-format
+msgid "The return value should look something like this:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:145
+#, no-c-format
+msgid ""
+"id | name | geom\n"
+"----+----------------+-----------------------------\n"
+" 1 | First Geometry | LINESTRING(2 3,4 5,6 5,7 8) \n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:151
+#, no-c-format
+msgid "How do I construct a spatial query?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:155
+#, no-c-format
+msgid ""
+"The same way you construct any other database query, as an SQL combination "
+"of return values, functions, and boolean tests."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:158
+#, no-c-format
+msgid ""
+"For spatial queries, there are two issues that are important to keep in mind "
+"while constructing your query: is there a spatial index you can make use of; "
+"and, are you doing expensive calculations on a large number of geometries."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:163
+#, no-c-format
+msgid ""
+"In general, you will want to use the \"intersects operator\" (&&) "
+"which tests whether the bounding boxes of features intersect. The reason the "
+"&& operator is useful is because if a spatial index is available to "
+"speed up the test, the && operator will make use of this. This can "
+"make queries much much faster."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:170
+#, no-c-format
+msgid ""
+"You will also make use of spatial functions, such as Distance(), "
+"ST_Intersects(), ST_Contains() and ST_Within(), among others, to narrow down "
+"the results of your search. Most spatial queries include both an indexed "
+"test and a spatial function test. The index test serves to limit the number "
+"of return tuples to only tuples that <emphasis>might</emphasis> meet the "
+"condition of interest. The spatial functions are then use to test the "
+"condition exactly."
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:178
+#, no-c-format
+msgid ""
+"SELECT id, the_geom \n"
+"FROM thetable \n"
+"WHERE \n"
+" ST_Contains(the_geom,'POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))');"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:184
+#, no-c-format
+msgid "How do I speed up spatial queries on large tables?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:188
+#, no-c-format
+msgid ""
+"Fast queries on large tables is the <emphasis>raison d'etre</emphasis> of "
+"spatial databases (along with transaction support) so having a good index is "
+"important."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:192
+#, no-c-format
+msgid ""
+"To build a spatial index on a table with a <varname>geometry</varname> "
+"column, use the \"CREATE INDEX\" function as follows:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:196
+#, no-c-format
+msgid ""
+"CREATE INDEX [indexname] ON [tablename] USING GIST ( [geometrycolumn] );"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:198
+#, no-c-format
+msgid ""
+"The \"USING GIST\" option tells the server to use a GiST (Generalized Search "
+"Tree) index."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:202
+#, no-c-format
+msgid ""
+"GiST indexes are assumed to be lossy. Lossy indexes uses a proxy object (in "
+"the spatial case, a bounding box) for building the index."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:207
+#, no-c-format
+msgid ""
+"You should also ensure that the PostgreSQL query planner has enough "
+"information about your index to make rational decisions about when to use "
+"it. To do this, you have to \"gather statistics\" on your geometry tables."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:212
+#, no-c-format
+msgid ""
+"For PostgreSQL 8.0.x and greater, just run the <command>VACUUM ANALYZE</"
+"command> command."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:215
+#, no-c-format
+msgid ""
+"For PostgreSQL 7.4.x and below, run the <command>SELECT "
+"UPDATE_GEOMETRY_STATS()</command> command."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:222
+#, no-c-format
+msgid "Why aren't PostgreSQL R-Tree indexes supported?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:226
+#, no-c-format
+msgid ""
+"Early versions of PostGIS used the PostgreSQL R-Tree indexes. However, "
+"PostgreSQL R-Trees have been completely discarded since version 0.6, and "
+"spatial indexing is provided with an R-Tree-over-GiST scheme."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:231
+#, no-c-format
+msgid ""
+"Our tests have shown search speed for native R-Tree and GiST to be "
+"comparable. Native PostgreSQL R-Trees have two limitations which make them "
+"undesirable for use with GIS features (note that these limitations are due "
+"to the current PostgreSQL native R-Tree implementation, not the R-Tree "
+"concept in general):"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:239
+#, no-c-format
+msgid ""
+"R-Tree indexes in PostgreSQL cannot handle features which are larger than 8K "
+"in size. GiST indexes can, using the \"lossy\" trick of substituting the "
+"bounding box for the feature itself."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:246
+#, no-c-format
+msgid ""
+"R-Tree indexes in PostgreSQL are not \"null safe\", so building an index on "
+"a geometry column which contains null geometries will fail."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:256
+#, no-c-format
+msgid ""
+"Why should I use the <varname>AddGeometryColumn()</varname> function and all "
+"the other OpenGIS stuff?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:261
+#, no-c-format
+msgid ""
+"If you do not want to use the OpenGIS support functions, you do not have to. "
+"Simply create tables as in older versions, defining your geometry columns in "
+"the CREATE statement. All your geometries will have SRIDs of -1, and the "
+"OpenGIS meta-data tables will <emphasis>not</emphasis> be filled in "
+"properly. However, this will cause most applications based on PostGIS to "
+"fail, and it is generally suggested that you do use "
+"<varname>AddGeometryColumn()</varname> to create geometry tables."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:270
+#, no-c-format
+msgid ""
+"MapServer is one application which makes use of the "
+"<varname>geometry_columns</varname> meta-data. Specifically, MapServer can "
+"use the SRID of the geometry column to do on-the-fly reprojection of "
+"features into the correct map projection."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:279
+#, no-c-format
+msgid ""
+"What is the best way to find all objects within a radius of another object?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:284
+#, no-c-format
+msgid ""
+"To use the database most efficiently, it is best to do radius queries which "
+"combine the radius test with a bounding box test: the bounding box test uses "
+"the spatial index, giving fast access to a subset of data which the radius "
+"test is then applied to."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:289
+#, no-c-format
+msgid ""
+"The <varname>ST_DWithin(geometry, geometry, distance)</varname> function is "
+"a handy way of performing an indexed distance search. It works by creating a "
+"search rectangle large enough to enclose the distance radius, then "
+"performing an exact distance search on the indexed subset of results."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:295
+#, no-c-format
+msgid ""
+"For example, to find all objects with 100 meters of POINT(1000 1000) the "
+"following query would work well:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:298
+#, no-c-format
+msgid ""
+"SELECT * FROM geotable \n"
+"WHERE ST_DWithin(geocolumn, 'POINT(1000 1000)', 100.0);"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:304
+#, no-c-format
+msgid "How do I perform a coordinate reprojection as part of a query?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:309
+#, no-c-format
+msgid ""
+"To perform a reprojection, both the source and destination coordinate "
+"systems must be defined in the SPATIAL_REF_SYS table, and the geometries "
+"being reprojected must already have an SRID set on them. Once that is done, "
+"a reprojection is as simple as referring to the desired destination SRID. "
+"The below projects a geometry to NAD 83 long lat. The below will only work "
+"if the srid of the_geom is not -1 (not undefined spatial ref)"
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:316
+#, no-c-format
+msgid "SELECT ST_Transform(the_geom,4269) FROM geotable;"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:322
+#, no-c-format
+msgid ""
+"I did an ST_AsEWKT and ST_AsText on my rather large geometry and it returned "
+"blank field. What gives?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:326
+#, no-c-format
+msgid ""
+"You are probably using PgAdmin or some other tool that doesn't output large "
+"text. If your geometry is big enough, it will appear blank in these tools. "
+"Use PSQL if you really need to see it or output it in WKT."
+msgstr ""
+
+#. Tag: programlisting
+#: faq.xml:329
+#, no-c-format
+msgid ""
+"--To check number of geometries are really blank\n"
+" SELECT count(gid) FROM geotable WHERE "
+"the_geom IS NULL;"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:335
+#, no-c-format
+msgid ""
+"When I do an ST_Intersects, it says my two geometries don't intersect when I "
+"KNOW THEY DO. What gives?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:339
+#, no-c-format
+msgid ""
+"This generally happens in two common cases. Your geometry is invalid -- "
+"check <xref linkend=\"ST_IsValid\"/> or you are assuming they intersect "
+"because ST_AsText truncates the numbers and you have lots of decimals after "
+"it is not showing you."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:347
+#, no-c-format
+msgid ""
+"I am releasing software that uses PostGIS, does that mean my software has to "
+"be licensed using the GPL like PostGIS? Will I have to publish all my code "
+"if I use PostGIS?"
+msgstr ""
+
+#. Tag: para
+#: faq.xml:351
+#, no-c-format
+msgid ""
+"Almost certainly not. As an example, consider Oracle database running on "
+"Linux. Linux is GPL, Oracle is not, does Oracle running on Linux have to be "
+"distributed using the GPL? No. So your software can use a PostgreSQL/PostGIS "
+"database as much as it wants and be under any license you like."
+msgstr ""
+
+#. Tag: para
+#: faq.xml:352
+#, no-c-format
+msgid ""
+"The only exception would be if you made changes to the PostGIS source code, "
+"and distributed your changed version of PostGIS. In that case you would have "
+"to share the code of your changed PostGIS (but not the code of applications "
+"running on top of it). Even in this limited case, you would still only have "
+"to distribute source code to people you distributed binaries to. The GPL "
+"does not require that you <emphasis>publish</emphasis> your source code, "
+"only that you share it with people you give binaries to."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: faq_raster.xml:3
+#, no-c-format
+msgid "PostGIS Raster Frequently Asked Questions"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:9
+#, no-c-format
+msgid "Where can I find out more about the PostGIS Raster Project?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:13
+#, no-c-format
+msgid ""
+"Refer to the <ulink url=\"http://trac.osgeo.org/postgis/wiki/WKTRaster"
+"\">PostGIS Raster home page</ulink>."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:19
+#, no-c-format
+msgid ""
+"Are there any books or tutorials to get me started with this wonderful "
+"invention?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:23
+#, no-c-format
+msgid ""
+"There is a full length beginner tutorial <ulink url=\"http://trac.osgeo.org/"
+"postgis/wiki/WKTRasterTutorial01\"> Intersecting vector buffers with large "
+"raster coverage using PostGIS Raster</ulink>. Jorge has a series of blog "
+"articles on PostGIS Raster that demonstrate how to load raster data as well "
+"as cross compare to same tasks in Oracle GeoRaster. Check out <ulink url="
+"\"http://gis4free.wordpress.com/category/postgis-raster/\">Jorge's PostGIS "
+"Raster / Oracle GeoRaster Series</ulink>. There is a whole chapter (more "
+"than 35 pages of content) dedicated to PostGIS Raster with free code and "
+"data downloads at <ulink url=\"http://www.postgis.us/chapter_13\">PostGIS in "
+"Action - Raster chapter</ulink>. You can <ulink url=\"http://www.postgis.us/"
+"page_buy_book\">buy PostGIS in Action</ulink> now from Manning in hard-copy "
+"(significant discounts for bulk purchases) or just the E-book format. You "
+"can also buy from Amazon and various other book distributors. All hard-copy "
+"books come with a free coupon to download the E-book version."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:30
+#, no-c-format
+msgid ""
+"Here is a review from a PostGIS Raster user <ulink url=\"http://"
+"fuzzytolerance.info/code/postgis-raster-ftw/\">PostGIS raster applied to "
+"land classification urban forestry</ulink>"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:37
+#, no-c-format
+msgid "How do I install Raster support in my PostGIS database?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:41
+#, no-c-format
+msgid ""
+"The easiest is to download binaries for PostGIS and Raster which are "
+"currently available for windows and latest versions of Mac OSX. First you "
+"need a working PostGIS 2.0.0 or above and be running PostgreSQL 8.4, 9.0, or "
+"9.1. Note in PostGIS 2.0 PostGIS Raster is fully integrated, so it will be "
+"compiled when you compile PostGIS."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:43
+#, no-c-format
+msgid ""
+"Instructions for installing and running under windows are available at "
+"<ulink url=\"http://gis4free.wordpress.com/2011/03/10/how-to-install-and-"
+"configure-postgis-raster-on-windows/\">How to Install and Configure PostGIS "
+"raster on windows</ulink>"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:44
+#, no-c-format
+msgid ""
+"If you are on windows, you can compile yourself, or use the <ulink url="
+"\"http://www.postgis.org/download/windows/experimental.php#wktraster\">pre-"
+"compiled PostGIS Raster windows binaries</ulink>. If you are on Mac OSX "
+"Leopard or Snow Leopard, there are binaries available at <ulink url=\"http://"
+"www.kyngchaos.com/software/postgres\">Kyng Chaos Mac OSX PostgreSQL/GIS "
+"binaries</ulink>."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:50
+#, no-c-format
+msgid ""
+"Then to enable raster support in your database, run the rtpostgis.sql file "
+"in your database. To upgrade an existing install use "
+"rtpostgis_upgrade_minor..sql instead of rtpostgis.sql"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:51
+#, no-c-format
+msgid ""
+"For other platforms, you generally need to compile yourself. Dependencies "
+"are PostGIS and GDAL. For more details about compiling from source, please "
+"refer to <ulink url=\"http://trac.osgeo.org/postgis/wiki/WKTRaster/"
+"Documentation01#a2.3-CompilingandInstallingfromSources\">Installing PostGIS "
+"Raster from source (in prior versions of PostGIS)</ulink>"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:57
+#, no-c-format
+msgid ""
+"I get error could not load library \"C:/Program Files/PostgreSQL/8.4/lib/"
+"rtpostgis.dll\": The specified module could not be found. or could not load "
+"library on Linux when trying to run rtpostgis.sql"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:62
+#, no-c-format
+msgid ""
+"rtpostgis.so/dll is built with dependency on libgdal.dll/so. Make sure for "
+"Windows you have libgdal-1.dll in the bin folder of your PostgreSQL install. "
+"For Linux libgdal has to be in your path or bin folder."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:64
+#, no-c-format
+msgid ""
+"You may also run into different errors if you don't have PostGIS installed "
+"in your database. Make sure to install PostGIS first in your database before "
+"trying to install the raster support."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:71
+#, no-c-format
+msgid "How do I load Raster data into PostGIS?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:75
+#, no-c-format
+msgid ""
+"The latest version of PostGIS comes packaged with a <varname>raster2pgsql</"
+"varname> raster loader executable capable of loading many kinds of rasters "
+"and also generating lower resolution overviews without any additional "
+"software. Please refer to <xref linkend=\"RT_Raster_Loader\"/> for more "
+"details. Pre-2.0 versions came with a <varname>raster2pgsql.py</varname> "
+"that required python with numpy and GDAL. This is no longer needed."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:81
+#, no-c-format
+msgid "What kind of raster file formats can I load into my database?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:85
+#, no-c-format
+msgid ""
+"Any that your GDAL library supports. GDAL supported formats are documented "
+"<ulink url=\"http://www.gdal.org/formats_list.html\">GDAL File Formats</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:86
+#, no-c-format
+msgid ""
+"Your particular GDAL install may not support all formats. To verify the ones "
+"supported by your particular GDAL install, you can use"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:87
+#, no-c-format
+msgid "raster2pgsql -G"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:93
+#, no-c-format
+msgid "Can I export my PostGIS raster data to other raster formats?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:97
+#, no-c-format
+msgid "<para>Yes</para>"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:98
+#, no-c-format
+msgid ""
+"GDAL 1.7+ has a PostGIS raster driver, but is only compiled in if you choose "
+"to compile with PostgreSQL support."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:99
+#, no-c-format
+msgid ""
+"The driver currently doesn't support irregularly blocked rasters, although "
+"you can store irregularly blocked rasters in PostGIS raster data type."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:101
+#, no-c-format
+msgid ""
+"If you are compiling from source, you need to include in your configure "
+"<programlisting>--with-pg=path/to/pg_config</programlisting> to enable the "
+"driver. Refer to <ulink url=\"http://trac.osgeo.org/gdal/wiki/BuildHints"
+"\">GDAL Build Hints</ulink> for tips on building GDAL against in various OS "
+"platforms."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:106
+#, no-c-format
+msgid ""
+"If your version of GDAL is compiled with the PostGIS Raster driver you "
+"should see PostGIS Raster in list when you do"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:108
+#, no-c-format
+msgid "gdalinfo --formats"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:110
+#, no-c-format
+msgid "To get a summary about your raster via GDAL use gdalinfo:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:111
+#, no-c-format
+msgid ""
+"gdalinfo \"PG:host=localhost port=5432 dbname='mygisdb' user='postgres' "
+"password='whatever' schema='someschema' table=sometable\""
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:114
+#, no-c-format
+msgid ""
+"To export data to other raster formats, use gdal_translate the below will "
+"export all data from a table to a PNG file at 10% size."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:116
+#, no-c-format
+msgid ""
+"Depending on your pixel band types, some translations may not work if the "
+"export format does not support that Pixel type. For example floating point "
+"band types and 32 bit unsigned ints will not translate easily to JPG or some "
+"others."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:119
+#, no-c-format
+msgid "Here is an example simple translation"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:120
+#, no-c-format
+msgid ""
+"gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost dbname='mygisdb' "
+"user='postgres' password=whatever' schema='someschema' table=sometable\" C:"
+"\\somefile.png"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:121
+#, no-c-format
+msgid ""
+"You can also use SQL where clauses in your export using the where=... in "
+"your driver connection string. Below are some using a where clause"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:123
+#, no-c-format
+msgid ""
+"gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost dbname='mygisdb' "
+"user='postgres' password=whatever' schema='someschema' table=sometable where="
+"\"owner='jimmy'\" \" C:\\somefile.png"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:124
+#, no-c-format
+msgid ""
+"gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost dbname='mygisdb' "
+"user='postgres' password=whatever' schema='someschema' table=sometable "
+"where='ST_Intersects(rast, ST_SetSRID(ST_Point(-71.032,42.3793),4326) )' \" "
+"C:\\intersectregion.png"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:125
+#, no-c-format
+msgid ""
+"To see more examples and syntax refer to <ulink url=\"http://trac.osgeo.org/"
+"gdal/wiki/frmts_wtkraster.html#a3.2-Readingrasterdatafromthedatabase"
+"\">Reading Raster Data of PostGIS Raster section</ulink>"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:130
+#, no-c-format
+msgid ""
+"Are their binaries of GDAL available already compiled with PostGIS Raster "
+"suppport?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:132
+#, no-c-format
+msgid ""
+"Yes. Check out the page <ulink url=\"http://trac.osgeo.org/gdal/wiki/"
+"DownloadingGdalBinaries\">GDAL Binaries</ulink> page. Any compiled with "
+"PostgreSQL support should have PostGIS Raster in them."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:134
+#, no-c-format
+msgid ""
+"We know for sure the following windows binaries have PostGIS Raster built in."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:135
+#, no-c-format
+msgid ""
+"<ulink url=\"http://fwtools.maptools.org/\">FWTools latest stable version "
+"for Windows is compiled with Raster support</ulink>."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:136
+#, no-c-format
+msgid ""
+"PostGIS Raster is undergoing many changes. If you want to get the latest "
+"nightly build for Windows -- then check out the Tamas Szekeres nightly "
+"builds built with Visual Studio which contain GDAL trunk, Python Bindings "
+"and MapServer executables and PostGIS Raster driver built-in. Just click the "
+"SDK bat and run your commands from there. <ulink url=\"http://vbkto.dyndns."
+"org/sdk/\">http://vbkto.dyndns.org/sdk/</ulink>. Also available are VS "
+"project files."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:145
+#, no-c-format
+msgid "What tools can I use to view PostGIS raster data?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:149
+#, no-c-format
+msgid ""
+"You can use MapServer compiled with GDAL 1.7+ and PostGIS Raster driver "
+"support to view Raster data. QuantumGIS (QGIS) now supports viewing of "
+"PostGIS Raster if you have PostGIS raster driver installed."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:151
+#, no-c-format
+msgid ""
+"In theory any tool that renders data using GDAL can support PostGIS raster "
+"data or support it with fairly minimal effort. Again for Windows, Tamas' "
+"binaries <ulink url=\"http://vbkto.dyndns.org/sdk/\">http://vbkto.dyndns.org/"
+"sdk/</ulink> are a good choice if you don't want the hassle of having to "
+"setup to compile your own."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:158
+#, no-c-format
+msgid "How can I add a PostGIS raster layer to my MapServer map?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:162
+#, no-c-format
+msgid ""
+"First you need GDAL 1.7 or higher compiled with PostGIS raster support. GDAL "
+"1.8 or above is preferred since many issues have been fixed in 1.8 and more "
+"PostGIS raster issues fixed in trunk version."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:164
+#, no-c-format
+msgid ""
+"You can much like you can with any other raster. Refer to <ulink url="
+"\"http://mapserver.org/input/raster.html\">MapServer Raster processing "
+"options</ulink> for list of various processing functions you can use with "
+"MapServer raster layers."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:167
+#, no-c-format
+msgid ""
+"What makes PostGIS raster data particularly interesting, is that since each "
+"tile can have various standard database columns, you can segment it in your "
+"data source"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:169
+#, no-c-format
+msgid ""
+"Below is an example of how you would define a PostGIS raster layer in "
+"MapServer."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:170
+#, no-c-format
+msgid ""
+"The mode=2 is required for tiled rasters and was added in PostGIS 2.0 and "
+"GDAL 1.8 drivers. This does not exist in GDAL 1.7 drivers."
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:171
+#, no-c-format
+msgid ""
+"-- displaying raster with standard raster options\n"
+"LAYER\n"
+" NAME coolwktraster\n"
+" TYPE raster\n"
+" STATUS ON\n"
+" DATA \"PG:host=localhost port=5432 dbname='somedb' user='someuser' "
+"password='whatever' \n"
+" schema='someschema' table='cooltable' mode='2'\" \n"
+" PROCESSING \"NODATA=0\"\n"
+" PROCESSING \"SCALE=AUTO\"\n"
+" #... other standard raster processing functions here\n"
+" #... classes are optional but useful for 1 band data\n"
+" CLASS\n"
+" NAME \"boring\"\n"
+" EXPRESSION ([pixel] < 20)\n"
+" COLOR 250 250 250\n"
+" END\n"
+" CLASS\n"
+" NAME \"mildly interesting\"\n"
+" EXPRESSION ([pixel] > 20 AND [pixel] < 1000)\n"
+" COLOR 255 0 0\n"
+" END\n"
+" CLASS\n"
+" NAME \"very interesting\"\n"
+" EXPRESSION ([pixel] >= 1000)\n"
+" COLOR 0 255 0\n"
+" END\n"
+"END"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:173
+#, no-c-format
+msgid ""
+"-- displaying raster with standard raster options and a where clause\n"
+"LAYER\n"
+" NAME soil_survey2009\n"
+" TYPE raster\n"
+" STATUS ON\n"
+" DATA \"PG:host=localhost port=5432 dbname='somedb' user='someuser' "
+"password='whatever' \n"
+" schema='someschema' table='cooltable' "
+"where='survey_year=2009' mode='2'\" \n"
+" PROCESSING \"NODATA=0\"\n"
+" #... other standard raster processing functions here\n"
+" #... classes are optional but useful for 1 band data\n"
+"END"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:181
+#, no-c-format
+msgid "What functions can I currently use with my raster data?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:185
+#, no-c-format
+msgid ""
+"Refer to the list of <xref linkend=\"RT_reference\"/>. There are more, but "
+"this is still a work in progress."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:187
+#, no-c-format
+msgid ""
+"Refer to the <ulink url=\"http://trac.osgeo.org/postgis/wiki/WKTRaster/"
+"PlanningAndFunding\">PostGIS Raster roadmap page</ulink> for details of what "
+"you can expect in the future."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:195
+#, no-c-format
+msgid ""
+"I am getting error ERROR: function st_intersects(raster, unknown) is not "
+"unique or st_union(geometry,text) is not unique. How do I fix?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:199
+#, no-c-format
+msgid ""
+"The function is not unique error happens if one of your arguments is a "
+"textual representation of a geometry instead of a geometry. In these cases, "
+"PostgreSQL marks the textual representation as an unknown type, which means "
+"it can fall into the st_intersects(raster, geometry) or st_intersects(raster,"
+"raster) thus resulting in a non-unique case since both functions can in "
+"theory support your request. To prevent this, you need to cast the geometry "
+"to a geometry."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:200
+#, no-c-format
+msgid "For example if your code looks like this:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:201
+#, no-c-format
+msgid ""
+"SELECT rast\n"
+" FROM my_raster\n"
+" WHERE ST_Intersects(rast, 'SRID=4326;POINT(-10 10)');"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:202
+#, no-c-format
+msgid ""
+"Cast the textual geometry representation to a geometry by changing your code "
+"to this:"
+msgstr ""
+
+#. Tag: programlisting
+#: faq_raster.xml:203
+#, no-c-format
+msgid ""
+"SELECT rast\n"
+" FROM my_raster\n"
+" WHERE ST_Intersects(rast, 'SRID=4326;POINT(-10 10)'::geometry);"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:211
+#, no-c-format
+msgid ""
+"How is PostGIS Raster different from Oracle GeoRaster (SDO_GEORASTER) and "
+"SDO_RASTER types?"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:215
+#, no-c-format
+msgid ""
+"For a more extensive discussion on this topic, check out Jorge Arévalo "
+"<ulink url=\"http://gis4free.wordpress.com/2010/07/19/oracle-georaster-part-"
+"i/\">Oracle GeoRaster and PostGIS Raster: First impressions </ulink>"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:216
+#, no-c-format
+msgid ""
+"The major advantage of one-georeference-by-raster over one-georeference-by-"
+"layer is to allow:"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:217
+#, no-c-format
+msgid ""
+"* coverages to be not necessarily rectangular (which is often the case of "
+"raster coverage covering large extents. See the possible raster arrangements "
+"in the documentation)"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:218
+#, no-c-format
+msgid ""
+"* rasters to overlaps (which is necessary to implement lossless vector to "
+"raster conversion)"
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:219
+#, no-c-format
+msgid ""
+"These arrangements are possible in Oracle as well, but they imply the "
+"storage of multiple SDO_GEORASTER objects linked to as many SDO_RASTER "
+"tables. A complex coverage can lead to hundreds of tables in the database. "
+"With PostGIS Raster you can store a similar raster arrangement into a unique "
+"table."
+msgstr ""
+
+#. Tag: para
+#: faq_raster.xml:224
+#, no-c-format
+msgid ""
+"It's a bit like if PostGIS would force you to store only full rectangular "
+"vector coverage without gaps or overlaps (a perfect rectangular topological "
+"layer). This is very practical in some applications but practice has shown "
+"that it is not realistic or desirable for most geographical coverages. "
+"Vector structures needs the flexibility to store discontinuous and non-"
+"rectangular coverages. We think it is a big advantage that raster structure "
+"should benefit as well."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-10-12 07:23+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: installation.xml:3 installation.xml:231 installation.xml:640
+#, no-c-format
+msgid "Installation"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:5
+#, no-c-format
+msgid "This chapter details the steps required to install PostGIS."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:10
+#, no-c-format
+msgid "Short Version"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:11
+#, no-c-format
+msgid ""
+"The raster support is currently optional, but installed by default. For "
+"installing using the PostgreSQL 9.1+ extensions model it is required. Please "
+"refer to <xref linkend=\"make_install_postgis_extensions\"/> if you are "
+"using PostgreSQL 9.1+."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:13
+#, no-c-format
+msgid ""
+"All the .sql files once installed will be installed in share/contrib/postgis-"
+"&last_release_version; folder of your PostgreSQL install"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:15
+#, no-c-format
+msgid ""
+"The <varname>postgis_comments.sql</varname>, <varname>raster_comments.sql</"
+"varname>, <varname>topology_comments.sql</varname> generate quick help tips "
+"for each function that can be accessed via pgAdmin III or psql. In psql with "
+"a command of the form e.g.<varname>\\dd ST_SetPoint</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:17
+#, no-c-format
+msgid ""
+"tar xvfz postgis-&last_release_version;.tar.gz\n"
+"cd postgis-&last_release_version;\n"
+"./configure --with-raster --with-topology --with-gui\n"
+"make\n"
+"make install\n"
+"createdb yourdatabase\n"
+"createlang plpgsql yourdatabase\n"
+"psql -d yourdatabase -f postgis.sql\n"
+"psql -d yourdatabase -f postgis_comments.sql\n"
+"psql -d yourdatabase -f spatial_ref_sys.sql\n"
+"psql -d yourdatabase -f rtpostgis.sql\n"
+"psql -d yourdatabase -f raster_comments.sql\n"
+"psql -d yourdatabase -f topology/topology.sql\n"
+"psql -d yourdatabase -f doc/topology_comments.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:18
+#, no-c-format
+msgid ""
+"<filename>topology_comments.sql</filename> since its an optional feature is "
+"not installed by <command>make install</command> or <command>make comments-"
+"install</command>. However if you do a <command>make comments</command> or "
+"<command>make topology_comments.sql</command>, it will be generated in the "
+"docs folder"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:27
+#, no-c-format
+msgid ""
+"The rest of this chapter goes into detail each of the above installation "
+"steps."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:34
+#, no-c-format
+msgid "Requirements"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:36
+#, no-c-format
+msgid "PostGIS has the following requirements for building and usage:"
+msgstr ""
+
+#. Tag: emphasis
+#: installation.xml:41
+#, no-c-format
+msgid "Required"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:46
+#, no-c-format
+msgid ""
+"PostgreSQL &min_postgres_version; or higher. A complete installation of "
+"PostgreSQL (including server headers) is required. PostgreSQL is available "
+"from <ulink url=\"http://www.postgresql.org\"> http://www.postgresql.org </"
+"ulink> ."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:55
+#, no-c-format
+msgid ""
+"For a full PostgreSQL / PostGIS support matrix and PostGIS/GEOS support "
+"matrix refer to <ulink url=\"http://trac.osgeo.org/postgis/wiki/"
+"UsersWikiPostgreSQLPostGIS\">http://trac.osgeo.org/postgis/wiki/"
+"UsersWikiPostgreSQLPostGIS</ulink>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:61
+#, no-c-format
+msgid ""
+"GNU C compiler (<filename>gcc</filename>). Some other ANSI C compilers can "
+"be used to compile PostGIS, but we find far fewer problems when compiling "
+"with <filename>gcc</filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:69
+#, no-c-format
+msgid ""
+"GNU Make (<filename>gmake</filename> or <filename>make</filename>). For many "
+"systems, GNU <filename>make</filename> is the default version of make. Check "
+"the version by invoking <filename>make -v</filename>. Other versions of "
+"<filename>make</filename> may not process the PostGIS <filename>Makefile</"
+"filename> properly."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:79
+#, no-c-format
+msgid ""
+"Proj4 reprojection library, version 4.6.0 or greater. The Proj4 library is "
+"used to provide coordinate reprojection support within PostGIS. Proj4 is "
+"available for download from <ulink url=\"http://trac.osgeo.org/proj/\"> "
+"http://trac.osgeo.org/proj/ </ulink> ."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:91
+#, no-c-format
+msgid ""
+"GEOS geometry library, version 3.3 or greater, but GEOS 3.4+ is recommended "
+"to take full advantage of all the new functions and features. Without GEOS "
+"3.4, you will be missing some major enhancements such as ST_Triangles and "
+"long-running function interruption, and improvements to geometry validation "
+"and making geometries valid such as ST_ValidDetail and ST_MakeValid. GEOS "
+"3.3.2+ is also required for topology support. GEOS is available for download "
+"from <ulink url=\"http://trac.osgeo.org/geos/\"> http://trac.osgeo.org/geos/ "
+"</ulink> and 3.4+ is backward-compatible with older versions so fairly safe "
+"to upgrade."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:101
+#, no-c-format
+msgid ""
+"LibXML2, version 2.5.x or higher. LibXML2 is currently used in some imports "
+"functions (ST_GeomFromGML and ST_GeomFromKML). LibXML2 is available for "
+"download from <ulink url=\"http://xmlsoft.org/downloads.html\">http://"
+"xmlsoft.org/downloads.html</ulink>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:108
+#, no-c-format
+msgid ""
+"JSON-C, version 0.9 or higher. JSON-C is currently used to import GeoJSON "
+"via the function ST_GeomFromGeoJson. JSON-C is available for download from "
+"<ulink url=\"http://oss.metaparadigm.com/json-c/\">http://oss.metaparadigm."
+"com/json-c/</ulink>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:116
+#, no-c-format
+msgid ""
+"GDAL, version 1.8 or higher (1.9 or higher is strongly recommended since "
+"some things will not work well or behavior differently with lower versions). "
+"This is required for raster support. <ulink url=\"http://trac.osgeo.org/gdal/"
+"wiki/DownloadSource\">http://trac.osgeo.org/gdal/wiki/DownloadSource</ulink>."
+msgstr ""
+
+#. Tag: emphasis
+#: installation.xml:124
+#, no-c-format
+msgid "Optional"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:129
+#, no-c-format
+msgid ""
+"GTK (requires GTK+2.0, 2.8+) to compile the shp2pgsql-gui shape file loader. "
+"<ulink url=\"http://www.gtk.org/\"> http://www.gtk.org/ </ulink> ."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:139
+#, no-c-format
+msgid ""
+"CUnit (<filename>CUnit</filename>). This is needed for regression testing. "
+"<ulink url=\"http://cunit.sourceforge.net/\">http://cunit.sourceforge.net/</"
+"ulink>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:145
+#, no-c-format
+msgid ""
+"Apache Ant (<filename>ant</filename>) is required for building any of the "
+"drivers under the <filename>java</filename> directory. Ant is available from "
+"<ulink url=\"http://ant.apache.org\"> http://ant.apache.org </ulink> ."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:157
+#, no-c-format
+msgid ""
+"DocBook (<filename>xsltproc</filename>) is required for building the "
+"documentation. Docbook is available from <ulink url=\"http://www.docbook.org/"
+"\"> http://www.docbook.org/ </ulink> ."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:168
+#, no-c-format
+msgid ""
+"DBLatex (<filename>dblatex</filename>) is required for building the "
+"documentation in PDF format. DBLatex is available from <ulink url=\"http://"
+"dblatex.sourceforge.net/\"> http://dblatex.sourceforge.net/ </ulink> ."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:179
+#, no-c-format
+msgid ""
+"ImageMagick (<filename>convert</filename>) is required to generate the "
+"images used in the documentation. ImageMagick is available from <ulink url="
+"\"http://www.imagemagick.org/\"> http://www.imagemagick.org/ </ulink> ."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:192
+#, no-c-format
+msgid "Getting the Source"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:194
+#, no-c-format
+msgid ""
+"Retrieve the PostGIS source archive from the downloads website <ulink url="
+"\"http://www.postgis.org/download/postgis-&last_release_version;.tar.gz\"> "
+"http://www.postgis.org/download/postgis-&last_release_version;.tar.gz </"
+"ulink>"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:201
+#, no-c-format
+msgid ""
+"wget http://www.postgis.org/download/postgis-&last_release_version;.tar.gz\n"
+"tar -xvzf postgis-&last_release_version;.tar.gz"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:203
+#, no-c-format
+msgid ""
+"This will create a directory called <varname>postgis-&last_release_version;</"
+"varname> in the current working directory."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:209
+#, no-c-format
+msgid ""
+"Alternatively, checkout the source from the <ulink url=\"http://subversion."
+"apache.org/\"> svn </ulink> repository <ulink url=\"http://svn.osgeo.org/"
+"postgis/trunk/\"> http://svn.osgeo.org/postgis/trunk/ </ulink> ."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:221
+#, no-c-format
+msgid ""
+"svn checkout http://svn.osgeo.org/postgis/trunk/ postgis-"
+"&last_release_version;"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:223
+#, no-c-format
+msgid ""
+"Change into the newly created <varname>postgis-&last_release_version;</"
+"varname> directory to continue the installation."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:234
+#, no-c-format
+msgid ""
+"Many OS systems now include pre-built packages for PostgreSQL/PostGIS. In "
+"many cases compilation is only necessary if you want the most bleeding edge "
+"versions or you are a package maintainer."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:239
+#, no-c-format
+msgid ""
+"This section includes general compilation instructions, if you are compiling "
+"for Windows etc or another OS, you may find additional more detailed help at "
+"<ulink url=\"http://trac.osgeo.org/postgis/wiki/UsersWikiInstall\">PostGIS "
+"User contributed compile guides</ulink> and <ulink url=\"http://trac.osgeo."
+"org/postgis/wiki/DevWikiMain\">PostGIS Dev Wiki</ulink>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:241
+#, no-c-format
+msgid ""
+"Pre-Built Packages for various OS are listed in <ulink url=\"http://trac."
+"osgeo.org/postgis/wiki/UsersWikiPackages\">PostGIS Pre-built Packages</ulink>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:242
+#, no-c-format
+msgid ""
+"If you are a windows user, you can get stable builds via Stackbuilder or "
+"<ulink url=\"http://www.postgis.org/download/windows/\">PostGIS Windows "
+"download site</ulink> We also have <ulink url=\"http://www.postgis.org/"
+"download/windows/experimental.php\">very bleeding-edge windows experimental "
+"builds</ulink> that are built usually once or twice a week or whenever "
+"anything exciting happens. You can use these to experiment with the in "
+"progress releases of PostGIS"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:247
+#, no-c-format
+msgid ""
+"The PostGIS module is an extension to the PostgreSQL backend server. As "
+"such, PostGIS &last_release_version; <emphasis>requires</emphasis> full "
+"PostgreSQL server headers access in order to compile. It can be built "
+"against PostgreSQL versions &min_postgres_version; or higher. Earlier "
+"versions of PostgreSQL are <emphasis>not</emphasis> supported."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:255
+#, no-c-format
+msgid ""
+"Refer to the PostgreSQL installation guides if you haven't already installed "
+"PostgreSQL. <ulink url=\"http://www.postgresql.org\"> http://www.postgresql."
+"org </ulink> ."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:265
+#, no-c-format
+msgid ""
+"For GEOS functionality, when you install PostgresSQL you may need to "
+"explicitly link PostgreSQL against the standard C++ library:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:270
+#, no-c-format
+msgid "LDFLAGS=-lstdc++ ./configure [YOUR OPTIONS HERE]"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:272
+#, no-c-format
+msgid ""
+"This is a workaround for bogus C++ exceptions interaction with older "
+"development tools. If you experience weird problems (backend unexpectedly "
+"closed or similar things) try this trick. This will require recompiling your "
+"PostgreSQL from scratch, of course."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:280
+#, no-c-format
+msgid ""
+"The following steps outline the configuration and compilation of the PostGIS "
+"source. They are written for Linux users and will not work on Windows or Mac."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:287
+#, no-c-format
+msgid "Configuration"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:289
+#, no-c-format
+msgid ""
+"As with most linux installations, the first step is to generate the Makefile "
+"that will be used to build the source code. This is done by running the "
+"shell script"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:299
+#, no-c-format
+msgid ""
+"With no additional parameters, this command will attempt to automatically "
+"locate the required components and libraries needed to build the PostGIS "
+"source code on your system. Although this is the most common usage of "
+"<command>./configure</command>, the script accepts several parameters for "
+"those who have the required libraries and programs in non-standard locations."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:308
+#, no-c-format
+msgid ""
+"The following list shows only the most commonly used parameters. For a "
+"complete list, use the <command>--help</command> or <command>--help=short</"
+"command> parameters."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:318
+#, no-c-format
+msgid ""
+"This is the location the PostGIS libraries and SQL scripts will be installed "
+"to. By default, this location is the same as the detected PostgreSQL "
+"installation."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:325
+#, no-c-format
+msgid ""
+"This parameter is currently broken, as the package will only install into "
+"the PostgreSQL installation directory. Visit <ulink url=\"http://trac.osgeo."
+"org/postgis/ticket/635\"> http://trac.osgeo.org/postgis/ticket/635 </ulink> "
+"to track this bug."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:340
+#, no-c-format
+msgid ""
+"PostgreSQL provides a utility called <command>pg_config</command> to enable "
+"extensions like PostGIS to locate the PostgreSQL installation directory. Use "
+"this parameter (<command>--with-pgconfig=/path/to/pg_config</command>) to "
+"manually specify a particular PostgreSQL installation that PostGIS will "
+"build against."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:354
+#, no-c-format
+msgid ""
+"GDAL, a required library, provides functionality needed for raster support "
+"<command>gdal-config</command> to enable software installations to locate "
+"the GDAL installation directory. Use this parameter (<command>--with-"
+"gdalconfig=/path/to/gdal-config</command>) to manually specify a particular "
+"GDAL installation that PostGIS will build against."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:368
+#, no-c-format
+msgid ""
+"GEOS, a required geometry library, provides a utility called <command>geos-"
+"config</command> to enable software installations to locate the GEOS "
+"installation directory. Use this parameter (<command>--with-geosconfig=/path/"
+"to/geos-config</command>) to manually specify a particular GEOS installation "
+"that PostGIS will build against."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:382
+#, no-c-format
+msgid ""
+"LibXML is the library required for doing GeomFromKML/GML processes. It "
+"normally is found if you have libxml installed, but if not or you want a "
+"specific version used, you'll need to point PostGIS at a specific "
+"<filename>xml2-config</filename> confi file to enable software installations "
+"to locate the LibXML installation directory. Use this parameter (<command>>--"
+"with-xml2config=/path/to/xml2-config</command>) to manually specify a "
+"particular LibXML installation that PostGIS will build against."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:400
+#, no-c-format
+msgid ""
+"Proj4 is a reprojection library required by PostGIS. Use this parameter "
+"(<command>--with-projdir=/path/to/projdir</command>) to manually specify a "
+"particular Proj4 installation directory that PostGIS will build against."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:412
+#, no-c-format
+msgid "Directory where iconv is installed."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:421
+#, no-c-format
+msgid ""
+"<ulink url=\"http://oss.metaparadigm.com/json-c/\">JSON-C</ulink> is an MIT-"
+"licensed JSON library required by PostGIS ST_GeomFromJSON support. Use this "
+"parameter (<command>--with-jsondir=/path/to/jsondir</command>) to manually "
+"specify a particular JSON-C installation directory that PostGIS will build "
+"against."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:433
+#, no-c-format
+msgid ""
+"Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-"
+"gui graphical interface to shp2pgsql."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:442
+#, no-c-format
+msgid ""
+"Compile with raster support. This will build rtpostgis-"
+"&last_release_version; library and rtpostgis.sql file. This may not be "
+"required in final release as plan is to build in raster support by default."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:451
+#, no-c-format
+msgid ""
+"Compile with topology support. This will build the topology.sql file. There "
+"is no corresponding library as all logic needed for topology is in postgis-"
+"&last_release_version; library."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:460
+#, no-c-format
+msgid ""
+"By default PostGIS will try to detect gettext support and compile with it, "
+"however if you run into incompatibility issues that cause breakage of "
+"loader, you can disable it entirely with this command. Refer to ticket "
+"<ulink url=\"http://trac.osgeo.org/postgis/ticket/748\">http://trac.osgeo."
+"org/postgis/ticket/748</ulink> for an example issue solved by configuring "
+"with this. NOTE: that you aren't missing much by turning this off. This is "
+"used for international help/label support for the GUI loader which is not "
+"yet documented and still experimental."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:470
+#, no-c-format
+msgid ""
+"If you obtained PostGIS from the SVN <ulink url=\"http://svn.osgeo.org/"
+"postgis/trunk/\"> repository </ulink> , the first step is really to run the "
+"script"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:482
+#, no-c-format
+msgid ""
+"This script will generate the <command>configure</command> script that in "
+"turn is used to customize the installation of PostGIS."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:487
+#, no-c-format
+msgid ""
+"If you instead obtained PostGIS as a tarball, running <command>./autogen.sh</"
+"command> is not necessary as <command>configure</command> has already been "
+"generated."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:496
+#, no-c-format
+msgid "Building"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:498
+#, no-c-format
+msgid ""
+"Once the Makefile has been generated, building PostGIS is as simple as "
+"running"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:507
+#, no-c-format
+msgid ""
+"The last line of the output should be \"<code>PostGIS was built "
+"successfully. Ready to install.</code>\""
+msgstr ""
+
+#. Tag: para
+#: installation.xml:512
+#, no-c-format
+msgid ""
+"As of PostGIS v1.4.0, all the functions have comments generated from the "
+"documentation. If you wish to install these comments into your spatial "
+"databases later, run the command which requires docbook. The "
+"postgis_comments.sql and other package comments files raster_comments.sql, "
+"topology_comments.sql are also packaged in the tar.gz distribution in the "
+"doc folder so no need to make comments if installing from the tar ball."
+msgstr ""
+
+#. Tag: command
+#: installation.xml:522 installation.xml:544
+#, no-c-format
+msgid "make comments"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:525
+#, no-c-format
+msgid ""
+"Introduced in PostGIS 2.0. This generates html cheat sheets suitable for "
+"quick reference or for student handouts. This requires xsltproc to build and "
+"will generate 4 files in doc folder <filename>topology_cheatsheet.html</"
+"filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, "
+"<filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet."
+"html</filename>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:530
+#, no-c-format
+msgid ""
+"You can download some pre-built ones available in html and pdf from <ulink "
+"url=\"http://www.postgis.us/study_guides\">PostGIS / PostgreSQL Study "
+"Guides</ulink>"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:533
+#, no-c-format
+msgid "make cheatsheets"
+msgstr ""
+
+#. Tag: title
+#: installation.xml:538
+#, no-c-format
+msgid "Building PostGIS Extensions and Deploying them"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:540
+#, no-c-format
+msgid ""
+"The PostGIS extensions are built and installed automatically if you are "
+"using PostgreSQL 9.1+."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:543
+#, no-c-format
+msgid ""
+"If you are building from source repository, you need to build the function "
+"descriptions first. These get built if you have docbook installed. You can "
+"also manually build with the statement:"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:545
+#, no-c-format
+msgid ""
+"Building the comments is not necessary if you are building from a release "
+"tar ball since these are packaged pre-built with the tar ball already."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:546
+#, no-c-format
+msgid ""
+"If you are building against PostgreSQL 9.1, the extensions should "
+"automatically build as part of the make install process. You can if needed "
+"build from the extensions folders or copy files if you need them on a "
+"different server."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:548
+#, no-c-format
+msgid ""
+"cd extensions\n"
+"cd postgis\n"
+"make clean\n"
+"make \n"
+"make install\n"
+"cd ..\n"
+"cd postgis_topology\n"
+"make clean\n"
+"make \n"
+"make install"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:549
+#, no-c-format
+msgid ""
+"The extension files will always be the same for the same version of PostGIS "
+"regardless of OS, so it is fine to copy over the extension files from one OS "
+"to another as long as you have the PostGIS binaries already installed on "
+"your servers."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:551
+#, no-c-format
+msgid ""
+"If you want to install the extensions manually on a separate server "
+"different from your development, You need to copy the following files from "
+"the extensions folder into the <filename>PostgreSQL / share / extension</"
+"filename> folder of your PostgreSQL install as well as the needed binaries "
+"for regular PostGIS if you don't have them already on the server."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:558
+#, no-c-format
+msgid ""
+"These are the control files that denote information such as the version of "
+"the extension to install if not specified. <filename>postgis.control, "
+"postgis_topology.control</filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:564
+#, no-c-format
+msgid ""
+"All the files in the /sql folder of each extension. Note that these need to "
+"be copied to the root of the PostgreSQL share/extension folder "
+"<filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/"
+"postgis_topology/sql/*.sql</filename>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:570
+#, no-c-format
+msgid ""
+"Once you do that, you should see <varname>postgis</varname>, "
+"<varname>postgis_topology</varname> as available extensions in PgAdmin -> "
+"extensions."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:571
+#, no-c-format
+msgid ""
+"If you are using psql, you can verify that the extensions are installed by "
+"running this query:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:572
+#, no-c-format
+msgid ""
+"SELECT name, default_version,installed_version \n"
+"FROM pg_available_extensions WHERE name LIKE 'postgis%' ;\n"
+" name | default_version | installed_version\n"
+"-----------------+-----------------+-------------------\n"
+"postgis | &last_release_version; | &last_release_version;\n"
+"postgis_topology | &last_release_version; |"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:574
+#, no-c-format
+msgid ""
+"If you have the extension installed in the database you are querying, you'll "
+"see mention in the <varname>installed_version</varname> column. If you get "
+"no records back, it means you don't have postgis extensions installed on the "
+"server at all. PgAdmin III 1.14+ will also provide this information in the "
+"<varname>extensions</varname> section of the database browser tree and will "
+"even allow upgrade or uninstall by right-clicking."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:578
+#, no-c-format
+msgid ""
+"If you have the extensions available, you can install postgis extension in "
+"your database of choice by either using pgAdmin extension interface or "
+"running these sql commands:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:579
+#, no-c-format
+msgid ""
+"CREATE EXTENSION postgis;\n"
+"CREATE EXTENSION postgis_topology;"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:581
+#, no-c-format
+msgid ""
+"Extension tables <varname>spatial_ref_sys</varname>, <varname>layer</"
+"varname>, <varname>topology</varname> can not be explicitly backed up. They "
+"can only be backed up when the respective <varname>postgis</varname> or "
+"<varname>postgis_topology</varname> extension is backed up, which only seems "
+"to happen when you backup the whole database. As of PostGIS 2.0.1, only srid "
+"records not packaged with PostGIS are backed up when the database is backed "
+"up so don't go around changing srids we package and expect your changes to "
+"be there. Put in a ticket if you find an issue. The structures of extension "
+"tables are never backed up since they are created with <code>CREATE "
+"EXTENSION</code> and assumed to be the same for a given version of an "
+"extension. These behaviors are built into the current PostgreSQL extension "
+"model, so nothing we can do about it."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:586
+#, no-c-format
+msgid ""
+"If you installed &last_release_version;, without using our wonderful "
+"extension system, you can change it to be extension based by first upgrading "
+"to the latest micro version running the upgrade scripts: "
+"<filename>postgis_upgrade_20_minor.sql</filename>,"
+"<filename>raster_upgrade_20_minor.sql</filename>,"
+"<filename>topology_upgrade_20_minor.sql</filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:587
+#, no-c-format
+msgid ""
+"If you installed postgis without raster support, you'll need to install "
+"raster support first (using the full <filename>rtpostgis.sql</filename>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:588
+#, no-c-format
+msgid ""
+"Then you can run the below commands to package the functions in their "
+"respective extension."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:589
+#, no-c-format
+msgid ""
+"CREATE EXTENSION postgis FROM unpackaged;\n"
+"CREATE EXTENSION postgis_topology FROM unpackaged;"
+msgstr ""
+
+#. Tag: title
+#: installation.xml:595
+#, no-c-format
+msgid "Testing"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:597
+#, no-c-format
+msgid "If you wish to test the PostGIS build, run"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:602
+#, no-c-format
+msgid "make check"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:605
+#, no-c-format
+msgid ""
+"The above command will run through various checks and regression tests using "
+"the generated library against an actual PostgreSQL database."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:611
+#, no-c-format
+msgid ""
+"If you configured PostGIS using non-standard PostgreSQL, GEOS, or Proj4 "
+"locations, you may need to add their library locations to the "
+"LD_LIBRARY_PATH environment variable."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:619
+#, no-c-format
+msgid ""
+"Currently, the <command>make check</command> relies on the <code>PATH</code> "
+"and <code>PGPORT</code> environment variables when performing the checks - "
+"it does <emphasis>not</emphasis> use the PostgreSQL version that may have "
+"been specified using the configuration parameter <command>--with-pgconfig</"
+"command>. So make sure to modify your PATH to match the detected PostgreSQL "
+"installation during configuration or be prepared to deal with the impending "
+"headaches."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:631
+#, no-c-format
+msgid ""
+"If successful, the output of the test should be similar to the following:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:636
+#, no-c-format
+msgid ""
+"CUnit - A Unit testing framework for C - Version 2.1-0\n"
+" http://cunit.sourceforge.net/\n"
+"\n"
+"\n"
+"Suite: print_suite\n"
+" Test: test_lwprint_default_format ... passed\n"
+" Test: test_lwprint_format_orders ... passed\n"
+" Test: test_lwprint_optional_format ... passed\n"
+" Test: test_lwprint_oddball_formats ... passed\n"
+" Test: test_lwprint_bad_formats ... passed\n"
+"Suite: Misc Suite\n"
+" Test: test_misc_force_2d ... passed\n"
+" Test: test_misc_simplify ... passed\n"
+" Test: test_misc_count_vertices ... passed\n"
+" Test: test_misc_area ... passed\n"
+" Test: test_misc_wkb ... passed\n"
+"Suite: PointArray Suite\n"
+" Test: test_ptarray_append_point ... passed\n"
+" Test: test_ptarray_append_ptarray ... passed\n"
+"Suite: PostGIS Computational Geometry Suite\n"
+" Test: test_lw_segment_side ... passed\n"
+" Test: test_lw_segment_intersects ... passed\n"
+" Test: test_lwline_crossing_short_lines ... passed\n"
+" Test: test_lwline_crossing_long_lines ... passed\n"
+" Test: test_lwline_crossing_bugs ... passed\n"
+" Test: test_lwpoint_set_ordinate ... passed\n"
+" Test: test_lwpoint_get_ordinate ... passed\n"
+" Test: test_point_interpolate ... passed\n"
+" Test: test_lwline_clip ... passed\n"
+" Test: test_lwline_clip_big ... passed\n"
+" Test: test_lwmline_clip ... passed\n"
+" Test: test_geohash_point ... passed\n"
+" Test: test_geohash_precision ... passed\n"
+" Test: test_geohash ... passed\n"
+" Test: test_isclosed ... passed\n"
+"Suite: PostGIS Measures Suite\n"
+" Test: test_mindistance2d_tolerance ... passed\n"
+" Test: test_rect_tree_contains_point ... passed\n"
+" Test: test_rect_tree_intersects_tree ... passed\n"
+" Test: test_lwgeom_segmentize2d ... passed\n"
+"Suite: WKT Out Suite\n"
+" Test: test_wkt_out_point ... passed\n"
+" Test: test_wkt_out_linestring ... passed\n"
+" Test: test_wkt_out_polygon ... passed\n"
+" Test: test_wkt_out_multipoint ... passed\n"
+" Test: test_wkt_out_multilinestring ... passed\n"
+":\n"
+":\n"
+"--Run Summary: Type Total Ran Passed Failed\n"
+" suites 17 17 n/a 0\n"
+" tests 143 143 143 0\n"
+" asserts 1228 1228 1228 0\n"
+"\n"
+"\n"
+"Creating spatial db postgis_reg\n"
+" Postgis 2.0.0SVN - 2011-01-11 15:33:37\n"
+" GEOS: 3.3.0-CAPI-1.7.0\n"
+" PROJ: Rel. 4.6.1, 21 August 2008\n"
+"\n"
+"Running tests\n"
+"\n"
+" loader/Point.............. ok\n"
+" loader/PointM.............. ok\n"
+" loader/PointZ.............. ok\n"
+" loader/MultiPoint.............. ok\n"
+" loader/MultiPointM.............. ok\n"
+" loader/MultiPointZ.............. ok\n"
+" loader/Arc.............. ok\n"
+" loader/ArcM.............. ok\n"
+" loader/ArcZ.......... ok\n"
+" loader/Polygon.............. ok\n"
+" loader/PolygonM.............. ok\n"
+" loader/PolygonZ.............. ok\n"
+" regress. ok\n"
+" regress_index. ok\n"
+" regress_index_nulls. ok\n"
+" lwgeom_regress. ok\n"
+" regress_lrs. ok\n"
+" removepoint. ok\n"
+" setpoint. ok\n"
+" simplify. ok\n"
+" snaptogrid. ok\n"
+" affine. ok\n"
+" measures. ok\n"
+" long_xact. ok\n"
+" ctors. ok\n"
+" sql-mm-serialize. ok\n"
+" sql-mm-circularstring. ok\n"
+" sql-mm-compoundcurve. ok\n"
+" sql-mm-curvepoly. ok\n"
+" sql-mm-general. ok\n"
+" sql-mm-multicurve. ok\n"
+" sql-mm-multisurface. ok\n"
+" polyhedralsurface. ok\n"
+" out_geometry. ok\n"
+" out_geography. ok\n"
+" in_gml. ok\n"
+" in_kml. ok\n"
+" iscollection. ok\n"
+" regress_ogc. ok\n"
+" regress_ogc_cover. ok\n"
+" regress_ogc_prep. ok\n"
+" regress_bdpoly. ok\n"
+" regress_proj. ok\n"
+" dump. ok\n"
+" dumppoints. ok\n"
+" wmsservers_new. ok\n"
+" tickets. ok\n"
+" remove_repeated_points. ok\n"
+" split. ok\n"
+" relatematch. ok\n"
+" regress_buffer_params. ok\n"
+" hausdorff. ok\n"
+" clean. ok\n"
+" sharedpaths. ok\n"
+" snap. ok\n"
+"\n"
+"Run tests: 55\n"
+"Failed: 0"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:642
+#, no-c-format
+msgid "To install PostGIS, type"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:647
+#, no-c-format
+msgid "make install"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:650
+#, no-c-format
+msgid ""
+"This will copy the PostGIS installation files into their appropriate "
+"subdirectory specified by the <command>--prefix</command> configuration "
+"parameter. In particular:"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:658
+#, no-c-format
+msgid ""
+"The loader and dumper binaries are installed in <filename>[prefix]/bin</"
+"filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:665
+#, no-c-format
+msgid ""
+"The SQL files, such as <filename>postgis.sql</filename>, are installed in "
+"<filename>[prefix]/share/contrib</filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:672
+#, no-c-format
+msgid ""
+"The PostGIS libraries are installed in <filename>[prefix]/lib</filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:679
+#, no-c-format
+msgid ""
+"If you previously ran the <command>make comments</command> command to "
+"generate the <filename>postgis_comments.sql</filename>, "
+"<filename>raster_comments.sql</filename> file, install the sql file by "
+"running"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:686
+#, no-c-format
+msgid "make comments-install"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:690
+#, no-c-format
+msgid ""
+"<filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</"
+"filename>, <filename>topology_comments.sql</filename> was separated from the "
+"typical build and installation targets since with it comes the extra "
+"dependency of <command>xsltproc</command>."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:700
+#, no-c-format
+msgid "Create a spatially-enabled database on PostgreSQL lower than 9.1"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:702
+#, no-c-format
+msgid ""
+"The first step in creating a PostGIS database is to create a simple "
+"PostgreSQL database."
+msgstr ""
+
+#. Tag: command
+#: installation.xml:708 installation.xml:805
+#, no-c-format
+msgid "createdb [yourdatabase]"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:711
+#, no-c-format
+msgid ""
+"Many of the PostGIS functions are written in the PL/pgSQL procedural "
+"language. As such, the next step to create a PostGIS database is to enable "
+"the PL/pgSQL language in your new database. This is accomplish by the "
+"command below command. For PostgreSQL 8.4+, this is generally already "
+"installed"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:719
+#, no-c-format
+msgid "createlang plpgsql [yourdatabase]"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:722
+#, no-c-format
+msgid ""
+"Now load the PostGIS object and function definitions into your database by "
+"loading the <filename>postgis.sql</filename> definitions file (located in "
+"<filename>[prefix]/share/contrib</filename> as specified during the "
+"configuration step)."
+msgstr ""
+
+#. Tag: command
+#: installation.xml:730
+#, no-c-format
+msgid "psql -d [yourdatabase] -f postgis.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:733
+#, no-c-format
+msgid ""
+"For a complete set of EPSG coordinate system definition identifiers, you can "
+"also load the <filename>spatial_ref_sys.sql</filename> definitions file and "
+"populate the <varname>spatial_ref_sys</varname> table. This will permit you "
+"to perform ST_Transform() operations on geometries."
+msgstr ""
+
+#. Tag: command
+#: installation.xml:741
+#, no-c-format
+msgid "psql -d [yourdatabase] -f spatial_ref_sys.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:744
+#, no-c-format
+msgid ""
+"If you wish to add comments to the PostGIS functions, the final step is to "
+"load the <filename>postgis_comments.sql</filename> into your spatial "
+"database. The comments can be viewed by simply typing <command>\\dd "
+"[function_name]</command> from a <command>psql</command> terminal window."
+msgstr ""
+
+#. Tag: command
+#: installation.xml:752
+#, no-c-format
+msgid "psql -d [yourdatabase] -f postgis_comments.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:755
+#, no-c-format
+msgid "Install raster support"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:760
+#, no-c-format
+msgid "psql -d [yourdatabase] -f rtpostgis.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:763
+#, no-c-format
+msgid ""
+"Install raster support comments. This will provide quick help info for each "
+"raster function using psql or PgAdmin or any other PostgreSQL tool that can "
+"show function comments"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:769
+#, no-c-format
+msgid "psql -d [yourdatabase] -f raster_comments.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:771
+#, no-c-format
+msgid "Install topology support"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:776
+#, no-c-format
+msgid "psql -d [yourdatabase] -f topology/topology.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:779
+#, no-c-format
+msgid ""
+"Install topology support comments. This will provide quick help info for "
+"each topology function / type using psql or PgAdmin or any other PostgreSQL "
+"tool that can show function comments"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:785
+#, no-c-format
+msgid "psql -d [yourdatabase] -f topology/topology_comments.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:788 installation.xml:825
+#, no-c-format
+msgid ""
+"If you plan to restore an old backup from prior versions in this new db, run:"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:789 installation.xml:826
+#, no-c-format
+msgid "psql -d [yourdatabase] -f legacy.sql"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:790
+#, no-c-format
+msgid ""
+"There is an alternative <filename>legacy_minimal.sql</filename> you can run "
+"instead which will install barebones needed to recover tables and work with "
+"apps like MapServer and GeoServer. If you have views that use things like "
+"distance / length etc, you'll need the full blown <filename>legacy.sql</"
+"filename>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:793 installation.xml:828
+#, no-c-format
+msgid ""
+"You can later run <filename>uninstall_legacy.sql</filename> to get rid of "
+"the deprecated functions after you are done with restoring and cleanup."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:797
+#, no-c-format
+msgid "Creating a spatial database using EXTENSIONS"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:799
+#, no-c-format
+msgid ""
+"If you are using PostgreSQL 9.1+ and have compiled and installed the "
+"extensions/ postgis modules, you can create a spatial database the new way."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:808
+#, no-c-format
+msgid ""
+"The core postgis extension installs PostGIS geometry, geography, raster, "
+"spatial_ref_sys and all the functions and comments with a simple: "
+"<programlisting>CREATE EXTENSION postgis;</programlisting> command."
+msgstr ""
+
+#. Tag: command
+#: installation.xml:814
+#, no-c-format
+msgid "psql -d [yourdatabase] -c \"CREATE EXTENSION postgis;\""
+msgstr ""
+
+#. Tag: para
+#: installation.xml:817
+#, no-c-format
+msgid ""
+"Topology is packaged as a separate extension and installable with command:"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:822
+#, no-c-format
+msgid "psql -d [yourdatabase] -c \"CREATE EXTENSION postgis_topology;\""
+msgstr ""
+
+#. Tag: title
+#: installation.xml:832
+#, no-c-format
+msgid "Installing, Upgrading Tiger Geocoder and loading data"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:834
+#, no-c-format
+msgid ""
+"The Tiger geocoder does not get installed / upgraded with the core PostGIS "
+"scripts because it is only of regional use. In fact nothing located in the "
+"extras folder is installed by default with the regular PostGIS install / "
+"upgrade. Extras like Tiger geocoder may also not be packaged in your PostGIS "
+"distribution, but will always be available in the postgis-"
+"&last_release_version;.tar.gz file. The instructions provided here are also "
+"available in the <filename>extras/tiger_geocoder/tiger_2010/README</filename>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:836
+#, no-c-format
+msgid ""
+"If you are on Windows and you don't have tar installed, you can use <ulink "
+"url=\"http://www.7-zip.org/\">http://www.7-zip.org/</ulink> to unzip the "
+"PostGIS tarball."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:838
+#, no-c-format
+msgid "Tiger Geocoder Enabling your PostGIS database"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:839
+#, no-c-format
+msgid "First install PostGIS using the prior instructions."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:843 installation.xml:870
+#, no-c-format
+msgid ""
+"If you don't have an extras folder, download <ulink url=\"http://www.postgis."
+"org/download/postgis-&last_release_version;.tar.gz\">http://www.postgis.org/"
+"download/postgis-&last_release_version;.tar.gz</ulink>"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:848 installation.xml:875
+#, no-c-format
+msgid "tar xvfz postgis-&last_release_version;.tar.gz"
+msgstr ""
+
+#. Tag: command
+#: installation.xml:852 installation.xml:879
+#, no-c-format
+msgid "cd postgis-&last_release_version;/extras/tiger_geocoder/tiger_2011"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:855
+#, no-c-format
+msgid ""
+"Edit the <filename>tiger_loader.sql</filename> to the paths of your "
+"executables server etc."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:856
+#, no-c-format
+msgid ""
+"If you are installing Tiger geocoder for the first time edit either the "
+"<filename>create_geocode.bat</filename> script If you are on windows or the "
+"<filename>create_geocode.sh</filename> if you are on Linux/Unix/Mac OSX with "
+"your PostgreSQL specific settings and run the corresponding script from the "
+"commandline. If you don't edit this file, it will just contain common case "
+"locations of items. You can edit the generated script after the fact when "
+"you run the <xref linkend=\"Loader_Generate_Script\"/> command."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:859
+#, no-c-format
+msgid ""
+"Verify that you now have a <varname>tiger</varname> schema in your database "
+"and that it is part of your database search_path. If it is not, add it with "
+"a command something along the line of:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:859
+#, no-c-format
+msgid "ALTER DATABASE geocoder SET search_path=public, tiger;"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:860
+#, no-c-format
+msgid ""
+"The normalizing address functionality works more or less without any data "
+"except for tricky addresses. Run this test and verify things look like this:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:861
+#, no-c-format
+msgid ""
+"SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, "
+"Nevada 89101')) As pretty_address;\n"
+"pretty_address\n"
+"---------------------------------------\n"
+"202 E Fremont St, Las Vegas, NV 89101"
+msgstr ""
+
+#. Tag: title
+#: installation.xml:865
+#, no-c-format
+msgid "Upgrading your Tiger Geocoder Install"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:866
+#, no-c-format
+msgid ""
+"If you have Tiger Geocoder packaged with 2.0+ already installed, you can "
+"upgrade the functions at any time even from an interim tar ball if there are "
+"fixes you badly need."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:882
+#, no-c-format
+msgid ""
+"Locate the <filename>upgrade_geocoder.bat</filename> script If you are on "
+"windows or the <filename>upgrade_geocoder.sh</filename> if you are on Linux/"
+"Unix/Mac OSX. Edit the file to have your postgis database credientials and "
+"run then corresponding script from the commandline."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:885
+#, no-c-format
+msgid ""
+"Next drop all nation tables and load up the new ones. Generate a drop script "
+"with this SQL statement as detailed in <xref linkend="
+"\"Drop_Nation_Tables_Generate_Script\"/>"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:886
+#, no-c-format
+msgid "SELECT drop_nation_tables_generate_script();"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:887
+#, no-c-format
+msgid "Run the generated drop SQL statements."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:888
+#, no-c-format
+msgid ""
+"Generate a nation load script with this SELECT statement as detailed in "
+"<xref linkend=\"Loader_Generate_Nation_Script\"/>"
+msgstr ""
+
+#. Tag: emphasis
+#: installation.xml:889
+#, no-c-format
+msgid "For windows"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:890
+#, no-c-format
+msgid "SELECT loader_generate_nation_script('windows');"
+msgstr ""
+
+#. Tag: emphasis
+#: installation.xml:891
+#, no-c-format
+msgid "For unix/linux"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:892
+#, no-c-format
+msgid "SELECT loader_generate_nation_script('sh');"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:893
+#, no-c-format
+msgid ""
+"Refer to <xref linkend=\"tiger_geocoder_loading_data\"/> for instructions on "
+"how to run the generate script. This only needs to be done once."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:894
+#, no-c-format
+msgid ""
+"You can have a mix of 2010/2011 state tables and can upgrade each state "
+"separately. Before you upgrade a state to 2011, you first need to drop the "
+"2010 tables for that state using <xref linkend="
+"\"Drop_State_Tables_Generate_Script\"/>."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:897
+#, no-c-format
+msgid "Loading Tiger Data"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:898
+#, no-c-format
+msgid ""
+"The instructions for loading data are available in a more detailed form in "
+"the <filename>extras/tiger_geocoder/tiger_2011/README</filename>. This just "
+"includes the general steps."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:899
+#, no-c-format
+msgid ""
+"The load process downloads data from the census website for the respective "
+"nation files, states requested, extracts the files, and then loads each "
+"state into its own separate set of state tables. Each state table inherits "
+"from the tables defined in <varname>tiger</varname> schema so that its "
+"sufficient to just query those tables to access all the data and drop a set "
+"of state tables at any time using the <xref linkend="
+"\"Drop_State_Tables_Generate_Script\"/> if you need to reload a state or "
+"just don't need a state anymore."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:901
+#, no-c-format
+msgid "In order to be able to load data you'll need the following tools:"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:903
+#, no-c-format
+msgid "A tool to unzip the zip files from census website."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:904
+#, no-c-format
+msgid ""
+"For Unix like systems: <varname>unzip</varname> executable which is usually "
+"already installed on most Unix like platforms."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:905
+#, no-c-format
+msgid ""
+"For Windows, 7-zip which is a free compress/uncompress tool you can download "
+"from <ulink url=\"http://www.7-zip.org/\">http://www.7-zip.org/</ulink>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:907
+#, no-c-format
+msgid ""
+"<filename>shp2pgsql</filename> commandline which is installed by default "
+"when you install PostGIS."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:908
+#, no-c-format
+msgid ""
+"<filename>wget</filename> which is a web grabber tool usually installed on "
+"most Unix/Linux systems."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:909
+#, no-c-format
+msgid ""
+"If you are on windows, you can get pre-compiled binaries from <ulink url="
+"\"http://gnuwin32.sourceforge.net/packages/wget.htm\">http://gnuwin32."
+"sourceforge.net/packages/wget.htm</ulink>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:912
+#, no-c-format
+msgid ""
+"If you are upgrading from tiger_2010, you'll need to first generate and run "
+"<xref linkend=\"Drop_Nation_Tables_Generate_Script\"/>. Before you load any "
+"state data, you need to load the nation wide data which you do with <xref "
+"linkend=\"Loader_Generate_Nation_Script\"/>. Which will generate a loader "
+"script for you."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:914
+#, no-c-format
+msgid ""
+"To load data refer to <xref linkend=\"Loader_Generate_Script\"/> to generate "
+"a data load script for your platform for the states you desire. Note that "
+"you can install these piecemeal. You don't have to load all the states you "
+"want all at once. You can load them as you need them."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:917
+#, no-c-format
+msgid ""
+"After the states you desire have been loaded, make sure to run the: "
+"<programlisting>SELECT install_missing_indexes();</programlisting> as "
+"described in <xref linkend=\"Install_Missing_Indexes\"/>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:919
+#, no-c-format
+msgid ""
+"To test that things are working as they should, try to run a geocode on an "
+"address in your state using <xref linkend=\"Geocode\"/>"
+msgstr ""
+
+#. Tag: title
+#: installation.xml:924
+#, no-c-format
+msgid "Create a spatially-enabled database from a template"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:926
+#, no-c-format
+msgid ""
+"Some packaged distributions of PostGIS (in particular the Win32 installers "
+"for PostGIS >= 1.1.5) load the PostGIS functions into a template database "
+"called <varname>template_postgis</varname>. If the "
+"<varname>template_postgis</varname> database exists in your PostgreSQL "
+"installation then it is possible for users and/or applications to create "
+"spatially-enabled databases using a single command. Note that in both cases, "
+"the database user must have been granted the privilege to create new "
+"databases."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:937
+#, no-c-format
+msgid "From the shell:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:941
+#, no-c-format
+msgid "# createdb -T template_postgis my_spatial_db"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:943
+#, no-c-format
+msgid "From SQL:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:947
+#, no-c-format
+msgid "postgres=# CREATE DATABASE my_spatial_db TEMPLATE=template_postgis"
+msgstr ""
+
+#. Tag: title
+#: installation.xml:951
+#, no-c-format
+msgid "Upgrading"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:953
+#, no-c-format
+msgid ""
+"Upgrading existing spatial databases can be tricky as it requires "
+"replacement or introduction of new PostGIS object definitions."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:958
+#, no-c-format
+msgid ""
+"Unfortunately not all definitions can be easily replaced in a live database, "
+"so sometimes your best bet is a dump/reload process."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:963
+#, no-c-format
+msgid ""
+"PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and "
+"a HARD UPGRADE procedure for major releases."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:968
+#, no-c-format
+msgid ""
+"Before attempting to upgrade PostGIS, it is always worth to backup your "
+"data. If you use the -Fc flag to pg_dump you will always be able to restore "
+"the dump with a HARD UPGRADE."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:975
+#, no-c-format
+msgid "Soft upgrade"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:977
+#, no-c-format
+msgid ""
+"If you installed your database using extensions, you'll need to upgrade "
+"using the extension model as well. If you installed using the old sql script "
+"way, then you should upgrade using the sql script way. Please refer to the "
+"appropriate."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:980
+#, no-c-format
+msgid "Soft Upgrade Pre 9.1+ or without extensions"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:981
+#, no-c-format
+msgid ""
+"This section applies only to those who installed PostGIS not using "
+"extensions. If you have extensions and try to upgrade with this approach "
+"you'll get messages like:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:982
+#, no-c-format
+msgid "can't drop ... because postgis extension depends on it"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:983
+#, no-c-format
+msgid ""
+"After compiling you should find several <filename>postgis_upgrade*.sql</"
+"filename> files. Install the one for your version of PostGIS. For example "
+"<filename>postgis_upgrade_13_to_15.sql</filename> should be used if you are "
+"upgrading from PostGIS 1.3 to 1.5. If you are moving from PostGIS 1.* to "
+"PostGIS 2.* or from PostGIS 2.* prior to r7409, you need to do a HARD "
+"UPGRADE."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:989
+#, no-c-format
+msgid "psql -f postgis_upgrade_20_minor.sql -d your_spatial_database"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:991
+#, no-c-format
+msgid ""
+"The same procedure applies to raster and topology extensions, with upgrade "
+"files named <filename>rtpostgis_upgrade*.sql</filename> and "
+"<filename>topology_upgrade*.sql</filename> respectively. If you need them:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:999
+#, no-c-format
+msgid "psql -f rtpostgis_upgrade_20_minor.sql -d your_spatial_database"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1000
+#, no-c-format
+msgid "psql -f topology_upgrade_20_minor.sql -d your_spatial_database"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1003
+#, no-c-format
+msgid ""
+"If you can't find the <filename>postgis_upgrade*.sql</filename> specific for "
+"upgrading your version you are using a version too early for a soft upgrade "
+"and need to do a HARD UPGRADE."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1009
+#, no-c-format
+msgid ""
+"The <xref linkend=\"PostGIS_Full_Version\"/> function should inform you "
+"about the need to run this kind of upgrade using a \"procs need upgrade\" "
+"message."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:1016
+#, no-c-format
+msgid "Soft Upgrade 9.1+ using extensions"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1017
+#, no-c-format
+msgid ""
+"If you originally installed PostGIS with extensions, then you need to "
+"upgrade using extensions as well. Doing a minor upgrade with extensions, is "
+"fairly painless."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1018
+#, no-c-format
+msgid ""
+"ALTER EXTENSION postgis UPDATE TO \"&last_release_version;\";\n"
+"ALTER EXTENSION postgis_topology UPDATE TO \"&last_release_version;\";"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1019
+#, no-c-format
+msgid "If you get an error notice something like:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1020
+#, no-c-format
+msgid "No migration path defined for ... to &last_release_version;"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1021
+#, no-c-format
+msgid ""
+"Then you'll need to backup your database, create a fresh one as described in "
+"<xref linkend=\"create_new_db_extensions\"/> and then restore your backup "
+"ontop of this new database. You might get a message that <code>postgis "
+"extension</code> already installed which you can safely ignore."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1023
+#, no-c-format
+msgid ""
+"If you installed PostGIS originally without a version specified, you can "
+"often skip the reinstallation of postgis extension before restoring since "
+"the backup just has <code>CREATE EXTENSION postgis</code> and thus picks up "
+"the newest latest version during restore. ."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:1030
+#, no-c-format
+msgid "Hard upgrade"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1032
+#, no-c-format
+msgid ""
+"By HARD UPGRADE we mean full dump/reload of postgis-enabled databases. You "
+"need a HARD UPGRADE when PostGIS objects' internal storage changes or when "
+"SOFT UPGRADE is not possible. The <link linkend=\"release_notes\">Release "
+"Notes</link> appendix reports for each version whether you need a dump/"
+"reload (HARD UPGRADE) to upgrade."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1041
+#, no-c-format
+msgid ""
+"The dump/reload process is assisted by the postgis_restore.pl script which "
+"takes care of skipping from the dump all definitions which belong to PostGIS "
+"(including old ones), allowing you to restore your schemas and data into a "
+"database with PostGIS installed without getting duplicate symbol errors or "
+"bringing forward deprecated objects."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1050
+#, no-c-format
+msgid ""
+"Supplementary instructions for windows users are available at <ulink url="
+"\"http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade\">Windows Hard "
+"upgrade</ulink>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1053
+#, no-c-format
+msgid "The Procedure is as follows:"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1061
+#, no-c-format
+msgid ""
+"Create a \"custom-format\" dump of the database you want to upgrade (let's "
+"call it <varname>olddb</varname>) include binary blobs (-b) and verbose (-v) "
+"output. The user can be the owner of the db, need not be postgres super "
+"account."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1069
+#, no-c-format
+msgid ""
+"pg_dump -h localhost -p 5432 -U postgres -Fc -b -v -f \"/somepath/olddb."
+"backup\" olddb"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1075
+#, no-c-format
+msgid ""
+"Do a fresh install of PostGIS in a new database -- we'll refer to this "
+"database as <varname>newdb</varname>. Please refer to <xref linkend="
+"\"create_new_db\"/> and <xref linkend=\"create_new_db_extensions\"/> for "
+"instructions on how to do this."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1082
+#, no-c-format
+msgid ""
+"The spatial_ref_sys entries found in your dump will be restored, but they "
+"will not override existing ones in spatial_ref_sys. This is to ensure that "
+"fixes in the official set will be properly propagated to restored databases. "
+"If for any reason you really want your own overrides of standard entries "
+"just don't load the spatial_ref_sys.sql file when creating the new db."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1092
+#, no-c-format
+msgid ""
+"If your database is really old or you know you've been using long deprecated "
+"functions in your views and functions, you might need to load "
+"<filename>legacy.sql</filename> for all your functions and views etc. to "
+"properly come back. Only do this if _really_ needed. Consider upgrading your "
+"views and functions before dumping instead, if possible. The deprecated "
+"functions can be later removed by loading <filename>uninstall_legacy.sql</"
+"filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1108
+#, no-c-format
+msgid ""
+"Restore your backup into your fresh <varname>newdb</varname> database using "
+"postgis_restore.pl. Unexpected errors, if any, will be printed to the "
+"standard error stream by psql. Keep a log of those."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1116
+#, no-c-format
+msgid ""
+"perl utils/postgis_restore.pl \"/somepath/olddb.backup\" | psql -h localhost "
+"-p 5432 -U postgres newdb 2> errors.txt"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1122
+#, no-c-format
+msgid "Errors may arise in the following cases:"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1128
+#, no-c-format
+msgid ""
+"Some of your views or functions make use of deprecated PostGIS objects. In "
+"order to fix this you may try loading <filename>legacy.sql</filename> script "
+"prior to restore or you'll have to restore to a version of PostGIS which "
+"still contains those objects and try a migration again after porting your "
+"code. If the <filename>legacy.sql</filename> way works for you, don't forget "
+"to fix your code to stop using deprecated functions and drop them loading "
+"<filename>uninstall_legacy.sql</filename>."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1140
+#, no-c-format
+msgid ""
+"Some custom records of spatial_ref_sys in dump file have an invalid SRID "
+"value. Valid SRID values are bigger than 0 and smaller than 999000. Values "
+"in the 999000.999999 range are reserved for internal use while values > "
+"999999 can't be used at all. All your custom records with invalid SRIDs will "
+"be retained, with those > 999999 moved into the reserved range, but the "
+"spatial_ref_sys table would loose a check constraint guarding for that "
+"invariant to hold and possibly also its primary key ( when multiple invalid "
+"SRIDS get converted to the same reserved SRID value )."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1154
+#, no-c-format
+msgid ""
+"In order to fix this you should copy your custom SRS to a SRID with a valid "
+"value (maybe in the 910000..910999 range), convert all your tables to the "
+"new srid (see <xref linkend=\"UpdateGeometrySRID\"/>), delete the invalid "
+"entry from spatial_ref_sys and re-construct the check(s) with:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1161
+#, no-c-format
+msgid ""
+"ALTER TABLE spatial_ref_sys ADD CONSTRAINT spatial_ref_sys_srid_check check "
+"(srid > 0 AND srid < 999000 );"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1163
+#, no-c-format
+msgid "ALTER TABLE spatial_ref_sys ADD PRIMARY KEY(srid));"
+msgstr ""
+
+#. Tag: title
+#: installation.xml:1174
+#, no-c-format
+msgid "Common Problems"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1175
+#, no-c-format
+msgid ""
+"There are several things to check when your installation or upgrade doesn't "
+"go as you expected."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1182
+#, no-c-format
+msgid ""
+"Check that you have installed PostgreSQL &min_postgres_version; or newer, "
+"and that you are compiling against the same version of the PostgreSQL source "
+"as the version of PostgreSQL that is running. Mix-ups can occur when your "
+"(Linux) distribution has already installed PostgreSQL, or you have otherwise "
+"installed PostgreSQL before and forgotten about it. PostGIS will only work "
+"with PostgreSQL &min_postgres_version; or newer, and strange, unexpected "
+"error messages will result if you use an older version. To check the version "
+"of PostgreSQL which is running, connect to the database using psql and run "
+"this query:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1195
+#, no-c-format
+msgid "SELECT version();"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1197
+#, no-c-format
+msgid ""
+"If you are running an RPM based distribution, you can check for the "
+"existence of pre-installed packages using the <command>rpm</command> command "
+"as follows: <command>rpm -qa | grep postgresql</command>"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1205
+#, no-c-format
+msgid ""
+"If your upgrade fails, make sure you are restoring into a database that "
+"already has PostGIS installed."
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1206
+#, no-c-format
+msgid "SELECT postgis_full_version();"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1210
+#, no-c-format
+msgid ""
+"Also check that configure has correctly detected the location and version of "
+"PostgreSQL, the Proj4 library and the GEOS library."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1217
+#, no-c-format
+msgid ""
+"The output from configure is used to generate the <filename>postgis_config."
+"h</filename> file. Check that the <varname>POSTGIS_PGSQL_VERSION</varname>, "
+"<varname>POSTGIS_PROJ_VERSION</varname> and <varname>POSTGIS_GEOS_VERSION</"
+"varname> variables have been set correctly."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:1230
+#, no-c-format
+msgid "JDBC"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1232
+#, no-c-format
+msgid ""
+"The JDBC extensions provide Java objects corresponding to the internal "
+"PostGIS types. These objects can be used to write Java clients which query "
+"the PostGIS database and draw or do calculations on the GIS data in PostGIS."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1241
+#, no-c-format
+msgid ""
+"Enter the <filename>java/jdbc</filename> sub-directory of the PostGIS "
+"distribution."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1248
+#, no-c-format
+msgid ""
+"Run the <filename>ant</filename> command. Copy the <filename>postgis.jar</"
+"filename> file to wherever you keep your java libraries."
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1256
+#, no-c-format
+msgid ""
+"The JDBC extensions require a PostgreSQL JDBC driver to be present in the "
+"current CLASSPATH during the build process. If the PostgreSQL JDBC driver is "
+"located elsewhere, you may pass the location of the JDBC driver JAR "
+"separately using the -D parameter like this:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1263
+#, no-c-format
+msgid "# ant -Dclasspath=/path/to/postgresql-jdbc.jar"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1265
+#, no-c-format
+msgid ""
+"PostgreSQL JDBC drivers can be downloaded from <ulink url=\"http://jdbc."
+"postgresql.org\"> http://jdbc.postgresql.org </ulink> ."
+msgstr ""
+
+#. Tag: title
+#: installation.xml:1275
+#, no-c-format
+msgid "Loader/Dumper"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1277
+#, no-c-format
+msgid ""
+"The data loader and dumper are built and installed automatically as part of "
+"the PostGIS build. To build and install them manually:"
+msgstr ""
+
+#. Tag: programlisting
+#: installation.xml:1282
+#, no-c-format
+msgid ""
+"# cd postgis-&last_release_version;/loader\n"
+"# make\n"
+"# make install"
+msgstr ""
+
+#. Tag: para
+#: installation.xml:1284
+#, no-c-format
+msgid ""
+"The loader is called <filename>shp2pgsql</filename> and converts ESRI Shape "
+"files into SQL suitable for loading in PostGIS/PostgreSQL. The dumper is "
+"called <filename>pgsql2shp</filename> and converts PostGIS tables (or "
+"queries) into ESRI Shape files. For more verbose documentation, see the "
+"online help, and the manual pages."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# wotankeld <arek.matoszka@gmail.com>, 2013
+# Mateusz Łoskot <mateusz@loskot.net>, 2013
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-12-07 13:59+0000\n"
+"Last-Translator: wotankeld <arek.matoszka@gmail.com>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: introduction.xml:3
+#, no-c-format
+msgid "Introduction"
+msgstr "Wprowadzenie"
+
+#. Tag: para
+#: introduction.xml:5
+#, no-c-format
+msgid ""
+"PostGIS was developed by Refractions Research Inc, as a spatial database "
+"technology research project. Refractions is a GIS and database consulting "
+"company in Victoria, British Columbia, Canada, specializing in data "
+"integration and custom software development. We plan on supporting and "
+"developing PostGIS to support a range of important GIS functionality, "
+"including full OpenGIS support, advanced topological constructs (coverages, "
+"surfaces, networks), desktop user interface tools for viewing and editing "
+"GIS data, and web-based access tools."
+msgstr ""
+"PostGIS w ramach projektu badawczego prowadzonego przes firmę Refractions "
+"Research Inc, którego celem było stworzenie bazy danych przestrzennych. "
+"Refractions to kanadyjska firma z siedzibą w Wiktorii, Kolumbia Brytyjska, "
+"która specjalizuje się w tworzeniu systemów informacji przestrzennej, baz "
+"danych przestrzennych oraz rozwoju w oprogramowania celowego.\n"
+"\n"
+"Naszym zamiarem jest wspieranie projektu PostGIS dla rozwoju nowych funkcji "
+"do analiz przestrzennych, zapewnienie wsparcia dla specyfikacji OpenGIS i "
+"tworzenia zaawansowanych konstrukcji topologicznych (pokrycia, powierzchnie, "
+"sieci) oraz dostarczenie przyjaznego interfejsu użytkownika do przeglądania "
+"i edycji danych przestrzennych, jak również dostępu do danych online."
+
+#. Tag: para
+#: introduction.xml:15
+#, no-c-format
+msgid ""
+"PostGIS is an incubation project of the OSGeo Foundation. PostGIS is being "
+"continually improved and funded by many FOSS4G Developers as well as "
+"corporations all over the world that gain great benefit from its "
+"functionality and versatility."
+msgstr ""
+"PostGIS został zgłoszony do inkubatora projektów przy Fundacji OSGeo. "
+"PostGIS podlega ciągłemu rozwojowi, które jest wspierane przez licznych "
+"programistów i entuzjastów FOSS4G, jak również przez korporacje na całym "
+"świecie, które doceniają funkcjonalność i wszechstronność PostGIS."
+
+#. Tag: title
+#: introduction.xml:21
+#, no-c-format
+msgid "Project Steering Committee"
+msgstr "Komitet Wykonawczy Projektu"
+
+#. Tag: para
+#: introduction.xml:22
+#, no-c-format
+msgid ""
+"The PostGIS Project Steering Committee (PSC) coordinates the general "
+"direction, release cycles, documentation, and outreach efforts for the "
+"PostGIS project. In addition the PSC provides general user support, accepts "
+"and approves patches from the general PostGIS community and votes on "
+"miscellaneous issues involving PostGIS such as developer commit access, new "
+"PSC members or significant API changes."
+msgstr ""
+"W ramach projektu PostGIS, komitet wykonawczy (Project Steering Committee, "
+"PSC) koordynuje generalny kierunek prac, cykl kolejnych wydań nowych wersji "
+"oprogramowania, tworzenie dokumentacji, oraz adresuje potrzeby społeczności "
+"skupionej wokół projektu PostGIS.\n"
+"Dodatkowo, komitet przyjmuje, akceptuje i zatwierdza wszelkie zmiany "
+"zgłaszane do projektu przez ogół użytkowników i programistów "
+"zainteresowanych PostGIS. Komitet również przeprowadza głosowania nad "
+"istotnymi decyzjami, takimi jak nadanie nowemu programiście praw zapisu do "
+"repozytorium kodu źródłowego, zgłoszenie nowego członka do komitetu "
+"wykonawczego lub istotnych zmian w interfejsie programowania aplikacji "
+"(Application Programming Interface, API)."
+
+#. Tag: term
+#: introduction.xml:31
+#, no-c-format
+msgid "Mark Cave-Ayland"
+msgstr "Mark Cave-Ayland"
+
+#. Tag: para
+#: introduction.xml:33
+#, no-c-format
+msgid ""
+"Coordinates bug fixing and maintenance effort, alignment of PostGIS with "
+"PostgreSQL releases, spatial index selectivity and binding, loader/dumper, "
+"and Shapefile GUI Loader, integration of new and new function enhancements."
+msgstr ""
+"Koordynuje naprawę błędów i przyjmowanie poprawek, synchronizuje wydania "
+"nowych wersji PostGIS wraz z wydaniami PostgreSQL, pracuje nad integracją "
+"indeksów przestrzennych, programów ładujących i zrzucających dane, "
+"tworzeniem graficznego programu Shapefile Loader oraz integrację nowych "
+"funkcji i usprawnień."
+
+#. Tag: term
+#: introduction.xml:40
+#, no-c-format
+msgid "Regina Obe"
+msgstr "Regina Obe"
+
+#. Tag: para
+#: introduction.xml:42
+#, no-c-format
+msgid ""
+"Buildbot Maintenance, windows production and experimental builds, "
+"Documentation, general user support on PostGIS newsgroup, X3D support, Tiger "
+"Geocoder Support, management functions, and smoke testing new functionality "
+"or major code changes."
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:49
+#, no-c-format
+msgid "Paul Ramsey (Chair)"
+msgstr "Paul Ramsey (Lider)"
+
+#. Tag: para
+#: introduction.xml:51
+#, no-c-format
+msgid ""
+"Co-founder of PostGIS project. General bug fixing, geography support, "
+"geography and geometry index support (2D, 3D, nD index and anything spatial "
+"index), underlying geometry internal structures, GEOS functionality "
+"integration and alignment with GEOS releases, loader/dumper, and Shapefile "
+"GUI loader."
+msgstr ""
+"Współzałożyciel projektu PostGIS. Ogólne poprawki błędów, wsparcie dla "
+"danych geograficznych, wsparcie dla indeksów przestrzennych geometrycznych i "
+"geograficznych (indeksy 2D, 3D, nD oraz pełny), wewnętrzne struktury dla "
+"podstawowych typów geometrii, integracja funkcji GEOS oraz dostosowanie do "
+"wersji GEOS, loader/dumper, GUI do ładowania plików Shapefile"
+
+#. Tag: term
+#: introduction.xml:57
+#, no-c-format
+msgid "Sandro Santilli"
+msgstr "Sandro Santilli"
+
+#. Tag: para
+#: introduction.xml:60
+#, no-c-format
+msgid ""
+"Bug fixes and maintenance and integration of new GEOS functionality and "
+"alignment with GEOS releases, Topology support, and Raster framework and low "
+"level api functions."
+msgstr ""
+"Poprawki błędów i utrzymaniowe, integracja nowych funkcji GEOS oraz "
+"dostosowanie do różnych wersji GEOS, wsparcie dla topologii, framework dla "
+"rastrów oraz funkcje api niskiego poziomu"
+
+#. Tag: title
+#: introduction.xml:67
+#, no-c-format
+msgid "Contributors Past and Present"
+msgstr "Autorzy byli i obecni"
+
+#. Tag: term
+#: introduction.xml:71
+#, no-c-format
+msgid "Chris Hodgson"
+msgstr "Chris Hodgson"
+
+#. Tag: para
+#: introduction.xml:73
+#, no-c-format
+msgid ""
+"Prior PSC Member. General development, site and buildbot maintenance, OSGeo "
+"incubation management"
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:77
+#, no-c-format
+msgid "Kevin Neufeld"
+msgstr "Kevin Neufeld"
+
+#. Tag: para
+#: introduction.xml:79
+#, no-c-format
+msgid ""
+"Prior PSC Member. Documentation and documentation support tools, advanced "
+"user support on PostGIS newsgroup, and PostGIS maintenance function "
+"enhancements."
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:85
+#, no-c-format
+msgid "Dave Blasby"
+msgstr "Dave Blasby"
+
+#. Tag: para
+#: introduction.xml:88
+#, no-c-format
+msgid ""
+"The original developer/Co-founder of PostGIS. Dave wrote the server side "
+"objects, index bindings, and many of the server side analytical functions."
+msgstr ""
+"Developer / współzałożyciel projektu PostGIS. Dave przygotował obiekty po "
+"stronie serwera, index bindings oraz wiele z funkcji analitycznych po "
+"stronie serwera."
+
+#. Tag: term
+#: introduction.xml:95
+#, no-c-format
+msgid "Jeff Lounsbury"
+msgstr "Jeff Lounsbury"
+
+#. Tag: para
+#: introduction.xml:97
+#, no-c-format
+msgid ""
+"Original development of the Shape file loader/dumper. Current PostGIS "
+"Project Owner representative."
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:102
+#, no-c-format
+msgid "Olivier Courtin"
+msgstr "Olivier Courtin"
+
+#. Tag: para
+#: introduction.xml:104
+#, no-c-format
+msgid "Input output XML (KML,GML)/GeoJSON functions, 3D support and bug fixes."
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:109
+#, no-c-format
+msgid "Mark Leslie"
+msgstr "Mark Leslie"
+
+#. Tag: para
+#: introduction.xml:111
+#, no-c-format
+msgid ""
+"Ongoing maintenance and development of core functions. Enhanced curve "
+"support. Shapefile GUI loader."
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:116
+#, no-c-format
+msgid "Pierre Racine"
+msgstr "Pierre Racine"
+
+#. Tag: para
+#: introduction.xml:118
+#, no-c-format
+msgid "Raster overall architecture, prototyping, programming support"
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:123
+#, no-c-format
+msgid "Nicklas Avén"
+msgstr "Nicklas Avén"
+
+#. Tag: para
+#: introduction.xml:126
+#, no-c-format
+msgid ""
+"Distance function enhancements (including 3D distance and relationship "
+"functions) and additions, Windows testing, and general user support"
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:131
+#, no-c-format
+msgid "Jorge Arévalo"
+msgstr "Jorge Arévalo"
+
+#. Tag: para
+#: introduction.xml:134
+#, no-c-format
+msgid "Raster development, GDAL driver support, loader"
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:139
+#, no-c-format
+msgid "Bborie Park"
+msgstr "Bborie Park"
+
+#. Tag: para
+#: introduction.xml:141
+#, no-c-format
+msgid "Raster development, raster loader"
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:146
+#, no-c-format
+msgid "Mateusz Loskot"
+msgstr "Mateusz Łoskot"
+
+#. Tag: para
+#: introduction.xml:148
+#, no-c-format
+msgid "Raster loader, low level raster api functions"
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:153
+#, no-c-format
+msgid "David Zwarg"
+msgstr "David Zwarg"
+
+#. Tag: para
+#: introduction.xml:156
+#, no-c-format
+msgid "Raster development"
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:161
+#, no-c-format
+msgid "Other contributors: Individuals"
+msgstr "Inni ofiarodawcy: osoby prywatne"
+
+#. Tag: para
+#: introduction.xml:164
+#, no-c-format
+msgid ""
+"In alphabetical order: Alex Bodnaru, Alex Mayrhofer, Andrea Peri, Andreas "
+"Forø Tollefsen, Andreas Neumann, Anne Ghisla, Barbara Phillipot, Ben Jubb, "
+"Bernhard Reiter, Brian Hamlin, Bruce Rindahl, Bruno Wolff III, Bryce L. "
+"Nordgren, Carl Anderson, Charlie Savage, Dane Springmeyer, David Skea, David "
+"Techer, Eduin Carrillo, Even Rouault, Frank Warmerdam, George Silva, Gerald "
+"Fenoy, Gino Lucrezi, Guillaume Lelarge, IIDA Tetsushi, Ingvild Nystuen, Jeff "
+"Adams, Jose Carlos Martinez Llari, Kashif Rasul, Klaus Foerster, Kris Jurka, "
+"Leo Hsu, Loic Dachary, Luca S. Percich, Maria Arias de Reyna, Mark Sondheim, "
+"Markus Schaber, Maxime Guillaud, Maxime van Noppen, Michael Fuhr, Nikita "
+"Shulga, Norman Vine, Rafal Magda, Ralph Mason, Richard Greenwood, Silvio "
+"Grosso, Steffen Macke, Stephen Frost, Tom van Tilburg, Vincent Picavet"
+msgstr ""
+"W kolejności alfabetycznej: Alex Bodnaru, Alex Mayrhofer, Andrea Peri, "
+"Andreas Forø Tollefsen, Andreas Neumann, Anne Ghisla, Barbara Phillipot, Ben "
+"Jubb, Bernhard Reiter, Brian Hamlin, Bruce Rindahl, Bruno Wolff III, Bryce "
+"L. Nordgren, Carl Anderson, Charlie Savage, Dane Springmeyer, David Skea, "
+"David Techer, Eduin Carrillo, Even Rouault, Frank Warmerdam, George Silva, "
+"Gerald Fenoy, Gino Lucrezi, Guillaume Lelarge, IIDA Tetsushi, Ingvild "
+"Nystuen, Jeff Adams, Jose Carlos Martinez Llari, Kashif Rasul, Klaus "
+"Foerster, Kris Jurka, Leo Hsu, Loic Dachary, Luca S. Percich, Maria Arias de "
+"Reyna, Mark Sondheim, Markus Schaber, Maxime Guillaud, Maxime van Noppen, "
+"Michael Fuhr, Nikita Shulga, Norman Vine, Rafal Magda, Ralph Mason, Richard "
+"Greenwood, Silvio Grosso, Steffen Macke, Stephen Frost, Tom van Tilburg, "
+"Vincent Picavet"
+
+#. Tag: term
+#: introduction.xml:221
+#, no-c-format
+msgid "Other contributors: Corporate Sponsors"
+msgstr "Inni ofiarodawcy: sponsorzy korporacyjni"
+
+#. Tag: para
+#: introduction.xml:224
+#, no-c-format
+msgid ""
+"These are corporate entities that have contributed developer time, hosting, "
+"or direct monetary funding to the PostGIS project"
+msgstr ""
+"Podmioty korporacyjne, które wniosły wkład do projektu PostGIS w postaci "
+"developmentu, hostingu lub wsparcia finansowego"
+
+#. Tag: para
+#: introduction.xml:225
+#, no-c-format
+msgid ""
+"In alphabetical order: Arrival 3D, Associazione Italiana per l'Informazione "
+"Geografica Libera (GFOSS.it), AusVet, Avencia, Azavea, Cadcorp, CampToCamp, "
+"City of Boston (DND), Clever Elephant Solutions, Cooperativa Alveo, Deimos "
+"Space, Faunalia, Geographic Data BC, Hunter Systems Group, Lidwala "
+"Consulting Engineers, LisaSoft, Logical Tracking & Tracing International "
+"AG, Michigan Tech Research Institute, Norwegian Forest and Landscape "
+"Institute, OpenGeo, OSGeo, Oslandia, Paragon Corporation, R3 GIS,, "
+"Refractions Research, Regione Toscana-SIGTA, Safe Software, Sirius "
+"Corporation plc, Stadt Uster, UC Davis Center for Vectorborne Diseases, "
+"University of Laval, U.S Department of State (HIU), Vizzuality, Zonar Systems"
+msgstr ""
+"W kolejności alfabetycznej: Arrival 3D, Associazione Italiana per "
+"l'Informazione Geografica Libera (GFOSS.it), AusVet, Avencia, Azavea, "
+"Cadcorp, CampToCamp, City of Boston (DND), Clever Elephant Solutions, "
+"Cooperativa Alveo, Deimos Space, Faunalia, Geographic Data BC, Hunter "
+"Systems Group, Lidwala Consulting Engineers, LisaSoft, Logical Tracking "
+"& Tracing International AG, Michigan Tech Research Institute, Norwegian "
+"Forest and Landscape Institute, OpenGeo, OSGeo, Oslandia, Paragon "
+"Corporation, R3 GIS,, Refractions Research, Regione Toscana-SIGTA, Safe "
+"Software, Sirius Corporation plc, Stadt Uster, UC Davis Center for "
+"Vectorborne Diseases, University of Laval, U.S Department of State (HIU), "
+"Vizzuality, Zonar Systems"
+
+#. Tag: term
+#: introduction.xml:265
+#, no-c-format
+msgid "Crowd Funding Campaigns"
+msgstr "Kampanie corwdfundingowe"
+
+#. Tag: para
+#: introduction.xml:268
+#, no-c-format
+msgid ""
+"Crowd funding campaigns are campaigns we run to get badly wanted features "
+"funded that can service a large number of people. Each campaign is "
+"specifically focused on a particular feature or set of features. Each "
+"sponsor chips in a small fraction of the needed funding and with enough "
+"people/organizations contributing, we have the funds to pay for the work "
+"that will help many. If you have an idea for a feature you think many others "
+"would be willing to co-fund, please post to the <ulink url=\"http://www."
+"postgis.org/mailman/listinfo/postgis-users\">PostGIS newsgroup</ulink> your "
+"thoughts and together we can make it happen."
+msgstr ""
+"Kampanie crowdfundingowe są organizowane aby pozyskać fundusze na rozwój "
+"najpotrzebniejszych funkcji, które służą dużej liczbie użytkowników. Każda "
+"kampania skupia się na konkretnej funkcji lub grupie funkcji. Każdy sponsor "
+"wpłaca małą część potrzebnych środków i przy udziale odpowiedniej liczby "
+"ludzi/organizacji uzyskujemy wystarczającą ilość środków, aby opłacić pracę, "
+"z której rezultatów skorzysta wiele osób. Jeśli masz pomysł na funkcję i "
+"uważasz, że inni byli by skłonni wesprzeć jej rozwój finansowo opisz swój "
+"pomysł na <ulink url=\"http://www.postgis.org/mailman/listinfo/postgis-users"
+"\">PostGIS newsgroup</ulink> i razem możemy sprawić, że Twój pomysł zostanie "
+"zrealizowany."
+
+#. Tag: para
+#: introduction.xml:269
+#, no-c-format
+msgid ""
+"PostGIS 2.0.0 was the first release we tried this strategy. We used <ulink "
+"url=\"http://www.pledgebank.com\">PledgeBank</ulink> and we got two "
+"successful campaigns out of it."
+msgstr ""
+"PostGIS 2.0.0 był pierwszym wydaniem, w którym wypróbowaliśmy taką "
+"strategię. Skorzystaliśmy z <ulink url=\"http://www.pledgebank.com"
+"\">PledgeBank</ulink> i przeprowadzilśmy dwie udane kampanie."
+
+#. Tag: para
+#: introduction.xml:270
+#, no-c-format
+msgid ""
+"<ulink url=\"http://www.pledgebank.com/postgistopology\"><emphasis role="
+"\"bold\">postgistopology</emphasis></ulink> - 10 plus sponsors each "
+"contributed $250 USD to build toTopoGeometry function and beef up topology "
+"support in 2.0.0. It happened."
+msgstr ""
+"<ulink url=\"http://www.pledgebank.com/postgistopology\"><emphasis role="
+"\"bold\">postgistopology</emphasis></ulink> - ponad 10 sponsorów wpłaciło "
+"po 250$ w celu stworzenia funkcji toTopoGeometry oraz rozbudowy wsparcia dla "
+"topologii w wersji 2.0.0. To naprawdę się wydarzyło."
+
+#. Tag: para
+#: introduction.xml:271
+#, no-c-format
+msgid ""
+"<ulink url=\"http://www.pledgebank.com/postgis64windows\"><emphasis role="
+"\"bold\">postgis64windows</emphasis></ulink> - 20 someodd sponsors each "
+"contributed $100 USD to pay for the work needed to work out PostGIS 64-bit "
+"on windows issues. It happened. We now have a 64-bit beta release for "
+"PostGIS 2.0.0 and a final one planned for release that will be available on "
+"PostgreSQL stack builder."
+msgstr ""
+
+#. Tag: term
+#: introduction.xml:276
+#, no-c-format
+msgid "Important Support Libraries"
+msgstr "Istotne biblioteki wspierające"
+
+#. Tag: para
+#: introduction.xml:279
+#, no-c-format
+msgid ""
+"The <ulink url=\"http://trac.osgeo.org/geos/\">GEOS</ulink> geometry "
+"operations library, and the algorithmic work of Martin Davis in making it "
+"all work, ongoing maintenance and support of Mateusz Loskot, Sandro Santilli "
+"(strk), Paul Ramsey and others."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:284
+#, no-c-format
+msgid ""
+"The <ulink url=\"http://trac.osgeo.org/gdal/\">GDAL</ulink> Geospatial Data "
+"Abstraction Library, by Frank Warmerdam and others is used to power much of "
+"the raster functionality introduced in PostGIS 2.0.0. In kind, improvements "
+"needed in GDAL to support PostGIS are contributed back to the GDAL project."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:289
+#, no-c-format
+msgid ""
+"The <ulink url=\"http://trac.osgeo.org/proj/\">Proj4</ulink> cartographic "
+"projection library, and the work of Gerald Evenden and Frank Warmerdam in "
+"creating and maintaining it."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:293
+#, no-c-format
+msgid ""
+"Last but not least, the <ulink url=\"http://www.postgresql.org\">PostgreSQL "
+"DBMS</ulink>, The giant that PostGIS stands on. Much of the speed and "
+"flexibility of PostGIS would not be possible without the extensibility, "
+"great query planner, GIST index, and plethora of SQL features provided by "
+"PostgreSQL."
+msgstr ""
+
+#. Tag: title
+#: introduction.xml:302
+#, no-c-format
+msgid "More Information"
+msgstr "Więcej informacji"
+
+#. Tag: para
+#: introduction.xml:306
+#, no-c-format
+msgid ""
+"The latest software, documentation and news items are available at the "
+"PostGIS web site, <ulink url=\"http://www.postgis.org\">http://www.postgis."
+"org</ulink>."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:312
+#, no-c-format
+msgid ""
+"More information about the GEOS geometry operations library is available "
+"at<ulink url=\"http://trac.osgeo.org/geos/\"> http://trac.osgeo.org/geos/</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:318
+#, no-c-format
+msgid ""
+"More information about the Proj4 reprojection library is available at <ulink "
+"url=\"http://trac.osgeo.org/proj/\">http://trac.osgeo.org/proj/</ulink>."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:324
+#, no-c-format
+msgid ""
+"More information about the PostgreSQL database server is available at the "
+"PostgreSQL main site <ulink url=\"http://www.postgresql.org\">http://www."
+"postgresql.org</ulink>."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:330
+#, no-c-format
+msgid ""
+"More information about GiST indexing is available at the PostgreSQL GiST "
+"development site, <ulink url=\"http://www.sai.msu.su/~megera/postgres/gist/"
+"\">http://www.sai.msu.su/~megera/postgres/gist/</ulink>."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:336
+#, no-c-format
+msgid ""
+"More information about MapServer internet map server is available at <ulink "
+"url=\"http://mapserver.org/\">http://mapserver.org</ulink>."
+msgstr ""
+
+#. Tag: para
+#: introduction.xml:342
+#, no-c-format
+msgid ""
+"The "<ulink url=\"http://www.opengeospatial.org/standards/sfs\">Simple "
+"Features for Specification for SQL</ulink>" is available at the OpenGIS "
+"Consortium web site: <ulink url=\"http://www.opengeospatial.org/\">http://"
+"www.opengeospatial.org/</ulink>."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: performance_tips.xml:3
+#, no-c-format
+msgid "Performance tips"
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:6
+#, no-c-format
+msgid "Small tables of large geometries"
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:9
+#, no-c-format
+msgid "Problem description"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:11
+#, no-c-format
+msgid ""
+"Current PostgreSQL versions (including 8.0) suffer from a query optimizer "
+"weakness regarding TOAST tables. TOAST tables are a kind of \"extension room"
+"\" used to store large (in the sense of data size) values that do not fit "
+"into normal data pages (like long texts, images or complex geometries with "
+"lots of vertices), see <ulink url=\"http://www.postgresql.org/docs/current/"
+"static/storage-toast.html\">the PostgreSQL Documentation for TOAST</ulink> "
+"for more information)."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:19
+#, no-c-format
+msgid ""
+"The problem appears if you happen to have a table with rather large "
+"geometries, but not too much rows of them (like a table containing the "
+"boundaries of all European countries in high resolution). Then the table "
+"itself is small, but it uses lots of TOAST space. In our example case, the "
+"table itself had about 80 rows and used only 3 data pages, but the TOAST "
+"table used 8225 pages."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:26
+#, no-c-format
+msgid ""
+"Now issue a query where you use the geometry operator && to search "
+"for a bounding box that matches only very few of those rows. Now the query "
+"optimizer sees that the table has only 3 pages and 80 rows. He estimates "
+"that a sequential scan on such a small table is much faster than using an "
+"index. And so he decides to ignore the GIST index. Usually, this estimation "
+"is correct. But in our case, the && operator has to fetch every "
+"geometry from disk to compare the bounding boxes, thus reading all TOAST "
+"pages, too."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:35
+#, no-c-format
+msgid ""
+"To see whether your suffer from this bug, use the \"EXPLAIN ANALYZE\" "
+"postgresql command. For more information and the technical details, you can "
+"read the thread on the postgres performance mailing list: http://archives."
+"postgresql.org/pgsql-performance/2005-02/msg00030.php"
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:43
+#, no-c-format
+msgid "Workarounds"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:45
+#, no-c-format
+msgid ""
+"The PostgreSQL people are trying to solve this issue by making the query "
+"estimation TOAST-aware. For now, here are two workarounds:"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:48
+#, no-c-format
+msgid ""
+"The first workaround is to force the query planner to use the index. Send "
+"\"SET enable_seqscan TO off;\" to the server before issuing the query. This "
+"basically forces the query planner to avoid sequential scans whenever "
+"possible. So it uses the GIST index as usual. But this flag has to be set on "
+"every connection, and it causes the query planner to make misestimations in "
+"other cases, so you should \"SET enable_seqscan TO on;\" after the query."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:56
+#, no-c-format
+msgid ""
+"The second workaround is to make the sequential scan as fast as the query "
+"planner thinks. This can be achieved by creating an additional column that "
+"\"caches\" the bbox, and matching against this. In our example, the commands "
+"are like:"
+msgstr ""
+
+#. Tag: programlisting
+#: performance_tips.xml:61
+#, no-c-format
+msgid ""
+"SELECT "
+"AddGeometryColumn('myschema','mytable','bbox','4326','GEOMETRY','2'); \n"
+"UPDATE mytable SET bbox = ST_Envelope(ST_Force_2d(the_geom));"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:63
+#, no-c-format
+msgid ""
+"Now change your query to use the && operator against bbox instead of "
+"geom_column, like:"
+msgstr ""
+
+#. Tag: programlisting
+#: performance_tips.xml:66
+#, no-c-format
+msgid ""
+"SELECT geom_column \n"
+"FROM mytable \n"
+"WHERE bbox && ST_SetSRID('BOX3D(0 0,1 1)'::box3d,4326);"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:68
+#, no-c-format
+msgid ""
+"Of course, if you change or add rows to mytable, you have to keep the bbox "
+"\"in sync\". The most transparent way to do this would be triggers, but you "
+"also can modify your application to keep the bbox column current or run the "
+"UPDATE query above after every modification."
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:77
+#, no-c-format
+msgid "CLUSTERing on geometry indices"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:79
+#, no-c-format
+msgid ""
+"For tables that are mostly read-only, and where a single index is used for "
+"the majority of queries, PostgreSQL offers the CLUSTER command. This command "
+"physically reorders all the data rows in the same order as the index "
+"criteria, yielding two performance advantages: First, for index range scans, "
+"the number of seeks on the data table is drastically reduced. Second, if "
+"your working set concentrates to some small intervals on the indices, you "
+"have a more efficient caching because the data rows are spread along fewer "
+"data pages. (Feel invited to read the CLUSTER command documentation from the "
+"PostgreSQL manual at this point.)"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:89
+#, no-c-format
+msgid ""
+"However, currently PostgreSQL does not allow clustering on PostGIS GIST "
+"indices because GIST indices simply ignores NULL values, you get an error "
+"message like:"
+msgstr ""
+
+#. Tag: programlisting
+#: performance_tips.xml:93
+#, no-c-format
+msgid ""
+"lwgeom=# CLUSTER my_geom_index ON my_table; \n"
+"ERROR: cannot cluster when index access method does not handle null values\n"
+"HINT: You may be able to work around this by marking column \"the_geom\" NOT "
+"NULL."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:95
+#, no-c-format
+msgid ""
+"As the HINT message tells you, one can work around this deficiency by adding "
+"a \"not null\" constraint to the table:"
+msgstr ""
+
+#. Tag: programlisting
+#: performance_tips.xml:98
+#, no-c-format
+msgid ""
+"lwgeom=# ALTER TABLE my_table ALTER COLUMN the_geom SET not null; \n"
+"ALTER TABLE"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:100
+#, no-c-format
+msgid ""
+"Of course, this will not work if you in fact need NULL values in your "
+"geometry column. Additionally, you must use the above method to add the "
+"constraint, using a CHECK constraint like \"ALTER TABLE blubb ADD CHECK "
+"(geometry is not null);\" will not work."
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:107
+#, no-c-format
+msgid "Avoiding dimension conversion"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:109
+#, no-c-format
+msgid ""
+"Sometimes, you happen to have 3D or 4D data in your table, but always access "
+"it using OpenGIS compliant ST_AsText() or ST_AsBinary() functions that only "
+"output 2D geometries. They do this by internally calling the ST_Force_2d() "
+"function, which introduces a significant overhead for large geometries. To "
+"avoid this overhead, it may be feasible to pre-drop those additional "
+"dimensions once and forever:"
+msgstr ""
+
+#. Tag: programlisting
+#: performance_tips.xml:116
+#, no-c-format
+msgid ""
+"UPDATE mytable SET the_geom = ST_Force_2d(the_geom); \n"
+"VACUUM FULL ANALYZE mytable;"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:118
+#, no-c-format
+msgid ""
+"Note that if you added your geometry column using AddGeometryColumn() "
+"there'll be a constraint on geometry dimension. To bypass it you will need "
+"to drop the constraint. Remember to update the entry in the geometry_columns "
+"table and recreate the constraint afterwards."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:124
+#, no-c-format
+msgid ""
+"In case of large tables, it may be wise to divide this UPDATE into smaller "
+"portions by constraining the UPDATE to a part of the table via a WHERE "
+"clause and your primary key or another feasible criteria, and running a "
+"simple \"VACUUM;\" between your UPDATEs. This drastically reduces the need "
+"for temporary disk space. Additionally, if you have mixed dimension "
+"geometries, restricting the UPDATE by \"WHERE dimension(the_geom)>2\" "
+"skips re-writing of geometries that already are in 2D."
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:136
+#, no-c-format
+msgid "Tuning your configuration"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:138
+#, no-c-format
+msgid ""
+"These tips are taken from Kevin Neufeld's presentation \"Tips for the "
+"PostGIS Power User\" at the FOSS4G 2007 conference. Depending on your use of "
+"PostGIS (for example, static data and complex analysis vs frequently updated "
+"data and lots of users) these changes can provide significant speedups to "
+"your queries."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:144
+#, no-c-format
+msgid ""
+"For a more tips (and better formatting), the original presentation is at "
+"<ulink url=\"http://2007.foss4g.org/presentations/view.php?"
+"abstract_id=117\"> http://2007.foss4g.org/presentations/view.php?"
+"abstract_id=117</ulink>."
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:151
+#, no-c-format
+msgid "Startup"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:153
+#, no-c-format
+msgid "These settings are configured in postgresql.conf:"
+msgstr ""
+
+#. Tag: ulink
+#: performance_tips.xml:158
+#, no-c-format
+msgid "checkpoint_segments"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:163
+#, no-c-format
+msgid ""
+"Maximum number of log file segments between automatic WAL checkpoints (each "
+"segment is normally 16MB); default is 3"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:169
+#, no-c-format
+msgid ""
+"Set to at least 10 or 30 for databases with heavy write activity, or more "
+"for large database loads. Another article on the topic worth reading <ulink "
+"url=\"http://www.westnet.com/~gsmith/content/postgresql/chkp-bgw-83.htm"
+"\">Greg Smith: Checkpoint and Background writer</ulink>"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:175
+#, no-c-format
+msgid "Possibly store the xlog on a separate disk device"
+msgstr ""
+
+#. Tag: ulink
+#: performance_tips.xml:182
+#, no-c-format
+msgid "constraint_exclusion"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:187
+#, no-c-format
+msgid ""
+"Default: off (prior to PostgreSQL 8.4 and for PostgreSQL 8.4+ is set to "
+"partition)"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:192
+#, no-c-format
+msgid ""
+"This is generally used for table partitioning. If you are running PostgreSQL "
+"versions below 8.4, set to \"on\" to ensure the query planner will optimize "
+"as desired. As of PostgreSQL 8.4, the default for this is set to \"partition"
+"\" which is ideal for PostgreSQL 8.4 and above since it will force the "
+"planner to only analyze tables for constraint consideration if they are in "
+"an inherited hierarchy and not pay the planner penalty otherwise."
+msgstr ""
+
+#. Tag: ulink
+#: performance_tips.xml:202
+#, no-c-format
+msgid "shared_buffers"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:207
+#, no-c-format
+msgid "Default: ~32MB"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:212
+#, no-c-format
+msgid "Set to about 1/3 to 3/4 of available RAM"
+msgstr ""
+
+#. Tag: title
+#: performance_tips.xml:220
+#, no-c-format
+msgid "Runtime"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:222
+#, no-c-format
+msgid ""
+"<ulink url=\"http://www.postgresql.org/docs/current/static/runtime-config-"
+"resource.html#GUC-WORK-MEM\">work_mem</ulink> (the memory used for sort "
+"operations and complex queries)"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:228
+#, no-c-format
+msgid "Default: 1MB"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:233
+#, no-c-format
+msgid "Adjust up for large dbs, complex queries, lots of RAM"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:238
+#, no-c-format
+msgid "Adjust down for many concurrent users or low RAM."
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:243
+#, no-c-format
+msgid "If you have lots of RAM and few developers:"
+msgstr ""
+
+#. Tag: programlisting
+#: performance_tips.xml:245
+#, no-c-format
+msgid "SET work_mem TO 1200000;"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:250
+#, no-c-format
+msgid ""
+"<ulink url=\"http://www.postgresql.org/docs/current/static/runtime-config-"
+"resource.html#GUC-MAINTENANCE-WORK-MEM\">maintenance_work_mem</ulink> (used "
+"for VACUUM, CREATE INDEX, etc.)"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:256
+#, no-c-format
+msgid "Default: 16MB"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:261
+#, no-c-format
+msgid "Generally too low - ties up I/O, locks objects while swapping memory"
+msgstr ""
+
+#. Tag: para
+#: performance_tips.xml:266
+#, no-c-format
+msgid ""
+"Recommend 32MB to 256MB on production servers w/lots of RAM, but depends on "
+"the # of concurrent users. If you have lots of RAM and few developers:"
+msgstr ""
+
+#. Tag: programlisting
+#: performance_tips.xml:269
+#, no-c-format
+msgid "SET maintainence_work_mem TO 1200000;"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# Jakub Bobrowski <jb@5dstudio.pl>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2014-10-14 22:30+0000\n"
+"PO-Revision-Date: 2014-10-14 22:36+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: postgis.xml:127
+#, no-c-format
+msgid "PostGIS &last_release_version; Manual"
+msgstr "PostGIS &last_release_version;. Podręcznik"
+
+#. Tag: corpauthor
+#: postgis.xml:131
+#, no-c-format
+msgid "The PostGIS Development Group"
+msgstr ""
+
+#. Tag: affiliation
+#: postgis.xml:137
+#, no-c-format
+msgid ""
+"<orgname><ulink url=\"http://www.cleverelephant.ca\">clever elephant</"
+"ulink></orgname> <address><city>Victoria</city> <state>British Columbia</"
+"state> <country>Canada</country> <email>pramsey@cleverelephant.ca</email></"
+"address>"
+msgstr ""
+"<orgname><ulink url=\"http://www.cleverelephant.ca\">clever elephant</"
+"ulink></orgname> <address><city>Victoria</city> <state>British Columbia</"
+"state> <country>Canada</country> <email>pramsey@cleverelephant.ca</email></"
+"address>"
+
+#. Tag: para
+#: postgis.xml:151
+#, no-c-format
+msgid ""
+"PostGIS is an extension to the PostgreSQL object-relational database system "
+"which allows GIS (Geographic Information Systems) objects to be stored in "
+"the database. PostGIS includes support for GiST-based R-Tree spatial "
+"indexes, and functions for analysis and processing of GIS objects."
+msgstr ""
+"PostGIS jest rozszerzeniem relacyjno-obiektowego systemu bazy danych "
+"PostgreSQL, który pozwala na przechowywanie obiektów GIS (Geographic "
+"Information Systems) w bazie danych. PostGIS posiada wsparcie dla indeksów "
+"przestrzennych opartych na algorytmach GiST i R-Tree, oraz funkcje "
+"pozwalające na analizowanie i przetwarzanie obiektów GIS."
+
+#. Tag: para
+#: postgis.xml:160
+#, no-c-format
+msgid "This is the manual for version &last_release_version;"
+msgstr "Podręcznik dla wersji &last_release_version;"
+
+#. Tag: para
+#: postgis.xml:161
+#, no-c-format
+msgid ""
+"This work is licensed under a <ulink url=\"http://creativecommons.org/"
+"licenses/by-sa/3.0/\">Creative Commons Attribution-Share Alike 3.0 License</"
+"ulink>. Feel free to use this material any way you like, but we ask that you "
+"attribute credit to the PostGIS Project and wherever possible, a link back "
+"to <ulink url=\"http://postgis.net\">http://postgis.net</ulink>."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference.xml:3
+#, no-c-format
+msgid "PostGIS Reference"
+msgstr ""
+
+#. Tag: para
+#: reference.xml:5
+#, no-c-format
+msgid ""
+"The functions given below are the ones which a user of PostGIS is likely to "
+"need. There are other functions which are required support functions to the "
+"PostGIS objects which are not of use to a general user."
+msgstr ""
+
+#. Tag: para
+#: reference.xml:11
+#, no-c-format
+msgid ""
+"PostGIS has begun a transition from the existing naming convention to an SQL-"
+"MM-centric convention. As a result, most of the functions that you know and "
+"love have been renamed using the standard spatial type (ST) prefix. Previous "
+"functions are still available, though are not listed in this document where "
+"updated functions are equivalent. The non ST_ functions not listed in this "
+"documentation are deprecated and will be removed in a future release so STOP "
+"USING THEM."
+msgstr ""
+
+#. Tag: chapter
+#: reference.xml:16
+#, no-c-format
+msgid ""
+"&reference_type; &reference_management; &reference_constructor; "
+"&reference_accessor; &reference_editor; &reference_output; "
+"&reference_operator; &reference_measure; &reference_processing; "
+"&reference_lrs; &reference_transaction; &reference_misc; "
+"&reference_exception;"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_accessor.xml:4
+#, no-c-format
+msgid "Geometry Accessors"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:8
+#, no-c-format
+msgid "GeometryType"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:10
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the type of the geometry as a string. Eg: 'LINESTRING', "
+"'POLYGON', 'MULTIPOINT', etc.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:16
+#, no-c-format
+msgid ""
+"<funcdef>text <function>GeometryType</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: title
+#: reference_accessor.xml:24 reference_accessor.xml:81
+#: reference_accessor.xml:128 reference_accessor.xml:176
+#: reference_accessor.xml:224 reference_accessor.xml:273
+#: reference_accessor.xml:325 reference_accessor.xml:374
+#: reference_accessor.xml:435 reference_accessor.xml:486
+#: reference_accessor.xml:545 reference_accessor.xml:604
+#: reference_accessor.xml:659 reference_accessor.xml:703
+#: reference_accessor.xml:754 reference_accessor.xml:811
+#: reference_accessor.xml:876 reference_accessor.xml:928
+#: reference_accessor.xml:987 reference_accessor.xml:1033
+#: reference_accessor.xml:1068 reference_accessor.xml:1107
+#: reference_accessor.xml:1147 reference_accessor.xml:1193
+#: reference_accessor.xml:1232 reference_accessor.xml:1265
+#: reference_accessor.xml:1306 reference_accessor.xml:1350
+#: reference_accessor.xml:1407 reference_accessor.xml:1460
+#: reference_accessor.xml:1503 reference_accessor.xml:1554
+#: reference_accessor.xml:1618 reference_accessor.xml:1661
+#: reference_accessor.xml:1706 reference_accessor.xml:1752
+#: reference_accessor.xml:1794 reference_accessor.xml:1839
+#: reference_accessor.xml:1885 reference_accessor.xml:1927
+#: reference_accessor.xml:1973 reference_accessor.xml:2014
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:26
+#, no-c-format
+msgid ""
+"<para>Returns the type of the geometry as a string. Eg: 'LINESTRING', "
+"'POLYGON', 'MULTIPOINT', etc.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:29
+#, no-c-format
+msgid ""
+"OGC SPEC s2.1.1.1 - Returns the name of the instantiable subtype of Geometry "
+"of which this Geometry instance is a member. The name of the instantiable "
+"subtype of Geometry is returned as a string."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:35
+#, no-c-format
+msgid ""
+"This function also indicates if the geometry is measured, by returning a "
+"string of the form 'POINTM'."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:38 reference_accessor.xml:388
+#: reference_accessor.xml:1152
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was "
+"introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:39 reference_accessor.xml:134
+#: reference_accessor.xml:390 reference_accessor.xml:497
+#: reference_accessor.xml:550 reference_accessor.xml:830
+#: reference_accessor.xml:996 reference_accessor.xml:1272
+#: reference_accessor.xml:1314 reference_accessor.xml:1423
+#: reference_accessor.xml:1757
+#, no-c-format
+msgid "&sfs_compliant;"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:40 reference_accessor.xml:136
+#: reference_accessor.xml:393 reference_accessor.xml:559
+#: reference_accessor.xml:624 reference_accessor.xml:670
+#: reference_accessor.xml:1074 reference_accessor.xml:1112
+#: reference_accessor.xml:1426 reference_accessor.xml:1468
+#: reference_accessor.xml:1671 reference_accessor.xml:1716
+#: reference_accessor.xml:1804 reference_accessor.xml:1849
+#: reference_accessor.xml:1937 reference_accessor.xml:1979
+#: reference_accessor.xml:2024
+#, no-c-format
+msgid "&curve_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:41 reference_accessor.xml:96
+#: reference_accessor.xml:137 reference_accessor.xml:231
+#: reference_accessor.xml:334 reference_accessor.xml:392
+#: reference_accessor.xml:441 reference_accessor.xml:499
+#: reference_accessor.xml:558 reference_accessor.xml:623
+#: reference_accessor.xml:768 reference_accessor.xml:998
+#: reference_accessor.xml:1038 reference_accessor.xml:1073
+#: reference_accessor.xml:1111 reference_accessor.xml:1156
+#: reference_accessor.xml:1271 reference_accessor.xml:1367
+#: reference_accessor.xml:1425 reference_accessor.xml:1510
+#: reference_accessor.xml:1626 reference_accessor.xml:1670
+#: reference_accessor.xml:1715 reference_accessor.xml:1759
+#: reference_accessor.xml:1803 reference_accessor.xml:1848
+#: reference_accessor.xml:1893 reference_accessor.xml:1936
+#: reference_accessor.xml:1978 reference_accessor.xml:2023
+#, no-c-format
+msgid "&Z_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:42 reference_accessor.xml:138
+#: reference_accessor.xml:189 reference_accessor.xml:394
+#: reference_accessor.xml:442 reference_accessor.xml:562
+#: reference_accessor.xml:1075 reference_accessor.xml:1157
+#: reference_accessor.xml:1274 reference_accessor.xml:1368
+#, no-c-format
+msgid "&P_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:43 reference_accessor.xml:139
+#: reference_accessor.xml:190 reference_accessor.xml:395
+#: reference_accessor.xml:1158
+#, no-c-format
+msgid "&T_support;"
+msgstr ""
+
+#. Tag: title
+#: reference_accessor.xml:49 reference_accessor.xml:100
+#: reference_accessor.xml:144 reference_accessor.xml:194
+#: reference_accessor.xml:241 reference_accessor.xml:295
+#: reference_accessor.xml:339 reference_accessor.xml:447
+#: reference_accessor.xml:505 reference_accessor.xml:629
+#: reference_accessor.xml:677 reference_accessor.xml:722
+#: reference_accessor.xml:773 reference_accessor.xml:837
+#: reference_accessor.xml:893 reference_accessor.xml:953
+#: reference_accessor.xml:1004 reference_accessor.xml:1042
+#: reference_accessor.xml:1080 reference_accessor.xml:1117
+#: reference_accessor.xml:1163 reference_accessor.xml:1204
+#: reference_accessor.xml:1278 reference_accessor.xml:1319
+#: reference_accessor.xml:1374 reference_accessor.xml:1432
+#: reference_accessor.xml:1473 reference_accessor.xml:1520
+#: reference_accessor.xml:1574 reference_accessor.xml:1632
+#: reference_accessor.xml:1676 reference_accessor.xml:1721
+#: reference_accessor.xml:1765 reference_accessor.xml:1809
+#: reference_accessor.xml:1854 reference_accessor.xml:1898
+#: reference_accessor.xml:1942 reference_accessor.xml:1984
+#: reference_accessor.xml:2029
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:51
+#, no-c-format
+msgid ""
+"SELECT GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 "
+"29.26,77.27 29.31,77.29 29.07)'));\n"
+" geometrytype\n"
+"--------------\n"
+" LINESTRING"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:52
+#, no-c-format
+msgid ""
+"SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 "
+"1 1, 0 1 0, 0 0 0)), \n"
+" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 "
+"1, 0 0 1, 0 0 0)), \n"
+" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 "
+"1, 0 1 1, 0 0 1)) )'));\n"
+" --result\n"
+" POLYHEDRALSURFACE"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:53
+#, no-c-format
+msgid ""
+"SELECT GeometryType(geom) as result\n"
+" FROM\n"
+" (SELECT \n"
+" ST_GeomFromEWKT('TIN (((\n"
+" 0 0 0, \n"
+" 0 0 1, \n"
+" 0 1 0, \n"
+" 0 0 0\n"
+" )), ((\n"
+" 0 0 0, \n"
+" 0 1 0, \n"
+" 1 1 0, \n"
+" 0 0 0\n"
+" ))\n"
+" )') AS geom\n"
+" ) AS g;\n"
+" result\n"
+"--------\n"
+" TIN"
+msgstr ""
+
+#. Tag: title
+#: reference_accessor.xml:58 reference_accessor.xml:105
+#: reference_accessor.xml:151 reference_accessor.xml:199
+#: reference_accessor.xml:247 reference_accessor.xml:300
+#: reference_accessor.xml:344 reference_accessor.xml:414
+#: reference_accessor.xml:458 reference_accessor.xml:512
+#: reference_accessor.xml:579 reference_accessor.xml:635
+#: reference_accessor.xml:728 reference_accessor.xml:779
+#: reference_accessor.xml:843 reference_accessor.xml:900
+#: reference_accessor.xml:960 reference_accessor.xml:1010
+#: reference_accessor.xml:1047 reference_accessor.xml:1085
+#: reference_accessor.xml:1124 reference_accessor.xml:1168
+#: reference_accessor.xml:1209 reference_accessor.xml:1243
+#: reference_accessor.xml:1283 reference_accessor.xml:1324
+#: reference_accessor.xml:1381 reference_accessor.xml:1438
+#: reference_accessor.xml:1478 reference_accessor.xml:1526
+#: reference_accessor.xml:1580 reference_accessor.xml:1638
+#: reference_accessor.xml:1683 reference_accessor.xml:1728
+#: reference_accessor.xml:1771 reference_accessor.xml:1816
+#: reference_accessor.xml:1861 reference_accessor.xml:1904
+#: reference_accessor.xml:1949 reference_accessor.xml:1991
+#: reference_accessor.xml:2036
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:64
+#, no-c-format
+msgid "ST_Boundary"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:66
+#, no-c-format
+msgid "Returns the closure of the combinatorial boundary of this Geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:72
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Boundary</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:83
+#, no-c-format
+msgid ""
+"Returns the closure of the combinatorial boundary of this Geometry. The "
+"combinatorial boundary is defined as described in section 3.12.3.2 of the "
+"OGC SPEC. Because the result of this function is a closure, and hence "
+"topologically closed, the resulting boundary can be represented using "
+"representational geometry primitives as discussed in the OGC SPEC, section "
+"3.12.2."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:90
+#, no-c-format
+msgid "Performed by the GEOS module"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:92
+#, no-c-format
+msgid ""
+"Prior to 2.0.0, this function throws an exception if used with "
+"<varname>GEOMETRYCOLLECTION</varname>. From 2.0.0 up it will return NULL "
+"instead (unsupported input)."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:94
+#, no-c-format
+msgid "&sfs_compliant; OGC SPEC s2.1.1.1"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:95
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.14"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:102
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Boundary(ST_GeomFromText('LINESTRING(1 1,0 0, -1 "
+"1)')));\n"
+"st_astext\n"
+"-----------\n"
+"MULTIPOINT(1 1,-1 1)\n"
+"\n"
+"SELECT ST_AsText(ST_Boundary(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 "
+"1))')));\n"
+"st_astext\n"
+"----------\n"
+"LINESTRING(1 1,0 0,-1 1,1 1)\n"
+"\n"
+"--Using a 3d polygon\n"
+"SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('POLYGON((1 1 1,0 0 1, -1 1 1, "
+"1 1 1))')));\n"
+"\n"
+"st_asewkt\n"
+"-----------------------------------\n"
+"LINESTRING(1 1 1,0 0 1,-1 1 1,1 1 1)\n"
+"\n"
+"--Using a 3d multilinestring\n"
+"SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('MULTILINESTRING((1 1 1,0 0 "
+"0.5, -1 1 1),(1 1 0.5,0 0 0.5, -1 1 0.5, 1 1 0.5) )')));\n"
+"\n"
+"st_asewkt\n"
+"----------\n"
+"MULTIPOINT(-1 1 1,1 1 0.75)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:107
+#, no-c-format
+msgid ", <xref linkend=\"ST_MakePolygon\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:113
+#, no-c-format
+msgid "ST_CoordDim"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:115
+#, no-c-format
+msgid ""
+"<refpurpose>Return the coordinate dimension of the ST_Geometry value.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:120
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_CoordDim</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:130
+#, no-c-format
+msgid "<para>Return the coordinate dimension of the ST_Geometry value.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:132
+#, no-c-format
+msgid "This is the MM compliant alias name for <xref linkend=\"ST_NDims\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:135
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.3"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:146
+#, no-c-format
+msgid ""
+"SELECT ST_CoordDim('CIRCULARSTRING(1 2 3, 1 3 4, 5 6 7, 8 9 10, 11 12 "
+"13)');\n"
+" ---result--\n"
+" 3\n"
+"\n"
+" SELECT ST_CoordDim(ST_Point(1,2));\n"
+" --result--\n"
+" 2"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:159
+#, no-c-format
+msgid "ST_Dimension"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:161
+#, no-c-format
+msgid ""
+"The inherent dimension of this Geometry object, which must be less than or "
+"equal to the coordinate dimension."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:167
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_Dimension</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:178
+#, no-c-format
+msgid ""
+"The inherent dimension of this Geometry object, which must be less than or "
+"equal to the coordinate dimension. OGC SPEC s2.1.1.1 - returns 0 for "
+"<varname>POINT</varname>, 1 for <varname>LINESTRING</varname>, 2 for "
+"<varname>POLYGON</varname>, and the largest dimension of the components of a "
+"<varname>GEOMETRYCOLLECTION</varname>. If unknown (empty geometry) null is "
+"returned."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:186
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.2"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:187
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for Polyhedral surfaces and TINs was introduced. No "
+"longer throws an exception if given empty geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:188
+#, no-c-format
+msgid ""
+"Prior to 2.0.0, this function throws an exception if used with empty "
+"geometry."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:196
+#, no-c-format
+msgid ""
+"SELECT ST_Dimension('GEOMETRYCOLLECTION(LINESTRING(1 1,0 0),POINT(0 0))');\n"
+"ST_Dimension\n"
+"-----------\n"
+"1"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:207
+#, no-c-format
+msgid "ST_EndPoint"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:209
+#, no-c-format
+msgid ""
+"Returns the last point of a <varname>LINESTRING</varname> geometry as a "
+"<varname>POINT</varname>."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:215
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_EndPoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:226
+#, no-c-format
+msgid ""
+"Returns the last point of a <varname>LINESTRING</varname> geometry as a "
+"<varname>POINT</varname> or <varname>NULL</varname> if the input parameter "
+"is not a <varname>LINESTRING</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:230
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.1.4"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:232 reference_accessor.xml:1511
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 no longer works with single geometry multilinestrings. In "
+"older versions of PostGIS -- a single line multilinestring would work "
+"happily with this function and return the start point. In 2.0.0 it just "
+"returns NULL like any other multilinestring. The older behavior was an "
+"undocumented feature, but people who assumed they had their data stored as "
+"LINESTRING may experience these returning NULL in 2.0 now."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:243
+#, no-c-format
+msgid ""
+"postgis=# SELECT ST_AsText(ST_EndPoint('LINESTRING(1 1, 2 2, 3 3)'::"
+"geometry));\n"
+" st_astext\n"
+"------------\n"
+" POINT(3 3)\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_EndPoint('POINT(1 1)'::geometry) IS NULL AS is_null;\n"
+" is_null\n"
+"----------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"--3d endpoint\n"
+"SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));\n"
+" st_asewkt\n"
+"--------------\n"
+" POINT(0 0 5)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:249
+#, no-c-format
+msgid ", <xref linkend=\"ST_StartPoint\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:256
+#, no-c-format
+msgid "ST_Envelope"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:258
+#, no-c-format
+msgid ""
+"Returns a geometry representing the double precision (float8) bounding box "
+"of the supplied geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:264
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Envelope</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:275
+#, no-c-format
+msgid ""
+"Returns the float8 minimum bounding box for the supplied geometry, as a "
+"geometry. The polygon is defined by the corner points of the bounding box "
+"((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</"
+"varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</"
+"varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), "
+"(<varname>MINX</varname>, <varname>MINY</varname>)). (PostGIS will add a "
+"<varname>ZMIN</varname>/<varname>ZMAX</varname> coordinate as well)."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:285
+#, no-c-format
+msgid ""
+"Degenerate cases (vertical lines, points) will return a geometry of lower "
+"dimension than <varname>POLYGON</varname>, ie. <varname>POINT</varname> or "
+"<varname>LINESTRING</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:289
+#, no-c-format
+msgid ""
+"Availability: 1.5.0 behavior changed to output double precision instead of "
+"float4"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:290 reference_accessor.xml:668
+#: reference_accessor.xml:766 reference_accessor.xml:1466
+#, no-c-format
+msgid "&sfs_compliant; s2.1.1.1"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:291
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.15"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:297
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Envelope('POINT(1 3)'::geometry));\n"
+" st_astext\n"
+"------------\n"
+" POINT(1 3)\n"
+"(1 row)\n"
+"\n"
+"\n"
+"SELECT ST_AsText(ST_Envelope('LINESTRING(0 0, 1 3)'::geometry));\n"
+" st_astext\n"
+"--------------------------------\n"
+" POLYGON((0 0,0 3,1 3,1 0,0 0))\n"
+"(1 row)\n"
+"\n"
+"\n"
+"SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000001 1, 1.0000001 0, 0 "
+"0))'::geometry));\n"
+" st_astext\n"
+"--------------------------------------------------------------\n"
+" POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))\n"
+"(1 row)\n"
+"SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000000001 1, "
+"1.0000000001 0, 0 0))'::geometry));\n"
+" st_astext\n"
+"--------------------------------------------------------------\n"
+" POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))\n"
+"(1 row)\n"
+" \n"
+"SELECT Box3D(geom), Box2D(geom), ST_AsText(ST_Envelope(geom)) As "
+"envelopewkt\n"
+" FROM (SELECT 'POLYGON((0 0, 0 1000012333334.34545678, 1.0000001 1, "
+"1.0000001 0, 0 0))'::geometry As geom) As foo;\n"
+"\n"
+"<!-- TODO: Fix examples to reflect new behavior -->"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:302
+#, no-c-format
+msgid ", <xref linkend=\"Box3D\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:308
+#, no-c-format
+msgid "ST_ExteriorRing"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:310
+#, no-c-format
+msgid ""
+"Returns a line string representing the exterior ring of the "
+"<varname>POLYGON</varname> geometry. Return NULL if the geometry is not a "
+"polygon. Will not work with MULTIPOLYGON"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:316
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_ExteriorRing</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_polygon</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:327
+#, no-c-format
+msgid ""
+"Returns a line string representing the exterior ring of the "
+"<varname>POLYGON</varname> geometry. Return NULL if the geometry is not a "
+"polygon."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:330
+#, no-c-format
+msgid "Only works with POLYGON geometry types"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:332 reference_accessor.xml:712
+#, no-c-format
+msgid "&sfs_compliant; 2.1.5.1"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:333
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.2.3, 8.3.3"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:340
+#, no-c-format
+msgid ""
+"--If you have a table of polygons\n"
+"SELECT gid, ST_ExteriorRing(the_geom) AS ering\n"
+"FROM sometable;\n"
+"\n"
+"--If you have a table of MULTIPOLYGONs\n"
+"--and want to return a MULTILINESTRING composed of the exterior rings of "
+"each polygon\n"
+"SELECT gid, ST_Collect(ST_ExteriorRing(the_geom)) AS erings\n"
+" FROM (SELECT gid, (ST_Dump(the_geom)).geom As the_geom\n"
+" FROM sometable) As foo\n"
+"GROUP BY gid;\n"
+"\n"
+"--3d Example\n"
+"SELECT ST_AsEWKT(\n"
+" ST_ExteriorRing(\n"
+" ST_GeomFromEWKT('POLYGON((0 0 1, 1 1 1, 1 2 1, 1 1 1, 0 0 1))')\n"
+" )\n"
+");\n"
+"\n"
+"st_asewkt\n"
+"---------\n"
+"LINESTRING(0 0 1,1 1 1,1 2 1,1 1 1,0 0 1)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:346
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Boundary\"/>, <xref linkend=\"ST_NumInteriorRings\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:356
+#, no-c-format
+msgid "ST_GeometryN"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:358
+#, no-c-format
+msgid ""
+"Return the 1-based Nth geometry if the geometry is a GEOMETRYCOLLECTION, "
+"(MULTI)POINT, (MULTI)LINESTRING, MULTICURVE or (MULTI)POLYGON, "
+"POLYHEDRALSURFACE Otherwise, return NULL."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:365
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_GeometryN</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>n</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:376
+#, no-c-format
+msgid ""
+"Return the 1-based Nth geometry if the geometry is a GEOMETRYCOLLECTION, "
+"(MULTI)POINT, (MULTI)LINESTRING, MULTICURVE or (MULTI)POLYGON, "
+"POLYHEDRALSURFACE Otherwise, return NULL"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:381 reference_accessor.xml:1414
+#, no-c-format
+msgid ""
+"Index is 1-based as for OGC specs since version 0.8.0. Previous versions "
+"implemented this as 0-based instead."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:386
+#, no-c-format
+msgid ""
+"If you want to extract all geometries, of a geometry, ST_Dump is more "
+"efficient and will also work for singular geoms."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:389
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 Prior versions would return NULL for singular geometries. "
+"This was changed to return the geometry for ST_GeometryN(..,1) case."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:391
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 9.1.5"
+msgstr ""
+
+#. Tag: title
+#: reference_accessor.xml:401
+#, no-c-format
+msgid "Standard Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:403
+#, no-c-format
+msgid ""
+"--Extracting a subset of points from a 3d multipoint\n"
+"SELECT n, ST_AsEWKT(ST_GeometryN(the_geom, n)) As geomewkt\n"
+"FROM (\n"
+"VALUES (ST_GeomFromEWKT('MULTIPOINT(1 2 7, 3 4 7, 5 6 7, 8 9 10)') ),\n"
+"( ST_GeomFromEWKT('MULTICURVE(CIRCULARSTRING(2.5 2.5,4.5 2.5, 3.5 3.5), (10 "
+"11, 12 11))') )\n"
+" )As foo(the_geom)\n"
+" CROSS JOIN generate_series(1,100) n\n"
+"WHERE n <= ST_NumGeometries(the_geom);\n"
+"\n"
+" n | geomewkt\n"
+"---+-----------------------------------------\n"
+" 1 | POINT(1 2 7)\n"
+" 2 | POINT(3 4 7)\n"
+" 3 | POINT(5 6 7)\n"
+" 4 | POINT(8 9 10)\n"
+" 1 | CIRCULARSTRING(2.5 2.5,4.5 2.5,3.5 3.5)\n"
+" 2 | LINESTRING(10 11,12 11)\n"
+"\n"
+"\n"
+"--Extracting all geometries (useful when you want to assign an id)\n"
+"SELECT gid, n, ST_GeometryN(the_geom, n)\n"
+"FROM sometable CROSS JOIN generate_series(1,100) n\n"
+"WHERE n <= ST_NumGeometries(the_geom);"
+msgstr ""
+
+#. Tag: title
+#: reference_accessor.xml:406
+#, no-c-format
+msgid "Polyhedral Surfaces, TIN and Triangle Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:407
+#, no-c-format
+msgid ""
+"-- Polyhedral surface example\n"
+"-- Break a Polyhedral surface into its faces\n"
+"SELECT ST_AsEWKT(ST_GeometryN(p_geom,3)) As geom_ewkt\n"
+" FROM (SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE( \n"
+"((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n"
+"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), \n"
+"((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)), \n"
+"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), \n"
+"((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) \n"
+")') AS p_geom ) AS a;\n"
+"\n"
+" geom_ewkt\n"
+"------------------------------------------\n"
+" POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:409
+#, no-c-format
+msgid ""
+"-- TIN -- \n"
+"SELECT ST_AsEWKT(ST_GeometryN(geom,2)) as wkt\n"
+" FROM\n"
+" (SELECT \n"
+" ST_GeomFromEWKT('TIN (((\n"
+" 0 0 0, \n"
+" 0 0 1, \n"
+" 0 1 0, \n"
+" 0 0 0\n"
+" )), ((\n"
+" 0 0 0, \n"
+" 0 1 0, \n"
+" 1 1 0, \n"
+" 0 0 0\n"
+" ))\n"
+" )') AS geom\n"
+" ) AS g;\n"
+"-- result --\n"
+" wkt\n"
+"-------------------------------------\n"
+" TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:416 reference_accessor.xml:1285
+#, no-c-format
+msgid ", <xref linkend=\"ST_NumGeometries\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:422
+#, no-c-format
+msgid "ST_GeometryType"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:423
+#, no-c-format
+msgid "Return the geometry type of the ST_Geometry value."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:428
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_GeometryType</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:437
+#, no-c-format
+msgid ""
+"Returns the type of the geometry as a string. EG: 'ST_Linestring', "
+"'ST_Polygon','ST_MultiPolygon' etc. This function differs from "
+"GeometryType(geometry) in the case of the string and ST in front that is "
+"returned, as well as the fact that it will not indicate whether the geometry "
+"is measured."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:439 reference_accessor.xml:560
+#: reference_accessor.xml:1071
+#, no-c-format
+msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:440
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.4"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:449
+#, no-c-format
+msgid ""
+"SELECT ST_GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 "
+"29.26,77.27 29.31,77.29 29.07)'));\n"
+" --result\n"
+" ST_LineString"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:451 reference_accessor.xml:453
+#, no-c-format
+msgid ""
+"SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 "
+"1 1, 0 1 0, 0 0 0)), \n"
+" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 "
+"1, 0 0 1, 0 0 0)), \n"
+" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 "
+"1, 0 1 1, 0 0 1)) )'));\n"
+" --result\n"
+" ST_PolyhedralSurface"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:455
+#, no-c-format
+msgid ""
+"SELECT ST_GeometryType(geom) as result\n"
+" FROM\n"
+" (SELECT \n"
+" ST_GeomFromEWKT('TIN (((\n"
+" 0 0 0, \n"
+" 0 0 1, \n"
+" 0 1 0, \n"
+" 0 0 0\n"
+" )), ((\n"
+" 0 0 0, \n"
+" 0 1 0, \n"
+" 1 1 0, \n"
+" 0 0 0\n"
+" ))\n"
+" )') AS geom\n"
+" ) AS g;\n"
+" result\n"
+"--------\n"
+" ST_Tin"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:468
+#, no-c-format
+msgid "ST_InteriorRingN"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:470
+#, no-c-format
+msgid ""
+"Return the Nth interior linestring ring of the polygon geometry. Return NULL "
+"if the geometry is not a polygon or the given N is out of range."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:477
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_InteriorRingN</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_polygon</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>n</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:488
+#, no-c-format
+msgid ""
+"Return the Nth interior linestring ring of the polygon geometry. Return NULL "
+"if the geometry is not a polygon or the given N is out of range. index "
+"starts at 1."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:494
+#, no-c-format
+msgid ""
+"This will not work for MULTIPOLYGONs. Use in conjunction with ST_Dump for "
+"MULTIPOLYGONS"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:498
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.2.6, 8.3.5"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:507
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_InteriorRingN(the_geom, 1)) As the_geom\n"
+"FROM (SELECT ST_BuildArea(\n"
+" ST_Collect(ST_Buffer(ST_Point(1,2), 20,3),\n"
+" ST_Buffer(ST_Point(1, 2), 10,3))) As the_geom\n"
+" ) as foo"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:514
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Collect\"/>, <xref linkend=\"ST_Dump\"/>, <xref linkend="
+"\"ST_NumInteriorRing\"/>,"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:527
+#, no-c-format
+msgid "ST_IsClosed"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:529
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if the <varname>LINESTRING</varname>'s start "
+"and end points are coincident. For Polyhedral surface is closed (volumetric)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:536
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_IsClosed</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:547
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if the <varname>LINESTRING</varname>'s start "
+"and end points are coincident. For Polyhedral Surfaces, it tells you if the "
+"surface is areal (open) or volumetric (closed)."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:551
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.1.5, 9.3.3"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:553
+#, no-c-format
+msgid ""
+"SQL-MM defines the result of <function>ST_IsClosed(<varname>NULL</varname>)</"
+"function> to be 0, while PostGIS returns <varname>NULL</varname>."
+msgstr ""
+
+#. Tag: title
+#: reference_accessor.xml:567
+#, no-c-format
+msgid "Line String and Point Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:569
+#, no-c-format
+msgid ""
+"postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 1 1)'::geometry);\n"
+" st_isclosed\n"
+"-------------\n"
+" f\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 0 1, 1 1, 0 0)'::geometry);\n"
+" st_isclosed\n"
+"-------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsClosed('MULTILINESTRING((0 0, 0 1, 1 1, 0 0),(0 0, 1 "
+"1))'::geometry);\n"
+" st_isclosed\n"
+"-------------\n"
+" f\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsClosed('POINT(0 0)'::geometry);\n"
+" st_isclosed\n"
+"-------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsClosed('MULTIPOINT((0 0), (1 1))'::geometry);\n"
+" st_isclosed\n"
+"-------------\n"
+" t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: title
+#: reference_accessor.xml:573
+#, no-c-format
+msgid "Polyhedral Surface Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:575
+#, no-c-format
+msgid ""
+"-- A cube --\n"
+" SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 "
+"0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n"
+" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 "
+"1, 0 0 1, 0 0 0)), \n"
+" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 "
+"1, 0 1 1, 0 0 1)) )'));\n"
+"\n"
+" st_isclosed\n"
+"-------------\n"
+" t\n"
+"\n"
+"\n"
+" -- Same as cube but missing a side --\n"
+" SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 "
+"1, 0 1 0, 0 0 0)), \n"
+" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 "
+"1, 0 0 1, 0 0 0)), \n"
+" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)) )'));\n"
+"\n"
+" st_isclosed\n"
+"-------------\n"
+" f"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:587
+#, no-c-format
+msgid "ST_IsCollection"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:589
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if the argument is a collection "
+"(<varname>MULTI*</varname>, <varname>GEOMETRYCOLLECTION</varname>, ...)"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:596
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_IsCollection</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:606
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if the geometry type of the argument is "
+"either:"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:609
+#, no-c-format
+msgid "GEOMETRYCOLLECTION"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:610
+#, no-c-format
+msgid "MULTI{POINT,POLYGON,LINESTRING,CURVE,SURFACE}"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:611
+#, no-c-format
+msgid "COMPOUNDCURVE"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:616
+#, no-c-format
+msgid ""
+"This function analyzes the type of the geometry. This means that it will "
+"return <varname>TRUE</varname> on collections that are empty or that contain "
+"a single element."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:631
+#, no-c-format
+msgid ""
+"postgis=# SELECT ST_IsCollection('LINESTRING(0 0, 1 1)'::geometry);\n"
+" st_iscollection\n"
+"-------------\n"
+" f\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsCollection('MULTIPOINT EMPTY'::geometry);\n"
+" st_iscollection\n"
+"-------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0))'::geometry);\n"
+" st_iscollection\n"
+"-------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0), (42 42))'::geometry);\n"
+" st_iscollection\n"
+"-------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_IsCollection('GEOMETRYCOLLECTION(POINT(0 0))'::"
+"geometry);\n"
+" st_iscollection\n"
+"-------------\n"
+" t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:643
+#, no-c-format
+msgid "ST_IsEmpty"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:645
+#, no-c-format
+msgid ""
+"Returns true if this Geometry is an empty geometrycollection, polygon, point "
+"etc."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:651
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_IsEmpty</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:661
+#, no-c-format
+msgid ""
+"Returns true if this Geometry is an empty geometry. If true, then this "
+"Geometry represents an empty geometry collection, polygon, point etc."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:664
+#, no-c-format
+msgid ""
+"SQL-MM defines the result of ST_IsEmpty(NULL) to be 0, while PostGIS returns "
+"NULL."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:669
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.7"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:671
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 In prior versions of PostGIS "
+"ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now "
+"illegal in PostGIS 2.0.0 to better conform with SQL/MM standards"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:679
+#, no-c-format
+msgid ""
+"SELECT ST_IsEmpty(ST_GeomFromText('GEOMETRYCOLLECTION EMPTY'));\n"
+" st_isempty\n"
+"------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+" SELECT ST_IsEmpty(ST_GeomFromText('POLYGON EMPTY'));\n"
+" st_isempty\n"
+"------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));\n"
+"\n"
+" st_isempty\n"
+"------------\n"
+" f\n"
+"(1 row)\n"
+"\n"
+" SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))')) = "
+"false;\n"
+" ?column?\n"
+"----------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+" SELECT ST_IsEmpty(ST_GeomFromText('CIRCULARSTRING EMPTY'));\n"
+" st_isempty\n"
+"------------\n"
+" t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:686
+#, no-c-format
+msgid "ST_IsRing"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:688
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if this <varname>LINESTRING</varname> is "
+"both closed and simple."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:694
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_IsRing</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:705
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if this <varname>LINESTRING</varname> is "
+"both <xref linkend=\"ST_IsClosed\"/> (<function>ST_StartPoint(<parameter>g</"
+"parameter>)</function> <function>~=</function> "
+"<function>ST_Endpoint(<parameter>g</parameter>)</function>) and <xref "
+"linkend=\"ST_IsSimple\"/> (does not self intersect)."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:713
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.1.6"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:715
+#, no-c-format
+msgid ""
+"SQL-MM defines the result of <function>ST_IsRing(<varname>NULL</varname>)</"
+"function> to be 0, while PostGIS returns <varname>NULL</varname>."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:724
+#, no-c-format
+msgid ""
+"SELECT ST_IsRing(the_geom), ST_IsClosed(the_geom), ST_IsSimple(the_geom)\n"
+"FROM (SELECT 'LINESTRING(0 0, 0 1, 1 1, 1 0, 0 0)'::geometry AS the_geom) AS "
+"foo;\n"
+" st_isring | st_isclosed | st_issimple\n"
+"-----------+-------------+-------------\n"
+" t | t | t\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_IsRing(the_geom), ST_IsClosed(the_geom), ST_IsSimple(the_geom)\n"
+"FROM (SELECT 'LINESTRING(0 0, 0 1, 1 0, 1 1, 0 0)'::geometry AS the_geom) AS "
+"foo;\n"
+" st_isring | st_isclosed | st_issimple\n"
+"-----------+-------------+-------------\n"
+" f | t | f\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:730
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_IsSimple\"/>, <xref linkend=\"ST_StartPoint\"/>, <xref "
+"linkend=\"ST_EndPoint\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:738
+#, no-c-format
+msgid "ST_IsSimple"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:740
+#, no-c-format
+msgid ""
+"Returns (TRUE) if this Geometry has no anomalous geometric points, such as "
+"self intersection or self tangency."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:746
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_IsSimple</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:756
+#, no-c-format
+msgid ""
+"Returns true if this Geometry has no anomalous geometric points, such as "
+"self intersection or self tangency. For more information on the OGC's "
+"definition of geometry simplicity and validity, refer to <link linkend="
+"\"OGC_Validity\">\"Ensuring OpenGIS compliancy of geometries\"</link>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:762
+#, no-c-format
+msgid ""
+"SQL-MM defines the result of ST_IsSimple(NULL) to be 0, while PostGIS "
+"returns NULL."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:767
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.8"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:775
+#, no-c-format
+msgid ""
+"SELECT ST_IsSimple(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));\n"
+" st_issimple\n"
+"-------------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+" SELECT ST_IsSimple(ST_GeomFromText('LINESTRING(1 1,2 2,2 3.5,1 3,1 2,2 "
+"1)'));\n"
+" st_issimple\n"
+"-------------\n"
+" f\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:787
+#, no-c-format
+msgid "ST_IsValid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:789
+#, no-c-format
+msgid ""
+"Returns <varname>true</varname> if the <varname>ST_Geometry</varname> is "
+"well formed."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_accessor.xml:795
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_IsValid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_IsValid</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>g</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>flags</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:813
+#, no-c-format
+msgid ""
+"Test if an ST_Geometry value is well formed. For geometries that are "
+"invalid, the PostgreSQL NOTICE will provide details of why it is not valid. "
+"For more information on the OGC's definition of geometry simplicity and "
+"validity, refer to <link linkend=\"OGC_Validity\">\"Ensuring OpenGIS "
+"compliancy of geometries\"</link>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:819
+#, no-c-format
+msgid ""
+"SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns "
+"NULL."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:823
+#, no-c-format
+msgid ""
+"The version accepting flags is available starting with 2.0.0 and requires "
+"GEOS >= 3.3.0. Such version does not print a NOTICE explaining the "
+"invalidity. Allowed <varname>flags</varname> are documented in <xref linkend="
+"\"ST_IsValidDetail\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:831
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.9"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:839
+#, no-c-format
+msgid ""
+"SELECT ST_IsValid(ST_GeomFromText('LINESTRING(0 0, 1 1)')) As good_line,\n"
+" ST_IsValid(ST_GeomFromText('POLYGON((0 0, 1 1, 1 2, 1 1, 0 0))')) As "
+"bad_poly\n"
+"--results\n"
+"NOTICE: Self-intersection at or near point 0 0\n"
+" good_line | bad_poly\n"
+"-----------+----------\n"
+" t | f"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:845
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_IsValidReason\"/>, <xref linkend=\"ST_IsValidDetail\"/"
+">, <xref linkend=\"ST_Summary\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:856
+#, no-c-format
+msgid "ST_IsValidReason"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:858
+#, no-c-format
+msgid ""
+"Returns text stating if a geometry is valid or not and if not valid, a "
+"reason why."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_accessor.xml:862
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_IsValidReason</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>geomA</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>text "
+"<function>ST_IsValidReason</function></funcdef> <paramdef><type>geometry </"
+"type> <parameter>geomA</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>flags</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:878
+#, no-c-format
+msgid ""
+"Returns text stating if a geometry is valid or not an if not valid, a reason "
+"why."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:880
+#, no-c-format
+msgid ""
+"Useful in combination with ST_IsValid to generate a detailed report of "
+"invalid geometries and reasons."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:882
+#, no-c-format
+msgid ""
+"Allowed <varname>flags</varname> are documented in <xref linkend="
+"\"ST_IsValidDetail\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:886
+#, no-c-format
+msgid "Availability: 1.4 - requires GEOS >= 3.1.0."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:887
+#, no-c-format
+msgid ""
+"Availability: 2.0 - requires GEOS >= 3.3.0 for the version taking flags."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:895
+#, no-c-format
+msgid ""
+"--First 3 Rejects from a successful quintuplet experiment\n"
+"SELECT gid, ST_IsValidReason(the_geom) as validity_info\n"
+"FROM\n"
+"(SELECT ST_MakePolygon(ST_ExteriorRing(e.buff), ST_Accum(f.line)) As "
+"the_geom, gid\n"
+"FROM (SELECT ST_Buffer(ST_MakePoint(x1*10,y1), z1) As buff, x1*10 + y1*100 + "
+"z1*1000 As gid\n"
+" FROM generate_series(-4,6) x1\n"
+" CROSS JOIN generate_series(2,5) y1\n"
+" CROSS JOIN generate_series(1,8) z1\n"
+" WHERE x1 > y1*0.5 AND z1 < x1*y1) As e\n"
+" INNER JOIN (SELECT "
+"ST_Translate(ST_ExteriorRing(ST_Buffer(ST_MakePoint(x1*10,y1), z1)),y1*1, "
+"z1*2) As line\n"
+" FROM generate_series(-3,6) x1\n"
+" CROSS JOIN generate_series(2,5) y1\n"
+" CROSS JOIN generate_series(1,10) z1\n"
+" WHERE x1 > y1*0.75 AND z1 < x1*y1) As f\n"
+"ON (ST_Area(e.buff) > 78 AND ST_Contains(e.buff, f.line))\n"
+"GROUP BY gid, e.buff) As quintuplet_experiment\n"
+"WHERE ST_IsValid(the_geom) = false\n"
+"ORDER BY gid\n"
+"LIMIT 3;\n"
+"\n"
+" gid | validity_info\n"
+"------+--------------------------\n"
+" 5330 | Self-intersection [32 5]\n"
+" 5340 | Self-intersection [42 5]\n"
+" 5350 | Self-intersection [52 5]\n"
+"\n"
+" --simple example\n"
+"SELECT ST_IsValidReason('LINESTRING(220227 150406,2220227 150407,222020 "
+"150410)');\n"
+"\n"
+" st_isvalidreason\n"
+"------------------\n"
+" Valid Geometry"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:902
+#, no-c-format
+msgid ", <xref linkend=\"ST_Summary\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:908
+#, no-c-format
+msgid "ST_IsValidDetail"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:910
+#, no-c-format
+msgid ""
+"Returns a valid_detail (valid,reason,location) row stating if a geometry is "
+"valid or not and if not valid, a reason why and a location where."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_accessor.xml:914
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>valid_detail <function>ST_IsValidDetail</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>geom</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>valid_detail "
+"<function>ST_IsValidDetail</function></funcdef> <paramdef><type>geometry </"
+"type> <parameter>geom</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>flags</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:930
+#, no-c-format
+msgid ""
+"Returns a valid_detail row, formed by a boolean (valid) stating if a "
+"geometry is valid, a varchar (reason) stating a reason why it is invalid and "
+"a geometry (location) pointing out where it is invalid."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:932
+#, no-c-format
+msgid ""
+"Useful to substitute and improve the combination of ST_IsValid and "
+"ST_IsValidReason to generate a detailed report of invalid geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:934
+#, no-c-format
+msgid "The 'flags' argument is a bitfield. It can have the following values:"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:938
+#, no-c-format
+msgid ""
+"1: Consider self-intersecting rings forming holes as valid. This is also "
+"know as \"the ESRI flag\". Note that this is against the OGC model."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:947
+#, no-c-format
+msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:955
+#, no-c-format
+msgid ""
+"--First 3 Rejects from a successful quintuplet experiment\n"
+"SELECT gid, reason(ST_IsValidDetail(the_geom)), "
+"ST_AsText(location(ST_IsValidDetail(the_geom))) as location \n"
+"FROM\n"
+"(SELECT ST_MakePolygon(ST_ExteriorRing(e.buff), ST_Accum(f.line)) As "
+"the_geom, gid\n"
+"FROM (SELECT ST_Buffer(ST_MakePoint(x1*10,y1), z1) As buff, x1*10 + y1*100 + "
+"z1*1000 As gid\n"
+" FROM generate_series(-4,6) x1\n"
+" CROSS JOIN generate_series(2,5) y1\n"
+" CROSS JOIN generate_series(1,8) z1\n"
+" WHERE x1 > y1*0.5 AND z1 < x1*y1) As e\n"
+" INNER JOIN (SELECT "
+"ST_Translate(ST_ExteriorRing(ST_Buffer(ST_MakePoint(x1*10,y1), z1)),y1*1, "
+"z1*2) As line\n"
+" FROM generate_series(-3,6) x1\n"
+" CROSS JOIN generate_series(2,5) y1\n"
+" CROSS JOIN generate_series(1,10) z1\n"
+" WHERE x1 > y1*0.75 AND z1 < x1*y1) As f\n"
+"ON (ST_Area(e.buff) > 78 AND ST_Contains(e.buff, f.line))\n"
+"GROUP BY gid, e.buff) As quintuplet_experiment\n"
+"WHERE ST_IsValid(the_geom) = false\n"
+"ORDER BY gid\n"
+"LIMIT 3;\n"
+"\n"
+" gid | reason | location\n"
+"------+-------------------+-------------\n"
+" 5330 | Self-intersection | POINT(32 5)\n"
+" 5340 | Self-intersection | POINT(42 5)\n"
+" 5350 | Self-intersection | POINT(52 5)\n"
+"\n"
+" --simple example\n"
+"SELECT * FROM ST_IsValidDetail('LINESTRING(220227 150406,2220227 "
+"150407,222020 150410)');\n"
+"\n"
+" valid | reason | location\n"
+"-------+--------+----------\n"
+" t | |"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:962
+#, no-c-format
+msgid ", <xref linkend=\"ST_IsValidReason\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:971
+#, no-c-format
+msgid "ST_M"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:973
+#, no-c-format
+msgid ""
+"<refpurpose>Return the M coordinate of the point, or NULL if not available. "
+"Input must be a point.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:979
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_M</function></funcdef> <paramdef><type>geometry "
+"</type> <parameter>a_point</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:989
+#, no-c-format
+msgid ""
+"<para>Return the M coordinate of the point, or NULL if not available. Input "
+"must be a point.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:993
+#, no-c-format
+msgid ""
+"This is not (yet) part of the OGC spec, but is listed here to complete the "
+"point coordinate extractor function list."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:997 reference_accessor.xml:1892
+#, no-c-format
+msgid "&sqlmm_compliant;"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1005
+#, no-c-format
+msgid ""
+"SELECT ST_M(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n"
+" st_m\n"
+"------\n"
+" 4\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1012
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_X\"/>, <xref linkend=\"ST_Y\"/>, <xref linkend=\"ST_Z\"/"
+">"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1018
+#, no-c-format
+msgid "ST_NDims"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1019
+#, no-c-format
+msgid ""
+"Returns coordinate dimension of the geometry as a small int. Values are: 2,3 "
+"or 4."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1025
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NDims</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1035
+#, no-c-format
+msgid ""
+"Returns the coordinate dimension of the geometry. PostGIS supports 2 - (x,"
+"y) , 3 - (x,y,z) or 2D with measure - x,y,m, and 4 - 3D with measure space x,"
+"y,z,m"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1044
+#, no-c-format
+msgid ""
+"SELECT ST_NDims(ST_GeomFromText('POINT(1 1)')) As d2point,\n"
+" ST_NDims(ST_GeomFromEWKT('POINT(1 1 2)')) As d3point,\n"
+" ST_NDims(ST_GeomFromEWKT('POINTM(1 1 0.5)')) As d2pointm;\n"
+"\n"
+" d2point | d3point | d2pointm\n"
+"---------+---------+----------\n"
+" 2 | 3 | 3"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1048
+#, no-c-format
+msgid ", <xref linkend=\"ST_Dimension\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1054
+#, no-c-format
+msgid "ST_NPoints"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1055
+#, no-c-format
+msgid "Return the number of points (vertexes) in a geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1060
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NPoints</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1070
+#, no-c-format
+msgid "Return the number of points in a geometry. Works for all geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1072
+#, no-c-format
+msgid ""
+"Prior to 1.3.4, this function crashes if used with geometries that contain "
+"CURVES. This is fixed in 1.3.4+"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1082
+#, no-c-format
+msgid ""
+"SELECT ST_NPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 "
+"29.31,77.29 29.07)'));\n"
+"--result\n"
+"4\n"
+"\n"
+"--Polygon in 3D space\n"
+"SELECT ST_NPoints(ST_GeomFromEWKT('LINESTRING(77.29 29.07 1,77.42 29.26 "
+"0,77.27 29.31 -1,77.29 29.07 3)'))\n"
+"--result\n"
+"4"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1093
+#, no-c-format
+msgid "ST_NRings"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1094
+#, no-c-format
+msgid ""
+"If the geometry is a polygon or multi-polygon returns the number of rings."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1099
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NRings</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1109
+#, no-c-format
+msgid ""
+"If the geometry is a polygon or multi-polygon returns the number of rings. "
+"Unlike NumInteriorRings, it counts the outer rings as well."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1119
+#, no-c-format
+msgid ""
+"SELECT ST_NRings(the_geom) As Nrings, ST_NumInteriorRings(the_geom) As "
+"ninterrings\n"
+" FROM (SELECT "
+"ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))') As the_geom) As foo;\n"
+" nrings | ninterrings\n"
+"--------+-------------\n"
+" 1 | 0\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1132
+#, no-c-format
+msgid "ST_NumGeometries"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1133
+#, no-c-format
+msgid ""
+"If geometry is a GEOMETRYCOLLECTION (or MULTI*) return the number of "
+"geometries, for single geometries will return 1, otherwise return NULL."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1139
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NumGeometries</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1149
+#, no-c-format
+msgid ""
+"Returns the number of Geometries. If geometry is a GEOMETRYCOLLECTION (or "
+"MULTI*) return the number of geometries, for single geometries will return "
+"1, otherwise return NULL."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1153
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 In prior versions this would return NULL if the geometry was "
+"not a collection/MULTI type. 2.0.0+ now returns 1 for single geometries e.g "
+"POLYGON, LINESTRING, POINT."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1155
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 9.1.4"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1165
+#, no-c-format
+msgid ""
+"--Prior versions would have returned NULL for this -- in 2.0.0 this returns "
+"1\n"
+"SELECT ST_NumGeometries(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 "
+"29.26,77.27 29.31,77.29 29.07)'));\n"
+"--result\n"
+"1\n"
+"\n"
+"--Geometry Collection Example - multis count as one geom in a collection\n"
+"SELECT ST_NumGeometries(ST_GeomFromEWKT('GEOMETRYCOLLECTION(MULTIPOINT(-2 "
+"3 , -2 2),\n"
+"LINESTRING(5 5 ,10 10),\n"
+"POLYGON((-7 4.2,-7.1 5,-7.1 4.3,-7 4.2)))'));\n"
+"--result\n"
+"3"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1170
+#, no-c-format
+msgid ", <xref linkend=\"ST_Multi\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1176
+#, no-c-format
+msgid "ST_NumInteriorRings"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1177
+#, no-c-format
+msgid ""
+"<refpurpose>Return the number of interior rings of the first polygon in the "
+"geometry. This will work with both POLYGON and MULTIPOLYGON types but only "
+"looks at the first polygon. Return NULL if there is no polygon in the "
+"geometry.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1185
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NumInteriorRings</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_polygon</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1195
+#, no-c-format
+msgid ""
+"<para>Return the number of interior rings of the first polygon in the "
+"geometry. This will work with both POLYGON and MULTIPOLYGON types but only "
+"looks at the first polygon. Return NULL if there is no polygon in the "
+"geometry.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1200 reference_accessor.xml:1239
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.2.5"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1206
+#, no-c-format
+msgid ""
+"--If you have a regular polygon\n"
+"SELECT gid, field1, field2, ST_NumInteriorRings(the_geom) AS numholes\n"
+"FROM sometable;\n"
+"\n"
+"--If you have multipolygons\n"
+"--And you want to know the total number of interior rings in the "
+"MULTIPOLYGON\n"
+"SELECT gid, field1, field2, SUM(ST_NumInteriorRings(the_geom)) AS numholes\n"
+"FROM (SELECT gid, field1, field2, (ST_Dump(the_geom)).geom As the_geom\n"
+" FROM sometable) As foo\n"
+"GROUP BY gid, field1,field2;"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1217
+#, no-c-format
+msgid "ST_NumInteriorRing"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1218
+#, no-c-format
+msgid ""
+"Return the number of interior rings of the first polygon in the geometry. "
+"Synonym to ST_NumInteriorRings."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1224
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NumInteriorRing</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_polygon</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1234
+#, no-c-format
+msgid ""
+"Return the number of interior rings of the first polygon in the geometry. "
+"Synonym to ST_NumInteriorRings. The OpenGIS specs are ambiguous about the "
+"exact function naming, so we provide both spellings."
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1251
+#, no-c-format
+msgid "ST_NumPatches"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1252
+#, no-c-format
+msgid ""
+"Return the number of faces on a Polyhedral Surface. Will return null for non-"
+"polyhedral geometries."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1257
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NumPatches</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1267
+#, no-c-format
+msgid ""
+"Return the number of faces on a Polyhedral Surface. Will return null for non-"
+"polyhedral geometries. This is an alias for ST_NumGeometries to support MM "
+"naming. Faster to use ST_NumGeometries if you don't care about MM convention."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1270 reference_accessor.xml:1365
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1273 reference_accessor.xml:1366
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: ?"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1280
+#, no-c-format
+msgid ""
+"SELECT ST_NumPatches(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 "
+"1, 0 1 0, 0 0 0)), \n"
+" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 "
+"1, 0 0 1, 0 0 0)), \n"
+" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 "
+"1, 0 1 1, 0 0 1)) )'));\n"
+" --result\n"
+" 6"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1291
+#, no-c-format
+msgid "ST_NumPoints"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1292
+#, no-c-format
+msgid ""
+"Return the number of points in an ST_LineString or ST_CircularString value."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1298
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NumPoints</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1308
+#, no-c-format
+msgid ""
+"Return the number of points in an ST_LineString or ST_CircularString value. "
+"Prior to 1.4 only works with Linestrings as the specs state. From 1.4 "
+"forward this is an alias for ST_NPoints which returns number of vertexes for "
+"not just line strings. Consider using ST_NPoints instead which is multi-"
+"purpose and works with many geometry types."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1315
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.2.4"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1321
+#, no-c-format
+msgid ""
+"SELECT ST_NumPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 "
+"29.26,77.27 29.31,77.29 29.07)'));\n"
+" --result\n"
+" 4"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1332
+#, no-c-format
+msgid "ST_PatchN"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1334
+#, no-c-format
+msgid ""
+"Return the 1-based Nth geometry (face) if the geometry is a "
+"POLYHEDRALSURFACE, POLYHEDRALSURFACEM. Otherwise, return NULL."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1341
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PatchN</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>n</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1352
+#, no-c-format
+msgid ""
+">Return the 1-based Nth geometry (face) if the geometry is a "
+"POLYHEDRALSURFACE, POLYHEDRALSURFACEM. Otherwise, return NULL. This returns "
+"the same answer as ST_GeometryN for Polyhedral Surfaces. Using ST_GemoetryN "
+"is faster."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1358
+#, no-c-format
+msgid "Index is 1-based."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1362
+#, no-c-format
+msgid ""
+"If you want to extract all geometries, of a geometry, ST_Dump is more "
+"efficient."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1376
+#, no-c-format
+msgid ""
+"--Extract the 2nd face of the polyhedral surface\n"
+"SELECT ST_AsEWKT(ST_PatchN(geom, 2)) As geomewkt\n"
+"FROM (\n"
+"VALUES (ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 "
+"0 0)), \n"
+" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, "
+"0 0 0)), \n"
+" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, "
+"0 0 1)) )')) ) As foo(geom);\n"
+"\n"
+" geomewkt\n"
+"---+-----------------------------------------\n"
+" POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1383
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeomFromEWKT\"/>, <xref linkend=\"ST_Dump\"/>, <xref "
+"linkend=\"ST_GeometryN\"/>, <xref linkend=\"ST_NumGeometries\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1389
+#, no-c-format
+msgid "ST_PointN"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1391
+#, no-c-format
+msgid ""
+"<refpurpose>Return the Nth point in the first linestring or circular "
+"linestring in the geometry. Return NULL if there is no linestring in the "
+"geometry.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1398
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PointN</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>n</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1409
+#, no-c-format
+msgid ""
+"<para>Return the Nth point in the first linestring or circular linestring in "
+"the geometry. Return NULL if there is no linestring in the geometry.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1419
+#, no-c-format
+msgid ""
+"If you want to get the nth point of each line string in a multilinestring, "
+"use in conjunction with ST_Dump"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1424
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.2.5, 7.3.5"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1434
+#, no-c-format
+msgid ""
+"-- Extract all POINTs from a LINESTRING\n"
+"SELECT ST_AsText(\n"
+" ST_PointN(\n"
+" column1,\n"
+" generate_series(1, ST_NPoints(column1))\n"
+" ))\n"
+"FROM ( VALUES ('LINESTRING(0 0, 1 1, 2 2)'::geometry) ) AS foo;\n"
+"\n"
+" st_astext\n"
+"------------\n"
+" POINT(0 0)\n"
+" POINT(1 1)\n"
+" POINT(2 2)\n"
+"(3 rows)\n"
+"\n"
+"--Example circular string\n"
+"SELECT ST_AsText(ST_PointN(ST_GeomFromText('CIRCULARSTRING(1 2, 3 2, 1 "
+"2)'),2));\n"
+"\n"
+"st_astext\n"
+"----------\n"
+"POINT(3 2)"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1446
+#, no-c-format
+msgid "ST_SRID"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1447
+#, no-c-format
+msgid ""
+"Returns the spatial reference identifier for the ST_Geometry as defined in "
+"spatial_ref_sys table."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1452
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_SRID</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1462
+#, no-c-format
+msgid ""
+"Returns the spatial reference identifier for the ST_Geometry as defined in "
+"spatial_ref_sys table. <xref linkend=\"spatial_ref_sys\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1463
+#, no-c-format
+msgid ""
+"spatial_ref_sys table is a table that catalogs all spatial reference systems "
+"known to PostGIS and is used for transformations from one spatial reference "
+"system to another. So verifying you have the right spatial reference system "
+"identifier is important if you plan to ever transform your geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1467
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.5"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1475
+#, no-c-format
+msgid ""
+"SELECT ST_SRID(ST_GeomFromText('POINT(-71.1043 42.315)',4326));\n"
+" --result\n"
+" 4326"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1480
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1486
+#, no-c-format
+msgid "ST_StartPoint"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1488
+#, no-c-format
+msgid ""
+"Returns the first point of a <varname>LINESTRING</varname> geometry as a "
+"<varname>POINT</varname>."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1494
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_StartPoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1505
+#, no-c-format
+msgid ""
+"Returns the first point of a <varname>LINESTRING</varname> geometry as a "
+"<varname>POINT</varname> or <varname>NULL</varname> if the input parameter "
+"is not a <varname>LINESTRING</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1509
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.1.3"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1522
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));\n"
+" st_astext\n"
+"------------\n"
+" POINT(0 1)\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_StartPoint('POINT(0 1)'::geometry) IS NULL AS is_null;\n"
+" is_null\n"
+"----------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"--3d line\n"
+"SELECT ST_AsEWKT(ST_StartPoint('LINESTRING(0 1 1, 0 2 2)'::geometry));\n"
+" st_asewkt\n"
+"------------\n"
+" POINT(0 1 1)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1528
+#, no-c-format
+msgid ", <xref linkend=\"ST_PointN\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1533
+#, no-c-format
+msgid "ST_Summary"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1535
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a text summary of the contents of the geometry.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_accessor.xml:1541
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_Summary</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_Summary</"
+"function></funcdef> <paramdef><type>geography </type> <parameter>g</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1556
+#, no-c-format
+msgid "<para>Returns a text summary of the contents of the geometry.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1558
+#, no-c-format
+msgid ""
+"Flags shown square brackets after the geometry type have the following "
+"meaning:"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1562
+#, no-c-format
+msgid "M: has M ordinate"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1563
+#, no-c-format
+msgid "Z: has Z ordinate"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1564
+#, no-c-format
+msgid "B: has a cached bounding box"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1565
+#, no-c-format
+msgid "G: is geodetic (geography)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1569
+#, no-c-format
+msgid "Availability: 1.2.2 - 2.0.0 added support for geography"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1576
+#, no-c-format
+msgid ""
+"=# SELECT ST_Summary(ST_GeomFromText('LINESTRING(0 0, 1 1)')) as geom,\n"
+" ST_Summary(ST_GeogFromText('POLYGON((0 0, 1 1, 1 2, 1 1, 0 0))')) "
+"geog;\n"
+" geom | geog \n"
+"-----------------------------+--------------------------\n"
+" LineString[B] with 2 points | Polygon[BG] with 1 rings\n"
+" : ring 0 has 5 points\n"
+" :\n"
+"(1 row)\n"
+"\n"
+"\n"
+"=# SELECT ST_Summary(ST_GeogFromText('LINESTRING(0 0 1, 1 1 1)')) As "
+"geog_line,\n"
+" ST_Summary(ST_GeomFromText('POLYGON((0 0 1, 1 1 2, 1 2 3, 1 1 1, 0 0 "
+"1))')) As geom_poly;\n"
+";\n"
+" geog_line | geom_poly\n"
+"-------------------------------+--------------------------\n"
+" LineString[ZBG] with 2 points | Polygon[ZB] with 1 rings\n"
+" : ring 0 has 5 points\n"
+" :\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1582
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_AddBBox\"/>, <xref linkend=\"ST_Force_3DM\"/>, "
+"<xref linkend=\"ST_Force_3DZ\"/>, <xref linkend=\"ST_Force_2D\"/>, <xref "
+"linkend=\"geography\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1591
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_IsValid\"/>, <xref linkend=\"ST_IsValidReason\"/>, "
+"<xref linkend=\"ST_IsValidDetail\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1602
+#, no-c-format
+msgid "ST_X"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1604
+#, no-c-format
+msgid ""
+"<refpurpose>Return the X coordinate of the point, or NULL if not available. "
+"Input must be a point.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1610
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_X</function></funcdef> <paramdef><type>geometry "
+"</type> <parameter>a_point</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1620
+#, no-c-format
+msgid ""
+"<para>Return the X coordinate of the point, or NULL if not available. Input "
+"must be a point.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1623
+#, no-c-format
+msgid ""
+"If you want to get the max min x values of any geometry look at ST_XMin, "
+"ST_XMax functions."
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1625
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 6.1.3"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1633
+#, no-c-format
+msgid ""
+"SELECT ST_X(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n"
+" st_x\n"
+"------\n"
+" 1\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_Y(ST_Centroid(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)')));\n"
+" st_y\n"
+"------\n"
+" 1.5\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1640
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeomFromEWKT\"/>, <xref linkend=\"ST_M\"/>, <xref "
+"linkend=\"ST_XMax\"/>, <xref linkend=\"ST_XMin\"/>, <xref linkend=\"ST_Y\"/"
+">, <xref linkend=\"ST_Z\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1646
+#, no-c-format
+msgid "ST_XMax"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1648
+#, no-c-format
+msgid ""
+"<refpurpose>Returns X maxima of a bounding box 2d or 3d or a geometry.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1653
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_XMax</function></funcdef> <paramdef><type>box3d "
+"</type> <parameter>aGeomorBox2DorBox3D</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1663
+#, no-c-format
+msgid "<para>Returns X maxima of a bounding box 2d or 3d or a geometry.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1666 reference_accessor.xml:1711
+#: reference_accessor.xml:1799 reference_accessor.xml:1844
+#: reference_accessor.xml:1932 reference_accessor.xml:2019
+#, no-c-format
+msgid ""
+"Although this function is only defined for box3d, it will work for box2d and "
+"geometry because of the auto-casting behavior defined for geometries and "
+"box2d. However you can not feed it a geometry or box2d text representation, "
+"since that will not auto-cast."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1678
+#, no-c-format
+msgid ""
+"SELECT ST_XMax('BOX3D(1 2 3, 4 5 6)');\n"
+"st_xmax\n"
+"-------\n"
+"4\n"
+"\n"
+"SELECT ST_XMax(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n"
+"st_xmax\n"
+"-------\n"
+"5\n"
+"\n"
+"SELECT ST_XMax(CAST('BOX(-3 2, 3 4)' As box2d));\n"
+"st_xmax\n"
+"-------\n"
+"3\n"
+"--Observe THIS DOES NOT WORK because it will try to autocast the string "
+"representation to a BOX3D\n"
+"SELECT ST_XMax('LINESTRING(1 3, 5 6)');\n"
+"\n"
+"--ERROR: BOX3D parser - doesnt start with BOX3D(\n"
+"\n"
+"SELECT ST_XMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 "
+"2,220227 150406 3)'));\n"
+"st_xmax\n"
+"--------\n"
+"220288.248780547"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1685 reference_accessor.xml:1730
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_YMax\"/>, <xref linkend=\"ST_YMin\"/>, <xref linkend="
+"\"ST_ZMax\"/>, <xref linkend=\"ST_ZMin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1691
+#, no-c-format
+msgid "ST_XMin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1693
+#, no-c-format
+msgid ""
+"<refpurpose>Returns X minima of a bounding box 2d or 3d or a geometry.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1698
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_XMin</function></funcdef> <paramdef><type>box3d "
+"</type> <parameter>aGeomorBox2DorBox3D</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1708
+#, no-c-format
+msgid "<para>Returns X minima of a bounding box 2d or 3d or a geometry.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1723
+#, no-c-format
+msgid ""
+"SELECT ST_XMin('BOX3D(1 2 3, 4 5 6)');\n"
+"st_xmin\n"
+"-------\n"
+"1\n"
+"\n"
+"SELECT ST_XMin(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n"
+"st_xmin\n"
+"-------\n"
+"1\n"
+"\n"
+"SELECT ST_XMin(CAST('BOX(-3 2, 3 4)' As box2d));\n"
+"st_xmin\n"
+"-------\n"
+"-3\n"
+"--Observe THIS DOES NOT WORK because it will try to autocast the string "
+"representation to a BOX3D\n"
+"SELECT ST_XMin('LINESTRING(1 3, 5 6)');\n"
+"\n"
+"--ERROR: BOX3D parser - doesnt start with BOX3D(\n"
+"\n"
+"SELECT ST_XMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 "
+"2,220227 150406 3)'));\n"
+"st_xmin\n"
+"--------\n"
+"220186.995121892"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1736
+#, no-c-format
+msgid "ST_Y"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1738
+#, no-c-format
+msgid ""
+"<refpurpose>Return the Y coordinate of the point, or NULL if not available. "
+"Input must be a point.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1744
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Y</function></funcdef> <paramdef><type>geometry "
+"</type> <parameter>a_point</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1754
+#, no-c-format
+msgid ""
+"<para>Return the Y coordinate of the point, or NULL if not available. Input "
+"must be a point.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1758
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 6.1.4"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1766
+#, no-c-format
+msgid ""
+"SELECT ST_Y(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n"
+" st_y\n"
+"------\n"
+" 2\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_Y(ST_Centroid(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)')));\n"
+" st_y\n"
+"------\n"
+" 1.5\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1773
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeomFromEWKT\"/>, <xref linkend=\"ST_M\"/>, <xref "
+"linkend=\"ST_X\"/>, <xref linkend=\"ST_YMax\"/>, <xref linkend=\"ST_YMin\"/"
+">, <xref linkend=\"ST_Z\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1779
+#, no-c-format
+msgid "ST_YMax"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1781
+#, no-c-format
+msgid ""
+"<refpurpose>Returns Y maxima of a bounding box 2d or 3d or a geometry.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1786
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_YMax</function></funcdef> <paramdef><type>box3d "
+"</type> <parameter>aGeomorBox2DorBox3D</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1796
+#, no-c-format
+msgid "<para>Returns Y maxima of a bounding box 2d or 3d or a geometry.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1811
+#, no-c-format
+msgid ""
+"SELECT ST_YMax('BOX3D(1 2 3, 4 5 6)');\n"
+"st_ymax\n"
+"-------\n"
+"5\n"
+"\n"
+"SELECT ST_YMax(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n"
+"st_ymax\n"
+"-------\n"
+"6\n"
+"\n"
+"SELECT ST_YMax(CAST('BOX(-3 2, 3 4)' As box2d));\n"
+"st_ymax\n"
+"-------\n"
+"4\n"
+"--Observe THIS DOES NOT WORK because it will try to autocast the string "
+"representation to a BOX3D\n"
+"SELECT ST_YMax('LINESTRING(1 3, 5 6)');\n"
+"\n"
+"--ERROR: BOX3D parser - doesnt start with BOX3D(\n"
+"\n"
+"SELECT ST_YMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 "
+"2,220227 150406 3)'));\n"
+"st_ymax\n"
+"--------\n"
+"150506.126829327"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1818
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_XMax\"/>, <xref linkend=\"ST_YMin\"/>, <xref linkend="
+"\"ST_ZMax\"/>, <xref linkend=\"ST_ZMin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1824
+#, no-c-format
+msgid "ST_YMin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1826
+#, no-c-format
+msgid ""
+"<refpurpose>Returns Y minima of a bounding box 2d or 3d or a geometry.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1831
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_YMin</function></funcdef> <paramdef><type>box3d "
+"</type> <parameter>aGeomorBox2DorBox3D</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1841
+#, no-c-format
+msgid "<para>Returns Y minima of a bounding box 2d or 3d or a geometry.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1856
+#, no-c-format
+msgid ""
+"SELECT ST_YMin('BOX3D(1 2 3, 4 5 6)');\n"
+"st_ymin\n"
+"-------\n"
+"2\n"
+"\n"
+"SELECT ST_YMin(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n"
+"st_ymin\n"
+"-------\n"
+"3\n"
+"\n"
+"SELECT ST_YMin(CAST('BOX(-3 2, 3 4)' As box2d));\n"
+"st_ymin\n"
+"-------\n"
+"2\n"
+"--Observe THIS DOES NOT WORK because it will try to autocast the string "
+"representation to a BOX3D\n"
+"SELECT ST_YMin('LINESTRING(1 3, 5 6)');\n"
+"\n"
+"--ERROR: BOX3D parser - doesnt start with BOX3D(\n"
+"\n"
+"SELECT ST_YMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 "
+"2,220227 150406 3)'));\n"
+"st_ymin\n"
+"--------\n"
+"150406"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1863
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_XMin\"/>, <xref linkend=\"ST_XMax\"/>, <xref linkend="
+"\"ST_YMax\"/>, <xref linkend=\"ST_ZMax\"/>, <xref linkend=\"ST_ZMin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1869
+#, no-c-format
+msgid "ST_Z"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1871
+#, no-c-format
+msgid ""
+"<refpurpose>Return the Z coordinate of the point, or NULL if not available. "
+"Input must be a point.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1877
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Z</function></funcdef> <paramdef><type>geometry "
+"</type> <parameter>a_point</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1887
+#, no-c-format
+msgid ""
+"<para>Return the Z coordinate of the point, or NULL if not available. Input "
+"must be a point.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1899
+#, no-c-format
+msgid ""
+"SELECT ST_Z(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n"
+" st_z\n"
+"------\n"
+" 3\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1906
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_M\"/>, <xref linkend=\"ST_X\"/>, <xref linkend=\"ST_Y\"/"
+">, <xref linkend=\"ST_ZMax\"/>, <xref linkend=\"ST_ZMin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1912
+#, no-c-format
+msgid "ST_ZMax"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1914 reference_accessor.xml:2001
+#, no-c-format
+msgid ""
+"<refpurpose>Returns Z minima of a bounding box 2d or 3d or a geometry.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1919
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_ZMax</function></funcdef> <paramdef><type>box3d "
+"</type> <parameter>aGeomorBox2DorBox3D</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1929
+#, no-c-format
+msgid "Returns Z maxima of a bounding box 2d or 3d or a geometry."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1944
+#, no-c-format
+msgid ""
+"SELECT ST_ZMax('BOX3D(1 2 3, 4 5 6)');\n"
+"st_zmax\n"
+"-------\n"
+"6\n"
+"\n"
+"SELECT ST_ZMax(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));\n"
+"st_zmax\n"
+"-------\n"
+"7\n"
+"\n"
+"SELECT ST_ZMax('BOX3D(-3 2 1, 3 4 1)' );\n"
+"st_zmax\n"
+"-------\n"
+"1\n"
+"--Observe THIS DOES NOT WORK because it will try to autocast the string "
+"representation to a BOX3D\n"
+"SELECT ST_ZMax('LINESTRING(1 3 4, 5 6 7)');\n"
+"\n"
+"--ERROR: BOX3D parser - doesnt start with BOX3D(\n"
+"\n"
+"SELECT ST_ZMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 "
+"2,220227 150406 3)'));\n"
+"st_zmax\n"
+"--------\n"
+"3"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1951
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_XMin\"/>, <xref linkend=\"ST_XMax\"/>, <xref linkend="
+"\"ST_YMax\"/>, <xref linkend=\"ST_YMin\"/>, <xref linkend=\"ST_ZMax\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1957
+#, no-c-format
+msgid "ST_Zmflag"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_accessor.xml:1959
+#, no-c-format
+msgid ""
+"<refpurpose>Returns ZM (dimension semantic) flag of the geometries as a "
+"small int. Values are: 0=2d, 1=3dm, 2=3dz, 3=4d.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:1965
+#, no-c-format
+msgid ""
+"<funcdef>smallint <function>ST_Zmflag</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1975
+#, no-c-format
+msgid ""
+"<para>Returns ZM (dimension semantic) flag of the geometries as a small int. "
+"Values are: 0=2d, 1=3dm, 2=3dz, 3=4d.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:1986
+#, no-c-format
+msgid ""
+"SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRING(1 2, 3 4)'));\n"
+" st_zmflag\n"
+"-----------\n"
+" 0\n"
+"\n"
+"SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRINGM(1 2 3, 3 4 3)'));\n"
+" st_zmflag\n"
+"-----------\n"
+" 1\n"
+"\n"
+"SELECT ST_Zmflag(ST_GeomFromEWKT('CIRCULARSTRING(1 2 3, 3 4 3, 5 6 3)'));\n"
+" st_zmflag\n"
+"-----------\n"
+" 2\n"
+"SELECT ST_Zmflag(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n"
+" st_zmflag\n"
+"-----------\n"
+" 3"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:1993
+#, no-c-format
+msgid ", <xref linkend=\"ST_NDims\"/>, <xref linkend=\"ST_Dimension\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_accessor.xml:1999
+#, no-c-format
+msgid "ST_ZMin"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_accessor.xml:2006
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_ZMin</function></funcdef> <paramdef><type>box3d "
+"</type> <parameter>aGeomorBox2DorBox3D</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:2016
+#, no-c-format
+msgid "<para>Returns Z minima of a bounding box 2d or 3d or a geometry.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_accessor.xml:2031
+#, no-c-format
+msgid ""
+"SELECT ST_ZMin('BOX3D(1 2 3, 4 5 6)');\n"
+"st_zmin\n"
+"-------\n"
+"3\n"
+"\n"
+"SELECT ST_ZMin(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));\n"
+"st_zmin\n"
+"-------\n"
+"4\n"
+"\n"
+"SELECT ST_ZMin('BOX3D(-3 2 1, 3 4 1)' );\n"
+"st_zmin\n"
+"-------\n"
+"1\n"
+"--Observe THIS DOES NOT WORK because it will try to autocast the string "
+"representation to a BOX3D\n"
+"SELECT ST_ZMin('LINESTRING(1 3 4, 5 6 7)');\n"
+"\n"
+"--ERROR: BOX3D parser - doesnt start with BOX3D(\n"
+"\n"
+"SELECT ST_ZMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 "
+"2,220227 150406 3)'));\n"
+"st_zmin\n"
+"--------\n"
+"1"
+msgstr ""
+
+#. Tag: para
+#: reference_accessor.xml:2038
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_XMin\"/>, <xref "
+"linkend=\"ST_XMax\"/>, <xref linkend=\"ST_YMax\"/>, <xref linkend=\"ST_YMin"
+"\"/>, <xref linkend=\"ST_ZMax\"/>"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# Jakub Bobrowski <jb@5dstudio.pl>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2014-01-03 10:44+0000\n"
+"Last-Translator: Jakub Bobrowski <jb@5dstudio.pl>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_constructor.xml:3
+#, no-c-format
+msgid "Geometry Constructors"
+msgstr ""
+
+#. Tag: refname
+#: reference_constructor.xml:6
+#, no-c-format
+msgid "ST_BdPolyFromText"
+msgstr "ST_BdPolyFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:8
+#, no-c-format
+msgid ""
+"<refpurpose>Construct a Polygon given an arbitrary collection of closed "
+"linestrings as a MultiLineString Well-Known text representation.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:14
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_BdPolyFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_BdPolyFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+
+#. Tag: title
+#: reference_constructor.xml:23 reference_constructor.xml:72
+#: reference_constructor.xml:119 reference_constructor.xml:148
+#: reference_constructor.xml:175 reference_constructor.xml:227
+#: reference_constructor.xml:278 reference_constructor.xml:326
+#: reference_constructor.xml:369 reference_constructor.xml:400
+#: reference_constructor.xml:474 reference_constructor.xml:513
+#: reference_constructor.xml:564 reference_constructor.xml:596
+#: reference_constructor.xml:649 reference_constructor.xml:695
+#: reference_constructor.xml:740 reference_constructor.xml:799
+#: reference_constructor.xml:867 reference_constructor.xml:927
+#: reference_constructor.xml:966 reference_constructor.xml:1023
+#: reference_constructor.xml:1094 reference_constructor.xml:1139
+#: reference_constructor.xml:1220 reference_constructor.xml:1263
+#: reference_constructor.xml:1305 reference_constructor.xml:1366
+#: reference_constructor.xml:1427 reference_constructor.xml:1481
+#: reference_constructor.xml:1535 reference_constructor.xml:1591
+#: reference_constructor.xml:1640 reference_constructor.xml:1694
+#: reference_constructor.xml:1737 reference_constructor.xml:1760
+#, no-c-format
+msgid "Description"
+msgstr "Opis"
+
+#. Tag: para
+#: reference_constructor.xml:25
+#, no-c-format
+msgid ""
+"<para>Construct a Polygon given an arbitrary collection of closed "
+"linestrings as a MultiLineString Well-Known text representation.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:30
+#, no-c-format
+msgid ""
+"Throws an error if WKT is not a MULTILINESTRING. Throws an error if output "
+"is a MULTIPOLYGON; use ST_BdMPolyFromText in that case, or see "
+"ST_BuildArea() for a postgis-specific approach."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:36 reference_constructor.xml:88
+#: reference_constructor.xml:241 reference_constructor.xml:756
+#: reference_constructor.xml:824 reference_constructor.xml:890
+#: reference_constructor.xml:1321 reference_constructor.xml:1443
+#: reference_constructor.xml:1705
+#, no-c-format
+msgid "&sfs_compliant; s3.2.6.2"
+msgstr "&sfs_compliant; s3.2.6.2"
+
+#. Tag: para
+#: reference_constructor.xml:38 reference_constructor.xml:90
+#, no-c-format
+msgid "Availability: 1.1.0 - requires GEOS >= 2.1.0."
+msgstr "Dostępność: 1.1.0 - wymaga GEOS >= 2.1.0."
+
+#. Tag: title
+#: reference_constructor.xml:42 reference_constructor.xml:94
+#: reference_constructor.xml:125 reference_constructor.xml:190
+#: reference_constructor.xml:248 reference_constructor.xml:292
+#: reference_constructor.xml:340 reference_constructor.xml:485
+#: reference_constructor.xml:617 reference_constructor.xml:665
+#: reference_constructor.xml:703 reference_constructor.xml:763
+#: reference_constructor.xml:831 reference_constructor.xml:895
+#: reference_constructor.xml:935 reference_constructor.xml:982
+#: reference_constructor.xml:1235 reference_constructor.xml:1270
+#: reference_constructor.xml:1328 reference_constructor.xml:1389
+#: reference_constructor.xml:1450 reference_constructor.xml:1559
+#: reference_constructor.xml:1609 reference_constructor.xml:1658
+#: reference_constructor.xml:1710
+#, no-c-format
+msgid "Examples"
+msgstr "Przykłady"
+
+#. Tag: programlisting
+#: reference_constructor.xml:44 reference_constructor.xml:96
+#, no-c-format
+msgid "Forthcoming"
+msgstr ""
+
+#. Tag: title
+#: reference_constructor.xml:48 reference_constructor.xml:100
+#: reference_constructor.xml:129 reference_constructor.xml:153
+#: reference_constructor.xml:195 reference_constructor.xml:255
+#: reference_constructor.xml:305 reference_constructor.xml:346
+#: reference_constructor.xml:374 reference_constructor.xml:453
+#: reference_constructor.xml:492 reference_constructor.xml:540
+#: reference_constructor.xml:571 reference_constructor.xml:621
+#: reference_constructor.xml:672 reference_constructor.xml:710
+#: reference_constructor.xml:770 reference_constructor.xml:838
+#: reference_constructor.xml:902 reference_constructor.xml:942
+#: reference_constructor.xml:989 reference_constructor.xml:1066
+#: reference_constructor.xml:1109 reference_constructor.xml:1173
+#: reference_constructor.xml:1239 reference_constructor.xml:1276
+#: reference_constructor.xml:1335 reference_constructor.xml:1396
+#: reference_constructor.xml:1457 reference_constructor.xml:1508
+#: reference_constructor.xml:1563 reference_constructor.xml:1616
+#: reference_constructor.xml:1665 reference_constructor.xml:1717
+#: reference_constructor.xml:1741 reference_constructor.xml:1764
+#, no-c-format
+msgid "See Also"
+msgstr "Zobacz także"
+
+#. Tag: para
+#: reference_constructor.xml:49
+#, no-c-format
+msgid ", <xref linkend=\"ST_BdMPolyFromText\"/>"
+msgstr ", <xref linkend=\"ST_BdMPolyFromText\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:55
+#, no-c-format
+msgid "ST_BdMPolyFromText"
+msgstr "ST_BdMPolyFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:56
+#, no-c-format
+msgid ""
+"Construct a MultiPolygon given an arbitrary collection of closed linestrings "
+"as a MultiLineString text representation Well-Known text representation."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:63
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_BdMPolyFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_BdMPolyFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:74
+#, no-c-format
+msgid ""
+"Construct a Polygon given an arbitrary collection of closed linestrings, "
+"polygons, MultiLineStrings as Well-Known text representation."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:79
+#, no-c-format
+msgid ""
+"Throws an error if WKT is not a MULTILINESTRING. Forces MULTIPOLYGON output "
+"even when result is really only composed by a single POLYGON; use <link "
+"linkend=\"ST_BdPolyFromText\">ST_BdPolyFromText</link> if you're sure a "
+"single POLYGON will result from operation, or see <link linkend="
+"\"ST_BuildArea\">ST_BuildArea()</link> for a postgis-specific approach."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:101
+#, no-c-format
+msgid ", <xref linkend=\"ST_BdPolyFromText\"/>"
+msgstr ", <xref linkend=\"ST_BdPolyFromText\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:107
+#, no-c-format
+msgid "ST_GeogFromText"
+msgstr "ST_GeogFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:108 reference_constructor.xml:137
+#, no-c-format
+msgid ""
+"Return a specified geography value from Well-Known Text representation or "
+"extended (WKT)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:112
+#, no-c-format
+msgid ""
+"<funcdef>geography <function>ST_GeogFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>EWKT</parameter></paramdef>"
+msgstr ""
+"<funcdef>geography <function>ST_GeogFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>EWKT</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:120
+#, no-c-format
+msgid ""
+"Returns a geography object from the well-known text or extended well-known "
+"representation. SRID 4326 is assumed. This is an alias for "
+"ST_GeographyFromText. Points are always expressed in long lat form."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:126
+#, no-c-format
+msgid ""
+"--- converting lon lat coords to geography\n"
+"ALTER TABLE sometable ADD COLUMN geog geography(POINT,4326);\n"
+"UPDATE sometable SET geog = ST_GeogFromText('SRID=4326;POINT(' || lon || ' ' "
+"|| lat || ')');"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:130
+#, no-c-format
+msgid ", <xref linkend=\"ST_GeographyFromText\"/>"
+msgstr ", <xref linkend=\"ST_GeographyFromText\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:136
+#, no-c-format
+msgid "ST_GeographyFromText"
+msgstr "ST_GeographyFromText"
+
+#. Tag: funcprototype
+#: reference_constructor.xml:141
+#, no-c-format
+msgid ""
+"<funcdef>geography <function>ST_GeographyFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>EWKT</parameter></paramdef>"
+msgstr ""
+"<funcdef>geography <function>ST_GeographyFromText</function></funcdef> "
+"<paramdef><type>text </type> <parameter>EWKT</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:149
+#, no-c-format
+msgid ""
+"Returns a geography object from the well-known text representation. SRID "
+"4326 is assumed."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:154
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsText\"/>"
+msgstr ", <xref linkend=\"ST_AsText\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:160
+#, no-c-format
+msgid "ST_GeogFromWKB"
+msgstr "ST_GeogFromWKB"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:161
+#, no-c-format
+msgid ""
+"Creates a geography instance from a Well-Known Binary geometry "
+"representation (WKB) or extended Well Known Binary (EWKB)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:167
+#, no-c-format
+msgid ""
+"<funcdef>geography <function>ST_GeogFromWKB</function></funcdef> "
+"<paramdef><type>bytea </type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+"<funcdef>geography <function>ST_GeogFromWKB</function></funcdef> "
+"<paramdef><type>bytea </type> <parameter>geom</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:177
+#, no-c-format
+msgid ""
+"The <varname>ST_GeogFromWKB</varname> function, takes a well-known binary "
+"representation (WKB) of a geometry or PostGIS Extended WKB and creates an "
+"instance of the appropriate geography type. This function plays the role of "
+"the Geometry Factory in SQL."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:182
+#, no-c-format
+msgid "If SRID is not specified, it defaults to 4326 (WGS 84 long lat)."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:184 reference_constructor.xml:286
+#: reference_constructor.xml:334 reference_constructor.xml:610
+#: reference_constructor.xml:660 reference_constructor.xml:1605
+#, no-c-format
+msgid "&curve_support;"
+msgstr "&curve_support;"
+
+#. Tag: programlisting
+#: reference_constructor.xml:192
+#, no-c-format
+msgid ""
+"--Although bytea rep contains single \\, these need to be escaped when "
+"inserting into a table\n"
+"SELECT ST_AsText(\n"
+"ST_GeogFromWKB(E'\\\\001\\\\002\\\\000\\\\000\\\\000\\\\002\\\\000\\\\000\\"
+"\\000\\\\037\\\\205\\\\353Q\\\\270~\\\\\\\\\\\\300\\\\323Mb\\\\020X\\\\231C@"
+"\\\\020X9\\\\264\\\\310~\\\\\\\\\\\\300)\\\\\\\\\\\\217\\\\302\\\\365\\"
+"\\230C@')\n"
+");\n"
+" st_astext\n"
+"------------------------------------------------------\n"
+" LINESTRING(-113.98 39.198,-113.981 39.195)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:197
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsBinary\"/>"
+msgstr ", <xref linkend=\"ST_AsBinary\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:204
+#, no-c-format
+msgid "ST_GeomCollFromText"
+msgstr "ST_GeomCollFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:206
+#, no-c-format
+msgid ""
+"Makes a collection Geometry from collection WKT with the given SRID. If SRID "
+"is not give, it defaults to -1."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:211
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomCollFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomCollFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomCollFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomCollFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:229
+#, no-c-format
+msgid ""
+"Makes a collection Geometry from the Well-Known-Text (WKT) representation "
+"with the given SRID. If SRID is not give, it defaults to -1."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:232 reference_constructor.xml:1310
+#: reference_constructor.xml:1371 reference_constructor.xml:1432
+#: reference_constructor.xml:1700
+#, no-c-format
+msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:234
+#, no-c-format
+msgid "Returns null if the WKT is not a GEOMETRYCOLLECTION"
+msgstr "Zwraca null jeśli WKT nie jest GEOMETRYCOLLECTION"
+
+#. Tag: para
+#: reference_constructor.xml:236
+#, no-c-format
+msgid ""
+"If you are absolutely sure all your WKT geometries are collections, don't "
+"use this function. It is slower than ST_GeomFromText since it adds an "
+"additional validation step."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:242
+#, no-c-format
+msgid "&sqlmm_compliant;"
+msgstr "&sqlmm_compliant;"
+
+#. Tag: programlisting
+#: reference_constructor.xml:250
+#, no-c-format
+msgid ""
+"SELECT ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(1 2, 3 "
+"4))');"
+msgstr ""
+"SELECT ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(1 2, 3 "
+"4))');"
+
+#. Tag: para
+#: reference_constructor.xml:257 reference_constructor.xml:1459
+#, no-c-format
+msgid ", <xref linkend=\"ST_SRID\"/>"
+msgstr ", <xref linkend=\"ST_SRID\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:264
+#, no-c-format
+msgid "ST_GeomFromEWKB"
+msgstr "ST_GeomFromEWKB"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:265
+#, no-c-format
+msgid ""
+"Return a specified ST_Geometry value from Extended Well-Known Binary "
+"representation (EWKB)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:270
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_GeomFromEWKB</function></funcdef> "
+"<paramdef><type>bytea </type> <parameter>EWKB</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_GeomFromEWKB</function></funcdef> "
+"<paramdef><type>bytea </type> <parameter>EWKB</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:279
+#, no-c-format
+msgid ""
+"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known "
+"binary (EWKT) representation."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:281
+#, no-c-format
+msgid ""
+"The EWKB format is not an OGC standard, but a PostGIS specific format that "
+"includes the spatial reference system (SRID) identifier"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:284 reference_constructor.xml:332
+#: reference_constructor.xml:420 reference_constructor.xml:567
+#, no-c-format
+msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:285 reference_constructor.xml:333
+#: reference_constructor.xml:422 reference_constructor.xml:481
+#: reference_constructor.xml:527 reference_constructor.xml:698
+#: reference_constructor.xml:1034 reference_constructor.xml:1151
+#: reference_constructor.xml:1230 reference_constructor.xml:1604
+#: reference_constructor.xml:1652
+#, no-c-format
+msgid "&Z_support;"
+msgstr "&Z_support;"
+
+#. Tag: para
+#: reference_constructor.xml:287 reference_constructor.xml:335
+#: reference_constructor.xml:423
+#, no-c-format
+msgid "&P_support;"
+msgstr "&P_support;"
+
+#. Tag: para
+#: reference_constructor.xml:288 reference_constructor.xml:336
+#: reference_constructor.xml:424
+#, no-c-format
+msgid "&T_support;"
+msgstr "&T_support;"
+
+#. Tag: para
+#: reference_constructor.xml:293
+#, no-c-format
+msgid ""
+"line string binary rep 0f LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932) in NAD 83 long lat (4269)."
+msgstr ""
+"line string binary rep 0f LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932) in NAD 83 long lat (4269)."
+
+#. Tag: para
+#: reference_constructor.xml:295
+#, no-c-format
+msgid ""
+"NOTE: Even though byte arrays are delimited with \\ and may have ', we need "
+"to escape both out with \\ and '' if standard_conforming_strings is off. So "
+"it does not look exactly like its AsEWKB representation."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:297
+#, no-c-format
+msgid ""
+"SELECT ST_GeomFromEWKB(E'\\\\001\\\\002\\\\000\\\\000 \\\\255\\\\020\\\\000\\"
+"\\000\\\\003\\\\000\\\\000\\\\000\\\\344J=\n"
+"\\\\013B\\\\312Q\\\\300n\\\\303(\\\\010\\\\036!E@''\\\\277E''K\n"
+"\\\\312Q\\\\300\\\\366{b\\\\235*!E@\\\\225|\\\\354.P\\\\312Q\n"
+"\\\\300p\\\\231\\\\323e1!E@');"
+msgstr ""
+"SELECT ST_GeomFromEWKB(E'\\\\001\\\\002\\\\000\\\\000 \\\\255\\\\020\\\\000\\"
+"\\000\\\\003\\\\000\\\\000\\\\000\\\\344J=\n"
+"\\\\013B\\\\312Q\\\\300n\\\\303(\\\\010\\\\036!E@''\\\\277E''K\n"
+"\\\\312Q\\\\300\\\\366{b\\\\235*!E@\\\\225|\\\\354.P\\\\312Q\n"
+"\\\\300p\\\\231\\\\323e1!E@');"
+
+#. Tag: para
+#: reference_constructor.xml:299
+#, no-c-format
+msgid ""
+"In PostgreSQL 9.1+ - standard_conforming_strings is set to on by default, "
+"where as in past versions it was set to on. You can change defaults as "
+"needed for a single query or at the database or server level. Below is how "
+"you would do it with standard_conforming_strings = on. In this case we "
+"escape the ' with standard ansi ', but slashes are not escaped"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:302
+#, no-c-format
+msgid ""
+"set standard_conforming_strings = on;\n"
+"SELECT ST_GeomFromEWKB('\\001\\002\\000\\000 "
+"\\255\\020\\000\\000\\003\\000\\000\\000\\344J=\\012\\013B\n"
+" \\312Q\\300n\\303(\\010\\036!E@''\\277E''K\\012\\312Q\\300\\366{b\\235*!"
+"E@\\225|\\354.P\\312Q\\012\\300p\\231\\323e1')"
+msgstr ""
+"set standard_conforming_strings = on;\n"
+"SELECT ST_GeomFromEWKB('\\001\\002\\000\\000 "
+"\\255\\020\\000\\000\\003\\000\\000\\000\\344J=\\012\\013B\n"
+" \\312Q\\300n\\303(\\010\\036!E@''\\277E''K\\012\\312Q\\300\\366{b\\235*!"
+"E@\\225|\\354.P\\312Q\\012\\300p\\231\\323e1')"
+
+#. Tag: para
+#: reference_constructor.xml:306
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsEWKB\"/>, <xref linkend=\"ST_GeomFromWKB\"/>"
+msgstr ", <xref linkend=\"ST_AsEWKB\"/>, <xref linkend=\"ST_GeomFromWKB\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:312
+#, no-c-format
+msgid "ST_GeomFromEWKT"
+msgstr "ST_GeomFromEWKT"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:313
+#, no-c-format
+msgid ""
+"Return a specified ST_Geometry value from Extended Well-Known Text "
+"representation (EWKT)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:318
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_GeomFromEWKT</function></funcdef> "
+"<paramdef><type>text </type> <parameter>EWKT</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_GeomFromEWKT</function></funcdef> "
+"<paramdef><type>text </type> <parameter>EWKT</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:327
+#, no-c-format
+msgid ""
+"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known "
+"text (EWKT) representation."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:329
+#, no-c-format
+msgid ""
+"The EWKT format is not an OGC standard, but an PostGIS specific format that "
+"includes the spatial reference system (SRID) identifier"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:341
+#, no-c-format
+msgid ""
+"SELECT ST_GeomFromEWKT('SRID=4269;LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932)');\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;MULTILINESTRING((-71.160281 "
+"42.258729,-71.160837 42.259113,-71.161144 42.25932))');\n"
+"\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;POINT(-71.064544 42.28787)');\n"
+"\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;POLYGON((-71.1776585052917 "
+"42.3902909739571,-71.1776820268866 42.3903701743239,\n"
+"-71.1776063012595 42.3903825660754,-71.1775826583081 "
+"42.3903033653531,-71.1776585052917 42.3902909739571))');\n"
+"\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;MULTIPOLYGON(((-71.1031880899493 "
+"42.3152774590236,\n"
+"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n"
+"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n"
+"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n"
+"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n"
+"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n"
+"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n"
+"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n"
+"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n"
+"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n"
+"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n"
+"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n"
+"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n"
+"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n"
+"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n"
+"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n"
+"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n"
+"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n"
+"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n"
+"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n"
+"-71.1031880899493 42.3152774590236)),\n"
+"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n"
+"-71.1043443253471 42.3150676015829,-71.1043850704575 "
+"42.3150793250568,-71.1043632495873 42.315113108546)))');"
+msgstr ""
+"SELECT ST_GeomFromEWKT('SRID=4269;LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932)');\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;MULTILINESTRING((-71.160281 "
+"42.258729,-71.160837 42.259113,-71.161144 42.25932))');\n"
+"\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;POINT(-71.064544 42.28787)');\n"
+"\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;POLYGON((-71.1776585052917 "
+"42.3902909739571,-71.1776820268866 42.3903701743239,\n"
+"-71.1776063012595 42.3903825660754,-71.1775826583081 "
+"42.3903033653531,-71.1776585052917 42.3902909739571))');\n"
+"\n"
+"SELECT ST_GeomFromEWKT('SRID=4269;MULTIPOLYGON(((-71.1031880899493 "
+"42.3152774590236,\n"
+"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n"
+"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n"
+"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n"
+"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n"
+"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n"
+"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n"
+"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n"
+"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n"
+"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n"
+"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n"
+"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n"
+"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n"
+"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n"
+"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n"
+"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n"
+"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n"
+"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n"
+"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n"
+"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n"
+"-71.1031880899493 42.3152774590236)),\n"
+"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n"
+"-71.1043443253471 42.3150676015829,-71.1043850704575 "
+"42.3150793250568,-71.1043632495873 42.315113108546)))');"
+
+#. Tag: programlisting
+#: reference_constructor.xml:342
+#, no-c-format
+msgid ""
+"--3d circular string\n"
+"SELECT ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 "
+"2,220227 150406 3)');"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:343
+#, no-c-format
+msgid ""
+"--Polyhedral Surface example\n"
+"SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE( \n"
+" ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n"
+" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), \n"
+" ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)), \n"
+" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), \n"
+" ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) \n"
+")');"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:347
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>"
+msgstr ""
+", <xref linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:352
+#, no-c-format
+msgid "ST_GeometryFromText"
+msgstr "ST_GeometryFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:353 reference_constructor.xml:1749
+#, no-c-format
+msgid ""
+"Return a specified ST_Geometry value from Well-Known Text representation "
+"(WKT). This is an alias name for ST_GeomFromText"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:356
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_GeometryFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeometryFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_GeometryFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeometryFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:370 reference_constructor.xml:1650
+#, no-c-format
+msgid "&sfs_compliant;"
+msgstr "&sfs_compliant;"
+
+#. Tag: para
+#: reference_constructor.xml:371 reference_constructor.xml:609
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.40"
+msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.40"
+
+#. Tag: refname
+#: reference_constructor.xml:381
+#, no-c-format
+msgid "ST_GeomFromGML"
+msgstr "ST_GeomFromGML"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:382
+#, no-c-format
+msgid ""
+"Takes as input GML representation of geometry and outputs a PostGIS geometry "
+"object"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:386
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomFromGML</function></"
+"funcdef> <paramdef><type>text </type> <parameter>geomgml</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomFromGML</function></funcdef> <paramdef><type>text </type> "
+"<parameter>geomgml</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomFromGML</function></"
+"funcdef> <paramdef><type>text </type> <parameter>geomgml</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomFromGML</function></funcdef> <paramdef><type>text </type> "
+"<parameter>geomgml</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:401
+#, no-c-format
+msgid ""
+"Constructs a PostGIS ST_Geometry object from the OGC GML representation."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:402
+#, no-c-format
+msgid ""
+"ST_GeomFromGML works only for GML Geometry fragments. It throws an error if "
+"you try to use it on a whole GML document."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:403
+#, no-c-format
+msgid ""
+"OGC GML versions supported: <itemizedlist> <listitem> <para>GML 3.2.1 "
+"Namespace</para> </listitem> <listitem> <para>GML 3.1.1 Simple Features "
+"profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility)</para> </"
+"listitem> <listitem> <para>GML 2.1.2</para> </listitem> </itemizedlist> OGC "
+"GML standards, cf: <ulink url=\"http://www.opengeospatial.org/standards/gml"
+"\">http://www.opengeospatial.org/standards/gml</ulink>:"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:419 reference_constructor.xml:566
+#, no-c-format
+msgid "Availability: 1.5, requires libxml2 1.6+"
+msgstr "Dostępność: 1.5, wymaga libxml2 1.6+"
+
+#. Tag: para
+#: reference_constructor.xml:421 reference_constructor.xml:568
+#, no-c-format
+msgid "Enhanced: 2.0.0 default srid optional parameter added."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:425
+#, no-c-format
+msgid ""
+"GML allow mixed dimensions (2D and 3D inside the same MultiGeometry for "
+"instance). As PostGIS geometries don't, ST_GeomFromGML convert the whole "
+"geometry to 2D if a missing Z dimension is found once."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:427
+#, no-c-format
+msgid ""
+"GML support mixed SRS inside the same MultiGeometry. As PostGIS geometries "
+"don't, ST_GeomFromGML, in this case, reproject all subgeometries to the SRS "
+"root node. If no srsName attribute available for the GML root node, the "
+"function throw an error."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:429
+#, no-c-format
+msgid ""
+"ST_GeomFromGML function is not pedantic about an explicit GML namespace. You "
+"could avoid to mention it explicitly for common usages. But you need it if "
+"you want to use XLink feature inside GML."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:431
+#, no-c-format
+msgid "ST_GeomFromGML function not support SQL/MM curves geometries."
+msgstr ""
+
+#. Tag: title
+#: reference_constructor.xml:437 reference_constructor.xml:535
+#, no-c-format
+msgid "Examples - A single geometry with srsName"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:438
+#, no-c-format
+msgid ""
+"SELECT ST_GeomFromGML('<![CDATA[\n"
+" <gml:LineString srsName=\"EPSG:4269\">\n"
+" <gml:coordinates>\n"
+" -71.16028,42.258729 -71.160837,42.259112 "
+"-71.161143,42.25932\n"
+" </gml:coordinates>\n"
+" </gml:LineString>']]>);"
+msgstr ""
+"SELECT ST_GeomFromGML('<![CDATA[\n"
+" <gml:LineString srsName=\"EPSG:4269\">\n"
+" <gml:coordinates>\n"
+" -71.16028,42.258729 -71.160837,42.259112 "
+"-71.161143,42.25932\n"
+" </gml:coordinates>\n"
+" </gml:LineString>']]>);"
+
+#. Tag: title
+#: reference_constructor.xml:442
+#, no-c-format
+msgid "Examples - XLink usage"
+msgstr "Przykłady - użycie XLink"
+
+#. Tag: programlisting
+#: reference_constructor.xml:443
+#, no-c-format
+msgid ""
+"SELECT <![CDATA[ST_GeomFromGML('\n"
+" <gml:LineString xmlns:gml=\"http://www.opengis.net/gml\" \n"
+" xmlns:xlink=\"http://www.w3.org/1999/xlink"
+"\"\n"
+" srsName=\"urn:ogc:def:crs:EPSG::4269\">\n"
+" <gml:pointProperty>\n"
+" <gml:Point gml:id=\"p1\"><gml:pos>42.258729 "
+"-71.16028</gml:pos></gml:Point>\n"
+" </gml:pointProperty>\n"
+" <gml:pos>42.259112 -71.160837</gml:pos>\n"
+" <gml:pointProperty>\n"
+" <gml:Point xlink:type=\"simple\" xlink:href="
+"\"#p1\"/>\n"
+" </gml:pointProperty>\n"
+" </gml:LineString>');]]>);"
+msgstr ""
+"SELECT <![CDATA[ST_GeomFromGML('\n"
+" <gml:LineString xmlns:gml=\"http://www.opengis.net/gml\" \n"
+" xmlns:xlink=\"http://www.w3.org/1999/xlink"
+"\"\n"
+" srsName=\"urn:ogc:def:crs:EPSG::4269\">\n"
+" <gml:pointProperty>\n"
+" <gml:Point gml:id=\"p1\"><gml:pos>42.258729 "
+"-71.16028</gml:pos></gml:Point>\n"
+" </gml:pointProperty>\n"
+" <gml:pos>42.259112 -71.160837</gml:pos>\n"
+" <gml:pointProperty>\n"
+" <gml:Point xlink:type=\"simple\" xlink:href="
+"\"#p1\"/>\n"
+" </gml:pointProperty>\n"
+" </gml:LineString>');]]>);"
+
+#. Tag: title
+#: reference_constructor.xml:447
+#, no-c-format
+msgid "Examples - Polyhedral Surface"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:448
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(<![CDATA[ST_GeomFromGML('\n"
+"<gml:PolyhedralSurface>\n"
+"<gml:polygonPatches>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing><gml:posList srsDimension=\"3\">0 0 0 0 0 1 0 1 1 0 1 "
+"0 0 0 0</gml:posList></gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing><gml:posList srsDimension=\"3\">0 0 0 0 1 0 1 1 "
+"0 1 0 0 0 0 0</gml:posList></gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing><gml:posList srsDimension=\"3\">0 0 0 1 0 0 1 0 "
+"1 0 0 1 0 0 0</gml:posList></gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing><gml:posList srsDimension=\"3\">1 1 0 1 1 1 1 0 "
+"1 1 0 0 1 1 0</gml:posList></gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing><gml:posList srsDimension=\"3\">0 1 0 0 1 1 1 1 "
+"1 1 1 0 0 1 0</gml:posList></gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing><gml:posList srsDimension=\"3\">0 0 1 1 0 1 1 1 "
+"1 0 1 1 0 0 1</gml:posList></gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+"</gml:polygonPatches>\n"
+"</gml:PolyhedralSurface>']]>));\n"
+"\n"
+"-- result --\n"
+" POLYHEDRALSURFACE(((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),\n"
+" ((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),\n"
+" ((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),\n"
+" ((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),\n"
+" ((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),\n"
+" ((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1)))"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:454
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsGML\"/>, <xref linkend=\"ST_GMLToSQL\"/>"
+msgstr ", <xref linkend=\"ST_AsGML\"/>, <xref linkend=\"ST_GMLToSQL\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:460
+#, no-c-format
+msgid "ST_GeomFromGeoJSON"
+msgstr "ST_GeomFromGeoJSON"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:461
+#, no-c-format
+msgid ""
+"Takes as input a geojson representation of a geometry and outputs a PostGIS "
+"geometry object"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:466
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_GeomFromGeoJSON</function></funcdef> "
+"<paramdef><type>text </type> <parameter>geomjson</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_GeomFromGeoJSON</function></funcdef> "
+"<paramdef><type>text </type> <parameter>geomjson</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:475
+#, no-c-format
+msgid "Constructs a PostGIS geometry object from the GeoJSON representation."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:476
+#, no-c-format
+msgid ""
+"ST_GeomFromGeoJSON works only for JSON Geometry fragments. It throws an "
+"error if you try to use it on a whole JSON document."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:478
+#, no-c-format
+msgid "Availability: 2.0.0 requires - JSON-C >= 0.9"
+msgstr "Dostępność: 2.0.0 wymaga - JSON-C >= 0.9"
+
+#. Tag: para
+#: reference_constructor.xml:479
+#, no-c-format
+msgid ""
+"If you do not have JSON-C enabled, support you will get an error notice "
+"instead of seeing an output. To enable JSON-C, run configure --with-jsondir=/"
+"path/to/json-c. See <xref linkend=\"installation_configuration\"/> for "
+"details."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:486
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_GeomFromGeoJSON('{\"type\":\"Point\",\"coordinates\":"
+"[-48.23456,20.12345]}')) As wkt;\n"
+"wkt\n"
+"------\n"
+"POINT(-48.23456 20.12345)"
+msgstr ""
+"SELECT ST_AsText(ST_GeomFromGeoJSON('{\"type\":\"Point\",\"coordinates\":"
+"[-48.23456,20.12345]}')) As wkt;\n"
+"wkt\n"
+"------\n"
+"POINT(-48.23456 20.12345)"
+
+#. Tag: programlisting
+#: reference_constructor.xml:487
+#, no-c-format
+msgid ""
+"-- a 3D linestring\n"
+"SELECT ST_AsText(ST_GeomFromGeoJSON('{\"type\":\"LineString\",\"coordinates"
+"\":[[1,2,3],[4,5,6],[7,8,9]]}')) As wkt;\n"
+"\n"
+"wkt\n"
+"-------------------\n"
+"LINESTRING(1 2,4 5,7 8)"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:493
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsGeoJSON\"/>, <xref linkend="
+"\"installation_configuration\"/>"
+msgstr ""
+", <xref linkend=\"ST_AsGeoJSON\"/>, <xref linkend="
+"\"installation_configuration\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:499
+#, no-c-format
+msgid "ST_GeomFromKML"
+msgstr "ST_GeomFromKML"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:500
+#, no-c-format
+msgid ""
+"Takes as input KML representation of geometry and outputs a PostGIS geometry "
+"object"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:505
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_GeomFromKML</function></funcdef> "
+"<paramdef><type>text </type> <parameter>geomkml</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_GeomFromKML</function></funcdef> "
+"<paramdef><type>text </type> <parameter>geomkml</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:514
+#, no-c-format
+msgid ""
+"Constructs a PostGIS ST_Geometry object from the OGC KML representation."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:515
+#, no-c-format
+msgid ""
+"ST_GeomFromKML works only for KML Geometry fragments. It throws an error if "
+"you try to use it on a whole KML document."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:516
+#, no-c-format
+msgid ""
+"OGC KML versions supported: <itemizedlist> <listitem> <para>KML 2.2.0 "
+"Namespace</para> </listitem> </itemizedlist> OGC KML standards, cf: <ulink "
+"url=\"http://www.opengeospatial.org/standards/kml\">http://www."
+"opengeospatial.org/standards/kml</ulink>:"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:526
+#, no-c-format
+msgid "Availability: 1.5,libxml2 2.6+"
+msgstr "Dostępność: 1.5, libxml2 2.6+"
+
+#. Tag: para
+#: reference_constructor.xml:529
+#, no-c-format
+msgid "ST_GeomFromKML function not support SQL/MM curves geometries."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:536
+#, no-c-format
+msgid ""
+"SELECT ST_GeomFromKML('<![CDATA[\n"
+" <LineString>\n"
+" <coordinates>-71.1663,42.2614 \n"
+" -71.1667,42.2616</coordinates>\n"
+" </LineString>']]>);"
+msgstr ""
+"SELECT ST_GeomFromKML('<![CDATA[\n"
+" <LineString>\n"
+" <coordinates>-71.1663,42.2614 \n"
+" -71.1667,42.2616</coordinates>\n"
+" </LineString>']]>);"
+
+#. Tag: para
+#: reference_constructor.xml:541
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsKML\"/>"
+msgstr ", <xref linkend=\"ST_AsKML\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:547
+#, no-c-format
+msgid "ST_GMLToSQL"
+msgstr "ST_GMLToSQL"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:548
+#, no-c-format
+msgid ""
+"Return a specified ST_Geometry value from GML representation. This is an "
+"alias name for ST_GeomFromGML"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:551
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_GMLToSQL</function></funcdef> "
+"<paramdef><type>text </type> <parameter>geomgml</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_GMLToSQL</"
+"function></funcdef> <paramdef><type>text </type> <parameter>geomgml</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>srid</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_GMLToSQL</function></funcdef> "
+"<paramdef><type>text </type> <parameter>geomgml</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_GMLToSQL</"
+"function></funcdef> <paramdef><type>text </type> <parameter>geomgml</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>srid</"
+"parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:565
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support)."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:572
+#, no-c-format
+msgid ", <xref linkend=\"ST_GeomFromGML\"/>, <xref linkend=\"ST_AsGML\"/>"
+msgstr ", <xref linkend=\"ST_GeomFromGML\"/>, <xref linkend=\"ST_AsGML\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:578
+#, no-c-format
+msgid "ST_GeomFromText"
+msgstr "ST_GeomFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:579
+#, no-c-format
+msgid ""
+"Return a specified ST_Geometry value from Well-Known Text representation "
+"(WKT)."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:582
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomFromText</function></funcdef> <paramdef><type>text </type> "
+"<parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomFromText</function></funcdef> <paramdef><type>text </type> "
+"<parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:598
+#, no-c-format
+msgid ""
+"Constructs a PostGIS ST_Geometry object from the OGC Well-Known text "
+"representation."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:602
+#, no-c-format
+msgid ""
+"There are 2 variants of ST_GeomFromText function, the first takes no SRID "
+"and returns a geometry with no defined spatial reference system. The second "
+"takes a spatial reference id as the second argument and returns an "
+"ST_Geometry that includes this srid as part of its meta-data. The srid must "
+"be defined in the spatial_ref_sys table."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:608 reference_constructor.xml:1554
+#, no-c-format
+msgid "&sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:611
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 In prior versions of PostGIS "
+"ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now "
+"illegal in PostGIS 2.0.0 to better conform with SQL/MM standards. This "
+"should now be written as ST_GeomFromText('GEOMETRYCOLLECTION EMPTY')"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:618
+#, no-c-format
+msgid ""
+"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932)');\n"
+"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932)',4269);\n"
+"\n"
+"SELECT ST_GeomFromText('MULTILINESTRING((-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932))');\n"
+"\n"
+"SELECT ST_GeomFromText('POINT(-71.064544 42.28787)');\n"
+"\n"
+"SELECT ST_GeomFromText('POLYGON((-71.1776585052917 "
+"42.3902909739571,-71.1776820268866 42.3903701743239,\n"
+"-71.1776063012595 42.3903825660754,-71.1775826583081 "
+"42.3903033653531,-71.1776585052917 42.3902909739571))');\n"
+"\n"
+"SELECT ST_GeomFromText('MULTIPOLYGON(((-71.1031880899493 42.3152774590236,\n"
+"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n"
+"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n"
+"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n"
+"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n"
+"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n"
+"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n"
+"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n"
+"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n"
+"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n"
+"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n"
+"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n"
+"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n"
+"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n"
+"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n"
+"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n"
+"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n"
+"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n"
+"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n"
+"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n"
+"-71.1031880899493 42.3152774590236)),\n"
+"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n"
+"-71.1043443253471 42.3150676015829,-71.1043850704575 "
+"42.3150793250568,-71.1043632495873 42.315113108546)))',4326);\n"
+"\n"
+"SELECT ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 "
+"150406)');"
+msgstr ""
+"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932)');\n"
+"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932)',4269);\n"
+"\n"
+"SELECT ST_GeomFromText('MULTILINESTRING((-71.160281 42.258729,-71.160837 "
+"42.259113,-71.161144 42.25932))');\n"
+"\n"
+"SELECT ST_GeomFromText('POINT(-71.064544 42.28787)');\n"
+"\n"
+"SELECT ST_GeomFromText('POLYGON((-71.1776585052917 "
+"42.3902909739571,-71.1776820268866 42.3903701743239,\n"
+"-71.1776063012595 42.3903825660754,-71.1775826583081 "
+"42.3903033653531,-71.1776585052917 42.3902909739571))');\n"
+"\n"
+"SELECT ST_GeomFromText('MULTIPOLYGON(((-71.1031880899493 42.3152774590236,\n"
+"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n"
+"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n"
+"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n"
+"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n"
+"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n"
+"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n"
+"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n"
+"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n"
+"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n"
+"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n"
+"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n"
+"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n"
+"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n"
+"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n"
+"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n"
+"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n"
+"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n"
+"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n"
+"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n"
+"-71.1031880899493 42.3152774590236)),\n"
+"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n"
+"-71.1043443253471 42.3150676015829,-71.1043850704575 "
+"42.3150793250568,-71.1043632495873 42.315113108546)))',4326);\n"
+"\n"
+"SELECT ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 "
+"150406)');"
+
+#. Tag: para
+#: reference_constructor.xml:622
+#, no-c-format
+msgid ", <xref linkend=\"ST_GeomFromWKB\"/>, <xref linkend=\"ST_SRID\"/>"
+msgstr ", <xref linkend=\"ST_GeomFromWKB\"/>, <xref linkend=\"ST_SRID\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:628
+#, no-c-format
+msgid "ST_GeomFromWKB"
+msgstr "ST_GeomFromWKB"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:629
+#, no-c-format
+msgid ""
+"Creates a geometry instance from a Well-Known Binary geometry representation "
+"(WKB) and optional SRID."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:634 reference_constructor.xml:1576
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomFromWKB</function></"
+"funcdef> <paramdef><type>bytea </type> <parameter>geom</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomFromWKB</function></funcdef> <paramdef><type>bytea </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_GeomFromWKB</function></"
+"funcdef> <paramdef><type>bytea </type> <parameter>geom</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_GeomFromWKB</function></funcdef> <paramdef><type>bytea </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:651
+#, no-c-format
+msgid ""
+"The <varname>ST_GeomFromWKB</varname> function, takes a well-known binary "
+"representation of a geometry and a Spatial Reference System ID "
+"(<varname>SRID</varname>) and creates an instance of the appropriate "
+"geometry type. This function plays the role of the Geometry Factory in SQL. "
+"This is an alternate name for ST_WKBToSQL."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:657
+#, no-c-format
+msgid "If SRID is not specified, it defaults to -1 (Unknown)."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:658
+#, no-c-format
+msgid ""
+"&sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:659
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.41"
+msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.41"
+
+#. Tag: programlisting
+#: reference_constructor.xml:667
+#, no-c-format
+msgid ""
+"--Although bytea rep contains single \\, these need to be escaped when "
+"inserting into a table \n"
+" -- unless standard_conforming_strings is set to on.\n"
+"SELECT ST_AsEWKT(\n"
+"ST_GeomFromWKB(E'\\\\001\\\\002\\\\000\\\\000\\\\000\\\\002\\\\000\\\\000\\"
+"\\000\\\\037\\\\205\\\\353Q\\\\270~\\\\\\\\\\\\300\\\\323Mb\\\\020X\\\\231C@"
+"\\\\020X9\\\\264\\\\310~\\\\\\\\\\\\300)\\\\\\\\\\\\217\\\\302\\\\365\\"
+"\\230C@',4326)\n"
+");\n"
+" st_asewkt\n"
+"------------------------------------------------------\n"
+" SRID=4326;LINESTRING(-113.98 39.198,-113.981 39.195)\n"
+"(1 row)\n"
+"\n"
+"SELECT\n"
+" ST_AsText(\n"
+" ST_GeomFromWKB(\n"
+" ST_AsEWKB('POINT(2 5)'::geometry)\n"
+" )\n"
+" );\n"
+" st_astext\n"
+"------------\n"
+" POINT(2 5)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:674
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsBinary\"/>, <xref linkend=\"ST_GeomFromEWKB\"/>"
+msgstr ", <xref linkend=\"ST_AsBinary\"/>, <xref linkend=\"ST_GeomFromEWKB\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:680
+#, no-c-format
+msgid "ST_LineFromMultiPoint"
+msgstr "ST_LineFromMultiPoint"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:682
+#, no-c-format
+msgid ""
+"<refpurpose>Creates a LineString from a MultiPoint geometry.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:687
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_LineFromMultiPoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>aMultiPoint</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_LineFromMultiPoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>aMultiPoint</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:697
+#, no-c-format
+msgid "<para>Creates a LineString from a MultiPoint geometry.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:705
+#, no-c-format
+msgid ""
+"--Create a 3d line string from a 3d multipoint\n"
+"SELECT ST_AsEWKT(ST_LineFromMultiPoint(ST_GeomFromEWKT('MULTIPOINT(1 2 3, 4 "
+"5 6, 7 8 9)')));\n"
+"--result--\n"
+"LINESTRING(1 2 3,4 5 6,7 8 9)"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:712
+#, no-c-format
+msgid ", <xref linkend=\"ST_Collect\"/>, <xref linkend=\"ST_MakeLine\"/>"
+msgstr ", <xref linkend=\"ST_Collect\"/>, <xref linkend=\"ST_MakeLine\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:718
+#, no-c-format
+msgid "ST_LineFromText"
+msgstr "ST_LineFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:720
+#, no-c-format
+msgid ""
+"Makes a Geometry from WKT representation with the given SRID. If SRID is not "
+"given, it defaults to -1."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:725
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_LineFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_LineFromText</function></funcdef> <paramdef><type>text </type> "
+"<parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_LineFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_LineFromText</function></funcdef> <paramdef><type>text </type> "
+"<parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:742
+#, no-c-format
+msgid ""
+"Makes a Geometry from WKT with the given SRID. If SRID is not give, it "
+"defaults to -1. If WKT passed in is not a LINESTRING, then null is returned."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:746 reference_constructor.xml:812
+#, no-c-format
+msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:751
+#, no-c-format
+msgid ""
+"If you know all your geometries are LINESTRINGS, its more efficient to just "
+"use ST_GeomFromText. This just calls ST_GeomFromText and adds additional "
+"validation that it returns a linestring."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:757
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.2.8"
+msgstr "&sqlmm_compliant; SQL-MM 3: 7.2.8"
+
+#. Tag: programlisting
+#: reference_constructor.xml:765
+#, no-c-format
+msgid ""
+"SELECT ST_LineFromText('LINESTRING(1 2, 3 4)') AS aline, "
+"ST_LineFromText('POINT(1 2)') AS null_return;\n"
+"aline | null_return\n"
+"------------------------------------------------\n"
+"010200000002000000000000000000F ... | t"
+msgstr ""
+"SELECT ST_LineFromText('LINESTRING(1 2, 3 4)') AS aline, "
+"ST_LineFromText('POINT(1 2)') AS null_return;\n"
+"aline | null_return\n"
+"------------------------------------------------\n"
+"010200000002000000000000000000F ... | t"
+
+#. Tag: refname
+#: reference_constructor.xml:778
+#, no-c-format
+msgid "ST_LineFromWKB"
+msgstr "ST_LineFromWKB"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:780
+#, no-c-format
+msgid "Makes a <varname>LINESTRING</varname> from WKB with the given SRID"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:784
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_LineFromWKB</function></"
+"funcdef> <paramdef><type>bytea </type> <parameter>WKB</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry <function>ST_LineFromWKB</"
+"function></funcdef> <paramdef><type>bytea </type> <parameter>WKB</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>srid</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_LineFromWKB</function></"
+"funcdef> <paramdef><type>bytea </type> <parameter>WKB</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry <function>ST_LineFromWKB</"
+"function></funcdef> <paramdef><type>bytea </type> <parameter>WKB</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>srid</"
+"parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:801
+#, no-c-format
+msgid ""
+"The <varname>ST_LineFromWKB</varname> function, takes a well-known binary "
+"representation of geometry and a Spatial Reference System ID (<varname>SRID</"
+"varname>) and creates an instance of the appropriate geometry type - in this "
+"case, a <varname>LINESTRING</varname> geometry. This function plays the role "
+"of the Geometry Factory in SQL."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:807
+#, no-c-format
+msgid ""
+"If an SRID is not specified, it defaults to -1. <varname>NULL</varname> is "
+"returned if the input <varname>bytea</varname> does not represent a "
+"<varname>LINESTRING</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:817
+#, no-c-format
+msgid ""
+"If you know all your geometries are <varname>LINESTRING</varname>s, its more "
+"efficient to just use <xref linkend=\"ST_GeomFromWKB\"/>. This function just "
+"calls <xref linkend=\"ST_GeomFromWKB\"/> and adds additional validation that "
+"it returns a linestring."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:825 reference_constructor.xml:891
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.2.9"
+msgstr "&sqlmm_compliant; SQL-MM 3: 7.2.9"
+
+#. Tag: programlisting
+#: reference_constructor.xml:833
+#, no-c-format
+msgid ""
+"SELECT ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))) "
+"AS aline,\n"
+" ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('POINT(1 2)'))) "
+"IS NULL AS null_return;\n"
+"aline | null_return\n"
+"------------------------------------------------\n"
+"010200000002000000000000000000F ... | t"
+msgstr ""
+"SELECT ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))) "
+"AS aline,\n"
+" ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('POINT(1 2)'))) "
+"IS NULL AS null_return;\n"
+"aline | null_return\n"
+"------------------------------------------------\n"
+"010200000002000000000000000000F ... | t"
+
+#. Tag: para
+#: reference_constructor.xml:840
+#, no-c-format
+msgid ", <xref linkend=\"ST_LinestringFromWKB\"/>"
+msgstr ", <xref linkend=\"ST_LinestringFromWKB\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:846
+#, no-c-format
+msgid "ST_LinestringFromWKB"
+msgstr "ST_LinestringFromWKB"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:848
+#, no-c-format
+msgid "Makes a geometry from WKB with the given SRID."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:852
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_LinestringFromWKB</function></"
+"funcdef> <paramdef><type>bytea </type> <parameter>WKB</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_LinestringFromWKB</function></funcdef> <paramdef><type>bytea </"
+"type> <parameter>WKB</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_LinestringFromWKB</function></"
+"funcdef> <paramdef><type>bytea </type> <parameter>WKB</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_LinestringFromWKB</function></funcdef> <paramdef><type>bytea </"
+"type> <parameter>WKB</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:869
+#, no-c-format
+msgid ""
+"The <varname>ST_LinestringFromWKB</varname> function, takes a well-known "
+"binary representation of geometry and a Spatial Reference System ID "
+"(<varname>SRID</varname>) and creates an instance of the appropriate "
+"geometry type - in this case, a <varname>LINESTRING</varname> geometry. This "
+"function plays the role of the Geometry Factory in SQL."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:875
+#, no-c-format
+msgid ""
+"If an SRID is not specified, it defaults to -1. <varname>NULL</varname> is "
+"returned if the input <varname>bytea</varname> does not represent a "
+"<varname>LINESTRING</varname> geometry. This an alias for <xref linkend="
+"\"ST_LineFromWKB\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:880
+#, no-c-format
+msgid "OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:884
+#, no-c-format
+msgid ""
+"If you know all your geometries are <varname>LINESTRING</varname>s, it's "
+"more efficient to just use <xref linkend=\"ST_GeomFromWKB\"/>. This function "
+"just calls <xref linkend=\"ST_GeomFromWKB\"/> and adds additional validation "
+"that it returns a <varname>LINESTRING</varname>."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:897
+#, no-c-format
+msgid ""
+"SELECT\n"
+" ST_LineStringFromWKB(\n"
+" ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))\n"
+" ) AS aline,\n"
+" ST_LinestringFromWKB(\n"
+" ST_AsBinary(ST_GeomFromText('POINT(1 2)'))\n"
+" ) IS NULL AS null_return;\n"
+" aline | null_return\n"
+"------------------------------------------------\n"
+"010200000002000000000000000000F ... | t"
+msgstr ""
+"SELECT\n"
+" ST_LineStringFromWKB(\n"
+" ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))\n"
+" ) AS aline,\n"
+" ST_LinestringFromWKB(\n"
+" ST_AsBinary(ST_GeomFromText('POINT(1 2)'))\n"
+" ) IS NULL AS null_return;\n"
+" aline | null_return\n"
+"------------------------------------------------\n"
+"010200000002000000000000000000F ... | t"
+
+#. Tag: para
+#: reference_constructor.xml:904 reference_constructor.xml:1618
+#, no-c-format
+msgid ", <xref linkend=\"ST_LineFromWKB\"/>"
+msgstr ", <xref linkend=\"ST_LineFromWKB\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:910
+#, no-c-format
+msgid "ST_MakeBox2D"
+msgstr "ST_MakeBox2D"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:912
+#, no-c-format
+msgid "Creates a BOX2D defined by the given point geometries."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:918
+#, no-c-format
+msgid ""
+"<funcdef>box2d <function>ST_MakeBox2D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>pointLowLeft</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>pointUpRight</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>box2d <function>ST_MakeBox2D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>pointLowLeft</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>pointUpRight</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:929
+#, no-c-format
+msgid ""
+"Creates a BOX2D defined by the given point geometries. This is useful for "
+"doing range queries"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:937
+#, no-c-format
+msgid ""
+"--Return all features that fall reside or partly reside in a US national "
+"atlas coordinate bounding box\n"
+"--It is assumed here that the geometries are stored with SRID = 2163 (US "
+"National atlas equal area)\n"
+"SELECT feature_id, feature_name, the_geom\n"
+"FROM features\n"
+"WHERE the_geom && ST_SetSRID(ST_MakeBox2D(ST_Point(-989502.1875, "
+"528439.5625),\n"
+" ST_Point(-987121.375 ,529933.1875)),2163)"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:944
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Point\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"ST_SRID\"/>"
+msgstr ""
+", <xref linkend=\"ST_Point\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"ST_SRID\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:950
+#, no-c-format
+msgid "ST_3DMakeBox"
+msgstr "ST_3DMakeBox"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:952
+#, no-c-format
+msgid "Creates a BOX3D defined by the given 3d point geometries."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:957
+#, no-c-format
+msgid ""
+"<funcdef>box3d <function>ST_3DMakeBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>point3DLowLeftBottom</"
+"parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>point3DUpRightTop</parameter></paramdef>"
+msgstr ""
+"<funcdef>box3d <function>ST_3DMakeBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>point3DLowLeftBottom</"
+"parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>point3DUpRightTop</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:968
+#, no-c-format
+msgid "Creates a BOX3D defined by the given 2 3D point geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:975
+#, no-c-format
+msgid "This function supports 3d and will not drop the z-index."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:977
+#, no-c-format
+msgid "Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:984
+#, no-c-format
+msgid ""
+"SELECT ST_3DMakeBox(ST_MakePoint(-989502.1875, 528439.5625, 10),\n"
+" ST_MakePoint(-987121.375 ,529933.1875, 10)) As abb3d\n"
+"\n"
+"--bb3d--\n"
+"--------\n"
+"BOX3D(-989502.1875 528439.5625 10,-987121.375 529933.1875 10)"
+msgstr ""
+"SELECT ST_3DMakeBox(ST_MakePoint(-989502.1875, 528439.5625, 10),\n"
+" ST_MakePoint(-987121.375 ,529933.1875, 10)) As abb3d\n"
+"\n"
+"--bb3d--\n"
+"--------\n"
+"BOX3D(-989502.1875 528439.5625 10,-987121.375 529933.1875 10)"
+
+#. Tag: para
+#: reference_constructor.xml:991
+#, no-c-format
+msgid ", <xref linkend=\"ST_SetSRID\"/>, <xref linkend=\"ST_SRID\"/>"
+msgstr ", <xref linkend=\"ST_SetSRID\"/>, <xref linkend=\"ST_SRID\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:997
+#, no-c-format
+msgid "ST_MakeLine"
+msgstr "ST_MakeLine"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:999
+#, no-c-format
+msgid "Creates a Linestring from point or line geometries."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:1003
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_MakeLine</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>geoms</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry <function>ST_MakeLine</"
+"function></funcdef> <paramdef><type>geometry</type> <parameter>geom1</"
+"parameter></paramdef> <paramdef><type>geometry</type> <parameter>geom2</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_MakeLine</function></funcdef> <paramdef><type>geometry[]</type> "
+"<parameter>geoms_array</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_MakeLine</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>geoms</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry <function>ST_MakeLine</"
+"function></funcdef> <paramdef><type>geometry</type> <parameter>geom1</"
+"parameter></paramdef> <paramdef><type>geometry</type> <parameter>geom2</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_MakeLine</function></funcdef> <paramdef><type>geometry[]</type> "
+"<parameter>geoms_array</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:1025
+#, no-c-format
+msgid ""
+"ST_MakeLine comes in 3 forms: a spatial aggregate that takes rows of point-"
+"or-line geometries and returns a line string, a function that takes an array "
+"of point-or-lines, and a regular function that takes two point-or-line "
+"geometries. You might want to use a subselect to order points before feeding "
+"them to the aggregate version of this function."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1030
+#, no-c-format
+msgid "When adding line components a common node is removed from the output."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1035
+#, no-c-format
+msgid ""
+"Availability: 1.4.0 - ST_MakeLine(geomarray) was introduced. ST_MakeLine "
+"aggregate functions was enhanced to handle more points faster."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1036
+#, no-c-format
+msgid ""
+"Availability: 2.0.0 - Support for linestring input elements was introduced"
+msgstr ""
+
+#. Tag: title
+#: reference_constructor.xml:1040
+#, no-c-format
+msgid "Examples: Spatial Aggregate version"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1041
+#, no-c-format
+msgid ""
+"This example takes a sequence of GPS points and creates one record for each "
+"gps travel where the geometry field is a line string composed of the gps "
+"points in the order of the travel."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1045
+#, no-c-format
+msgid ""
+"-- For pre-PostgreSQL 9.0 - this usually works, \n"
+"-- but the planner may on occasion choose not to respect the order of the "
+"subquery\n"
+"SELECT gps.gps_track, ST_MakeLine(gps.the_geom) As newgeom\n"
+" FROM (SELECT gps_track,gps_time, the_geom\n"
+" FROM gps_points ORDER BY gps_track, gps_time) As "
+"gps\n"
+" GROUP BY gps.gps_track;"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1047
+#, no-c-format
+msgid ""
+"-- If you are using PostgreSQL 9.0+ \n"
+"-- (you can use the new ORDER BY support for aggregates)\n"
+"-- this is a guaranteed way to get a correctly ordered linestring\n"
+"-- Your order by part can order by more than one column if needed\n"
+"SELECT gps.gps_track, ST_MakeLine(gps.the_geom ORDER BY gps_time) As "
+"newgeom\n"
+" FROM gps_points As gps\n"
+" GROUP BY gps.gps_track;"
+msgstr ""
+
+#. Tag: title
+#: reference_constructor.xml:1050
+#, no-c-format
+msgid "Examples: Non-Spatial Aggregate version"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1052
+#, no-c-format
+msgid ""
+"First example is a simple one off line string composed of 2 points. The "
+"second formulates line strings from 2 points a user draws. The third is a "
+"one-off that joins 2 3d points to create a line in 3d space."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1054
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_MakeLine(ST_MakePoint(1,2), ST_MakePoint(3,4)));\n"
+" st_astext\n"
+"---------------------\n"
+" LINESTRING(1 2,3 4)\n"
+"\n"
+"SELECT userpoints.id, ST_MakeLine(startpoint, endpoint) As drawn_line\n"
+" FROM userpoints ;\n"
+"\n"
+"SELECT ST_AsEWKT(ST_MakeLine(ST_MakePoint(1,2,3), ST_MakePoint(3,4,5)));\n"
+" st_asewkt\n"
+"-------------------------\n"
+" LINESTRING(1 2 3,3 4 5)"
+msgstr ""
+"SELECT ST_AsText(ST_MakeLine(ST_MakePoint(1,2), ST_MakePoint(3,4)));\n"
+" st_astext\n"
+"---------------------\n"
+" LINESTRING(1 2,3 4)\n"
+"\n"
+"SELECT userpoints.id, ST_MakeLine(startpoint, endpoint) As drawn_line\n"
+" FROM userpoints ;\n"
+"\n"
+"SELECT ST_AsEWKT(ST_MakeLine(ST_MakePoint(1,2,3), ST_MakePoint(3,4,5)));\n"
+" st_asewkt\n"
+"-------------------------\n"
+" LINESTRING(1 2 3,3 4 5)"
+
+#. Tag: title
+#: reference_constructor.xml:1058
+#, no-c-format
+msgid "Examples: Using Array version"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1060
+#, no-c-format
+msgid ""
+"SELECT ST_MakeLine(ARRAY(SELECT ST_Centroid(the_geom) FROM visit_locations "
+"ORDER BY visit_time));\n"
+"\n"
+"--Making a 3d line with 3 3-d points\n"
+"SELECT ST_AsEWKT(ST_MakeLine(ARRAY[ST_MakePoint(1,2,3),\n"
+" ST_MakePoint(3,4,5), "
+"ST_MakePoint(6,6,6)]));\n"
+" st_asewkt\n"
+"-------------------------\n"
+"LINESTRING(1 2 3,3 4 5,6 6 6)"
+msgstr ""
+"SELECT ST_MakeLine(ARRAY(SELECT ST_Centroid(the_geom) FROM visit_locations "
+"ORDER BY visit_time));\n"
+"\n"
+"--Making a 3d line with 3 3-d points\n"
+"SELECT ST_AsEWKT(ST_MakeLine(ARRAY[ST_MakePoint(1,2,3),\n"
+" ST_MakePoint(3,4,5), "
+"ST_MakePoint(6,6,6)]));\n"
+" st_asewkt\n"
+"-------------------------\n"
+"LINESTRING(1 2 3,3 4 5,6 6 6)"
+
+#. Tag: para
+#: reference_constructor.xml:1067
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_GeomFromText\"/>, <xref "
+"linkend=\"ST_MakePoint\"/>"
+msgstr ""
+", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_GeomFromText\"/>, <xref "
+"linkend=\"ST_MakePoint\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1074
+#, no-c-format
+msgid "ST_MakeEnvelope"
+msgstr "ST_MakeEnvelope"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1076
+#, no-c-format
+msgid ""
+"Creates a rectangular Polygon formed from the given minimums and maximums. "
+"Input values must be in SRS specified by the SRID."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1082
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakeEnvelope</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>xmin</parameter></"
+"paramdef> <paramdef><type>double precision</type> <parameter>ymin</"
+"parameter></paramdef> <paramdef><type>double precision</type> "
+"<parameter>xmax</parameter></paramdef> <paramdef><type>double precision</"
+"type> <parameter>ymax</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>srid=unknown</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_MakeEnvelope</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>xmin</parameter></"
+"paramdef> <paramdef><type>double precision</type> <parameter>ymin</"
+"parameter></paramdef> <paramdef><type>double precision</type> "
+"<parameter>xmax</parameter></paramdef> <paramdef><type>double precision</"
+"type> <parameter>ymax</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>srid=unknown</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1096
+#, no-c-format
+msgid ""
+"Creates a rectangular Polygon formed from the minima and maxima. by the "
+"given shell. Input values must be in SRS specified by the SRID. If no SRID "
+"is specified the unknown spatial reference system is assumed"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1099
+#, no-c-format
+msgid "Availability: 1.5"
+msgstr "Dostępność: 1.5"
+
+#. Tag: para
+#: reference_constructor.xml:1100
+#, no-c-format
+msgid ""
+"Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was "
+"introduced."
+msgstr ""
+
+#. Tag: title
+#: reference_constructor.xml:1105
+#, no-c-format
+msgid "Example: Building a bounding box polygon"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1106
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_MakeEnvelope(10, 10, 11, 11, 4326));\n"
+"\n"
+"st_asewkt\n"
+"-----------\n"
+"POLYGON((10 10, 10 11, 11 11, 11 10, 10 10))"
+msgstr ""
+"SELECT ST_AsText(ST_MakeEnvelope(10, 10, 11, 11, 4326));\n"
+"\n"
+"st_asewkt\n"
+"-----------\n"
+"POLYGON((10 10, 10 11, 11 11, 11 10, 10 10))"
+
+#. Tag: para
+#: reference_constructor.xml:1110
+#, no-c-format
+msgid ", <xref linkend=\"ST_MakeLine\"/>, <xref linkend=\"ST_MakePolygon\"/>"
+msgstr ", <xref linkend=\"ST_MakeLine\"/>, <xref linkend=\"ST_MakePolygon\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1116
+#, no-c-format
+msgid "ST_MakePolygon"
+msgstr "ST_MakePolygon"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1118
+#, no-c-format
+msgid ""
+"Creates a Polygon formed by the given shell. Input geometries must be closed "
+"LINESTRINGS."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1124
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakePolygon</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_MakePolygon</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef>"
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1130
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakePolygon</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>outerlinestring</parameter></"
+"paramdef> <paramdef><type>geometry[]</type> <parameter>interiorlinestrings</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_MakePolygon</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>outerlinestring</parameter></"
+"paramdef> <paramdef><type>geometry[]</type> <parameter>interiorlinestrings</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1141
+#, no-c-format
+msgid ""
+"Creates a Polygon formed by the given shell. Input geometries must be closed "
+"LINESTRINGS. Comes in 2 variants."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1143
+#, no-c-format
+msgid "Variant 1: takes one closed linestring."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1144
+#, no-c-format
+msgid ""
+"Variant 2: Creates a Polygon formed by the given shell and array of holes. "
+"You can construct a geometry array using ST_Accum or the PostgreSQL ARRAY[] "
+"and ARRAY() constructs. Input geometries must be closed LINESTRINGS."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1148
+#, no-c-format
+msgid ""
+"This function will not accept a MULTILINESTRING. Use <xref linkend="
+"\"ST_LineMerge\"/> or <xref linkend=\"ST_Dump\"/> to generate line strings."
+msgstr ""
+
+#. Tag: title
+#: reference_constructor.xml:1155
+#, no-c-format
+msgid "Examples: Single closed LINESTRING"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1156
+#, no-c-format
+msgid ""
+"--2d line\n"
+"SELECT ST_MakePolygon(ST_GeomFromText('LINESTRING(75.15 29.53,77 29,77.6 "
+"29.5, 75.15 29.53)'));\n"
+"--If linestring is not closed\n"
+"--you can add the start point to close it\n"
+"SELECT ST_MakePolygon(ST_AddPoint(foo.open_line, ST_StartPoint(foo."
+"open_line)))\n"
+"FROM (\n"
+"SELECT ST_GeomFromText('LINESTRING(75.15 29.53,77 29,77.6 29.5)') As "
+"open_line) As foo;\n"
+"\n"
+"--3d closed line\n"
+"SELECT ST_MakePolygon(ST_GeomFromText('LINESTRING(75.15 29.53 1,77 29 1,77.6 "
+"29.5 1, 75.15 29.53 1)'));\n"
+"\n"
+"st_asewkt\n"
+"-----------\n"
+"POLYGON((75.15 29.53 1,77 29 1,77.6 29.5 1,75.15 29.53 1))\n"
+"\n"
+"--measured line --\n"
+"SELECT ST_MakePolygon(ST_GeomFromText('LINESTRINGM(75.15 29.53 1,77 29 "
+"1,77.6 29.5 2, 75.15 29.53 2)'));\n"
+"\n"
+"st_asewkt\n"
+"----------\n"
+"POLYGONM((75.15 29.53 1,77 29 1,77.6 29.5 2,75.15 29.53 2))"
+msgstr ""
+
+#. Tag: title
+#: reference_constructor.xml:1159
+#, no-c-format
+msgid "Examples: Outter shell with inner shells"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1161
+#, no-c-format
+msgid "Build a donut with an ant hole"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1162
+#, no-c-format
+msgid ""
+"SELECT ST_MakePolygon(\n"
+" ST_ExteriorRing(ST_Buffer(foo.line,10)),\n"
+" ARRAY[ST_Translate(foo.line,1,1),\n"
+" ST_ExteriorRing(ST_Buffer(ST_MakePoint(20,20),1)) ]\n"
+" )\n"
+"FROM\n"
+" (SELECT ST_ExteriorRing(ST_Buffer(ST_MakePoint(10,10),10,10))\n"
+" As line )\n"
+" As foo;"
+msgstr ""
+"SELECT ST_MakePolygon(\n"
+" ST_ExteriorRing(ST_Buffer(foo.line,10)),\n"
+" ARRAY[ST_Translate(foo.line,1,1),\n"
+" ST_ExteriorRing(ST_Buffer(ST_MakePoint(20,20),1)) ]\n"
+" )\n"
+"FROM\n"
+" (SELECT ST_ExteriorRing(ST_Buffer(ST_MakePoint(10,10),10,10))\n"
+" As line )\n"
+" As foo;"
+
+#. Tag: para
+#: reference_constructor.xml:1163
+#, no-c-format
+msgid ""
+"Build province boundaries with holes representing lakes in the province from "
+"a set of province polygons/multipolygons and water line strings this is an "
+"example of using PostGIS ST_Accum"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1167
+#, no-c-format
+msgid ""
+"The use of CASE because feeding a null array into ST_MakePolygon results in "
+"NULL"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1169
+#, no-c-format
+msgid ""
+"the use of left join to guarantee we get all provinces back even if they "
+"have no lakes"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1170
+#, no-c-format
+msgid ""
+"SELECT p.gid, p.province_name,\n"
+" CASE WHEN\n"
+" ST_Accum(w.the_geom) IS NULL THEN p.the_geom\n"
+" ELSE ST_MakePolygon(ST_LineMerge(ST_Boundary(p.the_geom)), "
+"ST_Accum(w.the_geom)) END\n"
+" FROM\n"
+" provinces p LEFT JOIN waterlines w\n"
+" ON (ST_Within(w.the_geom, p.the_geom) AND "
+"ST_IsClosed(w.the_geom))\n"
+" GROUP BY p.gid, p.province_name, p.the_geom;\n"
+"\n"
+" --Same example above but utilizing a correlated subquery\n"
+" --and PostgreSQL built-in ARRAY() function that converts a row set "
+"to an array\n"
+"\n"
+" SELECT p.gid, p.province_name, CASE WHEN\n"
+" EXISTS(SELECT w.the_geom\n"
+" FROM waterlines w\n"
+" WHERE ST_Within(w.the_geom, p.the_geom)\n"
+" AND ST_IsClosed(w.the_geom))\n"
+" THEN\n"
+" ST_MakePolygon(ST_LineMerge(ST_Boundary(p.the_geom)),\n"
+" ARRAY(SELECT w.the_geom\n"
+" FROM waterlines w\n"
+" WHERE ST_Within(w.the_geom, p.the_geom)\n"
+" AND ST_IsClosed(w.the_geom)))\n"
+" ELSE p.the_geom END As the_geom\n"
+" FROM\n"
+" provinces p;"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1174
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AddPoint\"/>, <xref linkend=\"ST_GeometryType\"/>, "
+"<xref linkend=\"ST_IsClosed\"/>, <xref linkend=\"ST_LineMerge\"/>, <xref "
+"linkend=\"ST_BuildArea\"/>"
+msgstr ""
+", <xref linkend=\"ST_AddPoint\"/>, <xref linkend=\"ST_GeometryType\"/>, "
+"<xref linkend=\"ST_IsClosed\"/>, <xref linkend=\"ST_LineMerge\"/>, <xref "
+"linkend=\"ST_BuildArea\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1187
+#, no-c-format
+msgid "ST_MakePoint"
+msgstr "ST_MakePoint"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1189
+#, no-c-format
+msgid "Creates a 2D,3DZ or 4D point geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1194
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakePoint</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>y</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_MakePoint</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>y</parameter></paramdef>"
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1201
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakePoint</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>y</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>z</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_MakePoint</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>y</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>z</parameter></paramdef>"
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1209
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakePoint</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>y</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>z</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>m</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_MakePoint</function></funcdef> "
+"<paramdef><type>double precision</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>y</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>z</parameter></paramdef> "
+"<paramdef><type>double precision</type> <parameter>m</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1222
+#, no-c-format
+msgid ""
+"Creates a 2D,3DZ or 4D point geometry (geometry with measure). "
+"<varname>ST_MakePoint</varname> while not being OGC compliant is generally "
+"faster and more precise than <xref linkend=\"ST_GeomFromText\"/> and <xref "
+"linkend=\"ST_PointFromText\"/>. It is also easier to use if you have raw "
+"coordinates rather than WKT."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1228
+#, no-c-format
+msgid "Note x is longitude and y is latitude"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1229
+#, no-c-format
+msgid ""
+"Use <xref linkend=\"ST_MakePointM\"/> if you need to make a point with x,y,m."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1236
+#, no-c-format
+msgid ""
+"--Return point with unknown SRID\n"
+"SELECT ST_MakePoint(-71.1043443253471, 42.3150676015829);\n"
+"\n"
+"--Return point marked as WGS 84 long lat\n"
+"SELECT ST_SetSRID(ST_MakePoint(-71.1043443253471, 42.3150676015829),4326);\n"
+"\n"
+"--Return a 3D point (e.g. has altitude)\n"
+"SELECT ST_MakePoint(1, 2,1.5);\n"
+"\n"
+"--Get z of point\n"
+"SELECT ST_Z(ST_MakePoint(1, 2,1.5));\n"
+"result\n"
+"-------\n"
+"1.5"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1240
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_PointFromText\"/>, <xref linkend=\"ST_SetSRID\"/>, "
+"<xref linkend=\"ST_MakePointM\"/>"
+msgstr ""
+", <xref linkend=\"ST_PointFromText\"/>, <xref linkend=\"ST_SetSRID\"/>, "
+"<xref linkend=\"ST_MakePointM\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1246
+#, no-c-format
+msgid "ST_MakePointM"
+msgstr "ST_MakePointM"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1248
+#, no-c-format
+msgid "Creates a point geometry with an x y and m coordinate."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1253
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakePointM</function></funcdef> "
+"<paramdef><type>float</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>y</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>m</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_MakePointM</function></funcdef> "
+"<paramdef><type>float</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>y</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>m</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1265
+#, no-c-format
+msgid "Creates a point with x, y and measure coordinates."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1266
+#, no-c-format
+msgid "Note x is longitude and y is latitude."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1271
+#, no-c-format
+msgid ""
+"We use ST_AsEWKT in these examples to show the text representation instead "
+"of ST_AsText because ST_AsText does not support returning M."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1273
+#, no-c-format
+msgid ""
+"--Return EWKT representation of point with unknown SRID\n"
+"SELECT ST_AsEWKT(ST_MakePointM(-71.1043443253471, 42.3150676015829, 10));\n"
+"\n"
+"--result\n"
+" st_asewkt\n"
+"-----------------------------------------------\n"
+" POINTM(-71.1043443253471 42.3150676015829 10)\n"
+"\n"
+"--Return EWKT representation of point with measure marked as WGS 84 long "
+"lat\n"
+"SELECT ST_AsEWKT(ST_SetSRID(ST_MakePointM(-71.1043443253471, "
+"42.3150676015829,10),4326));\n"
+"\n"
+" st_asewkt\n"
+"---------------------------------------------------------\n"
+"SRID=4326;POINTM(-71.1043443253471 42.3150676015829 10)\n"
+"\n"
+"--Return a 3d point (e.g. has altitude)\n"
+"SELECT ST_MakePoint(1, 2,1.5);\n"
+"\n"
+"--Get m of point\n"
+"SELECT ST_M(ST_MakePointM(-71.1043443253471, 42.3150676015829,10));\n"
+"result\n"
+"-------\n"
+"10"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1277
+#, no-c-format
+msgid ", <xref linkend=\"ST_MakePoint\"/>, <xref linkend=\"ST_SetSRID\"/>"
+msgstr ", <xref linkend=\"ST_MakePoint\"/>, <xref linkend=\"ST_SetSRID\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1283
+#, no-c-format
+msgid "ST_MLineFromText"
+msgstr "ST_MLineFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1285
+#, no-c-format
+msgid "Return a specified ST_MultiLineString value from WKT representation."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:1289
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_MLineFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_MLineFromText</"
+"function></funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_MLineFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_MLineFromText</"
+"function></funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></"
+"paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:1307
+#, no-c-format
+msgid ""
+"Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is "
+"not give, it defaults to -1."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1313
+#, no-c-format
+msgid "Returns null if the WKT is not a MULTILINESTRING"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1316 reference_constructor.xml:1377
+#, no-c-format
+msgid ""
+"If you are absolutely sure all your WKT geometries are points, don't use "
+"this function. It is slower than ST_GeomFromText since it adds an additional "
+"validation step."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1322
+#, no-c-format
+msgid "&sqlmm_compliant;SQL-MM 3: 9.4.4"
+msgstr "&sqlmm_compliant;SQL-MM 3: 9.4.4"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1330
+#, no-c-format
+msgid "SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');"
+msgstr "SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');"
+
+#. Tag: refname
+#: reference_constructor.xml:1343
+#, no-c-format
+msgid "ST_MPointFromText"
+msgstr "ST_MPointFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1345 reference_constructor.xml:1675
+#, no-c-format
+msgid ""
+"<refpurpose>Makes a Geometry from WKT with the given SRID. If SRID is not "
+"give, it defaults to -1.</refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:1350
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_MPointFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_MPointFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_MPointFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_MPointFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:1368
+#, no-c-format
+msgid ""
+"<para>Makes a Geometry from WKT with the given SRID. If SRID is not give, it "
+"defaults to -1.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1374
+#, no-c-format
+msgid "Returns null if the WKT is not a MULTIPOINT"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1382
+#, no-c-format
+msgid "&sfs_compliant; 3.2.6.2"
+msgstr "&sfs_compliant; 3.2.6.2"
+
+#. Tag: para
+#: reference_constructor.xml:1383
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 9.2.4"
+msgstr "&sqlmm_compliant; SQL-MM 3: 9.2.4"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1391
+#, no-c-format
+msgid ""
+"SELECT ST_MPointFromText('MULTIPOINT(1 2, 3 4)');\n"
+"SELECT ST_MPointFromText('MULTIPOINT(-70.9590 42.1180, -70.9611 42.1223)', "
+"4326);"
+msgstr ""
+"SELECT ST_MPointFromText('MULTIPOINT(1 2, 3 4)');\n"
+"SELECT ST_MPointFromText('MULTIPOINT(-70.9590 42.1180, -70.9611 42.1223)', "
+"4326);"
+
+#. Tag: refname
+#: reference_constructor.xml:1404
+#, no-c-format
+msgid "ST_MPolyFromText"
+msgstr "ST_MPolyFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1406
+#, no-c-format
+msgid ""
+"Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not "
+"give, it defaults to -1."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:1411
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_MPolyFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_MPolyFromText</"
+"function></funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_MPolyFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_MPolyFromText</"
+"function></funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></"
+"paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:1429
+#, no-c-format
+msgid ""
+"Makes a MultiPolygon from WKT with the given SRID. If SRID is not give, it "
+"defaults to -1."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1435
+#, no-c-format
+msgid "Throws an error if the WKT is not a MULTIPOLYGON"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1438
+#, no-c-format
+msgid ""
+"If you are absolutely sure all your WKT geometries are multipolygons, don't "
+"use this function. It is slower than ST_GeomFromText since it adds an "
+"additional validation step."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1444
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 9.6.4"
+msgstr "&sqlmm_compliant; SQL-MM 3: 9.6.4"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1452
+#, no-c-format
+msgid ""
+"SELECT ST_MPolyFromText('MULTIPOLYGON(((0 0 1,20 0 1,20 20 1,0 20 1,0 0 1),"
+"(5 5 3,5 7 3,7 7 3,7 5 3,5 5 3)))');\n"
+"SELECt ST_MPolyFromText('MULTIPOLYGON(((-70.916 42.1002,-70.9468 "
+"42.0946,-70.9765 42.0872,-70.9754 42.0875,-70.9749 42.0879,-70.9752 "
+"42.0881,-70.9754 42.0891,-70.9758 42.0894,-70.9759 42.0897,-70.9759 "
+"42.0899,-70.9754 42.0902,-70.9756 42.0906,-70.9753 42.0907,-70.9753 "
+"42.0917,-70.9757 42.0924,-70.9755 42.0928,-70.9755 42.0942,-70.9751 "
+"42.0948,-70.9755 42.0953,-70.9751 42.0958,-70.9751 42.0962,-70.9759 "
+"42.0983,-70.9767 42.0987,-70.9768 42.0991,-70.9771 42.0997,-70.9771 "
+"42.1003,-70.9768 42.1005,-70.977 42.1011,-70.9766 42.1019,-70.9768 "
+"42.1026,-70.9769 42.1033,-70.9775 42.1042,-70.9773 42.1043,-70.9776 "
+"42.1043,-70.9778 42.1048,-70.9773 42.1058,-70.9774 42.1061,-70.9779 "
+"42.1065,-70.9782 42.1078,-70.9788 42.1085,-70.9798 42.1087,-70.9806 "
+"42.109,-70.9807 42.1093,-70.9806 42.1099,-70.9809 42.1109,-70.9808 "
+"42.1112,-70.9798 42.1116,-70.9792 42.1127,-70.979 42.1129,-70.9787 "
+"42.1134,-70.979 42.1139,-70.9791 42.1141,-70.9987 42.1116,-71.0022 42.1273,\n"
+" -70.9408 42.1513,-70.9315 42.1165,-70.916 42.1002)))',4326);"
+msgstr ""
+"SELECT ST_MPolyFromText('MULTIPOLYGON(((0 0 1,20 0 1,20 20 1,0 20 1,0 0 1),"
+"(5 5 3,5 7 3,7 7 3,7 5 3,5 5 3)))');\n"
+"SELECt ST_MPolyFromText('MULTIPOLYGON(((-70.916 42.1002,-70.9468 "
+"42.0946,-70.9765 42.0872,-70.9754 42.0875,-70.9749 42.0879,-70.9752 "
+"42.0881,-70.9754 42.0891,-70.9758 42.0894,-70.9759 42.0897,-70.9759 "
+"42.0899,-70.9754 42.0902,-70.9756 42.0906,-70.9753 42.0907,-70.9753 "
+"42.0917,-70.9757 42.0924,-70.9755 42.0928,-70.9755 42.0942,-70.9751 "
+"42.0948,-70.9755 42.0953,-70.9751 42.0958,-70.9751 42.0962,-70.9759 "
+"42.0983,-70.9767 42.0987,-70.9768 42.0991,-70.9771 42.0997,-70.9771 "
+"42.1003,-70.9768 42.1005,-70.977 42.1011,-70.9766 42.1019,-70.9768 "
+"42.1026,-70.9769 42.1033,-70.9775 42.1042,-70.9773 42.1043,-70.9776 "
+"42.1043,-70.9778 42.1048,-70.9773 42.1058,-70.9774 42.1061,-70.9779 "
+"42.1065,-70.9782 42.1078,-70.9788 42.1085,-70.9798 42.1087,-70.9806 "
+"42.109,-70.9807 42.1093,-70.9806 42.1099,-70.9809 42.1109,-70.9808 "
+"42.1112,-70.9798 42.1116,-70.9792 42.1127,-70.979 42.1129,-70.9787 "
+"42.1134,-70.979 42.1139,-70.9791 42.1141,-70.9987 42.1116,-71.0022 42.1273,\n"
+" -70.9408 42.1513,-70.9315 42.1165,-70.916 42.1002)))',4326);"
+
+#. Tag: refname
+#: reference_constructor.xml:1465
+#, no-c-format
+msgid "ST_Point"
+msgstr "ST_Point"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1467
+#, no-c-format
+msgid ""
+"Returns an ST_Point with the given coordinate values. OGC alias for "
+"ST_MakePoint."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1472
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Point</function></funcdef> "
+"<paramdef><type>float </type> <parameter>x_lon</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>y_lat</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Point</function></funcdef> "
+"<paramdef><type>float </type> <parameter>x_lon</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>y_lat</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1483
+#, no-c-format
+msgid ""
+"Returns an ST_Point with the given coordinate values. MM compliant alias for "
+"ST_MakePoint that takes just an x and y."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1486
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 6.1.2"
+msgstr "&sqlmm_compliant; SQL-MM 3: 6.1.2"
+
+#. Tag: title
+#: reference_constructor.xml:1492
+#, no-c-format
+msgid "Examples: Geometry"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1494
+#, no-c-format
+msgid "SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)"
+msgstr "SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)"
+
+#. Tag: title
+#: reference_constructor.xml:1498
+#, no-c-format
+msgid "Examples: Geography"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1500
+#, no-c-format
+msgid ""
+"SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) "
+"As geography);"
+msgstr ""
+"SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) "
+"As geography);"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1501
+#, no-c-format
+msgid ""
+"-- the :: is PostgreSQL short-hand for casting.\n"
+"SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)::"
+"geography;"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_constructor.xml:1503
+#, no-c-format
+msgid ""
+"--If your point coordinates are in a different spatial reference from WGS-84 "
+"long lat, then you need to transform before casting\n"
+"-- This example we convert a point in Pennsylvania State Plane feet to WGS "
+"84 and then geography\n"
+"SELECT ST_Transform(ST_SetSRID(ST_Point(3637510, 3014852),2273),4326)::"
+"geography;"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1510
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_MakePoint\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"ST_Transform\"/>"
+msgstr ""
+", <xref linkend=\"ST_MakePoint\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"ST_Transform\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1516
+#, no-c-format
+msgid "ST_PointFromText"
+msgstr "ST_PointFromText"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1517
+#, no-c-format
+msgid ""
+"Makes a point Geometry from WKT with the given SRID. If SRID is not given, "
+"it defaults to unknown."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:1521
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_PointFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_PointFromText</function></funcdef> <paramdef><type>text </type> "
+"<parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_PointFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_PointFromText</function></funcdef> <paramdef><type>text </type> "
+"<parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:1537
+#, no-c-format
+msgid ""
+"Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text "
+"representation. If SRID is not give, it defaults to unknown (currently -1). "
+"If geometry is not a WKT point representation, returns null. If completely "
+"invalid WKT, then throws an error."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1543
+#, no-c-format
+msgid ""
+"There are 2 variants of ST_PointFromText function, the first takes no SRID "
+"and returns a geometry with no defined spatial reference system. The second "
+"takes a spatial reference id as the second argument and returns an "
+"ST_Geometry that includes this srid as part of its meta-data. The srid must "
+"be defined in the spatial_ref_sys table."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1550
+#, no-c-format
+msgid ""
+"If you are absolutely sure all your WKT geometries are points, don't use "
+"this function. It is slower than ST_GeomFromText since it adds an additional "
+"validation step. If you are building points from long lat coordinates and "
+"care more about performance and accuracy than OGC compliance, use <xref "
+"linkend=\"ST_MakePoint\"/> or OGC compliant alias <xref linkend=\"ST_Point\"/"
+">."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1555
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 6.1.8"
+msgstr "&sqlmm_compliant; SQL-MM 3: 6.1.8"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1560
+#, no-c-format
+msgid ""
+"SELECT ST_PointFromText('POINT(-71.064544 42.28787)');\n"
+"SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);"
+msgstr ""
+"SELECT ST_PointFromText('POINT(-71.064544 42.28787)');\n"
+"SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);"
+
+#. Tag: para
+#: reference_constructor.xml:1564
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_MakePoint\"/>, <xref linkend=\"ST_Point\"/>, <xref "
+"linkend=\"ST_SRID\"/>"
+msgstr ""
+", <xref linkend=\"ST_MakePoint\"/>, <xref linkend=\"ST_Point\"/>, <xref "
+"linkend=\"ST_SRID\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1570
+#, no-c-format
+msgid "ST_PointFromWKB"
+msgstr "ST_PointFromWKB"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1572
+#, no-c-format
+msgid "Makes a geometry from WKB with the given SRID"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1593
+#, no-c-format
+msgid ""
+"The <varname>ST_PointFromWKB</varname> function, takes a well-known binary "
+"representation of geometry and a Spatial Reference System ID (<varname>SRID</"
+"varname>) and creates an instance of the appropriate geometry type - in this "
+"case, a <varname>POINT</varname> geometry. This function plays the role of "
+"the Geometry Factory in SQL."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1599
+#, no-c-format
+msgid ""
+"If an SRID is not specified, it defaults to -1. <varname>NULL</varname> is "
+"returned if the input <varname>bytea</varname> does not represent a "
+"<varname>POINT</varname> geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1602
+#, no-c-format
+msgid "&sfs_compliant; s3.2.7.2"
+msgstr "&sfs_compliant; s3.2.7.2"
+
+#. Tag: para
+#: reference_constructor.xml:1603
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 6.1.9"
+msgstr "&sqlmm_compliant; SQL-MM 3: 6.1.9"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1611
+#, no-c-format
+msgid ""
+"SELECT\n"
+" ST_AsText(\n"
+" ST_PointFromWKB(\n"
+" ST_AsEWKB('POINT(2 5)'::geometry)\n"
+" )\n"
+" );\n"
+" st_astext\n"
+"------------\n"
+" POINT(2 5)\n"
+"(1 row)\n"
+"\n"
+"SELECT\n"
+" ST_AsText(\n"
+" ST_PointFromWKB(\n"
+" ST_AsEWKB('LINESTRING(2 5, 2 6)'::geometry)\n"
+" )\n"
+" );\n"
+" st_astext\n"
+"-----------\n"
+"\n"
+"(1 row)"
+msgstr ""
+"SELECT\n"
+" ST_AsText(\n"
+" ST_PointFromWKB(\n"
+" ST_AsEWKB('POINT(2 5)'::geometry)\n"
+" )\n"
+" );\n"
+" st_astext\n"
+"------------\n"
+" POINT(2 5)\n"
+"(1 row)\n"
+"\n"
+"SELECT\n"
+" ST_AsText(\n"
+" ST_PointFromWKB(\n"
+" ST_AsEWKB('LINESTRING(2 5, 2 6)'::geometry)\n"
+" )\n"
+" );\n"
+" st_astext\n"
+"-----------\n"
+"\n"
+"(1 row)"
+
+#. Tag: refname
+#: reference_constructor.xml:1624
+#, no-c-format
+msgid "ST_Polygon"
+msgstr "ST_Polygon"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1626
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a polygon built from the specified linestring and SRID.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1631
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Polygon</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>aLineString</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>srid</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Polygon</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>aLineString</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>srid</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1642
+#, no-c-format
+msgid ""
+"<para>Returns a polygon built from the specified linestring and SRID.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1646
+#, no-c-format
+msgid ""
+"ST_Polygon is similar to first version oST_MakePolygon except it also sets "
+"the spatial ref sys (SRID) of the polygon. Will not work with "
+"MULTILINESTRINGS so use LineMerge to merge multilines. Also does not create "
+"polygons with holes. Use ST_MakePolygon for that."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1651
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.3.2"
+msgstr "&sqlmm_compliant; SQL-MM 3: 8.3.2"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1660
+#, no-c-format
+msgid ""
+"--a 2d polygon\n"
+"SELECT ST_Polygon(ST_GeomFromText('LINESTRING(75.15 29.53,77 29,77.6 29.5, "
+"75.15 29.53)'), 4326);\n"
+"\n"
+"--result--\n"
+"POLYGON((75.15 29.53,77 29,77.6 29.5,75.15 29.53))\n"
+"--a 3d polygon\n"
+"SELECT ST_AsEWKT(ST_Polygon(ST_GeomFromEWKT('LINESTRING(75.15 29.53 1,77 29 "
+"1,77.6 29.5 1, 75.15 29.53 1)'), 4326));\n"
+"\n"
+"result\n"
+"------\n"
+"SRID=4326;POLYGON((75.15 29.53 1,77 29 1,77.6 29.5 1,75.15 29.53 1))"
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1667
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>, <xref "
+"linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_LineMerge\"/>, <xref "
+"linkend=\"ST_MakePolygon\"/>"
+msgstr ""
+", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>, <xref "
+"linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_LineMerge\"/>, <xref "
+"linkend=\"ST_MakePolygon\"/>"
+
+#. Tag: refname
+#: reference_constructor.xml:1673
+#, no-c-format
+msgid "ST_PolygonFromText"
+msgstr "ST_PolygonFromText"
+
+#. Tag: funcsynopsis
+#: reference_constructor.xml:1680
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_PolygonFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_PolygonFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_PolygonFromText</function></"
+"funcdef> <paramdef><type>text </type> <parameter>WKT</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_PolygonFromText</function></funcdef> <paramdef><type>text </"
+"type> <parameter>WKT</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_constructor.xml:1696
+#, no-c-format
+msgid ""
+"Makes a Geometry from WKT with the given SRID. If SRID is not give, it "
+"defaults to -1. Returns null if WKT is not a polygon."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1703
+#, no-c-format
+msgid ""
+"If you are absolutely sure all your WKT geometries are polygons, don't use "
+"this function. It is slower than ST_GeomFromText since it adds an additional "
+"validation step."
+msgstr ""
+
+#. Tag: para
+#: reference_constructor.xml:1706
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.3.6"
+msgstr "&sqlmm_compliant; SQL-MM 3: 8.3.6"
+
+#. Tag: programlisting
+#: reference_constructor.xml:1712
+#, no-c-format
+msgid ""
+"SELECT ST_PolygonFromText('POLYGON((-71.1776585052917 "
+"42.3902909739571,-71.1776820268866 42.3903701743239,\n"
+"-71.1776063012595 42.3903825660754,-71.1775826583081 "
+"42.3903033653531,-71.1776585052917 42.3902909739571))');\n"
+"st_polygonfromtext\n"
+"------------------\n"
+"010300000001000000050000006...\n"
+"\n"
+"\n"
+"SELECT ST_PolygonFromText('POINT(1 2)') IS NULL as point_is_notpoly;\n"
+"\n"
+"point_is_not_poly\n"
+"----------\n"
+"t"
+msgstr ""
+"SELECT ST_PolygonFromText('POLYGON((-71.1776585052917 "
+"42.3902909739571,-71.1776820268866 42.3903701743239,\n"
+"-71.1776063012595 42.3903825660754,-71.1775826583081 "
+"42.3903033653531,-71.1776585052917 42.3902909739571))');\n"
+"st_polygonfromtext\n"
+"------------------\n"
+"010300000001000000050000006...\n"
+"\n"
+"\n"
+"SELECT ST_PolygonFromText('POINT(1 2)') IS NULL as point_is_notpoly;\n"
+"\n"
+"point_is_not_poly\n"
+"----------\n"
+"t"
+
+#. Tag: refname
+#: reference_constructor.xml:1725
+#, no-c-format
+msgid "ST_WKBToSQL"
+msgstr "ST_WKBToSQL"
+
+#. Tag: refpurpose
+#: reference_constructor.xml:1726
+#, no-c-format
+msgid ""
+"Return a specified ST_Geometry value from Well-Known Binary representation "
+"(WKB). This is an alias name for ST_GeomFromWKB that takes no srid"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1730
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_WKBToSQL</function></funcdef> "
+"<paramdef><type>bytea </type> <parameter>WKB</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_WKBToSQL</function></funcdef> "
+"<paramdef><type>bytea </type> <parameter>WKB</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1738
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.36"
+msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.36"
+
+#. Tag: refname
+#: reference_constructor.xml:1748
+#, no-c-format
+msgid "ST_WKTToSQL"
+msgstr "ST_WKTToSQL"
+
+#. Tag: funcprototype
+#: reference_constructor.xml:1753
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_WKTToSQL</function></funcdef> "
+"<paramdef><type>text </type> <parameter>WKT</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_WKTToSQL</function></funcdef> "
+"<paramdef><type>text </type> <parameter>WKT</parameter></paramdef>"
+
+#. Tag: para
+#: reference_constructor.xml:1761
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.34"
+msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.34"
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# Jakub Bobrowski <jb@5dstudio.pl>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2014-01-02 14:22+0000\n"
+"Last-Translator: Jakub Bobrowski <jb@5dstudio.pl>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_editor.xml:3
+#, no-c-format
+msgid "Geometry Editors"
+msgstr ""
+
+#. Tag: refname
+#: reference_editor.xml:7
+#, no-c-format
+msgid "ST_AddPoint"
+msgstr "ST_AddPoint"
+
+#. Tag: refpurpose
+#: reference_editor.xml:8
+#, no-c-format
+msgid ""
+"Adds a point to a LineString before point <position> (0-based index)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:13
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_AddPoint</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef> "
+"<paramdef><type>geometry</type> <parameter>point</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_AddPoint</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef> "
+"<paramdef><type>geometry</type> <parameter>point</parameter></paramdef>"
+
+#. Tag: funcprototype
+#: reference_editor.xml:20
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_AddPoint</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef> "
+"<paramdef><type>geometry</type> <parameter>point</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>position</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_AddPoint</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef> "
+"<paramdef><type>geometry</type> <parameter>point</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>position</parameter></paramdef>"
+
+#. Tag: title
+#: reference_editor.xml:30 reference_editor.xml:89 reference_editor.xml:148
+#: reference_editor.xml:193 reference_editor.xml:235 reference_editor.xml:277
+#: reference_editor.xml:317 reference_editor.xml:357 reference_editor.xml:407
+#: reference_editor.xml:453 reference_editor.xml:495 reference_editor.xml:543
+#: reference_editor.xml:582 reference_editor.xml:616 reference_editor.xml:649
+#: reference_editor.xml:693 reference_editor.xml:742 reference_editor.xml:789
+#: reference_editor.xml:838 reference_editor.xml:902 reference_editor.xml:962
+#: reference_editor.xml:1004 reference_editor.xml:1047
+#: reference_editor.xml:1124 reference_editor.xml:1202
+#: reference_editor.xml:1338 reference_editor.xml:1421
+#: reference_editor.xml:1475
+#, no-c-format
+msgid "Description"
+msgstr "Opis"
+
+#. Tag: para
+#: reference_editor.xml:32
+#, no-c-format
+msgid ""
+"Adds a point to a LineString before point <position> (0-based index). "
+"Third parameter can be omitted or set to -1 for appending."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:35 reference_editor.xml:460 reference_editor.xml:619
+#: reference_editor.xml:1009
+#, no-c-format
+msgid "Availability: 1.1.0"
+msgstr "Dostępność: 1.1.0"
+
+#. Tag: para
+#: reference_editor.xml:36 reference_editor.xml:111 reference_editor.xml:158
+#: reference_editor.xml:200 reference_editor.xml:241 reference_editor.xml:321
+#: reference_editor.xml:366 reference_editor.xml:416 reference_editor.xml:620
+#: reference_editor.xml:702 reference_editor.xml:752 reference_editor.xml:800
+#: reference_editor.xml:851 reference_editor.xml:917 reference_editor.xml:1011
+#: reference_editor.xml:1155 reference_editor.xml:1429
+#: reference_editor.xml:1488
+#, no-c-format
+msgid "&Z_support;"
+msgstr "&Z_support;"
+
+#. Tag: title
+#: reference_editor.xml:40 reference_editor.xml:117 reference_editor.xml:163
+#: reference_editor.xml:205 reference_editor.xml:247 reference_editor.xml:287
+#: reference_editor.xml:327 reference_editor.xml:372 reference_editor.xml:421
+#: reference_editor.xml:465 reference_editor.xml:514 reference_editor.xml:554
+#: reference_editor.xml:590 reference_editor.xml:624 reference_editor.xml:655
+#: reference_editor.xml:711 reference_editor.xml:758 reference_editor.xml:807
+#: reference_editor.xml:859 reference_editor.xml:924 reference_editor.xml:976
+#: reference_editor.xml:1015 reference_editor.xml:1063
+#: reference_editor.xml:1160 reference_editor.xml:1236
+#: reference_editor.xml:1366 reference_editor.xml:1434
+#: reference_editor.xml:1494
+#, no-c-format
+msgid "Examples"
+msgstr "Przykłady"
+
+#. Tag: programlisting
+#: reference_editor.xml:41
+#, no-c-format
+msgid ""
+"--guarantee all linestrings in a table are closed\n"
+" --by adding the start point of each linestring to the end of "
+"the line string\n"
+" --only for those that are not closed\n"
+" UPDATE sometable\n"
+" SET the_geom = ST_AddPoint(the_geom, "
+"ST_StartPoint(the_geom))\n"
+" FROM sometable\n"
+" WHERE ST_IsClosed(the_geom) = false;\n"
+"\n"
+" --Adding point to a 3-d line\n"
+" SELECT ST_AsEWKT(ST_AddPoint(ST_GeomFromEWKT('LINESTRING(0 0 "
+"1, 1 1 1)'), ST_MakePoint(1, 2, 3)));\n"
+"\n"
+" --result\n"
+" st_asewkt\n"
+" ----------\n"
+" LINESTRING(0 0 1,1 1 1,1 2 3)"
+msgstr ""
+
+#. Tag: title
+#: reference_editor.xml:44 reference_editor.xml:124 reference_editor.xml:170
+#: reference_editor.xml:212 reference_editor.xml:254 reference_editor.xml:294
+#: reference_editor.xml:334 reference_editor.xml:381 reference_editor.xml:427
+#: reference_editor.xml:470 reference_editor.xml:519 reference_editor.xml:559
+#: reference_editor.xml:595 reference_editor.xml:628 reference_editor.xml:718
+#: reference_editor.xml:765 reference_editor.xml:814 reference_editor.xml:866
+#: reference_editor.xml:931 reference_editor.xml:981 reference_editor.xml:1019
+#: reference_editor.xml:1071 reference_editor.xml:1167
+#: reference_editor.xml:1311 reference_editor.xml:1388
+#: reference_editor.xml:1447 reference_editor.xml:1501
+#, no-c-format
+msgid "See Also"
+msgstr "Zobacz także"
+
+#. Tag: para
+#: reference_editor.xml:45
+#, no-c-format
+msgid ", <xref linkend=\"ST_SetPoint\"/>"
+msgstr ", <xref linkend=\"ST_SetPoint\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:51
+#, no-c-format
+msgid "ST_Affine"
+msgstr "ST_Affine"
+
+#. Tag: refpurpose
+#: reference_editor.xml:53
+#, no-c-format
+msgid ""
+"<refpurpose>Applies a 3d affine transformation to the geometry to do things "
+"like translate, rotate, scale in one step.</refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_editor.xml:57
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Affine</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>a</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>b</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>c</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>d</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>e</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>f</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>g</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>h</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>i</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>xoff</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>yoff</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>zoff</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_Affine</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>a</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>b</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>d</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>e</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>xoff</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>yoff</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_Affine</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>a</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>b</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>c</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>d</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>e</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>f</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>g</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>h</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>i</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>xoff</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>yoff</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>zoff</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_Affine</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>a</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>b</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>d</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>e</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>xoff</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>yoff</"
+"parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_editor.xml:91
+#, no-c-format
+msgid ""
+"<para>Applies a 3d affine transformation to the geometry to do things like "
+"translate, rotate, scale in one step.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:92
+#, no-c-format
+msgid ""
+"Version 1: The call <programlisting>ST_Affine(geom, a, b, c, d, e, f, g, h, "
+"i, xoff, yoff, zoff) </programlisting> represents the transformation matrix "
+"<programlisting>/ a b c xoff \\\n"
+"| d e f yoff |\n"
+"| g h i zoff |\n"
+"\\ 0 0 0 1 /</programlisting> and the vertices are transformed as "
+"follows: <programlisting>x' = a*x + b*y + c*z + xoff\n"
+"y' = d*x + e*y + f*z + yoff\n"
+"z' = g*x + h*y + i*z + zoff</programlisting> All of the translate / scale "
+"functions below are expressed via such an affine transformation."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:99
+#, no-c-format
+msgid ""
+"Version 2: Applies a 2d affine transformation to the geometry. The call "
+"<programlisting>ST_Affine(geom, a, b, d, e, xoff, yoff)</programlisting> "
+"represents the transformation matrix <programlisting>/ a b 0 xoff "
+"\\ / a b xoff \\\n"
+"| d e 0 yoff | rsp. | d e yoff |\n"
+"| 0 0 1 0 | \\ 0 0 1 /\n"
+"\\ 0 0 0 1 /</programlisting> and the vertices are transformed as "
+"follows: <programlisting>x' = a*x + b*y + xoff\n"
+"y' = d*x + e*y + yoff\n"
+"z' = z </programlisting> This method is a subcase of the 3D method above."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:105 reference_editor.xml:699 reference_editor.xml:749
+#: reference_editor.xml:797 reference_editor.xml:846 reference_editor.xml:915
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was "
+"introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:106
+#, no-c-format
+msgid "Availability: 1.1.2. Name changed from Affine to ST_Affine in 1.2.2"
+msgstr ""
+"Dostępność: 1.1.2. Nazwa zmieniona z Affine na ST_Affine w wersji 1.2.2"
+
+#. Tag: para
+#: reference_editor.xml:107 reference_editor.xml:849 reference_editor.xml:911
+#: reference_editor.xml:1356 reference_editor.xml:1426
+#: reference_editor.xml:1484
+#, no-c-format
+msgid ""
+"Prior to 1.3.4, this function crashes if used with geometries that contain "
+"CURVES. This is fixed in 1.3.4+"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:109 reference_editor.xml:157 reference_editor.xml:198
+#: reference_editor.xml:240 reference_editor.xml:365 reference_editor.xml:417
+#: reference_editor.xml:704 reference_editor.xml:751 reference_editor.xml:799
+#: reference_editor.xml:853 reference_editor.xml:916 reference_editor.xml:1361
+#, no-c-format
+msgid "&P_support;"
+msgstr "&P_support;"
+
+#. Tag: para
+#: reference_editor.xml:110 reference_editor.xml:705 reference_editor.xml:753
+#: reference_editor.xml:801 reference_editor.xml:854 reference_editor.xml:919
+#, no-c-format
+msgid "&T_support;"
+msgstr "&T_support;"
+
+#. Tag: para
+#: reference_editor.xml:112 reference_editor.xml:156 reference_editor.xml:199
+#: reference_editor.xml:242 reference_editor.xml:282 reference_editor.xml:322
+#: reference_editor.xml:367 reference_editor.xml:703 reference_editor.xml:852
+#: reference_editor.xml:918 reference_editor.xml:1059
+#: reference_editor.xml:1360 reference_editor.xml:1430
+#: reference_editor.xml:1489
+#, no-c-format
+msgid "&curve_support;"
+msgstr "&curve_support;"
+
+#. Tag: programlisting
+#: reference_editor.xml:119
+#, no-c-format
+msgid ""
+"--Rotate a 3d line 180 degrees about the z axis. Note this is long-hand for "
+"doing ST_Rotate();\n"
+" SELECT ST_AsEWKT(ST_Affine(the_geom, cos(pi()), -sin(pi()), 0, sin(pi()), "
+"cos(pi()), 0, 0, 0, 1, 0, 0, 0)) As using_affine,\n"
+" ST_AsEWKT(ST_Rotate(the_geom, pi())) As using_rotate\n"
+" FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As "
+"the_geom) As foo;\n"
+" using_affine | using_rotate\n"
+"-----------------------------+-----------------------------\n"
+" LINESTRING(-1 -2 3,-1 -4 3) | LINESTRING(-1 -2 3,-1 -4 3)\n"
+"(1 row)\n"
+"\n"
+"--Rotate a 3d line 180 degrees in both the x and z axis\n"
+"SELECT ST_AsEWKT(ST_Affine(the_geom, cos(pi()), -sin(pi()), 0, sin(pi()), "
+"cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), 0, 0, 0))\n"
+" FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As "
+"the_geom) As foo;\n"
+" st_asewkt\n"
+"-------------------------------\n"
+" LINESTRING(-1 -2 -3,-1 -4 -3)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:126
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Scale\"/>, <xref linkend=\"ST_Translate\"/>, <xref "
+"linkend=\"ST_TransScale\"/>"
+msgstr ""
+", <xref linkend=\"ST_Scale\"/>, <xref linkend=\"ST_Translate\"/>, <xref "
+"linkend=\"ST_TransScale\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:132
+#, no-c-format
+msgid "ST_Force_2D"
+msgstr "ST_Force_2D"
+
+#. Tag: refpurpose
+#: reference_editor.xml:134
+#, no-c-format
+msgid ""
+"Forces the geometries into a \"2-dimensional mode\" so that all output "
+"representations will only have the X and Y coordinates."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:140
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Force_2D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Force_2D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:150
+#, no-c-format
+msgid ""
+"Forces the geometries into a \"2-dimensional mode\" so that all output "
+"representations will only have the X and Y coordinates. This is useful for "
+"force OGC-compliant output (since OGC only specifies 2-D geometries)."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:155 reference_editor.xml:197 reference_editor.xml:239
+#: reference_editor.xml:362 reference_editor.xml:415 reference_editor.xml:1358
+#, no-c-format
+msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:165
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_Force_2D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 "
+"5 2, 6 7 2, 5 6 2)')));\n"
+" st_asewkt\n"
+"-------------------------------------\n"
+"CIRCULARSTRING(1 1,2 3,4 5,6 7,5 6)\n"
+"\n"
+"SELECT ST_AsEWKT(ST_Force_2D('POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 "
+"2,1 3 2,1 1 2))'));\n"
+"\n"
+" st_asewkt\n"
+"----------------------------------------------\n"
+" POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))"
+msgstr ""
+"SELECT ST_AsEWKT(ST_Force_2D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 "
+"5 2, 6 7 2, 5 6 2)')));\n"
+" st_asewkt\n"
+"-------------------------------------\n"
+"CIRCULARSTRING(1 1,2 3,4 5,6 7,5 6)\n"
+"\n"
+"SELECT ST_AsEWKT(ST_Force_2D('POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 "
+"2,1 3 2,1 1 2))'));\n"
+"\n"
+" st_asewkt\n"
+"----------------------------------------------\n"
+" POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))"
+
+#. Tag: refname
+#: reference_editor.xml:178
+#, no-c-format
+msgid "ST_Force_3D"
+msgstr "ST_Force_3D"
+
+#. Tag: refpurpose
+#: reference_editor.xml:180
+#, no-c-format
+msgid "Forces the geometries into XYZ mode. This is an alias for ST_Force_3DZ."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:185
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Force_3D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Force_3D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:195
+#, no-c-format
+msgid ""
+"Forces the geometries into XYZ mode. This is an alias for ST_Force_3DZ. If a "
+"geometry has no Z component, then a 0 Z coordinate is tacked on."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:207
+#, no-c-format
+msgid ""
+"--Nothing happens to an already 3D geometry\n"
+" SELECT "
+"ST_AsEWKT(ST_Force_3D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 "
+"7 2, 5 6 2)')));\n"
+" st_asewkt\n"
+"-----------------------------------------------\n"
+" CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)\n"
+"\n"
+"\n"
+"SELECT ST_AsEWKT(ST_Force_3D('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 "
+"1))'));\n"
+"\n"
+" st_asewkt\n"
+"--------------------------------------------------------------\n"
+" POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:214
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Force_2D\"/>, <xref linkend=\"ST_Force_3DM\"/>, <xref "
+"linkend=\"ST_Force_3DZ\"/>"
+msgstr ""
+", <xref linkend=\"ST_Force_2D\"/>, <xref linkend=\"ST_Force_3DM\"/>, <xref "
+"linkend=\"ST_Force_3DZ\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:220
+#, no-c-format
+msgid "ST_Force_3DZ"
+msgstr "ST_Force_3DZ"
+
+#. Tag: refpurpose
+#: reference_editor.xml:222
+#, no-c-format
+msgid "Forces the geometries into XYZ mode. This is a synonym for ST_Force_3D."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:227
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Force_3DZ</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Force_3DZ</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:237
+#, no-c-format
+msgid ""
+"Forces the geometries into XYZ mode. This is a synonym for ST_Force_3DZ. If "
+"a geometry has no Z component, then a 0 Z coordinate is tacked on."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:249
+#, no-c-format
+msgid ""
+"--Nothing happens to an already 3D geometry\n"
+"SELECT ST_AsEWKT(ST_Force_3DZ(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, "
+"4 5 2, 6 7 2, 5 6 2)')));\n"
+" st_asewkt\n"
+"-----------------------------------------------\n"
+" CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)\n"
+"\n"
+"\n"
+"SELECT ST_AsEWKT(ST_Force_3DZ('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 "
+"1))'));\n"
+"\n"
+" st_asewkt\n"
+"--------------------------------------------------------------\n"
+" POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:256 reference_editor.xml:336
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Force_2D\"/>, <xref linkend=\"ST_Force_3DM\"/>, <xref "
+"linkend=\"ST_Force_3D\"/>"
+msgstr ""
+", <xref linkend=\"ST_Force_2D\"/>, <xref linkend=\"ST_Force_3DM\"/>, <xref "
+"linkend=\"ST_Force_3D\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:262
+#, no-c-format
+msgid "ST_Force_3DM"
+msgstr "ST_Force_3DM"
+
+#. Tag: refpurpose
+#: reference_editor.xml:264
+#, no-c-format
+msgid "Forces the geometries into XYM mode."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:269
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Force_3DM</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Force_3DM</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:279
+#, no-c-format
+msgid ""
+"Forces the geometries into XYM mode. If a geometry has no M component, then "
+"a 0 M coordinate is tacked on. If it has a Z component, then Z is removed"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:289
+#, no-c-format
+msgid ""
+"--Nothing happens to an already 3D geometry\n"
+"SELECT ST_AsEWKT(ST_Force_3DM(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, "
+"4 5 2, 6 7 2, 5 6 2)')));\n"
+" st_asewkt\n"
+"------------------------------------------------\n"
+" CIRCULARSTRINGM(1 1 0,2 3 0,4 5 0,6 7 0,5 6 0)\n"
+"\n"
+"\n"
+"SELECT ST_AsEWKT(ST_Force_3DM('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 "
+"1,1 3 1,1 1 1))'));\n"
+"\n"
+" st_asewkt\n"
+"---------------------------------------------------------------\n"
+" POLYGONM((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:296 reference_editor.xml:383
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Force_2D\"/>, <xref linkend=\"ST_Force_3DM\"/>, <xref "
+"linkend=\"ST_Force_3D\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>"
+msgstr ""
+", <xref linkend=\"ST_Force_2D\"/>, <xref linkend=\"ST_Force_3DM\"/>, <xref "
+"linkend=\"ST_Force_3D\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:302
+#, no-c-format
+msgid "ST_Force_4D"
+msgstr "ST_Force_4D"
+
+#. Tag: refpurpose
+#: reference_editor.xml:304
+#, no-c-format
+msgid "Forces the geometries into XYZM mode."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:309
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Force_4D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Force_4D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:319
+#, no-c-format
+msgid ""
+"Forces the geometries into XYZM mode. 0 is tacked on for missing Z and M "
+"dimensions."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:329
+#, no-c-format
+msgid ""
+"--Nothing happens to an already 3D geometry\n"
+"SELECT ST_AsEWKT(ST_Force_4D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 "
+"5 2, 6 7 2, 5 6 2)')));\n"
+" st_asewkt\n"
+"---------------------------------------------------------\n"
+" CIRCULARSTRING(1 1 2 0,2 3 2 0,4 5 2 0,6 7 2 0,5 6 2 0)\n"
+"\n"
+"\n"
+"\n"
+"SELECT ST_AsEWKT(ST_Force_4D('MULTILINESTRINGM((0 0 1,0 5 2,5 0 3,0 0 4),(1 "
+"1 1,3 1 1,1 3 1,1 1 1))'));\n"
+"\n"
+" st_asewkt\n"
+"--------------------------------------------------------------------------------------\n"
+" MULTILINESTRING((0 0 0 1,0 5 0 2,5 0 0 3,0 0 0 4),(1 1 0 1,3 1 0 1,1 3 0 "
+"1,1 1 0 1))"
+msgstr ""
+
+#. Tag: refname
+#: reference_editor.xml:342
+#, no-c-format
+msgid "ST_Force_Collection"
+msgstr "ST_Force_Collection"
+
+#. Tag: refpurpose
+#: reference_editor.xml:344
+#, no-c-format
+msgid "Converts the geometry into a GEOMETRYCOLLECTION."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:349
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Force_Collection</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Force_Collection</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:359
+#, no-c-format
+msgid ""
+"Converts the geometry into a GEOMETRYCOLLECTION. This is useful for "
+"simplifying the WKB representation."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:363
+#, no-c-format
+msgid ""
+"Availability: 1.2.2, prior to 1.3.4 this function will crash with Curves. "
+"This is fixed in 1.3.4+"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:374
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_Force_Collection('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 "
+"1 1,3 1 1,1 3 1,1 1 1))'));\n"
+"\n"
+" st_asewkt\n"
+"----------------------------------------------------------------------------------\n"
+" GEOMETRYCOLLECTION(POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 "
+"1)))\n"
+"\n"
+"\n"
+" SELECT ST_AsText(ST_Force_Collection('CIRCULARSTRING(220227 150406,2220227 "
+"150407,220227 150406)'));\n"
+" st_astext\n"
+"--------------------------------------------------------------------------------\n"
+" GEOMETRYCOLLECTION(CIRCULARSTRING(220227 150406,2220227 150407,220227 "
+"150406))\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:376
+#, no-c-format
+msgid ""
+"-- POLYHEDRAL example --\n"
+"SELECT ST_AsEWKT(ST_Force_Collection('POLYHEDRALSURFACE(((0 0 0,0 0 1,0 1 "
+"1,0 1 0,0 0 0)),\n"
+" ((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),\n"
+" ((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),\n"
+" ((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),\n"
+" ((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),\n"
+" ((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1)))'))\n"
+"\n"
+" st_asewkt\n"
+"----------------------------------------------------------------------------------\n"
+"GEOMETRYCOLLECTION(\n"
+" POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),\n"
+" POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),\n"
+" POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),\n"
+" POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),\n"
+" POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),\n"
+" POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))\n"
+")"
+msgstr ""
+
+#. Tag: refname
+#: reference_editor.xml:390
+#, no-c-format
+msgid "ST_ForceRHR"
+msgstr "ST_ForceRHR"
+
+#. Tag: refpurpose
+#: reference_editor.xml:392
+#, no-c-format
+msgid ""
+"Forces the orientation of the vertices in a polygon to follow the Right-Hand-"
+"Rule."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:398
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_ForceRHR</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>g</parameter></paramdef>"
+msgstr ""
+"<funcdef>boolean <function>ST_ForceRHR</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>g</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:409
+#, no-c-format
+msgid ""
+"Forces the orientation of the vertices in a polygon to follow the Right-Hand-"
+"Rule. In GIS terminology, this means that the area that is bounded by the "
+"polygon is to the right of the boundary. In particular, the exterior ring is "
+"orientated in a clockwise direction and the interior rings in a counter-"
+"clockwise direction."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:423
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(\n"
+" ST_ForceRHR(\n"
+" 'POLYGON((0 0 2, 5 0 2, 0 5 2, 0 0 2),(1 1 2, 1 3 2, 3 1 2, 1 1 "
+"2))'\n"
+" )\n"
+");\n"
+" st_asewkt\n"
+"--------------------------------------------------------------\n"
+" POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 2,1 3 2,1 1 2))\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:429
+#, no-c-format
+msgid ", <xref linkend=\"ST_Polygonize\"/>, <xref linkend=\"ST_Reverse\"/>"
+msgstr ", <xref linkend=\"ST_Polygonize\"/>, <xref linkend=\"ST_Reverse\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:437
+#, no-c-format
+msgid "ST_LineMerge"
+msgstr "ST_LineMerge"
+
+#. Tag: refpurpose
+#: reference_editor.xml:439
+#, no-c-format
+msgid ""
+"Returns a (set of) LineString(s) formed by sewing together a MULTILINESTRING."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:445
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_LineMerge</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>amultilinestring</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_LineMerge</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>amultilinestring</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:455
+#, no-c-format
+msgid ""
+"Returns a (set of) LineString(s) formed by sewing together the constituent "
+"line work of a MULTILINESTRING."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:457
+#, no-c-format
+msgid ""
+"Only use with MULTILINESTRING/LINESTRINGs. If you feed a polygon or geometry "
+"collection into this function, it will return an empty GEOMETRYCOLLECTION"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:461
+#, no-c-format
+msgid "requires GEOS >= 2.1.0"
+msgstr "wymaga GEOS >= 2.1.0"
+
+#. Tag: programlisting
+#: reference_editor.xml:467
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_LineMerge(\n"
+"ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 "
+"-33,-46 -32))')\n"
+" )\n"
+");\n"
+"st_astext\n"
+"--------------------------------------------------------------------------------------------------\n"
+"LINESTRING(-29 -27,-30 -29.7,-36 -31,-45 -33,-46 -32)\n"
+"(1 row)\n"
+"\n"
+"--If can't be merged - original MULTILINESTRING is returned\n"
+"SELECT ST_AsText(ST_LineMerge(\n"
+"ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 "
+"-33.2,-46 -32))')\n"
+")\n"
+");\n"
+"st_astext\n"
+"----------------\n"
+"MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:471
+#, no-c-format
+msgid ", <xref linkend=\"ST_Line_Substring\"/>"
+msgstr ", <xref linkend=\"ST_Line_Substring\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:477
+#, no-c-format
+msgid "ST_CollectionExtract"
+msgstr "ST_CollectionExtract"
+
+#. Tag: refpurpose
+#: reference_editor.xml:479
+#, no-c-format
+msgid ""
+"Given a (multi)geometry, returns a (multi)geometry consisting only of "
+"elements of the specified type."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:486
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_CollectionExtract</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>collection</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>type</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_CollectionExtract</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>collection</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>type</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:497
+#, no-c-format
+msgid ""
+"Given a (multi)geometry, returns a (multi)geometry consisting only of "
+"elements of the specified type. Sub-geometries that are not the specified "
+"type are ignored. If there are no sub-geometries of the right type, an EMPTY "
+"geometry will be returned. Only points, lines and polygons are supported. "
+"Type numbers are 1 == POINT, 2 == LINESTRING, 3 == POLYGON."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:503
+#, no-c-format
+msgid "Availability: 1.5.0"
+msgstr "Dostępność: 1.5.0"
+
+#. Tag: para
+#: reference_editor.xml:505
+#, no-c-format
+msgid ""
+"Prior to 1.5.3 this function returned non-collection inputs untouched, no "
+"matter type. In 1.5.3 non-matching single geometries result in a NULL "
+"return. In of 2.0.0 every case of missing match results in a typed EMPTY "
+"return."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:516
+#, no-c-format
+msgid ""
+"-- Constants: 1 == POINT, 2 == LINESTRING, 3 == POLYGON\n"
+"SELECT "
+"ST_AsText(ST_CollectionExtract(ST_GeomFromText('GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(POINT(0 "
+"0)))'),1));\n"
+"st_astext\n"
+"---------------\n"
+"MULTIPOINT(0 0)\n"
+"(1 row)\n"
+"\n"
+"SELECT "
+"ST_AsText(ST_CollectionExtract(ST_GeomFromText('GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(LINESTRING(0 "
+"0, 1 1)),LINESTRING(2 2, 3 3))'),2));\n"
+"st_astext\n"
+"---------------\n"
+"MULTILINESTRING((0 0, 1 1), (2 2, 3 3))\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:520
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Dump\"/>, <xref linkend=\"ST_CollectionHomogenize\"/>"
+msgstr ""
+", <xref linkend=\"ST_Dump\"/>, <xref linkend=\"ST_CollectionHomogenize\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:526
+#, no-c-format
+msgid "ST_CollectionHomogenize"
+msgstr "ST_CollectionHomogenize"
+
+#. Tag: refpurpose
+#: reference_editor.xml:528
+#, no-c-format
+msgid ""
+"Given a geometry collection, returns the \"simplest\" representation of the "
+"contents."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:535
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_CollectionHomogenize</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>collection</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:545
+#, no-c-format
+msgid ""
+"Given a geometry collection, returns the \"simplest\" representation of the "
+"contents. Singletons will be returned as singletons. Collections that are "
+"homogeneous will be returned as the appropriate multi-type."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:549
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr "Dostępność: 2.0"
+
+#. Tag: programlisting
+#: reference_editor.xml:556
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 "
+"0))')); \n"
+"\n"
+" st_astext\n"
+" ------------\n"
+" POINT(0 0)\n"
+" (1 row)\n"
+"\n"
+" SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 0),"
+"POINT(1 1))')); \n"
+"\n"
+" st_astext\n"
+" ---------------------\n"
+" MULTIPOINT(0 0,1 1)\n"
+" (1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:560
+#, no-c-format
+msgid ", <xref linkend=\"ST_CollectionExtract\"/>"
+msgstr ", <xref linkend=\"ST_CollectionExtract\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:566
+#, no-c-format
+msgid "ST_Multi"
+msgstr "ST_Multi"
+
+#. Tag: refpurpose
+#: reference_editor.xml:568
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the geometry as a MULTI* geometry. If the geometry is "
+"already a MULTI*, it is returned unchanged.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:574
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Multi</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:584
+#, no-c-format
+msgid ""
+"<para>Returns the geometry as a MULTI* geometry. If the geometry is already "
+"a MULTI*, it is returned unchanged.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:592
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Multi(ST_GeomFromText('POLYGON((743238 2967416,743238 "
+"2967450,\n"
+" 743265 2967450,743265.625 2967416,743238 "
+"2967416))')));\n"
+" st_astext\n"
+" --------------------------------------------------------------------------------------------------\n"
+" MULTIPOLYGON(((743238 2967416,743238 2967450,743265 "
+"2967450,743265.625 2967416,\n"
+" 743238 2967416)))\n"
+" (1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_editor.xml:602
+#, no-c-format
+msgid "ST_RemovePoint"
+msgstr "ST_RemovePoint"
+
+#. Tag: refpurpose
+#: reference_editor.xml:603
+#, no-c-format
+msgid "Removes point from a linestring. Offset is 0-based."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:607
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_RemovePoint</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>offset</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:618
+#, no-c-format
+msgid ""
+"Removes point from a linestring. Useful for turning a closed ring into an "
+"open line string"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:625
+#, no-c-format
+msgid ""
+"--guarantee no LINESTRINGS are closed\n"
+"--by removing the end point. The below assumes the_geom is of type "
+"LINESTRING\n"
+"UPDATE sometable\n"
+" SET the_geom = ST_RemovePoint(the_geom, ST_NPoints(the_geom) - 1)\n"
+" FROM sometable\n"
+" WHERE ST_IsClosed(the_geom) = true;"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:629
+#, no-c-format
+msgid ", <xref linkend=\"ST_NPoints\"/>, <xref linkend=\"ST_NumPoints\"/>"
+msgstr ", <xref linkend=\"ST_NPoints\"/>, <xref linkend=\"ST_NumPoints\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:635
+#, no-c-format
+msgid "ST_Reverse"
+msgstr "ST_Reverse"
+
+#. Tag: refpurpose
+#: reference_editor.xml:636
+#, no-c-format
+msgid "Returns the geometry with vertex order reversed."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:641
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Reverse</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Reverse</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:651
+#, no-c-format
+msgid "Can be used on any geometry and reverses the order of the vertexes."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:656
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(the_geom) as line, ST_AsText(ST_Reverse(the_geom)) As "
+"reverseline\n"
+"FROM\n"
+"(SELECT ST_MakeLine(ST_MakePoint(1,2),\n"
+" ST_MakePoint(1,10)) As the_geom) as foo;\n"
+"--result\n"
+" line | reverseline\n"
+"---------------------+----------------------\n"
+"LINESTRING(1 2,1 10) | LINESTRING(1 10,1 2)"
+msgstr ""
+
+#. Tag: refname
+#: reference_editor.xml:662
+#, no-c-format
+msgid "ST_Rotate"
+msgstr "ST_Rotate"
+
+#. Tag: refpurpose
+#: reference_editor.xml:664
+#, no-c-format
+msgid "Rotate a geometry rotRadians counter-clockwise about an origin."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_editor.xml:668
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Rotate</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>rotRadians</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_Rotate</"
+"function></funcdef> <paramdef><type>geometry</type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>rotRadians</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>x0</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>y0</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Rotate</function></funcdef> <paramdef><type>geometry</type> "
+"<parameter>geomA</parameter></paramdef> <paramdef><type>float</type> "
+"<parameter>rotRadians</parameter></paramdef> <paramdef><type>geometry</type> "
+"<parameter>pointOrigin</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_Rotate</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>rotRadians</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_Rotate</"
+"function></funcdef> <paramdef><type>geometry</type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>rotRadians</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>x0</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>y0</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Rotate</function></funcdef> <paramdef><type>geometry</type> "
+"<parameter>geomA</parameter></paramdef> <paramdef><type>float</type> "
+"<parameter>rotRadians</parameter></paramdef> <paramdef><type>geometry</type> "
+"<parameter>pointOrigin</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_editor.xml:695
+#, no-c-format
+msgid ""
+"Rotates geometry rotRadians counter-clockwise about the origin. The rotation "
+"origin can be specified either as a POINT geometry, or as x and y "
+"coordinates. If the origin is not specified, the geometry is rotated about "
+"POINT(0 0)."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:700
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 additional parameters for specifying the origin of rotation "
+"were added."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:701
+#, no-c-format
+msgid "Availability: 1.1.2. Name changed from Rotate to ST_Rotate in 1.2.2"
+msgstr ""
+"Dostępność: 1.1.2. Nazwę zmieniono z Rotate na ST_Rotate w wersji 1.2.2"
+
+#. Tag: programlisting
+#: reference_editor.xml:713
+#, no-c-format
+msgid ""
+"--Rotate 180 degrees\n"
+"SELECT ST_AsEWKT(ST_Rotate('LINESTRING (50 160, 50 50, 100 50)', pi()));\n"
+" st_asewkt\n"
+"---------------------------------------\n"
+" LINESTRING(-50 -160,-50 -50,-100 -50)\n"
+"(1 row)\n"
+"\n"
+"--Rotate 30 degrees counter-clockwise at x=50, y=160\n"
+"SELECT ST_AsEWKT(ST_Rotate('LINESTRING (50 160, 50 50, 100 50)', pi()/6, 50, "
+"160));\n"
+" st_asewkt\n"
+"---------------------------------------------------------------------------\n"
+" LINESTRING(50 160,105 64.7372055837117,148.301270189222 89.7372055837117)\n"
+"(1 row)\n"
+"\n"
+"--Rotate 60 degrees clockwise from centroid\n"
+"SELECT ST_AsEWKT(ST_Rotate(geom, -pi()/3, ST_Centroid(geom)))\n"
+"FROM (SELECT 'LINESTRING (50 160, 50 50, 100 50)'::geometry AS geom) AS "
+"foo;\n"
+" st_asewkt\n"
+"--------------------------------------------------------------\n"
+" LINESTRING(116.4225 130.6721,21.1597 75.6721,46.1597 32.3708)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:720
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_RotateX\"/>, <xref linkend=\"ST_RotateY\"/>, <xref "
+"linkend=\"ST_RotateZ\"/>"
+msgstr ""
+", <xref linkend=\"ST_RotateX\"/>, <xref linkend=\"ST_RotateY\"/>, <xref "
+"linkend=\"ST_RotateZ\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:726
+#, no-c-format
+msgid "ST_RotateX"
+msgstr "ST_RotateX"
+
+#. Tag: refpurpose
+#: reference_editor.xml:728
+#, no-c-format
+msgid "Rotate a geometry rotRadians about the X axis."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:733
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_RotateX</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>rotRadians</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:744
+#, no-c-format
+msgid "Rotate a geometry geomA - rotRadians about the X axis."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:746
+#, no-c-format
+msgid ""
+"<code>ST_RotateX(geomA, rotRadians)</code> is short-hand for "
+"<code>ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, "
+"sin(rotRadians), cos(rotRadians), 0, 0, 0)</code>."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:750
+#, no-c-format
+msgid "Availability: 1.1.2. Name changed from RotateX to ST_RotateX in 1.2.2"
+msgstr ""
+"Dostępność: 1.1.2. Nazwa zmieniona z RotateX na ST_RotateX w wersji 1.2.2"
+
+#. Tag: programlisting
+#: reference_editor.xml:760
+#, no-c-format
+msgid ""
+"--Rotate a line 90 degrees along x-axis\n"
+"SELECT ST_AsEWKT(ST_RotateX(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), "
+"pi()/2));\n"
+" st_asewkt\n"
+"---------------------------\n"
+" LINESTRING(1 -3 2,1 -1 1)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:767
+#, no-c-format
+msgid ", <xref linkend=\"ST_RotateY\"/>, <xref linkend=\"ST_RotateZ\"/>"
+msgstr ", <xref linkend=\"ST_RotateY\"/>, <xref linkend=\"ST_RotateZ\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:773
+#, no-c-format
+msgid "ST_RotateY"
+msgstr "ST_RotateY"
+
+#. Tag: refpurpose
+#: reference_editor.xml:775
+#, no-c-format
+msgid "Rotate a geometry rotRadians about the Y axis."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:780
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_RotateY</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>rotRadians</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_RotateY</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>rotRadians</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:791
+#, no-c-format
+msgid "Rotate a geometry geomA - rotRadians about the y axis."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:793
+#, no-c-format
+msgid ""
+"<code>ST_RotateY(geomA, rotRadians)</code> is short-hand for "
+"<code>ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -"
+"sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)</code>."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:796
+#, no-c-format
+msgid "Availability: 1.1.2. Name changed from RotateY to ST_RotateY in 1.2.2"
+msgstr ""
+"Dostępność: 1.1.2. Nazwa zmieniona z RotateY na ST_RotateY w wersji 1.2.2"
+
+#. Tag: programlisting
+#: reference_editor.xml:809
+#, no-c-format
+msgid ""
+"--Rotate a line 90 degrees along y-axis\n"
+" SELECT ST_AsEWKT(ST_RotateY(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), "
+"pi()/2));\n"
+" st_asewkt\n"
+"---------------------------\n"
+" LINESTRING(3 2 -1,1 1 -1)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:816
+#, no-c-format
+msgid ", <xref linkend=\"ST_RotateX\"/>, <xref linkend=\"ST_RotateZ\"/>"
+msgstr ", <xref linkend=\"ST_RotateX\"/>, <xref linkend=\"ST_RotateZ\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:822
+#, no-c-format
+msgid "ST_RotateZ"
+msgstr "ST_RotateZ"
+
+#. Tag: refpurpose
+#: reference_editor.xml:824
+#, no-c-format
+msgid "Rotate a geometry rotRadians about the Z axis."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:829
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_RotateZ</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>rotRadians</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_RotateZ</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>rotRadians</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:840
+#, no-c-format
+msgid "Rotate a geometry geomA - rotRadians about the Z axis."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:842
+#, no-c-format
+msgid "This is a synonym for ST_Rotate"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:843
+#, no-c-format
+msgid ""
+"<code>ST_RotateZ(geomA, rotRadians)</code> is short-hand for <code>SELECT "
+"ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), "
+"cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)</code>."
+msgstr ""
+"<code>ST_RotateZ(geomA, rotRadians)</code> is short-hand for <code>SELECT "
+"ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), "
+"cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)</code>."
+
+#. Tag: para
+#: reference_editor.xml:848
+#, no-c-format
+msgid "Availability: 1.1.2. Name changed from RotateZ to ST_RotateZ in 1.2.2"
+msgstr ""
+"Dostępność: 1.1.2. Nazwa zmieniona z RotateZ na ST_RotateZ w wersji 1.2.2"
+
+#. Tag: programlisting
+#: reference_editor.xml:861
+#, no-c-format
+msgid ""
+"--Rotate a line 90 degrees along z-axis\n"
+"SELECT ST_AsEWKT(ST_RotateZ(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), "
+"pi()/2));\n"
+" st_asewkt\n"
+"---------------------------\n"
+" LINESTRING(-2 1 3,-1 1 1)\n"
+"\n"
+" --Rotate a curved circle around z-axis\n"
+"SELECT ST_AsEWKT(ST_RotateZ(the_geom, pi()/2))\n"
+"FROM (SELECT ST_LineToCurve(ST_Buffer(ST_GeomFromText('POINT(234 567)'), 3)) "
+"As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"----------------------------------------------------------------------------------------------------------------------------\n"
+" CURVEPOLYGON(CIRCULARSTRING(-567 237,-564.87867965644 236.12132034356,-564 "
+"234,-569.12132034356 231.87867965644,-567 237))"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:868
+#, no-c-format
+msgid ", <xref linkend=\"ST_RotateX\"/>, <xref linkend=\"ST_RotateY\"/>"
+msgstr ", <xref linkend=\"ST_RotateX\"/>, <xref linkend=\"ST_RotateY\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:874
+#, no-c-format
+msgid "ST_Scale"
+msgstr "ST_Scale"
+
+#. Tag: refpurpose
+#: reference_editor.xml:876
+#, no-c-format
+msgid ""
+"<refpurpose>Scales the geometry to a new size by multiplying the ordinates "
+"with the parameters. Ie: ST_Scale(geom, Xfactor, Yfactor, Zfactor).</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_editor.xml:883
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Scale</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>XFactor</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>YFactor</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>ZFactor</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_Scale</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>XFactor</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>YFactor</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_Scale</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>XFactor</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>YFactor</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>ZFactor</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_Scale</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>XFactor</"
+"parameter></paramdef> <paramdef><type>float</type> <parameter>YFactor</"
+"parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_editor.xml:904
+#, no-c-format
+msgid ""
+"<para>Scales the geometry to a new size by multiplying the ordinates with "
+"the parameters. Ie: ST_Scale(geom, Xfactor, Yfactor, Zfactor).</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:908
+#, no-c-format
+msgid ""
+"<code>ST_Scale(geomA, XFactor, YFactor, ZFactor)</code> is short-hand for "
+"<code>ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, ZFactor, 0, 0, "
+"0)</code>."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:914 reference_editor.xml:1487
+#, no-c-format
+msgid "Availability: 1.1.0."
+msgstr "Dostępność: 1.1.0"
+
+#. Tag: programlisting
+#: reference_editor.xml:926
+#, no-c-format
+msgid ""
+"--Version 1: scale X, Y, Z\n"
+"SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, "
+"0.75, 0.8));\n"
+" st_asewkt\n"
+"--------------------------------------\n"
+" LINESTRING(0.5 1.5 2.4,0.5 0.75 0.8)\n"
+"\n"
+"--Version 2: Scale X Y\n"
+" SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, "
+"0.75));\n"
+" st_asewkt\n"
+"----------------------------------\n"
+" LINESTRING(0.5 1.5 3,0.5 0.75 1)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:933
+#, no-c-format
+msgid ", <xref linkend=\"ST_TransScale\"/>"
+msgstr ", <xref linkend=\"ST_TransScale\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:939
+#, no-c-format
+msgid "ST_Segmentize"
+msgstr "ST_Segmentize"
+
+#. Tag: refpurpose
+#: reference_editor.xml:941
+#, no-c-format
+msgid ""
+"Return a modified geometry/geography having no segment longer than the given "
+"distance. Distance computation is performed in 2d only. For geometry, length "
+"units are in units of spatial reference. For geography, units are in meters."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_editor.xml:947
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Segmentize</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>geom</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>max_segment_length</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Segmentize</function></funcdef> <paramdef><type>geography </"
+"type> <parameter>geog</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>max_segment_length</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_Segmentize</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>geom</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>max_segment_length</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Segmentize</function></funcdef> <paramdef><type>geography </"
+"type> <parameter>geog</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>max_segment_length</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_editor.xml:964
+#, no-c-format
+msgid ""
+"Returns a modified geometry having no segment longer than the given "
+"<varname>max_segment_length</varname>. Distance computation is performed in "
+"2d only. For geometry, length units are in units of spatial reference. For "
+"geography, units are in meters."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:967 reference_editor.xml:1428
+#, no-c-format
+msgid "Availability: 1.2.2"
+msgstr "Dostępność: 1.2.2"
+
+#. Tag: para
+#: reference_editor.xml:968
+#, no-c-format
+msgid "Enhanced: 2.1.0 support for geography was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:969
+#, no-c-format
+msgid ""
+"Changed: 2.1.0 As a result of the introduction of geography support: The "
+"construct <code>SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5);</code> "
+"will result in ambiguous function error. You need to have properly typed "
+"object e.g. a geometry/geography column, use ST_GeomFromText, "
+"ST_GeogFromText or <code>SELECT ST_Segmentize('LINESTRING(1 2, 3 4)'::"
+"geometry,0.5);</code>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:971
+#, no-c-format
+msgid ""
+"This will only increase segments. It will not lengthen segments shorter than "
+"max length"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:978
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Segmentize(\n"
+"ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 "
+"-33,-46 -32))')\n"
+" ,5)\n"
+");\n"
+"st_astext\n"
+"--------------------------------------------------------------------------------------------------\n"
+"MULTILINESTRING((-29 -27,-30 -29.7,-34.886615700134 -30.758766735029,-36 "
+"-31,\n"
+"-40.8809353009198 -32.0846522890933,-45 -33),\n"
+"(-45 -33,-46 -32))\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_AsText(ST_Segmentize(ST_GeomFromText('POLYGON((-29 28, -30 40, -29 "
+"28))'),10));\n"
+"st_astext\n"
+"-----------------------\n"
+"POLYGON((-29 28,-29.8304547985374 37.9654575824488,-30 40,-29.1695452014626 "
+"30.0345424175512,-29 28))\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_editor.xml:988
+#, no-c-format
+msgid "ST_SetPoint"
+msgstr "ST_SetPoint"
+
+#. Tag: refpurpose
+#: reference_editor.xml:989
+#, no-c-format
+msgid "Replace point N of linestring with given point. Index is 0-based."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:994
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_SetPoint</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>zerobasedposition</parameter></"
+"paramdef> <paramdef><type>geometry</type> <parameter>point</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_SetPoint</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>linestring</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>zerobasedposition</parameter></"
+"paramdef> <paramdef><type>geometry</type> <parameter>point</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:1006
+#, no-c-format
+msgid ""
+"Replace point N of linestring with given point. Index is 0-based. This is "
+"especially useful in triggers when trying to maintain relationship of joints "
+"when one vertex moves."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1016
+#, no-c-format
+msgid ""
+"--Change first point in line string from -1 3 to -1 1\n"
+"SELECT ST_AsText(ST_SetPoint('LINESTRING(-1 2,-1 3)', 0, 'POINT(-1 1)'));\n"
+" st_astext\n"
+"-----------------------\n"
+" LINESTRING(-1 1,-1 3)\n"
+"\n"
+"---Change last point in a line string (lets play with 3d linestring this "
+"time)\n"
+"SELECT ST_AsEWKT(ST_SetPoint(foo.the_geom, ST_NumPoints(foo.the_geom) - 1, "
+"ST_GeomFromEWKT('POINT(-1 1 3)')))\n"
+"FROM (SELECT ST_GeomFromEWKT('LINESTRING(-1 2 3,-1 3 4, 5 6 7)') As "
+"the_geom) As foo;\n"
+" st_asewkt\n"
+"-----------------------\n"
+"LINESTRING(-1 2 3,-1 3 4,-1 1 3)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1020
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_NPoints\"/>, <xref linkend=\"ST_NumPoints\"/>, <xref "
+"linkend=\"ST_PointN\"/>, <xref linkend=\"ST_RemovePoint\"/>"
+msgstr ""
+", <xref linkend=\"ST_NPoints\"/>, <xref linkend=\"ST_NumPoints\"/>, <xref "
+"linkend=\"ST_PointN\"/>, <xref linkend=\"ST_RemovePoint\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:1026
+#, no-c-format
+msgid "ST_SetSRID"
+msgstr "ST_SetSRID"
+
+#. Tag: refpurpose
+#: reference_editor.xml:1028
+#, no-c-format
+msgid "Sets the SRID on a geometry to a particular integer value."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:1034
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_SetSRID</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_SetSRID</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:1049
+#, no-c-format
+msgid ""
+"Sets the SRID on a geometry to a particular integer value. Useful in "
+"constructing bounding boxes for queries."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1053
+#, no-c-format
+msgid ""
+"This function does not transform the geometry coordinates in any way - it "
+"simply sets the meta data defining the spatial reference system the geometry "
+"is assumed to be in. Use <xref linkend=\"ST_Transform\"/> if you want to "
+"transform the geometry into a new projection."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1058
+#, no-c-format
+msgid "&sfs_compliant;"
+msgstr "&sfs_compliant;"
+
+#. Tag: para
+#: reference_editor.xml:1064
+#, no-c-format
+msgid "-- Mark a point as WGS 84 long lat --"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1065
+#, no-c-format
+msgid ""
+"SELECT ST_SetSRID(ST_Point(-123.365556, 48.428611),4326) As wgs84long_lat;\n"
+"-- the ewkt representation (wrap with ST_AsEWKT) -\n"
+"SRID=4326;POINT(-123.365556 48.428611)"
+msgstr ""
+"SELECT ST_SetSRID(ST_Point(-123.365556, 48.428611),4326) As wgs84long_lat;\n"
+"-- the ewkt representation (wrap with ST_AsEWKT) -\n"
+"SRID=4326;POINT(-123.365556 48.428611)"
+
+#. Tag: para
+#: reference_editor.xml:1066
+#, no-c-format
+msgid ""
+"-- Mark a point as WGS 84 long lat and then transform to web mercator "
+"(Spherical Mercator) --"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1067
+#, no-c-format
+msgid ""
+"SELECT ST_Transform(ST_SetSRID(ST_Point(-123.365556, 48.428611),4326),3785) "
+"As spere_merc;\n"
+"-- the ewkt representation (wrap with ST_AsEWKT) -\n"
+"SRID=3785;POINT(-13732990.8753491 6178458.96425423)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1073
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_Point\"/>, <xref linkend="
+"\"ST_SRID\"/>, <xref linkend=\"ST_Transform\"/>, <xref linkend="
+"\"UpdateGeometrySRID\"/>"
+msgstr ""
+", <xref linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_Point\"/>, <xref linkend="
+"\"ST_SRID\"/>, <xref linkend=\"ST_Transform\"/>, <xref linkend="
+"\"UpdateGeometrySRID\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:1080
+#, no-c-format
+msgid "ST_SnapToGrid"
+msgstr "ST_SnapToGrid"
+
+#. Tag: refpurpose
+#: reference_editor.xml:1082
+#, no-c-format
+msgid "Snap all points of the input geometry to a regular grid."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_editor.xml:1088
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_SnapToGrid</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>geomA</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>originX</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>originY</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>sizeX</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>sizeY</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_SnapToGrid</function></funcdef> <paramdef><type>geometry </"
+"type> <parameter>geomA</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeX</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeY</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>geometry <function>ST_SnapToGrid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>size</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_SnapToGrid</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>pointOrigin</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeX</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeY</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeZ</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeM</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_SnapToGrid</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>geomA</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>originX</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>originY</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>sizeX</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>sizeY</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_SnapToGrid</function></funcdef> <paramdef><type>geometry </"
+"type> <parameter>geomA</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeX</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeY</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>geometry <function>ST_SnapToGrid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>size</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_SnapToGrid</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>geomA</"
+"parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>pointOrigin</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeX</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeY</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeZ</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>sizeM</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_editor.xml:1126
+#, no-c-format
+msgid ""
+"Variant 1,2,3: Snap all points of the input geometry to the grid defined by "
+"its origin and cell size. Remove consecutive points falling on the same "
+"cell, eventually returning NULL if output points are not enough to define a "
+"geometry of the given type. Collapsed geometries in a collection are "
+"stripped from it. Useful for reducing precision."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1134
+#, no-c-format
+msgid ""
+"Variant 4: Introduced 1.1.0 - Snap all points of the input geometry to the "
+"grid defined by its origin (the second argument, must be a point) and cell "
+"sizes. Specify 0 as size for any dimension you don't want to snap to a grid."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1140
+#, no-c-format
+msgid ""
+"The returned geometry might loose its simplicity (see <xref linkend="
+"\"ST_IsSimple\"/>)."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1145
+#, no-c-format
+msgid ""
+"Before release 1.1.0 this function always returned a 2d geometry. Starting "
+"at 1.1.0 the returned geometry will have same dimensionality as the input "
+"one with higher dimension values untouched. Use the version taking a second "
+"geometry argument to define all grid dimensions."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1152
+#, no-c-format
+msgid "Availability: 1.0.0RC1"
+msgstr "Dostępność: 1.0.0RC1"
+
+#. Tag: para
+#: reference_editor.xml:1153
+#, no-c-format
+msgid "Availability: 1.1.0 - Z and M support"
+msgstr "Dostępność: 1.1.0 - wsparcie dla Z i M"
+
+#. Tag: programlisting
+#: reference_editor.xml:1162
+#, no-c-format
+msgid ""
+"--Snap your geometries to a precision grid of 10^-3\n"
+"UPDATE mytable\n"
+" SET the_geom = ST_SnapToGrid(the_geom, 0.001);\n"
+"\n"
+"SELECT ST_AsText(ST_SnapToGrid(\n"
+" ST_GeomFromText('LINESTRING(1.1115678 2.123, "
+"4.111111 3.2374897, 4.11112 3.23748667)'),\n"
+" 0.001)\n"
+" );\n"
+" st_astext\n"
+"-------------------------------------\n"
+" LINESTRING(1.112 2.123,4.111 3.237)\n"
+" --Snap a 4d geometry\n"
+"SELECT ST_AsEWKT(ST_SnapToGrid(\n"
+" ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 2.3456 1.11111,\n"
+" 4.111111 3.2374897 3.1234 1.1111, -1.11111112 2.123 2.3456 "
+"1.1111112)'),\n"
+" ST_GeomFromEWKT('POINT(1.12 2.22 3.2 4.4444)'),\n"
+" 0.1, 0.1, 0.1, 0.01) );\n"
+" st_asewkt\n"
+"------------------------------------------------------------------------------\n"
+" LINESTRING(-1.08 2.12 2.3 1.1144,4.12 3.22 3.1 1.1144,-1.08 2.12 2.3 "
+"1.1144)\n"
+"\n"
+"\n"
+"--With a 4d geometry - the ST_SnapToGrid(geom,size) only touches x and y "
+"coords but keeps m and z the same\n"
+"SELECT ST_AsEWKT(ST_SnapToGrid(ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 "
+"3 2.3456,\n"
+" 4.111111 3.2374897 3.1234 1.1111)'),\n"
+" 0.01) );\n"
+" st_asewkt\n"
+"---------------------------------------------------------\n"
+" LINESTRING(-1.11 2.12 3 2.3456,4.11 3.24 3.1234 1.1111)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1169
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_AsText\"/>, <xref "
+"linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>, <xref "
+"linkend=\"ST_Simplify\"/>"
+msgstr ""
+", <xref linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_AsText\"/>, <xref "
+"linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_GeomFromEWKT\"/>, <xref "
+"linkend=\"ST_Simplify\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:1182
+#, no-c-format
+msgid "ST_Snap"
+msgstr "ST_Snap"
+
+#. Tag: refpurpose
+#: reference_editor.xml:1184
+#, no-c-format
+msgid ""
+"Snap segments and vertices of input geometry to vertices of a reference "
+"geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:1192
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Snap</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>input</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>reference</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>tolerance</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Snap</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>input</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>reference</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>tolerance</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:1204
+#, no-c-format
+msgid ""
+"Snaps the vertices and segments of a geometry another Geometry's vertices. A "
+"snap distance tolerance is used to control where snapping is performed."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1209
+#, no-c-format
+msgid ""
+"Snapping one geometry to another can improve robustness for overlay "
+"operations by eliminating nearly-coincident edges (which cause problems "
+"during noding and intersection calculation)."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1216
+#, no-c-format
+msgid ""
+"Too much snapping can result in invalid topology being created, so the "
+"number and location of snapped vertices is decided using heuristics to "
+"determine when it is safe to snap. This can result in some potential snaps "
+"being omitted, however."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1225
+#, no-c-format
+msgid ""
+"The returned geometry might loose its simplicity (see <xref linkend="
+"\"ST_IsSimple\"/>) and validity (see <xref linkend=\"ST_IsValid\"/>)."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1232
+#, no-c-format
+msgid "Availability: 2.0.0 requires GEOS >= 3.3.0."
+msgstr "Dostępność: 2.0.0 wymaga GEOS >= 3.3.0."
+
+#. Tag: para
+#: reference_editor.xml:1249
+#, no-c-format
+msgid "A multipolygon shown with a linestring (before any snapping)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1260
+#, no-c-format
+msgid ""
+"A multipolygon snapped to linestring to tolerance: 1.01 of distance. The new "
+"multipolygon is shown with reference linestring"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1264
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS "
+"polysnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" ((26 125, 26 200, 126 200, 126 125, 26 125 ),\n"
+" ( 51 150, 101 150, 76 175, 51 150 )), \n"
+" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n"
+" \n"
+" ) As foo;\n"
+"\n"
+" polysnapped\n"
+"---------------------------------------------------------------------\n"
+" MULTIPOLYGON(((26 125,26 200,126 200,126 125,101 100,26 125),\n"
+" (51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))"
+msgstr ""
+"SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS "
+"polysnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" ((26 125, 26 200, 126 200, 126 125, 26 125 ),\n"
+" ( 51 150, 101 150, 76 175, 51 150 )), \n"
+" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n"
+" \n"
+" ) As foo;\n"
+"\n"
+" polysnapped\n"
+"---------------------------------------------------------------------\n"
+" MULTIPOLYGON(((26 125,26 200,126 200,126 125,101 100,26 125),\n"
+" (51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))"
+
+#. Tag: para
+#: reference_editor.xml:1271
+#, no-c-format
+msgid ""
+"A multipolygon snapped to linestring to tolerance: 1.25 of distance. The new "
+"multipolygon is shown with reference linestring"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1275
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_Snap(poly,line, ST_Distance(poly,line)*1.25)\n"
+" ) AS polysnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n"
+" ( 51 150, 101 150, 76 175, 51 150 )),\n"
+" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n"
+" \n"
+" ) As foo;\n"
+"\n"
+" polysnapped\n"
+"---------------------------------------------------------------------\n"
+"MULTIPOLYGON(((5 107,26 200,126 200,126 125,101 100,54 84,5 107),\n"
+"(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))"
+msgstr ""
+"SELECT ST_AsText(\n"
+" ST_Snap(poly,line, ST_Distance(poly,line)*1.25)\n"
+" ) AS polysnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n"
+" ( 51 150, 101 150, 76 175, 51 150 )),\n"
+" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n"
+" \n"
+" ) As foo;\n"
+"\n"
+" polysnapped\n"
+"---------------------------------------------------------------------\n"
+"MULTIPOLYGON(((5 107,26 200,126 200,126 125,101 100,54 84,5 107),\n"
+"(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))"
+
+#. Tag: para
+#: reference_editor.xml:1284
+#, no-c-format
+msgid ""
+"The linestring snapped to the original multipolygon at tolerance 1.01 of "
+"distance. The new linestring is shown with reference multipolygon"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1288
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_Snap(line, poly, ST_Distance(poly,line)*1.01)\n"
+" ) AS linesnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" ((26 125, 26 200, 126 200, 126 125, 26 125),\n"
+" (51 150, 101 150, 76 175, 51 150 )), \n"
+" ((151 100, 151 200, 176 175, 151 100)))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n"
+" ) As foo;\n"
+"\n"
+" linesnapped\n"
+"----------------------------------------\n"
+" LINESTRING(5 107,26 125,54 84,101 100)"
+msgstr ""
+"SELECT ST_AsText(\n"
+" ST_Snap(line, poly, ST_Distance(poly,line)*1.01)\n"
+" ) AS linesnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" ((26 125, 26 200, 126 200, 126 125, 26 125),\n"
+" (51 150, 101 150, 76 175, 51 150 )), \n"
+" ((151 100, 151 200, 176 175, 151 100)))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n"
+" ) As foo;\n"
+"\n"
+" linesnapped\n"
+"----------------------------------------\n"
+" LINESTRING(5 107,26 125,54 84,101 100)"
+
+#. Tag: para
+#: reference_editor.xml:1296
+#, no-c-format
+msgid ""
+"The linestring snapped to the original multipolygon at tolerance 1.25 of "
+"distance. The new linestring is shown with reference multipolygon"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1300
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_Snap(line, poly, ST_Distance(poly,line)*1.25)\n"
+" ) AS linesnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n"
+" (51 150, 101 150, 76 175, 51 150 )), \n"
+" ((151 100, 151 200, 176 175, 151 100 )))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As "
+"line \n"
+" ) As foo;\n"
+" linesnapped\n"
+"---------------------------------------\n"
+"LINESTRING(26 125,54 84,101 100)"
+msgstr ""
+"SELECT ST_AsText(\n"
+" ST_Snap(line, poly, ST_Distance(poly,line)*1.25)\n"
+" ) AS linesnapped\n"
+"FROM (SELECT \n"
+" ST_GeomFromText('MULTIPOLYGON(\n"
+" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n"
+" (51 150, 101 150, 76 175, 51 150 )), \n"
+" ((151 100, 151 200, 176 175, 151 100 )))') As poly,\n"
+" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As "
+"line \n"
+" ) As foo;\n"
+" linesnapped\n"
+"---------------------------------------\n"
+"LINESTRING(26 125,54 84,101 100)"
+
+#. Tag: refname
+#: reference_editor.xml:1321
+#, no-c-format
+msgid "ST_Transform"
+msgstr "ST_Transform"
+
+#. Tag: refpurpose
+#: reference_editor.xml:1323
+#, no-c-format
+msgid ""
+"Returns a new geometry with its coordinates transformed to the SRID "
+"referenced by the integer parameter."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:1329
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Transform</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Transform</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:1340
+#, no-c-format
+msgid ""
+"Returns a new geometry with its coordinates transformed to spatial reference "
+"system referenced by the SRID integer parameter. The destination SRID must "
+"exist in the <varname>SPATIAL_REF_SYS</varname> table."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1343
+#, no-c-format
+msgid ""
+"ST_Transform is often confused with ST_SetSRID(). ST_Transform actually "
+"changes the coordinates of a geometry from one spatial reference system to "
+"another, while ST_SetSRID() simply changes the SRID identifier of the "
+"geometry"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1348
+#, no-c-format
+msgid ""
+"Requires PostGIS be compiled with Proj support. Use <xref linkend="
+"\"PostGIS_Full_Version\"/> to confirm you have proj support compiled in."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1352
+#, no-c-format
+msgid ""
+"If using more than one transformation, it is useful to have a functional "
+"index on the commonly used transformations to take advantage of index usage."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1359
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.6"
+msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.6"
+
+#. Tag: para
+#: reference_editor.xml:1367
+#, no-c-format
+msgid "Change Mass state plane US feet geometry to WGS 84 long lat"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1368
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Transform(ST_GeomFromText('POLYGON((743238 "
+"2967416,743238 2967450,\n"
+" 743265 2967450,743265.625 2967416,743238 2967416))',2249),4326)) As "
+"wgs_geom;\n"
+"\n"
+" wgs_geom\n"
+"---------------------------\n"
+" POLYGON((-71.1776848522251 42.3902896512902,-71.1776843766326 "
+"42.3903829478009,\n"
+"-71.1775844305465 42.3903826677917,-71.1775825927231 "
+"42.3902893647987,-71.177684\n"
+"8522251 42.3902896512902));\n"
+"(1 row)\n"
+"\n"
+"--3D Circular String example\n"
+"SELECT ST_AsEWKT(ST_Transform(ST_GeomFromEWKT('SRID=2249;"
+"CIRCULARSTRING(743238 2967416 1,743238 2967450 2,743265 2967450 3,743265.625 "
+"2967416 3,743238 2967416 4)'),4326));\n"
+"\n"
+" st_asewkt\n"
+"--------------------------------------------------------------------------------------\n"
+" SRID=4326;CIRCULARSTRING(-71.1776848522251 42.3902896512902 "
+"1,-71.1776843766326 42.3903829478009 2,\n"
+" -71.1775844305465 42.3903826677917 3,\n"
+" -71.1775825927231 42.3902893647987 3,-71.1776848522251 42.3902896512902 4)"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1369
+#, no-c-format
+msgid ""
+"Example of creating a partial functional index. For tables where you are not "
+"sure all the geometries will be filled in, its best to use a partial index "
+"that leaves out null geometries which will both conserve space and make your "
+"index smaller and more efficient."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1371
+#, no-c-format
+msgid ""
+"CREATE INDEX idx_the_geom_26986_parcels\n"
+" ON parcels\n"
+" USING gist\n"
+" (ST_Transform(the_geom, 26986))\n"
+" WHERE the_geom IS NOT NULL;"
+msgstr ""
+"CREATE INDEX idx_the_geom_26986_parcels\n"
+" ON parcels\n"
+" USING gist\n"
+" (ST_Transform(the_geom, 26986))\n"
+" WHERE the_geom IS NOT NULL;"
+
+#. Tag: title
+#: reference_editor.xml:1375
+#, no-c-format
+msgid "Configuring transformation behaviour"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1376
+#, no-c-format
+msgid ""
+"Sometimes coordinate transformation involving a grid-shift can fail, for "
+"example if PROJ.4 has not been built with grid-shift files or the coordinate "
+"does not lie within the range for which the grid shift is defined. By "
+"default, PostGIS will throw an error if a grid shift file is not present, "
+"but this behaviour can be configured on a per-SRID basis by altering the "
+"proj4text value within the spatial_ref_sys table."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1377
+#, no-c-format
+msgid ""
+"For example, the proj4text parameter +datum=NAD87 is a shorthand form for "
+"the following +nadgrids parameter:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1378
+#, no-c-format
+msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat"
+msgstr "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat"
+
+#. Tag: para
+#: reference_editor.xml:1379
+#, no-c-format
+msgid ""
+"The @ prefix means no error is reported if the files are not present, but if "
+"the end of the list is reached with no file having been appropriate (ie. "
+"found and overlapping) then an error is issued."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1380
+#, no-c-format
+msgid ""
+"If, conversely, you wanted to ensure that at least the standard files were "
+"present, but that if all files were scanned without a hit a null "
+"transformation is applied you could use:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1381
+#, no-c-format
+msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null"
+msgstr "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null"
+
+#. Tag: para
+#: reference_editor.xml:1382
+#, no-c-format
+msgid ""
+"The null grid shift file is a valid grid shift file covering the whole world "
+"and applying no shift. So for a complete example, if you wanted to alter "
+"PostGIS so that transformations to SRID 4267 that didn't lie within the "
+"correct range did not throw an ERROR, you would use the following:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1383
+#, no-c-format
+msgid ""
+"UPDATE spatial_ref_sys SET proj4text = '+proj=longlat +ellps=clrk66 "
+"+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null +no_defs' WHERE srid "
+"= 4267;"
+msgstr ""
+"UPDATE spatial_ref_sys SET proj4text = '+proj=longlat +ellps=clrk66 "
+"+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null +no_defs' WHERE srid "
+"= 4267;"
+
+#. Tag: para
+#: reference_editor.xml:1390
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"UpdateGeometrySRID\"/>"
+msgstr ""
+", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"UpdateGeometrySRID\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:1396
+#, no-c-format
+msgid "ST_Translate"
+msgstr "ST_Translate"
+
+#. Tag: refpurpose
+#: reference_editor.xml:1398
+#, no-c-format
+msgid ""
+"Translates the geometry to a new location using the numeric parameters as "
+"offsets. Ie: ST_Translate(geom, X, Y) or ST_Translate(geom, X, Y,Z)."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_editor.xml:1403
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Translate</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>g1</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>deltax</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>deltay</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Translate</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>g1</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>deltax</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>deltay</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>deltaz</parameter></paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>geometry <function>ST_Translate</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>g1</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>deltax</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>deltay</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Translate</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>g1</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>deltax</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>deltay</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>deltaz</parameter></paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_editor.xml:1423
+#, no-c-format
+msgid ""
+"Returns a new geometry whose coordinates are translated delta x,delta y,"
+"delta z units. Units are based on the units defined in spatial reference "
+"(SRID) for this geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1435
+#, no-c-format
+msgid "Move a point 1 degree longitude"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1436
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Translate(ST_GeomFromText('POINT(-71.01 "
+"42.37)',4326),1,0)) As wgs_transgeomtxt;\n"
+"\n"
+" wgs_transgeomtxt\n"
+" ---------------------\n"
+" POINT(-70.01 42.37)"
+msgstr ""
+"SELECT ST_AsText(ST_Translate(ST_GeomFromText('POINT(-71.01 "
+"42.37)',4326),1,0)) As wgs_transgeomtxt;\n"
+"\n"
+" wgs_transgeomtxt\n"
+" ---------------------\n"
+" POINT(-70.01 42.37)"
+
+#. Tag: para
+#: reference_editor.xml:1437
+#, no-c-format
+msgid "Move a linestring 1 degree longitude and 1/2 degree latitude"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1438
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Translate(ST_GeomFromText('LINESTRING(-71.01 "
+"42.37,-71.11 42.38)',4326),1,0.5)) As wgs_transgeomtxt;\n"
+" wgs_transgeomtxt\n"
+" ---------------------------------------\n"
+" LINESTRING(-70.01 42.87,-70.11 42.88)"
+msgstr ""
+"SELECT ST_AsText(ST_Translate(ST_GeomFromText('LINESTRING(-71.01 "
+"42.37,-71.11 42.38)',4326),1,0.5)) As wgs_transgeomtxt;\n"
+" wgs_transgeomtxt\n"
+" ---------------------------------------\n"
+" LINESTRING(-70.01 42.87,-70.11 42.88)"
+
+#. Tag: para
+#: reference_editor.xml:1439
+#, no-c-format
+msgid "Move a 3d point"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1440
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_Translate(CAST('POINT(0 0 0)' As geometry), 5, 12,3));\n"
+" st_asewkt\n"
+" ---------\n"
+" POINT(5 12 3)"
+msgstr ""
+"SELECT ST_AsEWKT(ST_Translate(CAST('POINT(0 0 0)' As geometry), 5, 12,3));\n"
+" st_asewkt\n"
+" ---------\n"
+" POINT(5 12 3)"
+
+#. Tag: para
+#: reference_editor.xml:1441
+#, no-c-format
+msgid "Move a curve and a point"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1442
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Translate(ST_Collect('CURVEPOLYGON(CIRCULARSTRING(4 "
+"3,3.12 0.878,1 0,-1.121 5.1213,6 7, 8 9,4 3))','POINT(1 3)'),1,2));\n"
+" st_astext\n"
+"------------------------------------------------------------------------------------------------------------\n"
+" GEOMETRYCOLLECTION(CURVEPOLYGON(CIRCULARSTRING(5 5,4.12 2.878,2 2,-0.121 "
+"7.1213,7 9,9 11,5 5)),POINT(2 5))"
+msgstr ""
+"SELECT ST_AsText(ST_Translate(ST_Collect('CURVEPOLYGON(CIRCULARSTRING(4 "
+"3,3.12 0.878,1 0,-1.121 5.1213,6 7, 8 9,4 3))','POINT(1 3)'),1,2));\n"
+" st_astext\n"
+"------------------------------------------------------------------------------------------------------------\n"
+" GEOMETRYCOLLECTION(CURVEPOLYGON(CIRCULARSTRING(5 5,4.12 2.878,2 2,-0.121 "
+"7.1213,7 9,9 11,5 5)),POINT(2 5))"
+
+#. Tag: para
+#: reference_editor.xml:1448
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_GeomFromText\"/>"
+msgstr ", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"ST_GeomFromText\"/>"
+
+#. Tag: refname
+#: reference_editor.xml:1454
+#, no-c-format
+msgid "ST_TransScale"
+msgstr "ST_TransScale"
+
+#. Tag: refpurpose
+#: reference_editor.xml:1456
+#, no-c-format
+msgid ""
+"<refpurpose>Translates the geometry using the deltaX and deltaY args, then "
+"scales it using the XFactor, YFactor args, working in 2D only.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_editor.xml:1463
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_TransScale</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>deltaX</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>deltaY</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>XFactor</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>YFactor</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_TransScale</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>deltaX</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>deltaY</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>XFactor</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>YFactor</parameter></paramdef>"
+
+#. Tag: para
+#: reference_editor.xml:1477
+#, no-c-format
+msgid ""
+"<para>Translates the geometry using the deltaX and deltaY args, then scales "
+"it using the XFactor, YFactor args, working in 2D only.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1480
+#, no-c-format
+msgid ""
+"<code>ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor)</code> is short-"
+"hand for <code>ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, "
+"deltaX*XFactor, deltaY*YFactor, 0)</code>."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_editor.xml:1496
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_TransScale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), "
+"0.5, 1, 1, 2));\n"
+" st_asewkt\n"
+"-----------------------------\n"
+" LINESTRING(1.5 6 3,1.5 4 1)\n"
+"\n"
+"\n"
+"--Buffer a point to get an approximation of a circle, convert to curve and "
+"then translate 1,2 and scale it 3,4\n"
+" SELECT ST_AsText(ST_Transscale(ST_LineToCurve(ST_Buffer('POINT(234 567)', "
+"3)),1,2,3,4));\n"
+" st_astext\n"
+"------------------------------------------------------------------------------------------------------------------------------\n"
+" CURVEPOLYGON(CIRCULARSTRING(714 2276,711.363961030679 2267.51471862576,705 "
+"2264,698.636038969321 2284.48528137424,714 2276))"
+msgstr ""
+
+#. Tag: para
+#: reference_editor.xml:1503
+#, no-c-format
+msgid ", <xref linkend=\"ST_Translate\"/>"
+msgstr ", <xref linkend=\"ST_Translate\"/>"
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# Jakub Bobrowski <jb@5dstudio.pl>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2014-01-03 08:07+0000\n"
+"Last-Translator: Jakub Bobrowski <jb@5dstudio.pl>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_exception.xml:3
+#, no-c-format
+msgid "Exceptional Functions"
+msgstr ""
+
+#. Tag: para
+#: reference_exception.xml:4
+#, no-c-format
+msgid ""
+"These functions are rarely used functions that should only be used if your "
+"data is corrupted in someway. They are used for troubleshooting corruption "
+"and also fixing things that should under normal circumstances, never happen."
+msgstr ""
+
+#. Tag: refname
+#: reference_exception.xml:9
+#, no-c-format
+msgid "PostGIS_AddBBox"
+msgstr "PostGIS_AddBBox"
+
+#. Tag: refpurpose
+#: reference_exception.xml:11
+#, no-c-format
+msgid "Add bounding box to the geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_exception.xml:16
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>PostGIS_AddBBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>PostGIS_AddBBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: title
+#: reference_exception.xml:24 reference_exception.xml:70
+#: reference_exception.xml:119
+#, no-c-format
+msgid "Description"
+msgstr "Opis"
+
+#. Tag: para
+#: reference_exception.xml:26
+#, no-c-format
+msgid ""
+"Add bounding box to the geometry. This would make bounding box based queries "
+"faster, but will increase the size of the geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_exception.xml:31
+#, no-c-format
+msgid ""
+"Bounding boxes are automatically added to geometries so in general this is "
+"not needed unless the generated bounding box somehow becomes corrupted or "
+"you have an old install that is lacking bounding boxes. Then you need to "
+"drop the old and readd."
+msgstr ""
+
+#. Tag: para
+#: reference_exception.xml:35 reference_exception.xml:83
+#: reference_exception.xml:124
+#, no-c-format
+msgid "&curve_support;"
+msgstr "&curve_support;"
+
+#. Tag: title
+#: reference_exception.xml:40 reference_exception.xml:88
+#: reference_exception.xml:129
+#, no-c-format
+msgid "Examples"
+msgstr "Przykłady"
+
+#. Tag: programlisting
+#: reference_exception.xml:42
+#, no-c-format
+msgid ""
+"UPDATE sometable\n"
+" SET the_geom = PostGIS_AddBBox(the_geom)\n"
+" WHERE PostGIS_HasBBox(the_geom) = false;"
+msgstr ""
+"UPDATE sometable\n"
+" SET the_geom = PostGIS_AddBBox(the_geom)\n"
+" WHERE PostGIS_HasBBox(the_geom) = false;"
+
+#. Tag: title
+#: reference_exception.xml:47 reference_exception.xml:95
+#: reference_exception.xml:136
+#, no-c-format
+msgid "See Also"
+msgstr "Zobacz także"
+
+#. Tag: para
+#: reference_exception.xml:49
+#, no-c-format
+msgid ", <xref linkend=\"PostGIS_HasBBox\"/>"
+msgstr ", <xref linkend=\"PostGIS_HasBBox\"/>"
+
+#. Tag: refname
+#: reference_exception.xml:55
+#, no-c-format
+msgid "PostGIS_DropBBox"
+msgstr "PostGIS_DropBBox"
+
+#. Tag: refpurpose
+#: reference_exception.xml:57
+#, no-c-format
+msgid "Drop the bounding box cache from the geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_exception.xml:62
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>PostGIS_DropBBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>PostGIS_DropBBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_exception.xml:72
+#, no-c-format
+msgid ""
+"Drop the bounding box cache from the geometry. This reduces geometry size, "
+"but makes bounding-box based queries slower. It is also used to drop a "
+"corrupt bounding box. A tale-tell sign of a corrupt cached bounding box is "
+"when your ST_Intersects and other relation queries leave out geometries that "
+"rightfully should return true."
+msgstr ""
+
+#. Tag: para
+#: reference_exception.xml:77
+#, no-c-format
+msgid ""
+"Bounding boxes are automatically added to geometries and improve speed of "
+"queries so in general this is not needed unless the generated bounding box "
+"somehow becomes corrupted or you have an old install that is lacking "
+"bounding boxes. Then you need to drop the old and readd. This kind of "
+"corruption has been observed in 8.3-8.3.6 series whereby cached bboxes were "
+"not always recalculated when a geometry changed and upgrading to a newer "
+"version without a dump reload will not correct already corrupted boxes. So "
+"one can manually correct using below and readd the bbox or do a dump reload."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_exception.xml:90
+#, no-c-format
+msgid ""
+"--This example drops bounding boxes where the cached box is not correct\n"
+" --The force to ST_AsBinary before applying Box2D "
+"forces a recalculation of the box, and Box2D applied to the table geometry "
+"always\n"
+" -- returns the cached bounding box.\n"
+" UPDATE sometable\n"
+" SET the_geom = PostGIS_DropBBox(the_geom)\n"
+" WHERE Not (Box2D(ST_AsBinary(the_geom)) = Box2D(the_geom));\n"
+"\n"
+" UPDATE sometable\n"
+" SET the_geom = PostGIS_AddBBox(the_geom)\n"
+" WHERE Not PostGIS_HasBBOX(the_geom);"
+msgstr ""
+
+#. Tag: para
+#: reference_exception.xml:97
+#, no-c-format
+msgid ", <xref linkend=\"PostGIS_HasBBox\"/>, <xref linkend=\"Box2D\"/>"
+msgstr ", <xref linkend=\"PostGIS_HasBBox\"/>, <xref linkend=\"Box2D\"/>"
+
+#. Tag: refname
+#: reference_exception.xml:104
+#, no-c-format
+msgid "PostGIS_HasBBox"
+msgstr "PostGIS_HasBBox"
+
+#. Tag: refpurpose
+#: reference_exception.xml:106
+#, no-c-format
+msgid "Returns TRUE if the bbox of this geometry is cached, FALSE otherwise."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_exception.xml:111
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>PostGIS_HasBBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+"<funcdef>boolean <function>PostGIS_HasBBox</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+
+#. Tag: para
+#: reference_exception.xml:121
+#, no-c-format
+msgid ""
+"Returns TRUE if the bbox of this geometry is cached, FALSE otherwise. Use "
+"<xref linkend=\"PostGIS_AddBBox\"/> and <xref linkend=\"PostGIS_DropBBox\"/> "
+"to control caching."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_exception.xml:131
+#, no-c-format
+msgid ""
+"SELECT the_geom\n"
+"FROM sometable WHERE PostGIS_HasBBox(the_geom) = false;"
+msgstr ""
+"SELECT the_geom\n"
+"FROM sometable WHERE PostGIS_HasBBox(the_geom) = false;"
+
+#. Tag: para
+#: reference_exception.xml:138
+#, no-c-format
+msgid ", <xref linkend=\"PostGIS_DropBBox\"/>"
+msgstr ", <xref linkend=\"PostGIS_DropBBox\"/>"
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2014-10-10 23:07+0000\n"
+"PO-Revision-Date: 2014-10-13 17:58+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: para
+#: reference_guc.xml:5
+#, no-c-format
+msgid ""
+"This section lists custom PostGIS Grand Unified Custom Variables(GUC). These "
+"can be set globally, by database, by session or by transaction. Best set at "
+"global or database level."
+msgstr ""
+
+#. Tag: title
+#: reference_guc.xml:8
+#, no-c-format
+msgid "PostGIS Grand Unified Custom Variables (GUCs)"
+msgstr ""
+
+#. Tag: refname
+#: reference_guc.xml:12
+#, no-c-format
+msgid "postgis.backend"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_guc.xml:13
+#, no-c-format
+msgid ""
+"The backend to service a function where GEOS and SFCGAL overlap. Options: "
+"geos or sfcgal. Defaults to geos."
+msgstr ""
+
+#. Tag: title
+#: reference_guc.xml:17 reference_guc.xml:45 reference_guc.xml:99
+#: reference_guc.xml:191
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:18
+#, no-c-format
+msgid ""
+"This GUC is only relevant if you compiled PostGIS with sfcgal support. By "
+"default <varname>geos</varname> backend is used for functions where both "
+"GEOS and SFCGAL have the same named function. This variable allows you to "
+"override and make sfcgal the backend to service the request."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:19
+#, no-c-format
+msgid "Availability: 2.1.0"
+msgstr ""
+
+#. Tag: title
+#: reference_guc.xml:23 reference_guc.xml:69 reference_guc.xml:150
+#: reference_guc.xml:217
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:24
+#, no-c-format
+msgid "Sets backend just for life of connection"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:25
+#, no-c-format
+msgid "set postgis.backend = sfcgal;"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:27
+#, no-c-format
+msgid "Sets backend for new connections to database"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:28
+#, no-c-format
+msgid "ALTER DATABASE mygisdb SET postgis.backend = sfcgal;"
+msgstr ""
+
+#. Tag: title
+#: reference_guc.xml:31 reference_guc.xml:83 reference_guc.xml:170
+#: reference_guc.xml:229
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: reference_guc.xml:38
+#, no-c-format
+msgid "postgis.gdal_datapath"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_guc.xml:39
+#, no-c-format
+msgid ""
+"A configuration option to assign the value of GDAL's GDAL_DATA option. If "
+"not set, the environmentally set GDAL_DATA variable is used."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:46
+#, no-c-format
+msgid ""
+"A PostgreSQL GUC variable for setting the value of GDAL's GDAL_DATA option. "
+"The <varname>postgis.gdal_datapath</varname> value should be the complete "
+"physical path to GDAL's data files."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:49
+#, no-c-format
+msgid ""
+"This configuration option is of most use for Windows platforms where GDAL's "
+"data files path is not hard-coded. This option should also be set when "
+"GDAL's data files are not located in GDAL's expected path."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:54
+#, no-c-format
+msgid ""
+"This option can be set in PostgreSQL's configuration file postgresql.conf. "
+"It can also be set by connection or transaction."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:58 reference_guc.xml:145 reference_guc.xml:212
+#, no-c-format
+msgid "Availability: 2.2.0"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:61
+#, no-c-format
+msgid ""
+"Additional information about GDAL_DATA is available at GDAL's <ulink url="
+"\"http://trac.osgeo.org/gdal/wiki/ConfigOptions\">Configuration Options</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:70
+#, no-c-format
+msgid "Set and reset <varname>postgis.gdal_datapath</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:72
+#, no-c-format
+msgid ""
+"SET postgis.gdal_datapath TO '/usr/local/share/gdal.hidden';\n"
+"SET postgis.gdal_datapath TO default;"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:77
+#, no-c-format
+msgid "Setting on windows for a particular database"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:78
+#, no-c-format
+msgid ""
+"ALTER DATABASE gisdb\n"
+"SET postgis.gdal_datapath = 'C:/Program Files/PostgreSQL/9.3/gdal-data';"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:84
+#, no-c-format
+msgid "<para>,</para>"
+msgstr ""
+
+#. Tag: refname
+#: reference_guc.xml:92
+#, no-c-format
+msgid "postgis.gdal_enabled_drivers"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_guc.xml:93
+#, no-c-format
+msgid ""
+"A configuration option to set the enabled GDAL drivers in the PostGIS "
+"environment. Affects the GDAL configuration variable GDAL_SKIP."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:100
+#, no-c-format
+msgid ""
+"A configuration option to set the enabled GDAL drivers in the PostGIS "
+"environment. Affects the GDAL configuration variable GDAL_SKIP. This option "
+"can be set in PostgreSQL's configuration file: postgresql.conf. It can also "
+"be set by connection or transaction."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:104
+#, no-c-format
+msgid ""
+"The initial value of <varname>postgis.gdal_enabled_drivers</varname> may "
+"also be set by passing the environment variable "
+"<varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> with the list of enabled "
+"drivers to the process starting PostgreSQL."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:108
+#, no-c-format
+msgid ""
+"Enabled GDAL specified drivers can be specified by the driver's short-name "
+"or code. Driver short-names or codes can be found at <ulink url=\"http://www."
+"gdal.org/formats_list.html\">GDAL Raster Formats</ulink>. Multiple drivers "
+"can be specified by putting a space between each driver."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:113
+#, no-c-format
+msgid ""
+"There are three special codes available for <varname>postgis."
+"gdal_enabled_drivers</varname>. The codes are case-sensitive."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:118
+#, no-c-format
+msgid ""
+"<varname>DISABLE_ALL</varname> disables all GDAL drivers. If present, "
+"<varname>DISABLE_ALL</varname> overrides all other values in "
+"<varname>postgis.gdal_enabled_drivers</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:121
+#, no-c-format
+msgid "<varname>ENABLE_ALL</varname> enables all GDAL drivers."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:124
+#, no-c-format
+msgid ""
+"<varname>VSICURL</varname> enables GDAL's <varname>/vsicurl/</varname> "
+"virtual file system."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:128
+#, no-c-format
+msgid ""
+"When <varname>postgis.gdal_enabled_drivers</varname> is set to DISABLE_ALL, "
+"attempts to use out-db rasters, ST_FromGDALRaster(), ST_AsGDALRaster(), "
+"ST_AsTIFF(), ST_AsJPEG() and ST_AsPNG() will result in error messages."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:134
+#, no-c-format
+msgid ""
+"In the standard PostGIS installation, <varname>postgis.gdal_enabled_drivers</"
+"varname> is set to DISABLE_ALL."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:140
+#, no-c-format
+msgid ""
+"Additional information about GDAL_SKIP is available at GDAL's <ulink url="
+"\"http://trac.osgeo.org/gdal/wiki/ConfigOptions\">Configuration Options</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:151
+#, no-c-format
+msgid "Set and reset <varname>postgis.gdal_enabled_drivers</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:153
+#, no-c-format
+msgid ""
+"SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';\n"
+"SET postgis.gdal_enabled_drivers = default;"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:158
+#, no-c-format
+msgid "Enable all GDAL Drivers"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:159
+#, no-c-format
+msgid "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:163
+#, no-c-format
+msgid "Disable all GDAL Drivers"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:164
+#, no-c-format
+msgid "SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';"
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:171
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_AsGDALRaster\"/>, <xref linkend=\"RT_ST_AsTIFF\"/>, "
+"<xref linkend=\"RT_ST_AsPNG\"/>, <xref linkend=\"RT_ST_AsJPEG\"/>,"
+msgstr ""
+
+#. Tag: refname
+#: reference_guc.xml:184
+#, no-c-format
+msgid "postgis.enable_outdb_rasters"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_guc.xml:185
+#, no-c-format
+msgid "A boolean configuration option to enable access to out-db raster bands."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:192
+#, no-c-format
+msgid ""
+"A boolean configuration option to enable access to out-db raster bands. This "
+"option can be set in PostgreSQL's configuration file: postgresql.conf. It "
+"can also be set by connection or transaction."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:196
+#, no-c-format
+msgid ""
+"The initial value of <varname>postgis.enable_outdb_rasters</varname> may "
+"also be set by passing the environment variable "
+"<varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> with a non-zero value to the "
+"process starting PostgreSQL."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:201
+#, no-c-format
+msgid ""
+"Even if <varname>postgis.enable_outdb_rasters</varname> is True, the GUC "
+"<varname>postgis.enable_outdb_rasters</varname> determines the accessible "
+"raster formats."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:207
+#, no-c-format
+msgid ""
+"In the standard PostGIS installation, <varname>postgis.enable_outdb_rasters</"
+"varname> is set to False."
+msgstr ""
+
+#. Tag: para
+#: reference_guc.xml:218
+#, no-c-format
+msgid "Set and reset <varname>postgis.enable_outdb_rasters</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_guc.xml:220
+#, no-c-format
+msgid ""
+"SET postgis.enable_outdb_rasters TO True;\n"
+"SET postgis.enable_outdb_rasters = default;\n"
+"SET postgis.enable_outdb_rasters = True;\n"
+"SET postgis.enable_outdb_rasters = False;"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# Jakub Bobrowski <jb@5dstudio.pl>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2014-01-03 08:17+0000\n"
+"Last-Translator: Jakub Bobrowski <jb@5dstudio.pl>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_lrs.xml:3
+#, no-c-format
+msgid "Linear Referencing"
+msgstr ""
+
+#. Tag: refname
+#: reference_lrs.xml:7
+#, no-c-format
+msgid "ST_Line_Interpolate_Point"
+msgstr "ST_Line_Interpolate_Point"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:9
+#, no-c-format
+msgid ""
+"Returns a point interpolated along a line. Second argument is a float8 "
+"between 0 and 1 representing fraction of total length of linestring the "
+"point has to be located."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:15
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Line_Interpolate_Point</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>a_fraction</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Line_Interpolate_Point</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>a_fraction</parameter></"
+"paramdef>"
+
+#. Tag: title
+#: reference_lrs.xml:24 reference_lrs.xml:85 reference_lrs.xml:136
+#: reference_lrs.xml:202 reference_lrs.xml:260 reference_lrs.xml:311
+#: reference_lrs.xml:356 reference_lrs.xml:400
+#, no-c-format
+msgid "Description"
+msgstr "Opis"
+
+#. Tag: para
+#: reference_lrs.xml:26
+#, no-c-format
+msgid ""
+"Returns a point interpolated along a line. First argument must be a "
+"LINESTRING. Second argument is a float8 between 0 and 1 representing "
+"fraction of total linestring length the point has to be located."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:30 reference_lrs.xml:147
+#, no-c-format
+msgid ""
+"See <xref linkend=\"ST_Line_Locate_Point\"/> for computing the line location "
+"nearest to a Point."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:34
+#, no-c-format
+msgid ""
+"Since release 1.1.1 this function also interpolates M and Z values (when "
+"present), while prior releases set them to 0.0."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:38
+#, no-c-format
+msgid "Availability: 0.8.2, Z and M supported added in 1.1.1"
+msgstr "Dostępność: 0.8.2 - wsparcie dla Z i M dodano w wersji 1.1.1"
+
+#. Tag: para
+#: reference_lrs.xml:39 reference_lrs.xml:157 reference_lrs.xml:319
+#: reference_lrs.xml:362 reference_lrs.xml:406
+#, no-c-format
+msgid "&Z_support;"
+msgstr "&Z_support;"
+
+#. Tag: title
+#: reference_lrs.xml:44 reference_lrs.xml:101 reference_lrs.xml:161
+#: reference_lrs.xml:225 reference_lrs.xml:276 reference_lrs.xml:323
+#: reference_lrs.xml:366 reference_lrs.xml:410
+#, no-c-format
+msgid "Examples"
+msgstr "Przykłady"
+
+#. Tag: para
+#: reference_lrs.xml:50
+#, no-c-format
+msgid "A linestring with the interpolated point at 20% position (0.20)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_lrs.xml:53
+#, no-c-format
+msgid ""
+"--Return point 20% along 2d line\n"
+"SELECT ST_AsEWKT(ST_Line_Interpolate_Point(the_line, 0.20))\n"
+" FROM (SELECT ST_GeomFromEWKT('LINESTRING(25 50, 100 125, 150 190)') "
+"as the_line) As foo;\n"
+" st_asewkt\n"
+"----------------\n"
+" POINT(51.5974135047432 76.5974135047432)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_lrs.xml:54
+#, no-c-format
+msgid ""
+"--Return point mid-way of 3d line\n"
+"SELECT ST_AsEWKT(ST_Line_Interpolate_Point(the_line, 0.5))\n"
+" FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 4 5 6, 6 7 8)') as "
+"the_line) As foo;\n"
+"\n"
+" st_asewkt\n"
+"--------------------\n"
+" POINT(3.5 4.5 5.5)\n"
+"\n"
+"\n"
+"--find closest point on a line to a point or other geometry\n"
+" SELECT ST_AsText(ST_Line_Interpolate_Point(foo.the_line, "
+"ST_Line_Locate_Point(foo.the_line, ST_GeomFromText('POINT(4 3)'))))\n"
+"FROM (SELECT ST_GeomFromText('LINESTRING(1 2, 4 5, 6 7)') As the_line) As "
+"foo;\n"
+" st_astext\n"
+"----------------\n"
+" POINT(3 4)"
+msgstr ""
+
+#. Tag: title
+#: reference_lrs.xml:59 reference_lrs.xml:108 reference_lrs.xml:175
+#: reference_lrs.xml:231 reference_lrs.xml:283 reference_lrs.xml:330
+#: reference_lrs.xml:372
+#, no-c-format
+msgid "See Also"
+msgstr "Zobacz także"
+
+#. Tag: para
+#: reference_lrs.xml:61
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_Length\"/>, <xref "
+"linkend=\"ST_Line_Locate_Point\"/>"
+msgstr ""
+", <xref linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_Length\"/>, <xref "
+"linkend=\"ST_Line_Locate_Point\"/>"
+
+#. Tag: refname
+#: reference_lrs.xml:67
+#, no-c-format
+msgid "ST_Line_Locate_Point"
+msgstr "ST_Line_Locate_Point"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:69
+#, no-c-format
+msgid ""
+"Returns a float between 0 and 1 representing the location of the closest "
+"point on LineString to the given Point, as a fraction of total 2d line "
+"length."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:76
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Line_Locate_Point</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>a_point</parameter></"
+"paramdef>"
+msgstr ""
+"<funcdef>float <function>ST_Line_Locate_Point</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>a_point</parameter></"
+"paramdef>"
+
+#. Tag: para
+#: reference_lrs.xml:87
+#, no-c-format
+msgid ""
+"Returns a float between 0 and 1 representing the location of the closest "
+"point on LineString to the given Point, as a fraction of total <link linkend="
+"\"ST_Length2D\">2d line</link> length."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:91
+#, no-c-format
+msgid ""
+"You can use the returned location to extract a Point (<xref linkend="
+"\"ST_Line_Interpolate_Point\"/>) or a substring (<xref linkend="
+"\"ST_Line_Substring\"/>)."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:94
+#, no-c-format
+msgid "This is useful for approximating numbers of addresses"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:96
+#, no-c-format
+msgid "Availability: 1.1.0"
+msgstr "Dostępność: 1.1.0"
+
+#. Tag: programlisting
+#: reference_lrs.xml:103
+#, no-c-format
+msgid ""
+"--Rough approximation of finding the street number of a point along the "
+"street\n"
+"--Note the whole foo thing is just to generate dummy data that looks\n"
+"--like house centroids and street\n"
+"--We use ST_DWithin to exclude\n"
+"--houses too far away from the street to be considered on the street\n"
+"SELECT ST_AsText(house_loc) As as_text_house_loc,\n"
+" startstreet_num +\n"
+" CAST( (endstreet_num - startstreet_num)\n"
+" * ST_Line_Locate_Point(street_line, house_loc) As "
+"integer) As street_num\n"
+"FROM\n"
+"(SELECT ST_GeomFromText('LINESTRING(1 2, 3 4)') As street_line,\n"
+" ST_MakePoint(x*1.01,y*1.03) As house_loc, 10 As startstreet_num,\n"
+" 20 As endstreet_num\n"
+"FROM generate_series(1,3) x CROSS JOIN generate_series(2,4) As y)\n"
+"As foo\n"
+"WHERE ST_DWithin(street_line, house_loc, 0.2);\n"
+"\n"
+" as_text_house_loc | street_num\n"
+"-------------------+------------\n"
+" POINT(1.01 2.06) | 10\n"
+" POINT(2.02 3.09) | 15\n"
+" POINT(3.03 4.12) | 20\n"
+"\n"
+" --find closest point on a line to a point or other geometry\n"
+" SELECT ST_AsText(ST_Line_Interpolate_Point(foo.the_line, "
+"ST_Line_Locate_Point(foo.the_line, ST_GeomFromText('POINT(4 3)'))))\n"
+"FROM (SELECT ST_GeomFromText('LINESTRING(1 2, 4 5, 6 7)') As the_line) As "
+"foo;\n"
+" st_astext\n"
+"----------------\n"
+" POINT(3 4)"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:110
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Length2D\"/>, <xref linkend=\"ST_Line_Interpolate_Point"
+"\"/>, <xref linkend=\"ST_Line_Substring\"/>"
+msgstr ""
+", <xref linkend=\"ST_Length2D\"/>, <xref linkend=\"ST_Line_Interpolate_Point"
+"\"/>, <xref linkend=\"ST_Line_Substring\"/>"
+
+#. Tag: refname
+#: reference_lrs.xml:116
+#, no-c-format
+msgid "ST_Line_Substring"
+msgstr "ST_Line_Substring"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:118
+#, no-c-format
+msgid ""
+"Return a linestring being a substring of the input one starting and ending "
+"at the given fractions of total 2d length. Second and third arguments are "
+"float8 values between 0 and 1."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:126
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Line_Substring</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>startfraction</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>endfraction</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_Line_Substring</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>startfraction</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>endfraction</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: reference_lrs.xml:138
+#, no-c-format
+msgid ""
+"Return a linestring being a substring of the input one starting and ending "
+"at the given fractions of total 2d length. Second and third arguments are "
+"float8 values between 0 and 1. This only works with LINESTRINGs. To use with "
+"contiguous MULTILINESTRINGs use in conjunction with <xref linkend="
+"\"ST_LineMerge\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:144
+#, no-c-format
+msgid ""
+"If 'start' and 'end' have the same value this is equivalent to <xref linkend="
+"\"ST_Line_Interpolate_Point\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:151
+#, no-c-format
+msgid ""
+"Since release 1.1.1 this function also interpolates M and Z values (when "
+"present), while prior releases set them to unspecified values."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:156
+#, no-c-format
+msgid "Availability: 1.1.0, Z and M supported added in 1.1.1"
+msgstr "Dostępność: 1.1.0 - wsparcie dla Z i M"
+
+#. Tag: para
+#: reference_lrs.xml:167
+#, no-c-format
+msgid "A linestring seen with 1/3 midrange overlaid (0.333, 0.666)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_lrs.xml:170
+#, no-c-format
+msgid ""
+"--Return the approximate 1/3 mid-range part of a linestring\n"
+"SELECT ST_AsText(ST_Line_SubString(ST_GeomFromText('LINESTRING(25 50, 100 "
+"125, 150 190)'), 0.333, 0.666));\n"
+"\n"
+" st_astext\n"
+"------------------------------------------------------------------------------------------------\n"
+"LINESTRING(69.2846934853974 94.2846934853974,100 125,111.700356260683 "
+"140.210463138888)\n"
+"\n"
+"--The below example simulates a while loop in\n"
+"--SQL using PostgreSQL generate_series() to cut all\n"
+"--linestrings in a table to 100 unit segments\n"
+"-- of which no segment is longer than 100 units\n"
+"-- units are measured in the SRID units of measurement\n"
+"-- It also assumes all geometries are LINESTRING or contiguous "
+"MULTILINESTRING\n"
+"--and no geometry is longer than 100 units*10000\n"
+"--for better performance you can reduce the 10000\n"
+"--to match max number of segments you expect\n"
+"\n"
+"SELECT field1, field2, ST_Line_Substring(the_geom, 100.00*n/length,\n"
+" CASE\n"
+" WHEN 100.00*(n+1) < length THEN 100.00*(n+1)/length\n"
+" ELSE 1\n"
+" END) As the_geom\n"
+"FROM\n"
+" (SELECT sometable.field1, sometable.field2,\n"
+" ST_LineMerge(sometable.the_geom) AS the_geom,\n"
+" ST_Length(sometable.the_geom) As length\n"
+" FROM sometable\n"
+" ) AS t\n"
+"CROSS JOIN generate_series(0,10000) AS n\n"
+"WHERE n*100.00/length < 1;"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:177
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Line_Interpolate_Point\"/>, <xref linkend=\"ST_LineMerge"
+"\"/>"
+msgstr ""
+", <xref linkend=\"ST_Line_Interpolate_Point\"/>, <xref linkend=\"ST_LineMerge"
+"\"/>"
+
+#. Tag: refname
+#: reference_lrs.xml:183
+#, no-c-format
+msgid "ST_LocateAlong"
+msgstr "ST_LocateAlong"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:185
+#, no-c-format
+msgid ""
+"<refpurpose>Return a derived geometry collection value with elements that "
+"match the specified measure. Polygonal elements are not supported.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:192
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_LocateAlong</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>ageom_with_measure</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>a_measure</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>float </type> <parameter>offset</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_LocateAlong</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>ageom_with_measure</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>a_measure</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>float </type> <parameter>offset</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: reference_lrs.xml:204
+#, no-c-format
+msgid ""
+"<para>Return a derived geometry collection value with elements that match "
+"the specified measure. Polygonal elements are not supported.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:208
+#, no-c-format
+msgid ""
+"If an offset is provided, the resultant will be offset to the left or right "
+"of the input line by the specified number of units. A positive offset will "
+"be to the left, and a negative one to the right."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:213 reference_lrs.xml:266
+#, no-c-format
+msgid ""
+"Semantic is specified by: ISO/IEC CD 13249-3:200x(E) - Text for Continuation "
+"CD Editing Meeting"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:216
+#, no-c-format
+msgid "Availability: 1.1.0 by old name ST_Locate_Along_Measure."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:217
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 in prior versions this used to be called "
+"ST_Locate_Along_Measure. The old name has been deprecated and will be "
+"removed in the future but is still available."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:218
+#, no-c-format
+msgid "Use this function only for geometries with an M component"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:220 reference_lrs.xml:272
+#, no-c-format
+msgid "&M_support;"
+msgstr "&M_support;"
+
+#. Tag: programlisting
+#: reference_lrs.xml:226
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(the_geom)\n"
+" FROM\n"
+" (SELECT ST_LocateAlong(\n"
+" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 "
+"3),\n"
+" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"-----------------------------------------------------------\n"
+" MULTIPOINT M (1 2 3)\n"
+"\n"
+"--Geometry collections are difficult animals so dump them\n"
+"--to make them more digestable\n"
+"SELECT ST_AsText((ST_Dump(the_geom)).geom)\n"
+" FROM\n"
+" (SELECT ST_LocateAlong(\n"
+" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 "
+"3),\n"
+" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"---------------\n"
+" POINTM(1 2 3)\n"
+" POINTM(9 4 3)\n"
+" POINTM(1 2 3)"
+msgstr ""
+"SELECT ST_AsText(the_geom)\n"
+" FROM\n"
+" (SELECT ST_LocateAlong(\n"
+" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 "
+"3),\n"
+" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"-----------------------------------------------------------\n"
+" MULTIPOINT M (1 2 3)\n"
+"\n"
+"--Geometry collections are difficult animals so dump them\n"
+"--to make them more digestable\n"
+"SELECT ST_AsText((ST_Dump(the_geom)).geom)\n"
+" FROM\n"
+" (SELECT ST_LocateAlong(\n"
+" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 "
+"3),\n"
+" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"---------------\n"
+" POINTM(1 2 3)\n"
+" POINTM(9 4 3)\n"
+" POINTM(1 2 3)"
+
+#. Tag: para
+#: reference_lrs.xml:233
+#, no-c-format
+msgid ", <xref linkend=\"ST_LocateBetween\"/>"
+msgstr ", <xref linkend=\"ST_LocateBetween\"/>"
+
+#. Tag: refname
+#: reference_lrs.xml:239
+#, no-c-format
+msgid "ST_LocateBetween"
+msgstr "ST_LocateBetween"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:241
+#, no-c-format
+msgid ""
+"<refpurpose>Return a derived geometry collection value with elements that "
+"match the specified range of measures inclusively. Polygonal elements are "
+"not supported.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:248
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_LocateBetween</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>measure_start</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>measure_end</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>float </type> <parameter>offset</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_LocateBetween</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>measure_start</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>measure_end</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>float </type> <parameter>offset</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: reference_lrs.xml:262
+#, no-c-format
+msgid ""
+"<para>Return a derived geometry collection value with elements that match "
+"the specified range of measures inclusively. Polygonal elements are not "
+"supported.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:269
+#, no-c-format
+msgid "Availability: 1.1.0 by old name ST_Locate_Between_Measures."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:270
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 - in prior versions this used to be called "
+"ST_Locate_Between_Measures. The old name has been deprecated and will be "
+"removed in the future but is still available for backward compatibility."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_lrs.xml:278
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(the_geom)\n"
+" FROM\n"
+" (SELECT ST_LocateBetween(\n"
+" ST_GeomFromText('MULTILINESTRING M ((1 2 3, 3 4 2, 9 "
+"4 3),\n"
+" (1 2 3, 5 4 5))'),1.5, 3) As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"------------------------------------------------------------------------\n"
+" GEOMETRYCOLLECTION M (LINESTRING M (1 2 3,3 4 2,9 4 3),POINT M (1 2 3))\n"
+"\n"
+"--Geometry collections are difficult animals so dump them\n"
+"--to make them more digestable\n"
+"SELECT ST_AsText((ST_Dump(the_geom)).geom)\n"
+" FROM\n"
+" (SELECT ST_LocateBetween(\n"
+" ST_GeomFromText('MULTILINESTRING M ((1 2 3, 3 4 2, 9 "
+"4 3),\n"
+" (1 2 3, 5 4 5))'),1.5, 3) As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"--------------------------------\n"
+" LINESTRING M (1 2 3,3 4 2,9 4 3)\n"
+" POINT M (1 2 3)"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:285
+#, no-c-format
+msgid ", <xref linkend=\"ST_LocateAlong\"/>"
+msgstr ", <xref linkend=\"ST_LocateAlong\"/>"
+
+#. Tag: refname
+#: reference_lrs.xml:291
+#, no-c-format
+msgid "ST_LocateBetweenElevations"
+msgstr "ST_LocateBetweenElevations"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:293
+#, no-c-format
+msgid ""
+"Return a derived geometry (collection) value with elements that intersect "
+"the specified range of elevations inclusively. Only 3D, 4D LINESTRINGS and "
+"MULTILINESTRINGS are supported."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:300
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_LocateBetweenElevations</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom_mline</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>elevation_start</"
+"parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>elevation_end</parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_LocateBetweenElevations</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom_mline</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>elevation_start</"
+"parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>elevation_end</parameter></paramdef>"
+
+#. Tag: para
+#: reference_lrs.xml:313
+#, no-c-format
+msgid ""
+"Return a derived geometry (collection) value with elements that intersect "
+"the specified range of elevations inclusively. Only 3D, 3DM LINESTRINGS and "
+"MULTILINESTRINGS are supported."
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:317
+#, no-c-format
+msgid "Availability: 1.4.0"
+msgstr "Dostępność: 1.4.0"
+
+#. Tag: programlisting
+#: reference_lrs.xml:325
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_LocateBetweenElevations(\n"
+" ST_GeomFromEWKT('LINESTRING(1 2 3, 4 5 6)'),2,4)) As "
+"ewelev;\n"
+" ewelev\n"
+"----------------------------------------------------------------\n"
+" MULTILINESTRING((1 2 3,2 3 4))\n"
+"\n"
+"SELECT ST_AsEWKT(ST_LocateBetweenElevations(\n"
+" ST_GeomFromEWKT('LINESTRING(1 2 6, 4 5 -1, 7 8 "
+"9)'),6,9)) As ewelev;\n"
+"\n"
+" ewelev\n"
+"----------------------------------------------------------------\n"
+"GEOMETRYCOLLECTION(POINT(1 2 6),LINESTRING(6.1 7.1 6,7 8 9))\n"
+"\n"
+"--Geometry collections are difficult animals so dump them\n"
+"--to make them more digestable\n"
+"SELECT ST_AsEWKT((ST_Dump(the_geom)).geom)\n"
+" FROM\n"
+" (SELECT ST_LocateBetweenElevations(\n"
+" ST_GeomFromEWKT('LINESTRING(1 2 6, 4 5 -1, 7 8 "
+"9)'),6,9) As the_geom) As foo;\n"
+"\n"
+" st_asewkt\n"
+"--------------------------------\n"
+"POINT(1 2 6)\n"
+"LINESTRING(6.1 7.1 6,7 8 9)"
+msgstr ""
+
+#. Tag: refname
+#: reference_lrs.xml:339
+#, no-c-format
+msgid "ST_InterpolatePoint"
+msgstr "ST_InterpolatePoint"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:341
+#, no-c-format
+msgid ""
+"<refpurpose>Return the value of the measure dimension of a geometry at the "
+"point closed to the provided point.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:346
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_InterpolatePoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>line</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>point</parameter></paramdef>"
+msgstr ""
+"<funcdef>float <function>ST_InterpolatePoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>line</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>point</parameter></paramdef>"
+
+#. Tag: para
+#: reference_lrs.xml:358
+#, no-c-format
+msgid ""
+"<para>Return the value of the measure dimension of a geometry at the point "
+"closed to the provided point.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:360
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr "Dostępność: 2.0.0"
+
+#. Tag: programlisting
+#: reference_lrs.xml:368
+#, no-c-format
+msgid ""
+"SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');\n"
+" st_interpolatepoint \n"
+" ---------------------\n"
+" 10"
+msgstr ""
+"SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');\n"
+" st_interpolatepoint \n"
+" ---------------------\n"
+" 10"
+
+#. Tag: para
+#: reference_lrs.xml:374
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_LocateAlong\"/>, <xref linkend=\"ST_LocateBetween\"/>"
+msgstr ""
+", <xref linkend=\"ST_LocateAlong\"/>, <xref linkend=\"ST_LocateBetween\"/>"
+
+#. Tag: refname
+#: reference_lrs.xml:382
+#, no-c-format
+msgid "ST_AddMeasure"
+msgstr "ST_AddMeasure"
+
+#. Tag: refpurpose
+#: reference_lrs.xml:384
+#, no-c-format
+msgid ""
+"<refpurpose>Return a derived geometry with measure elements linearly "
+"interpolated between the start and end points. If the geometry has no "
+"measure dimension, one is added. If the geometry has a measure dimension, it "
+"is over-written with new values. Only LINESTRINGS and MULTILINESTRINGS are "
+"supported.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_lrs.xml:389
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_AddMeasure</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom_mline</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>measure_start</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>measure_end</"
+"parameter></paramdef>"
+msgstr ""
+"<funcdef>geometry <function>ST_AddMeasure</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom_mline</parameter></"
+"paramdef> <paramdef><type>float </type> <parameter>measure_start</"
+"parameter></paramdef> <paramdef><type>float </type> <parameter>measure_end</"
+"parameter></paramdef>"
+
+#. Tag: para
+#: reference_lrs.xml:402
+#, no-c-format
+msgid ""
+"<para>Return a derived geometry with measure elements linearly interpolated "
+"between the start and end points. If the geometry has no measure dimension, "
+"one is added. If the geometry has a measure dimension, it is over-written "
+"with new values. Only LINESTRINGS and MULTILINESTRINGS are supported.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_lrs.xml:404
+#, no-c-format
+msgid "Availability: 1.5.0"
+msgstr "Dostępność: 1.5.0"
+
+#. Tag: programlisting
+#: reference_lrs.xml:412
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('LINESTRING(1 0, 2 0, 4 0)'),1,4)) As ewelev;\n"
+" ewelev \n"
+"--------------------------------\n"
+" LINESTRINGM(1 0 1,2 0 2,4 0 4)\n"
+"\n"
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('LINESTRING(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n"
+" ewelev \n"
+"----------------------------------------\n"
+" LINESTRING(1 0 4 10,2 0 4 20,4 0 4 40)\n"
+"\n"
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('LINESTRINGM(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n"
+" ewelev \n"
+"----------------------------------------\n"
+" LINESTRINGM(1 0 10,2 0 20,4 0 40)\n"
+" \n"
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('MULTILINESTRINGM((1 0 4, 2 0 4, 4 0 4),(1 0 4, 2 0 4, 4 0 "
+"4))'),10,70)) As ewelev;\n"
+" ewelev \n"
+"-----------------------------------------------------------------\n"
+" MULTILINESTRINGM((1 0 10,2 0 20,4 0 40),(1 0 40,2 0 50,4 0 70))"
+msgstr ""
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('LINESTRING(1 0, 2 0, 4 0)'),1,4)) As ewelev;\n"
+" ewelev \n"
+"--------------------------------\n"
+" LINESTRINGM(1 0 1,2 0 2,4 0 4)\n"
+"\n"
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('LINESTRING(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n"
+" ewelev \n"
+"----------------------------------------\n"
+" LINESTRING(1 0 4 10,2 0 4 20,4 0 4 40)\n"
+"\n"
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('LINESTRINGM(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n"
+" ewelev \n"
+"----------------------------------------\n"
+" LINESTRINGM(1 0 10,2 0 20,4 0 40)\n"
+" \n"
+"SELECT ST_AsText(ST_AddMeasure(\n"
+"ST_GeomFromEWKT('MULTILINESTRINGM((1 0 4, 2 0 4, 4 0 4),(1 0 4, 2 0 4, 4 0 "
+"4))'),10,70)) As ewelev;\n"
+" ewelev \n"
+"-----------------------------------------------------------------\n"
+" MULTILINESTRINGM((1 0 10,2 0 20,4 0 40),(1 0 40,2 0 50,4 0 70))"
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_management.xml:3
+#, no-c-format
+msgid "Management Functions"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:7
+#, no-c-format
+msgid "AddGeometryColumn"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:9
+#, no-c-format
+msgid ""
+"Adds a geometry column to an existing table of attributes. By default uses "
+"type modifier to define rather than constraints. Pass in false for "
+"use_typmod to get old check constraint based behavior"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_management.xml:15
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>AddGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>table_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>column_name</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>srid</"
+"parameter></paramdef> <paramdef><type>varchar </type> <parameter>type</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>dimension</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>use_typmod=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AddGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>schema_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>table_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>column_name</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>srid</"
+"parameter></paramdef> <paramdef><type>varchar </type> <parameter>type</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>dimension</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>use_typmod=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>AddGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>catalog_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>column_name</parameter></paramdef> <paramdef><type>integer "
+"</type> <parameter>srid</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>type</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>dimension</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>use_typmod=true</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: title
+#: reference_management.xml:92 reference_management.xml:188
+#: reference_management.xml:254 reference_management.xml:298
+#: reference_management.xml:344 reference_management.xml:386
+#: reference_management.xml:427 reference_management.xml:458
+#: reference_management.xml:499 reference_management.xml:540
+#: reference_management.xml:583 reference_management.xml:631
+#: reference_management.xml:677 reference_management.xml:726
+#: reference_management.xml:862
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:94
+#, no-c-format
+msgid ""
+"Adds a geometry column to an existing table of attributes. The "
+"<varname>schema_name</varname> is the name of the table schema. The "
+"<varname>srid</varname> must be an integer value reference to an entry in "
+"the SPATIAL_REF_SYS table. The <varname>type</varname> must be a string "
+"corresponding to the geometry type, eg, 'POLYGON' or 'MULTILINESTRING' . An "
+"error is thrown if the schemaname doesn't exist (or not visible in the "
+"current search_path) or the specified SRID, geometry type, or dimension is "
+"invalid."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:104
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 This function no longer updates geometry_columns since "
+"geometry_columns is a view that reads from system catalogs. It by default "
+"also does not create constraints, but instead uses the built in type "
+"modifier behavior of PostgreSQL. So for example building a wgs84 POINT "
+"column with this function is now equivalent to: <code>ALTER TABLE some_table "
+"ADD COLUMN geom geometry(Point,4326);</code>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:107
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 If you require the old behavior of constraints use the "
+"default <varname>use_typmod</varname>, but set it to false."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:111
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 Views can no longer be manually registered in "
+"geometry_columns, however views built against geometry typmod tables "
+"geometries and used without wrapper functions will register themselves "
+"correctly because they inherit the typmod behavior of their parent table "
+"column. Views that use geometry functions that output other geometries will "
+"need to be cast to typmod geometries for these view geometry columns to be "
+"registered correctly in geometry_columns. Refer to <xref linkend="
+"\"Manual_Register_Spatial_Column\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:117 reference_management.xml:194
+#, no-c-format
+msgid "&sfs_compliant;"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:118 reference_management.xml:195
+#: reference_management.xml:868
+#, no-c-format
+msgid "&Z_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:119 reference_management.xml:196
+#: reference_management.xml:869
+#, no-c-format
+msgid "&curve_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:120
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 use_typmod argument introduced. Defaults to creating typmod "
+"geometry column instead of constraint-based."
+msgstr ""
+
+#. Tag: title
+#: reference_management.xml:124 reference_management.xml:203
+#: reference_management.xml:267 reference_management.xml:306
+#: reference_management.xml:351 reference_management.xml:393
+#: reference_management.xml:433 reference_management.xml:464
+#: reference_management.xml:506 reference_management.xml:548
+#: reference_management.xml:600 reference_management.xml:646
+#: reference_management.xml:683 reference_management.xml:784
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:126
+#, no-c-format
+msgid ""
+"-- Create schema to hold data\n"
+"CREATE SCHEMA my_schema;\n"
+"-- Create a new simple PostgreSQL table\n"
+"CREATE TABLE my_schema.my_spatial_table (id serial);\n"
+"\n"
+"-- Describing the table shows a simple table with a single \"id\" column.\n"
+"postgis=# \\d my_schema.my_spatial_table\n"
+" Table \"my_schema."
+"my_spatial_table\"\n"
+" Column | Type | Modifiers\n"
+"--------+---------"
+"+-------------------------------------------------------------------------\n"
+" id | integer | not null default nextval('my_schema."
+"my_spatial_table_id_seq'::regclass)\n"
+"\n"
+"-- Add a spatial column to the table\n"
+"SELECT AddGeometryColumn "
+"('my_schema','my_spatial_table','geom',4326,'POINT',2);\n"
+"\n"
+"-- Add a point using the old constraint based behavior\n"
+"SELECT AddGeometryColumn "
+"('my_schema','my_spatial_table','geom_c',4326,'POINT',2, false);\n"
+"\n"
+"--Add a curvepolygon using old constraint behavior\n"
+"SELECT AddGeometryColumn "
+"('my_schema','my_spatial_table','geomcp_c',4326,'CURVEPOLYGON',2, false);\n"
+"\n"
+"-- Describe the table again reveals the addition of a new geometry columns.\n"
+"\\d my_schema.my_spatial_table\n"
+" addgeometrycolumn \n"
+"-------------------------------------------------------------------------\n"
+" my_schema.my_spatial_table.geomcp_c SRID:4326 TYPE:CURVEPOLYGON DIMS:2 \n"
+"(1 row)\n"
+"\n"
+" Table \"my_schema.my_spatial_table\"\n"
+" Column | Type | "
+"Modifiers \n"
+"----------+----------------------"
+"+-------------------------------------------------------------------------\n"
+" id | integer | not null default nextval('my_schema."
+"my_spatial_table_id_seq'::regclass)\n"
+" geom | geometry(Point,4326) | \n"
+" geom_c | geometry | \n"
+" geomcp_c | geometry | \n"
+"Check constraints:\n"
+" \"enforce_dims_geom_c\" CHECK (st_ndims(geom_c) = 2)\n"
+" \"enforce_dims_geomcp_c\" CHECK (st_ndims(geomcp_c) = 2)\n"
+" \"enforce_geotype_geom_c\" CHECK (geometrytype(geom_c) = 'POINT'::text "
+"OR geom_c IS NULL)\n"
+" \"enforce_geotype_geomcp_c\" CHECK (geometrytype(geomcp_c) = "
+"'CURVEPOLYGON'::text OR geomcp_c IS NULL)\n"
+" \"enforce_srid_geom_c\" CHECK (st_srid(geom_c) = 4326)\n"
+" \"enforce_srid_geomcp_c\" CHECK (st_srid(geomcp_c) = 4326)\n"
+" \n"
+"-- geometry_columns view also registers the new columns --\n"
+"SELECT f_geometry_column As col_name, type, srid, coord_dimension As ndims \n"
+" FROM geometry_columns\n"
+" WHERE f_table_name = 'my_spatial_table' AND f_table_schema = "
+"'my_schema';\n"
+"\n"
+" col_name | type | srid | ndims \n"
+"----------+--------------+------+-------\n"
+" geom | Point | 4326 | 2\n"
+" geom_c | Point | 4326 | 2\n"
+" geomcp_c | CurvePolygon | 4326 | 2"
+msgstr ""
+
+#. Tag: title
+#: reference_management.xml:130 reference_management.xml:208
+#: reference_management.xml:272 reference_management.xml:312
+#: reference_management.xml:357 reference_management.xml:399
+#: reference_management.xml:470 reference_management.xml:512
+#: reference_management.xml:554 reference_management.xml:606
+#: reference_management.xml:652 reference_management.xml:689
+#: reference_management.xml:873
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:132
+#, no-c-format
+msgid ""
+", <xref linkend=\"DropGeometryTable\"/>, <xref linkend=\"geometry_columns\"/"
+">, <xref linkend=\"Manual_Register_Spatial_Column\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:138
+#, no-c-format
+msgid "DropGeometryColumn"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:140
+#, no-c-format
+msgid "Removes a geometry column from a spatial table."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_management.xml:145
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>DropGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>table_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>column_name</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>text "
+"<function>DropGeometryColumn</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>schema_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>column_name</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>DropGeometryColumn</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>catalog_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>column_name</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:190
+#, no-c-format
+msgid ""
+"Removes a geometry column from a spatial table. Note that schema_name will "
+"need to match the f_table_schema field of the table's row in the "
+"geometry_columns table."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:198
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 This function is provided for backward compatibility. Now "
+"that since geometry_columns is now a view against the system catalogs, you "
+"can drop a geometry column like any other table column using <code>ALTER "
+"TABLE</code>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:205
+#, no-c-format
+msgid ""
+"SELECT DropGeometryColumn ('my_schema','my_spatial_table','geom');\n"
+" ----RESULT output ---\n"
+" dropgeometrycolumn\n"
+"------------------------------------------------------\n"
+" my_schema.my_spatial_table.geom effectively removed.\n"
+" \n"
+"-- In PostGIS 2.0+ the above is also equivalent to the standard\n"
+"-- the standard alter table. Both will deregister from geometry_columns\n"
+"ALTER TABLE my_schema.my_spatial_table DROP column geom;"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:210
+#, no-c-format
+msgid ""
+", <xref linkend=\"DropGeometryTable\"/>, <xref linkend=\"geometry_columns\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:216
+#, no-c-format
+msgid "DropGeometryTable"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:218
+#, no-c-format
+msgid "Drops a table and all its references in geometry_columns."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_management.xml:223
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>DropGeometryTable</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>table_name</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>DropGeometryTable</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>schema_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>table_name</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>boolean <function>DropGeometryTable</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>catalog_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:256
+#, no-c-format
+msgid ""
+"Drops a table and all its references in geometry_columns. Note: uses "
+"current_schema() on schema-aware pgsql installations if schema is not "
+"provided."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:261
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 This function is provided for backward compatibility. Now "
+"that since geometry_columns is now a view against the system catalogs, you "
+"can drop a table with geometry columns like any other table using <code>DROP "
+"TABLE</code>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:269
+#, no-c-format
+msgid ""
+"SELECT DropGeometryTable ('my_schema','my_spatial_table');\n"
+"----RESULT output ---\n"
+"my_schema.my_spatial_table dropped.\n"
+" \n"
+"-- The above is now equivalent to --\n"
+"DROP TABLE my_schema.my_spatial_table;"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:274
+#, no-c-format
+msgid ""
+", <xref linkend=\"DropGeometryColumn\"/>, <xref linkend=\"geometry_columns\"/"
+">"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:281
+#, no-c-format
+msgid "PostGIS_Full_Version"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:283
+#, no-c-format
+msgid "Reports full postgis version and build configuration infos."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:289
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Full_Version</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:300
+#, no-c-format
+msgid ""
+"Reports full postgis version and build configuration infos. Also informs "
+"about synchronization between libraries and scripts suggesting upgrades as "
+"needed."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:308
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Full_Version();\n"
+" postgis_full_version\n"
+"----------------------------------------------------------------------------------\n"
+" POSTGIS=\"1.3.3\" GEOS=\"3.1.0-CAPI-1.5.0\" PROJ=\"Rel. 4.4.9, 29 Oct "
+"2004\" USE_STATS\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:314
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_GEOS_Version\"/>, <xref linkend="
+"\"PostGIS_Lib_Version\"/>, <xref linkend=\"PostGIS_LibXML_Version\"/>, <xref "
+"linkend=\"PostGIS_PROJ_Version\"/>, <xref linkend=\"PostGIS_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:327
+#, no-c-format
+msgid "PostGIS_GEOS_Version"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:329
+#, no-c-format
+msgid "Returns the version number of the GEOS library."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:335
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_GEOS_Version</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:346
+#, no-c-format
+msgid ""
+"Returns the version number of the GEOS library, or <varname>NULL</varname> "
+"if GEOS support is not enabled."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:353
+#, no-c-format
+msgid ""
+"SELECT PostGIS_GEOS_Version();\n"
+" postgis_geos_version\n"
+"----------------------\n"
+" 3.1.0-CAPI-1.5.0\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:359
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_Lib_Version\"/>, <xref linkend="
+"\"PostGIS_LibXML_Version\"/>, <xref linkend=\"PostGIS_PROJ_Version\"/>, "
+"<xref linkend=\"PostGIS_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:369
+#, no-c-format
+msgid "PostGIS_LibXML_Version"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:371
+#, no-c-format
+msgid "Returns the version number of the libxml2 library."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:377
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_LibXML_Version</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:388
+#, no-c-format
+msgid "Returns the version number of the LibXML2 library."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:389
+#, no-c-format
+msgid "Availability: 1.5"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:395
+#, no-c-format
+msgid ""
+"SELECT PostGIS_LibXML_Version();\n"
+" postgis_libxml_version\n"
+"----------------------\n"
+" 2.7.6\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:401
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_Lib_Version\"/>, <xref linkend="
+"\"PostGIS_PROJ_Version\"/>, <xref linkend=\"PostGIS_GEOS_Version\"/>, <xref "
+"linkend=\"PostGIS_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:411
+#, no-c-format
+msgid "PostGIS_Lib_Build_Date"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:413
+#, no-c-format
+msgid "<refpurpose>Returns build date of the PostGIS library.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:418
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Lib_Build_Date</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:429
+#, no-c-format
+msgid "<para>Returns build date of the PostGIS library.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:435
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Lib_Build_Date();\n"
+" postgis_lib_build_date\n"
+"------------------------\n"
+" 2008-06-21 17:53:21\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:441
+#, no-c-format
+msgid "PostGIS_Lib_Version"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:443
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the version number of the PostGIS library.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:449
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Lib_Version</function></funcdef> <paramdef></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:460
+#, no-c-format
+msgid "<para>Returns the version number of the PostGIS library.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:466
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Lib_Version();\n"
+" postgis_lib_version\n"
+"---------------------\n"
+" 1.3.3\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:472
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_GEOS_Version\"/>, <xref linkend="
+"\"PostGIS_LibXML_Version\"/>, <xref linkend=\"PostGIS_PROJ_Version\"/>, "
+"<xref linkend=\"PostGIS_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:482
+#, no-c-format
+msgid "PostGIS_PROJ_Version"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:484
+#, no-c-format
+msgid "Returns the version number of the PROJ4 library."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:490
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_PROJ_Version</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:501
+#, no-c-format
+msgid ""
+"Returns the version number of the PROJ4 library, or <varname>NULL</varname> "
+"if PROJ4 support is not enabled."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:508
+#, no-c-format
+msgid ""
+"SELECT PostGIS_PROJ_Version();\n"
+" postgis_proj_version\n"
+"-------------------------\n"
+" Rel. 4.4.9, 29 Oct 2004\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:514 reference_management.xml:556
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_GEOS_Version\"/>, <xref linkend="
+"\"PostGIS_Lib_Version\"/>, <xref linkend=\"PostGIS_LibXML_Version\"/>, <xref "
+"linkend=\"PostGIS_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:524
+#, no-c-format
+msgid "PostGIS_Scripts_Build_Date"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:526
+#, no-c-format
+msgid "<refpurpose>Returns build date of the PostGIS scripts.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:531
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Scripts_Build_Date</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:542
+#, no-c-format
+msgid "<para>Returns build date of the PostGIS scripts.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:544
+#, no-c-format
+msgid "Availability: 1.0.0RC1"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:550
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Scripts_Build_Date();\n"
+" postgis_scripts_build_date\n"
+"-------------------------\n"
+" 2007-08-18 09:09:26\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:566
+#, no-c-format
+msgid "PostGIS_Scripts_Installed"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:568
+#, no-c-format
+msgid ""
+"<refpurpose>Returns version of the postgis scripts installed in this "
+"database.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:574
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Scripts_Installed</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:585
+#, no-c-format
+msgid ""
+"<para>Returns version of the postgis scripts installed in this database.</"
+"para>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:589
+#, no-c-format
+msgid ""
+"If the output of this function doesn't match the output of <xref linkend="
+"\"PostGIS_Scripts_Released\"/> you probably missed to properly upgrade an "
+"existing database. See the <link linkend=\"upgrading\">Upgrading</link> "
+"section for more info."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:596 reference_management.xml:642
+#, no-c-format
+msgid "Availability: 0.9.0"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:602
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Scripts_Installed();\n"
+" postgis_scripts_installed\n"
+"-------------------------\n"
+" 1.5.0SVN\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:608
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_Scripts_Released\"/>, <xref linkend="
+"\"PostGIS_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:614
+#, no-c-format
+msgid "PostGIS_Scripts_Released"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:616
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the version number of the postgis.sql script released "
+"with the installed postgis lib.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:622
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Scripts_Released</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:633
+#, no-c-format
+msgid ""
+"<para>Returns the version number of the postgis.sql script released with the "
+"installed postgis lib.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:637
+#, no-c-format
+msgid ""
+"Starting with version 1.1.0 this function returns the same value of <xref "
+"linkend=\"PostGIS_Lib_Version\"/>. Kept for backward compatibility."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:648
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Scripts_Released();\n"
+" postgis_scripts_released\n"
+"-------------------------\n"
+" 1.3.4SVN\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:654
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_Scripts_Installed\"/>, <xref linkend="
+"\"PostGIS_Lib_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:660
+#, no-c-format
+msgid "PostGIS_Version"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:662
+#, no-c-format
+msgid ""
+"<refpurpose>Returns PostGIS version number and compile-time options.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_management.xml:668
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Version</function></funcdef> <paramdef></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:679
+#, no-c-format
+msgid "<para>Returns PostGIS version number and compile-time options.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:685
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Version();\n"
+" postgis_version\n"
+"---------------------------------------\n"
+" 1.3 USE_GEOS=1 USE_PROJ=1 USE_STATS=1\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:691
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_GEOS_Version\"/>, <xref linkend="
+"\"PostGIS_Lib_Version\"/>, <xref linkend=\"PostGIS_LibXML_Version\"/>, <xref "
+"linkend=\"PostGIS_PROJ_Version\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:701
+#, no-c-format
+msgid "Populate_Geometry_Columns"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:703
+#, no-c-format
+msgid ""
+"Ensures geometry columns are defined with type modifiers or have appropriate "
+"spatial constraints This ensures they will be registered correctly in "
+"<varname>geometry_columns</varname> view. By default will convert all "
+"geometry columns with no type modifier to ones with type modifiers. To get "
+"old behavior set <varname>use_typmod=false</varname>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_management.xml:709
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>Populate_Geometry_Columns</"
+"function></funcdef> <paramdef><type>boolean </type> "
+"<parameter>use_typmod=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>int <function>Populate_Geometry_Columns</function></"
+"funcdef> <paramdef><type>oid</type> <parameter>relation_oid</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>use_typmod=true</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:728
+#, no-c-format
+msgid ""
+"Ensures geometry columns have appropriate type modifiers or spatial "
+"constraints to ensure they are registered correctly in "
+"<varname>geometry_columns</varname> table."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:730
+#, no-c-format
+msgid ""
+"For backwards compatibility and for spatial needs such as tble inheritance "
+"where each child table may have different geometry type, the old check "
+"constraint behavior is still supported. If you need the old behavior, you "
+"need to pass in the new optional argument as false "
+"<varname>use_typmod=false</varname>. When this is done geometry columns will "
+"be created with no type modifiers but will have 3 constraints defined. In "
+"particular, this means that every geometry column belonging to a table has "
+"at least three constraints:"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:738
+#, no-c-format
+msgid ""
+"<varname>enforce_dims_the_geom</varname> - ensures every geometry has the "
+"same dimension (see <xref linkend=\"ST_NDims\"/>)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:744
+#, no-c-format
+msgid ""
+"<varname>enforce_geotype_the_geom</varname> - ensures every geometry is of "
+"the same type (see <xref linkend=\"GeometryType\"/>)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:750
+#, no-c-format
+msgid ""
+"<varname>enforce_srid_the_geom</varname> - ensures every geometry is in the "
+"same projection (see <xref linkend=\"ST_SRID\"/>)"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:756
+#, no-c-format
+msgid ""
+"If a table <varname>oid</varname> is provided, this function tries to "
+"determine the srid, dimension, and geometry type of all geometry columns in "
+"the table, adding constraints as necessary. If successful, an appropriate "
+"row is inserted into the geometry_columns table, otherwise, the exception is "
+"caught and an error notice is raised describing the problem."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:763
+#, no-c-format
+msgid ""
+"If the <varname>oid</varname> of a view is provided, as with a table oid, "
+"this function tries to determine the srid, dimension, and type of all the "
+"geometries in the view, inserting appropriate entries into the "
+"<varname>geometry_columns</varname> table, but nothing is done to enforce "
+"constraints."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:769
+#, no-c-format
+msgid ""
+"The parameterless variant is a simple wrapper for the parameterized variant "
+"that first truncates and repopulates the geometry_columns table for every "
+"spatial table and view in the database, adding spatial constraints to tables "
+"where appropriate. It returns a summary of the number of geometry columns "
+"detected in the database and the number that were inserted into the "
+"<varname>geometry_columns</varname> table. The parameterized version simply "
+"returns the number of rows inserted into the <varname>geometry_columns</"
+"varname> table."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:777
+#, no-c-format
+msgid "Availability: 1.4.0"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:778
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 By default, now uses type modifiers instead of check "
+"constraints to constrain geometry types. You can still use check constraint "
+"behavior instead by using the new <varname>use_typmod</varname> and setting "
+"it to false."
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:780
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 <varname>use_typmod</varname> optional argument was "
+"introduced that allows controlling if columns are created with typmodifiers "
+"or with check constraints."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:786
+#, no-c-format
+msgid ""
+"CREATE TABLE public.myspatial_table(gid serial, geom geometry);\n"
+"INSERT INTO myspatial_table(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, 3 "
+"4)',4326) );\n"
+"-- This will now use typ modifiers. For this to work, there must exist "
+"data\n"
+"SELECT Populate_Geometry_Columns('public.myspatial_table'::regclass);\n"
+"\n"
+"populate_geometry_columns\n"
+"--------------------------\n"
+" 1\n"
+" \n"
+" \n"
+"\\d myspatial_table\n"
+"\n"
+" Table \"public.myspatial_table\"\n"
+" Column | Type | "
+"Modifiers \n"
+"--------+---------------------------"
+"+---------------------------------------------------------------\n"
+" gid | integer | not null default "
+"nextval('myspatial_table_gid_seq'::regclass)\n"
+" geom | geometry(LineString,4326) |"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_management.xml:788
+#, no-c-format
+msgid ""
+"-- This will change the geometry columns to use constraints if they are not "
+"typmod or have constraints already. \n"
+"--For this to work, there must exist data\n"
+"CREATE TABLE public.myspatial_table_cs(gid serial, geom geometry);\n"
+"INSERT INTO myspatial_table_cs(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, "
+"3 4)',4326) );\n"
+"SELECT Populate_Geometry_Columns('public.myspatial_table_cs'::regclass, "
+"false);\n"
+"populate_geometry_columns\n"
+"--------------------------\n"
+" 1\n"
+"\\d myspatial_table_cs\n"
+"\n"
+" Table \"public.myspatial_table_cs\"\n"
+" Column | Type | "
+"Modifiers \n"
+"--------+----------"
+"+------------------------------------------------------------------\n"
+" gid | integer | not null default nextval('myspatial_table_cs_gid_seq'::"
+"regclass)\n"
+" geom | geometry | \n"
+"Check constraints:\n"
+" \"enforce_dims_geom\" CHECK (st_ndims(geom) = 2)\n"
+" \"enforce_geotype_geom\" CHECK (geometrytype(geom) = 'LINESTRING'::text "
+"OR geom IS NULL)\n"
+" \"enforce_srid_geom\" CHECK (st_srid(geom) = 4326)"
+msgstr ""
+
+#. Tag: refname
+#: reference_management.xml:803
+#, no-c-format
+msgid "UpdateGeometrySRID"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_management.xml:805
+#, no-c-format
+msgid ""
+"Updates the SRID of all features in a geometry column, geometry_columns "
+"metadata and srid table constraint"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_management.xml:810
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>UpdateGeometrySRID</function></"
+"funcdef> <paramdef><type>varchar </type> <parameter>table_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>column_name</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>srid</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>text "
+"<function>UpdateGeometrySRID</function></funcdef> <paramdef><type>varchar </"
+"type> <parameter>schema_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar "
+"</type> <parameter>column_name</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>UpdateGeometrySRID</"
+"function></funcdef> <paramdef><type>varchar </type> <parameter>catalog_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>schema_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>varchar </"
+"type> <parameter>column_name</parameter></paramdef> <paramdef><type>integer "
+"</type> <parameter>srid</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_management.xml:864
+#, no-c-format
+msgid ""
+"Updates the SRID of all features in a geometry column, updating constraints "
+"and reference in geometry_columns. Note: uses current_schema() on schema-"
+"aware pgsql installations if schema is not provided."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-10-11 21:39+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_measure.xml:3
+#, no-c-format
+msgid "Spatial Relationships and Measurements"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:6
+#, no-c-format
+msgid "ST_3DClosestPoint"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:8
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional point on g1 that is closest to g2. This is the "
+"first point of the 3D shortest line."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:14
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_3DClosestPoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: title
+#: reference_measure.xml:27 reference_measure.xml:92 reference_measure.xml:143
+#: reference_measure.xml:195 reference_measure.xml:252
+#: reference_measure.xml:302 reference_measure.xml:371
+#: reference_measure.xml:417 reference_measure.xml:489
+#: reference_measure.xml:547 reference_measure.xml:621
+#: reference_measure.xml:739 reference_measure.xml:812
+#: reference_measure.xml:964 reference_measure.xml:1045
+#: reference_measure.xml:1127 reference_measure.xml:1187
+#: reference_measure.xml:1353 reference_measure.xml:1488
+#: reference_measure.xml:1566 reference_measure.xml:1627
+#: reference_measure.xml:1679 reference_measure.xml:1726
+#: reference_measure.xml:1775 reference_measure.xml:1828
+#: reference_measure.xml:1910 reference_measure.xml:1973
+#: reference_measure.xml:2022 reference_measure.xml:2082
+#: reference_measure.xml:2145 reference_measure.xml:2195
+#: reference_measure.xml:2228 reference_measure.xml:2273
+#: reference_measure.xml:2325 reference_measure.xml:2376
+#: reference_measure.xml:2428 reference_measure.xml:2516
+#: reference_measure.xml:2559 reference_measure.xml:2651
+#: reference_measure.xml:2700 reference_measure.xml:2737
+#: reference_measure.xml:2779 reference_measure.xml:2826
+#: reference_measure.xml:2884 reference_measure.xml:2950
+#: reference_measure.xml:2993 reference_measure.xml:3072
+#: reference_measure.xml:3220
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:29
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional point on g1 that is closest to g2. This is the "
+"first point of the 3D shortest line. The 3D length of the 3D shortest line "
+"is the 3D distance."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:32 reference_measure.xml:97 reference_measure.xml:148
+#: reference_measure.xml:210 reference_measure.xml:265
+#: reference_measure.xml:311 reference_measure.xml:376
+#: reference_measure.xml:430 reference_measure.xml:2027
+#: reference_measure.xml:2232 reference_measure.xml:2287
+#: reference_measure.xml:2384 reference_measure.xml:2741
+#: reference_measure.xml:2787
+#, no-c-format
+msgid "&Z_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:34 reference_measure.xml:99 reference_measure.xml:150
+#: reference_measure.xml:212 reference_measure.xml:267
+#: reference_measure.xml:313 reference_measure.xml:378
+#: reference_measure.xml:432 reference_measure.xml:499
+#, no-c-format
+msgid "&P_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:35 reference_measure.xml:102
+#: reference_measure.xml:153 reference_measure.xml:209
+#: reference_measure.xml:259 reference_measure.xml:310
+#: reference_measure.xml:380 reference_measure.xml:429
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr ""
+
+#. Tag: title
+#: reference_measure.xml:39 reference_measure.xml:106
+#: reference_measure.xml:157 reference_measure.xml:217
+#: reference_measure.xml:317 reference_measure.xml:384
+#: reference_measure.xml:436 reference_measure.xml:505
+#: reference_measure.xml:563 reference_measure.xml:647
+#: reference_measure.xml:749 reference_measure.xml:850
+#: reference_measure.xml:1003 reference_measure.xml:1081
+#: reference_measure.xml:1156 reference_measure.xml:1253
+#: reference_measure.xml:1388 reference_measure.xml:1511
+#: reference_measure.xml:1580 reference_measure.xml:1652
+#: reference_measure.xml:1693 reference_measure.xml:1741
+#: reference_measure.xml:1789 reference_measure.xml:1846
+#: reference_measure.xml:1943 reference_measure.xml:1992
+#: reference_measure.xml:2033 reference_measure.xml:2238
+#: reference_measure.xml:2292 reference_measure.xml:2344
+#: reference_measure.xml:2390 reference_measure.xml:2438
+#: reference_measure.xml:2531 reference_measure.xml:2581
+#: reference_measure.xml:2747 reference_measure.xml:2791
+#: reference_measure.xml:2836 reference_measure.xml:2920
+#: reference_measure.xml:2960 reference_measure.xml:3009
+#: reference_measure.xml:3122 reference_measure.xml:3252
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:44
+#, no-c-format
+msgid "linestring and point -- both 3d and 2d closest point"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:45
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt, \n"
+" ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt\n"
+" FROM (SELECT 'POINT(100 100 30)'::geometry As pt, \n"
+" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 "
+"1000)'::geometry As line\n"
+" ) As foo;\n"
+" \n"
+" \n"
+" cp3d_line_pt "
+"| cp2d_line_pt\n"
+"-----------------------------------------------------------"
+"+------------------------------------------\n"
+" POINT(54.6993798867619 128.935022917228 11.5475869506606) | "
+"POINT(73.0769230769231 115.384615384615)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:49
+#, no-c-format
+msgid "linestring and multipoint -- both 3d and 2d closest point"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:50
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt, \n"
+" ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt\n"
+" FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt, \n"
+" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 "
+"900)'::geometry As line\n"
+" ) As foo;\n"
+" \n"
+" \n"
+" cp3d_line_pt | cp2d_line_pt\n"
+"-----------------------------------------------------------+--------------\n"
+" POINT(54.6993798867619 128.935022917228 11.5475869506606) | POINT(50 75)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:54
+#, no-c-format
+msgid "Multilinestring and polygon both 3d and 2d closest point"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:55
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DClosestPoint(poly, mline)) As cp3d,\n"
+" ST_AsEWKT(ST_ClosestPoint(poly, mline)) As cp2d \n"
+" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, "
+"50 60 5, 100 100 5, 175 150 5))') As poly,\n"
+" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 "
+"-2, 125 100 1, 175 155 1),\n"
+" (1 10 2, 5 20 1))') As mline ) As foo;\n"
+" cp3d | cp2d\n"
+"-------------------------------------------+--------------\n"
+" POINT(39.993580415989 54.1889925532825 5) | POINT(20 40)"
+msgstr ""
+
+#. Tag: title
+#: reference_measure.xml:65 reference_measure.xml:113
+#: reference_measure.xml:163 reference_measure.xml:222
+#: reference_measure.xml:275 reference_measure.xml:343
+#: reference_measure.xml:390 reference_measure.xml:462
+#: reference_measure.xml:521 reference_measure.xml:596
+#: reference_measure.xml:710 reference_measure.xml:784
+#: reference_measure.xml:937 reference_measure.xml:1008
+#: reference_measure.xml:1089 reference_measure.xml:1161
+#: reference_measure.xml:1458 reference_measure.xml:1517
+#: reference_measure.xml:1586 reference_measure.xml:1700
+#: reference_measure.xml:1748 reference_measure.xml:1796
+#: reference_measure.xml:1851 reference_measure.xml:1948
+#: reference_measure.xml:1998 reference_measure.xml:2040
+#: reference_measure.xml:2121 reference_measure.xml:2172
+#: reference_measure.xml:2204 reference_measure.xml:2247
+#: reference_measure.xml:2299 reference_measure.xml:2351
+#: reference_measure.xml:2397 reference_measure.xml:2491
+#: reference_measure.xml:2536 reference_measure.xml:2623
+#: reference_measure.xml:2677 reference_measure.xml:2713
+#: reference_measure.xml:2754 reference_measure.xml:2797
+#: reference_measure.xml:2842 reference_measure.xml:2926
+#: reference_measure.xml:2966 reference_measure.xml:3043
+#: reference_measure.xml:3263
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:67
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_ClosestPoint\"/>, <xref linkend=\"ST_3DDistance\"/>, "
+"<xref linkend=\"ST_3DShortestLine\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:72
+#, no-c-format
+msgid "ST_3DDistance"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:74
+#, no-c-format
+msgid ""
+"For geometry type Returns the 3-dimensional cartesian minimum distance "
+"(based on spatial ref) between two geometries in projected units."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:79
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_3DDistance</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:94
+#, no-c-format
+msgid ""
+"For geometry type returns the 3-dimensional minimum cartesian distance "
+"between two geometries in projected units (spatial ref units)."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:100 reference_measure.xml:151
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM ?"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:108
+#, no-c-format
+msgid ""
+"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal "
+"area) (3D point and line compared 2D point and line)\n"
+"-- Note: currently no vertical datum support so Z is not transformed and "
+"assumed to be same units as final.\n"
+"SELECT ST_3DDistance(\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"POINT(-72.1235 42.3521 4)'),2163),\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)\n"
+" ) As dist_3d,\n"
+" ST_Distance(\n"
+" ST_Transform(ST_GeomFromText('POINT(-72.1235 "
+"42.3521)',4326),2163),\n"
+" ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 "
+"42.45, -72.123 42.1546)', 4326),2163)\n"
+" ) As dist_2d;\n"
+"\n"
+" dist_3d | dist_2d\n"
+"------------------+-----------------\n"
+" 127.295059324629 | 126.66425605671"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:109
+#, no-c-format
+msgid ""
+"-- Multilinestring and polygon both 3d and 2d distance\n"
+"-- Same example as 3D closest point example\n"
+"SELECT ST_3DDistance(poly, mline) As dist3d,\n"
+" ST_Distance(poly, mline) As dist2d \n"
+" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, "
+"50 60 5, 100 100 5, 175 150 5))') As poly,\n"
+" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 "
+"-2, 125 100 1, 175 155 1),\n"
+" (1 10 2, 5 20 1))') As mline ) As foo;\n"
+" dist3d | dist2d\n"
+"-------------------+--------\n"
+" 0.716635696066337 | 0"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:115
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_3DClosestPoint\"/>, <xref linkend=\"ST_3DDWithin\"/>, "
+"<xref linkend=\"ST_3DMaxDistance\"/>, <xref linkend=\"ST_3DShortestLine\"/>, "
+"<xref linkend=\"ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:121
+#, no-c-format
+msgid "ST_3DDWithin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:123
+#, no-c-format
+msgid ""
+"For 3d (z) geometry type Returns true if two geometries 3d distance is "
+"within number of units."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:127
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_3DDWithin</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>distance_of_srid</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:145
+#, no-c-format
+msgid ""
+"For geometry type returns true if the 3d distance between two objects is "
+"within distance_of_srid specified projected units (spatial ref units)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:159
+#, no-c-format
+msgid ""
+"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal "
+"area) (3D point and line compared 2D point and line)\n"
+"-- Note: currently no vertical datum support so Z is not transformed and "
+"assumed to be same units as final.\n"
+"SELECT ST_3DDWithin(\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"POINT(-72.1235 42.3521 4)'),2163),\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163),\n"
+" 126.8\n"
+" ) As within_dist_3d,\n"
+"ST_DWithin(\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"POINT(-72.1235 42.3521 4)'),2163),\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163),\n"
+" 126.8\n"
+" ) As within_dist_2d;\n"
+"\n"
+" within_dist_3d | within_dist_2d\n"
+"----------------+----------------\n"
+" f | t"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:165
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Distance\"/>, <xref linkend=\"ST_DWithin\"/>, <xref "
+"linkend=\"ST_3DMaxDistance\"/>, <xref linkend=\"ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:171
+#, no-c-format
+msgid "ST_3DDFullyWithin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:173
+#, no-c-format
+msgid ""
+"Returns true if all of the 3D geometries are within the specified distance "
+"of one another."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:179
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_3DDFullyWithin</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>distance</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:197
+#, no-c-format
+msgid ""
+"Returns true if the 3D geometries are fully within the specified distance of "
+"one another. The distance is specified in units defined by the spatial "
+"reference system of the geometries. For this function to make sense, the "
+"source geometries must both be of the same coordinate projection, having the "
+"same SRID."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:204 reference_measure.xml:261
+#: reference_measure.xml:1243 reference_measure.xml:1837
+#: reference_measure.xml:1923 reference_measure.xml:2095
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:218
+#, no-c-format
+msgid ""
+"-- This compares the difference between fully within and distance within as "
+"well\n"
+" -- as the distance fully within for the 2D footprint of the "
+"line/point vs. the 3d fully within\n"
+" SELECT ST_3DDFullyWithin(geom_a, geom_b, 10) as "
+"D3DFullyWithin10, ST_3DDWithin(geom_a, geom_b, 10) as D3DWithin10, \n"
+" ST_DFullyWithin(geom_a, geom_b, 20) as D2DFullyWithin20, \n"
+" ST_3DDFullyWithin(geom_a, geom_b, 20) as D3DFullyWithin20 from \n"
+" (select ST_GeomFromEWKT('POINT(1 1 2)') as geom_a,\n"
+" ST_GeomFromEWKT('LINESTRING(1 5 2, 2 7 20, 1 9 100, 14 12 "
+"3)') as geom_b) t1;\n"
+" d3dfullywithin10 | d3dwithin10 | d2dfullywithin20 | d3dfullywithin20\n"
+"------------------+-------------+------------------+------------------\n"
+" f | t | t | f"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:224
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_3DDWithin\"/>, <xref linkend=\"ST_DWithin\"/>, <xref "
+"linkend=\"ST_DFullyWithin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:230
+#, no-c-format
+msgid "ST_3DIntersects"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:232
+#, no-c-format
+msgid ""
+"Returns TRUE if the Geometries \"spatially intersect\" in 3d - only for "
+"points and linestrings"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:238
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_3DIntersects</function></funcdef> <paramdef> "
+"<type>geometry</type> <parameter>geomA</parameter> </paramdef> <paramdef> "
+"<type>geometry</type> <parameter>geomB</parameter> </paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:253 reference_measure.xml:2083
+#, no-c-format
+msgid ""
+"Overlaps, Touches, Within all imply spatial intersection. If any of the "
+"aforementioned returns true, then the geometries also spatially intersect. "
+"Disjoint implies false for spatial intersection."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:268
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: ?"
+msgstr ""
+
+#. Tag: title
+#: reference_measure.xml:271 reference_measure.xml:2113
+#: reference_measure.xml:2161
+#, no-c-format
+msgid "Geometry Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:272
+#, no-c-format
+msgid ""
+"SELECT ST_3DIntersects(pt, line), ST_Intersects(pt,line) \n"
+" FROM (SELECT 'POINT(0 0 2)'::geometry As pt, \n"
+" 'LINESTRING (0 0 1, 0 2 3 )'::geometry As line) As foo;\n"
+" st_3dintersects | st_intersects\n"
+"-----------------+---------------\n"
+" f | t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:282
+#, no-c-format
+msgid "ST_3DLongestLine"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:284
+#, no-c-format
+msgid "Returns the 3-dimensional longest line between two geometries"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:289
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_3DLongestLine</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:304
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional longest line between two geometries. The function "
+"will only return the first longest line if more than one. The line returned "
+"will always start in g1 and end in g2. The 3D length of the line this "
+"function returns will always be the same as <xref linkend=\"ST_3DMaxDistance"
+"\"/> returns for g1 and g2."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:322
+#, no-c-format
+msgid "linestring and point -- both 3d and 2d longest line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:323
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt, \n"
+" ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt\n"
+" FROM (SELECT 'POINT(100 100 30)'::geometry As pt, \n"
+" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 "
+"1000)'::geometry As line\n"
+" ) As foo;\n"
+" \n"
+" \n"
+" lol3d_line_pt | lol2d_line_pt\n"
+"-----------------------------------+----------------------------\n"
+" LINESTRING(50 75 1000,100 100 30) | LINESTRING(98 190,100 100)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:327
+#, no-c-format
+msgid "linestring and multipoint -- both 3d and 2d longest line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:328
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt, \n"
+" ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt\n"
+" FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt, \n"
+" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 "
+"900)'::geometry As line\n"
+" ) As foo;\n"
+" \n"
+" \n"
+" lol3d_line_pt | lol2d_line_pt\n"
+"---------------------------------+--------------------------\n"
+" LINESTRING(98 190 1,50 74 1000) | LINESTRING(98 190,50 74)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:332
+#, no-c-format
+msgid "Multilinestring and polygon both 3d and 2d longest line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:333
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DLongestLine(poly, mline)) As lol3d,\n"
+" ST_AsEWKT(ST_LongestLine(poly, mline)) As lol2d \n"
+" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, "
+"50 60 5, 100 100 5, 175 150 5))') As poly,\n"
+" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 "
+"-2, 125 100 1, 175 155 1),\n"
+" (1 10 2, 5 20 1))') As mline ) As foo;\n"
+" lol3d | lol2d\n"
+"------------------------------+--------------------------\n"
+" LINESTRING(175 150 5,1 10 2) | LINESTRING(175 150,1 10)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:345
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_3DDistance\"/>, <xref linkend=\"ST_LongestLine\"/>, "
+"<xref linkend=\"ST_3DShortestLine\"/>, <xref linkend=\"ST_3DMaxDistance\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:351
+#, no-c-format
+msgid "ST_3DMaxDistance"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:353
+#, no-c-format
+msgid ""
+"For geometry type Returns the 3-dimensional cartesian maximum distance "
+"(based on spatial ref) between two geometries in projected units."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:358
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_3DMaxDistance</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:373
+#, no-c-format
+msgid ""
+"For geometry type returns the 3-dimensional maximum cartesian distance "
+"between two geometries in projected units (spatial ref units)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:386
+#, no-c-format
+msgid ""
+"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal "
+"area) (3D point and line compared 2D point and line)\n"
+"-- Note: currently no vertical datum support so Z is not transformed and "
+"assumed to be same units as final.\n"
+"SELECT ST_3DMaxDistance(\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"POINT(-72.1235 42.3521 10000)'),2163),\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)\n"
+" ) As dist_3d,\n"
+" ST_MaxDistance(\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"POINT(-72.1235 42.3521 10000)'),2163),\n"
+" ST_Transform(ST_GeomFromEWKT('SRID=4326;"
+"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)\n"
+" ) As dist_2d;\n"
+"\n"
+" dist_3d | dist_2d\n"
+"------------------+------------------\n"
+" 24383.7467488441 | 22247.8472107251"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:392
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_3DDWithin\"/>, <xref linkend=\"ST_3DMaxDistance\"/>, "
+"<xref linkend=\"ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:397
+#, no-c-format
+msgid "ST_3DShortestLine"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:399
+#, no-c-format
+msgid "Returns the 3-dimensional shortest line between two geometries"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:404
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_3DShortestLine</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:419
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional shortest line between two geometries. The function "
+"will only return the first shortest line if more than one, that the function "
+"finds. If g1 and g2 intersects in just one point the function will return a "
+"line with both start and end in that intersection-point. If g1 and g2 are "
+"intersecting with more than one point the function will return a line with "
+"start and end in the same point but it can be any of the intersecting "
+"points. The line returned will always start in g1 and end in g2. The 3D "
+"length of the line this function returns will always be the same as <xref "
+"linkend=\"ST_3DDistance\"/> returns for g1 and g2."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:441
+#, no-c-format
+msgid "linestring and point -- both 3d and 2d shortest line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:442
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt, \n"
+" ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt\n"
+" FROM (SELECT 'POINT(100 100 30)'::geometry As pt, \n"
+" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 "
+"1000)'::geometry As line\n"
+" ) As foo;\n"
+" \n"
+" \n"
+" shl3d_line_pt "
+"| shl2d_line_pt\n"
+"----------------------------------------------------------------------------"
+"+------------------------------------------------------\n"
+" LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) "
+"| LINESTRING(73.0769230769231 115.384615384615,100 100)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:446
+#, no-c-format
+msgid "linestring and multipoint -- both 3d and 2d shortest line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:447
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt, \n"
+" ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt\n"
+" FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt, \n"
+" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 "
+"900)'::geometry As line\n"
+" ) As foo;\n"
+" \n"
+" \n"
+" shl3d_line_pt | "
+"shl2d_line_pt\n"
+"---------------------------------------------------------------------------"
+"+------------------------\n"
+" LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) | "
+"LINESTRING(50 75,50 74)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:451
+#, no-c-format
+msgid "Multilinestring and polygon both 3d and 2d shortest line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:452
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_3DShortestLine(poly, mline)) As shl3d,\n"
+" ST_AsEWKT(ST_ShortestLine(poly, mline)) As shl2d \n"
+" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, "
+"50 60 5, 100 100 5, 175 150 5))') As poly,\n"
+" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 "
+"-2, 125 100 1, 175 155 1),\n"
+" (1 10 2, 5 20 1))') As mline ) As foo;\n"
+" shl3d "
+"| shl2d\n"
+"---------------------------------------------------------------------------------------------------"
+"+------------------------\n"
+" LINESTRING(39.993580415989 54.1889925532825 5,40.4078575708294 "
+"53.6052383805529 5.03423778139177) | LINESTRING(20 40,20 40)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:464
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_3DDistance\"/>, <xref linkend=\"ST_LongestLine\"/>, "
+"<xref linkend=\"ST_ShortestLine\"/>, <xref linkend=\"ST_3DMaxDistance\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:469
+#, no-c-format
+msgid "ST_Area"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:471
+#, no-c-format
+msgid ""
+"Returns the area of the surface if it is a polygon or multi-polygon. For "
+"\"geometry\" type area is in SRID units. For \"geography\" area is in square "
+"meters."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:475
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>float <function>ST_Area</function></funcdef> "
+"<paramdef><type>geometry </type><parameter>g1</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>float <function>ST_Area</function></"
+"funcdef> <paramdef><type>geography </type><parameter>geog</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </"
+"type><parameter>use_spheroid=true</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:491
+#, no-c-format
+msgid ""
+"Returns the area of the geometry if it is a polygon or multi-polygon. Return "
+"the area measurement of an ST_Surface or ST_MultiSurface value. For geometry "
+"Area is in the units of the srid. For geography area is in square meters and "
+"defaults to measuring about the spheroid of the geography (currently only "
+"WGS84). To measure around the faster but less accurate sphere -- "
+"ST_Area(geog,false)."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:496
+#, no-c-format
+msgid "Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:497 reference_measure.xml:642
+#: reference_measure.xml:1572 reference_measure.xml:1937
+#, no-c-format
+msgid "&sfs_compliant;"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:498
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.1.2, 9.5.3"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:500
+#, no-c-format
+msgid ""
+"For polyhedral surfaces, only supports 2D polyhedral surfaces (not 2.5D). "
+"For 2.5D, may give a non-zero answer, but only for the faces that sit "
+"completely in XY plane."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:506
+#, no-c-format
+msgid ""
+"Return area in square feet for a plot of Massachusetts land and multiply by "
+"conversion to get square meters. Note this is in square feet because 2249 is "
+"Mass State Plane Feet"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:509
+#, no-c-format
+msgid ""
+"SELECT ST_Area(the_geom) As sqft, ST_Area(the_geom)*POWER(0.3048,2) As sqm\n"
+" FROM (SELECT\n"
+" ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,\n"
+" 743265 2967450,743265.625 2967416,743238 "
+"2967416))',2249) ) As foo(the_geom);\n"
+" sqft | sqm\n"
+"---------+-------------\n"
+" 928.625 | 86.27208552"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:510
+#, no-c-format
+msgid ""
+"Return area square feet and transform to Massachusetts state plane meters "
+"(26986) to get square meters. Note this is in square feet because 2249 is "
+"Mass State Plane Feet and transformed area is in square meters since 26986 "
+"is state plane mass meters"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:513
+#, no-c-format
+msgid ""
+"SELECT ST_Area(the_geom) As sqft, ST_Area(ST_Transform(the_geom,26986)) As "
+"sqm\n"
+" FROM (SELECT\n"
+" ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,\n"
+" 743265 2967450,743265.625 2967416,743238 "
+"2967416))',2249) ) As foo(the_geom);\n"
+" sqft | sqm\n"
+"---------+------------------\n"
+" 928.625 | 86.2724304199219"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:515
+#, no-c-format
+msgid ""
+"Return area square feet and square meters using Geography data type. Note "
+"that we transform to our geometry to geography (before you can do that make "
+"sure your geometry is in WGS 84 long lat 4326). Geography always measures in "
+"meters. This is just for demonstration to compare. Normally your table will "
+"be stored in geography data type already."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:518
+#, no-c-format
+msgid ""
+"SELECT ST_Area(the_geog)/POWER(0.3048,2) As sqft_spheroid, ST_Area(the_geog,"
+"false)/POWER(0.3048,2) As sqft_sphere, ST_Area(the_geog) As sqm_spheroid\n"
+" FROM (SELECT\n"
+" geography(\n"
+" ST_Transform(\n"
+" ST_GeomFromText('POLYGON((743238 2967416,743238 "
+"2967450,743265 2967450,743265.625 2967416,743238 2967416))',\n"
+" 2249\n"
+" ) ,4326\n"
+" )\n"
+" )\n"
+" ) As foo(the_geog);\n"
+" sqft_spheroid | sqft_sphere | sqm_spheroid\n"
+"-----------------+------------------+------------------\n"
+"928.684405217197 | 927.186481558724 | 86.2776044452694\n"
+"\n"
+" --if your data is in geography already\n"
+" SELECT ST_Area(the_geog)/POWER(0.3048,2) As sqft, ST_Area(the_geog) As "
+"sqm\n"
+" FROM somegeogtable;"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:522
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeographyFromText\"/>, <xref linkend=\"ST_SetSRID\"/>, "
+"<xref linkend=\"ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:528
+#, no-c-format
+msgid "ST_Azimuth"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:530
+#, no-c-format
+msgid ""
+"Returns the angle in radians from the horizontal of the vector defined by "
+"pointA and pointB. Angle is computed clockwise from down-to-up: on the "
+"clock: 12=0; 3=PI/2; 6=PI; 9=3PI/2."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:533
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>float <function>ST_Azimuth</function></funcdef> "
+"<paramdef><type>geometry </type><parameter>pointA</parameter></paramdef> "
+"<paramdef><type>geometry </type><parameter>pointB</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>float <function>ST_Azimuth</"
+"function></funcdef> <paramdef><type>geography </type><parameter>pointA</"
+"parameter></paramdef> <paramdef><type>geography </type><parameter>pointB</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:549
+#, no-c-format
+msgid ""
+"Returns the azimuth of the segment defined by the given Point geometries, or "
+"NULL if the two points are coincident. Return value is in radians. Angle is "
+"computed clockwise from down-to-up: on the clock: 12=0; 3=PI/2; 6=PI; 9=3PI/2"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:553
+#, no-c-format
+msgid ""
+"The Azimuth is mathematical concept defined as the angle, in this case "
+"measured in radian, between a reference plane and a point."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:556
+#, no-c-format
+msgid "Availability: 1.1.0"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:557
+#, no-c-format
+msgid "Enhanced: 2.0.0 support for geography was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:558
+#, no-c-format
+msgid ""
+"Azimuth is especially useful in conjunction with ST_Translate for shifting "
+"an object along its perpendicular axis. See upgis_lineshift <ulink url="
+"\"http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctions"
+"\">Plpgsqlfunctions PostGIS wiki section</ulink> for example of this."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:564
+#, no-c-format
+msgid "Geometry Azimuth in degrees"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:565
+#, no-c-format
+msgid ""
+"SELECT ST_Azimuth(ST_Point(25,45), ST_Point(75,100))/(2*pi())*360 as degAz,\n"
+" ST_Azimuth(ST_Point(75,100), ST_Point(25,45))/(2*pi())*360 As "
+"degAzrev;\n"
+" \n"
+"-- NOTE easier to remember syntax using PostgreSQL built-in degrees function "
+"--\n"
+"-- Both yield same answer --\n"
+"SELECT degrees( ST_Azimuth(ST_Point(25,45), ST_Point(75,100)) ) as degAz,\n"
+" degrees( ST_Azimuth(ST_Point(75,100), ST_Point(25,45)) ) As "
+"degAzrev;\n"
+"\n"
+" degaz | degazrev\n"
+"------------------+------------------\n"
+" 42.2736890060937 | 222.273689006094"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:575
+#, no-c-format
+msgid ""
+"degAz is path to travel (azimuth), horizontal line (which starts at the "
+"start point and ends where we want the end point to fall) and points (start "
+"point: 25,45 is in green)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:585
+#, no-c-format
+msgid ""
+"degAzrev is azimuth curve shown, horizontal line (which starts at the start "
+"point and ends where we want the end point to fall) and points (start point: "
+"75,100 is in green)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:597
+#, no-c-format
+msgid ", <xref linkend=\"ST_Translate\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:604
+#, no-c-format
+msgid "ST_Centroid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:606
+#, no-c-format
+msgid "Returns the geometric center of a geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:611
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Centroid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:623
+#, no-c-format
+msgid ""
+"Computes the geometric center of a geometry, or equivalently, the center of "
+"mass of the geometry as a <varname>POINT</varname>. For [<varname>MULTI</"
+"varname>]<varname>POINT</varname>s, this is computed as the arithmetric mean "
+"of the input coordinates. For [<varname>MULTI</varname>]<varname>LINESTRING</"
+"varname>s, this is computed as the weighted length of each line segment. For "
+"[<varname>MULTI</varname>]<varname>POLYGON</varname>s, \"weight\" is thought "
+"in terms of area. If an empty geometry is supplied, an empty "
+"<varname>GEOMETRYCOLLECTION</varname> is returned. If <varname>NULL</"
+"varname> is supplied, <varname>NULL</varname> is returned."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:635
+#, no-c-format
+msgid ""
+"The centroid is equal to the centroid of the set of component Geometries of "
+"highest dimension (since the lower-dimension geometries contribute zero "
+"\"weight\" to the centroid)."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:639
+#, no-c-format
+msgid ""
+"Computation will be more accurate if performed by the GEOS module (enabled "
+"at compile time)."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:643
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.1.4, 9.5.5"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:649
+#, no-c-format
+msgid ""
+"In each of the following illustrations, the blue dot represents the centroid "
+"of the source geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:662
+#, no-c-format
+msgid "Centroid of a <varname>MULTIPOINT</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:673
+#, no-c-format
+msgid "Centroid of a <varname>LINESTRING</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:686
+#, no-c-format
+msgid "Centroid of a <varname>POLYGON</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:697
+#, no-c-format
+msgid "Centroid of a <varname>GEOMETRYCOLLECTION</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:706
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Centroid('MULTIPOINT ( -1 0, -1 2, -1 3, -1 4, -1 7, 0 "
+"1, 0 3, 1 1, 2 0, 6 0, 7 8, 9 8, 10 6 )'));\n"
+" st_astext\n"
+"------------------------------------------\n"
+" POINT(2.30769230769231 3.30769230769231)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:718
+#, no-c-format
+msgid "ST_ClosestPoint"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:720
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the 2-dimensional point on g1 that is closest to g2. "
+"This is the first point of the shortest line.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:726
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_ClosestPoint</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:741
+#, no-c-format
+msgid ""
+"<para>Returns the 2-dimensional point on g1 that is closest to g2. This is "
+"the first point of the shortest line.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:744
+#, no-c-format
+msgid ""
+"If you have a 3D Geometry, you may prefer to use <xref linkend="
+"\"ST_3DClosestPoint\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:745 reference_measure.xml:1690
+#: reference_measure.xml:1842 reference_measure.xml:2433
+#: reference_measure.xml:3005
+#, no-c-format
+msgid "Availability: 1.5.0"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:759
+#, no-c-format
+msgid ""
+"Closest between point and linestring is the point itself, but closest point "
+"between a linestring and point is the point on line string that is closest."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:763
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_ClosestPoint(pt,line)) AS cp_pt_line, \n"
+" ST_AsText(ST_ClosestPoint(line,pt)) As cp_line_pt\n"
+"FROM (SELECT 'POINT(100 100)'::geometry As pt, \n"
+" 'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry As "
+"line\n"
+" ) As foo;\n"
+"\n"
+" \n"
+" cp_pt_line | cp_line_pt\n"
+"----------------+------------------------------------------\n"
+" POINT(100 100) | POINT(73.0769230769231 115.384615384615)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:771
+#, no-c-format
+msgid "closest point on polygon A to polygon B"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:774
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_ClosestPoint(\n"
+" ST_GeomFromText('POLYGON((175 150, 20 40, 50 60, 125 "
+"100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" ) \n"
+" ) As ptwkt;\n"
+" \n"
+" ptwkt\n"
+"------------------------------------------\n"
+" POINT(140.752120669087 125.695053378061)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:786
+#, no-c-format
+msgid ""
+",<xref linkend=\"ST_Distance\"/>, <xref linkend=\"ST_LongestLine\"/>, <xref "
+"linkend=\"ST_ShortestLine\"/>, <xref linkend=\"ST_MaxDistance\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:792
+#, no-c-format
+msgid "ST_Contains"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:794
+#, no-c-format
+msgid ""
+"Returns true if and only if no points of B lie in the exterior of A, and at "
+"least one point of the interior of B lies in the interior of A."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:799
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Contains</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:814
+#, no-c-format
+msgid ""
+"Geometry A contains Geometry B if and only if no points of B lie in the "
+"exterior of A, and at least one point of the interior of B lies in the "
+"interior of A. An important subtlety of this definition is that A does not "
+"contain its boundary, but A does contain itself. Contrast that to <xref "
+"linkend=\"ST_ContainsProperly\"/> where geometry A does not Contain Properly "
+"itself."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:818
+#, no-c-format
+msgid ""
+"Returns TRUE if geometry B is completely inside geometry A. For this "
+"function to make sense, the source geometries must both be of the same "
+"coordinate projection, having the same SRID. ST_Contains is the inverse of "
+"ST_Within. So ST_Contains(A,B) implies ST_Within(B,A) except in the case of "
+"invalid geometries where the result is always false regardless or not "
+"defined."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:823 reference_measure.xml:1050
+#: reference_measure.xml:1132 reference_measure.xml:1497
+#: reference_measure.xml:2564 reference_measure.xml:2910
+#: reference_measure.xml:3227
+#, no-c-format
+msgid "Performed by the GEOS module"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:826 reference_measure.xml:988
+#: reference_measure.xml:1053 reference_measure.xml:1135
+#: reference_measure.xml:1239 reference_measure.xml:1494
+#: reference_measure.xml:3108 reference_measure.xml:3230
+#, no-c-format
+msgid "Do not call with a <varname>GEOMETRYCOLLECTION</varname> as an argument"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:830 reference_measure.xml:992
+#: reference_measure.xml:1061 reference_measure.xml:1139
+#: reference_measure.xml:3234
+#, no-c-format
+msgid ""
+"Do not use this function with invalid geometries. You will get unexpected "
+"results."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:833
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries. To avoid "
+"index use, use the function _ST_Contains."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:838 reference_measure.xml:1072
+#: reference_measure.xml:1147 reference_measure.xml:1503
+#: reference_measure.xml:2104 reference_measure.xml:2573
+#: reference_measure.xml:3242
+#, no-c-format
+msgid ""
+"NOTE: this is the \"allowable\" version that returns a boolean, not an "
+"integer."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:841
+#, no-c-format
+msgid ""
+"&sfs_compliant; s2.1.1.2 // s2.1.13.3 - same as within(geometry B, geometry "
+"A)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:843
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.31"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:845 reference_measure.xml:1076
+#: reference_measure.xml:1151
+#, no-c-format
+msgid ""
+"There are certain subtleties to ST_Contains and ST_Within that are not "
+"intuitively obvious. For details check out <ulink url=\"http://lin-ear-th-"
+"inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html"
+"\">Subtleties of OGC Covers, Contains, Within</ulink>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:852
+#, no-c-format
+msgid ""
+"The <function>ST_Contains</function> predicate returns <varname>TRUE</"
+"varname> in all the following illustrations."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:864
+#, no-c-format
+msgid "<varname>LINESTRING</varname> / <varname>MULTIPOINT</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:874 reference_measure.xml:3186
+#, no-c-format
+msgid "<varname>POLYGON</varname> / <varname>POINT</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:885 reference_measure.xml:925
+#: reference_measure.xml:3155
+#, no-c-format
+msgid "<varname>POLYGON</varname> / <varname>LINESTRING</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:895 reference_measure.xml:2610
+#: reference_measure.xml:3135 reference_measure.xml:3145
+#, no-c-format
+msgid "<varname>POLYGON</varname> / <varname>POLYGON</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:903
+#, no-c-format
+msgid ""
+"The <function>ST_Contains</function> predicate returns <varname>FALSE</"
+"varname> in all the following illustrations."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:915
+#, no-c-format
+msgid "<varname>POLYGON</varname> / <varname>MULTIPOINT</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:933
+#, no-c-format
+msgid ""
+"-- A circle within a circle\n"
+"SELECT ST_Contains(smallc, bigc) As smallcontainsbig,\n"
+" ST_Contains(bigc,smallc) As bigcontainssmall,\n"
+" ST_Contains(bigc, ST_Union(smallc, bigc)) as bigcontainsunion,\n"
+" ST_Equals(bigc, ST_Union(smallc, bigc)) as bigisunion,\n"
+" ST_Covers(bigc, ST_ExteriorRing(bigc)) As bigcoversexterior,\n"
+" ST_Contains(bigc, ST_ExteriorRing(bigc)) As bigcontainsexterior\n"
+"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,\n"
+" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As "
+"bigc) As foo;\n"
+"\n"
+"-- Result\n"
+" smallcontainsbig | bigcontainssmall | bigcontainsunion | bigisunion | "
+"bigcoversexterior | bigcontainsexterior\n"
+"------------------+------------------+------------------+------------"
+"+-------------------+---------------------\n"
+" f | t | t | t | "
+"t | f\n"
+"\n"
+"-- Example demonstrating difference between contains and contains properly\n"
+"SELECT ST_GeometryType(geomA) As geomtype, ST_Contains(geomA,geomA) AS "
+"acontainsa, ST_ContainsProperly(geomA, geomA) AS acontainspropa,\n"
+" ST_Contains(geomA, ST_Boundary(geomA)) As acontainsba, "
+"ST_ContainsProperly(geomA, ST_Boundary(geomA)) As acontainspropba\n"
+"FROM (VALUES ( ST_Buffer(ST_Point(1,1), 5,1) ),\n"
+" ( ST_MakeLine(ST_Point(1,1), ST_Point(-1,-1) ) ),\n"
+" ( ST_Point(1,1) )\n"
+" ) As foo(geomA);\n"
+"\n"
+" geomtype | acontainsa | acontainspropa | acontainsba | acontainspropba\n"
+"--------------+------------+----------------+-------------"
+"+-----------------\n"
+"ST_Polygon | t | f | f | f\n"
+"ST_LineString | t | f | f | f\n"
+"ST_Point | t | t | f | f"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:938
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_ContainsProperly\"/>, <xref linkend=\"ST_Covers\"/>, "
+"<xref linkend=\"ST_CoveredBy\"/>, <xref linkend=\"ST_Equals\"/>, <xref "
+"linkend=\"ST_Within\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:944
+#, no-c-format
+msgid "ST_ContainsProperly"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:946
+#, no-c-format
+msgid ""
+"Returns true if B intersects the interior of A but not the boundary (or "
+"exterior). A does not contain properly itself, but does contain itself."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:951
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_ContainsProperly</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:966
+#, no-c-format
+msgid ""
+"Returns true if B intersects the interior of A but not the boundary (or "
+"exterior)."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:968
+#, no-c-format
+msgid "A does not contain properly itself, but does contain itself."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:969
+#, no-c-format
+msgid ""
+"Every point of the other geometry is a point of this geometry's interior. "
+"The DE-9IM Intersection Matrix for the two geometries matches [T**FF*FF*] "
+"used in <xref linkend=\"ST_Relate\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:973
+#, no-c-format
+msgid ""
+"From JTS docs slightly reworded: The advantage to using this predicate over "
+"<xref linkend=\"ST_Contains\"/> and <xref linkend=\"ST_Intersects\"/> is "
+"that it can be computed efficiently, with no need to compute topology at "
+"individual points."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:975
+#, no-c-format
+msgid ""
+"An example use case for this predicate is computing the intersections of a "
+"set of geometries with a large polygonal geometry. Since intersection is a "
+"fairly slow operation, it can be more efficient to use containsProperly to "
+"filter out test geometries which lie wholly inside the area. In these cases "
+"the intersection is known a priori to be exactly the original test geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:985
+#, no-c-format
+msgid "Availability: 1.4.0 - requires GEOS >= 3.1.0."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:995
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries. To avoid "
+"index use, use the function _ST_ContainsProperly."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1004
+#, no-c-format
+msgid ""
+"--a circle within a circle\n"
+" SELECT ST_ContainsProperly(smallc, bigc) As smallcontainspropbig,\n"
+" ST_ContainsProperly(bigc,smallc) As bigcontainspropsmall,\n"
+" ST_ContainsProperly(bigc, ST_Union(smallc, bigc)) as "
+"bigcontainspropunion,\n"
+" ST_Equals(bigc, ST_Union(smallc, bigc)) as bigisunion,\n"
+" ST_Covers(bigc, ST_ExteriorRing(bigc)) As bigcoversexterior,\n"
+" ST_ContainsProperly(bigc, ST_ExteriorRing(bigc)) As "
+"bigcontainsexterior\n"
+" FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As "
+"smallc,\n"
+" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;\n"
+" --Result\n"
+" smallcontainspropbig | bigcontainspropsmall | bigcontainspropunion | "
+"bigisunion | bigcoversexterior | bigcontainsexterior\n"
+"------------------+------------------+------------------+------------"
+"+-------------------+---------------------\n"
+" f | t | f | "
+"t | t | f\n"
+"\n"
+" --example demonstrating difference between contains and contains properly\n"
+" SELECT ST_GeometryType(geomA) As geomtype, ST_Contains(geomA,geomA) AS "
+"acontainsa, ST_ContainsProperly(geomA, geomA) AS acontainspropa,\n"
+" ST_Contains(geomA, ST_Boundary(geomA)) As acontainsba, "
+"ST_ContainsProperly(geomA, ST_Boundary(geomA)) As acontainspropba\n"
+" FROM (VALUES ( ST_Buffer(ST_Point(1,1), 5,1) ),\n"
+" ( ST_MakeLine(ST_Point(1,1), ST_Point(-1,-1) ) ),\n"
+" ( ST_Point(1,1) )\n"
+" ) As foo(geomA);\n"
+"\n"
+" geomtype | acontainsa | acontainspropa | acontainsba | acontainspropba\n"
+"--------------+------------+----------------+-------------"
+"+-----------------\n"
+"ST_Polygon | t | f | f | f\n"
+"ST_LineString | t | f | f | f\n"
+"ST_Point | t | t | f | f"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1009
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Boundary\"/>, <xref linkend=\"ST_Contains\"/>, <xref "
+"linkend=\"ST_Covers\"/>, <xref linkend=\"ST_CoveredBy\"/>, <xref linkend="
+"\"ST_Equals\"/>, <xref linkend=\"ST_Relate\"/>, <xref linkend=\"ST_Within\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1015
+#, no-c-format
+msgid "ST_Covers"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1017
+#, no-c-format
+msgid "Returns 1 (TRUE) if no point in Geometry B is outside Geometry A"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:1022
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Covers</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Covers</"
+"function></funcdef> <paramdef><type>geography </type> <parameter>geogpolyA</"
+"parameter></paramdef> <paramdef><type>geography </type> "
+"<parameter>geogpointB</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1047
+#, no-c-format
+msgid ""
+"Returns 1 (TRUE) if no point in Geometry/Geography B is outside Geometry/"
+"Geography A"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1057
+#, no-c-format
+msgid "For geography only Polygon covers point is supported."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1064
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries. To avoid "
+"index use, use the function _ST_Covers."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1069 reference_measure.xml:1141
+#, no-c-format
+msgid "Availability: 1.2.2 - requires GEOS >= 3.0"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1070
+#, no-c-format
+msgid "Availability: 1.5 - support for geography was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1075 reference_measure.xml:1150
+#, no-c-format
+msgid "Not an OGC standard, but Oracle has it too."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1082
+#, no-c-format
+msgid "Geometry example"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1083
+#, no-c-format
+msgid ""
+"--a circle covering a circle\n"
+"SELECT ST_Covers(smallc,smallc) As smallinsmall,\n"
+" ST_Covers(smallc, bigc) As smallcoversbig,\n"
+" ST_Covers(bigc, ST_ExteriorRing(bigc)) As bigcoversexterior,\n"
+" ST_Contains(bigc, ST_ExteriorRing(bigc)) As bigcontainsexterior\n"
+"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,\n"
+" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;\n"
+" --Result\n"
+" smallinsmall | smallcoversbig | bigcoversexterior | bigcontainsexterior\n"
+"--------------+----------------+-------------------+---------------------\n"
+" t | f | t | f\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1084
+#, no-c-format
+msgid "Geeography Example"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1085
+#, no-c-format
+msgid ""
+"-- a point with a 300 meter buffer compared to a point, a point and its 10 "
+"meter buffer\n"
+"SELECT ST_Covers(geog_poly, geog_pt) As poly_covers_pt, \n"
+" ST_Covers(ST_Buffer(geog_pt,10), geog_pt) As buff_10m_covers_cent\n"
+" FROM (SELECT ST_Buffer(ST_GeogFromText('SRID=4326;POINT(-99.327 "
+"31.4821)'), 300) As geog_poly,\n"
+" ST_GeogFromText('SRID=4326;POINT(-99.33 "
+"31.483)') As geog_pt ) As foo;\n"
+" \n"
+" poly_covers_pt | buff_10m_covers_cent\n"
+"----------------+------------------\n"
+" f | t"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1090
+#, no-c-format
+msgid ", <xref linkend=\"ST_CoveredBy\"/>, <xref linkend=\"ST_Within\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1096
+#, no-c-format
+msgid "ST_CoveredBy"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1098
+#, no-c-format
+msgid ""
+"<refpurpose>Returns 1 (TRUE) if no point in Geometry/Geography A is outside "
+"Geometry/Geography B</refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:1103
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_CoveredBy</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_CoveredBy</"
+"function></funcdef> <paramdef><type>geography </type> <parameter>geogA</"
+"parameter></paramdef> <paramdef><type>geography </type> <parameter>geogB</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1129
+#, no-c-format
+msgid ""
+"<para>Returns 1 (TRUE) if no point in Geometry/Geography A is outside "
+"Geometry/Geography B</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1142
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries. To avoid "
+"index use, use the function _ST_CoveredBy."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1157
+#, no-c-format
+msgid ""
+"--a circle coveredby a circle\n"
+"SELECT ST_CoveredBy(smallc,smallc) As smallinsmall,\n"
+" ST_CoveredBy(smallc, bigc) As smallcoveredbybig,\n"
+" ST_CoveredBy(ST_ExteriorRing(bigc), bigc) As exteriorcoveredbybig,\n"
+" ST_Within(ST_ExteriorRing(bigc),bigc) As exeriorwithinbig\n"
+"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,\n"
+" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;\n"
+" --Result\n"
+" smallinsmall | smallcoveredbybig | exteriorcoveredbybig | exeriorwithinbig\n"
+"--------------+-------------------+----------------------"
+"+------------------\n"
+" t | t | t | f\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1162
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Covers\"/>, <xref linkend=\"ST_ExteriorRing\"/>, <xref "
+"linkend=\"ST_Within\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1168
+#, no-c-format
+msgid "ST_Crosses"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1170
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if the supplied geometries have some, but "
+"not all, interior points in common."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1176
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Crosses</function></funcdef> "
+"<paramdef><type>geometry </type><parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type><parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1189
+#, no-c-format
+msgid ""
+"<function>ST_Crosses</function> takes two geometry objects and returns "
+"<varname>TRUE</varname> if their intersection \"spatially cross\", that is, "
+"the geometries have some, but not all interior points in common. The "
+"intersection of the interiors of the geometries must not be the empty set "
+"and must have a dimensionality less than the the maximum dimension of the "
+"two input geometries. Additionally, the intersection of the two geometries "
+"must not equal either of the source geometries. Otherwise, it returns "
+"<varname>FALSE</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1198
+#, no-c-format
+msgid "In mathematical terms, this is expressed as:"
+msgstr ""
+
+#. Tag: remark
+#: reference_measure.xml:1200
+#, no-c-format
+msgid ""
+"TODO: Insert appropriate MathML markup here or use a gif. Simple HTML markup "
+"does not work well in both IE and Firefox."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1211
+#, no-c-format
+msgid "The DE-9IM Intersection Matrix for the two geometries is:"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1215
+#, no-c-format
+msgid ""
+"<markup>T*T******</markup> (for Point/Line, Point/Area, and Line/Area "
+"situations)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1220
+#, no-c-format
+msgid ""
+"<markup>T*****T**</markup> (for Line/Point, Area/Point, and Area/Line "
+"situations)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1225
+#, no-c-format
+msgid "<markup>0********</markup> (for Line/Line situations)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1229
+#, no-c-format
+msgid "For any other combination of dimensions this predicate returns false."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1232
+#, no-c-format
+msgid ""
+"The OpenGIS Simple Features Specification defines this predicate only for "
+"Point/Line, Point/Area, Line/Line, and Line/Area situations. JTS / GEOS "
+"extends the definition to apply to Line/Point, Area/Point and Area/Line "
+"situations as well. This makes the relation symmetric."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1248
+#, no-c-format
+msgid "&sfs_compliant; s2.1.13.3"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1249
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.29"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1255 reference_measure.xml:2582
+#, no-c-format
+msgid "The following illustrations all return <varname>TRUE</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1267
+#, no-c-format
+msgid "<varname>MULTIPOINT</varname> / <varname>LINESTRING</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1277
+#, no-c-format
+msgid "<varname>MULTIPOINT</varname> / <varname>POLYGON</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1289
+#, no-c-format
+msgid "<varname>LINESTRING</varname> / <varname>POLYGON</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1299 reference_measure.xml:2602
+#: reference_measure.xml:3166 reference_measure.xml:3176
+#, no-c-format
+msgid "<varname>LINESTRING</varname> / <varname>LINESTRING</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1307
+#, no-c-format
+msgid ""
+"Consider a situation where a user has two tables: a table of roads and a "
+"table of highways."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1315
+#, no-c-format
+msgid ""
+"CREATE TABLE roads (\n"
+" id serial NOT NULL,\n"
+" the_geom geometry,\n"
+" CONSTRAINT roads_pkey PRIMARY KEY (road_id)\n"
+");"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1319
+#, no-c-format
+msgid ""
+"CREATE TABLE highways (\n"
+" id serial NOT NULL,\n"
+" the_gem geometry,\n"
+" CONSTRAINT roads_pkey PRIMARY KEY (road_id)\n"
+");"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1326
+#, no-c-format
+msgid ""
+"To determine a list of roads that cross a highway, use a query similiar to:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1330
+#, no-c-format
+msgid ""
+"SELECT roads.id\n"
+"FROM roads, highways\n"
+"WHERE ST_Crosses(roads.the_geom, highways.the_geom);"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1337
+#, no-c-format
+msgid "ST_LineCrossingDirection"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1339
+#, no-c-format
+msgid ""
+"Given 2 linestrings, returns a number between -3 and 3 denoting what kind of "
+"crossing behavior. 0 is no crossing."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1344
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_LineCrossingDirection</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>linestringA</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>linestringB</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1355
+#, no-c-format
+msgid ""
+"Given 2 linestrings, returns a number between -3 and 3 denoting what kind of "
+"crossing behavior. 0 is no crossing. This is only supported for "
+"<varname>LINESTRING</varname>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1356
+#, no-c-format
+msgid "Definition of integer constants is as follows:"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1359
+#, no-c-format
+msgid "0: LINE NO CROSS"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1362
+#, no-c-format
+msgid "-1: LINE CROSS LEFT"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1365
+#, no-c-format
+msgid "1: LINE CROSS RIGHT"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1368
+#, no-c-format
+msgid "-2: LINE MULTICROSS END LEFT"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1371
+#, no-c-format
+msgid "2: LINE MULTICROSS END RIGHT"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1374
+#, no-c-format
+msgid "-3: LINE MULTICROSS END SAME FIRST LEFT"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1377
+#, no-c-format
+msgid "3: LINE MULTICROSS END SAME FIRST RIGHT"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1381
+#, no-c-format
+msgid "Availability: 1.4"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1399
+#, no-c-format
+msgid ""
+"Line 1 (green), Line 2 ball is start point, triangle are end points. Query "
+"below."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1403
+#, no-c-format
+msgid ""
+"SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n"
+" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n"
+"FROM (\n"
+"SELECT\n"
+" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n"
+" ST_GeomFromText('LINESTRING(171 154,20 140,71 74,161 53)') As line2\n"
+" ) As foo;\n"
+"\n"
+" l1_cross_l2 | l2_cross_l1\n"
+"-------------+-------------\n"
+" 3 | -3"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1413 reference_measure.xml:1427
+#: reference_measure.xml:1441
+#, no-c-format
+msgid ""
+"Line 1 (green), Line 2 (blue) ball is start point, triangle are end points. "
+"Query below."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1417
+#, no-c-format
+msgid ""
+"SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n"
+" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n"
+"FROM (\n"
+" SELECT\n"
+" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n"
+" ST_GeomFromText('LINESTRING (171 154, 20 140, 71 74, 2.99 90.16)') As "
+"line2\n"
+") As foo;\n"
+"\n"
+" l1_cross_l2 | l2_cross_l1\n"
+"-------------+-------------\n"
+" 2 | -2"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1431
+#, no-c-format
+msgid ""
+"SELECT\n"
+" ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n"
+" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n"
+"FROM (\n"
+" SELECT\n"
+" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n"
+" ST_GeomFromText('LINESTRING (20 140, 71 74, 161 53)') As line2\n"
+" ) As foo;\n"
+"\n"
+" l1_cross_l2 | l2_cross_l1\n"
+"-------------+-------------\n"
+" -1 | 1"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1445
+#, no-c-format
+msgid ""
+"SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n"
+" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n"
+"FROM (SELECT\n"
+" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n"
+" ST_GeomFromText('LINESTRING(2.99 90.16,71 74,20 140,171 154)') As "
+"line2\n"
+" ) As foo;\n"
+"\n"
+" l1_cross_l2 | l2_cross_l1\n"
+"-------------+-------------\n"
+" -2 | 2"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1453
+#, no-c-format
+msgid ""
+"SELECT s1.gid, s2.gid, ST_LineCrossingDirection(s1.the_geom, s2.the_geom)\n"
+" FROM streets s1 CROSS JOIN streets s2 ON (s1.gid != s2.gid AND s1."
+"the_geom && s2.the_geom )\n"
+"WHERE ST_CrossingDirection(s1.the_geom, s2.the_geom) > 0;"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1466
+#, no-c-format
+msgid "ST_Disjoint"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1468
+#, no-c-format
+msgid ""
+"Returns TRUE if the Geometries do not \"spatially intersect\" - if they do "
+"not share any space together."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1474
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Disjoint</function></funcdef> <paramdef> "
+"<type>geometry</type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry</type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1489
+#, no-c-format
+msgid ""
+"Overlaps, Touches, Within all imply geometries are not spatially disjoint. "
+"If any of the aforementioned returns true, then the geometries are not "
+"spatially disjoint. Disjoint implies false for spatial intersection."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1499
+#, no-c-format
+msgid "This function call does not use indexes"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1506
+#, no-c-format
+msgid "&sfs_compliant; s2.1.1.2 //s2.1.13.3 - a.Relate(b, 'FF*FF****')"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1508
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.26"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1513
+#, no-c-format
+msgid ""
+"SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::"
+"geometry);\n"
+" st_disjoint\n"
+"---------------\n"
+" t\n"
+"(1 row)\n"
+"SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::"
+"geometry);\n"
+" st_disjoint\n"
+"---------------\n"
+" f\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1518
+#, no-c-format
+msgid "<para>ST_Intersects</para>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1524
+#, no-c-format
+msgid "ST_Distance"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1526
+#, no-c-format
+msgid ""
+"For geometry type Returns the 2-dimensional cartesian minimum distance "
+"(based on spatial ref) between two geometries in projected units. For "
+"geography type defaults to return spheroidal minimum distance between two "
+"geographies in meters."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:1530
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>float <function>ST_Distance</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>float <function>ST_Distance</"
+"function></funcdef> <paramdef><type>geography </type> <parameter>gg1</"
+"parameter></paramdef> <paramdef><type>geography </type> <parameter>gg2</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>float "
+"<function>ST_Distance</function></funcdef> <paramdef><type>geography </type> "
+"<parameter>gg1</parameter></paramdef> <paramdef><type>geography </type> "
+"<parameter>gg2</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>use_spheroid</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1568
+#, no-c-format
+msgid ""
+"For geometry type returns the 2-dimensional minimum cartesian distance "
+"between two geometries in projected units (spatial ref units). For geography "
+"type defaults to return the minimum distance around WGS 84 spheroid between "
+"two geographies in meters. Pass in false to return answer in sphere instead "
+"of spheroid."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1573
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.23"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1575
+#, no-c-format
+msgid ""
+"Availability: 1.5.0 geography support was introduced in 1.5. Speed "
+"improvements for planar to better handle large or many vertex geometries"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1576 reference_measure.xml:1939
+#, no-c-format
+msgid ""
+"Enhanced: 2.1.0 improved speed for geography. See <ulink url=\"http://blog."
+"opengeo.org/2012/07/12/making-geography-faster/\">Making Geography faster</"
+"ulink> for details."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1582
+#, no-c-format
+msgid ""
+"--Geometry example - units in planar degrees 4326 is WGS 84 long lat "
+"unit=degrees\n"
+"SELECT ST_Distance(\n"
+" ST_GeomFromText('POINT(-72.1235 42.3521)',4326),\n"
+" ST_GeomFromText('LINESTRING(-72.1260 42.45, -72.123 "
+"42.1546)', 4326)\n"
+" );\n"
+"st_distance\n"
+"-----------------\n"
+"0.00150567726382282\n"
+"\n"
+"-- Geometry example - units in meters (SRID: 26986 Massachusetts state plane "
+"meters) (most accurate for Massachusetts)\n"
+"SELECT ST_Distance(\n"
+" ST_Transform(ST_GeomFromText('POINT(-72.1235 "
+"42.3521)',4326),26986),\n"
+" ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 "
+"42.45, -72.123 42.1546)', 4326),26986)\n"
+" );\n"
+"st_distance\n"
+"-----------------\n"
+"123.797937878454\n"
+"\n"
+"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal "
+"area) (least accurate)\n"
+"SELECT ST_Distance(\n"
+" ST_Transform(ST_GeomFromText('POINT(-72.1235 "
+"42.3521)',4326),2163),\n"
+" ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 "
+"42.45, -72.123 42.1546)', 4326),2163)\n"
+" );\n"
+"\n"
+"st_distance\n"
+"------------------\n"
+"126.664256056812\n"
+"\n"
+"-- Geography example -- same but note units in meters - use sphere for "
+"slightly faster less accurate\n"
+"SELECT ST_Distance(gg1, gg2) As spheroid_dist, ST_Distance(gg1, gg2, false) "
+"As sphere_dist \n"
+"FROM (SELECT\n"
+" ST_GeographyFromText('SRID=4326;POINT(-72.1235 42.3521)') As gg1,\n"
+" ST_GeographyFromText('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 "
+"42.1546)') As gg2\n"
+" ) As foo ;\n"
+"\n"
+" spheroid_dist | sphere_dist\n"
+"------------------+------------------\n"
+" 123.802076746848 | 123.475736916397"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1588
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_DWithin\"/>, <xref linkend=\"ST_Distance_Sphere\"/>, "
+"<xref linkend=\"ST_Distance_Spheroid\"/>, <xref linkend=\"ST_MaxDistance\"/"
+">, <xref linkend=\"ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1594
+#, no-c-format
+msgid "ST_HausdorffDistance"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1596
+#, no-c-format
+msgid ""
+"Returns the Hausdorff distance between two geometries. Basically a measure "
+"of how similar or dissimilar 2 geometries are. Units are in the units of the "
+"spatial reference system of the geometries."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:1601
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>float <function>ST_HausdorffDistance</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>g1</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>g2</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>float "
+"<function>ST_HausdorffDistance</function></funcdef> <paramdef><type>geometry "
+"</type> <parameter>g1</parameter></paramdef> <paramdef><type>geometry </"
+"type> <parameter>g2</parameter></paramdef> <paramdef><type>float</type> "
+"<parameter>densifyFrac</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1629
+#, no-c-format
+msgid ""
+"Implements algorithm for computing a distance metric which can be thought of "
+"as the \"Discrete Hausdorff Distance\". This is the Hausdorff distance "
+"restricted to discrete points for one of the geometries. <ulink url=\"http://"
+"en.wikipedia.org/wiki/Hausdorff_distance\">Wikipedia article on Hausdorff "
+"distance</ulink> <ulink url=\"http://lin-ear-th-inking.blogspot.com/2009/01/"
+"computing-geometric-similarity.html\">Martin Davis note on how Hausdorff "
+"Distance calculation was used to prove correctness of the "
+"CascadePolygonUnion approach.</ulink>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1632
+#, no-c-format
+msgid ""
+"When densifyFrac is specified, this function performs a segment "
+"densification before computing the discrete hausdorff distance. The "
+"densifyFrac parameter sets the fraction by which to densify each segment. "
+"Each segment will be split into a number of equal-length subsegments, whose "
+"fraction of the total length is closest to the given fraction."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1637
+#, no-c-format
+msgid ""
+"The current implementation supports only vertices as the discrete locations. "
+"This could be extended to allow an arbitrary density of points to be used."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1642
+#, no-c-format
+msgid ""
+"This algorithm is NOT equivalent to the standard Hausdorff distance. "
+"However, it computes an approximation that is correct for a large subset of "
+"useful cases. One important part of this subset is Linestrings that are "
+"roughly parallel to each other, and roughly equal in length. This is a "
+"useful metric for line matching."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1647
+#, no-c-format
+msgid "Availability: 1.5.0 - requires GEOS >= 3.2.0"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1654
+#, no-c-format
+msgid ""
+"postgis=# SELECT st_HausdorffDistance(\n"
+" 'LINESTRING (0 0, 2 0)'::geometry,\n"
+" 'MULTIPOINT (0 1, 1 0, 2 1)'::geometry);\n"
+" st_hausdorffdistance\n"
+" ----------------------\n"
+" 1\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1655
+#, no-c-format
+msgid ""
+"postgis=# SELECT st_hausdorffdistance('LINESTRING (130 0, 0 0, 0 150)'::"
+"geometry, 'LINESTRING (10 10, 10 150, 130 10)'::geometry, 0.5);\n"
+" st_hausdorffdistance\n"
+" ----------------------\n"
+" 70\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1662
+#, no-c-format
+msgid "ST_MaxDistance"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1664
+#, no-c-format
+msgid ""
+"Returns the 2-dimensional largest distance between two geometries in "
+"projected units."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1670
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_MaxDistance</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1681
+#, no-c-format
+msgid "Some useful description here."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1685
+#, no-c-format
+msgid ""
+"Returns the 2-dimensional maximum distance between two linestrings in "
+"projected units. If g1 and g2 is the same geometry the function will return "
+"the distance between the two vertices most far from each other in that "
+"geometry."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1695
+#, no-c-format
+msgid ""
+"postgis=# SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 "
+"2 )'::geometry);\n"
+" st_maxdistance\n"
+"-----------------\n"
+" 2\n"
+"(1 row)\n"
+"\n"
+"postgis=# SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 2, 2 "
+"2 )'::geometry);\n"
+" st_maxdistance \n"
+"------------------\n"
+" 2.82842712474619\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1701
+#, no-c-format
+msgid ", <xref linkend=\"ST_LongestLine\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1707
+#, no-c-format
+msgid "ST_Distance_Sphere"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1709
+#, no-c-format
+msgid ""
+"Returns minimum distance in meters between two lon/lat geometries. Uses a "
+"spherical earth and radius of 6370986 meters. Faster than "
+"ST_Distance_Spheroid <xref linkend=\"ST_Distance_Spheroid\"/>, but less "
+"accurate. PostGIS versions prior to 1.5 only implemented for points."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1717
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Distance_Sphere</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomlonlatA</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>geomlonlatB</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1728
+#, no-c-format
+msgid ""
+"Returns minimum distance in meters between two lon/lat points. Uses a "
+"spherical earth and radius of 6370986 meters. Faster than <xref linkend="
+"\"ST_Distance_Spheroid\"/>, but less accurate. PostGIS Versions prior to 1.5 "
+"only implemented for points."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1733
+#, no-c-format
+msgid ""
+"This function currently does not look at the SRID of a geometry and will "
+"always assume its in WGS 84 long lat. Prior versions of this function only "
+"support points."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1736 reference_measure.xml:1784
+#, no-c-format
+msgid ""
+"Availability: 1.5 - support for other geometry types besides points was "
+"introduced. Prior versions only work with points."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1743
+#, no-c-format
+msgid ""
+"SELECT round(CAST(ST_Distance_Sphere(ST_Centroid(the_geom), "
+"ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters,\n"
+"round(CAST(ST_Distance(ST_Transform(ST_Centroid(the_geom),32611),\n"
+" ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) "
+"As numeric),2) As dist_utm11_meters,\n"
+"round(CAST(ST_Distance(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 "
+"38)', 4326)) As numeric),5) As dist_degrees,\n"
+"round(CAST(ST_Distance(ST_Transform(the_geom,32611),\n"
+" ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) "
+"As numeric),2) As min_dist_line_point_meters\n"
+"FROM\n"
+" (SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', "
+"4326) As the_geom) as foo;\n"
+" dist_meters | dist_utm11_meters | dist_degrees | "
+"min_dist_line_point_meters\n"
+" -------------+-------------------+--------------"
+"+----------------------------\n"
+" 70424.47 | 70438.00 | 0.72900 "
+"| 65871.18"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1750
+#, no-c-format
+msgid ", <xref linkend=\"ST_Distance_Spheroid\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1756
+#, no-c-format
+msgid "ST_Distance_Spheroid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1758
+#, no-c-format
+msgid ""
+"Returns the minimum distance between two lon/lat geometries given a "
+"particular spheroid. PostGIS versions prior to 1.5 only support points."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1765
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Distance_Spheroid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomlonlatA</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>geomlonlatB</"
+"parameter></paramdef> <paramdef><type>spheroid </type> "
+"<parameter>measurement_spheroid</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1777
+#, no-c-format
+msgid ""
+"Returns minimum distance in meters between two lon/lat geometries given a "
+"particular spheroid. See the explanation of spheroids given for <xref "
+"linkend=\"ST_Length_Spheroid\"/>. PostGIS version prior to 1.5 only support "
+"points."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1781
+#, no-c-format
+msgid ""
+"This function currently does not look at the SRID of a geometry and will "
+"always assume its represented in the coordinates of the passed in spheroid. "
+"Prior versions of this function only support points."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1791
+#, no-c-format
+msgid ""
+"SELECT round(CAST(\n"
+" ST_Distance_Spheroid(ST_Centroid(the_geom), "
+"ST_GeomFromText('POINT(-118 38)',4326), 'SPHEROID[\"WGS "
+"84\",6378137,298.257223563]')\n"
+" As numeric),2) As dist_meters_spheroid,\n"
+" round(CAST(ST_Distance_Sphere(ST_Centroid(the_geom), "
+"ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As "
+"dist_meters_sphere,\n"
+"round(CAST(ST_Distance(ST_Transform(ST_Centroid(the_geom),32611),\n"
+" ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) "
+"As numeric),2) As dist_utm11_meters\n"
+"FROM\n"
+" (SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', "
+"4326) As the_geom) as foo;\n"
+" dist_meters_spheroid | dist_meters_sphere | dist_utm11_meters\n"
+"----------------------+--------------------+-------------------\n"
+" 70454.92 | 70424.47 | 70438.00"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1798
+#, no-c-format
+msgid ", <xref linkend=\"ST_Distance_Sphere\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1804
+#, no-c-format
+msgid "ST_DFullyWithin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1806
+#, no-c-format
+msgid ""
+"Returns true if all of the geometries are within the specified distance of "
+"one another"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1812
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_DFullyWithin</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>distance</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1830
+#, no-c-format
+msgid ""
+"Returns true if the geometries is fully within the specified distance of one "
+"another. The distance is specified in units defined by the spatial reference "
+"system of the geometries. For this function to make sense, the source "
+"geometries must both be of the same coordinate projection, having the same "
+"SRID."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1847
+#, no-c-format
+msgid ""
+"postgis=# SELECT ST_DFullyWithin(geom_a, geom_b, 10) as DFullyWithin10, "
+"ST_DWithin(geom_a, geom_b, 10) as DWithin10, ST_DFullyWithin(geom_a, geom_b, "
+"20) as DFullyWithin20 from \n"
+" (select ST_GeomFromText('POINT(1 1)') as geom_a,"
+"ST_GeomFromText('LINESTRING(1 5, 2 7, 1 9, 14 12)') as geom_b) t1;\n"
+" \n"
+"-----------------\n"
+" DFullyWithin10 | DWithin10 | DFullyWithin20 |\n"
+"---------------+----------+---------------+\n"
+" f | t | t |"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1853
+#, no-c-format
+msgid ", <xref linkend=\"ST_DWithin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1859
+#, no-c-format
+msgid "ST_DWithin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1861
+#, no-c-format
+msgid ""
+"Returns true if the geometries are within the specified distance of one "
+"another. For geometry units are in those of spatial reference and For "
+"geography units are in meters and measurement is defaulted to "
+"use_spheroid=true (measure around spheroid), for faster check, "
+"use_spheroid=false to measure along sphere."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:1867
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_DWithin</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>distance_of_srid</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>ST_DWithin</function></funcdef> <paramdef><type>geography </type> "
+"<parameter>gg1</parameter></paramdef> <paramdef><type>geography </type> "
+"<parameter>gg2</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>distance_meters</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>boolean <function>ST_DWithin</function></funcdef> "
+"<paramdef><type>geography </type> <parameter>gg1</parameter></paramdef> "
+"<paramdef><type>geography </type> <parameter>gg2</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>distance_meters</"
+"parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>use_spheroid</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1912
+#, no-c-format
+msgid ""
+"Returns true if the geometries are within the specified distance of one "
+"another."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1914
+#, no-c-format
+msgid ""
+"For Geometries: The distance is specified in units defined by the spatial "
+"reference system of the geometries. For this function to make sense, the "
+"source geometries must both be of the same coordinate projection, having the "
+"same SRID."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1919
+#, no-c-format
+msgid ""
+"For geography units are in meters and measurement is defaulted to "
+"use_spheroid=true (measure around WGS 84 spheroid), for faster check, "
+"use_spheroid=false to measure along sphere."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1929
+#, no-c-format
+msgid ""
+"Prior to 1.3, ST_Expand was commonly used in conjunction with && and "
+"ST_Distance to achieve the same effect and in pre-1.3.4 this function was "
+"basically short-hand for that construct. From 1.3.4, ST_DWithin uses a more "
+"short-circuit distance function which should make it more efficient than "
+"prior versions for larger buffer regions."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1935
+#, no-c-format
+msgid "Use ST_3DDWithin if you have 3D geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1938
+#, no-c-format
+msgid "Availability: 1.5.0 support for geography was introduced"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1944
+#, no-c-format
+msgid ""
+"--Find the nearest hospital to each school\n"
+"--that is within 3000 units of the school.\n"
+"-- We do an ST_DWithin search to utilize indexes to limit our search list\n"
+"-- that the non-indexable ST_Distance needs to process\n"
+"--If the units of the spatial reference is meters then units would be "
+"meters\n"
+"SELECT DISTINCT ON (s.gid) s.gid, s.school_name, s.the_geom, h."
+"hospital_name\n"
+" FROM schools s\n"
+" LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.the_geom, "
+"3000)\n"
+" ORDER BY s.gid, ST_Distance(s.the_geom, h.the_geom);\n"
+"\n"
+"--The schools with no close hospitals\n"
+"--Find all schools with no hospital within 3000 units\n"
+"--away from the school. Units is in units of spatial ref (e.g. meters, "
+"feet, degrees)\n"
+"SELECT s.gid, s.school_name\n"
+" FROM schools s\n"
+" LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.the_geom, "
+"3000)\n"
+" WHERE h.gid IS NULL;"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1950
+#, no-c-format
+msgid ", <xref linkend=\"ST_Expand\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:1956
+#, no-c-format
+msgid "ST_Equals"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:1958
+#, no-c-format
+msgid ""
+"Returns true if the given geometries represent the same geometry. "
+"Directionality is ignored."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:1964
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Equals</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>A</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>B</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1975
+#, no-c-format
+msgid ""
+"Returns TRUE if the given Geometries are \"spatially equal\". Use this for a "
+"'better' answer than '='. Note by spatially equal we mean ST_Within(A,B) = "
+"true and ST_Within(B,A) = true and also mean ordering of points can be "
+"different but represent the same geometry structure. To verify the order of "
+"points is consistent, use ST_OrderingEquals (it must be noted "
+"ST_OrderingEquals is a little more stringent than simply verifying order of "
+"points are the same)."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1984
+#, no-c-format
+msgid ""
+"This function will return false if either geometry is invalid even if they "
+"are binary equal."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1987
+#, no-c-format
+msgid "&sfs_compliant; s2.1.1.2"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:1988
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.24"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:1994
+#, no-c-format
+msgid ""
+"SELECT ST_Equals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n"
+" ST_GeomFromText('LINESTRING(0 0, 5 5, 10 10)'));\n"
+" st_equals\n"
+"-----------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_Equals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 10)')),\n"
+" ST_GeomFromText('LINESTRING(0 0, 5 5, 10 10)'));\n"
+" st_equals\n"
+"-----------\n"
+" t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2000
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_OrderingEquals\"/>, <xref linkend=\"ST_Reverse\"/>, "
+"<xref linkend=\"ST_Within\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2007
+#, no-c-format
+msgid "ST_HasArc"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2009
+#, no-c-format
+msgid ""
+"<refpurpose>Returns true if a geometry or geometry collection contains a "
+"circular string</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2014
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_HasArc</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2024
+#, no-c-format
+msgid ""
+"<para>Returns true if a geometry or geometry collection contains a circular "
+"string</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2026
+#, no-c-format
+msgid "Availability: 1.2.3?"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2028
+#, no-c-format
+msgid "&curve_support;"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2035
+#, no-c-format
+msgid ""
+"SELECT ST_HasArc(ST_Collect('LINESTRING(1 2, 3 4, 5 6)', 'CIRCULARSTRING(1 "
+"1, 2 3, 4 5, 6 7, 5 6)'));\n"
+" st_hasarc\n"
+" --------\n"
+" t"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2042
+#, no-c-format
+msgid ", <xref linkend=\"ST_LineToCurve\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2048
+#, no-c-format
+msgid "<refname>ST_Intersects</refname>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2050
+#, no-c-format
+msgid ""
+"Returns TRUE if the Geometries/Geography \"spatially intersect in 2D\" - "
+"(share any portion of space) and FALSE if they don't (they are Disjoint). "
+"For geography -- tolerance is 0.00001 meters (so any points that close are "
+"considered to intersect)"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:2056
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Intersects</function></"
+"funcdef> <paramdef> <type>geometry</type> <parameter>geomA</parameter> </"
+"paramdef> <paramdef> <type>geometry</type> <parameter>geomB</parameter> </"
+"paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>ST_Intersects</function></funcdef> <paramdef> <type>geography</"
+"type> <parameter>geogA</parameter> </paramdef> <paramdef> <type>geography</"
+"type> <parameter>geogB</parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2088
+#, no-c-format
+msgid ""
+"Do not call with a <varname>GEOMETRYCOLLECTION</varname> as an argument for "
+"geometry version. The geography version supports GEOMETRYCOLLECTION since "
+"its a thin wrapper around distance implementation."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2092
+#, no-c-format
+msgid "Performed by the GEOS module (for geometry), geography is native"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2093
+#, no-c-format
+msgid "Availability: 1.5 support for geography was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2100
+#, no-c-format
+msgid ""
+"For geography, this function has a distance tolerance of about 0.00001 "
+"meters and uses the sphere rather than spheroid calculation."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2107
+#, no-c-format
+msgid ""
+"&sfs_compliant; s2.1.1.2 //s2.1.13.3 - ST_Intersects(g1, g2 ) --> Not "
+"(ST_Disjoint(g1, g2 ))"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2110
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.27"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2114
+#, no-c-format
+msgid ""
+"SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::"
+"geometry);\n"
+" st_intersects\n"
+"---------------\n"
+" f\n"
+"(1 row)\n"
+"SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::"
+"geometry);\n"
+" st_intersects\n"
+"---------------\n"
+" t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: title
+#: reference_measure.xml:2117 reference_measure.xml:2167
+#, no-c-format
+msgid "Geography Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2118
+#, no-c-format
+msgid ""
+"SELECT ST_Intersects(\n"
+" ST_GeographyFromText('SRID=4326;LINESTRING(-43.23456 "
+"72.4567,-43.23456 72.4568)'),\n"
+" ST_GeographyFromText('SRID=4326;POINT(-43.23456 "
+"72.4567772)')\n"
+" );\n"
+"\n"
+" st_intersects\n"
+"---------------\n"
+"t"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2122
+#, no-c-format
+msgid ", <xref linkend=\"ST_Disjoint\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2127
+#, no-c-format
+msgid "ST_Length"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2129
+#, no-c-format
+msgid ""
+"Returns the 2d length of the geometry if it is a linestring or "
+"multilinestring. geometry are in units of spatial reference and geography "
+"are in meters (default spheroid)"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:2132
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>float <function>ST_Length</function></funcdef> "
+"<paramdef><type>geometry </type><parameter>a_2dlinestring</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>float "
+"<function>ST_Length</function></funcdef> <paramdef><type>geography </"
+"type><parameter>geog</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type><parameter>use_spheroid=true</parameter></paramdef> "
+"</funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2147
+#, no-c-format
+msgid ""
+"For geometry: Returns the cartesian 2D length of the geometry if it is a "
+"linestring, multilinestring, ST_Curve, ST_MultiCurve. 0 is returned for "
+"areal geometries. For areal geometries use ST_Perimeter. Geometry: "
+"Measurements are in the units of the spatial reference system of the "
+"geometry. Geography: Units are in meters and also acts as a Perimeter "
+"function for areal geogs."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2151
+#, no-c-format
+msgid ""
+"Currently for geometry this is an alias for ST_Length2D, but this may change "
+"to support higher dimensions."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2152
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 Breaking change -- in prior versions applying this to a MULTI/"
+"POLYGON of type geography would give you the perimeter of the POLYGON/"
+"MULTIPOLYGON. In 2.0.0 this was changed to return 0 to be in line with "
+"geometry behavior. Please use ST_Perimeter if you want the perimeter of a "
+"polygon"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2154
+#, no-c-format
+msgid ""
+"For geography measurement defaults spheroid measurement. To use the faster "
+"less accurate sphere use ST_Length(gg,false);"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2155 reference_measure.xml:2660
+#, no-c-format
+msgid "&sfs_compliant; s2.1.5.1"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2156
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.1.2, 9.3.4"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2157
+#, no-c-format
+msgid "Availability: 1.5.0 geography support was introduced in 1.5."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2162
+#, no-c-format
+msgid ""
+"Return length in feet for line string. Note this is in feet because 2249 is "
+"Mass State Plane Feet"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2164
+#, no-c-format
+msgid ""
+"SELECT ST_Length(ST_GeomFromText('LINESTRING(743238 2967416,743238 "
+"2967450,743265 2967450,\n"
+"743265.625 2967416,743238 2967416)',2249));\n"
+"st_length\n"
+"---------\n"
+" 122.630744000095\n"
+"\n"
+"\n"
+"--Transforming WGS 84 linestring to Massachusetts state plane meters\n"
+"SELECT ST_Length(\n"
+" ST_Transform(\n"
+" ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45, "
+"-72.1240 42.45666, -72.123 42.1546)'),\n"
+" 26986\n"
+" )\n"
+");\n"
+"st_length\n"
+"---------\n"
+"34309.4563576191"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2168
+#, no-c-format
+msgid "Return length of WGS 84 geography line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2169
+#, no-c-format
+msgid ""
+"-- default calculation is using a sphere rather than spheroid\n"
+"SELECT ST_Length(the_geog) As length_spheroid, ST_Length(the_geog,false) As "
+"length_sphere\n"
+"FROM (SELECT ST_GeographyFromText(\n"
+"'SRID=4326;LINESTRING(-72.1260 42.45, -72.1240 42.45666, -72.123 42.1546)') "
+"As the_geog)\n"
+" As foo;\n"
+" length_spheroid | length_sphere\n"
+"------------------+------------------\n"
+" 34310.5703627305 | 34346.2060960742\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2173
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeomFromEWKT\"/>, <xref linkend=\"ST_Length_Spheroid\"/"
+">, <xref linkend=\"ST_Perimeter\"/>, <xref linkend=\"ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2179
+#, no-c-format
+msgid "ST_Length2D"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2181
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the 2-dimensional length of the geometry if it is a "
+"linestring or multi-linestring. This is an alias for <varname>ST_Length</"
+"varname></refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2187
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Length2D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_2dlinestring</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2197
+#, no-c-format
+msgid ""
+"<para>Returns the 2-dimensional length of the geometry if it is a linestring "
+"or multi-linestring. This is an alias for <varname>ST_Length</varname></para>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2206
+#, no-c-format
+msgid ", <xref linkend=\"ST_3DLength\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2212
+#, no-c-format
+msgid "ST_3DLength"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2214
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional or 2-dimensional length of the geometry if it is a "
+"linestring or multi-linestring."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2220
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_3DLength</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_3dlinestring</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2230
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional or 2-dimensional length of the geometry if it is a "
+"linestring or multi-linestring. For 2-d lines it will just return the 2-d "
+"length (same as ST_Length and ST_Length2D)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2233
+#, no-c-format
+msgid "Changed: 2.0.0 In prior versions this used to be called ST_Length3D"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2240
+#, no-c-format
+msgid ""
+"Return length in feet for a 3D cable. Note this is in feet because 2249 is "
+"Mass State Plane Feet"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2242
+#, no-c-format
+msgid ""
+"SELECT ST_3DLength(ST_GeomFromText('LINESTRING(743238 2967416 1,743238 "
+"2967450 1,743265 2967450 3,\n"
+"743265.625 2967416 3,743238 2967416 3)',2249));\n"
+"ST_3DLength\n"
+"-----------\n"
+"122.704716741457"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2249
+#, no-c-format
+msgid ", <xref linkend=\"ST_Length2D\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2255
+#, no-c-format
+msgid "ST_Length_Spheroid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2257
+#, no-c-format
+msgid ""
+"Calculates the 2D or 3D length of a linestring/multilinestring on an "
+"ellipsoid. This is useful if the coordinates of the geometry are in "
+"longitude/latitude and a length is desired without reprojection."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2264
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Length_Spheroid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>spheroid </type> <parameter>a_spheroid</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2275
+#, no-c-format
+msgid ""
+"Calculates the length of a geometry on an ellipsoid. This is useful if the "
+"coordinates of the geometry are in longitude/latitude and a length is "
+"desired without reprojection. The ellipsoid is a separate database type and "
+"can be constructed as follows:"
+msgstr ""
+
+#. Tag: literallayout
+#: reference_measure.xml:2281 reference_measure.xml:2333
+#, no-c-format
+msgid ""
+"SPHEROID[<NAME>,<SEMI-MAJOR\n"
+" AXIS>,<INVERSE FLATTENING>]"
+msgstr ""
+
+#. Tag: literallayout
+#: reference_measure.xml:2284 reference_measure.xml:2336
+#, no-c-format
+msgid "SPHEROID[\"GRS_1980\",6378137,298.257222101]"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2285 reference_measure.xml:2337
+#, no-c-format
+msgid "Will return 0 for anything that is not a MULTILINESTRING or LINESTRING"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2294
+#, no-c-format
+msgid ""
+"SELECT ST_Length_Spheroid( geometry_column,\n"
+" 'SPHEROID[\"GRS_1980\",6378137,298.257222101]' )\n"
+" FROM geometry_table;\n"
+"\n"
+"SELECT ST_Length_Spheroid( the_geom, sph_m ) As tot_len,\n"
+"ST_Length_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n"
+"ST_Length_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n"
+" FROM (SELECT "
+"ST_GeomFromText('MULTILINESTRING((-118.584 38.374,-118.583 38.5),\n"
+" (-71.05957 42.3589 , -71.061 43))') As the_geom,\n"
+"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) "
+"as foo;\n"
+" tot_len | len_line1 | len_line2\n"
+"------------------+------------------+------------------\n"
+" 85204.5207562955 | 13986.8725229309 | 71217.6482333646\n"
+"\n"
+" --3D\n"
+"SELECT ST_Length_Spheroid( the_geom, sph_m ) As tot_len,\n"
+"ST_Length_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n"
+"ST_Length_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n"
+" FROM (SELECT "
+"ST_GeomFromEWKT('MULTILINESTRING((-118.584 38.374 20,-118.583 38.5 30),\n"
+" (-71.05957 42.3589 75, -71.061 43 90))') As the_geom,\n"
+"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) "
+"as foo;\n"
+"\n"
+" tot_len | len_line1 | len_line2\n"
+"------------------+-----------------+------------------\n"
+" 85204.5259107402 | 13986.876097711 | 71217.6498130292"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2301
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Length\"/>, <xref linkend=\"ST_3DLength_Spheroid\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2307
+#, no-c-format
+msgid "ST_Length2D_Spheroid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2309
+#, no-c-format
+msgid ""
+"Calculates the 2D length of a linestring/multilinestring on an ellipsoid. "
+"This is useful if the coordinates of the geometry are in longitude/latitude "
+"and a length is desired without reprojection."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2316
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Length2D_Spheroid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>spheroid </type> <parameter>a_spheroid</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2327
+#, no-c-format
+msgid ""
+"Calculates the 2D length of a geometry on an ellipsoid. This is useful if "
+"the coordinates of the geometry are in longitude/latitude and a length is "
+"desired without reprojection. The ellipsoid is a separate database type and "
+"can be constructed as follows:"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2338
+#, no-c-format
+msgid ""
+"This is much like <xref linkend=\"ST_Length_Spheroid\"/> and <xref linkend="
+"\"ST_3DLength_Spheroid\"/> except it will throw away the Z coordinate in "
+"calculations."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2346
+#, no-c-format
+msgid ""
+"SELECT ST_Length2D_Spheroid( geometry_column,\n"
+" 'SPHEROID[\"GRS_1980\",6378137,298.257222101]' )\n"
+" FROM geometry_table;\n"
+"\n"
+"SELECT ST_Length2D_Spheroid( the_geom, sph_m ) As tot_len,\n"
+"ST_Length2D_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n"
+"ST_Length2D_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n"
+" FROM (SELECT "
+"ST_GeomFromText('MULTILINESTRING((-118.584 38.374,-118.583 38.5),\n"
+" (-71.05957 42.3589 , -71.061 43))') As the_geom,\n"
+"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) "
+"as foo;\n"
+" tot_len | len_line1 | len_line2\n"
+"------------------+------------------+------------------\n"
+" 85204.5207562955 | 13986.8725229309 | 71217.6482333646\n"
+"\n"
+" --3D Observe same answer\n"
+"SELECT ST_Length2D_Spheroid( the_geom, sph_m ) As tot_len,\n"
+"ST_Length2D_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n"
+"ST_Length2D_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n"
+" FROM (SELECT "
+"ST_GeomFromEWKT('MULTILINESTRING((-118.584 38.374 20,-118.583 38.5 30),\n"
+" (-71.05957 42.3589 75, -71.061 43 90))') As the_geom,\n"
+"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) "
+"as foo;\n"
+"\n"
+" tot_len | len_line1 | len_line2\n"
+"------------------+------------------+------------------\n"
+" 85204.5207562955 | 13986.8725229309 | 71217.6482333646"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2353
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Length_Spheroid\"/>, <xref linkend="
+"\"ST_3DLength_Spheroid\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2359
+#, no-c-format
+msgid "ST_3DLength_Spheroid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2361
+#, no-c-format
+msgid ""
+"<refpurpose>Calculates the length of a geometry on an ellipsoid, taking the "
+"elevation into account. This is just an alias for ST_Length_Spheroid.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2367
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_3DLength_Spheroid</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_linestring</parameter></"
+"paramdef> <paramdef><type>spheroid </type> <parameter>a_spheroid</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2378
+#, no-c-format
+msgid ""
+"<para>Calculates the length of a geometry on an ellipsoid, taking the "
+"elevation into account. This is just an alias for ST_Length_Spheroid.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2382
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 In prior versions this used to return 0 for anything that is "
+"not a MULTILINESTRING or LINESTRING and in 2.0.0 on returns the perimeter of "
+"if given a polgon."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2383
+#, no-c-format
+msgid "This function is just an alias for ST_Length_Spheroid."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2385
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 In prior versions this used to be called ST_Length3d_Spheroid"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2392
+#, no-c-format
+msgid "See ST_Length_Spheroid"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2399
+#, no-c-format
+msgid ", <xref linkend=\"ST_Length\"/>, <xref linkend=\"ST_Length_Spheroid\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2405
+#, no-c-format
+msgid "ST_LongestLine"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2407
+#, no-c-format
+msgid ""
+"Returns the 2-dimensional longest line points of two geometries. The "
+"function will only return the first longest line if more than one, that the "
+"function finds. The line returned will always start in g1 and end in g2. The "
+"length of the line this function returns will always be the same as "
+"st_maxdistance returns for g1 and g2."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2415
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_LongestLine</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2430
+#, no-c-format
+msgid ""
+"Returns the 2-dimensional longest line between the points of two geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2448
+#, no-c-format
+msgid "Longest line between point and line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2451
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_LongestLine('POINT(100 100)'::geometry, \n"
+" 'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry)\n"
+" ) As lline;\n"
+"\n"
+" \n"
+" lline\n"
+"-----------------\n"
+"LINESTRING(100 100,98 190)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2459
+#, no-c-format
+msgid "longest line between polygon and polygon"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2462
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_LongestLine(\n"
+" ST_GeomFromText('POLYGON((175 150, 20 40, \n"
+" 50 60, 125 100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" ) \n"
+" ) As llinewkt;\n"
+" \n"
+" lline\n"
+"-----------------\n"
+"LINESTRING(20 40,121.111404660392 186.629392246051)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2478
+#, no-c-format
+msgid ""
+"longest straight distance to travel from one part of an elegant city to the "
+"other Note the max distance = to the length of the line."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2482
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_LongestLine(c.the_geom, c.the_geom)) As llinewkt, \n"
+" ST_MaxDistance(c.the_geom,c.the_geom) As max_dist, \n"
+" ST_Length(ST_LongestLine(c.the_geom, c.the_geom)) As lenll \n"
+"FROM (SELECT ST_BuildArea(ST_Collect(the_geom)) As the_geom\n"
+" FROM (SELECT ST_Translate(ST_SnapToGrid(ST_Buffer(ST_Point(50 ,"
+"generate_series(50,190, 50) \n"
+" ),40, 'quad_segs=2'),1), x, 0) As the_geom \n"
+" FROM generate_series(1,100,50) As x) AS foo\n"
+") As c;\n"
+" \n"
+" llinewkt | max_dist | lenll\n"
+"---------------------------+------------------+------------------\n"
+" LINESTRING(23 22,129 178) | 188.605408193933 | 188.605408193933"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2493
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_ShortestLine\"/>, <xref linkend=\"ST_LongestLine\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2499
+#, no-c-format
+msgid "ST_OrderingEquals"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2501
+#, no-c-format
+msgid ""
+"Returns true if the given geometries represent the same geometry and points "
+"are in the same directional order."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2507
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_OrderingEquals</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>A</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>B</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2518
+#, no-c-format
+msgid ""
+"ST_OrderingEquals compares two geometries and returns t (TRUE) if the "
+"geometries are equal and the coordinates are in the same order; otherwise it "
+"returns f (FALSE)."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2523
+#, no-c-format
+msgid ""
+"This function is implemented as per the ArcSDE SQL specification rather than "
+"SQL-MM. http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3."
+"htm#ST_OrderingEquals"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2527
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.43"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2533
+#, no-c-format
+msgid ""
+"SELECT ST_OrderingEquals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n"
+" ST_GeomFromText('LINESTRING(0 0, 5 5, 10 10)'));\n"
+" st_orderingequals\n"
+"-----------\n"
+" f\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_OrderingEquals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n"
+" ST_GeomFromText('LINESTRING(0 0, 0 0, 10 10)'));\n"
+" st_orderingequals\n"
+"-----------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_OrderingEquals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 "
+"10)')),\n"
+" ST_GeomFromText('LINESTRING(0 0, 0 0, 10 10)'));\n"
+" st_orderingequals\n"
+"-----------\n"
+" f\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2537
+#, no-c-format
+msgid ", <xref linkend=\"ST_Reverse\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2543
+#, no-c-format
+msgid "ST_Overlaps"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2545
+#, no-c-format
+msgid ""
+"Returns TRUE if the Geometries share space, are of the same dimension, but "
+"are not completely contained by each other."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2550
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Overlaps</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>A</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>B</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2561
+#, no-c-format
+msgid ""
+"Returns TRUE if the Geometries \"spatially overlap\". By that we mean they "
+"intersect, but one does not completely contain another."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2566 reference_measure.xml:2892
+#: reference_measure.xml:2906
+#, no-c-format
+msgid "Do not call with a GeometryCollection as an argument"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2568
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries. To avoid "
+"index use, use the function _ST_Overlaps."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2576 reference_measure.xml:2912
+#: reference_measure.xml:3117
+#, no-c-format
+msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2577
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.32"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2593
+#, no-c-format
+msgid "<varname>MULTIPOINT</varname> / <varname>MULTIPOINT</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2617
+#, no-c-format
+msgid ""
+"--a point on a line is contained by the line and is of a lower dimension, "
+"and therefore does not overlap the line\n"
+" nor crosses\n"
+"\n"
+"SELECT ST_Overlaps(a,b) As a_overlap_b,\n"
+" ST_Crosses(a,b) As a_crosses_b,\n"
+" ST_Intersects(a, b) As a_intersects_b, ST_Contains(b,a) As "
+"b_contains_a\n"
+"FROM (SELECT ST_GeomFromText('POINT(1 0.5)') As a, "
+"ST_GeomFromText('LINESTRING(1 0, 1 1, 3 5)') As b)\n"
+" As foo\n"
+"\n"
+"a_overlap_b | a_crosses_b | a_intersects_b | b_contains_a\n"
+"------------+-------------+----------------+--------------\n"
+"f | f | t | t\n"
+"\n"
+"--a line that is partly contained by circle, but not fully is defined as "
+"intersecting and crossing,\n"
+"-- but since of different dimension it does not overlap\n"
+"SELECT ST_Overlaps(a,b) As a_overlap_b, ST_Crosses(a,b) As a_crosses_b,\n"
+" ST_Intersects(a, b) As a_intersects_b,\n"
+" ST_Contains(a,b) As a_contains_b\n"
+"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 0.5)'), 3) As a, "
+"ST_GeomFromText('LINESTRING(1 0, 1 1, 3 5)') As b)\n"
+" As foo;\n"
+"\n"
+" a_overlap_b | a_crosses_b | a_intersects_b | a_contains_b\n"
+"-------------+-------------+----------------+--------------\n"
+" f | t | t | f\n"
+"\n"
+" -- a 2-dimensional bent hot dog (aka buffered line string) that intersects "
+"a circle,\n"
+" -- but is not fully contained by the circle is defined as "
+"overlapping since they are of the same dimension,\n"
+"-- but it does not cross, because the intersection of the 2 is of the "
+"same dimension\n"
+"-- as the maximum dimension of the 2\n"
+"\n"
+"SELECT ST_Overlaps(a,b) As a_overlap_b, ST_Crosses(a,b) As a_crosses_b, "
+"ST_Intersects(a, b) As a_intersects_b,\n"
+"ST_Contains(b,a) As b_contains_a,\n"
+"ST_Dimension(a) As dim_a, ST_Dimension(b) as dim_b, "
+"ST_Dimension(ST_Intersection(a,b)) As dima_intersection_b\n"
+"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 0.5)'), 3) As a,\n"
+" ST_Buffer(ST_GeomFromText('LINESTRING(1 0, 1 1, 3 5)'),0.5) As b)\n"
+" As foo;\n"
+"\n"
+" a_overlap_b | a_crosses_b | a_intersects_b | b_contains_a | dim_a | dim_b | "
+"dima_intersection_b\n"
+"-------------+-------------+----------------+--------------+-------+-------"
+"+---------------------\n"
+" t | f | t | f | 2 | 2 "
+"| 2"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2625
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Crosses\"/>, <xref linkend=\"ST_Dimension\"/>, <xref "
+"linkend=\"ST_Intersects\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2630
+#, no-c-format
+msgid "ST_Perimeter"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2632
+#, no-c-format
+msgid ""
+"Return the length measurement of the boundary of an ST_Surface or "
+"ST_MultiSurface geometry or geography. (Polygon, Multipolygon). geometry "
+"measurement is in units of spatial reference and geography is in meters."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2637
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Perimeter</function></funcdef> "
+"<paramdef><type>geometry </type><parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2643
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Perimeter</function></funcdef> "
+"<paramdef><type>geography </type><parameter>geog</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type><parameter>use_spheroid=true</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2653
+#, no-c-format
+msgid ""
+"Returns the 2D perimeter of the geometry/geography if it is a ST_Surface, "
+"ST_MultiSurface (Polygon, Multipolygon). 0 is returned for non-areal "
+"geometries. For linestrings use ST_Length. Measurements for geometry are in "
+"the units of the spatial reference system of the geometry. Measurements for "
+"geography are in meters. If <varname>use_spheroid</varname> is set to false, "
+"then will model earth as a sphere instead of a spheroid."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2658
+#, no-c-format
+msgid ""
+"Currently this is an alias for ST_Perimeter2D, but this may change to "
+"support higher dimensions."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2661
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 8.1.3, 9.5.4"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2662
+#, no-c-format
+msgid "Availability 2.0.0: Support for geography was introduced"
+msgstr ""
+
+#. Tag: title
+#: reference_measure.xml:2666
+#, no-c-format
+msgid "Examples: Geometry"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2667
+#, no-c-format
+msgid ""
+"Return perimeter in feet for polygon and multipolygon. Note this is in feet "
+"because 2249 is Mass State Plane Feet"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2669
+#, no-c-format
+msgid ""
+"SELECT ST_Perimeter(ST_GeomFromText('POLYGON((743238 2967416,743238 "
+"2967450,743265 2967450,\n"
+"743265.625 2967416,743238 2967416))', 2249));\n"
+"st_perimeter\n"
+"---------\n"
+" 122.630744000095\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_Perimeter(ST_GeomFromText('MULTIPOLYGON(((763104.471273676 "
+"2949418.44119003,\n"
+"763104.477769673 2949418.42538203,\n"
+"763104.189609677 2949418.22343004,763104.471273676 2949418.44119003)),\n"
+"((763104.471273676 2949418.44119003,763095.804579742 2949436.33850239,\n"
+"763086.132105649 2949451.46730207,763078.452329651 2949462.11549407,\n"
+"763075.354136904 2949466.17407812,763064.362142565 2949477.64291974,\n"
+"763059.953961626 2949481.28983009,762994.637609571 2949532.04103014,\n"
+"762990.568508415 2949535.06640477,762986.710889563 2949539.61421415,\n"
+"763117.237897679 2949709.50493431,763235.236617789 2949617.95619822,\n"
+"763287.718121842 2949562.20592617,763111.553321674 2949423.91664605,\n"
+"763104.471273676 2949418.44119003)))', 2249));\n"
+"st_perimeter\n"
+"---------\n"
+" 845.227713366825\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: title
+#: reference_measure.xml:2672
+#, no-c-format
+msgid "Examples: Geography"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2673
+#, no-c-format
+msgid ""
+"Return perimeter in meters and feet for polygon and multipolygon. Note this "
+"is geography (WGS 84 long lat)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2674
+#, no-c-format
+msgid ""
+"SELECT ST_Perimeter(geog) As per_meters, ST_Perimeter(geog)/0.3048 As "
+"per_ft \n"
+"FROM ST_GeogFromText('POLYGON((-71.1776848522251 "
+"42.3902896512902,-71.1776843766326 42.3903829478009,\n"
+"-71.1775844305465 42.3903826677917,-71.1775825927231 "
+"42.3902893647987,-71.1776848522251 42.3902896512902))') As geog;\n"
+"\n"
+" per_meters | per_ft\n"
+"-----------------+------------------\n"
+"37.3790462565251 | 122.634666195949\n"
+"\n"
+"\n"
+"-- Multipolygon example --\n"
+"SELECT ST_Perimeter(geog) As per_meters, ST_Perimeter(geog,false) As "
+"per_sphere_meters, ST_Perimeter(geog)/0.3048 As per_ft \n"
+"FROM ST_GeogFromText('MULTIPOLYGON(((-71.1044543107478 "
+"42.340674480411,-71.1044542869917 42.3406744369506,\n"
+"-71.1044553562977 42.340673886454,-71.1044543107478 42.340674480411)),\n"
+"((-71.1044543107478 42.340674480411,-71.1044860600303 "
+"42.3407237015564,-71.1045215770124 42.3407653385914,\n"
+"-71.1045498002983 42.3407946553165,-71.1045611902745 "
+"42.3408058316308,-71.1046016507427 42.340837442371,\n"
+"-71.104617893173 42.3408475056957,-71.1048586153981 "
+"42.3409875993595,-71.1048736143677 42.3409959528211,\n"
+"-71.1048878050242 42.3410084812078,-71.1044020965803 42.3414730072048,\n"
+"-71.1039672113619 42.3412202916693,-71.1037740497748 42.3410666421308,\n"
+"-71.1044280218456 42.3406894151355,-71.1044543107478 42.340674480411)))') As "
+"geog;\n"
+"\n"
+" per_meters | per_sphere_meters | per_ft\n"
+"------------------+-------------------+------------------\n"
+" 257.634283683311 | 257.412311446337 | 845.256836231335"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2678
+#, no-c-format
+msgid ", <xref linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_Length\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2684
+#, no-c-format
+msgid "ST_Perimeter2D"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2686
+#, no-c-format
+msgid ""
+"Returns the 2-dimensional perimeter of the geometry, if it is a polygon or "
+"multi-polygon. This is currently an alias for ST_Perimeter."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2692
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_Perimeter2D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2702
+#, no-c-format
+msgid ""
+"Returns the 2-dimensional perimeter of the geometry, if it is a polygon or "
+"multi-polygon."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2707
+#, no-c-format
+msgid ""
+"This is currently an alias for ST_Perimeter. In future versions ST_Perimeter "
+"may return the highest dimension perimeter for a geometry. This is still "
+"under consideration"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2721
+#, no-c-format
+msgid "ST_3DPerimeter"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2723
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional perimeter of the geometry, if it is a polygon or "
+"multi-polygon."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2729
+#, no-c-format
+msgid ""
+"<funcdef>float <function>ST_3DPerimeter</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2739
+#, no-c-format
+msgid ""
+"Returns the 3-dimensional perimeter of the geometry, if it is a polygon or "
+"multi-polygon. If the geometry is 2-dimensional, then the 2-dimensional "
+"perimeter is returned."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2742
+#, no-c-format
+msgid "Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2748
+#, no-c-format
+msgid ""
+"Perimeter of a slightly elevated polygon in the air in Massachusetts state "
+"plane feet"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2749
+#, no-c-format
+msgid ""
+"SELECT ST_3DPerimeter(the_geom), ST_Perimeter2d(the_geom), "
+"ST_Perimeter(the_geom) FROM\n"
+" (SELECT ST_GeomFromEWKT('SRID=2249;POLYGON((743238 "
+"2967416 2,743238 2967450 1,\n"
+"743265.625 2967416 1,743238 2967416 2))') As the_geom) As foo;\n"
+"\n"
+" ST_3DPerimeter | st_perimeter2d | st_perimeter\n"
+"------------------+------------------+------------------\n"
+" 105.465793597674 | 105.432997272188 | 105.432997272188"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2756
+#, no-c-format
+msgid ", <xref linkend=\"ST_Perimeter\"/>, <xref linkend=\"ST_Perimeter2D\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2762
+#, no-c-format
+msgid "ST_PointOnSurface"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2764
+#, no-c-format
+msgid "Returns a <varname>POINT</varname> guaranteed to lie on the surface."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2769
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PointOnSurface</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2781
+#, no-c-format
+msgid "Returns a <varname>POINT</varname> guaranteed to intersect a surface."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2783
+#, no-c-format
+msgid "&sfs_compliant; s3.2.14.2 // s3.2.18.2"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2784
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM 3: 8.1.5, 9.5.6. According to the specs, "
+"ST_PointOnSurface works for surface geometries (POLYGONs, MULTIPOLYGONS, "
+"CURVED POLYGONS). So PostGIS seems to be extending what the spec allows "
+"here. Most databases Oracle,DB II, ESRI SDE seem to only support this "
+"function for surfaces. SQL Server 2008 like PostGIS supports for all common "
+"geometries."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2793
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_PointOnSurface('POINT(0 5)'::geometry));\n"
+" st_astext\n"
+"------------\n"
+" POINT(0 5)\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_AsText(ST_PointOnSurface('LINESTRING(0 5, 0 10)'::geometry));\n"
+" st_astext\n"
+"------------\n"
+" POINT(0 5)\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_AsText(ST_PointOnSurface('POLYGON((0 0, 0 5, 5 5, 5 0, 0 0))'::"
+"geometry));\n"
+" st_astext\n"
+"----------------\n"
+" POINT(2.5 2.5)\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_AsEWKT(ST_PointOnSurface(ST_GeomFromEWKT('LINESTRING(0 5 1, 0 0 1, "
+"0 10 2)')));\n"
+" st_asewkt\n"
+"----------------\n"
+" POINT(0 0 1)\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2799
+#, no-c-format
+msgid ", <xref linkend=\"ST_Point_Inside_Circle\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2805
+#, no-c-format
+msgid "ST_Project"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2807
+#, no-c-format
+msgid ""
+"Returns a <varname>POINT</varname> projected from a start point using a "
+"bearing and distance."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2812
+#, no-c-format
+msgid ""
+"<funcdef>geography <function>ST_Project</function></funcdef> "
+"<paramdef><type>geography </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>distance</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>azimuth</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2828
+#, no-c-format
+msgid ""
+"Returns a <varname>POINT</varname> projected from a start point using an "
+"azimuth (bearing) and distance."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2829
+#, no-c-format
+msgid ""
+"Distance, azimuth and projection are all aspects of the same operation, "
+"describing (or in the case of projection, constructing) the relationship "
+"between two points on the world."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2830
+#, no-c-format
+msgid ""
+"The azimuth is sometimes called the heading or the bearing in navigation. It "
+"is measured relative to true north (azimuth zero). East is azimuth 90, south "
+"is azimuth 180, west is azimuth 270."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2831
+#, no-c-format
+msgid "The distance is given in meters."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2838
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, 45));\n"
+" st_astext\n"
+" ------------------------------------------\n"
+" POINT(0.63523102912532 0.63947233472882)\n"
+" (1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2844
+#, no-c-format
+msgid ", <xref linkend=\"ST_Distance\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2850
+#, no-c-format
+msgid "ST_Relate"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2852
+#, no-c-format
+msgid ""
+"Returns true if this Geometry is spatially related to anotherGeometry, by "
+"testing for intersections between the Interior, Boundary and Exterior of the "
+"two geometries as specified by the values in the intersectionMatrixPattern. "
+"If no intersectionMatrixPattern is passed in, then returns the maximum "
+"intersectionMatrixPattern that relates the 2 geometries."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_measure.xml:2860
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Relate</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>intersectionMatrixPattern</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>text "
+"<function>ST_Relate</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>geomA</parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>geomB</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>text <function>ST_Relate</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef> "
+"<paramdef><type>int </type> <parameter>BoundaryNodeRule</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2886
+#, no-c-format
+msgid ""
+"Version 1: Takes geomA, geomB, intersectionMatrix and Returns 1 (TRUE) if "
+"this Geometry is spatially related to anotherGeometry, by testing for "
+"intersections between the Interior, Boundary and Exterior of the two "
+"geometries as specified by the values in the <ulink url=\"http://en."
+"wikipedia.org/wiki/DE-9IM\">DE-9IM matrix pattern</ulink>."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2891
+#, no-c-format
+msgid ""
+"This is especially useful for testing compound checks of intersection, "
+"crosses, etc in one step."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2894
+#, no-c-format
+msgid ""
+"This is the \"allowable\" version that returns a boolean, not an integer. "
+"This is defined in OGC spec"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2897
+#, no-c-format
+msgid ""
+"This DOES NOT automagically include an index call. The reason for that is "
+"some relationships are anti e.g. Disjoint. If you are using a relationship "
+"pattern that requires intersection, then include the && index call."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2902
+#, no-c-format
+msgid ""
+"Version 2: Takes geomA and geomB and returns the <xref linkend=\"DE-9IM\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2904
+#, no-c-format
+msgid ""
+"Version 3: same as version 2 bu allows to specify a boundary node rule (1:"
+"OGC/MOD2, 2:Endpoint, 3:MultivalentEndpoint, 4:MonovalentEndpoint)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2908
+#, no-c-format
+msgid "not in OGC spec, but implied. see s2.1.13.2"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2913
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2914
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 - added support for specifying boundary node rule (requires "
+"GEOS >= 3.0)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2921
+#, no-c-format
+msgid ""
+"--Find all compounds that intersect and not touch a poly (interior "
+"intersects)\n"
+"SELECT l.* , b.name As poly_name\n"
+" FROM polys As b\n"
+"INNER JOIN compounds As l\n"
+"ON (p.the_geom && b.the_geom\n"
+"AND ST_Relate(l.the_geom, b.the_geom,'T********'));\n"
+"\n"
+"SELECT ST_Relate(ST_GeometryFromText('POINT(1 2)'), "
+"ST_Buffer(ST_GeometryFromText('POINT(1 2)'),2));\n"
+"st_relate\n"
+"-----------\n"
+"0FFFFF212\n"
+"\n"
+"SELECT ST_Relate(ST_GeometryFromText('LINESTRING(1 2, 3 4)'), "
+"ST_GeometryFromText('LINESTRING(5 6, 7 8)'));\n"
+"st_relate\n"
+"-----------\n"
+"FF1FF0102\n"
+"\n"
+"\n"
+"SELECT ST_Relate(ST_GeometryFromText('POINT(1 2)'), "
+"ST_Buffer(ST_GeometryFromText('POINT(1 2)'),2), '0FFFFF212');\n"
+"st_relate\n"
+"-----------\n"
+"t\n"
+"\n"
+"SELECT ST_Relate(ST_GeometryFromText('POINT(1 2)'), "
+"ST_Buffer(ST_GeometryFromText('POINT(1 2)'),2), '*FF*FF212');\n"
+"st_relate\n"
+"-----------\n"
+"t"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2928
+#, no-c-format
+msgid ""
+", <xref linkend=\"DE-9IM\"/>, <xref linkend=\"ST_Disjoint\"/>, <xref linkend="
+"\"ST_Intersects\"/>, <xref linkend=\"ST_Touches\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2934
+#, no-c-format
+msgid "ST_RelateMatch"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2936
+#, no-c-format
+msgid ""
+"Returns true if intersectionMattrixPattern1 implies "
+"intersectionMatrixPattern2"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2941
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_RelateMatch</function></funcdef> "
+"<paramdef><type>text </type> <parameter>intersectionMatrix</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>intersectionMatrixPattern</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2952
+#, no-c-format
+msgid ""
+"Takes intersectionMatrix and intersectionMatrixPattern and Returns true if "
+"the intersectionMatrix satisfies the intersectionMatrixPattern. For more "
+"information refer to <xref linkend=\"DE-9IM\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2955
+#, no-c-format
+msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:2961
+#, no-c-format
+msgid ""
+"SELECT ST_RelateMatch('101202FFF', 'TTTTTTFFF') ;\n"
+"-- result --\n"
+"t\n"
+"--example of common intersection matrix patterns and example matrices\n"
+"-- comparing relationships of involving one invalid geometry and ( a line "
+"and polygon that intersect at interior and boundary)\n"
+"SELECT mat.name, pat.name, ST_RelateMatch(mat.val, pat.val) As satisfied\n"
+" FROM \n"
+" ( VALUES ('Equality', 'T1FF1FFF1'),\n"
+" ('Overlaps', 'T*T***T**'),\n"
+" ('Within', 'T*F**F***'),\n"
+" ('Disjoint', 'FF*FF****') As pat(name,val)\n"
+" CROSS JOIN \n"
+" ( VALUES ('Self intersections (invalid)', '111111111'),\n"
+" ('IE2_BI1_BB0_BE1_EI1_EE2', 'FF2101102'),\n"
+" ('IB1_IE1_BB0_BE0_EI2_EI1_EE2', 'F11F00212')\n"
+" ) As mat(name,val);"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2967
+#, no-c-format
+msgid ", <xref linkend=\"ST_Relate\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:2973
+#, no-c-format
+msgid "ST_ShortestLine"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:2975
+#, no-c-format
+msgid "Returns the 2-dimensional shortest line between two geometries"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:2980
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_ShortestLine</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:2995
+#, no-c-format
+msgid ""
+"Returns the 2-dimensional shortest line between two geometries. The function "
+"will only return the first shortest line if more than one, that the function "
+"finds. If g1 and g2 intersects in just one point the function will return a "
+"line with both start and end in that intersection-point. If g1 and g2 are "
+"intersecting with more than one point the function will return a line with "
+"start and end in the same point but it can be any of the intersecting "
+"points. The line returned will always start in g1 and end in g2. The length "
+"of the line this function returns will always be the same as st_distance "
+"returns for g1 and g2."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3019
+#, no-c-format
+msgid "Shortest line between point and linestring"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:3022
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_ShortestLine('POINT(100 100)'::geometry, \n"
+" 'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry)\n"
+" ) As sline;\n"
+"\n"
+" \n"
+" sline\n"
+"-----------------\n"
+"LINESTRING(100 100,73.0769230769231 115.384615384615)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3030
+#, no-c-format
+msgid "shortest line between polygon and polygon"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:3033
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_ShortestLine(\n"
+" ST_GeomFromText('POLYGON((175 150, 20 40, 50 60, 125 "
+"100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" ) \n"
+" ) As slinewkt;\n"
+" \n"
+" LINESTRING(140.752120669087 125.695053378061,121.111404660392 "
+"153.370607753949)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3045
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Distance\"/>, <xref linkend=\"ST_LongestLine\"/>, <xref "
+"linkend=\"ST_MaxDistance\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:3051
+#, no-c-format
+msgid "ST_Touches"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:3053
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if the geometries have at least one point in "
+"common, but their interiors do not intersect."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:3059
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Touches</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3074
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if the only points in common between "
+"<parameter>g1</parameter> and <parameter>g2</parameter> lie in the union of "
+"the boundaries of <parameter>g1</parameter> and <parameter>g2</parameter>. "
+"The <function>ST_Touches</function> relation applies to all Area/Area, Line/"
+"Line, Line/Area, Point/Area and Point/Line pairs of relationships, but "
+"<emphasis>not</emphasis> to the Point/Point pair."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3081
+#, no-c-format
+msgid "In mathematical terms, this predicate is expressed as:"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3091
+#, no-c-format
+msgid "The allowable DE-9IM Intersection Matrices for the two geometries are:"
+msgstr ""
+
+#. Tag: markup
+#: reference_measure.xml:3095
+#, no-c-format
+msgid "FT*******"
+msgstr ""
+
+#. Tag: markup
+#: reference_measure.xml:3099
+#, no-c-format
+msgid "F**T*****"
+msgstr ""
+
+#. Tag: markup
+#: reference_measure.xml:3103
+#, no-c-format
+msgid "F***T****"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3112
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries. To avoid "
+"using an index, use <function>_ST_Touches</function> instead."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3118
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.28"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3124
+#, no-c-format
+msgid ""
+"The <function>ST_Touches</function> predicate returns <varname>TRUE</"
+"varname> in all the following illustrations."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:3194
+#, no-c-format
+msgid ""
+"SELECT ST_Touches('LINESTRING(0 0, 1 1, 0 2)'::geometry, 'POINT(1 1)'::"
+"geometry);\n"
+" st_touches\n"
+"------------\n"
+" f\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_Touches('LINESTRING(0 0, 1 1, 0 2)'::geometry, 'POINT(0 2)'::"
+"geometry);\n"
+" st_touches\n"
+"------------\n"
+" t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_measure.xml:3200
+#, no-c-format
+msgid "ST_Within"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_measure.xml:3202
+#, no-c-format
+msgid "Returns true if the geometry A is completely inside geometry B"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_measure.xml:3207
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Within</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>A</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>B</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3222
+#, no-c-format
+msgid ""
+"Returns TRUE if geometry A is completely inside geometry B. For this "
+"function to make sense, the source geometries must both be of the same "
+"coordinate projection, having the same SRID. It is a given that if "
+"ST_Within(A,B) is true and ST_Within(B,A) is true, then the two geometries "
+"are considered spatially equal."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3237
+#, no-c-format
+msgid ""
+"This function call will automatically include a bounding box comparison that "
+"will make use of any indexes that are available on the geometries. To avoid "
+"index use, use the function _ST_Within."
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3245
+#, no-c-format
+msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3 - a.Relate(b, 'T*F**F***')"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3248
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.30"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_measure.xml:3253
+#, no-c-format
+msgid ""
+"--a circle within a circle\n"
+"SELECT ST_Within(smallc,smallc) As smallinsmall,\n"
+" ST_Within(smallc, bigc) As smallinbig,\n"
+" ST_Within(bigc,smallc) As biginsmall,\n"
+" ST_Within(ST_Union(smallc, bigc), bigc) as unioninbig,\n"
+" ST_Within(bigc, ST_Union(smallc, bigc)) as biginunion,\n"
+" ST_Equals(bigc, ST_Union(smallc, bigc)) as bigisunion\n"
+"FROM\n"
+"(\n"
+"SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc,\n"
+" ST_Buffer(ST_GeomFromText('POINT(50 50)'), 40) As bigc) As foo;\n"
+"--Result\n"
+" smallinsmall | smallinbig | biginsmall | unioninbig | biginunion | "
+"bigisunion\n"
+"--------------+------------+------------+------------+------------"
+"+------------\n"
+" t | t | f | t | t | t\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_measure.xml:3264
+#, no-c-format
+msgid ", <xref linkend=\"ST_Equals\"/>, <xref linkend=\"ST_IsValid\"/>"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_misc.xml:3
+#, no-c-format
+msgid "Miscellaneous Functions"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:7
+#, no-c-format
+msgid "ST_Accum"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:9
+#, no-c-format
+msgid "<refpurpose>Aggregate. Constructs an array of geometries.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:14
+#, no-c-format
+msgid ""
+"<funcdef>geometry[] <function>ST_Accum</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>geomfield</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: title
+#: reference_misc.xml:22 reference_misc.xml:64 reference_misc.xml:106
+#: reference_misc.xml:158 reference_misc.xml:229 reference_misc.xml:289
+#: reference_misc.xml:343 reference_misc.xml:396 reference_misc.xml:438
+#: reference_misc.xml:488
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:24
+#, no-c-format
+msgid "<para>Aggregate. Constructs an array of geometries.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:25 reference_misc.xml:68 reference_misc.xml:109
+#: reference_misc.xml:255 reference_misc.xml:309 reference_misc.xml:355
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was "
+"introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:26 reference_misc.xml:113 reference_misc.xml:357
+#: reference_misc.xml:447
+#, no-c-format
+msgid "&Z_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:27 reference_misc.xml:69 reference_misc.xml:110
+#: reference_misc.xml:183 reference_misc.xml:358 reference_misc.xml:448
+#, no-c-format
+msgid "&curve_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:28 reference_misc.xml:70 reference_misc.xml:111
+#: reference_misc.xml:256 reference_misc.xml:310 reference_misc.xml:359
+#: reference_misc.xml:449
+#, no-c-format
+msgid "&P_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:29 reference_misc.xml:71 reference_misc.xml:112
+#: reference_misc.xml:257 reference_misc.xml:311 reference_misc.xml:360
+#: reference_misc.xml:450
+#, no-c-format
+msgid "&T_support;"
+msgstr ""
+
+#. Tag: title
+#: reference_misc.xml:34 reference_misc.xml:76 reference_misc.xml:118
+#: reference_misc.xml:188 reference_misc.xml:262 reference_misc.xml:316
+#: reference_misc.xml:364 reference_misc.xml:408 reference_misc.xml:455
+#: reference_misc.xml:499
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:36
+#, no-c-format
+msgid ""
+"SELECT (ST_Accum(the_geom)) As all_em, ST_AsText((ST_Accum(the_geom))[1]) As "
+"grabone,\n"
+"(ST_Accum(the_geom))[2:4] as grab_rest\n"
+" FROM (SELECT ST_MakePoint(a*CAST(random()*10 As "
+"integer), a*CAST(random()*10 As integer), a*CAST(random()*10 As integer)) As "
+"the_geom\n"
+" FROM generate_series(1,4) a) As foo;\n"
+"\n"
+"all_em|grabone | grab_rest\n"
+"\n"
+"-------------------------------------------------------------------------------"
+"+\n"
+"\n"
+" {0101000080000000000000144000000000000024400000000000001040:\n"
+" 0101000080000000000\n"
+"00018400000000000002C400000000000003040:\n"
+"0101000080000000000000354000000000000038400000000000001840:\n"
+"010100008000000000000040400000000000003C400000000000003040} |\n"
+" POINT(5 10) | {010100008000000000000018400000000000002C400000000000003040:\n"
+" 0101000080000000000000354000000000000038400000000000001840:\n"
+" 010100008000000000000040400000000000003C400000000000003040}\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: title
+#: reference_misc.xml:41 reference_misc.xml:83 reference_misc.xml:125
+#: reference_misc.xml:195 reference_misc.xml:268 reference_misc.xml:322
+#: reference_misc.xml:369 reference_misc.xml:415 reference_misc.xml:462
+#: reference_misc.xml:506
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:49
+#, no-c-format
+msgid "Box2D"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:51
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a BOX2D representing the maximum extents of the geometry."
+"</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:56
+#, no-c-format
+msgid ""
+"<funcdef>box2d <function>Box2D</function></funcdef> <paramdef><type>geometry "
+"</type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:66
+#, no-c-format
+msgid ""
+"<para>Returns a BOX2D representing the maximum extents of the geometry.</"
+"para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:78
+#, no-c-format
+msgid ""
+"SELECT Box2D(ST_GeomFromText('LINESTRING(1 2, 3 4, 5 6)'));\n"
+" box2d\n"
+" ---------\n"
+" BOX(1 2,5 6)\n"
+"\n"
+" SELECT Box2D(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 "
+"150505,220227 150406)'));\n"
+" box2d\n"
+" --------\n"
+" BOX(220186.984375 150406,220288.25 150506.140625)"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:85
+#, no-c-format
+msgid ", <xref linkend=\"ST_GeomFromText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:91
+#, no-c-format
+msgid "Box3D"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:93
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a BOX3D representing the maximum extents of the geometry."
+"</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:98
+#, no-c-format
+msgid ""
+"<funcdef>box3d <function>Box3D</function></funcdef> <paramdef><type>geometry "
+"</type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:108
+#, no-c-format
+msgid ""
+"<para>Returns a BOX3D representing the maximum extents of the geometry.</"
+"para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:120
+#, no-c-format
+msgid ""
+"SELECT Box3D(ST_GeomFromEWKT('LINESTRING(1 2 3, 3 4 5, 5 6 5)'));\n"
+" Box3d\n"
+" ---------\n"
+" BOX3D(1 2 3,5 6 5)\n"
+"\n"
+" SELECT Box3D(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 "
+"150505 1,220227 150406 1)'));\n"
+" Box3d\n"
+" --------\n"
+" BOX3D(220227 150406 1,220268 150415 1)"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:127
+#, no-c-format
+msgid ", <xref linkend=\"ST_GeomFromEWKT\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:133
+#, no-c-format
+msgid "ST_EstimatedExtent"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:135
+#, no-c-format
+msgid ""
+"<refpurpose>Return the 'estimated' extent of the given spatial table. The "
+"estimated is taken from the geometry column's statistics. The current schema "
+"will be used if not specified.</refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_misc.xml:141
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>box2d <function>ST_EstimatedExtent</function></"
+"funcdef> <paramdef><type>text </type> <parameter>schema_name</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>table_name</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>geocolumn_name</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>box2d "
+"<function>ST_EstimatedExtent</function></funcdef> <paramdef><type>text </"
+"type> <parameter>table_name</parameter></paramdef> <paramdef><type>text </"
+"type> <parameter>geocolumn_name</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:160
+#, no-c-format
+msgid ""
+"<para>Return the 'estimated' extent of the given spatial table. The "
+"estimated is taken from the geometry column's statistics. The current schema "
+"will be used if not specified.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:164
+#, no-c-format
+msgid ""
+"For PostgreSQL>=8.0.0 statistics are gathered by VACUUM ANALYZE and "
+"resulting extent will be about 95% of the real one."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:169
+#, no-c-format
+msgid ""
+"In absence of statistics (empty table or no ANALYZE called) this function "
+"returns NULL. Prior to version 1.5.4 an exception was thrown instead."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:177
+#, no-c-format
+msgid ""
+"For PostgreSQL<8.0.0 statistics are gathered by update_geometry_stats() "
+"and resulting extent will be exact."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:180
+#, no-c-format
+msgid "Availability: 1.0.0"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:181
+#, no-c-format
+msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:190
+#, no-c-format
+msgid ""
+"SELECT ST_EstimatedExtent('ny', 'edges', 'the_geom');\n"
+"--result--\n"
+"BOX(-8877653 4912316,-8010225.5 5589284)\n"
+"\n"
+"SELECT ST_EstimatedExtent('feature_poly', 'the_geom');\n"
+"--result--\n"
+"BOX(-124.659652709961 24.6830825805664,-67.7798080444336 49.0012092590332)"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:202
+#, no-c-format
+msgid "ST_Expand"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:203
+#, no-c-format
+msgid ""
+"Returns bounding box expanded in all directions from the bounding box of the "
+"input geometry. Uses double-precision"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_misc.xml:207
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Expand</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>units_to_expand</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>box2d "
+"<function>ST_Expand</function></funcdef> <paramdef><type>box2d </type> "
+"<parameter>g1</parameter></paramdef> <paramdef><type>float</type> "
+"<parameter>units_to_expand</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>box3d <function>ST_Expand</function></funcdef> "
+"<paramdef><type>box3d </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>units_to_expand</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:231
+#, no-c-format
+msgid ""
+"This function returns a bounding box expanded in all directions from the "
+"bounding box of the input geometry, by an amount specified in the second "
+"argument. Uses double-precision. Very useful for distance() queries, or "
+"bounding box queries to add an index filter to the query."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:235
+#, no-c-format
+msgid ""
+"There are 3 variants of this. The one that takes a geometry will return a "
+"POLYGON geometry representation of the bounding box and is the most commonly "
+"used variant."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:237
+#, no-c-format
+msgid ""
+"ST_Expand is similar in concept to ST_Buffer except while buffer expands the "
+"geometry in all directions, ST_Expand expands the bounding box an x,y,z unit "
+"amount."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:239
+#, no-c-format
+msgid ""
+"Units are in the units of the spatial reference system in use denoted by the "
+"SRID"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:242
+#, no-c-format
+msgid ""
+"Pre 1.3, ST_Expand was used in conjunction with distance to do indexable "
+"queries. Something of the form <code>the_geom && ST_Expand('POINT(10 "
+"20)', 10) AND ST_Distance(the_geom, 'POINT(10 20)') < 10</code> Post 1.2, "
+"this was replaced with the easier ST_DWithin construct."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:248
+#, no-c-format
+msgid ""
+"Bounding boxes of all geometries are currently 2-d even if they are 3-"
+"dimensional geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:252
+#, no-c-format
+msgid ""
+"Availability: 1.5.0 behavior changed to output double precision instead of "
+"float4 coordinates."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:263
+#, no-c-format
+msgid ""
+"Examples below use US National Atlas Equal Area (SRID=2163) which is a meter "
+"projection"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:264
+#, no-c-format
+msgid ""
+"<!-- TODO: fix results of documentation to reflect new behavior -->\n"
+"--10 meter expanded box around bbox of a linestring\n"
+"SELECT CAST(ST_Expand(ST_GeomFromText('LINESTRING(2312980 110676,2312923 "
+"110701,2312892 110714)', 2163),10) As box2d);\n"
+" st_expand\n"
+"------------------------------------\n"
+" BOX(2312882 110666,2312990 110724)\n"
+"\n"
+"--10 meter expanded 3d box of a 3d box\n"
+"SELECT ST_Expand(CAST('BOX3D(778783 2951741 1,794875 2970042.61545891 10)' "
+"As box3d),10)\n"
+" st_expand\n"
+"-----------------------------------------------------\n"
+" BOX3D(778773 2951731 -9,794885 2970052.61545891 20)\n"
+"\n"
+" --10 meter geometry astext rep of a expand box around a point geometry\n"
+" SELECT ST_AsEWKT(ST_Expand(ST_GeomFromEWKT('SRID=2163;POINT(2312980 "
+"110676)'),10));\n"
+" st_asewkt\n"
+"-------------------------------------------------------------------------------------------------\n"
+" SRID=2163;POLYGON((2312970 110666,2312970 110686,2312990 110686,2312990 "
+"110666,2312970 110666))"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:269
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Buffer\"/>, <xref linkend=\"ST_DWithin\"/>, <xref "
+"linkend=\"ST_GeomFromEWKT\"/>, <xref linkend=\"ST_GeomFromText\"/>, <xref "
+"linkend=\"ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:275
+#, no-c-format
+msgid "ST_Extent"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:276
+#, no-c-format
+msgid ""
+"an aggregate function that returns the bounding box that bounds rows of "
+"geometries."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:281
+#, no-c-format
+msgid ""
+"<funcdef>box2d <function>ST_Extent</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>geomfield</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:291
+#, no-c-format
+msgid ""
+"ST_Extent returns a bounding box that encloses a set of geometries. The "
+"ST_Extent function is an \"aggregate\" function in the terminology of SQL. "
+"That means that it operates on lists of data, in the same way the SUM() and "
+"AVG() functions do."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:294 reference_misc.xml:348
+#, no-c-format
+msgid ""
+"Since it returns a bounding box, the spatial Units are in the units of the "
+"spatial reference system in use denoted by the SRID"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:295
+#, no-c-format
+msgid ""
+"ST_Extent is similar in concept to Oracle Spatial/Locator's SDO_AGGR_MBR"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:297
+#, no-c-format
+msgid ""
+"Since ST_Extent returns a bounding box, the SRID meta-data is lost. Use "
+"ST_SetSRID to force it back into a geometry with SRID meta data. The "
+"coordinates are in the units of the spatial ref of the orginal geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:302
+#, no-c-format
+msgid ""
+"ST_Extent will return boxes with only an x and y component even with (x,y,z) "
+"coordinate geometries. To maintain x,y,z use ST_3DExtent instead."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:306
+#, no-c-format
+msgid "Availability: 1.4.0"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:317
+#, no-c-format
+msgid "Examples below use Massachusetts State Plane ft (SRID=2249)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:318
+#, no-c-format
+msgid ""
+"SELECT ST_Extent(the_geom) as bextent FROM sometable;\n"
+" st_bextent\n"
+"------------------------------------\n"
+"BOX(739651.875 2908247.25,794875.8125 2970042.75)\n"
+"\n"
+"\n"
+"--Return extent of each category of geometries\n"
+"SELECT ST_Extent(the_geom) as bextent\n"
+"FROM sometable\n"
+"GROUP BY category ORDER BY category;\n"
+"\n"
+" bextent "
+"| name\n"
+"----------------------------------------------------+----------------\n"
+" BOX(778783.5625 2951741.25,794875.8125 2970042.75) | A\n"
+" BOX(751315.8125 2919164.75,765202.6875 2935417.25) | B\n"
+" BOX(739651.875 2917394.75,756688.375 2935866) | C\n"
+"\n"
+" --Force back into a geometry\n"
+" -- and render the extended text representation of that geometry\n"
+"SELECT ST_SetSRID(ST_Extent(the_geom),2249) as bextent FROM sometable;\n"
+"\n"
+" bextent\n"
+"--------------------------------------------------------------------------------\n"
+" SRID=2249;POLYGON((739651.875 2908247.25,739651.875 2970042.75,794875.8125 "
+"2970042.75,\n"
+" 794875.8125 2908247.25,739651.875 2908247.25))"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:323
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_3DExtent\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:329
+#, no-c-format
+msgid "ST_3DExtent"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:330
+#, no-c-format
+msgid ""
+"an aggregate function that returns the box3D bounding box that bounds rows "
+"of geometries."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:335
+#, no-c-format
+msgid ""
+"<funcdef>box3d <function>ST_3DExtent</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>geomfield</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:345
+#, no-c-format
+msgid ""
+"ST_3DExtent returns a box3d (includes Z coordinate) bounding box that "
+"encloses a set of geometries. The ST_3DExtent function is an \"aggregate\" "
+"function in the terminology of SQL. That means that it operates on lists of "
+"data, in the same way the SUM() and AVG() functions do."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:351
+#, no-c-format
+msgid ""
+"Since ST_3DExtent returns a bounding box, the SRID meta-data is lost. Use "
+"ST_SetSRID to force it back into a geometry with SRID meta data. The "
+"coordinates are in the units of the spatial ref of the orginal geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:356
+#, no-c-format
+msgid "Changed: 2.0.0 In prior versions this used to be called ST_Extent3D"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:365
+#, no-c-format
+msgid ""
+"SELECT ST_3DExtent(foo.the_geom) As b3extent\n"
+"FROM (SELECT ST_MakePoint(x,y,z) As the_geom\n"
+" FROM generate_series(1,3) As x\n"
+" CROSS JOIN generate_series(1,2) As y\n"
+" CROSS JOIN generate_series(0,2) As Z) As foo;\n"
+" b3extent\n"
+"--------------------\n"
+" BOX3D(1 1 0,3 2 2)\n"
+"\n"
+"--Get the extent of various elevated circular strings\n"
+"SELECT ST_3DExtent(foo.the_geom) As b3extent\n"
+"FROM (SELECT "
+"ST_Translate(ST_Force_3DZ(ST_LineToCurve(ST_Buffer(ST_MakePoint(x,"
+"y),1))),0,0,z) As the_geom\n"
+" FROM generate_series(1,3) As x\n"
+" CROSS JOIN generate_series(1,2) As y\n"
+" CROSS JOIN generate_series(0,2) As Z) As foo;\n"
+"\n"
+" b3extent\n"
+"--------------------\n"
+" BOX3D(1 0 0,4 2 2)"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:370
+#, no-c-format
+msgid ", <xref linkend=\"ST_Force_3DZ\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:377
+#, no-c-format
+msgid "Find_SRID"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:379
+#, no-c-format
+msgid ""
+"The syntax is find_srid(<db/schema>, <table>, <column>) "
+"and the function returns the integer SRID of the specified column by "
+"searching through the GEOMETRY_COLUMNS table."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:386
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>Find_SRID</function></funcdef> "
+"<paramdef><type>varchar </type> <parameter>a_schema_name</parameter></"
+"paramdef> <paramdef><type>varchar </type> <parameter>a_table_name</"
+"parameter></paramdef> <paramdef><type>varchar </type> "
+"<parameter>a_geomfield_name</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:398
+#, no-c-format
+msgid ""
+"The syntax is find_srid(<db/schema>, <table>, <column>) "
+"and the function returns the integer SRID of the specified column by "
+"searching through the GEOMETRY_COLUMNS table. If the geometry column has not "
+"been properly added with the AddGeometryColumns() function, this function "
+"will not work either."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:410
+#, no-c-format
+msgid ""
+"SELECT Find_SRID('public', 'tiger_us_state_2007', 'the_geom_4269');\n"
+"find_srid\n"
+"----------\n"
+"4269"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:423
+#, no-c-format
+msgid "ST_Mem_Size"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:425
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the amount of space (in bytes) the geometry takes.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:430
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_Mem_Size</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:440
+#, no-c-format
+msgid "<para>Returns the amount of space (in bytes) the geometry takes.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:441
+#, no-c-format
+msgid ""
+"This is a nice compliment to PostgreSQL built in functions pg_size_pretty, "
+"pg_relation_size, pg_total_relation_size."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:442
+#, no-c-format
+msgid ""
+"pg_relation_size which gives the byte size of a table may return byte size "
+"lower than ST_Mem_Size. This is because pg_relation_size does not add "
+"toasted table contribution and large geometries are stored in TOAST tables."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:444
+#, no-c-format
+msgid ""
+"pg_total_relation_size - includes, the table, the toasted tables, and the "
+"indexes."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:457
+#, no-c-format
+msgid ""
+"--Return how much byte space Boston takes up in our Mass data set\n"
+"SELECT pg_size_pretty(SUM(ST_Mem_Size(the_geom))) as totgeomsum,\n"
+"pg_size_pretty(SUM(CASE WHEN town = 'BOSTON' THEN st_mem_size(the_geom) ELSE "
+"0 END)) As bossum,\n"
+"CAST(SUM(CASE WHEN town = 'BOSTON' THEN st_mem_size(the_geom) ELSE 0 "
+"END)*1.00 /\n"
+" SUM(st_mem_size(the_geom))*100 As numeric(10,2)) As perbos\n"
+"FROM towns;\n"
+"\n"
+"totgeomsum bossum perbos\n"
+"---------- ------ ------\n"
+"1522 kB 30 kB 1.99\n"
+"\n"
+"\n"
+"SELECT ST_Mem_Size(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 "
+"150505,220227 150406)'));\n"
+"\n"
+"---\n"
+"73\n"
+"\n"
+"--What percentage of our table is taken up by just the geometry\n"
+"SELECT pg_total_relation_size('public.neighborhoods') As fulltable_size, "
+"sum(ST_Mem_Size(the_geom)) As geomsize,\n"
+"sum(ST_Mem_Size(the_geom))*1.00/pg_total_relation_size('public."
+"neighborhoods')*100 As pergeom\n"
+"FROM neighborhoods;\n"
+"fulltable_size geomsize pergeom\n"
+"------------------------------------------------\n"
+"262144 96238 36.71188354492187500000"
+msgstr ""
+
+#. Tag: refname
+#: reference_misc.xml:470
+#, no-c-format
+msgid "ST_Point_Inside_Circle"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_misc.xml:472
+#, no-c-format
+msgid ""
+"Is the point geometry insert circle defined by center_x, center_y, radius"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_misc.xml:477
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_Point_Inside_Circle</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_point</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>center_x</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>center_y</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>radius</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:490
+#, no-c-format
+msgid ""
+"The syntax for this functions is point_inside_circle(<geometry>,<"
+"circle_center_x>,<circle_center_y>,<radius>). Returns the "
+"true if the geometry is a point and is inside the circle. Returns false "
+"otherwise."
+msgstr ""
+
+#. Tag: para
+#: reference_misc.xml:494
+#, no-c-format
+msgid "This only works for points as the name suggests"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_misc.xml:501
+#, no-c-format
+msgid ""
+"SELECT ST_Point_Inside_Circle(ST_Point(1,2), 0.5, 2, 3);\n"
+" st_point_inside_circle\n"
+"------------------------\n"
+" t"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# Jakub Bobrowski <jb@5dstudio.pl>, 2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2014-01-04 22:00+0000\n"
+"Last-Translator: Jakub Bobrowski <jb@5dstudio.pl>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_operator.xml:3
+#, no-c-format
+msgid "Operators"
+msgstr "Operatory"
+
+#. Tag: refname
+#: reference_operator.xml:6
+#, no-c-format
+msgid "&&"
+msgstr "&&"
+
+#. Tag: refpurpose
+#: reference_operator.xml:8
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's 2D bounding box intersects B's 2D "
+"bounding box."
+msgstr ""
+"Zwraca <varname>TRUE</varname> jeśli dwuwymiarowe (2D) pole ograniczające "
+"obiektu A przecina dwuwymiarowe (2D) pole ograniczające obiektu B."
+
+#. Tag: funcsynopsis
+#: reference_operator.xml:12
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>&&</function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>&&</"
+"function></funcdef> <paramdef> <type>geography </type> <parameter>A</"
+"parameter> </paramdef> <paramdef> <type>geography </type> <parameter>B</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>boolean <function>&&</function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>&&</"
+"function></funcdef> <paramdef> <type>geography </type> <parameter>A</"
+"parameter> </paramdef> <paramdef> <type>geography </type> <parameter>B</"
+"parameter> </paramdef> </funcprototype>"
+
+#. Tag: title
+#: reference_operator.xml:50 reference_operator.xml:111
+#: reference_operator.xml:176 reference_operator.xml:234
+#: reference_operator.xml:295 reference_operator.xml:353
+#: reference_operator.xml:406 reference_operator.xml:475
+#: reference_operator.xml:546 reference_operator.xml:599
+#: reference_operator.xml:654 reference_operator.xml:712
+#: reference_operator.xml:765 reference_operator.xml:818
+#: reference_operator.xml:883 reference_operator.xml:949
+#, no-c-format
+msgid "Description"
+msgstr "Opis"
+
+#. Tag: para
+#: reference_operator.xml:52
+#, no-c-format
+msgid ""
+"The <varname>&&</varname> operator returns <varname>TRUE</varname> "
+"if the 2D bounding box of geometry A intersects the 2D bounding box of "
+"geometry B."
+msgstr ""
+"Operator <varname>&&</varname> zwraca <varname>TRUE</varname> jeśli "
+"dwuwymiarowe (2D) pole ograniczające geometrii A przecina dwuwymiarowe (2D) "
+"pole ograniczające geometrii B."
+
+#. Tag: para
+#: reference_operator.xml:54 reference_operator.xml:115
+#: reference_operator.xml:182 reference_operator.xml:243
+#: reference_operator.xml:301 reference_operator.xml:358
+#: reference_operator.xml:411 reference_operator.xml:551
+#: reference_operator.xml:605 reference_operator.xml:660
+#: reference_operator.xml:717 reference_operator.xml:770
+#: reference_operator.xml:823
+#, no-c-format
+msgid ""
+"This operand will make use of any indexes that may be available on the "
+"geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:57
+#, no-c-format
+msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:58
+#, no-c-format
+msgid "Availability: 1.5.0 support for geography was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:59 reference_operator.xml:119
+#: reference_operator.xml:240 reference_operator.xml:492
+#, no-c-format
+msgid "&curve_support;"
+msgstr "&curve_support;"
+
+#. Tag: para
+#: reference_operator.xml:60 reference_operator.xml:120
+#: reference_operator.xml:241 reference_operator.xml:493
+#: reference_operator.xml:827
+#, no-c-format
+msgid "&P_support;"
+msgstr "&P_support;"
+
+#. Tag: title
+#: reference_operator.xml:64 reference_operator.xml:187
+#: reference_operator.xml:248 reference_operator.xml:306
+#: reference_operator.xml:363 reference_operator.xml:416
+#: reference_operator.xml:502 reference_operator.xml:556
+#: reference_operator.xml:611 reference_operator.xml:665
+#: reference_operator.xml:722 reference_operator.xml:775
+#: reference_operator.xml:843 reference_operator.xml:899
+#: reference_operator.xml:963
+#, no-c-format
+msgid "Examples"
+msgstr "Przykłady"
+
+#. Tag: programlisting
+#: reference_operator.xml:66
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 && tbl2.column2 AS "
+"overlaps\n"
+"FROM ( VALUES\n"
+" (1, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (2, 'LINESTRING(0 1, 0 5)'::geometry)) AS tbl1,\n"
+"( VALUES\n"
+" (3, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overlaps\n"
+"---------+---------+----------\n"
+" 1 | 3 | t\n"
+" 2 | 3 | f\n"
+"(2 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 && tbl2.column2 AS "
+"overlaps\n"
+"FROM ( VALUES\n"
+" (1, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (2, 'LINESTRING(0 1, 0 5)'::geometry)) AS tbl1,\n"
+"( VALUES\n"
+" (3, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overlaps\n"
+"---------+---------+----------\n"
+" 1 | 3 | t\n"
+" 2 | 3 | f\n"
+"(2 rows)"
+
+#. Tag: title
+#: reference_operator.xml:71 reference_operator.xml:139
+#: reference_operator.xml:193 reference_operator.xml:254
+#: reference_operator.xml:312 reference_operator.xml:369
+#: reference_operator.xml:422 reference_operator.xml:508
+#: reference_operator.xml:562 reference_operator.xml:617
+#: reference_operator.xml:671 reference_operator.xml:728
+#: reference_operator.xml:781 reference_operator.xml:848
+#: reference_operator.xml:915 reference_operator.xml:967
+#, no-c-format
+msgid "See Also"
+msgstr "Zobacz także"
+
+#. Tag: para
+#: reference_operator.xml:73
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Overright\"/>, <xref linkend="
+"\"ST_Geometry_Overbelow\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>, <xref "
+"linkend=\"ST_Geometry_Contain\"/>, <xref linkend=\"ST_Geometry_Contained\"/>"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Overright\"/>, <xref linkend="
+"\"ST_Geometry_Overbelow\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>, <xref "
+"linkend=\"ST_Geometry_Contain\"/>, <xref linkend=\"ST_Geometry_Contained\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:85
+#, no-c-format
+msgid "&&&"
+msgstr "&&&"
+
+#. Tag: refpurpose
+#: reference_operator.xml:87
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's 3D bounding box intersects B's 3D "
+"bounding box."
+msgstr ""
+"Zwraca <varname>TRUE</varname> jeśli trójwymiarowe (3D) pole ograniczające "
+"obiektu A przecina trójwymiarowe (3D) pole ograniczające obiektu B."
+
+#. Tag: funcprototype
+#: reference_operator.xml:92
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>&&&</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>&&&</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:113
+#, no-c-format
+msgid ""
+"The <varname>&&&</varname> operator returns <varname>TRUE</"
+"varname> if the n-D bounding box of geometry A intersects the n-D bounding "
+"box of geometry B."
+msgstr ""
+"Operator <varname>&&&</varname> zwraca <varname>TRUE</"
+"varname>jesli n-wymiarowe (n-D) pole ograniczające geometrii A przecina n-"
+"wymiarowe (n-D) pole ograniczające geometrii B."
+
+#. Tag: para
+#: reference_operator.xml:118
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr "Dostępność: 2.0.0"
+
+#. Tag: para
+#: reference_operator.xml:121
+#, no-c-format
+msgid "&T_support;"
+msgstr "&T_support;"
+
+#. Tag: para
+#: reference_operator.xml:122
+#, no-c-format
+msgid "&Z_support;"
+msgstr "&Z_support;"
+
+#. Tag: title
+#: reference_operator.xml:126
+#, no-c-format
+msgid "Examples: 3D LineStrings"
+msgstr "Przykłady: 3D LineStrings"
+
+#. Tag: programlisting
+#: reference_operator.xml:128
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 "
+"AS overlaps_3d, \n"
+" tbl1.column2 && tbl2.column2 AS "
+"overlaps_2d\n"
+"FROM ( VALUES\n"
+" (1, 'LINESTRING Z(0 0 1, 3 3 2)'::geometry),\n"
+" (2, 'LINESTRING Z(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n"
+"( VALUES\n"
+" (3, 'LINESTRING Z(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overlaps_3d | overlaps_2d\n"
+"---------+---------+-------------+-------------\n"
+" 1 | 3 | t | t\n"
+" 2 | 3 | f | t"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 "
+"AS overlaps_3d, \n"
+" tbl1.column2 && tbl2.column2 AS "
+"overlaps_2d\n"
+"FROM ( VALUES\n"
+" (1, 'LINESTRING Z(0 0 1, 3 3 2)'::geometry),\n"
+" (2, 'LINESTRING Z(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n"
+"( VALUES\n"
+" (3, 'LINESTRING Z(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overlaps_3d | overlaps_2d\n"
+"---------+---------+-------------+-------------\n"
+" 1 | 3 | t | t\n"
+" 2 | 3 | f | t"
+
+#. Tag: title
+#: reference_operator.xml:132
+#, no-c-format
+msgid "Examples: 3M LineStrings"
+msgstr "Przykłady: 3M LineStrings"
+
+#. Tag: programlisting
+#: reference_operator.xml:134
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 "
+"AS overlaps_3zm, \n"
+" tbl1.column2 && tbl2.column2 AS "
+"overlaps_2d\n"
+"FROM ( VALUES\n"
+" (1, 'LINESTRING M(0 0 1, 3 3 2)'::geometry),\n"
+" (2, 'LINESTRING M(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n"
+"( VALUES\n"
+" (3, 'LINESTRING M(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overlaps_3zm | overlaps_2d\n"
+"---------+---------+-------------+-------------\n"
+" 1 | 3 | t | t\n"
+" 2 | 3 | f | t"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 "
+"AS overlaps_3zm, \n"
+" tbl1.column2 && tbl2.column2 AS "
+"overlaps_2d\n"
+"FROM ( VALUES\n"
+" (1, 'LINESTRING M(0 0 1, 3 3 2)'::geometry),\n"
+" (2, 'LINESTRING M(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n"
+"( VALUES\n"
+" (3, 'LINESTRING M(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overlaps_3zm | overlaps_2d\n"
+"---------+---------+-------------+-------------\n"
+" 1 | 3 | t | t\n"
+" 2 | 3 | f | t"
+
+#. Tag: refname
+#: reference_operator.xml:147
+#, no-c-format
+msgid "&<"
+msgstr "&<"
+
+#. Tag: refpurpose
+#: reference_operator.xml:149
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box overlaps or is to the "
+"left of B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:154
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>&<</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>&<</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:178
+#, no-c-format
+msgid ""
+"The <varname>&<</varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of geometry A overlaps or is to the left of the bounding "
+"box of geometry B, or more accurately, overlaps or is NOT to the right of "
+"the bounding box of geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:189
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &< tbl2.column2 AS "
+"overleft\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overleft\n"
+"---------+---------+----------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | f\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &< tbl2.column2 AS "
+"overleft\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overleft\n"
+"---------+---------+----------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | f\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:195
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Overabove\"/>, <xref linkend="
+"\"ST_Geometry_Overright\"/>, <xref linkend=\"ST_Geometry_Overbelow\"/>"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Overabove\"/>, <xref linkend="
+"\"ST_Geometry_Overright\"/>, <xref linkend=\"ST_Geometry_Overbelow\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:205
+#, no-c-format
+msgid "&<|"
+msgstr "&<|"
+
+#. Tag: refpurpose
+#: reference_operator.xml:207
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box overlaps or is below B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:212
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>&<|</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>&<|</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:236
+#, no-c-format
+msgid ""
+"The <varname>&<|</varname> operator returns <varname>TRUE</varname> "
+"if the bounding box of geometry A overlaps or is below of the bounding box "
+"of geometry B, or more accurately, overlaps or is NOT above the bounding box "
+"of geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:250
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &<| tbl2.column2 AS "
+"overbelow\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overbelow\n"
+"---------+---------+-----------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | t\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &<| tbl2.column2 AS "
+"overbelow\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overbelow\n"
+"---------+---------+-----------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | t\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:256
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Overabove\"/>, <xref linkend="
+"\"ST_Geometry_Overright\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Overabove\"/>, <xref linkend="
+"\"ST_Geometry_Overright\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:266
+#, no-c-format
+msgid "&>"
+msgstr "&>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:268
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A' bounding box overlaps or is to the "
+"right of B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:273
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>&></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>&></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:297
+#, no-c-format
+msgid ""
+"The <varname>&></varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of geometry A overlaps or is to the right of the bounding "
+"box of geometry B, or more accurately, overlaps or is NOT to the left of the "
+"bounding box of geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:308
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &> tbl2.column2 AS "
+"overright\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overright\n"
+"---------+---------+-----------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | t\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &> tbl2.column2 AS "
+"overright\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overright\n"
+"---------+---------+-----------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | t\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:314
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Overabove\"/>, <xref linkend="
+"\"ST_Geometry_Overbelow\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Overabove\"/>, <xref linkend="
+"\"ST_Geometry_Overbelow\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:324
+#, no-c-format
+msgid "<<"
+msgstr "<<"
+
+#. Tag: refpurpose
+#: reference_operator.xml:326
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is strictly to the left "
+"of B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:331
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function><<</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function><<</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:355
+#, no-c-format
+msgid ""
+"The <varname><<</varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of geometry A is strictly to the left of the bounding box "
+"of geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:365
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 << tbl2.column2 AS "
+"left\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (1 2, 1 5)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 3)'::geometry),\n"
+" (3, 'LINESTRING (6 0, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (2 2, 5 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | left\n"
+"---------+---------+------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | t\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 << tbl2.column2 AS "
+"left\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (1 2, 1 5)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 3)'::geometry),\n"
+" (3, 'LINESTRING (6 0, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (2 2, 5 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | left\n"
+"---------+---------+------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | t\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:371 reference_operator.xml:564
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Above\"/>, <xref linkend=\"ST_Geometry_Below\"/"
+">"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Above\"/>, <xref linkend=\"ST_Geometry_Below\"/"
+">"
+
+#. Tag: refname
+#: reference_operator.xml:377
+#, no-c-format
+msgid "<<|"
+msgstr "<<|"
+
+#. Tag: refpurpose
+#: reference_operator.xml:379
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is strictly below B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:384
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function><<|</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function><<|</function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:408
+#, no-c-format
+msgid ""
+"The <varname><<|</varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of geometry A is strictly below the bounding box of "
+"geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:418
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 <<| tbl2.column2 AS "
+"below\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n"
+" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | below\n"
+"---------+---------+-------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 <<| tbl2.column2 AS "
+"below\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n"
+" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | below\n"
+"---------+---------+-------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:424
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Right\"/>, <xref linkend=\"ST_Geometry_Above\"/"
+">"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Right\"/>, <xref linkend=\"ST_Geometry_Above\"/"
+">"
+
+#. Tag: refname
+#: reference_operator.xml:430
+#, no-c-format
+msgid "="
+msgstr "="
+
+#. Tag: refpurpose
+#: reference_operator.xml:432
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is the same as B's. Uses "
+"double precision bounding box."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_operator.xml:436
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>=</function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>=</function></"
+"funcdef> <paramdef> <type>geography </type> <parameter>A</parameter> </"
+"paramdef> <paramdef> <type>geography </type> <parameter>B</parameter> </"
+"paramdef> </funcprototype>"
+msgstr ""
+"<funcprototype> <funcdef>boolean <function>=</function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>=</function></"
+"funcdef> <paramdef> <type>geography </type> <parameter>A</parameter> </"
+"paramdef> <paramdef> <type>geography </type> <parameter>B</parameter> </"
+"paramdef> </funcprototype>"
+
+#. Tag: para
+#: reference_operator.xml:477
+#, no-c-format
+msgid ""
+"The <varname>=</varname> operator returns <varname>TRUE</varname> if the "
+"bounding box of geometry/geography A is the same as the bounding box of "
+"geometry/geography B. PostgreSQL uses the =, <, and > operators "
+"defined for geometries to perform internal orderings and comparison of "
+"geometries (ie. in a GROUP BY or ORDER BY clause)."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:482
+#, no-c-format
+msgid ""
+"This is cause for a lot of confusion. When you compare geometryA = geometryB "
+"it will return true even when the geometries are clearly different IF their "
+"bounding boxes are the same. To check for true equality use <xref linkend="
+"\"ST_OrderingEquals\"/> or <xref linkend=\"ST_Equals\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:489
+#, no-c-format
+msgid ""
+"This operand will NOT make use of any indexes that may be available on the "
+"geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:494
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 , the bounding box of geometries was changed to use double "
+"precision instead of float4 precision of prior. The side effect of this is "
+"that in particular points in prior versions that were a little different may "
+"have returned true in prior versions and false in 2.0+ since their float4 "
+"boxes would be the same but there float8 (double precision), would be "
+"different."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:504
+#, no-c-format
+msgid ""
+"SELECT 'LINESTRING(0 0, 0 1, 1 0)'::geometry = 'LINESTRING(1 1, 0 0)'::"
+"geometry;\n"
+" ?column?\n"
+"----------\n"
+" t\n"
+"(1 row)\n"
+"\n"
+"SELECT ST_AsText(column1)\n"
+"FROM ( VALUES\n"
+" ('LINESTRING(0 0, 1 1)'::geometry),\n"
+" ('LINESTRING(1 1, 0 0)'::geometry)) AS foo;\n"
+" st_astext\n"
+"---------------------\n"
+" LINESTRING(0 0,1 1)\n"
+" LINESTRING(1 1,0 0)\n"
+"(2 rows)\n"
+"\n"
+"-- Note: the GROUP BY uses the \"=\" to compare for geometry equivalency.\n"
+"SELECT ST_AsText(column1)\n"
+"FROM ( VALUES\n"
+" ('LINESTRING(0 0, 1 1)'::geometry),\n"
+" ('LINESTRING(1 1, 0 0)'::geometry)) AS foo\n"
+"GROUP BY column1;\n"
+" st_astext\n"
+"---------------------\n"
+" LINESTRING(0 0,1 1)\n"
+"(1 row)\n"
+"\n"
+"-- In versions prior to 2.0, this used to return true --\n"
+" SELECT ST_GeomFromText('POINT(1707296.37 4820536.77)') =\n"
+" ST_GeomFromText('POINT(1707296.27 4820536.87)') As pt_intersect;\n"
+" \n"
+"--pt_intersect --\n"
+"f"
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:510
+#, no-c-format
+msgid ", <xref linkend=\"ST_OrderingEquals\"/>"
+msgstr ", <xref linkend=\"ST_OrderingEquals\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:517
+#, no-c-format
+msgid ">>"
+msgstr ">>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:519
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is strictly to the right "
+"of B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:524
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>>></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>>></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:548
+#, no-c-format
+msgid ""
+"The <varname>>></varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of geometry A is strictly to the right of the bounding box "
+"of geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:558
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 >> tbl2.column2 AS "
+"right\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n"
+" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | right\n"
+"---------+---------+-------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 >> tbl2.column2 AS "
+"right\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n"
+" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | right\n"
+"---------+---------+-------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+
+#. Tag: refname
+#: reference_operator.xml:570
+#, no-c-format
+msgid "<refname>@</refname>"
+msgstr "<refname>@</refname>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:572
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is contained by B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:577
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>@</function></funcdef> <paramdef> <type>geometry "
+"</type> <parameter>A</parameter> </paramdef> <paramdef> <type>geometry </"
+"type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>@</function></funcdef> <paramdef> <type>geometry "
+"</type> <parameter>A</parameter> </paramdef> <paramdef> <type>geometry </"
+"type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:601
+#, no-c-format
+msgid ""
+"The <varname>@</varname> operator returns <varname>TRUE</varname> if the "
+"bounding box of geometry A is completely contained by the bounding box of "
+"geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:613
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 @ tbl2.column2 AS contained\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n"
+" (3, 'LINESTRING (2 2, 4 4)'::geometry),\n"
+" (4, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | contained\n"
+"---------+---------+-----------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 @ tbl2.column2 AS contained\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n"
+" (3, 'LINESTRING (2 2, 4 4)'::geometry),\n"
+" (4, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | contained\n"
+"---------+---------+-----------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:619 reference_operator.xml:783
+#, no-c-format
+msgid ", <xref linkend=\"geometry_overlaps\"/>"
+msgstr ", <xref linkend=\"geometry_overlaps\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:625
+#, no-c-format
+msgid "|&>"
+msgstr "|&>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:627
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box overlaps or is above B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:632
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>|&></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>|&></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:656
+#, no-c-format
+msgid ""
+"The <varname>|&></varname> operator returns <varname>TRUE</varname> "
+"if the bounding box of geometry A overlaps or is above the bounding box of "
+"geometry B, or more accurately, overlaps or is NOT below the bounding box of "
+"geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:667
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |&> tbl2.column2 AS "
+"overabove\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overabove\n"
+"---------+---------+-----------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |&> tbl2.column2 AS "
+"overabove\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n"
+" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n"
+" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | overabove\n"
+"---------+---------+-----------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:673
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Overright\"/>, <xref linkend="
+"\"ST_Geometry_Overbelow\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Overright\"/>, <xref linkend="
+"\"ST_Geometry_Overbelow\"/>, <xref linkend=\"ST_Geometry_Overleft\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:683
+#, no-c-format
+msgid "|>>"
+msgstr "|>>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:685
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is strictly above B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:690
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>|>></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>|>></function></funcdef> <paramdef> "
+"<type>geometry </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:714
+#, no-c-format
+msgid ""
+"The <varname>|>></varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of geometry A is strictly to the right of the bounding box "
+"of geometry B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:724
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |>> tbl2.column2 AS "
+"above\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (1 4, 1 7)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 2)'::geometry),\n"
+" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | above\n"
+"---------+---------+-------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |>> tbl2.column2 AS "
+"above\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (1 4, 1 7)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 2)'::geometry),\n"
+" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n"
+" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | above\n"
+"---------+---------+-------\n"
+" 1 | 2 | t\n"
+" 1 | 3 | f\n"
+" 1 | 4 | f\n"
+"(3 rows)"
+
+#. Tag: para
+#: reference_operator.xml:730
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Geometry_Right\"/>, <xref linkend=\"ST_Geometry_Below\"/"
+">"
+msgstr ""
+", <xref linkend=\"ST_Geometry_Right\"/>, <xref linkend=\"ST_Geometry_Below\"/"
+">"
+
+#. Tag: refname
+#: reference_operator.xml:736
+#, no-c-format
+msgid "<refname>~</refname>"
+msgstr "<refname>~</refname>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:738
+#, no-c-format
+msgid "Returns <varname>TRUE</varname> if A's bounding box contains B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:743
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>~</function></funcdef> <paramdef> <type>geometry "
+"</type> <parameter>A</parameter> </paramdef> <paramdef> <type>geometry </"
+"type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>~</function></funcdef> <paramdef> <type>geometry "
+"</type> <parameter>A</parameter> </paramdef> <paramdef> <type>geometry </"
+"type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:767
+#, no-c-format
+msgid ""
+"The <varname>~</varname> operator returns <varname>TRUE</varname> if the "
+"bounding box of geometry A completely contains the bounding box of geometry "
+"B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:777
+#, no-c-format
+msgid ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 ~ tbl2.column2 AS contains\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n"
+" (3, 'LINESTRING (1 1, 2 2)'::geometry),\n"
+" (4, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | contains\n"
+"---------+---------+----------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | t\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+msgstr ""
+"SELECT tbl1.column1, tbl2.column1, tbl1.column2 ~ tbl2.column2 AS contains\n"
+"FROM\n"
+" ( VALUES\n"
+" (1, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl1,\n"
+" ( VALUES\n"
+" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n"
+" (3, 'LINESTRING (1 1, 2 2)'::geometry),\n"
+" (4, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl2;\n"
+"\n"
+" column1 | column1 | contains\n"
+"---------+---------+----------\n"
+" 1 | 2 | f\n"
+" 1 | 3 | t\n"
+" 1 | 4 | t\n"
+"(3 rows)"
+
+#. Tag: refname
+#: reference_operator.xml:789
+#, no-c-format
+msgid "<refname>~=</refname>"
+msgstr "<refname>~=</refname>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:791
+#, no-c-format
+msgid "Returns <varname>TRUE</varname> if A's bounding box is the same as B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:796
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>~=</function></funcdef> <paramdef> <type>geometry "
+"</type> <parameter>A</parameter> </paramdef> <paramdef> <type>geometry </"
+"type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>boolean <function>~=</function></funcdef> <paramdef> <type>geometry "
+"</type> <parameter>A</parameter> </paramdef> <paramdef> <type>geometry </"
+"type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:820
+#, no-c-format
+msgid ""
+"The <varname>~=</varname> operator returns <varname>TRUE</varname> if the "
+"bounding box of geometry/geography A is the same as the bounding box of "
+"geometry/geography B."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:826
+#, no-c-format
+msgid "Availability: 1.5.0 changed behavior"
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:830
+#, no-c-format
+msgid ""
+"This operator has changed behavior in PostGIS 1.5 from testing for actual "
+"geometric equality to only checking for bounding box equality. To complicate "
+"things it also depends on if you have done a hard or soft upgrade which "
+"behavior your database has. To find out which behavior your database has you "
+"can run the query below. To check for true equality use <xref linkend="
+"\"ST_OrderingEquals\"/> or <xref linkend=\"ST_Equals\"/> and to check for "
+"bounding box equality <xref linkend=\"ST_Geometry_EQ\"/>; operator is a "
+"safer option."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:844
+#, no-c-format
+msgid ""
+"select 'LINESTRING(0 0, 1 1)'::geometry ~= 'LINESTRING(0 1, 1 0)'::geometry "
+"as equality;\n"
+" equality |\n"
+"-----------------+\n"
+" t |"
+msgstr ""
+"select 'LINESTRING(0 0, 1 1)'::geometry ~= 'LINESTRING(0 1, 1 0)'::geometry "
+"as equality;\n"
+" equality |\n"
+"-----------------+\n"
+" t |"
+
+#. Tag: para
+#: reference_operator.xml:845
+#, no-c-format
+msgid ""
+"The above can be used to test if you have the new or old behavior of ~= "
+"operator."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:849
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_OrderingEquals\"/>, <xref linkend=\"ST_Geometry_EQ\"/>"
+msgstr ""
+", <xref linkend=\"ST_OrderingEquals\"/>, <xref linkend=\"ST_Geometry_EQ\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:855
+#, no-c-format
+msgid "<->"
+msgstr "<->"
+
+#. Tag: refpurpose
+#: reference_operator.xml:857
+#, no-c-format
+msgid ""
+"Returns the distance between two points. For point / point checks it uses "
+"floating point accuracy (as opposed to the double precision accuracy of the "
+"underlying point geometry). For other geometry types the distance between "
+"the floating point bounding box centroids is returned. Useful for doing "
+"distance ordering and nearest neighbor limits using KNN gist functionality."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:864
+#, no-c-format
+msgid ""
+"<funcdef>double precision <function><-></function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>double precision <function><-></function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:885
+#, no-c-format
+msgid ""
+"The <varname><-></varname> operator returns distance between two "
+"points read from the spatial index for points (float precision). For other "
+"geometries it returns the distance from centroid of bounding box of "
+"geometries. Useful for doing nearest neighbor <emphasis role=\"strong"
+"\">approximate</emphasis> distance ordering."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:888 reference_operator.xml:953
+#, no-c-format
+msgid ""
+"This operand will make use of any indexes that may be available on the "
+"geometries. It is different from other operators that use spatial indexes in "
+"that the spatial index is only used when the operator is in the ORDER BY "
+"clause."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:891
+#, no-c-format
+msgid ""
+"Index only kicks in if one of the geometries is a constant (not in a "
+"subquery/cte). e.g. 'SRID=3005;POINT(1011102 450541)'::geometry instead of a."
+"geom"
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:893 reference_operator.xml:958
+#, no-c-format
+msgid "Availability: 2.0.0 only available for PostgreSQL 9.1+"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:900
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT ST_Distance(geom, 'SRID=3005;POINT(1011102 450541)'::"
+"geometry) as d,edabbr, vaabbr \n"
+"FROM va2005 \n"
+"ORDER BY d limit 10;]]>\n"
+"\n"
+" d | edabbr | vaabbr\n"
+"------------------+--------+--------\n"
+" 0 | ALQ | 128\n"
+" 5541.57712511724 | ALQ | 129A\n"
+" 5579.67450712005 | ALQ | 001\n"
+" 6083.4207708641 | ALQ | 131\n"
+" 7691.2205404848 | ALQ | 003\n"
+" 7900.75451037313 | ALQ | 122\n"
+" 8694.20710669982 | ALQ | 129B\n"
+" 9564.24289057111 | ALQ | 130\n"
+" 12089.665931705 | ALQ | 127\n"
+" 18472.5531479404 | ALQ | 002\n"
+"(10 rows)"
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:901
+#, no-c-format
+msgid "Then the KNN raw answer:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:904
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT st_distance(geom, 'SRID=3005;POINT(1011102 450541)'::"
+"geometry) as d,edabbr, vaabbr \n"
+"FROM va2005 \n"
+"ORDER BY geom <-> 'SRID=3005;POINT(1011102 450541)'::geometry limit 10;]]>\n"
+"\n"
+" d | edabbr | vaabbr\n"
+"------------------+--------+--------\n"
+" 0 | ALQ | 128\n"
+" 5579.67450712005 | ALQ | 001\n"
+" 5541.57712511724 | ALQ | 129A\n"
+" 8694.20710669982 | ALQ | 129B\n"
+" 9564.24289057111 | ALQ | 130\n"
+" 6083.4207708641 | ALQ | 131\n"
+" 12089.665931705 | ALQ | 127\n"
+" 24795.264503022 | ALQ | 124\n"
+" 24587.6584922302 | ALQ | 123\n"
+" 26764.2555463114 | ALQ | 125\n"
+"(10 rows)"
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:905
+#, no-c-format
+msgid ""
+"Note the misordering in the actual distances and the different entries that "
+"actually show up in the top 10."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:909
+#, no-c-format
+msgid "Finally the hybrid:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:912
+#, no-c-format
+msgid ""
+"<![CDATA[WITH index_query AS (\n"
+" SELECT ST_Distance(geom, 'SRID=3005;POINT(1011102 450541)'::geometry) as d,"
+"edabbr, vaabbr\n"
+" FROM va2005\n"
+" ORDER BY geom <-> 'SRID=3005;POINT(1011102 450541)'::geometry LIMIT 100) \n"
+" SELECT * \n"
+" FROM index_query \n"
+" ORDER BY d limit 10;]]>\n"
+"\n"
+" d | edabbr | vaabbr\n"
+"------------------+--------+--------\n"
+" 0 | ALQ | 128\n"
+" 5541.57712511724 | ALQ | 129A\n"
+" 5579.67450712005 | ALQ | 001\n"
+" 6083.4207708641 | ALQ | 131\n"
+" 7691.2205404848 | ALQ | 003\n"
+" 7900.75451037313 | ALQ | 122\n"
+" 8694.20710669982 | ALQ | 129B\n"
+" 9564.24289057111 | ALQ | 130\n"
+" 12089.665931705 | ALQ | 127\n"
+" 18472.5531479404 | ALQ | 002\n"
+"(10 rows)"
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:916
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Distance\"/>, <xref linkend=\"geometry_distance_box\"/>"
+msgstr ""
+", <xref linkend=\"ST_Distance\"/>, <xref linkend=\"geometry_distance_box\"/>"
+
+#. Tag: refname
+#: reference_operator.xml:922
+#, no-c-format
+msgid "<#>"
+msgstr "<#>"
+
+#. Tag: refpurpose
+#: reference_operator.xml:924
+#, no-c-format
+msgid ""
+"Returns the distance between bounding box of 2 geometries. For point / point "
+"checks it's almost the same as distance (though may be different since the "
+"bounding box is at floating point accuracy and geometries are double "
+"precision). Useful for doing distance ordering and nearest neighbor limits "
+"using KNN gist functionality."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_operator.xml:930
+#, no-c-format
+msgid ""
+"<funcdef>double precision <function><#></function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+"<funcdef>double precision <function><#></function></funcdef> "
+"<paramdef> <type>geometry </type> <parameter>A</parameter> </paramdef> "
+"<paramdef> <type>geometry </type> <parameter>B</parameter> </paramdef>"
+
+#. Tag: para
+#: reference_operator.xml:951
+#, no-c-format
+msgid ""
+"The <varname><#></varname> KNN GIST operator returns distance between "
+"two floating point bounding boxes read from the spatial index if available. "
+"Useful for doing nearest neighbor <emphasis role=\"strong\">approximate</"
+"emphasis> distance ordering."
+msgstr ""
+
+#. Tag: para
+#: reference_operator.xml:956
+#, no-c-format
+msgid ""
+"Index only kicks in if one of the geometries is a constant e.g. ORDER BY "
+"(ST_GeomFromText('POINT(1 2)') <#> geom) instead of g1.geom <#>."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_operator.xml:964
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT *\n"
+"FROM (\n"
+"SELECT b.tlid, b.mtfcc, \n"
+" b.geom <#> ST_GeomFromText('LINESTRING(746149 2948672,745954 "
+"2948576,\n"
+" 745787 2948499,745740 2948468,745712 2948438,\n"
+" 745690 2948384,745677 2948319)',2249) As b_dist, \n"
+" ST_Distance(b.geom, ST_GeomFromText('LINESTRING(746149 "
+"2948672,745954 2948576,\n"
+" 745787 2948499,745740 2948468,745712 2948438,\n"
+" 745690 2948384,745677 2948319)',2249)) As act_dist\n"
+" FROM bos_roads As b \n"
+" ORDER BY b_dist, b.tlid\n"
+" LIMIT 100) As foo\n"
+" ORDER BY act_dist, tlid LIMIT 10;]]>\n"
+"\n"
+" tlid | mtfcc | b_dist | act_dist\n"
+"-----------+-------+------------------+------------------\n"
+" 85732027 | S1400 | 0 | 0\n"
+" 85732029 | S1400 | 0 | 0\n"
+" 85732031 | S1400 | 0 | 0\n"
+" 85734335 | S1400 | 0 | 0\n"
+" 85736037 | S1400 | 0 | 0\n"
+" 624683742 | S1400 | 0 | 128.528874268666\n"
+" 85719343 | S1400 | 260.839270432962 | 260.839270432962\n"
+" 85741826 | S1400 | 164.759294123275 | 260.839270432962\n"
+" 85732032 | S1400 | 277.75 | 311.830282365264\n"
+" 85735592 | S1400 | 222.25 | 311.830282365264\n"
+"(10 rows)"
+msgstr ""
+"<![CDATA[SELECT *\n"
+"FROM (\n"
+"SELECT b.tlid, b.mtfcc, \n"
+" b.geom <#> ST_GeomFromText('LINESTRING(746149 2948672,745954 "
+"2948576,\n"
+" 745787 2948499,745740 2948468,745712 2948438,\n"
+" 745690 2948384,745677 2948319)',2249) As b_dist, \n"
+" ST_Distance(b.geom, ST_GeomFromText('LINESTRING(746149 "
+"2948672,745954 2948576,\n"
+" 745787 2948499,745740 2948468,745712 2948438,\n"
+" 745690 2948384,745677 2948319)',2249)) As act_dist\n"
+" FROM bos_roads As b \n"
+" ORDER BY b_dist, b.tlid\n"
+" LIMIT 100) As foo\n"
+" ORDER BY act_dist, tlid LIMIT 10;]]>\n"
+"\n"
+" tlid | mtfcc | b_dist | act_dist\n"
+"-----------+-------+------------------+------------------\n"
+" 85732027 | S1400 | 0 | 0\n"
+" 85732029 | S1400 | 0 | 0\n"
+" 85732031 | S1400 | 0 | 0\n"
+" 85734335 | S1400 | 0 | 0\n"
+" 85736037 | S1400 | 0 | 0\n"
+" 624683742 | S1400 | 0 | 128.528874268666\n"
+" 85719343 | S1400 | 260.839270432962 | 260.839270432962\n"
+" 85741826 | S1400 | 164.759294123275 | 260.839270432962\n"
+" 85732032 | S1400 | 277.75 | 311.830282365264\n"
+" 85735592 | S1400 | 222.25 | 311.830282365264\n"
+"(10 rows)"
+
+#. Tag: para
+#: reference_operator.xml:968
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Distance\"/>, <xref linkend=\"geometry_distance_centroid"
+"\"/>"
+msgstr ""
+", <xref linkend=\"ST_Distance\"/>, <xref linkend=\"geometry_distance_centroid"
+"\"/>"
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2014-10-14 21:54+0000\n"
+"PO-Revision-Date: 2014-10-14 22:36+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_output.xml:4
+#, no-c-format
+msgid "Geometry Outputs"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:7
+#, no-c-format
+msgid "ST_AsBinary"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:8
+#, no-c-format
+msgid ""
+"Return the Well-Known Binary (WKB) representation of the geometry/geography "
+"without SRID meta data."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:12
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>bytea <function>ST_AsBinary</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>bytea <function>ST_AsBinary</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>g1</"
+"parameter></paramdef> <paramdef><type>text </type><parameter>NDR_or_XDR</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bytea "
+"<function>ST_AsBinary</function></funcdef> <paramdef><type>geography </type> "
+"<parameter>g1</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>bytea <function>ST_AsBinary</function></funcdef> "
+"<paramdef><type>geography </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>text </type><parameter>NDR_or_XDR</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:35 reference_output.xml:109 reference_output.xml:162
+#: reference_output.xml:238 reference_output.xml:339 reference_output.xml:440
+#: reference_output.xml:496 reference_output.xml:561 reference_output.xml:604
+#: reference_output.xml:707 reference_output.xml:755 reference_output.xml:813
+#: reference_output.xml:879 reference_output.xml:944 reference_output.xml:988
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:37
+#, no-c-format
+msgid ""
+"Returns the Well-Known Binary representation of the geometry. There are 2 "
+"variants of the function. The first variant takes no endian encoding "
+"parameter and defaults to server machine endian. The second variant takes a "
+"second argument denoting the encoding - using little-endian ('NDR') or big-"
+"endian ('XDR') encoding."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:40 reference_output.xml:113
+#, no-c-format
+msgid ""
+"This is useful in binary cursors to pull data out of the database without "
+"converting it to a string representation."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:44
+#, no-c-format
+msgid ""
+"The WKB spec does not include the SRID. To get the WKB with SRID format use "
+"ST_AsEWKB"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:47
+#, no-c-format
+msgid ""
+"ST_AsBinary is the reverse of <xref linkend=\"ST_GeomFromWKB\"/> for "
+"geometry. Use <xref linkend=\"ST_GeomFromWKB\"/> to convert to a postgis "
+"geometry from ST_AsBinary representation."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:51
+#, no-c-format
+msgid ""
+"The default behavior in PostgreSQL 9.0 has been changed to output bytea in "
+"hex encoding. ST_AsBinary is the reverse of <xref linkend=\"ST_GeomFromWKB\"/"
+"> for geometry. If your GUI tools require the old behavior, then SET "
+"bytea_output='escape' in your database."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:55 reference_output.xml:121
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was "
+"introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:56
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for higher coordinate dimensions was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:57
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for specifying endian with geography was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:58 reference_output.xml:279 reference_output.xml:383
+#, no-c-format
+msgid "Availability: 1.5.0 geography support was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:59
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 Inputs to this function can not be unknown -- must be "
+"geometry. Constructs such as <code>ST_AsBinary('POINT(1 2)')</code> are no "
+"longer valid and you will get an <code>n st_asbinary(unknown) is not unique "
+"error</code>. Code like that needs to be changed to "
+"<code>ST_AsBinary('POINT(1 2)'::geometry);</code>. If that is not possible, "
+"then install <filename>legacy.sql</filename>."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:61 reference_output.xml:771
+#, no-c-format
+msgid "&sfs_compliant; s2.1.1.1"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:62
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.37"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:63 reference_output.xml:123 reference_output.xml:177
+#: reference_output.xml:449 reference_output.xml:721 reference_output.xml:773
+#, no-c-format
+msgid "&curve_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:64 reference_output.xml:124 reference_output.xml:178
+#: reference_output.xml:390 reference_output.xml:664
+#, no-c-format
+msgid "&P_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:65 reference_output.xml:125 reference_output.xml:179
+#: reference_output.xml:391 reference_output.xml:667
+#, no-c-format
+msgid "&T_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:66 reference_output.xml:122 reference_output.xml:176
+#: reference_output.xml:281 reference_output.xml:389 reference_output.xml:448
+#: reference_output.xml:523 reference_output.xml:662
+#, no-c-format
+msgid "&Z_support;"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:71 reference_output.xml:130 reference_output.xml:184
+#: reference_output.xml:285 reference_output.xml:453 reference_output.xml:527
+#: reference_output.xml:580 reference_output.xml:725 reference_output.xml:778
+#: reference_output.xml:842 reference_output.xml:896 reference_output.xml:961
+#: reference_output.xml:997
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:73
+#, no-c-format
+msgid ""
+"SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n"
+"\n"
+" st_asbinary\n"
+"--------------------------------\n"
+"\\001\\003\\000\\000\\000\\001\\000\\000\\000\\005\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\360?\\000\\000\\000\\000\\000\\000\n"
+"\\360?\\000\\000\\000\\000\\000\\000\\360?\\000\\000\n"
+"\\000\\000\\000\\000\\360?\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:74
+#, no-c-format
+msgid ""
+"SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), "
+"'XDR');\n"
+" st_asbinary\n"
+"--------------------------------\n"
+"\\000\\000\\000\\000\\003\\000\\000\\000\\001\\000\\000\\000\\005\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000?\\360\\000\\000\\000\\000\\000\\000?"
+"\\360\\000\\000\\000\\000\\000\\000?\\360\\000\\000\n"
+"\\000\\000\\000\\000?"
+"\\360\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:79 reference_output.xml:138 reference_output.xml:191
+#: reference_output.xml:409 reference_output.xml:531 reference_output.xml:729
+#: reference_output.xml:785 reference_output.xml:901 reference_output.xml:966
+#: reference_output.xml:1002
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:80
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsEWKB\"/>, <xref linkend=\"ST_AsTWKB\"/>, <xref "
+"linkend=\"ST_AsText\"/>,"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:90
+#, no-c-format
+msgid "ST_AsEWKB"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:91
+#, no-c-format
+msgid ""
+"Return the Well-Known Binary (WKB) representation of the geometry with SRID "
+"meta data."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:95
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>bytea <function>ST_AsEWKB</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>bytea <function>ST_AsEWKB</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>g1</"
+"parameter></paramdef> <paramdef><type>text </type><parameter>NDR_or_XDR</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:110
+#, no-c-format
+msgid ""
+"Returns the Well-Known Binary representation of the geometry with SRID "
+"metadata. There are 2 variants of the function. The first variant takes no "
+"endian encoding parameter and defaults to little endian. The second variant "
+"takes a second argument denoting the encoding - using little-endian ('NDR') "
+"or big-endian ('XDR') encoding."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:116
+#, no-c-format
+msgid ""
+"The WKB spec does not include the SRID. To get the OGC WKB format use "
+"ST_AsBinary"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:119
+#, no-c-format
+msgid ""
+"ST_AsEWKB is the reverse of ST_GeomFromEWKB. Use ST_GeomFromEWKB to convert "
+"to a postgis geometry from ST_AsEWKB representation."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:132
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n"
+"\n"
+" st_asewkb\n"
+"--------------------------------\n"
+"\\001\\003\\000\\000 \\346\\020\\000\\000\\001\\000\n"
+"\\000\\000\\005\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\360?\\000\\000\\000\\000\\000\\000\\360?\n"
+"\\000\\000\\000\\000\\000\\000\\360?\\000\\000\\000\\000\\000\n"
+"\\000\\360?\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:133
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), "
+"'XDR');\n"
+" st_asewkb\n"
+"--------------------------------\n"
+"\\000 "
+"\\000\\000\\003\\000\\000\\020\\346\\000\\000\\000\\001\\000\\000\\000\\005\\000\\000\\000\\000\\\n"
+"000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000?\n"
+"\\360\\000\\000\\000\\000\\000\\000?\\360\\000\\000\\000\\000\\000\\000?"
+"\\360\\000\\000\\000\\000\n"
+"\\000\\000?"
+"\\360\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n"
+"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:139
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_AsText\"/>, <xref "
+"linkend=\"ST_GeomFromEWKT\"/>, <xref linkend=\"ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:144
+#, no-c-format
+msgid "ST_AsEWKT"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:145
+#, no-c-format
+msgid ""
+"Return the Well-Known Text (WKT) representation of the geometry with SRID "
+"meta data."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:149
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsEWKT</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsEWKT</function></"
+"funcdef> <paramdef><type>geography </type> <parameter>g1</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:164
+#, no-c-format
+msgid ""
+"Returns the Well-Known Text representation of the geometry prefixed with the "
+"SRID."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:167
+#, no-c-format
+msgid ""
+"The WKT spec does not include the SRID. To get the OGC WKT format use "
+"ST_AsText"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:169 reference_output.xml:763
+#, no-c-format
+msgid ""
+"WKT format does not maintain precision so to prevent floating truncation, "
+"use ST_AsBinary or ST_AsEWKB format for transport."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:173
+#, no-c-format
+msgid ""
+"ST_AsEWKT is the reverse of <xref linkend=\"ST_GeomFromEWKT\"/>. Use <xref "
+"linkend=\"ST_GeomFromEWKT\"/> to convert to a postgis geometry from "
+"ST_AsEWKT representation."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:175
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and "
+"TIN was introduced."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:186
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT('0103000020E61000000100000005000000000000\n"
+" 000000000000000000000000000000000000000000000000000000\n"
+" F03F000000000000F03F000000000000F03F000000000000F03\n"
+" F000000000000000000000000000000000000000000000000'::"
+"geometry);\n"
+"\n"
+" st_asewkt\n"
+"--------------------------------\n"
+"SRID=4326;POLYGON((0 0,0 1,1 1,1 0,0 0))\n"
+"(1 row)\n"
+"\n"
+"SELECT "
+"ST_AsEWKT('0108000080030000000000000060E30A4100000000785C0241000000000000F03F0000000018\n"
+"E20A4100000000485F024100000000000000400000000018\n"
+"E20A4100000000305C02410000000000000840')\n"
+"\n"
+"--st_asewkt---\n"
+"CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:192
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsEWKB\"/>, <xref linkend=\"ST_AsText\"/>, <xref "
+"linkend=\"ST_GeomFromEWKT\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:201
+#, no-c-format
+msgid "ST_AsGeoJSON"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:203
+#, no-c-format
+msgid "Return the geometry as a GeoJSON element."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:207
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsGeoJSON</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsGeoJSON</"
+"function></funcdef> <paramdef><type>geography </type> <parameter>geog</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsGeoJSON</"
+"function></funcdef> <paramdef><type>integer </type> <parameter>gj_version</"
+"parameter></paramdef> <paramdef><type>geometry </type> <parameter>geom</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsGeoJSON</"
+"function></funcdef> <paramdef><type>integer </type> <parameter>gj_version</"
+"parameter></paramdef> <paramdef><type>geography </type> <parameter>geog</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:240
+#, no-c-format
+msgid ""
+"Return the geometry as a Geometry Javascript Object Notation (GeoJSON) "
+"element. (Cf <ulink url=\"http://geojson.org/geojson-spec.html\">GeoJSON "
+"specifications 1.0</ulink>). 2D and 3D Geometries are both supported. "
+"GeoJSON only support SFS 1.1 geometry type (no curve support for example)."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:246
+#, no-c-format
+msgid ""
+"The gj_version parameter is the major version of the GeoJSON spec. If "
+"specified, must be 1. This represents the spec version of GeoJSON."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:248
+#, no-c-format
+msgid ""
+"The third argument may be used to reduce the maximum number of decimal "
+"places used in output (defaults to 15)."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:251
+#, no-c-format
+msgid ""
+"The last 'options' argument could be used to add Bbox or Crs in GeoJSON "
+"output:"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:255
+#, no-c-format
+msgid "0: means no option (default value)"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:259
+#, no-c-format
+msgid "1: GeoJSON Bbox"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:263
+#, no-c-format
+msgid "2: GeoJSON Short CRS (e.g EPSG:4326)"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:267
+#, no-c-format
+msgid "4: GeoJSON Long CRS (e.g urn:ogc:def:crs:EPSG::4326)"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:271
+#, no-c-format
+msgid "Version 1: ST_AsGeoJSON(geom) / precision=15 version=1 options=0"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:272
+#, no-c-format
+msgid "Version 2: ST_AsGeoJSON(geom, precision) / version=1 options=0"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:273
+#, no-c-format
+msgid "Version 3: ST_AsGeoJSON(geom, precision, options) / version=1"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:274
+#, no-c-format
+msgid "Version 4: ST_AsGeoJSON(gj_version, geom) / precision=15 options=0"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:275
+#, no-c-format
+msgid "Version 5: ST_AsGeoJSON(gj_version, geom, precision) /options=0"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:276
+#, no-c-format
+msgid "Version 6: ST_AsGeoJSON(gj_version, geom, precision,options)"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:278
+#, no-c-format
+msgid "Availability: 1.3.4"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:280
+#, no-c-format
+msgid "Changed: 2.0.0 support default args and named args."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:286
+#, no-c-format
+msgid ""
+"GeoJSON format is generally more efficient than other formats for use in "
+"ajax mapping. One popular javascript client that supports this is Open "
+"Layers. Example of its use is <ulink url=\"http://openlayers.org/dev/"
+"examples/vector-formats.html\">OpenLayers GeoJSON Example</ulink>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:291
+#, no-c-format
+msgid ""
+"SELECT ST_AsGeoJSON(the_geom) from fe_edges limit 1;\n"
+" st_asgeojson\n"
+"-----------------------------------------------------------------------------------------------------------\n"
+"\n"
+"{\"type\":\"MultiLineString\",\"coordinates\":"
+"[[[-89.734634999999997,31.492072000000000],\n"
+"[-89.734955999999997,31.492237999999997]]]}\n"
+"(1 row)\n"
+"--3d point\n"
+"SELECT ST_AsGeoJSON('LINESTRING(1 2 3, 4 5 6)');\n"
+"\n"
+"st_asgeojson\n"
+"-----------------------------------------------------------------------------------------\n"
+" {\"type\":\"LineString\",\"coordinates\":[[1,2,3],[4,5,6]]}"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:296
+#, no-c-format
+msgid "ST_AsGML"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:297
+#, no-c-format
+msgid "Return the geometry as a GML version 2 or 3 element."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:301
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsGML</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsGML</function></"
+"funcdef> <paramdef><type>geography </type> <parameter>geog</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsGML</function></"
+"funcdef> <paramdef><type>integer </type> <parameter>version</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>geom</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter>nprefix=null</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>id=null</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>text <function>ST_AsGML</function></funcdef> "
+"<paramdef><type>integer </type> <parameter>version</parameter></paramdef> "
+"<paramdef><type>geography </type> <parameter>geog</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter>nprefix=null</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>id=null</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:341
+#, no-c-format
+msgid ""
+"Return the geometry as a Geography Markup Language (GML) element. The "
+"version parameter, if specified, may be either 2 or 3. If no version "
+"parameter is specified then the default is assumed to be 2. The precision "
+"argument may be used to reduce the maximum number of decimal places "
+"(<varname>maxdecimaldigits</varname>) used in output (defaults to 15)."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:346
+#, no-c-format
+msgid "GML 2 refer to 2.1.2 version, GML 3 to 3.1.1 version"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:347
+#, no-c-format
+msgid ""
+"The 'options' argument is a bitfield. It could be used to define CRS output "
+"type in GML output, and to declare data as lat/lon:"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:351
+#, no-c-format
+msgid "0: GML Short CRS (e.g EPSG:4326), default value"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:355
+#, no-c-format
+msgid "1: GML Long CRS (e.g urn:ogc:def:crs:EPSG::4326)"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:359
+#, no-c-format
+msgid "2: For GML 3 only, remove srsDimension attribute from output."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:363
+#, no-c-format
+msgid ""
+"4: For GML 3 only, use <LineString> rather than <Curve> tag for "
+"lines."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:367
+#, no-c-format
+msgid ""
+"16: Declare that datas are lat/lon (e.g srid=4326). Default is to assume "
+"that data are planars. This option is useful for GML 3.1.1 output only, "
+"related to axis order. So if you set it, it will swap the coordinates so "
+"order is lat lon instead of database lon lat."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:373
+#, no-c-format
+msgid "32: Output the box of the geometry (envelope)."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:378
+#, no-c-format
+msgid ""
+"The 'namespace prefix' argument may be used to specify a custom namespace "
+"prefix or no prefix (if empty). If null or omitted 'gml' prefix is used"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:382
+#, no-c-format
+msgid "Availability: 1.3.2"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:384
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 prefix support was introduced. Option 4 for GML3 was "
+"introduced to allow using LineString instead of Curve tag for lines. GML3 "
+"Support for Polyhedral surfaces and TINS was introduced. Option 32 was "
+"introduced to output the box."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:385
+#, no-c-format
+msgid "Changed: 2.0.0 use default named args"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:386
+#, no-c-format
+msgid "Enhanced: 2.1.0 id support was introduced, for GML 3."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:388
+#, no-c-format
+msgid "Only version 3+ of ST_AsGML supports Polyhedral Surfaces and TINS."
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:395
+#, no-c-format
+msgid "Examples: Version 2"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:396
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT ST_AsGML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 "
+"0))',4326));\n"
+" st_asgml\n"
+" --------\n"
+" <gml:Polygon srsName=\"EPSG:4326\"><gml:outerBoundaryIs><gml:"
+"LinearRing><gml:coordinates>0,0 0,1 1,1 1,0 0,0</gml:coordinates></gml:"
+"LinearRing></gml:outerBoundaryIs></gml:Polygon>]]>"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:399
+#, no-c-format
+msgid "Examples: Version 3"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:400
+#, no-c-format
+msgid ""
+"-- Flip coordinates and output extended EPSG (16 | 1)--\n"
+"<![CDATA[SELECT ST_AsGML(3, ST_GeomFromText('POINT(5.234234233242 "
+"6.34534534534)',4326), 5, 17);\n"
+" st_asgml\n"
+" --------\n"
+" <gml:Point srsName=\"urn:ogc:def:crs:EPSG::4326\"><gml:"
+"pos>6.34535 5.23423</gml:pos></gml:Point>]]>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:401
+#, no-c-format
+msgid ""
+"-- Output the envelope (32) --\n"
+"<![CDATA[SELECT ST_AsGML(3, ST_GeomFromText('LINESTRING(1 2, 3 4, 10 "
+"20)',4326), 5, 32);\n"
+" st_asgml\n"
+" --------\n"
+" <gml:Envelope srsName=\"EPSG:4326\">\n"
+" <gml:lowerCorner>1 2</gml:lowerCorner>\n"
+" <gml:upperCorner>10 20</gml:upperCorner>\n"
+" </gml:Envelope>]]>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:403
+#, no-c-format
+msgid ""
+"-- Output the envelope (32) , reverse (lat lon instead of lon lat) (16), "
+"long srs (1)= 32 | 16 | 1 = 49 --\n"
+"<![CDATA[SELECT ST_AsGML(3, ST_GeomFromText('LINESTRING(1 2, 3 4, 10 "
+"20)',4326), 5, 49);\n"
+" st_asgml\n"
+" --------\n"
+"<gml:Envelope srsName=\"urn:ogc:def:crs:EPSG::4326\">\n"
+" <gml:lowerCorner>2 1</gml:lowerCorner>\n"
+" <gml:upperCorner>20 10</gml:upperCorner>\n"
+"</gml:Envelope>]]>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:405
+#, no-c-format
+msgid ""
+"-- Polyhedral Example --\n"
+"SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 "
+"1, 0 1 0, 0 0 0)), \n"
+"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 "
+"0)), \n"
+"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 "
+"1)) )'));\n"
+" st_asgml\n"
+" --------\n"
+"<![CDATA[ <gml:PolyhedralSurface>\n"
+"<gml:polygonPatches>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing>\n"
+" <gml:posList srsDimension=\"3\">0 0 0 0 0 "
+"1 0 1 1 0 1 0 0 0 0</gml:posList>\n"
+" </gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing>\n"
+" <gml:posList srsDimension=\"3\">0 0 0 0 1 "
+"0 1 1 0 1 0 0 0 0 0</gml:posList>\n"
+" </gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing>\n"
+" <gml:posList srsDimension=\"3\">0 0 0 1 0 "
+"0 1 0 1 0 0 1 0 0 0</gml:posList>\n"
+" </gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing>\n"
+" <gml:posList srsDimension=\"3\">1 1 0 1 1 "
+"1 1 0 1 1 0 0 1 1 0</gml:posList>\n"
+" </gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing>\n"
+" <gml:posList srsDimension=\"3\">0 1 0 0 1 "
+"1 1 1 1 1 1 0 0 1 0</gml:posList>\n"
+" </gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+" <gml:PolygonPatch>\n"
+" <gml:exterior>\n"
+" <gml:LinearRing>\n"
+" <gml:posList srsDimension=\"3\">0 0 1 1 0 "
+"1 1 1 1 0 1 1 0 0 1</gml:posList>\n"
+" </gml:LinearRing>\n"
+" </gml:exterior>\n"
+" </gml:PolygonPatch>\n"
+"</gml:polygonPatches>\n"
+"</gml:PolyhedralSurface>]]>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:418
+#, no-c-format
+msgid "ST_AsHEXEWKB"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:420
+#, no-c-format
+msgid ""
+"Returns a Geometry in HEXEWKB format (as text) using either little-endian "
+"(NDR) or big-endian (XDR) encoding."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:425
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsHEXEWKB</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>NDRorXDR</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsHEXEWKB</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>g1</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:442
+#, no-c-format
+msgid ""
+"Returns a Geometry in HEXEWKB format (as text) using either little-endian "
+"(NDR) or big-endian (XDR) encoding. If no encoding is specified, then NDR is "
+"used."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:446
+#, no-c-format
+msgid "Availability: 1.2.2"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:454
+#, no-c-format
+msgid ""
+"SELECT ST_AsHEXEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 "
+"0))',4326));\n"
+" which gives same answer as\n"
+"\n"
+" SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 "
+"0))',4326)::text;\n"
+"\n"
+" st_ashexewkb\n"
+" --------\n"
+" 0103000020E6100000010000000500\n"
+" 00000000000000000000000000000000\n"
+" 00000000000000000000000000000000F03F\n"
+" 000000000000F03F000000000000F03F000000000000F03\n"
+" F000000000000000000000000000000000000000000000000"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:460
+#, no-c-format
+msgid "ST_AsKML"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:462
+#, no-c-format
+msgid ""
+"Return the geometry as a KML element. Several variants. Default version=2, "
+"default precision=15"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:466
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsKML</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>ST_AsKML</function></funcdef> "
+"<paramdef><type>geography </type> <parameter>geog</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>ST_AsKML</function></funcdef> "
+"<paramdef><type>integer </type> <parameter>version</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>nprefix=NULL</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsKML</function></"
+"funcdef> <paramdef><type>integer </type> <parameter>version</parameter></"
+"paramdef> <paramdef><type>geography </type> <parameter>geog</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>nprefix=NULL</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:498
+#, no-c-format
+msgid ""
+"Return the geometry as a Keyhole Markup Language (KML) element. There are "
+"several variants of this function. maximum number of decimal places used in "
+"output (defaults to 15), version default to 2 and default namespace is no "
+"prefix."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:502
+#, no-c-format
+msgid ""
+"Version 1: ST_AsKML(geom_or_geog, maxdecimaldigits) / version=2 / "
+"maxdecimaldigits=15"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:503
+#, no-c-format
+msgid ""
+"Version 2: ST_AsKML(version, geom_or_geog, maxdecimaldigits, nprefix) "
+"maxdecimaldigits=15 / nprefix=NULL"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:506
+#, no-c-format
+msgid ""
+"Requires PostGIS be compiled with Proj support. Use <xref linkend="
+"\"PostGIS_Full_Version\"/> to confirm you have proj support compiled in."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:510
+#, no-c-format
+msgid ""
+"Availability: 1.2.2 - later variants that include version param came in 1.3.2"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:513
+#, no-c-format
+msgid "Enhanced: 2.0.0 - Add prefix namespace. Default is no prefix"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:516
+#, no-c-format
+msgid "Changed: 2.0.0 - uses default args and supports named args"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:520
+#, no-c-format
+msgid "AsKML output will not work with geometries that do not have an SRID"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:528
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 "
+"0))',4326));\n"
+"\n"
+" st_askml\n"
+" --------\n"
+" <Polygon><outerBoundaryIs><LinearRing><coordinates>0,0 0,1 "
+"1,1 1,0 0,0</coordinates></LinearRing></outerBoundaryIs></Polygon>\n"
+"\n"
+" --3d linestring\n"
+" SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3, 4 5 6)');\n"
+" <LineString><coordinates>1,2,3 4,5,6</coordinates></"
+"LineString>\n"
+" ]]>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:533
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsGML\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:538
+#, no-c-format
+msgid "ST_AsSVG"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:540
+#, no-c-format
+msgid ""
+"Returns a Geometry in SVG path data given a geometry or geography object."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:544
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsSVG</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>rel=0</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>text <function>ST_AsSVG</function></funcdef> "
+"<paramdef><type>geography </type> <parameter>geog</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>rel=0</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:563
+#, no-c-format
+msgid ""
+"Return the geometry as Scalar Vector Graphics (SVG) path data. Use 1 as "
+"second argument to have the path data implemented in terms of relative "
+"moves, the default (or 0) uses absolute moves. Third argument may be used to "
+"reduce the maximum number of decimal digits used in output (defaults to 15). "
+"Point geometries will be rendered as cx/cy when 'rel' arg is 0, x/y when "
+"'rel' is 1. Multipoint geometries are delimited by commas (\",\"), "
+"GeometryCollection geometries are delimited by semicolons (\";\")."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:573
+#, no-c-format
+msgid ""
+"Availability: 1.2.2. Availability: 1.4.0 Changed in PostGIS 1.4.0 to include "
+"L command in absolute path to conform to <ulink url=\"http://www.w3.org/TR/"
+"SVG/paths.html#PathDataBNF\">http://www.w3.org/TR/SVG/paths."
+"html#PathDataBNF</ulink>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:576
+#, no-c-format
+msgid "Changed: 2.0.0 to use default args and support named args"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:581
+#, no-c-format
+msgid ""
+"SELECT ST_AsSVG(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n"
+"\n"
+" st_assvg\n"
+" --------\n"
+" M 0 0 L 0 -1 1 -1 1 0 Z"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:587
+#, no-c-format
+msgid "ST_AsX3D"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:589
+#, no-c-format
+msgid ""
+"Returns a Geometry in X3D xml node element format: ISO-IEC-19776-1.2-"
+"X3DEncodings-XML"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_output.xml:594
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_AsX3D</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxdecimaldigits=15</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>options=0</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:606
+#, no-c-format
+msgid ""
+"Returns a geometry as an X3D xml formatted node element <ulink url=\"http://"
+"www.web3d.org/standards/number/19776-1\">http://www.web3d.org/standards/"
+"number/19776-1</ulink>. If <varname>maxdecimaldigits</varname> (precision) "
+"is not specified then defaults to 15."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:608
+#, no-c-format
+msgid ""
+"There are various options for translating PostGIS geometries to X3D since "
+"X3D geometry types don't map directly to PostGIS geometry types and some "
+"newer X3D types that might be better mappings we ahve avoided since most "
+"rendering tools don't currently support them. These are the mappings we have "
+"settled on. Feel free to post a bug ticket if you have thoughts on the idea "
+"or ways we can allow people to denote their preferred mappings."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:610
+#, no-c-format
+msgid "Below is how we currently map PostGIS 2D/3D types to X3D types"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:617
+#, no-c-format
+msgid "PostGIS Type"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:618
+#, no-c-format
+msgid "2D X3D Type"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:619
+#, no-c-format
+msgid "3D X3D Type"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:624
+#, no-c-format
+msgid "LINESTRING"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:625 reference_output.xml:630
+#, no-c-format
+msgid "not yet implemented - will be PolyLine2D"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:626
+#, no-c-format
+msgid "LineSet"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:629
+#, no-c-format
+msgid "MULTILINESTRING"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:631
+#, no-c-format
+msgid "IndexedLineSet"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:634
+#, no-c-format
+msgid "MULTIPOINT"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:635
+#, no-c-format
+msgid "Polypoint2D"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:636
+#, no-c-format
+msgid "PointSet"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:639
+#, no-c-format
+msgid "POINT"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:640 reference_output.xml:641
+#, no-c-format
+msgid "outputs the space delimited coordinates"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:644
+#, no-c-format
+msgid "(MULTI) POLYGON, POLYHEDRALSURFACE"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:645
+#, no-c-format
+msgid "Invalid X3D markup"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:646
+#, no-c-format
+msgid "IndexedFaceSet (inner rings currently output as another faceset)"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:649
+#, no-c-format
+msgid "<entry>TIN</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:650
+#, no-c-format
+msgid "TriangleSet2D (Not Yet Implemented)"
+msgstr ""
+
+#. Tag: entry
+#: reference_output.xml:651
+#, no-c-format
+msgid "IndexedTriangleSet"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:656
+#, no-c-format
+msgid ""
+"2D geometry support not yet complete. Inner rings currently just drawn as "
+"separate polygons. We are working on these."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:657
+#, no-c-format
+msgid ""
+"Lots of advancements happening in 3D space particularly with <ulink url="
+"\"http://www.web3d.org/x3d/wiki/index.php/X3D_and_HTML5#Goals:"
+"_X3D_and_HTML5\">X3D Integration with HTML5</ulink>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:658
+#, no-c-format
+msgid ""
+"There is also a nice open source X3D viewer you can use to view rendered "
+"geometries. Free Wrl <ulink url=\"http://freewrl.sourceforge.net/\">http://"
+"freewrl.sourceforge.net/</ulink> binaries available for Mac, Linux, and "
+"Windows. Use the FreeWRL_Launcher packaged to view the geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:659
+#, no-c-format
+msgid ""
+"Also check out <ulink url=\"https://github.com/robe2/postgis_x3d_viewer"
+"\">PostGIS minimalist X3D viewer</ulink> that utilizes this function and "
+"<ulink url=\"http://www.x3dom.org/\">x3dDom html/js open source toolkit</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:660
+#, no-c-format
+msgid "Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:672
+#, no-c-format
+msgid ""
+"Example: Create a fully functional X3D document - This will generate a cube "
+"that is viewable in FreeWrl and other X3D viewers."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:673
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT '<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
+"<!DOCTYPE X3D PUBLIC \"ISO//Web3D//DTD X3D 3.0//EN\" \"http://www.web3d.org/"
+"specifications/x3d-3.0.dtd\">\n"
+"<X3D>\n"
+" <Scene>\n"
+" <Transform>\n"
+" <Shape>\n"
+" <Appearance>\n"
+" <Material emissiveColor=''0 0 1''/> \n"
+" </Appearance> ' || \n"
+" ST_AsX3D( ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, "
+"0 1 0, 0 0 0)), \n"
+"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 "
+"0)), \n"
+"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 "
+"1)) )')) ||\n"
+" '</Shape>\n"
+" </Transform>\n"
+" </Scene>\n"
+"</X3D>' As x3ddoc;]]>\n"
+"\n"
+" x3ddoc\n"
+" --------\n"
+"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
+"<!DOCTYPE X3D PUBLIC \"ISO//Web3D//DTD X3D 3.0//EN\" \"http://www.web3d.org/"
+"specifications/x3d-3.0.dtd\">\n"
+"<X3D>\n"
+" <Scene>\n"
+" <Transform>\n"
+" <Shape>\n"
+" <Appearance>\n"
+" <Material emissiveColor='0 0 1'/> \n"
+" </Appearance> \n"
+" <IndexedFaceSet coordIndex='0 1 2 3 -1 4 5 6 7 -1 8 9 10 11 -1 12 13 "
+"14 15 -1 16 17 18 19 -1 20 21 22 23'>\n"
+" <Coordinate point='0 0 0 0 0 1 0 1 1 0 1 0 0 0 0 0 1 0 1 1 0 1 0 "
+"0 0 0 0 1 0 0 1 0 1 0 0 1 1 1 0 1 1 1 1 0 1 1 0 0 0 1 0 0 1 1 1 1 1 1 1 0 0 "
+"0 1 1 0 1 1 1 1 0 1 1' />\n"
+" </IndexedFaceSet>\n"
+" </Shape>\n"
+" </Transform>\n"
+" </Scene>\n"
+"</X3D>]]>"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:676
+#, no-c-format
+msgid "Example: An Octagon elevated 3 Units and decimal precision of 6"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:677
+#, no-c-format
+msgid ""
+"SELECT ST_AsX3D(\n"
+"ST_Translate(\n"
+" ST_Force_3d(\n"
+" ST_Buffer(ST_Point(10,10),5, 'quad_segs=2')), 0,0,\n"
+" 3)\n"
+" ,6) As x3dfrag;\n"
+"\n"
+"x3dfrag\n"
+"--------\n"
+"<![CDATA[<IndexedFaceSet coordIndex=\"0 1 2 3 4 5 6 7\">\n"
+" <Coordinate point=\"15 10 3 13.535534 6.464466 3 10 5 3 6.464466 "
+"6.464466 3 5 10 3 6.464466 13.535534 3 10 15 3 13.535534 13.535534 3 \" />\n"
+"</IndexedFaceSet>]]>"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:680
+#, no-c-format
+msgid "Example: TIN"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:681
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT ST_AsX3D(ST_GeomFromEWKT('TIN (((\n"
+" 0 0 0, \n"
+" 0 0 1, \n"
+" 0 1 0, \n"
+" 0 0 0\n"
+" )), ((\n"
+" 0 0 0, \n"
+" 0 1 0, \n"
+" 1 1 0, \n"
+" 0 0 0\n"
+" ))\n"
+" )')) As x3dfrag;]]>\n"
+"\n"
+" x3dfrag\n"
+" --------\n"
+"<![CDATA[<IndexedTriangleSet index='0 1 2 3 4 5'><Coordinate point='0 0 0 0 "
+"0 1 0 1 0 0 0 0 0 1 0 1 1 0'/></IndexedTriangleSet>]]>"
+msgstr ""
+
+#. Tag: title
+#: reference_output.xml:684
+#, no-c-format
+msgid "Example: Closed multilinestring (the boundary of a polygon with holes)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:685
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT ST_AsX3D(\n"
+" ST_GeomFromEWKT('MULTILINESTRING((20 0 10,16 -12 10,0 "
+"-16 10,-12 -12 10,-20 0 10,-12 16 10,0 24 10,16 16 10,20 0 10),\n"
+" (12 0 10,8 8 10,0 12 10,-8 8 10,-8 0 10,-8 -4 10,0 -8 10,8 -4 10,12 0 "
+"10))') \n"
+") As x3dfrag;]]>\n"
+"\n"
+" x3dfrag\n"
+" --------\n"
+"<![CDATA[<IndexedLineSet coordIndex='0 1 2 3 4 5 6 7 0 -1 8 9 10 11 12 13 "
+"14 15 8'>\n"
+" <Coordinate point='20 0 10 16 -12 10 0 -16 10 -12 -12 10 -20 0 10 -12 16 "
+"10 0 24 10 16 16 10 12 0 10 8 8 10 0 12 10 -8 8 10 -8 0 10 -8 -4 10 0 -8 10 "
+"8 -4 10 ' />\n"
+" </IndexedLineSet>]]>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:691
+#, no-c-format
+msgid "ST_GeoHash"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:693
+#, no-c-format
+msgid "Return a GeoHash representation of the geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_output.xml:698
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_GeoHash</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>maxchars=full_precision_of_point</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:709
+#, no-c-format
+msgid ""
+"Return a GeoHash representation (<ulink url=\"http://en.wikipedia.org/wiki/"
+"Geohash\">http://en.wikipedia.org/wiki/Geohash</ulink>) of the geometry. A "
+"GeoHash encodes a point into a text form that is sortable and searchable "
+"based on prefixing. A shorter GeoHash is a less precise representation of a "
+"point. It can also be thought of as a box, that contains the actual point."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:711
+#, no-c-format
+msgid ""
+"If no <varname>maxchars</varname> is specficified ST_GeoHash returns a "
+"GeoHash based on full precision of the input geometry type. Points return a "
+"GeoHash with 20 characters of precision (about enough to hold the full "
+"double precision of the input). Other types return a GeoHash with a variable "
+"amount of precision, based on the size of the feature. Larger features are "
+"represented with less precision, smaller features with more precision. The "
+"idea is that the box implied by the GeoHash will always contain the input "
+"feature."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:713
+#, no-c-format
+msgid ""
+"If <varname>maxchars</varname> is specified ST_GeoHash returns a GeoHash "
+"with at most that many characters so a possibly lower precision "
+"representation of the input geometry. For non-points, the starting point of "
+"the calculation is the center of the bounding box of the geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:715
+#, no-c-format
+msgid "Availability: 1.4.0"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:718
+#, no-c-format
+msgid ""
+"ST_GeoHash will not work with geometries that are not in geographic (lon/"
+"lat) coordinates."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:726
+#, no-c-format
+msgid ""
+"<![CDATA[SELECT ST_GeoHash(ST_SetSRID(ST_MakePoint(-126,48),4326));\n"
+"\n"
+" st_geohash\n"
+"----------------------\n"
+" c0w3hf1s70w3hf1s70w3\n"
+"\n"
+"SELECT ST_GeoHash(ST_SetSRID(ST_MakePoint(-126,48),4326),5);\n"
+"\n"
+" st_geohash\n"
+"------------\n"
+" c0w3h\n"
+" ]]>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:737
+#, no-c-format
+msgid "ST_AsText"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:738
+#, no-c-format
+msgid ""
+"Return the Well-Known Text (WKT) representation of the geometry/geography "
+"without SRID metadata."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:742
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsText</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsText</function></"
+"funcdef> <paramdef><type>geography </type> <parameter>g1</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:757
+#, no-c-format
+msgid "Returns the Well-Known Text representation of the geometry/geography."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:760
+#, no-c-format
+msgid ""
+"The WKT spec does not include the SRID. To get the SRID as part of the data, "
+"use the non-standard PostGIS <xref linkend=\"ST_AsEWKT\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:767
+#, no-c-format
+msgid ""
+"ST_AsText is the reverse of <xref linkend=\"ST_GeomFromText\"/>. Use <xref "
+"linkend=\"ST_GeomFromText\"/> to convert to a postgis geometry from "
+"ST_AsText representation."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:770
+#, no-c-format
+msgid "Availability: 1.5 - support for geography was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:772
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:780
+#, no-c-format
+msgid ""
+"SELECT ST_AsText('01030000000100000005000000000000000000\n"
+"000000000000000000000000000000000000000000000000\n"
+"F03F000000000000F03F000000000000F03F000000000000F03\n"
+"F000000000000000000000000000000000000000000000000');\n"
+"\n"
+" st_astext\n"
+"--------------------------------\n"
+" POLYGON((0 0,0 1,1 1,1 0,0 0))\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:787
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsEWKB\"/>, <xref linkend=\"ST_AsEWKT\"/>, <xref "
+"linkend=\"ST_GeomFromText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:794
+#, no-c-format
+msgid "ST_AsLatLonText"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:795
+#, no-c-format
+msgid "Return the Degrees, Minutes, Seconds representation of the given point."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:799
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>text <function>ST_AsLatLonText</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>pt</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>text <function>ST_AsLatLonText</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>pt</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>format</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:815
+#, no-c-format
+msgid "Returns the Degrees, Minutes, Seconds representation of the point."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:818
+#, no-c-format
+msgid ""
+"It is assumed the point is in a lat/lon projection. The X (lon) and Y (lat) "
+"coordinates are normalized in the output to the \"normal\" range (-180 to "
+"+180 for lon, -90 to +90 for lat)."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:821
+#, no-c-format
+msgid ""
+"The text parameter is a format string containing the format for the "
+"resulting text, similar to a date format string. Valid tokens are \"D\" for "
+"degrees, \"M\" for minutes, \"S\" for seconds, and \"C\" for cardinal "
+"direction (NSEW). DMS tokens may be repeated to indicate desired width and "
+"precision (\"SSS.SSSS\" means \" 1.0023\")."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:826
+#, no-c-format
+msgid ""
+"\"M\", \"S\", and \"C\" are optional. If \"C\" is omitted, degrees are shown "
+"with a \"-\" sign if south or west. If \"S\" is omitted, minutes will be "
+"shown as decimal with as many digits of precision as you specify. If \"M\" "
+"is also omitted, degrees are shown as decimal with as many digits precision "
+"as you specify."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:831
+#, no-c-format
+msgid ""
+"If the format string is omitted (or zero-length) a default format will be "
+"used."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:837
+#, no-c-format
+msgid "Availability: 2.0"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:843
+#, no-c-format
+msgid "Default format."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:844
+#, no-c-format
+msgid ""
+"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)'));\n"
+" st_aslatlontext \n"
+"----------------------------\n"
+" 2°19'29.928\"S 3°14'3.243\"W"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:845
+#, no-c-format
+msgid "Providing a format (same as the default)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:846
+#, no-c-format
+msgid ""
+"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"C'));\n"
+" st_aslatlontext \n"
+"----------------------------\n"
+" 2°19'29.928\"S 3°14'3.243\"W"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:847
+#, no-c-format
+msgid "Characters other than D, M, S, C and . are just passed through."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:848
+#, no-c-format
+msgid ""
+"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D degrees, M "
+"minutes, S seconds to the C'));\n"
+" st_aslatlontext \n"
+"--------------------------------------------------------------------------------------\n"
+" 2 degrees, 19 minutes, 30 seconds to the S 3 degrees, 14 minutes, 3 seconds "
+"to the W"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:849
+#, no-c-format
+msgid "Signed degrees instead of cardinal directions."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:850
+#, no-c-format
+msgid ""
+"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"'));\n"
+" st_aslatlontext \n"
+"----------------------------\n"
+" -2°19'29.928\" -3°14'3.243\""
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:851
+#, no-c-format
+msgid "Decimal degrees."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:852
+#, no-c-format
+msgid ""
+"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D.DDDD degrees "
+"C'));\n"
+" st_aslatlontext \n"
+"-----------------------------------\n"
+" 2.3250 degrees S 3.2342 degrees W"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:853
+#, no-c-format
+msgid "Excessively large values are normalized."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:854
+#, no-c-format
+msgid ""
+"SELECT (ST_AsLatLonText('POINT (-302.2342342 -792.32498)'));\n"
+" st_aslatlontext \n"
+"-------------------------------\n"
+" 72°19'29.928\"S 57°45'56.757\"E"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:862
+#, no-c-format
+msgid "ST_AsTWKB"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:863
+#, no-c-format
+msgid "Returns the geometry as TWKB, Tiny WKB"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_output.xml:868
+#, no-c-format
+msgid ""
+"<funcdef>bytea <function>ST_AsTWKB</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>decimaldigits</parameter></"
+"paramdef> <paramdef><type>int8 </type> <parameter>geometryID=null</"
+"parameter></paramdef> <paramdef><type>boolean </type> <parameter>include "
+"sizes=false</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>include bounding boxes=false</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:880 reference_output.xml:946
+#, no-c-format
+msgid ""
+"Returns the geometry in TWKB format. TWKB is a new compressed binary format."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:881 reference_output.xml:948
+#, no-c-format
+msgid ""
+"The second parameter is an integer used to define the number of coordinate "
+"decimals in the output."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:882 reference_output.xml:949
+#, no-c-format
+msgid ""
+"The third parameter is optional. It is used to give each TWKB-geometry an "
+"unique ID"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:883 reference_output.xml:950
+#, no-c-format
+msgid ""
+"The fourth parameter is optional. If it is set to true, the size of the "
+"geometry is included"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:885
+#, no-c-format
+msgid ""
+"TWKB is still a moving target. The format is described <ulink url=\"https://"
+"github.com/TWKB/Specification\">https://github.com/TWKB/Specification</"
+"ulink> , and code for building a client can be found <ulink url=\"https://"
+"github.com/TWKB/twkb.js\">https://github.com/TWKB/twkb.js</ulink>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:888
+#, no-c-format
+msgid ""
+"TWKB doesn't make any difference of Z and M. So PointM and PointZ will give "
+"the same twkb representation."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:891 reference_output.xml:956 reference_output.xml:993
+#, no-c-format
+msgid "Availability: 2.2.0"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:897
+#, no-c-format
+msgid ""
+"SELECT ST_AsTWKB('LINESTRING(1 1,5 5)'::geometry,0,1);\n"
+" st_astwkb \n"
+"--------------------------------------------\n"
+"\\x0142020202020808"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:902 reference_output.xml:967
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_AsBinary\"/>, <xref linkend=\"ST_AsEWKB\"/>, <xref "
+"linkend=\"ST_AsEWKT\"/>, <xref linkend=\"ST_GeomFromText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:908
+#, no-c-format
+msgid "ST_AsTWKBAgg"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:909
+#, no-c-format
+msgid "Aggregates the geometries and returns as TWKB"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_output.xml:913
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>bytea <function>ST_AsTWKBAgg</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>decimaldigits</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>bytea "
+"<function>ST_AsTWKBAgg</function></funcdef> <paramdef><type>geometry set</"
+"type> <parameter>g1</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>decimaldigits</parameter></paramdef> <paramdef><type>int8 </type> "
+"<parameter>geometryID</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>bytea <function>ST_AsTWKBAgg</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>decimaldigits</parameter></"
+"paramdef> <paramdef><type>int8 </type> <parameter>geometryID</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>include sizes</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bytea "
+"<function>ST_AsTWKBAgg</function></funcdef> <paramdef><type>geometry set</"
+"type> <parameter>g1</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>decimaldigits</parameter></paramdef> <paramdef><type>int8 </type> "
+"<parameter>geometryID</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>include sizes</parameter></paramdef> <paramdef><type>boolean </"
+"type> <parameter>include bounding boxes</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:947
+#, no-c-format
+msgid ""
+"This is the aggregate version of ST_AsTWKB. It aggregates and returns the "
+"geometry in TWKB-format. In the resulting TWKB-geometry each individual ID "
+"of the input geometries is stored."
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:952
+#, no-c-format
+msgid ""
+"TWKB is still a moving target. The format is described <ulink url=\"https://"
+"github.com/nicklasaven/TWKB\">https://github.com/nicklasaven/TWKB</ulink> , "
+"and code for building a client can be found <ulink url=\"https://github.com/"
+"nicklasaven/twkb_web\">https://github.com/nicklasaven/twkb_web</ulink>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:962
+#, no-c-format
+msgid ""
+"SELECT ST_AsTWKBAgg(geom,0,id) FROM\n"
+"(SELECT 'LINESTRING(1 1,5 5)'::geometry geom, 1 AS id\n"
+"UNION ALL\n"
+"SELECT 'LINESTRING(6 5, 1 7)'::geometry AS geom, 2 AS id) foo;\n"
+" st_astwkbagg \n"
+"----------------------------------------------------------------------------\n"
+"\\x015602020202020808040202000904"
+msgstr ""
+
+#. Tag: refname
+#: reference_output.xml:973
+#, no-c-format
+msgid "ST_AsEncodedPolyline"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_output.xml:974
+#, no-c-format
+msgid "Returns an Encoded Polyline from a LineString geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_output.xml:979
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_AsEncodedPolyline</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>precision=5</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_output.xml:990
+#, no-c-format
+msgid "Returns the geometry as an Encoded Polyline."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_output.xml:998
+#, no-c-format
+msgid ""
+"ST_AsEncodedPolyline(GeomFromEWKT('SRID=4326;LINESTRING(-120.2 38.5,-120.95 "
+"40.7,-126.453 43.252)'));\n"
+"--result--\n"
+"|_p~iF~ps|U_ulLnnqC_mqNvxq`@"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_processing.xml:3
+#, no-c-format
+msgid "Geometry Processing"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:6
+#, no-c-format
+msgid "ST_Buffer"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:8
+#, no-c-format
+msgid ""
+"(T) For geometry: Returns a geometry that represents all points whose "
+"distance from this Geometry is less than or equal to distance. Calculations "
+"are in the Spatial Reference System of this Geometry. For geography: Uses a "
+"planar transform wrapper. Introduced in 1.5 support for different end cap "
+"and mitre settings to control shape. buffer_style options: quad_segs=#,"
+"endcap=round|flat|square,join=round|mitre|bevel,mitre_limit=#.#"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_processing.xml:16
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Buffer</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>radius_of_buffer</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Buffer</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>g1</parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>radius_of_buffer</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>num_seg_quarter_circle</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geometry <function>ST_Buffer</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>g1</"
+"parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>radius_of_buffer</parameter></paramdef> <paramdef><type>text </"
+"type> <parameter>buffer_style_parameters</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>geography <function>ST_Buffer</"
+"function></funcdef> <paramdef><type>geography </type> <parameter>g1</"
+"parameter></paramdef> <paramdef><type>float </type> "
+"<parameter>radius_of_buffer_in_meters</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:47 reference_processing.xml:221
+#: reference_processing.xml:307 reference_processing.xml:373
+#: reference_processing.xml:522 reference_processing.xml:590
+#: reference_processing.xml:638 reference_processing.xml:736
+#: reference_processing.xml:816 reference_processing.xml:874
+#: reference_processing.xml:942 reference_processing.xml:989
+#: reference_processing.xml:1041 reference_processing.xml:1093
+#: reference_processing.xml:1133 reference_processing.xml:1192
+#: reference_processing.xml:1239 reference_processing.xml:1298
+#: reference_processing.xml:1350 reference_processing.xml:1404
+#: reference_processing.xml:1557 reference_processing.xml:1593
+#: reference_processing.xml:1670 reference_processing.xml:1720
+#: reference_processing.xml:1766 reference_processing.xml:1808
+#: reference_processing.xml:1919 reference_processing.xml:2012
+#: reference_processing.xml:2081
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:49
+#, no-c-format
+msgid ""
+"Returns a geometry/geography that represents all points whose distance from "
+"this Geometry/geography is less than or equal to distance."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:51
+#, no-c-format
+msgid ""
+"Geometry: Calculations are in the Spatial Reference System of the geometry. "
+"Introduced in 1.5 support for different end cap and mitre settings to "
+"control shape."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:54
+#, no-c-format
+msgid ""
+"Negative radii: For polygons, a negative radius can be used, which will "
+"shrink the polygon rather than expanding it."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:55
+#, no-c-format
+msgid ""
+"Geography: For geography this is really a thin wrapper around the geometry "
+"implementation. It first determines the best SRID that fits the bounding box "
+"of the geography object (favoring UTM, Lambert Azimuthal Equal Area (LAEA) "
+"north/south pole, and falling back on mercator in worst case scenario) and "
+"then buffers in that planar spatial ref and retransforms back to WGS84 "
+"geography."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:57
+#, no-c-format
+msgid ""
+"For geography this may not behave as expected if object is sufficiently "
+"large that it falls between two UTM zones or crosses the dateline"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:59
+#, no-c-format
+msgid ""
+"Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and "
+"join types. These are useful for example to convert road linestrings into "
+"polygon roads with flat or square edges instead of rounded edges. Thin "
+"wrapper for geography was added. - requires GEOS >= 3.2 to take advantage "
+"of advanced geometry functionality."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:62
+#, no-c-format
+msgid ""
+"The optional third parameter (currently only applies to geometry) can either "
+"specify number of segments used to approximate a quarter circle (integer "
+"case, defaults to 8) or a list of blank-separated key=value pairs (string "
+"case) to tweak operations as follows:"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:66 reference_processing.xml:1427
+#, no-c-format
+msgid ""
+"'quad_segs=#' : number of segments used to approximate a quarter circle "
+"(defaults to 8)."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:69
+#, no-c-format
+msgid ""
+"'endcap=round|flat|square' : endcap style (defaults to \"round\", needs "
+"GEOS-3.2 or higher for a different value). 'butt' is also accepted as a "
+"synonym for 'flat'."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:72
+#, no-c-format
+msgid ""
+"'join=round|mitre|bevel' : join style (defaults to \"round\", needs GEOS-3.2 "
+"or higher for a different value). 'miter' is also accepted as a synonym for "
+"'mitre'."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:75
+#, no-c-format
+msgid ""
+"'mitre_limit=#.#' : mitre ratio limit (only affects mitered join style). "
+"'miter_limit' is also accepted as a synonym for 'mitre_limit'."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:80
+#, no-c-format
+msgid "Units of radius are measured in units of the spatial reference system."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:81
+#, no-c-format
+msgid ""
+"The inputs can be POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, "
+"POLYGONS, MULTIPOLYGONS, and GeometryCollections."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:82
+#, no-c-format
+msgid ""
+"This function ignores the third dimension (z) and will always give a 2-d "
+"buffer even when presented with a 3d-geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:84 reference_processing.xml:1444
+#: reference_processing.xml:1732 reference_processing.xml:1775
+#: reference_processing.xml:2032
+#, no-c-format
+msgid "Performed by the GEOS module."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:85 reference_processing.xml:541
+#: reference_processing.xml:747 reference_processing.xml:1063
+#: reference_processing.xml:1930 reference_processing.xml:2041
+#, no-c-format
+msgid "&sfs_compliant; s2.1.1.3"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:86
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.17"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:88
+#, no-c-format
+msgid ""
+"People often make the mistake of using this function to try to do radius "
+"searches. Creating a buffer to to a radius search is slow and pointless. Use "
+"<xref linkend=\"ST_DWithin\"/> instead."
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:93 reference_processing.xml:238
+#: reference_processing.xml:343 reference_processing.xml:411
+#: reference_processing.xml:547 reference_processing.xml:604
+#: reference_processing.xml:754 reference_processing.xml:957
+#: reference_processing.xml:1067 reference_processing.xml:1104
+#: reference_processing.xml:1208 reference_processing.xml:1256
+#: reference_processing.xml:1367 reference_processing.xml:1453
+#: reference_processing.xml:1690 reference_processing.xml:1737
+#: reference_processing.xml:1781 reference_processing.xml:1823
+#: reference_processing.xml:1938 reference_processing.xml:2048
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:104
+#, no-c-format
+msgid "quad_segs=8 (default)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:107
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText('POINT(100 90)'),\n"
+" 50, 'quad_segs=8');"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:115
+#, no-c-format
+msgid "quad_segs=2 (lame)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:118
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText('POINT(100 90)'),\n"
+" 50, 'quad_segs=2');"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:127
+#, no-c-format
+msgid "endcap=round join=round (default)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:130
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText(\n"
+" 'LINESTRING(50 50,150 150,150 50)'\n"
+" ), 10, 'endcap=round join=round');"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:138
+#, no-c-format
+msgid "endcap=square"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:141
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText(\n"
+" 'LINESTRING(50 50,150 150,150 50)'\n"
+" ), 10, 'endcap=square join=round');"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:149
+#, no-c-format
+msgid "endcap=flat"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:152
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText(\n"
+" 'LINESTRING(50 50,150 150,150 50)'\n"
+" ), 10, 'endcap=flat join=round');"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:161
+#, no-c-format
+msgid "join=bevel"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:164
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText(\n"
+" 'LINESTRING(50 50,150 150,150 50)'\n"
+" ), 10, 'join=bevel');"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:172
+#, no-c-format
+msgid "join=mitre mitre_limit=5.0 (default mitre limit)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:175
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText(\n"
+" 'LINESTRING(50 50,150 150,150 50)'\n"
+" ), 10, 'join=mitre mitre_limit=5.0');"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:183
+#, no-c-format
+msgid "join=mitre mitre_limit=1"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:186
+#, no-c-format
+msgid ""
+"SELECT ST_Buffer(\n"
+" ST_GeomFromText(\n"
+" 'LINESTRING(50 50,150 150,150 50)'\n"
+" ), 10, 'join=mitre mitre_limit=1.0');"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:193
+#, no-c-format
+msgid ""
+"--A buffered point approximates a circle\n"
+"-- A buffered point forcing approximation of (see diagram)\n"
+"-- 2 points per circle is poly with 8 sides (see diagram)\n"
+"SELECT ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50)) As "
+"promisingcircle_pcount,\n"
+"ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50, 2)) As "
+"lamecircle_pcount;\n"
+"\n"
+"promisingcircle_pcount | lamecircle_pcount\n"
+"------------------------+-------------------\n"
+" 33 | 9\n"
+"\n"
+"--A lighter but lamer circle\n"
+"-- only 2 points per quarter circle is an octagon\n"
+"--Below is a 100 meter octagon\n"
+"-- Note coordinates are in NAD 83 long lat which we transform\n"
+"to Mass state plane meter and then buffer to get measurements in meters;\n"
+"SELECT ST_AsText(ST_Buffer(\n"
+"ST_Transform(\n"
+"ST_SetSRID(ST_MakePoint(-71.063526, 42.35785),4269), 26986)\n"
+",100,2)) As octagon;\n"
+"----------------------\n"
+"POLYGON((236057.59057465 900908.759918696,236028.301252769 "
+"900838.049240578,235\n"
+"957.59057465 900808.759918696,235886.879896532 "
+"900838.049240578,235857.59057465\n"
+"900908.759918696,235886.879896532 900979.470596815,235957.59057465 "
+"901008.759918\n"
+"696,236028.301252769 900979.470596815,236057.59057465 900908.759918696))"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:197 reference_processing.xml:272
+#: reference_processing.xml:350 reference_processing.xml:500
+#: reference_processing.xml:563 reference_processing.xml:611
+#: reference_processing.xml:711 reference_processing.xml:794
+#: reference_processing.xml:853 reference_processing.xml:920
+#: reference_processing.xml:964 reference_processing.xml:1071
+#: reference_processing.xml:1111 reference_processing.xml:1165
+#: reference_processing.xml:1215 reference_processing.xml:1269
+#: reference_processing.xml:1322 reference_processing.xml:1373
+#: reference_processing.xml:1535 reference_processing.xml:1571
+#: reference_processing.xml:1641 reference_processing.xml:1697
+#: reference_processing.xml:1742 reference_processing.xml:1786
+#: reference_processing.xml:1894 reference_processing.xml:1979
+#: reference_processing.xml:2055 reference_processing.xml:2109
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:199
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_DWithin\"/>, <xref linkend=\"ST_SetSRID\"/>, <xref "
+"linkend=\"ST_Transform\"/>, <xref linkend=\"ST_Union\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:205
+#, no-c-format
+msgid "ST_BuildArea"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:207
+#, no-c-format
+msgid ""
+"Creates an areal geometry formed by the constituent linework of given "
+"geometry"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:213
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_BuildArea</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>A</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:223
+#, no-c-format
+msgid ""
+"Creates an areal geometry formed by the constituent linework of given "
+"geometry. The return type can be a Polygon or MultiPolygon, depending on "
+"input. If the input lineworks do not form polygons NULL is returned. The "
+"inputs can be LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS, and "
+"GeometryCollections."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:228
+#, no-c-format
+msgid "This function will assume all inner geometries represent holes"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:231 reference_processing.xml:1310
+#, no-c-format
+msgid ""
+"Input linework must be correctly noded for this function to work properly"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:234
+#, no-c-format
+msgid "Availability: 1.1.0 - requires GEOS >= 2.1.0."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:248
+#, no-c-format
+msgid "This will create a donut"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:251
+#, no-c-format
+msgid ""
+"SELECT ST_BuildArea(ST_Collect(smallc,bigc))\n"
+"FROM (SELECT\n"
+" ST_Buffer(\n"
+" ST_GeomFromText('POINT(100 90)'), 25) As smallc,\n"
+" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As bigc) As foo;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:260
+#, no-c-format
+msgid ""
+"This will create a gaping hole inside the circle with prongs sticking out"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:263
+#, no-c-format
+msgid ""
+"SELECT ST_BuildArea(ST_Collect(line,circle))\n"
+"FROM (SELECT\n"
+" ST_Buffer(\n"
+" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190)),\n"
+" 5) As line,\n"
+" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;\n"
+"\n"
+"--this creates the same gaping hole\n"
+"--but using linestrings instead of polygons\n"
+"SELECT ST_BuildArea(\n"
+" ST_Collect(ST_ExteriorRing(line),ST_ExteriorRing(circle))\n"
+" )\n"
+"FROM (SELECT ST_Buffer(\n"
+" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190))\n"
+" ,5) As line,\n"
+" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:274
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_MakePolygon\"/>, <xref linkend=\"ST_BdPolyFromText\"/>, "
+"<xref linkend=\"ST_BdMPolyFromText\"/>wrappers to this function with "
+"standard OGC interface"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:284
+#, no-c-format
+msgid "ST_Collect"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:285
+#, no-c-format
+msgid ""
+"Return a specified ST_Geometry value from a collection of other geometries."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_processing.xml:289
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Collect</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>g1field</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Collect</function></funcdef> <paramdef><type>geometry</type> "
+"<parameter>g1</parameter></paramdef> <paramdef><type>geometry</type> "
+"<parameter>g2</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>geometry <function>ST_Collect</function></funcdef> "
+"<paramdef><type>geometry[]</type> <parameter>g1_array</parameter></paramdef> "
+"</funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:308
+#, no-c-format
+msgid ""
+"Output type can be a MULTI* or a GEOMETRYCOLLECTION. Comes in 2 variants. "
+"Variant 1 collects 2 geometries. Variant 2 is an aggregate function that "
+"takes a set of geometries and collects them into a single ST_Geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:312
+#, no-c-format
+msgid ""
+"Aggregate version: This function returns a GEOMETRYCOLLECTION or a MULTI "
+"object from a set of geometries. The ST_Collect() function is an \"aggregate"
+"\" function in the terminology of PostgreSQL. That means that it operates on "
+"rows of data, in the same way the SUM() and AVG() functions do. For example, "
+"\"SELECT ST_Collect(GEOM) FROM GEOMTABLE GROUP BY ATTRCOLUMN\" will return a "
+"separate GEOMETRYCOLLECTION for each distinct value of ATTRCOLUMN."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:320
+#, no-c-format
+msgid ""
+"Non-Aggregate version: This function returns a geometry being a collection "
+"of two input geometries. Output type can be a MULTI* or a GEOMETRYCOLLECTION."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:324
+#, no-c-format
+msgid ""
+"ST_Collect and ST_Union are often interchangeable. ST_Collect is in general "
+"orders of magnitude faster than ST_Union because it does not try to dissolve "
+"boundaries or validate that a constructed MultiPolgon doesn't have "
+"overlapping regions. It merely rolls up single geometries into MULTI and "
+"MULTI or mixed geometry types into Geometry Collections. Unfortunately "
+"geometry collections are not well-supported by GIS tools. To prevent "
+"ST_Collect from returning a Geometry Collection when collecting MULTI "
+"geometries, one can use the below trick that utilizes <xref linkend=\"ST_Dump"
+"\"/> to expand the MULTIs out to singles and then regroup them."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:335
+#, no-c-format
+msgid ""
+"Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was "
+"enhanced to handle more geometries faster."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:336 reference_processing.xml:543
+#: reference_processing.xml:598 reference_processing.xml:650
+#: reference_processing.xml:840 reference_processing.xml:894
+#: reference_processing.xml:952 reference_processing.xml:992
+#: reference_processing.xml:1098 reference_processing.xml:1160
+#: reference_processing.xml:1203 reference_processing.xml:1357
+#: reference_processing.xml:1567 reference_processing.xml:1682
+#: reference_processing.xml:2101
+#, no-c-format
+msgid "&Z_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:337
+#, no-c-format
+msgid ""
+"&curve_support; This method supports Circular Strings and Curves, but will "
+"never return a MULTICURVE or MULTI as one would expect and PostGIS does not "
+"currently support those."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:344
+#, no-c-format
+msgid ""
+"Aggregate example (<ulink url=\"http://postgis.refractions.net/pipermail/"
+"postgis-users/2008-June/020331.html\">http://postgis.refractions.net/"
+"pipermail/postgis-users/2008-June/020331.html</ulink>)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:345
+#, no-c-format
+msgid ""
+"SELECT stusps,\n"
+" ST_Multi(ST_Collect(f.the_geom)) as singlegeom\n"
+" FROM (SELECT stusps, (ST_Dump(the_geom)).geom As the_geom\n"
+" FROM\n"
+" somestatetable ) As f\n"
+"GROUP BY stusps"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:346 reference_processing.xml:2051
+#, no-c-format
+msgid "Non-Aggregate example"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:347
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Collect(ST_GeomFromText('POINT(1 2)'),\n"
+" ST_GeomFromText('POINT(-2 3)') ));\n"
+"\n"
+"st_astext\n"
+"----------\n"
+"MULTIPOINT(1 2,-2 3)\n"
+"\n"
+"--Collect 2 d points\n"
+"SELECT ST_AsText(ST_Collect(ST_GeomFromText('POINT(1 2)'),\n"
+" ST_GeomFromText('POINT(1 2)') ) );\n"
+"\n"
+"st_astext\n"
+"----------\n"
+"MULTIPOINT(1 2,1 2)\n"
+"\n"
+"--Collect 3d points\n"
+"SELECT ST_AsEWKT(ST_Collect(ST_GeomFromEWKT('POINT(1 2 3)'),\n"
+" ST_GeomFromEWKT('POINT(1 2 4)') ) );\n"
+"\n"
+" st_asewkt\n"
+"-------------------------\n"
+" MULTIPOINT(1 2 3,1 2 4)\n"
+"\n"
+" --Example with curves\n"
+"SELECT ST_AsText(ST_Collect(ST_GeomFromText('CIRCULARSTRING(220268 "
+"150415,220227 150505,220227 150406)'),\n"
+"ST_GeomFromText('CIRCULARSTRING(220227 150406,2220227 150407,220227 "
+"150406)')));\n"
+" st_astext\n"
+"------------------------------------------------------------------------------------\n"
+" GEOMETRYCOLLECTION(CIRCULARSTRING(220268 150415,220227 150505,220227 "
+"150406),\n"
+" CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))\n"
+"\n"
+"--New ST_Collect array construct\n"
+"SELECT ST_Collect(ARRAY(SELECT the_geom FROM sometable));\n"
+"\n"
+"SELECT ST_AsText(ST_Collect(ARRAY[ST_GeomFromText('LINESTRING(1 2, 3 4)'),\n"
+" ST_GeomFromText('LINESTRING(3 4, 4 5)')])) As "
+"wktcollect;\n"
+"\n"
+"--wkt collect --\n"
+"MULTILINESTRING((1 2,3 4),(3 4,4 5))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:351
+#, no-c-format
+msgid ", <xref linkend=\"ST_Union\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:356
+#, no-c-format
+msgid "ST_ConcaveHull"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:357
+#, no-c-format
+msgid ""
+"The concave hull of a geometry represents a possibly concave geometry that "
+"encloses all geometries within the set. You can think of it as shrink "
+"wrapping."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:363
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_ConcaveHull</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>target_percent</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>allow_holes=false</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:374
+#, no-c-format
+msgid ""
+"The concave hull of a geometry represents a possibly concave geometry that "
+"encloses all geometries within the set. Defaults to false for allowing "
+"polygons with holes. The result is never higher than a single polygon."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:378
+#, no-c-format
+msgid ""
+"The target_percent is the target percent of area of convex hull the PostGIS "
+"solution will try to approach before giving up or exiting. One can think of "
+"the concave hull as the geometry you get by vacuum sealing a set of "
+"geometries. The target_percent of 1 will give you the same answer as the "
+"convex hull. A target_percent between 0 and 0.99 will give you something "
+"that should have a smaller area than the convex hull. This is different from "
+"a convex hull which is more like wrapping a rubber band around the set of "
+"geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:383
+#, no-c-format
+msgid ""
+"It is usually used with MULTI and Geometry Collections. Although it is not "
+"an aggregate - you can use it in conjunction with ST_Collect or ST_Union to "
+"get the concave hull of a set of points/linestring/polygons "
+"ST_ConcaveHull(ST_Collect(somepointfield), 0.80)."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:388
+#, no-c-format
+msgid ""
+"It is much slower to compute than convex hull but encloses the geometry "
+"better and is also useful for image recognition."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:391 reference_processing.xml:539
+#: reference_processing.xml:743 reference_processing.xml:1059
+#: reference_processing.xml:1926
+#, no-c-format
+msgid "Performed by the GEOS module"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:392
+#, no-c-format
+msgid ""
+"Note - If you are using with points, linestrings, or geometry collections "
+"use ST_Collect. If you are using with polygons, use ST_Union since it may "
+"fail with invalid geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:395
+#, no-c-format
+msgid ""
+"Note - The smaller you make the target percent, the longer it takes to "
+"process the concave hull and more likely to run into topological exceptions. "
+"Also the more floating points and number of points you accrue. First try a "
+"0.99 which does a first hop, is usually very fast, sometimes as fast as "
+"computing the convex hull, and usually gives much better than 99% of shrink "
+"since it almost always overshoots. Second hope of 0.98 it slower, others get "
+"slower usually quadratically. To reduce precision and float points, use "
+"<xref linkend=\"ST_SimplifyPreserveTopology\"/> or <xref linkend="
+"\"ST_SnapToGrid\"/> after ST_ConcaveHull. ST_SnapToGrid is a bit faster, but "
+"could result in invalid geometries where as ST_SimplifyPreserveTopology "
+"almost always preserves the validity of the geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:400
+#, no-c-format
+msgid ""
+"More real world examples and brief explanation of the technique are shown "
+"<ulink url=\"http://www.bostongis.com/postgis_concavehull.snippet\">http://"
+"www.bostongis.com/postgis_concavehull.snippet</ulink>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:403
+#, no-c-format
+msgid ""
+"Also check out Simon Greener's article on demonstrating ConcaveHull "
+"introduced in Oracle 11G R2. <ulink url=\"http://www.spatialdbadvisor.com/"
+"oracle_spatial_tips_tricks/172/concave-hull-geometries-in-"
+"oracle-11gr2\">http://www.spatialdbadvisor.com/"
+"oracle_spatial_tips_tricks/172/concave-hull-geometries-in-oracle-11gr2</"
+"ulink>. The solution we get at 0.75 target percent of convex hull is similar "
+"to the shape Simon gets with Oracle SDO_CONCAVEHULL_BOUNDARY."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:407 reference_processing.xml:994
+#: reference_processing.xml:1565 reference_processing.xml:1819
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:412
+#, no-c-format
+msgid ""
+"--Get estimate of infected area based on point observations\n"
+"SELECT d.disease_type,\n"
+" ST_ConcaveHull(ST_Collect(d.pnt_geom), 0.99) As geom\n"
+" FROM disease_obs As d\n"
+" GROUP BY d.disease_type;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:422
+#, no-c-format
+msgid "ST_ConcaveHull of 2 polygons encased in target 100% shrink concave hull"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:425
+#, no-c-format
+msgid ""
+"-- geometries overlaid with concavehull \n"
+"-- at target 100% shrink (this is the same as convex hull - since no "
+"shrink)\n"
+"SELECT \n"
+" ST_ConcaveHull(\n"
+" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n"
+" 50 60, 125 100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" ), 1) \n"
+" As convexhull;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:432
+#, no-c-format
+msgid ""
+"-- geometries overlaid with concavehull at target 90% of convex hull area"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:436
+#, no-c-format
+msgid ""
+"-- geometries overlaid with concavehull at target 90% shrink\n"
+"SELECT \n"
+" ST_ConcaveHull(\n"
+" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n"
+" 50 60, 125 100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" ), 0.9) \n"
+" As target_90;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:445
+#, no-c-format
+msgid "L Shape points overlaid with convex hull"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:448
+#, no-c-format
+msgid ""
+"-- this produces a table of 42 points that form an L shape\n"
+"SELECT (ST_DumpPoints(ST_GeomFromText(\n"
+"'MULTIPOINT(14 14,34 14,54 14,74 14,94 14,114 14,134 14,\n"
+"150 14,154 14,154 6,134 6,114 6,94 6,74 6,54 6,34 6,\n"
+"14 6,10 6,8 6,7 7,6 8,6 10,6 30,6 50,6 70,6 90,6 110,6 130,\n"
+"6 150,6 170,6 190,6 194,14 194,14 174,14 154,14 134,14 114,\n"
+"14 94,14 74,14 54,14 34,14 14)'))).geom \n"
+" INTO TABLE l_shape;\n"
+"\n"
+"SELECT ST_ConvexHull(ST_Collect(geom))\n"
+"FROM l_shape;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:455
+#, no-c-format
+msgid "ST_ConcaveHull of L points at target 99% of convex hull"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:458
+#, no-c-format
+msgid ""
+"SELECT ST_ConcaveHull(ST_Collect(geom), 0.99)\n"
+" FROM l_shape;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:467
+#, no-c-format
+msgid "Concave Hull of L points at target 80% convex hull area"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:470
+#, no-c-format
+msgid ""
+"-- Concave Hull L shape points\n"
+" -- at target 80% of convexhull\n"
+" SELECT ST_ConcaveHull(ST_Collect(geom), 0.80)\n"
+" FROM l_shape;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:479
+#, no-c-format
+msgid "multilinestring overlaid with Convex hull"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:487
+#, no-c-format
+msgid ""
+"multilinestring with overlaid with Concave hull of linestrings at 99% target "
+"-- first hop"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:491
+#, no-c-format
+msgid ""
+"SELECT ST_ConcaveHull(ST_GeomFromText('MULTILINESTRING((106 164,30 112,74 "
+"70,82 112,130 94,\n"
+" 130 62,122 40,156 32,162 76,172 88),\n"
+"(132 178,134 148,128 136,96 128,132 108,150 130,\n"
+"170 142,174 110,156 96,158 90,158 88),\n"
+"(22 64,66 28,94 38,94 68,114 76,112 30,\n"
+"132 10,168 18,178 34,186 52,184 74,190 100,\n"
+"190 122,182 148,178 170,176 184,156 164,146 178,\n"
+"132 186,92 182,56 158,36 150,62 150,76 128,88 118))'),0.99)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:501
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_ConvexHull\"/>, <xref linkend="
+"\"ST_SimplifyPreserveTopology\"/>, <xref linkend=\"ST_SnapToGrid\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:507
+#, no-c-format
+msgid "ST_ConvexHull"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:508
+#, no-c-format
+msgid ""
+"<refpurpose>The convex hull of a geometry represents the minimum convex "
+"geometry that encloses all geometries within the set.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:514
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_ConvexHull</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:523
+#, no-c-format
+msgid ""
+"<para>The convex hull of a geometry represents the minimum convex geometry "
+"that encloses all geometries within the set.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:526
+#, no-c-format
+msgid ""
+"One can think of the convex hull as the geometry you get by wrapping an "
+"elastic band around a set of geometries. This is different from a concave "
+"hull which is analogous to shrink-wrapping your geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:530
+#, no-c-format
+msgid ""
+"It is usually used with MULTI and Geometry Collections. Although it is not "
+"an aggregate - you can use it in conjunction with ST_Collect to get the "
+"convex hull of a set of points. ST_ConvexHull(ST_Collect(somepointfield))."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:535
+#, no-c-format
+msgid ""
+"It is often used to determine an affected area based on a set of point "
+"observations."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:542
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.16"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:548
+#, no-c-format
+msgid ""
+"--Get estimate of infected area based on point observations\n"
+"SELECT d.disease_type,\n"
+" ST_ConvexHull(ST_Collect(d.the_geom)) As the_geom\n"
+" FROM disease_obs As d\n"
+" GROUP BY d.disease_type;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:556
+#, no-c-format
+msgid ""
+"Convex Hull of a MultiLinestring and a MultiPoint seen together with the "
+"MultiLinestring and MultiPoint"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:559
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_ConvexHull(\n"
+" ST_Collect(\n"
+" ST_GeomFromText('MULTILINESTRING((100 190,10 8),(150 10, 20 "
+"30))'),\n"
+" ST_GeomFromText('MULTIPOINT(50 5, 150 30, 50 10, 10 "
+"10)')\n"
+" )) );\n"
+"---st_astext--\n"
+"POLYGON((50 5,10 8,10 10,100 190,150 30,150 10,50 5))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:564
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_ConcaveHull\"/>, <xref linkend="
+"\"ST_MinimumBoundingCircle\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:570
+#, no-c-format
+msgid "ST_CurveToLine"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:572
+#, no-c-format
+msgid "Converts a CIRCULARSTRING/CURVEDPOLYGON to a LINESTRING/POLYGON"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_processing.xml:576
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_CurveToLine</function></"
+"funcdef> <paramdef><type>geometry</type> <parameter>curveGeom</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_CurveToLine</function></funcdef> <paramdef><type>geometry</"
+"type> <parameter>curveGeom</parameter></paramdef> <paramdef><type>integer</"
+"type> <parameter>segments_per_qtr_circle</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:592
+#, no-c-format
+msgid ""
+"Converst a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON. "
+"Useful for outputting to devices that can't support CIRCULARSTRING geometry "
+"types"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:593
+#, no-c-format
+msgid ""
+"Converts a given geometry to a linear geometry. Each curved geometry or "
+"segment is converted into a linear approximation using the default value of "
+"32 segments per quarter circle"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:595 reference_processing.xml:1097
+#, no-c-format
+msgid "Availability: 1.2.2?"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:596
+#, no-c-format
+msgid "&sfs_compliant;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:597
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 7.1.7"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:599 reference_processing.xml:837
+#: reference_processing.xml:891 reference_processing.xml:991
+#: reference_processing.xml:1099
+#, no-c-format
+msgid "&curve_support;"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:606
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 "
+"150415,220227 150505,220227 150406)')));\n"
+"\n"
+"--Result --\n"
+" LINESTRING(220268 150415,220269.95064912 150416.539364228,220271.823415575 "
+"150418.17258804,220273.613787707 150419.895736857,\n"
+" 220275.317452352 150421.704659462,220276.930305234 "
+"150423.594998003,220278.448460847 150425.562198489,\n"
+" 220279.868261823 150427.60152176,220281.186287736 "
+"150429.708054909,220282.399363347 150431.876723113,\n"
+" 220283.50456625 150434.10230186,220284.499233914 "
+"150436.379429536,220285.380970099 150438.702620341,220286.147650624 "
+"150441.066277505,\n"
+" 220286.797428488 150443.464706771,220287.328738321 "
+"150445.892130112,220287.740300149 150448.342699654,\n"
+" 220288.031122486 150450.810511759,220288.200504713 "
+"150453.289621251,220288.248038775 150455.77405574,\n"
+" 220288.173610157 150458.257830005,220287.977398166 "
+"150460.734960415,220287.659875492 150463.199479347,\n"
+" 220287.221807076 150465.64544956,220286.664248262 "
+"150468.066978495,220285.988542259 150470.458232479,220285.196316903 "
+"150472.81345077,\n"
+" 220284.289480732 150475.126959442,220283.270218395 "
+"150477.39318505,220282.140985384 150479.606668057,\n"
+" 220280.90450212 150481.762075989,220279.5637474 "
+"150483.85421628,220278.12195122 150485.87804878,\n"
+" 220276.582586992 150487.828697901,220274.949363179 "
+"150489.701464356,220273.226214362 150491.491836488,\n"
+" 220271.417291757 150493.195501133,220269.526953216 "
+"150494.808354014,220267.559752731 150496.326509628,\n"
+" 220265.520429459 150497.746310603,220263.41389631 "
+"150499.064336517,220261.245228106 150500.277412127,\n"
+" 220259.019649359 150501.38261503,220256.742521683 "
+"150502.377282695,220254.419330878 150503.259018879,\n"
+" 220252.055673714 150504.025699404,220249.657244448 "
+"150504.675477269,220247.229821107 150505.206787101,\n"
+" 220244.779251566 150505.61834893,220242.311439461 "
+"150505.909171266,220239.832329968 150506.078553494,\n"
+" 220237.347895479 150506.126087555,220234.864121215 "
+"150506.051658938,220232.386990804 150505.855446946,\n"
+" 220229.922471872 150505.537924272,220227.47650166 "
+"150505.099855856,220225.054972724 150504.542297043,\n"
+" 220222.663718741 150503.86659104,220220.308500449 150503.074365683,\n"
+" 220217.994991777 150502.167529512,220215.72876617 150501.148267175,\n"
+" 220213.515283163 150500.019034164,220211.35987523 150498.7825509,\n"
+" 220209.267734939 150497.441796181,220207.243902439 150496,\n"
+" 220205.293253319 150494.460635772,220203.420486864 "
+"150492.82741196,220201.630114732 150491.104263143,\n"
+" 220199.926450087 150489.295340538,220198.313597205 "
+"150487.405001997,220196.795441592 150485.437801511,\n"
+" 220195.375640616 150483.39847824,220194.057614703 "
+"150481.291945091,220192.844539092 150479.123276887,220191.739336189 "
+"150476.89769814,\n"
+" 220190.744668525 150474.620570464,220189.86293234 "
+"150472.297379659,220189.096251815 150469.933722495,\n"
+" 220188.446473951 150467.535293229,220187.915164118 "
+"150465.107869888,220187.50360229 150462.657300346,\n"
+" 220187.212779953 150460.189488241,220187.043397726 "
+"150457.710378749,220186.995863664 150455.22594426,\n"
+" 220187.070292282 150452.742169995,220187.266504273 "
+"150450.265039585,220187.584026947 150447.800520653,\n"
+" 220188.022095363 150445.35455044,220188.579654177 "
+"150442.933021505,220189.25536018 150440.541767521,\n"
+" 220190.047585536 150438.18654923,220190.954421707 "
+"150435.873040558,220191.973684044 150433.60681495,\n"
+" 220193.102917055 150431.393331943,220194.339400319 "
+"150429.237924011,220195.680155039 150427.14578372,220197.12195122 "
+"150425.12195122,\n"
+" 220198.661315447 150423.171302099,220200.29453926 "
+"150421.298535644,220202.017688077 150419.508163512,220203.826610682 "
+"150417.804498867,\n"
+" 220205.716949223 150416.191645986,220207.684149708 "
+"150414.673490372,220209.72347298 150413.253689397,220211.830006129 "
+"150411.935663483,\n"
+" 220213.998674333 150410.722587873,220216.22425308 "
+"150409.61738497,220218.501380756 150408.622717305,220220.824571561 "
+"150407.740981121,\n"
+" 220223.188228725 150406.974300596,220225.586657991 150406.324522731,220227 "
+"150406)\n"
+"\n"
+"--3d example\n"
+"SELECT ST_AsEWKT(ST_CurveToLine(ST_GeomFromEWKT('CIRCULARSTRING(220268 "
+"150415 1,220227 150505 2,220227 150406 3)')));\n"
+"Output\n"
+"------\n"
+" LINESTRING(220268 150415 1,220269.95064912 150416.539364228 "
+"1.0181172856673,\n"
+" 220271.823415575 150418.17258804 1.03623457133459,220273.613787707 "
+"150419.895736857 1.05435185700189,....AD INFINITUM ....\n"
+" 220225.586657991 150406.324522731 1.32611114201132,220227 150406 3)\n"
+"\n"
+"--use only 2 segments to approximate quarter circle\n"
+"SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 "
+"150415,220227 150505,220227 150406)'),2));\n"
+"st_astext\n"
+"------------------------------\n"
+" LINESTRING(220268 150415,220287.740300149 150448.342699654,220278.12195122 "
+"150485.87804878,\n"
+" 220244.779251566 150505.61834893,220207.243902439 150496,220187.50360229 "
+"150462.657300346,\n"
+" 220197.12195122 150425.12195122,220227 150406)"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:619
+#, no-c-format
+msgid "ST_DelaunayTriangles"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:621
+#, no-c-format
+msgid "Return a Delaunay triangulation around the given input points."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:628
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_DelaunayTriangles</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>tolerance</parameter></paramdef> "
+"<paramdef><type>int4 </type> <parameter>flags</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:640
+#, no-c-format
+msgid ""
+"Return a <ulink url=\"http://en.wikipedia.org/wiki/Delaunay_triangulation"
+"\">Delaunay triangulation</ulink> around the vertices of the input geometry. "
+"Output is a COLLECTION of polygons (for flags=0) or a MULTILINESTRING (for "
+"flags=1). The tolerance, if any, is used to snap input vertices togheter."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:649
+#, no-c-format
+msgid "Availability: 2.1.0 - requires GEOS >= 3.4.0."
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:654
+#, no-c-format
+msgid "2D Examples"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:663
+#, no-c-format
+msgid "Original polygons"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:666
+#, no-c-format
+msgid ""
+"-- our original geometry --\n"
+" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n"
+" 50 60, 125 100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" )"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:674
+#, no-c-format
+msgid ""
+"ST_DelaunayTriangles of 2 polygons: delaunay triangle polygons each triangle "
+"themed in different color"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:677
+#, no-c-format
+msgid ""
+"-- geometries overlaid multilinestring triangles\n"
+"SELECT \n"
+" ST_DelaunayTriangles(\n"
+" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n"
+" 50 60, 125 100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" )) \n"
+" As dtriag;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:684
+#, no-c-format
+msgid "-- delaunay triangles as multilinestring"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:687
+#, no-c-format
+msgid ""
+"SELECT \n"
+" ST_DelaunayTriangles(\n"
+" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n"
+" 50 60, 125 100, 175 150))'),\n"
+" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n"
+" ),0.001,1) \n"
+" As dtriag;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:695
+#, no-c-format
+msgid "-- delaunay triangles of 45 points as 55 triangle polygons"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:698
+#, no-c-format
+msgid ""
+"-- this produces a table of 42 points that form an L shape\n"
+"SELECT (ST_DumpPoints(ST_GeomFromText(\n"
+"'MULTIPOINT(14 14,34 14,54 14,74 14,94 14,114 14,134 14,\n"
+"150 14,154 14,154 6,134 6,114 6,94 6,74 6,54 6,34 6,\n"
+"14 6,10 6,8 6,7 7,6 8,6 10,6 30,6 50,6 70,6 90,6 110,6 130,\n"
+"6 150,6 170,6 190,6 194,14 194,14 174,14 154,14 134,14 114,\n"
+"14 94,14 74,14 54,14 34,14 14)'))).geom \n"
+" INTO TABLE l_shape;\n"
+"-- output as individual polygon triangles\n"
+"SELECT ST_AsText((ST_Dump(geom)).geom) As wkt\n"
+"FROM ( SELECT ST_DelaunayTriangles(ST_Collect(geom)) As geom\n"
+"FROM l_shape) As foo;\n"
+"\n"
+"---wkt ---\n"
+"POLYGON((6 194,6 190,14 194,6 194))\n"
+"POLYGON((14 194,6 190,14 174,14 194))\n"
+"POLYGON((14 194,14 174,154 14,14 194))\n"
+"POLYGON((154 14,14 174,14 154,154 14))\n"
+"POLYGON((154 14,14 154,150 14,154 14))\n"
+"POLYGON((154 14,150 14,154 6,154 14))\n"
+":\n"
+":"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:707
+#, no-c-format
+msgid "3D Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:708
+#, no-c-format
+msgid ""
+"-- 3D multipoint --\n"
+"SELECT ST_AsText(ST_DelaunayTriangles(ST_GeomFromText(\n"
+"'MULTIPOINT Z(14 14 10,\n"
+"150 14 100,34 6 25, 20 10 150)'))) As wkt;\n"
+"\n"
+"-----wkt----\n"
+"GEOMETRYCOLLECTION Z (POLYGON Z ((14 14 10,20 10 150,34 6 25,14 14 10))\n"
+" ,POLYGON Z ((14 14 10,34 6 25,150 14 100,14 14 10)))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:712 reference_processing.xml:1323
+#, no-c-format
+msgid ", <xref linkend=\"ST_Dump\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:719
+#, no-c-format
+msgid "ST_Difference"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:721
+#, no-c-format
+msgid ""
+"Returns a geometry that represents that part of geometry A that does not "
+"intersect with geometry B."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:727
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Difference</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:738
+#, no-c-format
+msgid ""
+"Returns a geometry that represents that part of geometry A that does not "
+"intersect with geometry B. One can think of this as GeometryA - "
+"ST_Intersection(A,B). If A is completely contained in B then an empty "
+"geometry collection is returned."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:741
+#, no-c-format
+msgid "Note - order matters. B - A will always return a portion of B"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:745 reference_processing.xml:1928
+#, no-c-format
+msgid "Do not call with a GeometryCollection as an argument"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:748
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.20"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:749 reference_processing.xml:1932
+#, no-c-format
+msgid ""
+"&Z_support; However it seems to only consider x y when doing the difference "
+"and tacks back on the Z-Index"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:766
+#, no-c-format
+msgid "The original linestrings shown together."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:778
+#, no-c-format
+msgid "The difference of the two linestrings"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:787
+#, no-c-format
+msgid ""
+"--Safe for 2d. This is same geometries as what is shown for "
+"st_symdifference\n"
+"SELECT ST_AsText(\n"
+" ST_Difference(\n"
+" ST_GeomFromText('LINESTRING(50 100, 50 200)'),\n"
+" ST_GeomFromText('LINESTRING(50 50, 50 150)')\n"
+" )\n"
+" );\n"
+"\n"
+"st_astext\n"
+"---------\n"
+"LINESTRING(50 150,50 200)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:789
+#, no-c-format
+msgid ""
+"--When used in 3d doesn't quite do the right thing\n"
+"SELECT ST_AsEWKT(ST_Difference(ST_GeomFromEWKT('MULTIPOINT(-118.58 38.38 "
+"5,-118.60 38.329 6,-118.614 38.281 7)'), ST_GeomFromEWKT('POINT(-118.614 "
+"38.281 5)')));\n"
+"st_asewkt\n"
+"---------\n"
+"MULTIPOINT(-118.6 38.329 6,-118.58 38.38 5)"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:802
+#, no-c-format
+msgid "ST_Dump"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:803
+#, no-c-format
+msgid ""
+"Returns a set of geometry_dump (geom,path) rows, that make up a geometry g1."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:808
+#, no-c-format
+msgid ""
+"<funcdef>geometry_dump[] <function>ST_Dump</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:817
+#, no-c-format
+msgid ""
+"This is a set-returning function (SRF). It returns a set of geometry_dump "
+"rows, formed by a geometry (geom) and an array of integers (path). When the "
+"input geometry is a simple type (POINT,LINESTRING,POLYGON) a single record "
+"will be returned with an empty path array and the input geometry as geom. "
+"When the input geometry is a collection or multi it will return a record for "
+"each of the collection components, and the path will express the position of "
+"the component inside the collection."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:826
+#, no-c-format
+msgid ""
+"ST_Dump is useful for expanding geometries. It is the reverse of a GROUP BY "
+"in that it creates new rows. For example it can be use to expand "
+"MULTIPOLYGONS into POLYGONS."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:830 reference_processing.xml:889
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was "
+"introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:831
+#, no-c-format
+msgid "Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:833
+#, no-c-format
+msgid ""
+"Prior to 1.3.4, this function crashes if used with geometries that contain "
+"CURVES. This is fixed in 1.3.4+"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:838 reference_processing.xml:892
+#: reference_processing.xml:995 reference_processing.xml:1566
+#: reference_processing.xml:1684
+#, no-c-format
+msgid "&P_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:839 reference_processing.xml:893
+#: reference_processing.xml:996 reference_processing.xml:1685
+#, no-c-format
+msgid "&T_support;"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:844
+#, no-c-format
+msgid "Standard Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:845
+#, no-c-format
+msgid ""
+"SELECT sometable.field1, sometable.field1,\n"
+" (ST_Dump(sometable.the_geom)).geom AS the_geom\n"
+"FROM sometable;\n"
+"\n"
+"-- Break a compound curve into its constituent linestrings and "
+"circularstrings\n"
+"SELECT ST_AsEWKT(a.geom), ST_HasArc(a.geom)\n"
+" FROM ( SELECT (ST_Dump(p_geom)).geom AS geom\n"
+" FROM (SELECT ST_GeomFromEWKT('COMPOUNDCURVE(CIRCULARSTRING(0 0, 1 "
+"1, 1 0),(1 0, 0 1))') AS p_geom) AS b\n"
+" ) AS a;\n"
+" st_asewkt | st_hasarc\n"
+"-----------------------------+----------\n"
+" CIRCULARSTRING(0 0,1 1,1 0) | t\n"
+" LINESTRING(1 0,0 1) | f\n"
+"(2 rows)"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:847 reference_processing.xml:914
+#, no-c-format
+msgid "Polyhedral Surfaces, TIN and Triangle Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:848
+#, no-c-format
+msgid ""
+"-- Polyhedral surface example\n"
+"-- Break a Polyhedral surface into its faces\n"
+"SELECT (a.p_geom).path[1] As path, ST_AsEWKT((a.p_geom).geom) As geom_ewkt\n"
+" FROM (SELECT ST_Dump(ST_GeomFromEWKT('POLYHEDRALSURFACE( \n"
+"((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n"
+"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 "
+"0)), ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 "
+"1)) \n"
+")') ) AS p_geom ) AS a;\n"
+"\n"
+" path | geom_ewkt\n"
+"------+------------------------------------------\n"
+" 1 | POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0))\n"
+" 2 | POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))\n"
+" 3 | POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))\n"
+" 4 | POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0))\n"
+" 5 | POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0))\n"
+" 6 | POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:850
+#, no-c-format
+msgid ""
+"-- TIN -- \n"
+"SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt\n"
+" FROM\n"
+" (SELECT \n"
+" ST_Dump( ST_GeomFromEWKT('TIN (((\n"
+" 0 0 0, \n"
+" 0 0 1, \n"
+" 0 1 0, \n"
+" 0 0 0\n"
+" )), ((\n"
+" 0 0 0, \n"
+" 0 1 0, \n"
+" 1 1 0, \n"
+" 0 0 0\n"
+" ))\n"
+" )') ) AS gdump\n"
+" ) AS g;\n"
+"-- result --\n"
+" path | wkt\n"
+"------+-------------------------------------\n"
+" {1} | TRIANGLE((0 0 0,0 0 1,0 1 0,0 0 0))\n"
+" {2} | TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:854
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_Geometry_DumpFunctions\"/>, <xref linkend="
+"\"ST_Collect\"/>, <xref linkend=\"ST_Collect\"/>, <xref linkend="
+"\"ST_GeometryN\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:860
+#, no-c-format
+msgid "ST_DumpPoints"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:861
+#, no-c-format
+msgid ""
+"Returns a set of geometry_dump (geom,path) rows of all points that make up a "
+"geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:866
+#, no-c-format
+msgid ""
+"<funcdef>geometry_dump[]<function>ST_DumpPoints</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:875
+#, no-c-format
+msgid ""
+"This set-returning function (SRF) returns a set of <varname>geometry_dump</"
+"varname> rows formed by a geometry (<varname>geom</varname>) and an array of "
+"integers (<varname>path</varname>)."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:878
+#, no-c-format
+msgid ""
+"The <parameter>geom</parameter> component of <varname>geometry_dump</"
+"varname> are all the <varname>POINT</varname>s that make up the supplied "
+"geometry"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:881
+#, no-c-format
+msgid ""
+"The <parameter>path</parameter> component of <varname>geometry_dump</"
+"varname> (an <varname>integer[]</varname>) is an index reference enumerating "
+"the <varname>POINT</varname>s of the supplied geometry. For example, if a "
+"<varname>LINESTRING</varname> is supplied, a path of <varname>{i}</varname> "
+"is returned where <varname>i</varname> is the <varname>nth</varname> "
+"coordinate in the <varname>LINESTRING</varname>. If a <varname>POLYGON</"
+"varname> is supplied, a path of <varname>{i,j}</varname> is returned where "
+"<varname>i</varname> is the ring number (1 is outer; inner rings follow) and "
+"<varname>j</varname> enumerates the <varname>POINT</varname>s (again 1-based "
+"index)."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:890
+#, no-c-format
+msgid "Availability: 1.5.0"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:897
+#, no-c-format
+msgid "Classic Explode a Table of LineStrings into nodes"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:898
+#, no-c-format
+msgid ""
+"SELECT edge_id, (dp).path[1] As index, ST_AsText((dp).geom) As wktnode\n"
+"FROM (SELECT 1 As edge_id\n"
+" , ST_DumpPoints(ST_GeomFromText('LINESTRING(1 2, 3 4, 10 10)')) AS "
+"dp\n"
+" UNION ALL\n"
+" SELECT 2 As edge_id\n"
+" , ST_DumpPoints(ST_GeomFromText('LINESTRING(3 5, 5 6, 9 10)')) AS "
+"dp\n"
+" ) As foo;\n"
+" edge_id | index | wktnode\n"
+"---------+-------+--------------\n"
+" 1 | 1 | POINT(1 2)\n"
+" 1 | 2 | POINT(3 4)\n"
+" 1 | 3 | POINT(10 10)\n"
+" 2 | 1 | POINT(3 5)\n"
+" 2 | 2 | POINT(5 6)\n"
+" 2 | 3 | POINT(9 10)"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:901
+#, no-c-format
+msgid "Standard Geometry Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:911
+#, no-c-format
+msgid ""
+"SELECT path, ST_AsText(geom) \n"
+"FROM (\n"
+" SELECT (ST_DumpPoints(g.geom)).* \n"
+" FROM\n"
+" (SELECT \n"
+" 'GEOMETRYCOLLECTION(\n"
+" POINT ( 0 1 ), \n"
+" LINESTRING ( 0 3, 3 4 ),\n"
+" POLYGON (( 2 0, 2 3, 0 2, 2 0 )),\n"
+" POLYGON (( 3 0, 3 3, 6 3, 6 0, 3 0 ), \n"
+" ( 5 1, 4 2, 5 2, 5 1 )),\n"
+" MULTIPOLYGON (\n"
+" (( 0 5, 0 8, 4 8, 4 5, 0 5 ), \n"
+" ( 1 6, 3 6, 2 7, 1 6 )), \n"
+" (( 5 4, 5 8, 6 7, 5 4 ))\n"
+" )\n"
+" )'::geometry AS geom\n"
+" ) AS g\n"
+" ) j;\n"
+" \n"
+" path | st_astext \n"
+"-----------+------------\n"
+" {1,1} | POINT(0 1)\n"
+" {2,1} | POINT(0 3)\n"
+" {2,2} | POINT(3 4)\n"
+" {3,1,1} | POINT(2 0)\n"
+" {3,1,2} | POINT(2 3)\n"
+" {3,1,3} | POINT(0 2)\n"
+" {3,1,4} | POINT(2 0)\n"
+" {4,1,1} | POINT(3 0)\n"
+" {4,1,2} | POINT(3 3)\n"
+" {4,1,3} | POINT(6 3)\n"
+" {4,1,4} | POINT(6 0)\n"
+" {4,1,5} | POINT(3 0)\n"
+" {4,2,1} | POINT(5 1)\n"
+" {4,2,2} | POINT(4 2)\n"
+" {4,2,3} | POINT(5 2)\n"
+" {4,2,4} | POINT(5 1)\n"
+" {5,1,1,1} | POINT(0 5)\n"
+" {5,1,1,2} | POINT(0 8)\n"
+" {5,1,1,3} | POINT(4 8)\n"
+" {5,1,1,4} | POINT(4 5)\n"
+" {5,1,1,5} | POINT(0 5)\n"
+" {5,1,2,1} | POINT(1 6)\n"
+" {5,1,2,2} | POINT(3 6)\n"
+" {5,1,2,3} | POINT(2 7)\n"
+" {5,1,2,4} | POINT(1 6)\n"
+" {5,2,1,1} | POINT(5 4)\n"
+" {5,2,1,2} | POINT(5 8)\n"
+" {5,2,1,3} | POINT(6 7)\n"
+" {5,2,1,4} | POINT(5 4)\n"
+"(29 rows)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:915
+#, no-c-format
+msgid ""
+"-- Polyhedral surface cube -- \n"
+"SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt\n"
+" FROM\n"
+" (SELECT \n"
+" ST_DumpPoints(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 "
+"1, 0 1 0, 0 0 0)), \n"
+"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 "
+"0)), \n"
+"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n"
+"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 "
+"1)) )') ) AS gdump\n"
+" ) AS g;\n"
+"-- result --\n"
+" path | wkt\n"
+"---------+--------------\n"
+" {1,1,1} | POINT(0 0 0)\n"
+" {1,1,2} | POINT(0 0 1)\n"
+" {1,1,3} | POINT(0 1 1)\n"
+" {1,1,4} | POINT(0 1 0)\n"
+" {1,1,5} | POINT(0 0 0)\n"
+" {2,1,1} | POINT(0 0 0)\n"
+" {2,1,2} | POINT(0 1 0)\n"
+" {2,1,3} | POINT(1 1 0)\n"
+" {2,1,4} | POINT(1 0 0)\n"
+" {2,1,5} | POINT(0 0 0)\n"
+" {3,1,1} | POINT(0 0 0)\n"
+" {3,1,2} | POINT(1 0 0)\n"
+" {3,1,3} | POINT(1 0 1)\n"
+" {3,1,4} | POINT(0 0 1)\n"
+" {3,1,5} | POINT(0 0 0)\n"
+" {4,1,1} | POINT(1 1 0)\n"
+" {4,1,2} | POINT(1 1 1)\n"
+" {4,1,3} | POINT(1 0 1)\n"
+" {4,1,4} | POINT(1 0 0)\n"
+" {4,1,5} | POINT(1 1 0)\n"
+" {5,1,1} | POINT(0 1 0)\n"
+" {5,1,2} | POINT(0 1 1)\n"
+" {5,1,3} | POINT(1 1 1)\n"
+" {5,1,4} | POINT(1 1 0)\n"
+" {5,1,5} | POINT(0 1 0)\n"
+" {6,1,1} | POINT(0 0 1)\n"
+" {6,1,2} | POINT(1 0 1)\n"
+" {6,1,3} | POINT(1 1 1)\n"
+" {6,1,4} | POINT(0 1 1)\n"
+" {6,1,5} | POINT(0 0 1)\n"
+"(30 rows)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:916
+#, no-c-format
+msgid ""
+"-- Triangle -- \n"
+"SELECT (g.gdump).path, ST_AsText((g.gdump).geom) as wkt\n"
+" FROM\n"
+" (SELECT \n"
+" ST_DumpPoints( ST_GeomFromEWKT('TRIANGLE ((\n"
+" 0 0, \n"
+" 0 9, \n"
+" 9 0, \n"
+" 0 0\n"
+" ))') ) AS gdump\n"
+" ) AS g;\n"
+"-- result --\n"
+" path | wkt\n"
+"------+------------\n"
+" {1} | POINT(0 0)\n"
+" {2} | POINT(0 9)\n"
+" {3} | POINT(9 0)\n"
+" {4} | POINT(0 0)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:917
+#, no-c-format
+msgid ""
+"-- TIN -- \n"
+"SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt\n"
+" FROM\n"
+" (SELECT \n"
+" ST_DumpPoints( ST_GeomFromEWKT('TIN (((\n"
+" 0 0 0, \n"
+" 0 0 1, \n"
+" 0 1 0, \n"
+" 0 0 0\n"
+" )), ((\n"
+" 0 0 0, \n"
+" 0 1 0, \n"
+" 1 1 0, \n"
+" 0 0 0\n"
+" ))\n"
+" )') ) AS gdump\n"
+" ) AS g;\n"
+"-- result --\n"
+" path | wkt\n"
+"---------+--------------\n"
+" {1,1,1} | POINT(0 0 0)\n"
+" {1,1,2} | POINT(0 0 1)\n"
+" {1,1,3} | POINT(0 1 0)\n"
+" {1,1,4} | POINT(0 0 0)\n"
+" {2,1,1} | POINT(0 0 0)\n"
+" {2,1,2} | POINT(0 1 0)\n"
+" {2,1,3} | POINT(1 1 0)\n"
+" {2,1,4} | POINT(0 0 0)\n"
+"(8 rows)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:921
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_Geometry_DumpFunctions\"/>, <xref linkend=\"ST_Dump"
+"\"/>, <xref linkend=\"ST_DumpRings\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:926
+#, no-c-format
+msgid "ST_DumpRings"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:928
+#, no-c-format
+msgid ""
+"Returns a set of <varname>geometry_dump</varname> rows, representing the "
+"exterior and interior rings of a polygon."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:934
+#, no-c-format
+msgid ""
+"<funcdef>geometry_dump[] <function>ST_DumpRings</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>a_polygon</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:944
+#, no-c-format
+msgid ""
+"This is a set-returning function (SRF). It returns a set of "
+"<varname>geometry_dump</varname> rows, defined as an <varname>integer[]</"
+"varname> and a <varname>geometry</varname>, aliased \"path\" and \"geom\" "
+"respectively. The \"path\" field holds the polygon ring index containing a "
+"single integer: 0 for the shell, >0 for holes. The \"geom\" field contains "
+"the corresponding ring as a polygon."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:950
+#, no-c-format
+msgid "Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:951
+#, no-c-format
+msgid ""
+"This only works for POLYGON geometries. It will not work for MULTIPOLYGONS"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:959
+#, no-c-format
+msgid ""
+"SELECT sometable.field1, sometable.field1,\n"
+" (ST_DumpRings(sometable.the_geom)).geom As the_geom\n"
+"FROM sometableOfpolys;\n"
+"\n"
+"SELECT ST_AsEWKT(geom) As the_geom, path\n"
+" FROM ST_DumpRings(\n"
+" ST_GeomFromEWKT('POLYGON((-8149064 5133092 1,-8149064 "
+"5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,-8148941 "
+"5132466 1,-8148924 5132394 1,\n"
+" -8148903 5132210 1,-8148930 5131967 1,-8148992 5131978 "
+"1,-8149237 5132093 1,-8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 "
+"1,\n"
+" -8150305 5132788 1,-8149064 5133092 1),\n"
+" (-8149362 5132394 1,-8149446 5132501 1,-8149548 5132597 "
+"1,-8149695 5132675 1,-8149362 5132394 1))')\n"
+" ) as foo;\n"
+" path | the_geom\n"
+"----------------------------------------------------------------------------------------------------------------\n"
+" {0} | POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 "
+"1,-8148972 5132767 1,-8148958 5132508 1,\n"
+" | -8148941 5132466 1,-8148924 5132394 1,\n"
+" | -8148903 5132210 1,-8148930 5131967 1,\n"
+" | -8148992 5131978 1,-8149237 5132093 1,\n"
+" | -8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 "
+"1,-8150305 5132788 1,-8149064 5133092 1))\n"
+" {1} | POLYGON((-8149362 5132394 1,-8149446 5132501 1,\n"
+" | -8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 "
+"1))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:966
+#, no-c-format
+msgid ""
+", <xref linkend=\"PostGIS_Geometry_DumpFunctions\"/>, <xref linkend=\"ST_Dump"
+"\"/>, <xref linkend=\"ST_ExteriorRing\"/>, <xref linkend=\"ST_InteriorRingN"
+"\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:972
+#, no-c-format
+msgid "ST_FlipCoordinates"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:973
+#, no-c-format
+msgid ""
+"Returns a version of the given geometry with X and Y axis flipped. Useful "
+"for people who have built latitude/longitude features and need to fix them."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:981
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_FlipCoordinates</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:990
+#, no-c-format
+msgid "Returns a version of the given geometry with X and Y axis flipped."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:993
+#, no-c-format
+msgid "&M_support;"
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:1000
+#, no-c-format
+msgid "Example"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1001
+#, no-c-format
+msgid ""
+"<![CDATA[\n"
+"SELECT ST_AsEWKT(ST_FlipCoordinates(GeomFromEWKT('POINT(1 2)')));\n"
+" st_asewkt \n"
+"------------\n"
+"POINT(2 1)\n"
+" ]]>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1008
+#, no-c-format
+msgid "ST_Intersection"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1010
+#, no-c-format
+msgid ""
+"(T) Returns a geometry that represents the shared portion of geomA and "
+"geomB. The geography implementation does a transform to geometry to do the "
+"intersection and then transform back to WGS84."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_processing.xml:1015
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Intersection</function></"
+"funcdef> <paramdef> <type>geometry</type> <parameter>geomA</parameter> </"
+"paramdef> <paramdef> <type>geometry</type> <parameter>geomB</parameter> </"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geography "
+"<function>ST_Intersection</function></funcdef> <paramdef> <type>geography</"
+"type> <parameter>geogA</parameter> </paramdef> <paramdef> <type>geography</"
+"type> <parameter>geogB</parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1042
+#, no-c-format
+msgid ""
+"Returns a geometry that represents the point set intersection of the "
+"Geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1045
+#, no-c-format
+msgid ""
+"In other words - that portion of geometry A and geometry B that is shared "
+"between the two geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1048
+#, no-c-format
+msgid ""
+"If the geometries do not share any space (are disjoint), then an empty "
+"geometry collection is returned."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1050
+#, no-c-format
+msgid ""
+"ST_Intersection in conjunction with ST_Intersects is very useful for "
+"clipping geometries such as in bounding box, buffer, region queries where "
+"you only want to return that portion of a geometry that sits in a country or "
+"region of interest."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1053
+#, no-c-format
+msgid ""
+"Geography: For geography this is really a thin wrapper around the geometry "
+"implementation. It first determines the best SRID that fits the bounding box "
+"of the 2 geography objects (if geography objects are within one half zone "
+"UTM but not same UTM will pick one of those) (favoring UTM or Lambert "
+"Azimuthal Equal Area (LAEA) north/south pole, and falling back on mercator "
+"in worst case scenario) and then intersection in that best fit planar "
+"spatial ref and retransforms back to WGS84 geography."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1056
+#, no-c-format
+msgid "Do not call with a <varname>GEOMETRYCOLLECTION</varname> as an argument"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1061
+#, no-c-format
+msgid "Availability: 1.5 support for geography data type was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1064
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.18"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1068
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, "
+"0 2 )'::geometry));\n"
+" st_astext\n"
+"---------------\n"
+"GEOMETRYCOLLECTION EMPTY\n"
+"(1 row)\n"
+"SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, "
+"0 2 )'::geometry));\n"
+" st_astext\n"
+"---------------\n"
+"POINT(0 0)\n"
+"(1 row)\n"
+"\n"
+"---Clip all lines (trails) by country (here we assume country geom are "
+"POLYGON or MULTIPOLYGONS)\n"
+"-- NOTE: we are only keeping intersections that result in a LINESTRING or "
+"MULTILINESTRING because we don't\n"
+"-- care about trails that just share a point\n"
+"-- the dump is needed to expand a geometry collection into individual single "
+"MULT* parts\n"
+"-- the below is fairly generic and will work for polys, etc. by just "
+"changing the where clause\n"
+"SELECT clipped.gid, clipped.f_name, clipped_geom\n"
+"FROM (SELECT trails.gid, trails.f_name, (ST_Dump(ST_Intersection(country."
+"the_geom, trails.the_geom))).geom As clipped_geom\n"
+"FROM country\n"
+" INNER JOIN trails\n"
+" ON ST_Intersects(country.the_geom, trails.the_geom)) As clipped\n"
+" WHERE ST_Dimension(clipped.clipped_geom) = 1 ;\n"
+"\n"
+"--For polys e.g. polygon landmarks, you can also use the sometimes faster "
+"hack that buffering anything by 0.0\n"
+"-- except a polygon results in an empty geometry collection\n"
+"--(so a geometry collection containing polys, lines and points)\n"
+"-- buffered by 0.0 would only leave the polygons and dissolve the collection "
+"shell\n"
+"SELECT poly.gid, ST_Multi(ST_Buffer(\n"
+" ST_Intersection(country.the_geom, poly."
+"the_geom),\n"
+" 0.0)\n"
+" ) As clipped_geom\n"
+"FROM country\n"
+" INNER JOIN poly\n"
+" ON ST_Intersects(country.the_geom, poly.the_geom)\n"
+" WHERE Not ST_IsEmpty(ST_Buffer(ST_Intersection(country.the_geom, "
+"poly.the_geom),0.0));"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1072
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Dimension\"/>, <xref linkend=\"ST_Dump\"/>, <xref "
+"linkend=\"ST_SymDifference\"/>, <xref linkend=\"ST_Intersects\"/>, <xref "
+"linkend=\"ST_Multi\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1078
+#, no-c-format
+msgid "ST_LineToCurve"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1080
+#, no-c-format
+msgid "Converts a LINESTRING/POLYGON to a CIRCULARSTRING, CURVED POLYGON"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1085
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_LineToCurve</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomANoncircular</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1095
+#, no-c-format
+msgid ""
+"Converts plain LINESTRING/POLYGONS to CIRCULAR STRINGs and Curved Polygons. "
+"Note much fewer points are needed to describe the curved equivalent."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1106
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_LineToCurve(foo.the_geom)) As curvedastext,ST_AsText(foo."
+"the_geom) As non_curvedastext\n"
+" FROM (SELECT ST_Buffer('POINT(1 3)'::geometry, 3) As the_geom) As "
+"foo;\n"
+"\n"
+"curvedatext "
+"non_curvedastext\n"
+"--------------------------------------------------------------------|-----------------------------------------------------------------\n"
+"CURVEPOLYGON(CIRCULARSTRING(4 3,3.12132034355964 0.878679656440359, | "
+"POLYGON((4 3,3.94235584120969 2.41472903395162,3.77163859753386 "
+"1.85194970290473,\n"
+"1 0,-1.12132034355965 5.12132034355963,4 3)) | "
+"3.49440883690764 1.33328930094119,3.12132034355964 0.878679656440359,\n"
+" | "
+"2.66671069905881 0.505591163092366,2.14805029709527 0.228361402466141,\n"
+" | "
+"1.58527096604839 0.0576441587903094,1 0,\n"
+" | "
+"0.414729033951621 0.0576441587903077,-0.148050297095264 0.228361402466137,\n"
+" | "
+"-0.666710699058802 0.505591163092361,-1.12132034355964 0.878679656440353,\n"
+" | "
+"-1.49440883690763 1.33328930094119,-1.77163859753386 1.85194970290472\n"
+" | --"
+"ETC-- ,3.94235584120969 3.58527096604839,4 3))\n"
+"--3D example\n"
+"SELECT ST_AsEWKT(ST_LineToCurve(ST_GeomFromEWKT('LINESTRING(1 2 3, 3 4 8, 5 "
+"6 4, 7 8 4, 9 10 4)')));\n"
+"\n"
+" st_asewkt\n"
+"------------------------------------\n"
+" CIRCULARSTRING(1 2 3,5 6 4,9 10 4)"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1119
+#, no-c-format
+msgid "ST_MakeValid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1120
+#, no-c-format
+msgid "Attempts to make an invalid geometry valid w/out loosing vertices."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1125
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MakeValid</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>input</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1134
+#, no-c-format
+msgid ""
+"The function attempts to create a valid representation of a given invalid "
+"geometry without loosing any of the input vertices. Already-valid geometries "
+"are returned w/out further intervention."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1140
+#, no-c-format
+msgid ""
+"Supported inputs are: POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, "
+"POLYGONS, MULTIPOLYGONS and GEOMETRYCOLLECTIONS containing any mix of them."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1146
+#, no-c-format
+msgid ""
+"In case of full or partial dimensional collapses, the output geometry may be "
+"a collection of lower-to-equal dimension geometries or a geometry of lower "
+"dimension."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1152
+#, no-c-format
+msgid ""
+"Single polygons may become multi-geometries in case of self-intersections."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1156
+#, no-c-format
+msgid "Availability: 2.0.0, requires GEOS-3.3.0"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1157
+#, no-c-format
+msgid "Enahnced: 2.0.1, speed improvements requires GEOS-3.3.4"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1158
+#, no-c-format
+msgid "Enhanced: 2.1.0 added support for GEOMETRYCOLLECTION and MULTIPOINT."
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1175
+#, no-c-format
+msgid "ST_MemUnion"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1177
+#, no-c-format
+msgid ""
+"Same as ST_Union, only memory-friendly (uses less memory and more processor "
+"time)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1183
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MemUnion</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>geomfield</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1194
+#, no-c-format
+msgid "Some useful description here."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1198
+#, no-c-format
+msgid ""
+"Same as ST_Union, only memory-friendly (uses less memory and more processor "
+"time). This aggregate function works by unioning the geometries one at a "
+"time to previous result as opposed to ST_Union aggregate which first creates "
+"an array and then unions"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1210
+#, no-c-format
+msgid "See ST_Union"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1223
+#, no-c-format
+msgid "ST_MinimumBoundingCircle"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1224
+#, no-c-format
+msgid ""
+"Returns the smallest circle polygon that can fully contain a geometry. "
+"Default uses 48 segments per quarter circle."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1230
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_MinimumBoundingCircle</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>num_segs_per_qt_circ=48</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1240
+#, no-c-format
+msgid "Returns the smallest circle polygon that can fully contain a geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1241
+#, no-c-format
+msgid ""
+"The circle is approximated by a polygon with a default of 48 segments per "
+"quarter circle. This number can be increased with little performance penalty "
+"to obtain a more accurate result."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1243
+#, no-c-format
+msgid ""
+"It is often used with MULTI and Geometry Collections. Although it is not an "
+"aggregate - you can use it in conjunction with ST_Collect to get the minimum "
+"bounding circle of a set of geometries. "
+"ST_MinimumBoundingCircle(ST_Collect(somepointfield))."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1248
+#, no-c-format
+msgid ""
+"The ratio of the area of a polygon divided by the area of its Minimum "
+"Bounding Circle is often referred to as the Roeck test."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1250
+#, no-c-format
+msgid "Availability: 1.4.0 - requires GEOS"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1257
+#, no-c-format
+msgid ""
+"SELECT d.disease_type,\n"
+" ST_MinimumBoundingCircle(ST_Collect(d.the_geom)) As the_geom\n"
+" FROM disease_obs As d\n"
+" GROUP BY d.disease_type;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1263
+#, no-c-format
+msgid ""
+"Minimum bounding circle of a point and linestring. Using 8 segs to "
+"approximate a quarter circle"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1266
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_MinimumBoundingCircle(\n"
+" ST_Collect(\n"
+" ST_GeomFromEWKT('LINESTRING(55 75,125 150)'),\n"
+" ST_Point(20, 80)), 8\n"
+" )) As wktmbc;\n"
+"wktmbc\n"
+"-----------\n"
+"POLYGON((135.59714732062 115,134.384753327498 "
+"102.690357210921,130.79416296937 90.8537670908995,124.963360620072 "
+"79.9451031602111,117.116420743937 70.3835792560632,107.554896839789 "
+"62.5366393799277,96.6462329091006 56.70583703063,84.8096427890789 "
+"53.115246672502,72.5000000000001 51.9028526793802,60.1903572109213 "
+"53.1152466725019,48.3537670908996 56.7058370306299,37.4451031602112 "
+"62.5366393799276,27.8835792560632 70.383579256063,20.0366393799278 "
+"79.9451031602109,14.20583703063 90.8537670908993,10.615246672502 "
+"102.690357210921,9.40285267938019 115,10.6152466725019 "
+"127.309642789079,14.2058370306299 139.1462329091,20.0366393799275 "
+"150.054896839789,27.883579256063 159.616420743937,\n"
+"37.4451031602108 167.463360620072,48.3537670908992 "
+"173.29416296937,60.190357210921 176.884753327498,\n"
+"72.4999999999998 178.09714732062,84.8096427890786 "
+"176.884753327498,96.6462329091003 173.29416296937,107.554896839789 "
+"167.463360620072,\n"
+"117.116420743937 159.616420743937,124.963360620072 "
+"150.054896839789,130.79416296937 139.146232909101,134.384753327498 "
+"127.309642789079,135.59714732062 115))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1270
+#, no-c-format
+msgid ", <xref linkend=\"ST_ConvexHull\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1276
+#, no-c-format
+msgid "ST_Polygonize"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1278
+#, no-c-format
+msgid ""
+"Aggregate. Creates a GeometryCollection containing possible polygons formed "
+"from the constituent linework of a set of geometries."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_processing.xml:1284
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Polygonize</function></"
+"funcdef> <paramdef><type>geometry set</type> <parameter>geomfield</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Polygonize</function></funcdef> <paramdef><type>geometry[]</"
+"type> <parameter>geom_array</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1300
+#, no-c-format
+msgid ""
+"Creates a GeometryCollection containing possible polygons formed from the "
+"constituent linework of a set of geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1305
+#, no-c-format
+msgid ""
+"Geometry Collections are often difficult to deal with with third party "
+"tools, so use ST_Polygonize in conjunction with <xref linkend=\"ST_Dump\"/> "
+"to dump the polygons out into individual polygons."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1313
+#, no-c-format
+msgid "Availability: 1.0.0RC1 - requires GEOS >= 2.1.0."
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:1317
+#, no-c-format
+msgid "Examples: Polygonizing single linestrings"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1318
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(ST_Polygonize(the_geom_4269)) As geomtextrep\n"
+"FROM (SELECT the_geom_4269 FROM ma.suffolk_edges ORDER BY tlid LIMIT 45) As "
+"foo;\n"
+"\n"
+"geomtextrep\n"
+"-------------------------------------\n"
+" SRID=4269;GEOMETRYCOLLECTION(POLYGON((-71.040878 42.285678,-71.040943 "
+"42.2856,-71.04096 42.285752,-71.040878 42.285678)),\n"
+" POLYGON((-71.17166 42.353675,-71.172026 42.354044,-71.17239 "
+"42.354358,-71.171794 42.354971,-71.170511 42.354855,\n"
+" -71.17112 42.354238,-71.17166 42.353675)))\n"
+"(1 row)\n"
+"\n"
+"--Use ST_Dump to dump out the polygonize geoms into individual polygons\n"
+"SELECT ST_AsEWKT((ST_Dump(foofoo.polycoll)).geom) As geomtextrep\n"
+"FROM (SELECT ST_Polygonize(the_geom_4269) As polycoll\n"
+" FROM (SELECT the_geom_4269 FROM ma.suffolk_edges\n"
+" ORDER BY tlid LIMIT 45) As foo) As foofoo;\n"
+"\n"
+"geomtextrep\n"
+"------------------------\n"
+" SRID=4269;POLYGON((-71.040878 42.285678,-71.040943 42.2856,-71.04096 "
+"42.285752,\n"
+"-71.040878 42.285678))\n"
+" SRID=4269;POLYGON((-71.17166 42.353675,-71.172026 42.354044,-71.17239 "
+"42.354358\n"
+",-71.171794 42.354971,-71.170511 42.354855,-71.17112 42.354238,-71.17166 "
+"42.353675))\n"
+"(2 rows)"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1332
+#, no-c-format
+msgid "ST_Node"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1334
+#, no-c-format
+msgid "Node a set of linestrings."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1341
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Node</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1352
+#, no-c-format
+msgid ""
+"Fully node a set of linestrings using the least possible number of nodes "
+"while preserving all of the input ones."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1359 reference_processing.xml:2103
+#, no-c-format
+msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1361
+#, no-c-format
+msgid ""
+"Due to a bug in GEOS up to 3.3.1 this function fails to node self-"
+"intersecting lines. This is fixed with GEOS 3.3.2 or higher."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1368
+#, no-c-format
+msgid ""
+"SELECT ST_AsEWKT(\n"
+" ST_Node('LINESTRINGZ(0 0 0, 10 10 10, 0 10 5, 10 0 3)'::"
+"geometry)\n"
+" ) As output;\n"
+"output\n"
+"-----------\n"
+"MULTILINESTRING((0 0 0,5 5 4.5),(5 5 4.5,10 10 10,0 10 5,5 5 4.5),(5 5 "
+"4.5,10 0 3))"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1383
+#, no-c-format
+msgid "ST_OffsetCurve"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1385
+#, no-c-format
+msgid ""
+"Return an offset line at a given distance and side from an input line. "
+"Useful for computing parallel lines about a center line"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1393
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_OffsetCurve</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>line</parameter></paramdef> "
+"<paramdef><type>float </type> <parameter>signed_distance</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>style_parameters=''</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1406
+#, no-c-format
+msgid ""
+"Return an offset line at a given distance and side from an input line. All "
+"points of the returned geometries are not further than the given distance "
+"from the input geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1412
+#, no-c-format
+msgid ""
+"For positive distance the offset will be at the left side of the input line "
+"and retain the same direction. For a negative distance it'll be at the right "
+"side and in the opposite direction."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1418
+#, no-c-format
+msgid ""
+"Availability: 2.0 - requires GEOS >= 3.2, improved with GEOS >= 3.3"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1422
+#, no-c-format
+msgid ""
+"The optional third parameter allows specifying a list of blank-separated "
+"key=value pairs to tweak operations as follows:"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1430
+#, no-c-format
+msgid ""
+"'join=round|mitre|bevel' : join style (defaults to \"round\"). 'miter' is "
+"also accepted as a synonym for 'mitre'."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1433
+#, no-c-format
+msgid ""
+"'mitre_limit=#.#' : mitre ratio limit (only affects mitred join style). "
+"'miter_limit' is also accepted as a synonym for 'mitre_limit'."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1438
+#, no-c-format
+msgid ""
+"Units of distance are measured in units of the spatial reference system."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1442
+#, no-c-format
+msgid "The inputs can only be LINESTRINGS."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1446
+#, no-c-format
+msgid ""
+"This function ignores the third dimension (z) and will always give a 2-d "
+"result even when presented with a 3d-geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1454
+#, no-c-format
+msgid "Compute an open buffer around roads"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1455
+#, no-c-format
+msgid ""
+"SELECT ST_Union(\n"
+" ST_OffsetCurve(f.the_geom, f.width/2, 'quad_segs=4 join=round'),\n"
+" ST_OffsetCurve(f.the_geom, -f.width/2, 'quad_segs=4 join=round')\n"
+") as track\n"
+"FROM someroadstable;"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1465
+#, no-c-format
+msgid "15, 'quad_segs=4 join=round' original line and its offset 15 units."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1469
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n"
+"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n"
+" 44 16,24 16,20 16,18 16,17 17,\n"
+" 16 18,16 20,16 40,16 60,16 80,16 100,\n"
+" 16 120,16 140,16 160,16 180,16 195)'),\n"
+" 15, 'quad_segs=4 join=round'));\n"
+"--output --\n"
+"LINESTRING(164 1,18 1,12.2597485145237 2.1418070123307,\n"
+" 7.39339828220179 5.39339828220179,\n"
+" 5.39339828220179 7.39339828220179,\n"
+" 2.14180701233067 12.2597485145237,1 18,1 195)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1476
+#, no-c-format
+msgid "-15, 'quad_segs=4 join=round' original line and its offset -15 units"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1480
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_OffsetCurve(geom,\n"
+" -15, 'quad_segs=4 join=round')) As notsocurvy\n"
+" FROM ST_GeomFromText(\n"
+"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n"
+" 44 16,24 16,20 16,18 16,17 17,\n"
+" 16 18,16 20,16 40,16 60,16 80,16 100,\n"
+" 16 120,16 140,16 160,16 180,16 195)') As geom;\n"
+"-- notsocurvy --\n"
+"LINESTRING(31 195,31 31,164 31)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1489
+#, no-c-format
+msgid ""
+"double-offset to get more curvy, note the first reverses direction, so -30 + "
+"15 = -15"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1492
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_OffsetCurve(ST_OffsetCurve(geom,\n"
+" -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')) As "
+"morecurvy\n"
+" FROM ST_GeomFromText(\n"
+"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n"
+" 44 16,24 16,20 16,18 16,17 17,\n"
+" 16 18,16 20,16 40,16 60,16 80,16 100,\n"
+" 16 120,16 140,16 160,16 180,16 195)') As geom;\n"
+"-- morecurvy --\n"
+"LINESTRING(164 31,46 31,40.2597485145236 32.1418070123307,\n"
+"35.3933982822018 35.3933982822018,\n"
+"32.1418070123307 40.2597485145237,31 46,31 195)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1499
+#, no-c-format
+msgid ""
+"double-offset to get more curvy,combined with regular offset 15 to get "
+"parallel lines. Overlaid with original."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1502
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Collect(\n"
+" ST_OffsetCurve(geom, 15, 'quad_segs=4 join=round'), \n"
+" ST_OffsetCurve(ST_OffsetCurve(geom,\n"
+" -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')\n"
+" )\n"
+") As parallel_curves\n"
+" FROM ST_GeomFromText(\n"
+"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n"
+" 44 16,24 16,20 16,18 16,17 17,\n"
+" 16 18,16 20,16 40,16 60,16 80,16 100,\n"
+" 16 120,16 140,16 160,16 180,16 195)') As geom;\n"
+"-- parallel curves --\n"
+"MULTILINESTRING((164 1,18 1,12.2597485145237 2.1418070123307,\n"
+"7.39339828220179 5.39339828220179,5.39339828220179 7.39339828220179,\n"
+"2.14180701233067 12.2597485145237,1 18,1 195),\n"
+"(164 31,46 31,40.2597485145236 32.1418070123307,35.3933982822018 "
+"35.3933982822018,\n"
+"32.1418070123307 40.2597485145237,31 46,31 195))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1511
+#, no-c-format
+msgid "15, 'quad_segs=4 join=bevel' shown with original line"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1514
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n"
+"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n"
+" 44 16,24 16,20 16,18 16,17 17,\n"
+" 16 18,16 20,16 40,16 60,16 80,16 100,\n"
+" 16 120,16 140,16 160,16 180,16 195)'), \n"
+" 15, 'quad_segs=4 join=bevel'));\n"
+"-- output --\n"
+"LINESTRING(164 1,18 1,7.39339828220179 5.39339828220179,\n"
+" 5.39339828220179 7.39339828220179,1 18,1 195)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1522
+#, no-c-format
+msgid "15,-15 collected, join=mitre mitre_limit=2.1"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1525
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Collect(\n"
+" ST_OffsetCurve(geom, 15, 'quad_segs=4 join=mitre mitre_limit=2.2'),\n"
+" ST_OffsetCurve(geom, -15, 'quad_segs=4 join=mitre mitre_limit=2.2')\n"
+" ) )\n"
+" FROM ST_GeomFromText(\n"
+"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n"
+" 44 16,24 16,20 16,18 16,17 17,\n"
+" 16 18,16 20,16 40,16 60,16 80,16 100,\n"
+" 16 120,16 140,16 160,16 180,16 195)') As geom;\n"
+"-- output --\n"
+"MULTILINESTRING((164 1,11.7867965644036 1,1 11.7867965644036,1 195),\n"
+" (31 195,31 31,164 31))"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1542
+#, no-c-format
+msgid "ST_RemoveRepeatedPoints"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1543
+#, no-c-format
+msgid "Returns a version of the given geometry with duplicated points removed."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1549
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_RemoveRepeatedPoints</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1558
+#, no-c-format
+msgid ""
+"Returns a version of the given geometry with duplicated points removed. Will "
+"actually do something only with (multi)lines, (multi)polygons and "
+"multipoints but you can safely call it with any kind of geometry. Since "
+"simplification occurs on a object-by-object basis you can also feed a "
+"GeometryCollection to this function."
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1578
+#, no-c-format
+msgid "ST_SharedPaths"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1579
+#, no-c-format
+msgid ""
+"Returns a collection containing paths shared by the two input linestrings/"
+"multilinestrings."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1584
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_SharedPaths</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>lineal1</parameter></paramdef> "
+"<paramdef><type>geometry</type> <parameter>lineal2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1594
+#, no-c-format
+msgid ""
+"Returns a collection containing paths shared by the two input geometries. "
+"Those going in the same direction are in the first element of the "
+"collection, those going in the opposite direction are in the second element. "
+"The paths themselves are given in the direction of the first geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1599
+#, no-c-format
+msgid "Availability: 2.0.0 requires GEOS >= 3.3.0."
+msgstr ""
+
+#. Tag: title
+#: reference_processing.xml:1602
+#, no-c-format
+msgid "Examples: Finding shared paths"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1612
+#, no-c-format
+msgid "A multilinestring and a linestring"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1623
+#, no-c-format
+msgid ""
+"The shared path of multilinestring and linestring overlaid with original "
+"geometries."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1626
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(\n"
+" ST_SharedPaths(\n"
+" ST_GeomFromText('MULTILINESTRING((26 125,26 200,126 200,126 125,26 "
+"125),\n"
+" (51 150,101 150,76 175,51 150))'),\n"
+" ST_GeomFromText('LINESTRING(151 100,126 156.25,126 125,90 161, 76 "
+"175)')\n"
+" )\n"
+" ) As wkt\n"
+"\n"
+" wkt\n"
+"-------------------------------------------------------------\n"
+"GEOMETRYCOLLECTION(MULTILINESTRING((126 156.25,126 125),\n"
+" (101 150,90 161),(90 161,76 175)),MULTILINESTRING EMPTY)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1632
+#, no-c-format
+msgid ""
+"-- same example but linestring orientation flipped\n"
+"SELECT ST_AsText(\n"
+" ST_SharedPaths(\n"
+" ST_GeomFromText('LINESTRING(76 175,90 161,126 125,126 156.25,151 100)'),\n"
+" ST_GeomFromText('MULTILINESTRING((26 125,26 200,126 200,126 125,26 125),\n"
+" (51 150,101 150,76 175,51 150))')\n"
+" )\n"
+" ) As wkt\n"
+"\n"
+" wkt\n"
+"-------------------------------------------------------------\n"
+"GEOMETRYCOLLECTION(MULTILINESTRING EMPTY,\n"
+"MULTILINESTRING((76 175,90 161),(90 161,101 150),(126 125,126 156.25)))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1642
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_GeometryN\"/>, <xref linkend=\"ST_NumGeometries\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1652
+#, no-c-format
+msgid "ST_Shift_Longitude"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1654
+#, no-c-format
+msgid ""
+"<refpurpose>Reads every point/vertex in every component of every feature in "
+"a geometry, and if the longitude coordinate is <0, adds 360 to it. The "
+"result would be a 0-360 version of the data to be plotted in a 180 centric "
+"map</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1662
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Shift_Longitude</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1672
+#, no-c-format
+msgid ""
+"<para>Reads every point/vertex in every component of every feature in a "
+"geometry, and if the longitude coordinate is <0, adds 360 to it. The "
+"result would be a 0-360 version of the data to be plotted in a 180 centric "
+"map</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1676
+#, no-c-format
+msgid "This is only useful for data in long lat e.g. 4326 (WGS 84 long lat)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1678
+#, no-c-format
+msgid ""
+"Pre-1.3.4 bug prevented this from working for MULTIPOINT. 1.3.4+ works with "
+"MULTIPOINT as well."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1683
+#, no-c-format
+msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1692
+#, no-c-format
+msgid ""
+"--3d points\n"
+"SELECT ST_AsEWKT(ST_Shift_Longitude(ST_GeomFromEWKT('SRID=4326;POINT(-118.58 "
+"38.38 10)'))) As geomA,\n"
+" ST_AsEWKT(ST_Shift_Longitude(ST_GeomFromEWKT('SRID=4326;POINT(241.42 "
+"38.38 10)'))) As geomb\n"
+"geomA geomB\n"
+"---------- -----------\n"
+"SRID=4326;POINT(241.42 38.38 10) SRID=4326;POINT(-118.58 38.38 10)\n"
+"\n"
+"--regular line string\n"
+"SELECT ST_AsText(ST_Shift_Longitude(ST_GeomFromText('LINESTRING(-118.58 "
+"38.38, -118.20 38.45)')))\n"
+"\n"
+"st_astext\n"
+"----------\n"
+"LINESTRING(241.42 38.38,241.8 38.45)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1698
+#, no-c-format
+msgid ", <xref linkend=\"ST_GeomFromText\"/>, <xref linkend=\"ST_AsEWKT\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1704
+#, no-c-format
+msgid "ST_Simplify"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1705
+#, no-c-format
+msgid ""
+"Returns a \"simplified\" version of the given geometry using the Douglas-"
+"Peucker algorithm."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1711
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Simplify</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>tolerance</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1721
+#, no-c-format
+msgid ""
+"Returns a \"simplified\" version of the given geometry using the Douglas-"
+"Peucker algorithm. Will actually do something only with (multi)lines and "
+"(multi)polygons but you can safely call it with any kind of geometry. Since "
+"simplification occurs on a object-by-object basis you can also feed a "
+"GeometryCollection to this function."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1728
+#, no-c-format
+msgid ""
+"Note that returned geometry might loose its simplicity (see <xref linkend="
+"\"ST_IsSimple\"/>)"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1730
+#, no-c-format
+msgid ""
+"Note topology may not be preserved and may result in invalid geometries. Use "
+"(see <xref linkend=\"ST_SimplifyPreserveTopology\"/>) to preserve topology."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1733
+#, no-c-format
+msgid "Availability: 1.2.2"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1738
+#, no-c-format
+msgid "A circle simplified too much becomes a triangle, medium an octagon,"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1739
+#, no-c-format
+msgid ""
+"SELECT ST_Npoints(the_geom) As np_before, "
+"ST_NPoints(ST_Simplify(the_geom,0.1)) As np01_notbadcircle, "
+"ST_NPoints(ST_Simplify(the_geom,0.5)) As np05_notquitecircle,\n"
+"ST_NPoints(ST_Simplify(the_geom,1)) As np1_octagon, "
+"ST_NPoints(ST_Simplify(the_geom,10)) As np10_triangle,\n"
+"(ST_Simplify(the_geom,100) is null) As np100_geometrygoesaway\n"
+"FROM (SELECT ST_Buffer('POINT(1 3)', 10,12) As the_geom) As foo;\n"
+"-result\n"
+" np_before | np01_notbadcircle | np05_notquitecircle | np1_octagon | "
+"np10_triangle | np100_geometrygoesaway\n"
+"-----------+-------------------+---------------------+-------------"
+"+---------------+------------------------\n"
+" 49 | 33 | 17 | 9 "
+"| 4 | t"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1743
+#, no-c-format
+msgid ", <xref linkend=\"ST_SimplifyPreserveTopology\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1749
+#, no-c-format
+msgid "ST_SimplifyPreserveTopology"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1750
+#, no-c-format
+msgid ""
+"Returns a \"simplified\" version of the given geometry using the Douglas-"
+"Peucker algorithm. Will avoid creating derived geometries (polygons in "
+"particular) that are invalid."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1757
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_SimplifyPreserveTopology</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>tolerance</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1767
+#, no-c-format
+msgid ""
+"Returns a \"simplified\" version of the given geometry using the Douglas-"
+"Peucker algorithm. Will avoid creating derived geometries (polygons in "
+"particular) that are invalid. Will actually do something only with "
+"(multi)lines and (multi)polygons but you can safely call it with any kind of "
+"geometry. Since simplification occurs on a object-by-object basis you can "
+"also feed a GeometryCollection to this function."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1776
+#, no-c-format
+msgid "Requires GEOS 3.0.0+"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1777
+#, no-c-format
+msgid "Availability: 1.3.3"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1782
+#, no-c-format
+msgid ""
+"Same example as Simplify, but we see Preserve Topology prevents "
+"oversimplification. The circle can at most become a square."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1783
+#, no-c-format
+msgid ""
+"SELECT ST_Npoints(the_geom) As np_before, "
+"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,0.1)) As np01_notbadcircle, "
+"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,0.5)) As "
+"np05_notquitecircle,\n"
+"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,1)) As np1_octagon, "
+"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,10)) As np10_square,\n"
+"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,100)) As np100_stillsquare\n"
+"FROM (SELECT ST_Buffer('POINT(1 3)', 10,12) As the_geom) As foo;\n"
+"\n"
+"--result--\n"
+" np_before | np01_notbadcircle | np05_notquitecircle | np1_octagon | "
+"np10_square | np100_stillsquare\n"
+"-----------+-------------------+---------------------+-------------"
+"+---------------+-------------------\n"
+" 49 | 33 | 17 | 9 "
+"| 5 | 5"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1793
+#, no-c-format
+msgid "ST_Split"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1794
+#, no-c-format
+msgid "Returns a collection of geometries resulting by splitting a geometry."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1799
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Split</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>input</parameter></paramdef> "
+"<paramdef><type>geometry</type> <parameter>blade</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1809
+#, no-c-format
+msgid ""
+"The function supports splitting a line by point, a line by line, a polygon "
+"by line. The returned geometry is always a collection."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1813
+#, no-c-format
+msgid ""
+"Think of this function as the opposite of ST_Union. Theoretically applying "
+"ST_Union to the elements of the returned collection should always yield the "
+"original geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1824
+#, no-c-format
+msgid "Polygon Cut by Line"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1836 reference_processing.xml:1870
+#, no-c-format
+msgid "Before Split"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1848 reference_processing.xml:1882
+#, no-c-format
+msgid "After split"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1857
+#, no-c-format
+msgid ""
+"-- this creates a geometry collection consisting of the 2 halves of the "
+"polygon\n"
+"-- this is similar to the example we demonstrated in ST_BuildArea\n"
+"SELECT ST_Split(circle, line)\n"
+"FROM (SELECT \n"
+" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190)) As line,\n"
+" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;\n"
+" \n"
+"-- result --\n"
+" GEOMETRYCOLLECTION(POLYGON((150 90,149.039264020162 "
+"80.2454838991936,146.193976625564 70.8658283817455,..), POLYGON(..)))\n"
+" \n"
+"-- To convert to individual polygons, you can use ST_Dump or ST_GeometryN\n"
+"SELECT ST_AsText((ST_Dump(ST_Split(circle, line))).geom) As wkt\n"
+"FROM (SELECT \n"
+" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190)) As line,\n"
+" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;\n"
+" \n"
+"-- result --\n"
+"wkt\n"
+"---------------\n"
+"POLYGON((150 90,149.039264020162 80.2454838991936,..))\n"
+"POLYGON((60.1371179574584 60.1371179574584,58.4265193848728 "
+"62.2214883490198,53.8060233744357 ..))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1858
+#, no-c-format
+msgid "Multilinestring Cut by point"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1891
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Split(mline, pt)) As wktcut\n"
+" FROM (SELECT \n"
+" ST_GeomFromText('MULTILINESTRING((10 10, 190 190), (15 15, 30 30, 100 "
+"90))') As mline,\n"
+" ST_Point(30,30) As pt) As foo;\n"
+" \n"
+"wktcut\n"
+"------\n"
+"GEOMETRYCOLLECTION(\n"
+" LINESTRING(10 10,30 30),\n"
+" LINESTRING(30 30,190 190),\n"
+" LINESTRING(15 15,30 30),\n"
+" LINESTRING(30 30,100 90)\n"
+")"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1895
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_BuildArea\"/>, <xref linkend=\"ST_Dump\"/>, <xref "
+"linkend=\"ST_GeometryN\"/>, <xref linkend=\"ST_Union\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1901
+#, no-c-format
+msgid "ST_SymDifference"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1903
+#, no-c-format
+msgid ""
+"Returns a geometry that represents the portions of A and B that do not "
+"intersect. It is called a symmetric difference because ST_SymDifference(A,B) "
+"= ST_SymDifference(B,A)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:1910
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_SymDifference</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geomB</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1921
+#, no-c-format
+msgid ""
+"Returns a geometry that represents the portions of A and B that do not "
+"intersect. It is called a symmetric difference because ST_SymDifference(A,B) "
+"= ST_SymDifference(B,A). One can think of this as ST_Union(geomA,geomB) - "
+"ST_Intersection(A,B)."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1931
+#, no-c-format
+msgid "&sqlmm_compliant; SQL-MM 3: 5.1.21"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1951
+#, no-c-format
+msgid "The original linestrings shown together"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1963
+#, no-c-format
+msgid "The symmetric difference of the two linestrings"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1972
+#, no-c-format
+msgid ""
+"--Safe for 2d - symmetric difference of 2 linestrings\n"
+"SELECT ST_AsText(\n"
+" ST_SymDifference(\n"
+" ST_GeomFromText('LINESTRING(50 100, 50 200)'),\n"
+" ST_GeomFromText('LINESTRING(50 50, 50 150)')\n"
+" )\n"
+");\n"
+"\n"
+"st_astext\n"
+"---------\n"
+"MULTILINESTRING((50 150,50 200),(50 50,50 100))"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:1974
+#, no-c-format
+msgid ""
+"--When used in 3d doesn't quite do the right thing\n"
+"SELECT ST_AsEWKT(ST_SymDifference(ST_GeomFromEWKT('LINESTRING(1 2 1, 1 4 "
+"2)'),\n"
+" ST_GeomFromEWKT('LINESTRING(1 1 3, 1 3 4)')))\n"
+"\n"
+"st_astext\n"
+"------------\n"
+"MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:1981
+#, no-c-format
+msgid ", <xref linkend=\"ST_Intersection\"/>, <xref linkend=\"ST_Union\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:1988
+#, no-c-format
+msgid "ST_Union"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:1989
+#, no-c-format
+msgid ""
+"Returns a geometry that represents the point set union of the Geometries."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_processing.xml:1994
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>geometry <function>ST_Union</function></funcdef> "
+"<paramdef><type>geometry set</type> <parameter>g1field</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>geometry "
+"<function>ST_Union</function></funcdef> <paramdef><type>geometry</type> "
+"<parameter>g1</parameter></paramdef> <paramdef><type>geometry</type> "
+"<parameter>g2</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>geometry <function>ST_Union</function></funcdef> "
+"<paramdef><type>geometry[]</type> <parameter>g1_array</parameter></paramdef> "
+"</funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2013
+#, no-c-format
+msgid ""
+"Output type can be a MULTI*, single geometry, or Geometry Collection. Comes "
+"in 2 variants. Variant 1 unions 2 geometries resulting in a new geometry "
+"with no intersecting regions. Variant 2 is an aggregate function that takes "
+"a set of geometries and unions them into a single ST_Geometry resulting in "
+"no intersecting regions."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2017
+#, no-c-format
+msgid ""
+"Aggregate version: This function returns a MULTI geometry or NON-MULTI "
+"geometry from a set of geometries. The ST_Union() function is an \"aggregate"
+"\" function in the terminology of PostgreSQL. That means that it operates on "
+"rows of data, in the same way the SUM() and AVG() functions do."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2023
+#, no-c-format
+msgid ""
+"Non-Aggregate version: This function returns a geometry being a union of two "
+"input geometries. Output type can be a MULTI*, NON-MULTI or "
+"GEOMETRYCOLLECTION."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2027
+#, no-c-format
+msgid ""
+"ST_Collect and ST_Union are often interchangeable. ST_Union is in general "
+"orders of magnitude slower than ST_Collect because it tries to dissolve "
+"boundaries and reorder geometries to ensure that a constructed Multi* "
+"doesn't have intersecting regions."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2033
+#, no-c-format
+msgid ""
+"NOTE: this function was formerly called GeomUnion(), which was renamed from "
+"\"Union\" because UNION is an SQL reserved word."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2036
+#, no-c-format
+msgid ""
+"Availability: 1.4.0 - ST_Union was enhanced. ST_Union(geomarray) was "
+"introduced and also faster aggregate collection in PostgreSQL. If you are "
+"using GEOS 3.1.0+ ST_Union will use the faster Cascaded Union algorithm "
+"described in <ulink url=\"http://blog.cleverelephant.ca/2009/01/must-faster-"
+"unions-in-postgis-14.html\">http://blog.cleverelephant.ca/2009/01/must-"
+"faster-unions-in-postgis-14.html</ulink>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2042
+#, no-c-format
+msgid "Aggregate version is not explicitly defined in OGC SPEC."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2043
+#, no-c-format
+msgid ""
+"&sqlmm_compliant; SQL-MM 3: 5.1.19 the z-index (elevation) when polygons are "
+"involved."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2049
+#, no-c-format
+msgid "Aggregate example"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:2050
+#, no-c-format
+msgid ""
+"SELECT stusps,\n"
+" ST_Multi(ST_Union(f.the_geom)) as singlegeom\n"
+" FROM sometable As f\n"
+"GROUP BY stusps"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_processing.xml:2052
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_Union(ST_GeomFromText('POINT(1 2)'),\n"
+" ST_GeomFromText('POINT(-2 3)') ) )\n"
+"\n"
+"st_astext\n"
+"----------\n"
+"MULTIPOINT(-2 3,1 2)\n"
+"\n"
+"\n"
+"SELECT ST_AsText(ST_Union(ST_GeomFromText('POINT(1 2)'),\n"
+" ST_GeomFromText('POINT(1 2)') ) );\n"
+"st_astext\n"
+"----------\n"
+"POINT(1 2)\n"
+"\n"
+"--3d example - sort of supports 3d (and with mixed dimensions!)\n"
+"SELECT ST_AsEWKT(st_union(the_geom))\n"
+"FROM\n"
+"(SELECT ST_GeomFromEWKT('POLYGON((-7 4.2,-7.1 4.2,-7.1 4.3,\n"
+"-7 4.2))') as the_geom\n"
+"UNION ALL\n"
+"SELECT ST_GeomFromEWKT('POINT(5 5 5)') as the_geom\n"
+"UNION ALL\n"
+" SELECT ST_GeomFromEWKT('POINT(-2 3 1)') as the_geom\n"
+"UNION ALL\n"
+"SELECT ST_GeomFromEWKT('LINESTRING(5 5 5, 10 10 10)') as the_geom ) as foo;\n"
+"\n"
+"st_asewkt\n"
+"---------\n"
+"GEOMETRYCOLLECTION(POINT(-2 3 1),LINESTRING(5 5 5,10 10 10),POLYGON((-7 4.2 "
+"5,-7.1 4.2 5,-7.1 4.3 5,-7 4.2 5)));\n"
+"\n"
+"--3d example not mixing dimensions\n"
+"SELECT ST_AsEWKT(st_union(the_geom))\n"
+"FROM\n"
+"(SELECT ST_GeomFromEWKT('POLYGON((-7 4.2 2,-7.1 4.2 3,-7.1 4.3 2,\n"
+"-7 4.2 2))') as the_geom\n"
+"UNION ALL\n"
+"SELECT ST_GeomFromEWKT('POINT(5 5 5)') as the_geom\n"
+"UNION ALL\n"
+" SELECT ST_GeomFromEWKT('POINT(-2 3 1)') as the_geom\n"
+"UNION ALL\n"
+"SELECT ST_GeomFromEWKT('LINESTRING(5 5 5, 10 10 10)') as the_geom ) as foo;\n"
+"\n"
+"st_asewkt\n"
+"---------\n"
+"GEOMETRYCOLLECTION(POINT(-2 3 1),LINESTRING(5 5 5,10 10 10),POLYGON((-7 4.2 "
+"2,-7.1 4.2 3,-7.1 4.3 2,-7 4.2 2)))\n"
+"\n"
+"--Examples using new Array construct\n"
+"SELECT ST_Union(ARRAY(SELECT the_geom FROM sometable));\n"
+"\n"
+"SELECT ST_AsText(ST_Union(ARRAY[ST_GeomFromText('LINESTRING(1 2, 3 4)'),\n"
+" ST_GeomFromText('LINESTRING(3 4, 4 5)')])) As "
+"wktunion;\n"
+"\n"
+"--wktunion---\n"
+"MULTILINESTRING((3 4,4 5),(1 2,3 4))"
+msgstr ""
+
+#. Tag: refname
+#: reference_processing.xml:2065
+#, no-c-format
+msgid "ST_UnaryUnion"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_processing.xml:2067
+#, no-c-format
+msgid "Like ST_Union, but working at the geometry component level."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_processing.xml:2072
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_UnaryUnion</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2083
+#, no-c-format
+msgid ""
+"Unlike ST_Union, ST_UnaryUnion does dissolve boundaries between components "
+"of a multipolygon (invalid) and does perform union between the components of "
+"a geometrycollection. Each components of the input geometry is assumed to be "
+"valid, so you won't get a valid multipolygon out of a bow-tie polygon "
+"(invalid)."
+msgstr ""
+
+#. Tag: para
+#: reference_processing.xml:2093
+#, no-c-format
+msgid ""
+"You may use this function to node a set of linestrings. You may mix "
+"ST_UnaryUnion with ST_Collect to fine-tune how many geometries at once you "
+"want to dissolve to be nice on both memory size and CPU time, finding the "
+"balance between ST_Union and ST_MemUnion."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-10-11 21:39+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_raster.xml:3
+#, no-c-format
+msgid "Raster Reference"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5
+#, no-c-format
+msgid ""
+"The functions given below are the ones which a user of PostGIS Raster is "
+"likely to need and which are currently available in PostGIS Raster. There "
+"are other functions which are required support functions to the raster "
+"objects which are not of use to a general user."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:9
+#, no-c-format
+msgid ""
+"<varname>raster</varname> is a new PostGIS type for storing and analyzing "
+"raster data."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:10
+#, no-c-format
+msgid ""
+"For loading rasters from raster files please refer to <xref linkend="
+"\"RT_Loading_Rasters\"/>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:12
+#, no-c-format
+msgid ""
+"For the examples in this reference we will be using a raster table of dummy "
+"rasters - Formed with the following code"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:13
+#, no-c-format
+msgid ""
+"CREATE TABLE dummy_rast(rid integer, rast raster);\n"
+"INSERT INTO dummy_rast(rid, rast)\n"
+"VALUES (1,\n"
+"('01' -- little endian (uint8 ndr)\n"
+"|| \n"
+"'0000' -- version (uint16 0)\n"
+"||\n"
+"'0000' -- nBands (uint16 0)\n"
+"||\n"
+"'0000000000000040' -- scaleX (float64 2)\n"
+"||\n"
+"'0000000000000840' -- scaleY (float64 3)\n"
+"||\n"
+"'000000000000E03F' -- ipX (float64 0.5)\n"
+"||\n"
+"'000000000000E03F' -- ipY (float64 0.5)\n"
+"||\n"
+"'0000000000000000' -- skewX (float64 0)\n"
+"||\n"
+"'0000000000000000' -- skewY (float64 0)\n"
+"||\n"
+"'00000000' -- SRID (int32 0)\n"
+"||\n"
+"'0A00' -- width (uint16 10)\n"
+"||\n"
+"'1400' -- height (uint16 20)\n"
+")::raster\n"
+"),\n"
+"-- Raster: 5 x 5 pixels, 3 bands, PT_8BUI pixel type, NODATA = 0\n"
+"(2, ('01000003009A9999999999A93F9A9999999999A9BF000000E02B274A' ||\n"
+"'41000000007719564100000000000000000000000000000000FFFFFFFF050005000400FDFEFDFEFEFDFEFEFDF9FAFEF' "
+"||\n"
+"'EFCF9FBFDFEFEFDFCFAFEFEFE04004E627AADD16076B4F9FE6370A9F5FE59637AB0E54F58617087040046566487A1506CA2E3FA5A6CAFFBFE4D566DA4CB3E454C5665')::"
+"raster);"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:17
+#, no-c-format
+msgid ""
+"This section lists the PostgreSQL data types specifically created to support "
+"raster functionality."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:20
+#, no-c-format
+msgid "Raster Support Data types"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:24
+#, no-c-format
+msgid "geomval"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:25
+#, no-c-format
+msgid ""
+"A spatial datatype with two fields - geom (holding a geometry object) and "
+"val (holding a double precision pixel value from a raster band)."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:30 reference_raster.xml:49 reference_raster.xml:121
+#: reference_raster.xml:171 reference_raster.xml:211 reference_raster.xml:257
+#: reference_raster.xml:439 reference_raster.xml:613 reference_raster.xml:652
+#: reference_raster.xml:689 reference_raster.xml:730 reference_raster.xml:820
+#: reference_raster.xml:1022 reference_raster.xml:1109
+#: reference_raster.xml:1203 reference_raster.xml:1248
+#: reference_raster.xml:1287 reference_raster.xml:1321
+#: reference_raster.xml:1356 reference_raster.xml:1390
+#: reference_raster.xml:1435 reference_raster.xml:1489
+#: reference_raster.xml:1526 reference_raster.xml:1566
+#: reference_raster.xml:1621 reference_raster.xml:1673
+#: reference_raster.xml:1717 reference_raster.xml:1752
+#: reference_raster.xml:1788 reference_raster.xml:1824
+#: reference_raster.xml:1859 reference_raster.xml:1893
+#: reference_raster.xml:1927 reference_raster.xml:1971
+#: reference_raster.xml:2033 reference_raster.xml:2087
+#: reference_raster.xml:2122 reference_raster.xml:2162
+#: reference_raster.xml:2209 reference_raster.xml:2251
+#: reference_raster.xml:2305 reference_raster.xml:2340
+#: reference_raster.xml:2415 reference_raster.xml:2458
+#: reference_raster.xml:2504 reference_raster.xml:2556
+#: reference_raster.xml:2599 reference_raster.xml:2644
+#: reference_raster.xml:2687 reference_raster.xml:2753
+#: reference_raster.xml:2829 reference_raster.xml:2916
+#: reference_raster.xml:3004 reference_raster.xml:3081
+#: reference_raster.xml:3215 reference_raster.xml:3254
+#: reference_raster.xml:3293 reference_raster.xml:3336
+#: reference_raster.xml:3383 reference_raster.xml:3427
+#: reference_raster.xml:3465 reference_raster.xml:3540
+#: reference_raster.xml:3595 reference_raster.xml:3657
+#: reference_raster.xml:3735 reference_raster.xml:3800
+#: reference_raster.xml:3887 reference_raster.xml:3926
+#: reference_raster.xml:3996 reference_raster.xml:4102
+#: reference_raster.xml:4222 reference_raster.xml:4283
+#: reference_raster.xml:4438 reference_raster.xml:4480
+#: reference_raster.xml:4517 reference_raster.xml:4602
+#: reference_raster.xml:4693 reference_raster.xml:4781
+#: reference_raster.xml:4842 reference_raster.xml:4900
+#: reference_raster.xml:5031 reference_raster.xml:5093
+#: reference_raster.xml:5138 reference_raster.xml:5183
+#: reference_raster.xml:5222 reference_raster.xml:5287
+#: reference_raster.xml:5401 reference_raster.xml:5513
+#: reference_raster.xml:5651 reference_raster.xml:5747
+#: reference_raster.xml:5984 reference_raster.xml:6080
+#: reference_raster.xml:6172 reference_raster.xml:6284
+#: reference_raster.xml:6334 reference_raster.xml:6419
+#: reference_raster.xml:6480 reference_raster.xml:6530
+#: reference_raster.xml:6580 reference_raster.xml:6630
+#: reference_raster.xml:6679 reference_raster.xml:6729
+#: reference_raster.xml:6779 reference_raster.xml:6829
+#: reference_raster.xml:6893 reference_raster.xml:6956
+#: reference_raster.xml:7000 reference_raster.xml:7045
+#: reference_raster.xml:7112 reference_raster.xml:7201
+#: reference_raster.xml:7286 reference_raster.xml:7367
+#: reference_raster.xml:7448 reference_raster.xml:7577
+#: reference_raster.xml:7661 reference_raster.xml:7741
+#: reference_raster.xml:7860 reference_raster.xml:7932
+#: reference_raster.xml:8029 reference_raster.xml:8122
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:31
+#, no-c-format
+msgid ""
+"geomval is a compound data type consisting of a geometry object referenced "
+"by the .geom field and val, a double precision value that represents the "
+"pixel value at a particular geometric location in a raster band. It is used "
+"by the ST_DumpAsPolygon and Raster intersection family of functions as an "
+"output type to explode a raster band into geometry polygons."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:37 reference_raster.xml:107 reference_raster.xml:157
+#: reference_raster.xml:200 reference_raster.xml:245 reference_raster.xml:292
+#: reference_raster.xml:487 reference_raster.xml:628 reference_raster.xml:664
+#: reference_raster.xml:702 reference_raster.xml:750 reference_raster.xml:857
+#: reference_raster.xml:1074 reference_raster.xml:1163
+#: reference_raster.xml:1223 reference_raster.xml:1266
+#: reference_raster.xml:1300 reference_raster.xml:1335
+#: reference_raster.xml:1369 reference_raster.xml:1413
+#: reference_raster.xml:1468 reference_raster.xml:1505
+#: reference_raster.xml:1543 reference_raster.xml:1588
+#: reference_raster.xml:1644 reference_raster.xml:1696
+#: reference_raster.xml:1731 reference_raster.xml:1767
+#: reference_raster.xml:1803 reference_raster.xml:1838
+#: reference_raster.xml:1872 reference_raster.xml:1906
+#: reference_raster.xml:1941 reference_raster.xml:1991
+#: reference_raster.xml:2047 reference_raster.xml:2101
+#: reference_raster.xml:2137 reference_raster.xml:2187
+#: reference_raster.xml:2222 reference_raster.xml:2280
+#: reference_raster.xml:2318 reference_raster.xml:2393
+#: reference_raster.xml:2430 reference_raster.xml:2472
+#: reference_raster.xml:2524 reference_raster.xml:2567
+#: reference_raster.xml:2612 reference_raster.xml:2655
+#: reference_raster.xml:2700 reference_raster.xml:2775
+#: reference_raster.xml:2854 reference_raster.xml:2948
+#: reference_raster.xml:3019 reference_raster.xml:3138
+#: reference_raster.xml:3271 reference_raster.xml:3306
+#: reference_raster.xml:3355 reference_raster.xml:3400
+#: reference_raster.xml:3440 reference_raster.xml:3478
+#: reference_raster.xml:3560 reference_raster.xml:3622
+#: reference_raster.xml:3685 reference_raster.xml:3764
+#: reference_raster.xml:3852 reference_raster.xml:3900
+#: reference_raster.xml:3949 reference_raster.xml:4010
+#: reference_raster.xml:4137 reference_raster.xml:4237
+#: reference_raster.xml:4311 reference_raster.xml:4456
+#: reference_raster.xml:4556 reference_raster.xml:4647
+#: reference_raster.xml:4738 reference_raster.xml:4818
+#: reference_raster.xml:4860 reference_raster.xml:5008
+#: reference_raster.xml:5070 reference_raster.xml:5117
+#: reference_raster.xml:5157 reference_raster.xml:5198
+#: reference_raster.xml:5263 reference_raster.xml:5328
+#: reference_raster.xml:5440 reference_raster.xml:5612
+#: reference_raster.xml:5705 reference_raster.xml:5910
+#: reference_raster.xml:6042 reference_raster.xml:6142
+#: reference_raster.xml:6260 reference_raster.xml:6295
+#: reference_raster.xml:6369 reference_raster.xml:6449
+#: reference_raster.xml:6499 reference_raster.xml:6549
+#: reference_raster.xml:6599 reference_raster.xml:6649
+#: reference_raster.xml:6698 reference_raster.xml:6748
+#: reference_raster.xml:6798 reference_raster.xml:6867
+#: reference_raster.xml:6916 reference_raster.xml:7147
+#: reference_raster.xml:7232 reference_raster.xml:7313
+#: reference_raster.xml:7394 reference_raster.xml:7478
+#: reference_raster.xml:7607 reference_raster.xml:7688
+#: reference_raster.xml:7768 reference_raster.xml:7881
+#: reference_raster.xml:7965 reference_raster.xml:8060
+#: reference_raster.xml:8153
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:44
+#, no-c-format
+msgid "addbandarg"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:45
+#, no-c-format
+msgid ""
+"<refpurpose>A composite type used as input into the ST_AddBand function "
+"defining the attributes and initial value of the new band.</refpurpose>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:50
+#, no-c-format
+msgid ""
+"<para>A composite type used as input into the ST_AddBand function defining "
+"the attributes and initial value of the new band.</para>"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:55
+#, no-c-format
+msgid "<parameter>index </parameter> <type>integer</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:60
+#, no-c-format
+msgid ""
+"1-based value indicating the position where the new band will be added "
+"amongst the raster's bands. If NULL, the new band will be added at the end "
+"of the raster's bands."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:67
+#, no-c-format
+msgid "<parameter>pixeltype </parameter> <type>text</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:72
+#, no-c-format
+msgid ""
+"Pixel type of the new band. One of defined pixel types as described in <xref "
+"linkend=\"RT_ST_BandPixelType\"/>."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:79
+#, no-c-format
+msgid "<parameter>initialvalue </parameter> <type>double precision</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:84
+#, no-c-format
+msgid "Initial value that all pixels of new band will be set to."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:91
+#, no-c-format
+msgid "<parameter>nodataval </parameter> <type>double precision</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:96
+#, no-c-format
+msgid ""
+"NODATA value of the new band. If NULL, the new band will not have a NODATA "
+"value assigned."
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:116
+#, no-c-format
+msgid "rastbandarg"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:117
+#, no-c-format
+msgid ""
+"<refpurpose>A composite type for use when needing to express a raster and a "
+"band index of that raster.</refpurpose>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:122
+#, no-c-format
+msgid ""
+"<para>A composite type for use when needing to express a raster and a band "
+"index of that raster.</para>"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:128
+#, no-c-format
+msgid "<parameter>rast </parameter> <type>raster</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:133
+#, no-c-format
+msgid "The raster in question/"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:140 reference_raster.xml:263
+#, no-c-format
+msgid "<parameter>nband </parameter> <type>integer</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:145
+#, no-c-format
+msgid "1-based value indicating the band of raster"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:166
+#, no-c-format
+msgid "raster"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:167
+#, no-c-format
+msgid "raster spatial data type."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:172
+#, no-c-format
+msgid ""
+"raster is a spatial data type used to represent raster data such as those "
+"imported from jpegs, tiffs, pngs, digital elevation models. Each raster has "
+"1 or more bands each having a set of pixel values. Rasters can be "
+"georeferenced."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:175
+#, no-c-format
+msgid ""
+"Requires PostGIS be compiled with GDAL support. Currently rasters can be "
+"implicitly converted to geometry type, but the conversion returns the <xref "
+"linkend=\"RT_ST_ConvexHull\"/> of the raster. This auto casting may be "
+"removed in the near future so don't rely on it."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:181
+#, no-c-format
+msgid "Casting Behavior"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:182
+#, no-c-format
+msgid ""
+"This section lists the automatic as well as explicit casts allowed for this "
+"data type"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:187
+#, no-c-format
+msgid "Cast To"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:188
+#, no-c-format
+msgid "Behavior"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:191
+#, no-c-format
+msgid "geometry"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:192
+#, no-c-format
+msgid "automatic"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:207
+#, no-c-format
+msgid "reclassarg"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:208
+#, no-c-format
+msgid ""
+"<refpurpose>A composite type used as input into the ST_Reclass function "
+"defining the behavior of reclassification.</refpurpose>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:212
+#, no-c-format
+msgid ""
+"<para>A composite type used as input into the ST_Reclass function defining "
+"the behavior of reclassification.</para>"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:215
+#, no-c-format
+msgid "<parameter>nband </parameter><type>integer</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:216
+#, no-c-format
+msgid "The band number of band to reclassify."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:219
+#, no-c-format
+msgid "<parameter>reclassexpr </parameter><type>text</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:220
+#, no-c-format
+msgid ""
+"range expression consisting of comma delimited range:map_range mappings. : "
+"to define mapping that defines how to map old band values to new band "
+"values. ( means >, ) means less than, ] < or equal, [ means > or "
+"equal"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:221
+#, no-c-format
+msgid ""
+"1. [a-b] = a <= x <= b\n"
+"\n"
+"2. (a-b] = a < x <= b\n"
+"\n"
+"3. [a-b) = a <= x < b\n"
+"\n"
+"4. (a-b) = a < x < b"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:222
+#, no-c-format
+msgid "( notation is optional so a-b means the same as (a-b)"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:227
+#, no-c-format
+msgid "<parameter>pixeltype </parameter><type>text</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:228
+#, no-c-format
+msgid ""
+"One of defined pixel types as described in <xref linkend="
+"\"RT_ST_BandPixelType\"/>"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:231
+#, no-c-format
+msgid "<parameter>nodataval </parameter><type>double precision</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:232
+#, no-c-format
+msgid ""
+"Value to treat as no data. For image outputs that support transparency, "
+"these will be blank."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:237
+#, no-c-format
+msgid "Example: Reclassify band 2 as an 8BUI where 255 is nodata value"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:238
+#, no-c-format
+msgid ""
+"SELECT ROW(2, '0-100:1-10, 101-500:11-150,501 - 10000: 151-254', '8BUI', "
+"255)::reclassarg;"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:241
+#, no-c-format
+msgid "Example: Reclassify band 1 as an 1BB and no nodata value defined"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:242
+#, no-c-format
+msgid "SELECT ROW(1, '0-100]:0, (100-255:1', '1BB', NULL)::reclassarg;"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:252
+#, no-c-format
+msgid "unionarg"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:253
+#, no-c-format
+msgid ""
+"<refpurpose>A composite type used as input into the ST_Union function "
+"defining the bands to be processed and behavior of the UNION operation.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:258
+#, no-c-format
+msgid ""
+"<para>A composite type used as input into the ST_Union function defining the "
+"bands to be processed and behavior of the UNION operation.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:268
+#, no-c-format
+msgid "1-based value indicating the band of each input raster to be processed."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:275
+#, no-c-format
+msgid "<parameter>uniontype </parameter> <type>text</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:280
+#, no-c-format
+msgid ""
+"Type of UNION operation. One of defined types as described in <xref linkend="
+"\"RT_ST_Union\"/>."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:302
+#, no-c-format
+msgid "Raster Management"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:305
+#, no-c-format
+msgid "AddRasterConstraints"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:307
+#, no-c-format
+msgid ""
+"Adds raster constraints to a loaded raster table for a specific column that "
+"constrains spatial ref, scaling, blocksize, alignment, bands, band type and "
+"a flag to denote if raster column is regularly blocked. The table must be "
+"loaded with data for the constraints to be inferred. Returns true of the "
+"constraint setting was accomplished and if issues a notice."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:311
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>AddRasterConstraints</function></"
+"funcdef> <paramdef><type>name </type> <parameter>rasttable</parameter></"
+"paramdef> <paramdef><type>name </type> <parameter>rastcolumn</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>srid</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>scale_x</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>scale_y</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>blocksize_x</"
+"parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>blocksize_y</parameter></paramdef> <paramdef><type>boolean </"
+"type> <parameter>same_alignment</parameter></paramdef> "
+"<paramdef><type>boolean </type> <parameter>regular_blocking</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>num_bands=true</parameter> </paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>pixel_types=true</parameter> </paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>nodata_values=true</parameter> </paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>out_db=true</parameter> </paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>extent=true</"
+"parameter> </paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>AddRasterConstraints</function></funcdef> <paramdef><type>name </"
+"type> <parameter>rasttable</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rastcolumn</parameter></paramdef> <paramdef><type>text[] </"
+"type> <parameter>VARIADIC constraints</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean "
+"<function>AddRasterConstraints</function></funcdef> <paramdef><type>name </"
+"type> <parameter>rastschema</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rasttable</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rastcolumn</parameter></paramdef> <paramdef><type>text[] </"
+"type> <parameter>VARIADIC constraints</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean "
+"<function>AddRasterConstraints</function></funcdef> <paramdef><type>name </"
+"type> <parameter>rastschema</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rasttable</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rastcolumn</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>srid=true</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>scale_x=true</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>scale_y=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>blocksize_x=true</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>blocksize_y=true</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>same_alignment=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>regular_blocking=true</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>num_bands=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>pixel_types=true</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>nodata_values=true</parameter> </paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>out_db=true</parameter> </paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>extent=true</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:441
+#, no-c-format
+msgid ""
+"Generates constraints on a raster column that are used to display "
+"information in the <varname>raster_columns</varname> raster catalog. The "
+"<varname>rastschema</varname> is the name of the table schema the table "
+"resides in. The <varname>srid</varname> must be an integer value reference "
+"to an entry in the SPATIAL_REF_SYS table."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:446
+#, no-c-format
+msgid ""
+"<varname>raster2pgsql</varname> loader uses this function to register raster "
+"tables"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:447
+#, no-c-format
+msgid ""
+"Valid constraint names to pass in: refer to <xref linkend=\"RT_Raster_Columns"
+"\"/> for more details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:449
+#, no-c-format
+msgid "<varname>blocksize</varname> sets both X and Y blocksize"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:450
+#, no-c-format
+msgid ""
+"<varname>blocksize_x</varname> sets X tile (width in pixels of each tile)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:451
+#, no-c-format
+msgid ""
+"<varname>blocksize_y</varname> sets Y tile (height in pixels of each tile)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:452
+#, no-c-format
+msgid ""
+"<varname>extent</varname> computes extent of whole table and applys "
+"constraint all rasters must be within that extent"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:454
+#, no-c-format
+msgid "<varname>num_bands</varname> number of bands"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:455
+#, no-c-format
+msgid ""
+"<varname>pixel_types</varname> reads array of pixel types for each band "
+"ensure all band n have same pixel type"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:456
+#, no-c-format
+msgid ""
+"<varname>regular_blocking</varname> apply informational flag to denote all "
+"tiles are regularly blocked"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:457
+#, no-c-format
+msgid ""
+"<varname>same_alignment</varname> ensures they all have same alignment "
+"meaning any two tiles you compare will return true for. Refer to"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:458
+#, no-c-format
+msgid "<varname>srid</varname> ensures all have same srid"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:459
+#, no-c-format
+msgid "More -- any listed as inputs into the above functions"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:462
+#, no-c-format
+msgid ""
+"This function infers the constraints from the data already present in the "
+"table. As such for it to work, you must create the raster column first and "
+"then load it with data."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:467
+#, no-c-format
+msgid ""
+"If you need to load more data in your tables after you have already applied "
+"constraints, you may want to run the DropRasterConstraints if the extent of "
+"your data has changed."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:471 reference_raster.xml:620 reference_raster.xml:1114
+#: reference_raster.xml:2126 reference_raster.xml:2259
+#: reference_raster.xml:2419 reference_raster.xml:2462
+#: reference_raster.xml:2514 reference_raster.xml:3934
+#: reference_raster.xml:4000 reference_raster.xml:4123
+#: reference_raster.xml:4226 reference_raster.xml:4290
+#: reference_raster.xml:4443 reference_raster.xml:4908
+#: reference_raster.xml:5187 reference_raster.xml:5252
+#: reference_raster.xml:5317 reference_raster.xml:5663
+#: reference_raster.xml:5800 reference_raster.xml:6002
+#: reference_raster.xml:6099 reference_raster.xml:6219
+#: reference_raster.xml:6343 reference_raster.xml:6423
+#: reference_raster.xml:6488 reference_raster.xml:6538
+#: reference_raster.xml:6588 reference_raster.xml:6638
+#: reference_raster.xml:6687 reference_raster.xml:6737
+#: reference_raster.xml:6787 reference_raster.xml:7870
+#, no-c-format
+msgid "Availability: 2.0.0"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:475
+#, no-c-format
+msgid "Examples: Apply all possible constraints on column based on data"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:477
+#, no-c-format
+msgid ""
+"CREATE TABLE myrasters(rid SERIAL primary key, rast raster);\n"
+"INSERT INTO myrasters(rast)\n"
+"SELECT ST_AddBand(ST_MakeEmptyRaster(1000, 1000, 0.3, -0.3, 2, 2, 0, "
+"0,4326), 1, '8BSI'::text, -129, NULL);\n"
+"\n"
+"SELECT AddRasterConstraints('myrasters'::name, 'rast'::name);\n"
+"\n"
+"\n"
+"-- verify if registered correctly in the raster_columns view --\n"
+"SELECT srid, scale_x, scale_y, blocksize_x, blocksize_y, num_bands, "
+"pixel_types, nodata_values\n"
+" FROM raster_columns\n"
+" WHERE r_table_name = 'myrasters';\n"
+" \n"
+" srid | scale_x | scale_y | blocksize_x | blocksize_y | num_bands | "
+"pixel_types| nodata_values\n"
+"------+---------+---------+-------------+-------------+-----------"
+"+-------------+---------------\n"
+" 4326 | 2 | 2 | 1000 | 1000 | 1 | "
+"{8BSI} | {0}"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:481
+#, no-c-format
+msgid "Examples: Apply single constraint"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:483
+#, no-c-format
+msgid ""
+"CREATE TABLE public.myrasters2(rid SERIAL primary key, rast raster);\n"
+"INSERT INTO myrasters2(rast)\n"
+"SELECT ST_AddBand(ST_MakeEmptyRaster(1000, 1000, 0.3, -0.3, 2, 2, 0, "
+"0,4326), 1, '8BSI'::text, -129, NULL);\n"
+"\n"
+"SELECT AddRasterConstraints('public'::name, 'myrasters2'::name, 'rast'::"
+"name,'regular_blocking', 'blocksize');\n"
+"-- get notice--\n"
+"NOTICE: Adding regular blocking constraint\n"
+"INFO: The regular_blocking constraint is just a flag indicating that the "
+"column \"rast\" is regularly blocked. As no function exist yet to assert "
+"that a raster column is regularly blocked, it is up to the end-user to "
+"ensure that the column is truly regularly blocked.\n"
+"CONTEXT: PL/pgSQL function \"addrasterconstraints\" line 85 at assignment\n"
+"NOTICE: Adding blocksize-X constraint\n"
+"NOTICE: Adding blocksize-Y constraint"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:489
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_AddBand\"/>, <xref linkend=\"RT_ST_MakeEmptyRaster\"/"
+">, <xref linkend=\"RT_DropRasterConstraints\"/>, <xref linkend="
+"\"RT_ST_BandPixelType\"/>, <xref linkend=\"RT_ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:495
+#, no-c-format
+msgid "DropRasterConstraints"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:497
+#, no-c-format
+msgid ""
+"Drops PostGIS raster constraints that refer to a raster table column. Useful "
+"if you need to reload data or update your raster column data."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:501
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>DropRasterConstraints</function></"
+"funcdef> <paramdef><type>name </type> <parameter>rasttable</parameter></"
+"paramdef> <paramdef><type>name </type> <parameter>rastcolumn</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>srid</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>scale_x</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>scale_y</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>blocksize_x</"
+"parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>blocksize_y</parameter></paramdef> <paramdef><type>boolean </"
+"type> <parameter>same_alignment</parameter></paramdef> "
+"<paramdef><type>boolean </type> <parameter>regular_blocking</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>num_bands=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>pixel_types=true</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>nodata_values=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>out_db=true</parameter> </paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>extent=true</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>DropRasterConstraints</function></funcdef> <paramdef><type>name </"
+"type> <parameter>rastschema</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rasttable</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rastcolumn</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>srid=true</parameter></paramdef> "
+"<paramdef><type>boolean </type> <parameter>scale_x=true</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>scale_y=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>blocksize_x=true</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>blocksize_y=true</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>same_alignment=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>regular_blocking=true</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>num_bands=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>pixel_types=true</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>nodata_values=true</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>out_db=true</parameter> </paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>extent=true</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>DropRasterConstraints</function></funcdef> <paramdef><type>name </"
+"type> <parameter>rastschema</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rasttable</parameter></paramdef> <paramdef><type>name </"
+"type> <parameter>rastcolumn</parameter></paramdef> <paramdef><type>text[] </"
+"type> <parameter>constraints</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:614
+#, no-c-format
+msgid ""
+"Drops PostGIS raster constraints that refer to a raster table column that "
+"were added by <xref linkend=\"RT_AddRasterConstraints\"/>. Useful if you "
+"need to load more data or update your raster column data. You do not need to "
+"do this if you want to get rid of a raster table or a raster column."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:616
+#, no-c-format
+msgid "To drop a raster table use the standard"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:616
+#, no-c-format
+msgid "DROP TABLE mytable"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:617
+#, no-c-format
+msgid ""
+"To drop just a raster column and leave the rest of the table, use standard "
+"SQL"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:617
+#, no-c-format
+msgid "ALTER TABLE mytable DROP COLUMN rast"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:618
+#, no-c-format
+msgid ""
+"the table will disappear from the <varname>raster_columns</varname> catalog "
+"if the column or table is dropped. However if only the constraints are "
+"dropped, the raster column will still be listed in the "
+"<varname>raster_columns</varname> catalog, but there will be no other "
+"information about it aside from the column name and table."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:623 reference_raster.xml:658 reference_raster.xml:696
+#: reference_raster.xml:1118 reference_raster.xml:1216
+#: reference_raster.xml:1260 reference_raster.xml:1293
+#: reference_raster.xml:1328 reference_raster.xml:1362
+#: reference_raster.xml:1497 reference_raster.xml:1535
+#: reference_raster.xml:1578 reference_raster.xml:1634
+#: reference_raster.xml:1686 reference_raster.xml:1724
+#: reference_raster.xml:1759 reference_raster.xml:1795
+#: reference_raster.xml:1831 reference_raster.xml:1865
+#: reference_raster.xml:1899 reference_raster.xml:1933
+#: reference_raster.xml:1984 reference_raster.xml:2040
+#: reference_raster.xml:2094 reference_raster.xml:2130
+#: reference_raster.xml:2180 reference_raster.xml:2215
+#: reference_raster.xml:2273 reference_raster.xml:2311
+#: reference_raster.xml:2386 reference_raster.xml:2423
+#: reference_raster.xml:2467 reference_raster.xml:2519
+#: reference_raster.xml:2562 reference_raster.xml:2607
+#: reference_raster.xml:2650 reference_raster.xml:2695
+#: reference_raster.xml:2762 reference_raster.xml:2845
+#: reference_raster.xml:2937 reference_raster.xml:3012
+#: reference_raster.xml:3224 reference_raster.xml:3265
+#: reference_raster.xml:3299 reference_raster.xml:3347
+#: reference_raster.xml:3390 reference_raster.xml:3471
+#: reference_raster.xml:3554 reference_raster.xml:3615
+#: reference_raster.xml:3677 reference_raster.xml:3756
+#: reference_raster.xml:3811 reference_raster.xml:3893
+#: reference_raster.xml:3942 reference_raster.xml:4004
+#: reference_raster.xml:4230 reference_raster.xml:4447
+#: reference_raster.xml:4490 reference_raster.xml:4730
+#: reference_raster.xml:4853 reference_raster.xml:5043
+#: reference_raster.xml:5113 reference_raster.xml:5150
+#: reference_raster.xml:5667 reference_raster.xml:6006
+#: reference_raster.xml:6226 reference_raster.xml:6291
+#: reference_raster.xml:6492 reference_raster.xml:6542
+#: reference_raster.xml:6592 reference_raster.xml:6642
+#: reference_raster.xml:6691 reference_raster.xml:6741
+#: reference_raster.xml:6791 reference_raster.xml:6862
+#: reference_raster.xml:6911 reference_raster.xml:6966
+#: reference_raster.xml:7011 reference_raster.xml:7056
+#: reference_raster.xml:7140 reference_raster.xml:7227
+#: reference_raster.xml:7308 reference_raster.xml:7389
+#: reference_raster.xml:7470 reference_raster.xml:7602
+#: reference_raster.xml:7683 reference_raster.xml:7763
+#: reference_raster.xml:7960 reference_raster.xml:8055
+#: reference_raster.xml:8148
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:625
+#, no-c-format
+msgid ""
+"SELECT DropRasterConstraints ('myrasters','rast');\n"
+"----RESULT output ---\n"
+"t\n"
+"\n"
+"-- verify change in raster_columns --\n"
+"SELECT srid, scale_x, scale_y, blocksize_x, blocksize_y, num_bands, "
+"pixel_types, nodata_values\n"
+" FROM raster_columns\n"
+" WHERE r_table_name = 'myrasters';\n"
+" \n"
+" srid | scale_x | scale_y | blocksize_x | blocksize_y | num_bands | "
+"pixel_types| nodata_values\n"
+"------+---------+---------+-------------+-------------+-----------"
+"+-------------+---------------\n"
+" 0 | | | | | "
+"| |"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:636
+#, no-c-format
+msgid "PostGIS_Raster_Lib_Build_Date"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:638
+#, no-c-format
+msgid "Reports full raster library build date."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:643
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Raster_Lib_Build_Date</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:654
+#, no-c-format
+msgid "Reports raster build date"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:660
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Raster_Lib_Build_Date();\n"
+"postgis_raster_lib_build_date\n"
+"-----------------------------\n"
+"2010-04-28 21:15:10"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:672
+#, no-c-format
+msgid "PostGIS_Raster_Lib_Version"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:674
+#, no-c-format
+msgid ""
+"<refpurpose>Reports full raster version and build configuration infos.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:680
+#, no-c-format
+msgid ""
+"<funcdef>text <function>PostGIS_Raster_Lib_Version</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:691
+#, no-c-format
+msgid "<para>Reports full raster version and build configuration infos.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:698
+#, no-c-format
+msgid ""
+"SELECT PostGIS_Raster_Lib_Version();\n"
+"postgis_raster_lib_version\n"
+"-----------------------------\n"
+" 2.0.0"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:712
+#, no-c-format
+msgid "ST_GDALDrivers"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:714
+#, no-c-format
+msgid ""
+"Returns a list of raster formats supported by your lib gdal. These are the "
+"formats you can output your raster using ST_AsGDALRaster."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:719
+#, no-c-format
+msgid ""
+"<funcdef>setof record <function>ST_GDALDrivers</function></funcdef> "
+"<paramdef><type>integer </type> <parameter>OUT idx</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>OUT short_name</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>OUT long_name</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>OUT create_options</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:732
+#, no-c-format
+msgid ""
+"Returns a list of raster formats short_name,long_name and creator options of "
+"each format supported by your lib gdal. Use the short_name as input in the "
+"<varname>format</varname> parameter of <xref linkend=\"RT_ST_AsGDALRaster\"/"
+">. Options vary depending on what drivers your libgdal was compiled with. "
+"<varname>create_options</varname> returns an xml formatted set of "
+"CreationOptionList/Option consisting of name and optional <varname>type</"
+"varname>, <varname>description</varname> and set of <varname>VALUE</varname> "
+"for each creator option for the specific driver."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:735 reference_raster.xml:1042
+#: reference_raster.xml:4537 reference_raster.xml:4635
+#: reference_raster.xml:4726 reference_raster.xml:4806
+#, no-c-format
+msgid "Availability: 2.0.0 - requires GDAL >= 1.6.0."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:739
+#, no-c-format
+msgid "Examples: List of Drivers"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:741
+#, no-c-format
+msgid ""
+"SELECT short_name, long_name\n"
+"FROM st_gdaldrivers()\n"
+"ORDER BY short_name;\n"
+" short_name | long_name\n"
+"----------------+--------------------------------------\n"
+"AAIGrid | Arc/Info ASCII Grid\n"
+"DTED | DTED Elevation Raster\n"
+"EHdr | ESRI .hdr Labelled\n"
+"FIT | FIT Image\n"
+"GIF | Graphics Interchange Format (.gif)\n"
+"GSAG | Golden Software ASCII Grid (.grd)\n"
+"GSBG | Golden Software Binary Grid (.grd)\n"
+"GTiff | GeoTIFF\n"
+"HF2 | HF2/HFZ heightfield raster\n"
+"HFA | Erdas Imagine Images (.img)\n"
+"ILWIS | ILWIS Raster Map\n"
+"INGR | Intergraph Raster\n"
+"JPEG | JPEG JFIF\n"
+"KMLSUPEROVERLAY | Kml Super Overlay\n"
+"NITF | National Imagery Transmission Format\n"
+"PNG | Portable Network Graphics\n"
+"R | R Object Data Store\n"
+"SAGA | SAGA GIS Binary Grid (.sdat)\n"
+"SRTMHGT | SRTMHGT File Format\n"
+"USGSDEM | USGS Optional ASCII DEM (and CDED)\n"
+"VRT | Virtual Raster\n"
+"XPM | X11 PixMap Format"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:743
+#, no-c-format
+msgid "Example: List of options for each driver"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:744
+#, no-c-format
+msgid ""
+"-- Output the create options XML column of JPEG as a table --\n"
+"-- Note you can use these creator options in ST_AsGDALRaster options "
+"argument\n"
+"SELECT (xpath('@name', g.opt))[1]::text As oname,\n"
+" (xpath('@type', g.opt))[1]::text As otype,\n"
+" (xpath('@description', g.opt))[1]::text As descrip\n"
+"FROM (SELECT unnest(xpath('/CreationOptionList/Option', create_options::"
+"xml)) As opt\n"
+"FROM st_gdaldrivers()\n"
+"WHERE short_name = 'JPEG') As g;\n"
+"\n"
+" oname | otype | descrip\n"
+"-------------+---------+-----------------------------\n"
+" PROGRESSIVE | boolean |\n"
+" QUALITY | int | good=100, bad=0, default=75\n"
+" WORLDFILE | boolean |"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:746
+#, no-c-format
+msgid ""
+"-- raw xml output for creator options for GeoTiff --\n"
+"SELECT create_options\n"
+"FROM st_gdaldrivers()\n"
+"WHERE short_name = 'GTiff';\n"
+"\n"
+"<![CDATA[<CreationOptionList>\n"
+" <Option name=\"COMPRESS\" type=\"string-select\">\n"
+" <Value>NONE</Value>\n"
+" <Value>LZW</Value>\n"
+" <Value>PACKBITS</Value>\n"
+" <Value>JPEG</Value>\n"
+" <Value>CCITTRLE</Value>\n"
+" <Value>CCITTFAX3</Value>\n"
+" <Value>CCITTFAX4</Value>\n"
+" <Value>DEFLATE</Value>\n"
+" </Option>\n"
+" <Option name=\"PREDICTOR\" type=\"int\" description=\"Predictor Type\"/"
+">\n"
+" <Option name=\"JPEG_QUALITY\" type=\"int\" description=\"JPEG quality "
+"1-100\" default=\"75\"/>\n"
+" <Option name=\"ZLEVEL\" type=\"int\" description=\"DEFLATE compression "
+"level 1-9\" default=\"6\"/>\n"
+" <Option name=\"NBITS\" type=\"int\" description=\"BITS for sub-byte "
+"files (1-7), sub-uint16 (9-15), sub-uint32 (17-31)\"/>\n"
+" <Option name=\"INTERLEAVE\" type=\"string-select\" default=\"PIXEL\">\n"
+" <Value>BAND</Value>\n"
+" <Value>PIXEL</Value>\n"
+" </Option>\n"
+" <Option name=\"TILED\" type=\"boolean\" description=\"Switch to tiled "
+"format\"/>\n"
+" <Option name=\"TFW\" type=\"boolean\" description=\"Write out world file"
+"\"/>\n"
+" <Option name=\"RPB\" type=\"boolean\" description=\"Write out .RPB (RPC) "
+"file\"/>\n"
+" <Option name=\"BLOCKXSIZE\" type=\"int\" description=\"Tile Width\"/>\n"
+" <Option name=\"BLOCKYSIZE\" type=\"int\" description=\"Tile/Strip Height"
+"\"/>\n"
+" <Option name=\"PHOTOMETRIC\" type=\"string-select\">\n"
+" <Value>MINISBLACK</Value>\n"
+" <Value>MINISWHITE</Value>\n"
+" <Value>PALETTE</Value>\n"
+" <Value>RGB</Value>\n"
+" <Value>CMYK</Value>\n"
+" <Value>YCBCR</Value>\n"
+" <Value>CIELAB</Value>\n"
+" <Value>ICCLAB</Value>\n"
+" <Value>ITULAB</Value>\n"
+" </Option>\n"
+" <Option name=\"SPARSE_OK\" type=\"boolean\" description=\"Can newly "
+"created files have missing blocks?\" default=\"FALSE\"/>\n"
+" <Option name=\"ALPHA\" type=\"boolean\" description=\"Mark first "
+"extrasample as being alpha\"/>\n"
+" <Option name=\"PROFILE\" type=\"string-select\" default=\"GDALGeoTIFF"
+"\">\n"
+" <Value>GDALGeoTIFF</Value>\n"
+" <Value>GeoTIFF</Value>\n"
+" <Value>BASELINE</Value>\n"
+" </Option>\n"
+" <Option name=\"PIXELTYPE\" type=\"string-select\">\n"
+" <Value>DEFAULT</Value>\n"
+" <Value>SIGNEDBYTE</Value>\n"
+" </Option>\n"
+" <Option name=\"BIGTIFF\" type=\"string-select\" description=\"Force "
+"creation of BigTIFF file\">\n"
+" <Value>YES</Value>\n"
+" <Value>NO</Value>\n"
+" <Value>IF_NEEDED</Value>\n"
+" <Value>IF_SAFER</Value>\n"
+" </Option>\n"
+" <Option name=\"ENDIANNESS\" type=\"string-select\" default=\"NATIVE\" "
+"description=\"Force endianness of created file. For DEBUG purpose mostly\">\n"
+" <Value>NATIVE</Value>\n"
+" <Value>INVERTED</Value>\n"
+" <Value>LITTLE</Value>\n"
+" <Value>BIG</Value>\n"
+" </Option>\n"
+" <Option name=\"COPY_SRC_OVERVIEWS\" type=\"boolean\" default=\"NO\" "
+"description=\"Force copy of overviews of source dataset (CreateCopy())\"/>\n"
+"</CreationOptionList>]]>\n"
+"\n"
+"-- Output the create options XML column for GTiff as a table --\n"
+"SELECT (xpath('@name', g.opt))[1]::text As oname,\n"
+" (xpath('@type', g.opt))[1]::text As otype,\n"
+" (xpath('@description', g.opt))[1]::text As descrip,\n"
+" array_to_string(xpath('Value/text()', g.opt),', ') As vals \n"
+"FROM (SELECT unnest(xpath('/CreationOptionList/Option', create_options::"
+"xml)) As opt\n"
+"FROM st_gdaldrivers()\n"
+"WHERE short_name = 'GTiff') As g;\n"
+"\n"
+" oname | otype | "
+"descrip | "
+"vals \n"
+"--------------------+---------------"
+"+----------------------------------------------------------------------"
+"+---------------------------------------------------------------------------\n"
+" COMPRESS | string-select "
+"| | "
+"NONE, LZW, PACKBITS, JPEG, CCITTRLE, CCITTFAX3, CCITTFAX4, DEFLATE\n"
+" PREDICTOR | int | Predictor "
+"Type | \n"
+" JPEG_QUALITY | int | JPEG quality "
+"1-100 | \n"
+" ZLEVEL | int | DEFLATE compression level "
+"1-9 | \n"
+" NBITS | int | BITS for sub-byte files (1-7), sub-"
+"uint16 (9-15), sub-uint32 (17-31) | \n"
+" INTERLEAVE | string-select "
+"| | "
+"BAND, PIXEL\n"
+" TILED | boolean | Switch to tiled "
+"format | \n"
+" TFW | boolean | Write out world "
+"file | \n"
+" RPB | boolean | Write out .RPB (RPC) "
+"file | \n"
+" BLOCKXSIZE | int | Tile "
+"Width | \n"
+" BLOCKYSIZE | int | Tile/Strip "
+"Height | \n"
+" PHOTOMETRIC | string-select "
+"| | "
+"MINISBLACK, MINISWHITE, PALETTE, RGB, CMYK, YCBCR, CIELAB, ICCLAB, ITULAB\n"
+" SPARSE_OK | boolean | Can newly created files have missing "
+"blocks? | \n"
+" ALPHA | boolean | Mark first extrasample as being "
+"alpha | \n"
+" PROFILE | string-select "
+"| | "
+"GDALGeoTIFF, GeoTIFF, BASELINE\n"
+" PIXELTYPE | string-select "
+"| | "
+"DEFAULT, SIGNEDBYTE\n"
+" BIGTIFF | string-select | Force creation of BigTIFF "
+"file | YES, NO, IF_NEEDED, IF_SAFER\n"
+" ENDIANNESS | string-select | Force endianness of created file. For "
+"DEBUG purpose mostly | NATIVE, INVERTED, LITTLE, BIG\n"
+" COPY_SRC_OVERVIEWS | boolean | Force copy of overviews of source "
+"dataset (CreateCopy()) | \n"
+"(19 rows)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:752 reference_raster.xml:1839
+#, no-c-format
+msgid ", <xref linkend=\"ST_SRID\"/>"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:759
+#, no-c-format
+msgid "Raster Constructors"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:763
+#, no-c-format
+msgid "ST_AddBand"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:764
+#, no-c-format
+msgid ""
+"Returns a raster with the new band(s) of given type added with given initial "
+"value in the given index location. If no index is specified, the band is "
+"added to the end."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:770
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_AddBand</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>addbandarg[] </type> <parameter>addbandargset</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_AddBand</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>pixeltype</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>initialvalue=0</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>nodataval=NULL</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_AddBand</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>index</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>initialvalue=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>nodataval=NULL</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_AddBand</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>torast</parameter></paramdef> <paramdef><type>raster </type> "
+"<parameter>fromrast</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>fromband=1</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>torastindex=at_end</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_AddBand</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>torast</parameter></paramdef> "
+"<paramdef><type>raster[] </type> <parameter>fromrasts</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>fromband=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>torastindex=at_end</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:822
+#, no-c-format
+msgid ""
+"Returns a raster with a new band added in given position (index), of given "
+"type, of given initial value, and of given nodata value. If no index is "
+"specified, the band is added to the end. If no <varname>fromband</varname> "
+"is specified, band 1 is assumed. Pixel type is a string representation of "
+"one of the pixel types specified in <xref linkend=\"RT_ST_BandPixelType\"/>. "
+"If an existing index is specified all subsequent bands >= that index are "
+"incremented by 1. If an initial value greater than the max of the pixel type "
+"is specified, then the initial value is set to the highest value allowed by "
+"the pixel type. The last version add the <varname>fromband</varname> from "
+"<varname>fromrast</varname> raster to <varname>torast</varname> in position "
+"<varname>torastindex</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:826
+#, no-c-format
+msgid ""
+"For the version that takes an array of <xref linkend=\"addbandarg\"/>, a "
+"specific addbandarg's index value is relative to the raster at the time when "
+"the band described by that addbandarg is being added to the raster. See the "
+"Multiple New Bands example below."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:830
+#, no-c-format
+msgid ""
+"For the version that takes an array of bands if <varname>torast</varname> is "
+"NULL, then the <varname>fromband</varname> band of each raster in the array "
+"is accumulated into a new raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:833
+#, no-c-format
+msgid "Enhanced: 2.1.0 support addbandarg was introduced."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:837
+#, no-c-format
+msgid "Examples: Single New Band versions"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:839
+#, no-c-format
+msgid ""
+"-- Add another band of type 8 bit unsigned integer with pixels initialized "
+"to 200\n"
+"UPDATE dummy_rast\n"
+" SET rast = ST_AddBand(rast,'8BUI'::text,200) \n"
+"WHERE rid = 1;"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:841
+#, no-c-format
+msgid ""
+"-- Create an empty raster 100x100 units, with upper left right at 0, add 2 "
+"bands (band 1 is 0/1 boolean bit switch, band2 allows values 0-15)\n"
+"-- uses addbandargs\n"
+"INSERT INTO dummy_rast(rid,rast)\n"
+" VALUES(10, ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 1, -1, 0, 0, "
+"0), \n"
+" ARRAY[\n"
+" ROW(1, '1BB'::text, 0, NULL),\n"
+" ROW(2, '4BUI'::text, 0, NULL)\n"
+" ]::addbandarg[]\n"
+" )\n"
+" );\n"
+" \n"
+"-- output meta data of raster bands to verify all is right --\n"
+"SELECT (bmd).*\n"
+"FROM (SELECT ST_BandMetaData(rast,generate_series(1,2)) As bmd \n"
+" FROM dummy_rast WHERE rid = 10) AS foo;\n"
+" --result -- \n"
+" pixeltype | nodatavalue | isoutdb | path\n"
+"-----------+----------------+-------------+---------+------\n"
+" 1BB | | f |\n"
+" 4BUI | | f |\n"
+" \n"
+" \n"
+"-- output meta data of raster -\n"
+"SELECT (rmd).width, (rmd).height, (rmd).numbands\n"
+"FROM (SELECT ST_MetaData(rast) As rmd \n"
+" FROM dummy_rast WHERE rid = 10) AS foo;\n"
+"-- result --\n"
+" upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy "
+"| srid | numbands\n"
+"------------+------------+-------+--------+------------+------------+-------"
+"+-------+------+----------\n"
+" 0 | 0 | 100 | 100 | 1 | -1 | 0 | 0 "
+"| 0 | 2"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:845
+#, no-c-format
+msgid "Examples: Multiple New Bands"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:847
+#, no-c-format
+msgid ""
+"SELECT\n"
+" *\n"
+"FROM ST_BandMetadata(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(10, 10, 0, 0, 1, -1, 0, 0, 0),\n"
+" ARRAY[\n"
+" ROW(NULL, '8BUI', 255, 0),\n"
+" ROW(NULL, '16BUI', 1, 2),\n"
+" ROW(2, '32BUI', 100, 12),\n"
+" ROW(2, '32BF', 3.14, -1)\n"
+" ]::addbandarg[]\n"
+" ),\n"
+" ARRAY[]::integer[]\n"
+");\n"
+"\n"
+" bandnum | pixeltype | nodatavalue | isoutdb | path \n"
+"---------+-----------+-------------+---------+------\n"
+" 1 | 8BUI | 0 | f | \n"
+" 2 | 32BF | -1 | f | \n"
+" 3 | 32BUI | 12 | f | \n"
+" 4 | 16BUI | 2 | f |"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:851
+#, no-c-format
+msgid "Examples: Multi-Band versions"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:853
+#, no-c-format
+msgid ""
+"-- Aggregate the 1st band of a table of like rasters into a single raster \n"
+"-- with as many bands as there are test_types and as many rows (new rasters) "
+"as there are mice\n"
+"-- NOTE: The ORDER BY test_type is only supported in PostgreSQL 9.0+\n"
+"-- for 8.4 and below it usually works to order your data in a subselect (but "
+"not guaranteed)\n"
+"-- The resulting raster will have a band for each test_type alphabetical by "
+"test_type\n"
+"-- For mouse lovers: No mice were harmed in this exercise\n"
+"SELECT mouse, ST_AddBand(NULL, array_agg(rast ORDER BY test_type), 1 ) As "
+"rast \n"
+" FROM mice_studies\n"
+" GROUP BY mouse;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:858
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_BandPixelType\"/>, <xref linkend="
+"\"RT_ST_MakeEmptyRaster\"/>, <xref linkend=\"RT_ST_MetaData\"/>, <xref "
+"linkend=\"RT_ST_NumBands\"/>, <xref linkend=\"RT_ST_Reclass\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:871
+#, no-c-format
+msgid "ST_AsRaster"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:872
+#, no-c-format
+msgid "Converts a PostGIS geometry to a PostGIS raster."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:876
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_AsRaster</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>raster </type> <parameter>ref</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>value=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>nodataval=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>touched=false</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>raster <function>ST_AsRaster</"
+"function></funcdef> <paramdef><type>geometry </type> <parameter>geom</"
+"parameter></paramdef> <paramdef><type>raster </type> <parameter>ref</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text[] </type> "
+"<parameter>pixeltype=ARRAY['8BUI']</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision[] </type> <parameter>value=ARRAY[1]</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision[] </"
+"type> <parameter>nodataval=ARRAY[0]</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>boolean </type> <parameter>touched=false</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_AsRaster</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>scalex</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>scaley</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>gridx</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>gridy</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>pixeltype</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>value=1</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>nodataval=0</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>skewx=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewy=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>touched=false</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_AsRaster</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>scalex</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>scaley</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision </type> <parameter>gridx=NULL</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>gridy=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text[] </type> <parameter>pixeltype=ARRAY['8BUI']</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision[] </type> "
+"<parameter>value=ARRAY[1]</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision[] </type> <parameter>nodataval=ARRAY[0]</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>skewx=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewy=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>touched=false</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_AsRaster</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>scalex</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>scaley</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>value=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>nodataval=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>upperleftx=NULL</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>upperlefty=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewx=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>skewy=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>touched=false</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_AsRaster</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>scalex</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>scaley</"
+"parameter></paramdef> <paramdef><type>text[] </type> <parameter>pixeltype</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision[] </"
+"type> <parameter>value=ARRAY[1]</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision[] </type> <parameter>nodataval=ARRAY[0]</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>upperleftx=NULL</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision </type> <parameter>upperlefty=NULL</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>skewx=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewy=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>touched=false</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_AsRaster</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>width</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>height</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>gridx</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>gridy</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>value=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>nodataval=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewx=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>skewy=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>touched=false</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_AsRaster</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>width</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>height</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>gridx=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>gridy=NULL</parameter></"
+"paramdef> <paramdef><type>text[] </type> <parameter>pixeltype=ARRAY['8BUI']</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision[] </"
+"type> <parameter>value=ARRAY[1]</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision[] </type> <parameter>nodataval=ARRAY[0]</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>skewx=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewy=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>boolean </type> <parameter>touched=false</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_AsRaster</function></funcdef> <paramdef><type>geometry </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>width</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>height</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>pixeltype</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>value=1</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>nodataval=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>upperleftx=NULL</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>upperlefty=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewx=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>skewy=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>touched=false</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_AsRaster</function></funcdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>width</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>height</parameter></paramdef> "
+"<paramdef><type>text[] </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef><type>double precision[] </type> <parameter>value=ARRAY[1]</"
+"parameter></paramdef> <paramdef><type>double precision[] </type> "
+"<parameter>nodataval=ARRAY[0]</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>upperleftx=NULL</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>upperlefty=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewx=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>skewy=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>touched=false</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1024
+#, no-c-format
+msgid ""
+"Converts a PostGIS geometry to a PostGIS raster. The many variants offers "
+"three groups of possibilities for setting the alignment and pixelsize of the "
+"resulting raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1026
+#, no-c-format
+msgid ""
+"The first group, composed of the two first variants, produce a raster having "
+"the same alignment (<varname>scalex</varname>, <varname>scaley</varname>, "
+"<varname>gridx</varname> and <varname>gridy</varname>), pixel type and "
+"nodata value as the provided reference raster. You generally pass this "
+"reference raster by joining the table containing the geometry with the table "
+"containing the reference raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1028
+#, no-c-format
+msgid ""
+"The second group, composed of four variants, let you set the dimensions of "
+"the raster by providing the parameters of a pixel size (<varname>scalex</"
+"varname> & <varname>scaley</varname> and <varname>skewx</varname> & "
+"<varname>skewy</varname>). The <varname>width</varname> & "
+"<varname>height</varname> of the resulting raster will be adjusted to fit "
+"the extent of the geometry. In most cases, you must cast integer "
+"<varname>scalex</varname> & <varname>scaley</varname> arguments to "
+"double precision so that PostgreSQL choose the right variant."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1030
+#, no-c-format
+msgid ""
+"The third group, composed of four variants, let you fix the dimensions of "
+"the raster by providing the dimensions of the raster (<varname>width</"
+"varname> & <varname>height</varname>). The parameters of the pixel size "
+"(<varname>scalex</varname> & <varname>scaley</varname> and "
+"<varname>skewx</varname> & <varname>skewy</varname>) of the resulting "
+"raster will be adjusted to fit the extent of the geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1032
+#, no-c-format
+msgid ""
+"The two first variants of each of those two last groups let you specify the "
+"alignment with an arbitrary corner of the alignment grid (<varname>gridx</"
+"varname> & <varname>gridy</varname>) and the two last variants takes the "
+"upper left corner (<varname>upperleftx</varname> & <varname>upperlefty</"
+"varname>)."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1034
+#, no-c-format
+msgid ""
+"Each group of variant allows producing a one band raster or a multiple bands "
+"raster. To produce a multiple bands raster, you must provide an array of "
+"pixel types (<varname>pixeltype[]</varname>), an array of initial values "
+"(<varname>value</varname>) and an array of nodata values "
+"(<varname>nodataval</varname>). If not provided pixeltyped defaults to 8BUI, "
+"values to 1 and nodataval to 0."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1036
+#, no-c-format
+msgid ""
+"The output raster will be in the same spatial reference as the source "
+"geometry. The only exception is for variants with a reference raster. In "
+"this case the resulting raster will get the same SRID as the reference "
+"raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1038
+#, no-c-format
+msgid ""
+"The optional <varname>touched</varname> parameter defaults to false and maps "
+"to the GDAL ALL_TOUCHED rasterization option, which determines if pixels "
+"touched by lines or polygons will be burned. Not just those on the line "
+"render path, or whose center point is within the polygon."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1040
+#, no-c-format
+msgid ""
+"This is particularly useful for rendering jpegs and pngs of geometries "
+"directly from the database when using in combination with <xref linkend="
+"\"RT_ST_AsPNG\"/> and other <xref linkend=\"RT_ST_AsGDALRaster\"/> family of "
+"functions."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1044
+#, no-c-format
+msgid ""
+"Not yet capable of rendering complex geometry types such as curves, TINS, "
+"and PolyhedralSurfaces, but should be able too once GDAL can."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:1049
+#, no-c-format
+msgid "Examples: Output geometries as PNG files"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1055
+#, no-c-format
+msgid "black circle"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1058
+#, no-c-format
+msgid ""
+"-- this will output a black circle taking up 150 x 150 pixels --\n"
+"SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10),150, 150, '2BUI'));"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1065
+#, no-c-format
+msgid "example from buffer rendered with just PostGIS"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1069
+#, no-c-format
+msgid ""
+"-- the bands map to RGB bands - the value (118,154,118) - teal --\n"
+"SELECT ST_AsPNG(\n"
+" ST_AsRaster(\n"
+" ST_Buffer(\n"
+" ST_GeomFromText('LINESTRING(50 50,150 150,150 50)'), "
+"10,'join=bevel'), \n"
+" 200,200,ARRAY['8BUI', '8BUI', '8BUI'], "
+"ARRAY[118,154,118], ARRAY[0,0,0]));"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1075
+#, no-c-format
+msgid ""
+", <xref linkend=\"ST_Buffer\"/>, <xref linkend=\"RT_ST_GDALDrivers\"/>, "
+"<xref linkend=\"RT_ST_AsGDALRaster\"/>, <xref linkend=\"RT_ST_AsPNG\"/>, "
+"<xref linkend=\"RT_ST_AsJPEG\"/>, <xref linkend=\"RT_ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1081
+#, no-c-format
+msgid "ST_Band"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1082
+#, no-c-format
+msgid ""
+"Returns one or more bands of an existing raster as a new raster. Useful for "
+"building new rasters from existing rasters."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:1086
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_Band</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer[] </type> <parameter>nbands = "
+"ARRAY[1]</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>raster <function>ST_Band</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>nbands</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>character </type> <parameter>delimiter=,</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Band</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>nband</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1111
+#, no-c-format
+msgid ""
+"Returns a single band of an existing raster as a new raster. Useful for "
+"building new rasters from existing rasters or export of only selected bands "
+"of a raster. If no band is specified, band 1 is assumed. Used as a helper "
+"function in various functions such as for deleting a band."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1120
+#, no-c-format
+msgid ""
+"-- Make 2 new rasters: 1 containing band 1 of dummy, second containing band "
+"2 of dummy and then reclassified as a 2BUI\n"
+"SELECT ST_NumBands(rast1) As numb1, ST_BandPixelType(rast1) As pix1, \n"
+" ST_NumBands(rast2) As numb2, ST_BandPixelType(rast2) As pix2\n"
+"FROM (\n"
+" SELECT ST_Band(rast) As rast1, ST_Reclass(ST_Band(rast,3), '100-200):1, "
+"[200-254:2', '2BUI') As rast2\n"
+" FROM dummy_rast\n"
+" WHERE rid = 2) As foo;\n"
+" \n"
+" numb1 | pix1 | numb2 | pix2\n"
+"-------+------+-------+------\n"
+" 1 | 8BUI | 1 | 2BUI"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1122
+#, no-c-format
+msgid ""
+"-- Return bands 2 and 3. Use text to define bands\n"
+"SELECT ST_NumBands(ST_Band(rast, '2,3')) As num_bands\n"
+" FROM dummy_rast WHERE rid=2;\n"
+" \n"
+"num_bands\n"
+"----------\n"
+"2\n"
+" \n"
+"-- Return bands 2 and 3. Use array to define bands\n"
+"SELECT ST_NumBands(ST_Band(rast, ARRAY[2,3])) As num_bands\n"
+" FROM dummy_rast \n"
+"WHERE rid=2;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1132
+#, no-c-format
+msgid "original (column rast)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1141
+#, no-c-format
+msgid "dupe_band"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1150
+#, no-c-format
+msgid "sing_band"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1158
+#, no-c-format
+msgid ""
+"--Make a new raster with 2nd band of original and 1st band repeated twice,\n"
+"and another with just the third band\n"
+"SELECT rast, ST_Band(rast, ARRAY[2,1,1]) As dupe_band, \n"
+" ST_Band(rast, 3) As sing_band \n"
+"FROM samples.than_chunked \n"
+"WHERE rid=35;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1164
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_NumBands\"/>, , <xref linkend=\"RT_ST_Reclass\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1169
+#, no-c-format
+msgid "ST_MakeEmptyRaster"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1170
+#, no-c-format
+msgid ""
+"Returns an empty raster (having no bands) of given dimensions (width & "
+"height), upperleft X and Y, pixel size and rotation (scalex, scaley, skewx "
+"& skewy) and reference system (srid). If a raster is passed in, returns "
+"a new raster with the same size, alignment and SRID. If srid is left out, "
+"the spatial ref is set to unknown (0)."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:1174
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_MakeEmptyRaster</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_MakeEmptyRaster</function></funcdef> <paramdef><type>integer </"
+"type> <parameter>width</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>height</parameter></paramdef> <paramdef><type>float8 </"
+"type> <parameter>upperleftx</parameter></paramdef> <paramdef><type>float8 </"
+"type> <parameter>upperlefty</parameter></paramdef> <paramdef><type>float8 </"
+"type> <parameter>scalex</parameter></paramdef> <paramdef><type>float8 </"
+"type> <parameter>scaley</parameter></paramdef> <paramdef><type>float8 </"
+"type> <parameter>skewx</parameter></paramdef> <paramdef><type>float8 </type> "
+"<parameter>skewy</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>srid=unknown</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>raster <function>ST_MakeEmptyRaster</"
+"function></funcdef> <paramdef><type>integer </type> <parameter>width</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>height</"
+"parameter></paramdef> <paramdef><type>float8 </type> <parameter>upperleftx</"
+"parameter></paramdef> <paramdef><type>float8 </type> <parameter>upperlefty</"
+"parameter></paramdef> <paramdef><type>float8 </type> <parameter>pixelsize</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1204
+#, no-c-format
+msgid ""
+"Returns an empty raster (having no band) of given dimensions (width & "
+"height) and georeferenced in spatial (or world) coordinates with upper left "
+"X (upperleftx), upper left Y (upperlefty), pixel size and rotation (scalex, "
+"scaley, skewx & skewy) and reference system (srid)."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1207
+#, no-c-format
+msgid ""
+"The last version use a single parameter to specify the pixel size "
+"(pixelsize). scalex is set to this argument and scaley is set to the "
+"negative value of this argument. skewx and skewy are set to 0."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1209
+#, no-c-format
+msgid ""
+"If an existing raster is passed in, it returns a new raster with the same "
+"meta data settings (without the bands)."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1211
+#, no-c-format
+msgid ""
+"If no srid is specified it defaults to 0. After you create an empty raster "
+"you probably want to add bands to it and maybe edit it. Refer to <xref "
+"linkend=\"RT_ST_AddBand\"/> to define bands and <xref linkend="
+"\"RT_ST_SetValue\"/> to set initial pixel values."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1218
+#, no-c-format
+msgid ""
+"INSERT INTO dummy_rast(rid,rast)\n"
+"VALUES(3, ST_MakeEmptyRaster( 100, 100, 0.0005, 0.0005, 1, 1, 0, 0, "
+"4326) );\n"
+"\n"
+"--use an existing raster as template for new raster\n"
+"INSERT INTO dummy_rast(rid,rast)\n"
+"SELECT 4, ST_MakeEmptyRaster(rast)\n"
+"FROM dummy_rast WHERE rid = 3;\n"
+"\n"
+"-- output meta data of rasters we just added\n"
+"SELECT rid, (md).*\n"
+"FROM (SELECT rid, ST_MetaData(rast) As md \n"
+" FROM dummy_rast\n"
+" WHERE rid IN(3,4)) As foo;\n"
+" \n"
+"-- output --\n"
+" rid | upperleftx | upperlefty | width | height | scalex | scaley | skewx | "
+"skewy | srid | numbands\n"
+"-----+------------+------------+-------+--------+------------+------------"
+"+-------+-------+------+----------\n"
+" 3 | 0.0005 | 0.0005 | 100 | 100 | 1 | 1 "
+"| 0 | 0 | 4326 | 0\n"
+" 4 | 0.0005 | 0.0005 | 100 | 100 | 1 | 1 "
+"| 0 | 0 | 4326 | 0"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1224
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_MetaData\"/>, <xref linkend=\"RT_ST_ScaleX\"/>, "
+"<xref linkend=\"RT_ST_ScaleY\"/>, <xref linkend=\"RT_ST_SetValue\"/>, <xref "
+"linkend=\"RT_ST_SkewX\"/>, , <xref linkend=\"RT_ST_SkewY\"/>"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:1229
+#, no-c-format
+msgid "Raster Accessors"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1233
+#, no-c-format
+msgid "ST_GeoReference"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1234
+#, no-c-format
+msgid ""
+"Returns the georeference meta data in GDAL or ESRI format as commonly seen "
+"in a world file. Default is GDAL."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1239
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_GeoReference</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter>format=GDAL</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1250
+#, no-c-format
+msgid ""
+"Returns the georeference meta data including carriage return in GDAL or ESRI "
+"format as commonly seen in a <ulink url=\"http://en.wikipedia.org/wiki/"
+"World_file\">world file</ulink>. Default is GDAL if no type specified. type "
+"is string 'GDAL' or 'ESRI'."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1252 reference_raster.xml:3257
+#, no-c-format
+msgid "Difference between format representations is as follows:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1253 reference_raster.xml:3258
+#, no-c-format
+msgid "<varname>GDAL</varname>:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1254
+#, no-c-format
+msgid ""
+"scalex \n"
+"skewy \n"
+"skewx\n"
+"scaley\n"
+"upperleftx\n"
+"upperlefty"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1255 reference_raster.xml:3260
+#, no-c-format
+msgid "<varname>ESRI</varname>:"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1256
+#, no-c-format
+msgid ""
+"scalex \n"
+"skewy \n"
+"skewx\n"
+"scaley\n"
+"upperleftx + scalex*0.5\n"
+"upperlefty + scaley*0.5"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1262
+#, no-c-format
+msgid ""
+"SELECT ST_GeoReference(rast, 'ESRI') As esri_ref, ST_GeoReference(rast, "
+"'GDAL') As gdal_ref\n"
+" FROM dummy_rast WHERE rid=1;\n"
+"\n"
+" esri_ref | gdal_ref\n"
+"--------------+--------------\n"
+" 2.0000000000 | 2.0000000000\n"
+" 0.0000000000 : 0.0000000000\n"
+" 0.0000000000 : 0.0000000000\n"
+" 3.0000000000 : 3.0000000000\n"
+" 1.5000000000 : 0.5000000000\n"
+" 2.0000000000 : 0.5000000000"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1267
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_ScaleX\"/>, <xref linkend=\"RT_ST_ScaleY\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1273
+#, no-c-format
+msgid "ST_Height"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1274
+#, no-c-format
+msgid "Returns the height of the raster in pixels."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1279
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_Height</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1289
+#, no-c-format
+msgid "Returns the height of the raster."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1295
+#, no-c-format
+msgid ""
+"SELECT rid, ST_Height(rast) As rastheight\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | rastheight\n"
+"-----+------------\n"
+" 1 | 20\n"
+" 2 | 5"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1307
+#, no-c-format
+msgid "ST_MetaData"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1308
+#, no-c-format
+msgid ""
+"Returns basic meta data about a raster object such as pixel size, rotation "
+"(skew), upper, lower left, etc."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1313
+#, no-c-format
+msgid ""
+"<funcdef>record <function>ST_MetaData</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1323
+#, no-c-format
+msgid ""
+"Returns basic meta data about a raster object such as pixel size, rotation "
+"(skew), upper, lower left, etc. Columns returned: upperleftx | upperlefty | "
+"width | height | scalex | scaley | skewx | skewy | srid | numbands"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1330
+#, no-c-format
+msgid ""
+"SELECT rid, (foo.md).* \n"
+" FROM (SELECT rid, ST_MetaData(rast) As md\n"
+"FROM dummy_rast) As foo;\n"
+"\n"
+" rid | upperleftx | upperlefty | width | height | scalex | scaley | skewx | "
+"skewy | srid | numbands\n"
+" ----+------------+------------+-------+--------+--------+-----------+-------"
+"+-------+------+-------\n"
+" 1 | 0.5 | 0.5 | 10 | 20 | 2 | 3 "
+"| 0 | 0 | 0 | 0\n"
+" 2 | 3427927.75 | 5793244 | 5 | 5 | 0.05 | -0.05 "
+"| 0 | 0 | 0 | 3"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1336 reference_raster.xml:3901
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_NumBands\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1342
+#, no-c-format
+msgid "ST_NumBands"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1343
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the number of bands in the raster object.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1348
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_NumBands</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1358
+#, no-c-format
+msgid "<para>Returns the number of bands in the raster object.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1364
+#, no-c-format
+msgid ""
+"SELECT rid, ST_NumBands(rast) As numbands\n"
+"FROM dummy_rast;\n"
+"\n"
+"rid | numbands\n"
+"----+----------\n"
+" 1 | 0\n"
+" 2 | 3"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1376
+#, no-c-format
+msgid "ST_PixelHeight"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1377
+#, no-c-format
+msgid ""
+"Returns the pixel height in geometric units of the spatial reference system."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1382
+#, no-c-format
+msgid ""
+"<funcdef>double precision <function>ST_PixelHeight</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1392
+#, no-c-format
+msgid ""
+"Returns the height of a pixel in geometric units of the spatial reference "
+"system. In the common case where there is no skew, the pixel height is just "
+"the scale ratio between geometric coordinates and raster pixels."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1394
+#, no-c-format
+msgid ""
+"Refer to <xref linkend=\"RT_ST_PixelWidth\"/> for a diagrammatic "
+"visualization of the relationship."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:1398 reference_raster.xml:1453
+#, no-c-format
+msgid "Examples: Rasters with no skew"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1400
+#, no-c-format
+msgid ""
+"SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,\n"
+" ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) As "
+"skewx,\n"
+" ST_SkewY(rast) As skewy\n"
+"FROM dummy_rast;\n"
+"\n"
+" rastheight | pixheight | scalex | scaley | skewx | skewy\n"
+"------------+-----------+--------+--------+-------+----------\n"
+" 20 | 3 | 2 | 3 | 0 | 0\n"
+" 5 | 0.05 | 0.05 | -0.05 | 0 | 0"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:1405 reference_raster.xml:1460
+#, no-c-format
+msgid "Examples: Rasters with skew different than 0"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1407
+#, no-c-format
+msgid ""
+"SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,\n"
+" ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) As "
+"skewx,\n"
+" ST_SkewY(rast) As skewy\n"
+"FROM (SELECT ST_SetSKew(rast,0.5,0.5) As rast\n"
+" FROM dummy_rast) As skewed;\n"
+"\n"
+"rastheight | pixheight | scalex | scaley | skewx | skewy\n"
+"-----------+-------------------+--------+--------+-------+----------\n"
+" 20 | 3.04138126514911 | 2 | 3 | 0.5 | 0.5\n"
+" 5 | 0.502493781056044 | 0.05 | -0.05 | 0.5 | 0.5"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1414 reference_raster.xml:1469
+#: reference_raster.xml:3307
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_ScaleX\"/>, <xref linkend=\"RT_ST_ScaleY\"/>, <xref "
+"linkend=\"RT_ST_SkewX\"/>, <xref linkend=\"RT_ST_SkewY\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1421
+#, no-c-format
+msgid "ST_PixelWidth"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1422
+#, no-c-format
+msgid ""
+"Returns the pixel width in geometric units of the spatial reference system."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1427
+#, no-c-format
+msgid ""
+"<funcdef>double precision <function>ST_PixelWidth</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1437
+#, no-c-format
+msgid ""
+"Returns the width of a pixel in geometric units of the spatial reference "
+"system. In the common case where there is no skew, the pixel width is just "
+"the scale ratio between geometric coordinates and raster pixels."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1439
+#, no-c-format
+msgid "The following diagram demonstrates the relationship:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1446
+#, no-c-format
+msgid "Pixel Width: Pixel size in the i direction"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1446
+#, no-c-format
+msgid "Pixel Height: Pixel size in the j direction"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1455
+#, no-c-format
+msgid ""
+"SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,\n"
+" ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) "
+"As skewx,\n"
+" ST_SkewY(rast) As skewy\n"
+" FROM dummy_rast;\n"
+" \n"
+" rastwidth | pixwidth | scalex | scaley | skewx | skewy\n"
+" -----------+----------+--------+--------+-------+----------\n"
+" 10 | 2 | 2 | 3 | 0 | 0\n"
+" 5 | 0.05 | 0.05 | -0.05 | 0 | 0"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1462
+#, no-c-format
+msgid ""
+"SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,\n"
+" ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) "
+"As skewx,\n"
+" ST_SkewY(rast) As skewy\n"
+" FROM (SELECT ST_SetSkew(rast,0.5,0.5) As rast\n"
+" FROM dummy_rast) As skewed;\n"
+" \n"
+" rastwidth | pixwidth | scalex | scaley | skewx | skewy\n"
+" -----------+-------------------+--------+--------+-------"
+"+----------\n"
+" 10 | 2.06155281280883 | 2 | 3 | 0.5 | 0.5\n"
+" 5 | 0.502493781056044 | 0.05 | -0.05 | 0.5 | 0.5"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1475
+#, no-c-format
+msgid "ST_ScaleX"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1476
+#, no-c-format
+msgid ""
+"Returns the X component of the pixel width in units of coordinate reference "
+"system."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1481
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_ScaleX</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1491
+#, no-c-format
+msgid ""
+"Returns the X component of the pixel width in units of coordinate reference "
+"system. Refer to <ulink url=\"http://en.wikipedia.org/wiki/World_file"
+"\">World File</ulink> for more details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1493
+#, no-c-format
+msgid "Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeX."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1499
+#, no-c-format
+msgid ""
+"SELECT rid, ST_ScaleX(rast) As rastpixwidth\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | rastpixwidth\n"
+"-----+--------------\n"
+" 1 | 2\n"
+" 2 | 0.05"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1512
+#, no-c-format
+msgid "ST_ScaleY"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1513
+#, no-c-format
+msgid ""
+"Returns the Y component of the pixel height in units of coordinate reference "
+"system."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1518
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_ScaleY</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1528
+#, no-c-format
+msgid ""
+"Returns the Y component of the pixel height in units of coordinate reference "
+"system. May be negative. Refer to <ulink url=\"http://en.wikipedia.org/wiki/"
+"World_file\">World File</ulink> for more details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1531
+#, no-c-format
+msgid "Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeY."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1537
+#, no-c-format
+msgid ""
+"SELECT rid, ST_ScaleY(rast) As rastpixheight\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | rastpixheight\n"
+"-----+---------------\n"
+" 1 | 3\n"
+" 2 | -0.05"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1550
+#, no-c-format
+msgid "ST_Raster2WorldCoord"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1551
+#, no-c-format
+msgid ""
+"Returns the raster's upper left corner as geometric X and Y (longitude and "
+"latitude) given a column and row. Column and row starts at 1."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1556
+#, no-c-format
+msgid ""
+"<funcdef>record <function>ST_Raster2WorldCoord</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>xcolumn</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>yrow</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1568
+#, no-c-format
+msgid ""
+"Returns the upper left corner as geometric X and Y (longitude and latitude) "
+"given a column and row. Returned X and Y are in geometric units of the "
+"georeferenced raster. Numbering of column and row starts at 1 but if either "
+"parameter is passed a zero, a negative number or a number greater than the "
+"respective dimension of the raster, it will return coordinates outside of "
+"the raster assuming the raster's grid is applicable outside the raster's "
+"bounds."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1573 reference_raster.xml:1979
+#: reference_raster.xml:2558 reference_raster.xml:2603
+#: reference_raster.xml:2646 reference_raster.xml:2691
+#: reference_raster.xml:2836 reference_raster.xml:2933
+#: reference_raster.xml:3102 reference_raster.xml:3221
+#: reference_raster.xml:5578 reference_raster.xml:6858
+#: reference_raster.xml:6907 reference_raster.xml:7136
+#: reference_raster.xml:7223 reference_raster.xml:7304
+#: reference_raster.xml:7385 reference_raster.xml:7466
+#: reference_raster.xml:7679 reference_raster.xml:7759
+#: reference_raster.xml:7956 reference_raster.xml:8051
+#: reference_raster.xml:8144
+#, no-c-format
+msgid "Availability: 2.1.0"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1580
+#, no-c-format
+msgid ""
+"-- non-skewed raster\n"
+"SELECT\n"
+" rid,\n"
+" (ST_Raster2WorldCoord(rast,1, 1)).*,\n"
+" (ST_Raster2WorldCoord(rast,2, 2)).*\n"
+"FROM dummy_rast\n"
+"\n"
+" rid | longitude | latitude | longitude | latitude \n"
+"-----+------------+----------+-----------+------------\n"
+" 1 | 0.5 | 0.5 | 2.5 | 3.5\n"
+" 2 | 3427927.75 | 5793244 | 3427927.8 | 5793243.95"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1582
+#, no-c-format
+msgid ""
+"-- skewed raster\n"
+"SELECT\n"
+" rid,\n"
+" (ST_Raster2WorldCoord(rast, 1, 1)).*,\n"
+" (ST_Raster2WorldCoord(rast, 2, 3)).*\n"
+"FROM (\n"
+" SELECT\n"
+" rid,\n"
+" ST_SetSkew(rast, 100.5, 0) As rast\n"
+" FROM dummy_rast\n"
+") As foo\n"
+"\n"
+" rid | longitude | latitude | longitude | latitude \n"
+"-----+------------+----------+-----------+-----------\n"
+" 1 | 0.5 | 0.5 | 203.5 | 6.5\n"
+" 2 | 3427927.75 | 5793244 | 3428128.8 | 5793243.9"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1589
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Raster2WorldCoordY\"/>, <xref linkend=\"RT_ST_SetSkew"
+"\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1599
+#, no-c-format
+msgid "ST_Raster2WorldCoordX"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1600
+#, no-c-format
+msgid ""
+"Returns the geometric X coordinate upper left of a raster, column and row. "
+"Numbering of columns and rows starts at 1."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:1605
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>float8 <function>ST_Raster2WorldCoordX</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>xcolumn</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>float8 "
+"<function>ST_Raster2WorldCoordX</function></funcdef> <paramdef><type>raster "
+"</type> <parameter>rast</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>xcolumn</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>yrow</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1623
+#, no-c-format
+msgid ""
+"Returns the upper left X coordinate of a raster column row in geometric "
+"units of the georeferenced raster. Numbering of columns and rows starts at 1 "
+"but if you pass in a negative number or number higher than number of columns "
+"in raster, it will give you coordinates outside of the raster file to left "
+"or right with the assumption that the skew and pixel sizes are same as "
+"selected raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1628
+#, no-c-format
+msgid ""
+"For non-skewed rasters, providing the X column is sufficient. For skewed "
+"rasters, the georeferenced coordinate is a function of the ST_ScaleX and "
+"ST_SkewX and row and column. An error will be raised if you give just the X "
+"column for a skewed raster."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1636
+#, no-c-format
+msgid ""
+"-- non-skewed raster providing column is "
+"sufficient \n"
+"SELECT rid, ST_Raster2WorldCoordX(rast,1) As x1coord, \n"
+" ST_Raster2WorldCoordX(rast,2) As x2coord,\n"
+" ST_ScaleX(rast) As pixelx\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | x1coord | x2coord | pixelx\n"
+"-----+------------+-----------+--------\n"
+" 1 | 0.5 | 2.5 | 2\n"
+" 2 | 3427927.75 | 3427927.8 | 0.05"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1638
+#, no-c-format
+msgid ""
+"-- for fun lets skew it \n"
+"SELECT rid, ST_Raster2WorldCoordX(rast, 1, 1) As x1coord, \n"
+" ST_Raster2WorldCoordX(rast, 2, 3) As x2coord,\n"
+" ST_ScaleX(rast) As pixelx\n"
+"FROM (SELECT rid, ST_SetSkew(rast, 100.5, 0) As rast FROM dummy_rast) As "
+"foo;\n"
+"\n"
+" rid | x1coord | x2coord | pixelx\n"
+"-----+------------+-----------+--------\n"
+" 1 | 0.5 | 203.5 | 2\n"
+" 2 | 3427927.75 | 3428128.8 | 0.05"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1645
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Raster2WorldCoordY\"/>, <xref linkend=\"RT_ST_SetSkew"
+"\"/>, <xref linkend=\"RT_ST_SkewX\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1651
+#, no-c-format
+msgid "ST_Raster2WorldCoordY"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1652
+#, no-c-format
+msgid ""
+"Returns the geometric Y coordinate upper left corner of a raster, column and "
+"row. Numbering of columns and rows starts at 1."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:1657
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>float8 <function>ST_Raster2WorldCoordY</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>yrow</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>float8 "
+"<function>ST_Raster2WorldCoordY</function></funcdef> <paramdef><type>raster "
+"</type> <parameter>rast</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>xcolumn</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>yrow</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1675
+#, no-c-format
+msgid ""
+"Returns the upper left Y coordinate of a raster column row in geometric "
+"units of the georeferenced raster. Numbering of columns and rows starts at 1 "
+"but if you pass in a negative number or number higher than number of columns/"
+"rows in raster, it will give you coordinates outside of the raster file to "
+"left or right with the assumption that the skew and pixel sizes are same as "
+"selected raster tile."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1680
+#, no-c-format
+msgid ""
+"For non-skewed rasters, providing the Y column is sufficient. For skewed "
+"rasters, the georeferenced coordinate is a function of the ST_ScaleY and "
+"ST_SkewY and row and column. An error will be raised if you give just the Y "
+"row for a skewed raster."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1688
+#, no-c-format
+msgid ""
+"-- non-skewed raster providing row is "
+"sufficient \n"
+"SELECT rid, ST_Raster2WorldCoordY(rast,1) As y1coord, \n"
+" ST_Raster2WorldCoordY(rast,3) As y2coord,\n"
+" ST_ScaleY(rast) As pixely\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | y1coord | y2coord | pixely\n"
+"-----+---------+-----------+--------\n"
+" 1 | 0.5 | 6.5 | 3\n"
+" 2 | 5793244 | 5793243.9 | -0.05"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1690
+#, no-c-format
+msgid ""
+"-- for fun lets skew it \n"
+"SELECT rid, ST_Raster2WorldCoordY(rast,1,1) As y1coord, \n"
+" ST_Raster2WorldCoordY(rast,2,3) As y2coord,\n"
+" ST_ScaleY(rast) As pixely\n"
+"FROM (SELECT rid, ST_SetSkew(rast,0,100.5) As rast FROM dummy_rast) As foo;\n"
+"\n"
+" rid | y1coord | y2coord | pixely\n"
+"-----+---------+-----------+--------\n"
+" 1 | 0.5 | 107 | 3\n"
+" 2 | 5793244 | 5793344.4 | -0.05"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1697
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Raster2WorldCoordX\"/>, <xref linkend=\"RT_ST_SetSkew"
+"\"/>, <xref linkend=\"RT_ST_SkewY\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1703
+#, no-c-format
+msgid "ST_Rotation"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1704
+#, no-c-format
+msgid "Returns the rotation of the raster in radian."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1709
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_Rotation</function></funcdef> "
+"<paramdef><type>raster</type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1719
+#, no-c-format
+msgid ""
+"Returns the uniform rotation of the raster in radian. If a raster does not "
+"have uniform rotation, NaN is returned. Refer to <ulink url=\"http://en."
+"wikipedia.org/wiki/World_file\">World File</ulink> for more details."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1726
+#, no-c-format
+msgid ""
+"SELECT rid, ST_Rotation(ST_SetScale(ST_SetSkew(rast, sqrt(2)), sqrt(2))) as "
+"rot FROM dummy_rast;\n"
+"\n"
+" rid | rot \n"
+"-----+-------------------\n"
+" 1 | 0.785398163397448\n"
+" 2 | 0.785398163397448"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1732
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_SetScale\"/>, <xref linkend=\"RT_ST_SetSkew\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1738
+#, no-c-format
+msgid "ST_SkewX"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1739
+#, no-c-format
+msgid "Returns the georeference X skew (or rotation parameter)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1744
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_SkewX</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1754
+#, no-c-format
+msgid ""
+"Returns the georeference X skew (or rotation parameter). Refer to <ulink url="
+"\"http://en.wikipedia.org/wiki/World_file\">World File</ulink> for more "
+"details."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1761 reference_raster.xml:1797
+#, no-c-format
+msgid ""
+"SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy, \n"
+" ST_GeoReference(rast) as georef\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | skewx | skewy | georef\n"
+"-----+-------+-------+--------------------\n"
+" 1 | 0 | 0 | 2.0000000000\n"
+" : 0.0000000000\n"
+" : 0.0000000000\n"
+" : 3.0000000000\n"
+" : 0.5000000000\n"
+" : 0.5000000000\n"
+" :\n"
+" 2 | 0 | 0 | 0.0500000000\n"
+" : 0.0000000000\n"
+" : 0.0000000000\n"
+" : -0.0500000000\n"
+" : 3427927.7500000000\n"
+" : 5793244.0000000000"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1768
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_SkewY\"/>, <xref linkend=\"RT_ST_SetSkew\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1774
+#, no-c-format
+msgid "ST_SkewY"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1775
+#, no-c-format
+msgid "Returns the georeference Y skew (or rotation parameter)."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1780
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_SkewY</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1790
+#, no-c-format
+msgid ""
+"Returns the georeference Y skew (or rotation parameter). Refer to <ulink url="
+"\"http://en.wikipedia.org/wiki/World_file\">World File</ulink> for more "
+"details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1804
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_SkewX\"/>, <xref linkend=\"RT_ST_SetSkew\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1810
+#, no-c-format
+msgid "ST_SRID"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1811
+#, no-c-format
+msgid ""
+"Returns the spatial reference identifier of the raster as defined in "
+"spatial_ref_sys table."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1816
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_SRID</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1826
+#, no-c-format
+msgid ""
+"Returns the spatial reference identifier of the raster object as defined in "
+"the spatial_ref_sys table."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1827
+#, no-c-format
+msgid ""
+"From PostGIS 2.0+ the srid of a non-georeferenced raster/geometry is 0 "
+"instead of the prior -1."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1833
+#, no-c-format
+msgid ""
+"SELECT ST_SRID(rast) As srid\n"
+"FROM dummy_rast WHERE rid=1;\n"
+"\n"
+"srid\n"
+"----------------\n"
+"0"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1845
+#, no-c-format
+msgid "ST_UpperLeftX"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1846
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the upper left X coordinate of raster in projected "
+"spatial ref.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1851
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_UpperLeftX</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1861
+#, no-c-format
+msgid ""
+"<para>Returns the upper left X coordinate of raster in projected spatial ref."
+"</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1867
+#, no-c-format
+msgid ""
+"SELECt rid, ST_UpperLeftX(rast) As ulx\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | ulx\n"
+"-----+------------\n"
+" 1 | 0.5\n"
+" 2 | 3427927.75"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1873 reference_raster.xml:1907
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_GeoReference\"/>, <xref linkend=\"RT_Box3D\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1879
+#, no-c-format
+msgid "ST_UpperLeftY"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1880
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the upper left Y coordinate of raster in projected "
+"spatial ref.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1885
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_UpperLeftY</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1895
+#, no-c-format
+msgid ""
+"<para>Returns the upper left Y coordinate of raster in projected spatial ref."
+"</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1901
+#, no-c-format
+msgid ""
+"SELECT rid, ST_UpperLeftY(rast) As uly\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | uly\n"
+"-----+---------\n"
+" 1 | 0.5\n"
+" 2 | 5793244"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1913
+#, no-c-format
+msgid "ST_Width"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1914
+#, no-c-format
+msgid "<refpurpose>Returns the width of the raster in pixels.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:1919
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_Width</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1929
+#, no-c-format
+msgid "<para>Returns the width of the raster in pixels.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1935
+#, no-c-format
+msgid ""
+"SELECT ST_Width(rast) As rastwidth\n"
+"FROM dummy_rast WHERE rid=1;\n"
+"\n"
+"rastwidth\n"
+"----------------\n"
+"10"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:1949
+#, no-c-format
+msgid "ST_World2RasterCoord"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:1950
+#, no-c-format
+msgid ""
+"Returns the upper left corner as column and row given geometric X and Y "
+"(longitude and latitude) or a point geometry expressed in the spatial "
+"reference coordinate system of the raster."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:1954
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>integer <function>ST_World2RasterCoord</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>pt</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>ST_World2RasterCoord</function></funcdef> <paramdef><type>raster </"
+"type> <parameter>rast</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>longitude</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>latitude</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1973
+#, no-c-format
+msgid ""
+"Returns the upper left corner as column and row given geometric X and Y "
+"(longitude and latitude) or a point geometry. This function works regardless "
+"of whether or not the geometric X and Y or point geometry is outside the "
+"extent of the raster. Geometric X and Y must be expressed in the spatial "
+"reference coordinate system of the raster."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:1986
+#, no-c-format
+msgid ""
+"SELECT\n"
+" rid,\n"
+" (ST_World2RasterCoord(rast,3427927.8,20.5)).*,\n"
+" (ST_World2RasterCoord(rast,ST_GeomFromText('POINT(3427927.8 20.5)',"
+"ST_SRID(rast)))).*\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | columnx | rowy | columnx | rowy \n"
+"-----+---------+-----------+---------+-----------\n"
+" 1 | 1713964 | 7 | 1713964 | 7\n"
+" 2 | 2 | 115864471 | 2 | 115864471"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:1992
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_World2RasterCoordY\"/>, <xref linkend="
+"\"RT_ST_Raster2WorldCoordX\"/>, <xref linkend=\"RT_ST_Raster2WorldCoordY\"/"
+">, <xref linkend=\"RT_ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2004
+#, no-c-format
+msgid "ST_World2RasterCoordX"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2005
+#, no-c-format
+msgid ""
+"Returns the column in the raster of the point geometry (pt) or a X and Y "
+"world coordinate (xw, yw) represented in world spatial reference system of "
+"raster."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:2010
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>integer <function>ST_World2RasterCoordX</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>pt</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>ST_World2RasterCoordX</function></funcdef> <paramdef><type>raster "
+"</type> <parameter>rast</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>xw</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>integer <function>ST_World2RasterCoordX</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>xw</"
+"parameter></paramdef> <paramdef><type>double precision </type> "
+"<parameter>yw</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2035
+#, no-c-format
+msgid ""
+"Returns the column in the raster of the point geometry (pt) or a X and Y "
+"world coordinate (xw, yw). A point, or (both xw and yw world coordinates are "
+"required if a raster is skewed). If a raster is not skewed then xw is "
+"sufficient. World coordinates are in the spatial reference coordinate system "
+"of the raster."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2042
+#, no-c-format
+msgid ""
+"SELECT rid, ST_World2RasterCoordX(rast,3427927.8) As xcoord, \n"
+" ST_World2RasterCoordX(rast,3427927.8,20.5) As xcoord_xwyw, \n"
+" ST_World2RasterCoordX(rast,ST_GeomFromText('POINT(3427927.8 "
+"20.5)',ST_SRID(rast))) As ptxcoord\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | xcoord | xcoord_xwyw | ptxcoord\n"
+"-----+---------+---------+----------\n"
+" 1 | 1713964 | 1713964 | 1713964\n"
+" 2 | 1 | 1 | 1"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2048 reference_raster.xml:2102
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Raster2WorldCoordY\"/>, <xref linkend=\"RT_ST_SRID\"/"
+">"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2058
+#, no-c-format
+msgid "ST_World2RasterCoordY"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2059
+#, no-c-format
+msgid ""
+"Returns the row in the raster of the point geometry (pt) or a X and Y world "
+"coordinate (xw, yw) represented in world spatial reference system of raster."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:2064
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>integer <function>ST_World2RasterCoordY</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>pt</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>ST_World2RasterCoordY</function></funcdef> <paramdef><type>raster "
+"</type> <parameter>rast</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>xw</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>integer <function>ST_World2RasterCoordY</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>xw</"
+"parameter></paramdef> <paramdef><type>double precision </type> "
+"<parameter>yw</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2089
+#, no-c-format
+msgid ""
+"Returns the row in the raster of the point geometry (pt) or a X and Y world "
+"coordinate (xw, yw). A point, or (both xw and yw world coordinates are "
+"required if a raster is skewed). If a raster is not skewed then xw is "
+"sufficient. World coordinates are in the spatial reference coordinate system "
+"of the raster."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2096
+#, no-c-format
+msgid ""
+"SELECT rid, ST_World2RasterCoordY(rast,20.5) As ycoord, \n"
+" ST_World2RasterCoordY(rast,3427927.8,20.5) As ycoord_xwyw, \n"
+" ST_World2RasterCoordY(rast,ST_GeomFromText('POINT(3427927.8 "
+"20.5)',ST_SRID(rast))) As ptycoord\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | ycoord | ycoord_xwyw | ptycoord\n"
+"-----+-----------+-------------+-----------\n"
+" 1 | 7 | 7 | 7\n"
+" 2 | 115864471 | 115864471 | 115864471"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2108
+#, no-c-format
+msgid "ST_IsEmpty"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2109
+#, no-c-format
+msgid ""
+"<refpurpose>Returns true if the raster is empty (width = 0 and height = 0). "
+"Otherwise, returns false.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2114
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_IsEmpty</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2124
+#, no-c-format
+msgid ""
+"<para>Returns true if the raster is empty (width = 0 and height = 0). "
+"Otherwise, returns false.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2132
+#, no-c-format
+msgid ""
+"SELECT ST_IsEmpty(ST_MakeEmptyRaster(100, 100, 0, 0, 0, 0, 0, 0))\n"
+"st_isempty |\n"
+"-----------+\n"
+"f |\n"
+" \n"
+" \n"
+"SELECT ST_IsEmpty(ST_MakeEmptyRaster(0, 0, 0, 0, 0, 0, 0, 0))\n"
+"st_isempty |\n"
+"-----------+\n"
+"t |"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:2144
+#, no-c-format
+msgid "Raster Band Accessors"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2147
+#, no-c-format
+msgid "ST_BandMetaData"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2148
+#, no-c-format
+msgid ""
+"Returns basic meta data for a specific raster band. band num 1 is assumed if "
+"none-specified."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2153
+#, no-c-format
+msgid ""
+"<funcdef>record <function>ST_BandMetaData</function></funcdef> "
+"<paramdef><type>raster </type><parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type><parameter>bandnum=1</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2164
+#, no-c-format
+msgid ""
+"Returns basic meta data about a raster band. Columns returned pixeltype | "
+"nodatavalue | isoutdb | path."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2168
+#, no-c-format
+msgid "If raster contains no bands then an error is thrown."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2173
+#, no-c-format
+msgid "If band has no NODATA value, nodatavalue will be NULL."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2182
+#, no-c-format
+msgid ""
+"SELECT rid, (foo.md).* \n"
+" FROM (SELECT rid, ST_BandMetaData(rast,1) As md\n"
+"FROM dummy_rast WHERE rid=2) As foo;\n"
+"\n"
+" rid | pixeltype | nodatavalue | isoutdb | path\n"
+"-----+-----------+----------------+-------------+---------+------\n"
+" 2 | 8BUI | 0 | f |"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2188
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_BandPixelType\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2194
+#, no-c-format
+msgid "ST_BandNoDataValue"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2195
+#, no-c-format
+msgid ""
+"Returns the value in a given band that represents no data. If no band num 1 "
+"is assumed."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2200
+#, no-c-format
+msgid ""
+"<funcdef>double precision <function>ST_BandNoDataValue</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>bandnum=1</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2211 reference_raster.xml:2342
+#, no-c-format
+msgid "Returns the value that represents no data for the band"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2217
+#, no-c-format
+msgid ""
+"SELECT ST_BandNoDataValue(rast,1) As bnval1, \n"
+" ST_BandNoDataValue(rast,2) As bnval2, ST_BandNoDataValue(rast,3) As "
+"bnval3\n"
+"FROM dummy_rast\n"
+"WHERE rid = 2;\n"
+"\n"
+" bnval1 | bnval2 | bnval3\n"
+"--------+--------+--------\n"
+" 0 | 0 | 0"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2230
+#, no-c-format
+msgid "ST_BandIsNoData"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2231
+#, no-c-format
+msgid "Returns true if the band is filled with only nodata values."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:2235
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_BandIsNoData</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>band</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>forceChecking=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>boolean <function>ST_BandIsNoData</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>forceChecking=true</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2252
+#, no-c-format
+msgid ""
+"Returns true if the band is filled with only nodata values. Band 1 is "
+"assumed if not specified. If the last argument is TRUE, the entire band is "
+"checked pixel by pixel. Otherwise, the function simply returns the value of "
+"the isnodata flag for the band. The default value for this parameter is "
+"FALSE, if not specified."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2262
+#, no-c-format
+msgid ""
+"If the flag is dirty (this is, the result is different using TRUE as last "
+"parameter and not using it) you should update the raster to set this flag to "
+"true, by using ST_SetBandIsNodata function, or ST_SetBandNodataValue "
+"function with TRUE as last argument. The loader (raster2pgsql.py) currently "
+"can not properly set the flag while loading raster data. See <xref linkend="
+"\"RT_ST_SetBandIsNoData\"/>."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2275
+#, no-c-format
+msgid ""
+"-- Create dummy table with one raster column\n"
+"create table dummy_rast (rid integer, rast raster);\n"
+"\n"
+"-- Add raster with two bands, one pixel/band. In the first band, nodatavalue "
+"= pixel value = 3.\n"
+"-- In the second band, nodatavalue = 13, pixel value = 4\n"
+"insert into dummy_rast values(1,\n"
+"(\n"
+"'01' -- little endian (uint8 ndr)\n"
+"|| \n"
+"'0000' -- version (uint16 0)\n"
+"||\n"
+"'0200' -- nBands (uint16 0)\n"
+"||\n"
+"'17263529ED684A3F' -- scaleX (float64 0.000805965234044584)\n"
+"||\n"
+"'F9253529ED684ABF' -- scaleY (float64 -0.00080596523404458)\n"
+"||\n"
+"'1C9F33CE69E352C0' -- ipX (float64 -75.5533328537098)\n"
+"||\n"
+"'718F0E9A27A44840' -- ipY (float64 49.2824585505576)\n"
+"||\n"
+"'ED50EB853EC32B3F' -- skewX (float64 0.000211812383858707)\n"
+"||\n"
+"'7550EB853EC32B3F' -- skewY (float64 0.000211812383858704)\n"
+"||\n"
+"'E6100000' -- SRID (int32 4326)\n"
+"||\n"
+"'0100' -- width (uint16 1)\n"
+"||\n"
+"'0100' -- height (uint16 1)\n"
+"||\n"
+"'6' -- hasnodatavalue and isnodata value set to true.\n"
+"||\n"
+"'2' -- first band type (4BUI) \n"
+"||\n"
+"'03' -- novalue==3\n"
+"||\n"
+"'03' -- pixel(0,0)==3 (same that nodata)\n"
+"||\n"
+"'0' -- hasnodatavalue set to false\n"
+"||\n"
+"'5' -- second band type (16BSI)\n"
+"||\n"
+"'0D00' -- novalue==13\n"
+"||\n"
+"'0400' -- pixel(0,0)==4\n"
+")::raster\n"
+");\n"
+"\n"
+"select st_bandisnodata(rast, 1) from dummy_rast where rid = 1; -- Expected "
+"true\n"
+"select st_bandisnodata(rast, 2) from dummy_rast where rid = 1; -- Expected "
+"false"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2281
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_NumBands\"/>, <xref linkend="
+"\"RT_ST_SetBandNoDataValue\"/>, <xref linkend=\"RT_ST_SetBandIsNoData\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2290
+#, no-c-format
+msgid "ST_BandPath"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2291
+#, no-c-format
+msgid ""
+"Returns system file path to a band stored in file system. If no bandnum "
+"specified, 1 is assumed."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2296
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_BandPath</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>bandnum=1</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2307
+#, no-c-format
+msgid ""
+"Returns system file path to a band. Throws an error if called with an in db "
+"band."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2313
+#, no-c-format
+msgid "<!-- TODO: -->"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2325
+#, no-c-format
+msgid "ST_BandPixelType"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2326
+#, no-c-format
+msgid ""
+"Returns the type of pixel for given band. If no bandnum specified, 1 is "
+"assumed."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2331
+#, no-c-format
+msgid ""
+"<funcdef>text <function>ST_BandPixelType</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>bandnum=1</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2343
+#, no-c-format
+msgid "There are 11 pixel types. Pixel Types supported are as follows:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2346
+#, no-c-format
+msgid "1BB - 1-bit boolean"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2350
+#, no-c-format
+msgid "2BUI - 2-bit unsigned integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2354
+#, no-c-format
+msgid "4BUI - 4-bit unsigned integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2358
+#, no-c-format
+msgid "8BSI - 8-bit signed integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2361
+#, no-c-format
+msgid "8BUI - 8-bit unsigned integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2364
+#, no-c-format
+msgid "16BSI - 16-bit signed integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2367
+#, no-c-format
+msgid "16BUI - 16-bit unsigned integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2370
+#, no-c-format
+msgid "32BSI - 32-bit signed integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2373
+#, no-c-format
+msgid "32BUI - 32-bit unsigned integer"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2376
+#, no-c-format
+msgid "32BF - 32-bit float"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2379
+#, no-c-format
+msgid "64BF - 64-bit float"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2388
+#, no-c-format
+msgid ""
+"SELECT ST_BandPixelType(rast,1) As btype1, \n"
+" ST_BandPixelType(rast,2) As btype2, ST_BandPixelType(rast,3) As btype3\n"
+"FROM dummy_rast\n"
+"WHERE rid = 2;\n"
+"\n"
+" btype1 | btype2 | btype3\n"
+"--------+--------+--------\n"
+" 8BUI | 8BUI | 8BUI"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2400
+#, no-c-format
+msgid "ST_HasNoBand"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2401
+#, no-c-format
+msgid ""
+"<refpurpose>Returns true if there is no band with given band number. If no "
+"band number is specified, then band number 1 is assumed.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2406
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_HasNoBand</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>bandnum=1</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2417
+#, no-c-format
+msgid ""
+"<para>Returns true if there is no band with given band number. If no band "
+"number is specified, then band number 1 is assumed.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2425
+#, no-c-format
+msgid ""
+"SELECT rid, ST_HasNoBand(rast) As hb1, ST_HasNoBand(rast,2) as hb2, \n"
+"ST_HasNoBand(rast,4) as hb4, ST_NumBands(rast) As numbands \n"
+"FROM dummy_rast;\n"
+"\n"
+"rid | hb1 | hb2 | hb4 | numbands\n"
+"-----+-----+-----+-----+----------\n"
+"1 | t | t | t | 0\n"
+"2 | f | f | t | 3"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:2438
+#, no-c-format
+msgid "Raster Pixel Accessors and Setters"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2442
+#, no-c-format
+msgid "ST_PixelAsPolygon"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2443
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the polygon geometry that bounds the pixel for a "
+"particular row and column.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2448
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PixelAsPolygon</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>columnx</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>rowy</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2460
+#, no-c-format
+msgid ""
+"<para>Returns the polygon geometry that bounds the pixel for a particular "
+"row and column.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2468
+#, no-c-format
+msgid ""
+"-- get raster pixel polygon\n"
+"SELECT i,j, ST_AsText(ST_PixelAsPolygon(foo.rast, i,j)) As b1pgeom\n"
+"FROM dummy_rast As foo \n"
+" CROSS JOIN generate_series(1,2) As i \n"
+" CROSS JOIN generate_series(1,1) As j\n"
+"WHERE rid=2;\n"
+"\n"
+" i | j | b1pgeom\n"
+"---+---"
+"+-----------------------------------------------------------------------------\n"
+" 1 | 1 | POLYGON((3427927.75 5793244,3427927.8 5793244,3427927.8 "
+"5793243.95,...\n"
+" 2 | 1 | POLYGON((3427927.8 5793244,3427927.85 5793244,3427927.85 "
+"5793243.95, .."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2473
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_PixelAsPolygons\"/>, <xref linkend="
+"\"RT_ST_PixelAsPoint\"/>, <xref linkend=\"RT_ST_PixelAsPoints\"/>, <xref "
+"linkend=\"RT_ST_PixelAsCentroid\"/>, <xref linkend=\"RT_ST_PixelAsCentroids"
+"\"/>, <xref linkend=\"RT_ST_Intersection\"/>, <xref linkend=\"ST_AsText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2488
+#, no-c-format
+msgid "ST_PixelAsPolygons"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2489
+#, no-c-format
+msgid ""
+"Returns the polygon geometry that bounds every pixel of a raster band along "
+"with the value, the X and the Y raster coordinates of each pixel."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2494
+#, no-c-format
+msgid ""
+"<funcdef>setof record <function>ST_PixelAsPolygons</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>band=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=TRUE</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2506
+#, no-c-format
+msgid ""
+"Returns the polygon geometry that bounds every pixel of a raster band along "
+"with the value (double precision), the X and the Y raster coordinates "
+"(integers) of each pixel."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2509
+#, no-c-format
+msgid ""
+"ST_PixelAsPolygons returns one polygon geometry for every pixel. This is "
+"different than ST_DumpAsPolygons where each geometry represents one or more "
+"pixels with the same pixel value."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2515
+#, no-c-format
+msgid "Enhanced: 2.1.0 exclude_nodata_value optional argument was added."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2520
+#, no-c-format
+msgid ""
+"-- get raster pixel polygon\n"
+"SELECT (gv).x, (gv).y, (gv).val, ST_AsText((gv).geom) geom\n"
+"FROM (SELECT ST_PixelAsPolygons(\n"
+" ST_SetValue(ST_SetValue(ST_AddBand(ST_MakeEmptyRaster(2, 2, "
+"0, 0, 0.001, -0.001, 0.001, 0.001, 4269), \n"
+" '8BUI'::text, 1, 0), \n"
+" 2, 2, 10), \n"
+" 1, 1, NULL)\n"
+") gv \n"
+") foo;\n"
+"\n"
+" x | y | val | geom\n"
+"---+---"
+"+-----------------------------------------------------------------------------\n"
+" 1 | 1 | | POLYGON((0 0,0.001 0.001,0.002 0,0.001 -0.001,0 0))\n"
+" 1 | 2 | 1 | POLYGON((0.001 -0.001,0.002 0,0.003 -0.001,0.002 -0.002,0.001 "
+"-0.001))\n"
+" 2 | 1 | 1 | POLYGON((0.001 0.001,0.002 0.002,0.003 0.001,0.002 0,0.001 "
+"0.001))\n"
+" 2 | 2 | 10 | POLYGON((0.002 0,0.003 0.001,0.004 0,0.003 -0.001,0.002 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2525
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_PixelAsPolygon\"/>, <xref linkend="
+"\"RT_ST_PixelAsPoint\"/>, <xref linkend=\"RT_ST_PixelAsPoints\"/>, <xref "
+"linkend=\"RT_ST_PixelAsCentroid\"/>, <xref linkend=\"RT_ST_PixelAsCentroids"
+"\"/>, <xref linkend=\"ST_AsText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2539
+#, no-c-format
+msgid "ST_PixelAsPoint"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2540
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a point geometry of the pixel's upper-left corner.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2546
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PixelAsPoint</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>columnx</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>rowy</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2557
+#, no-c-format
+msgid "<para>Returns a point geometry of the pixel's upper-left corner.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2563
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_PixelAsPoint(rast, 1, 1)) FROM dummy_rast WHERE rid = "
+"1;\n"
+"\n"
+" st_astext \n"
+"----------------\n"
+" POINT(0.5 0.5)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2568
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_PixelAsPolygon\"/>, <xref linkend="
+"\"RT_ST_PixelAsPolygons\"/>, <xref linkend=\"RT_ST_PixelAsPoints\"/>, <xref "
+"linkend=\"RT_ST_PixelAsCentroid\"/>, <xref linkend=\"RT_ST_PixelAsCentroids"
+"\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2582
+#, no-c-format
+msgid "ST_PixelAsPoints"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2583
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a point geometry for each pixel of a raster band along "
+"with the value, the X and the Y raster coordinates of each pixel. The "
+"coordinates of the point geometry are of the pixel's upper-left corner.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2589
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PixelAsPoints</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>band=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=TRUE</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2600
+#, no-c-format
+msgid ""
+"<para>Returns a point geometry for each pixel of a raster band along with "
+"the value, the X and the Y raster coordinates of each pixel. The coordinates "
+"of the point geometry are of the pixel's upper-left corner.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2608
+#, no-c-format
+msgid ""
+"SELECT x, y, val, ST_AsText(geom) FROM (SELECT (ST_PixelAsPoints(rast, 1)).* "
+"FROM dummy_rast WHERE rid = 2) foo;\n"
+"\n"
+" x | y | val | st_astext \n"
+"---+---+-----+------------------------------\n"
+" 1 | 1 | 253 | POINT(3427927.75 5793244)\n"
+" 2 | 1 | 254 | POINT(3427927.8 5793244)\n"
+" 3 | 1 | 253 | POINT(3427927.85 5793244)\n"
+" 4 | 1 | 254 | POINT(3427927.9 5793244)\n"
+" 5 | 1 | 254 | POINT(3427927.95 5793244)\n"
+" 1 | 2 | 253 | POINT(3427927.75 5793243.95)\n"
+" 2 | 2 | 254 | POINT(3427927.8 5793243.95)\n"
+" 3 | 2 | 254 | POINT(3427927.85 5793243.95)\n"
+" 4 | 2 | 253 | POINT(3427927.9 5793243.95)\n"
+" 5 | 2 | 249 | POINT(3427927.95 5793243.95)\n"
+" 1 | 3 | 250 | POINT(3427927.75 5793243.9)\n"
+" 2 | 3 | 254 | POINT(3427927.8 5793243.9)\n"
+" 3 | 3 | 254 | POINT(3427927.85 5793243.9)\n"
+" 4 | 3 | 252 | POINT(3427927.9 5793243.9)\n"
+" 5 | 3 | 249 | POINT(3427927.95 5793243.9)\n"
+" 1 | 4 | 251 | POINT(3427927.75 5793243.85)\n"
+" 2 | 4 | 253 | POINT(3427927.8 5793243.85)\n"
+" 3 | 4 | 254 | POINT(3427927.85 5793243.85)\n"
+" 4 | 4 | 254 | POINT(3427927.9 5793243.85)\n"
+" 5 | 4 | 253 | POINT(3427927.95 5793243.85)\n"
+" 1 | 5 | 252 | POINT(3427927.75 5793243.8)\n"
+" 2 | 5 | 250 | POINT(3427927.8 5793243.8)\n"
+" 3 | 5 | 254 | POINT(3427927.85 5793243.8)\n"
+" 4 | 5 | 254 | POINT(3427927.9 5793243.8)\n"
+" 5 | 5 | 254 | POINT(3427927.95 5793243.8)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2613
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_PixelAsPolygon\"/>, <xref linkend="
+"\"RT_ST_PixelAsPolygons\"/>, <xref linkend=\"RT_ST_PixelAsPoint\"/>, <xref "
+"linkend=\"RT_ST_PixelAsCentroid\"/>, <xref linkend=\"RT_ST_PixelAsCentroids"
+"\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2627
+#, no-c-format
+msgid "ST_PixelAsCentroid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2628
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the centroid (point geometry) of the area represented by "
+"a pixel.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2634
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PixelAsCentroid</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>columnx</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>rowy</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2645
+#, no-c-format
+msgid ""
+"<para>Returns the centroid (point geometry) of the area represented by a "
+"pixel.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2651
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(ST_PixelAsCentroid(rast, 1, 1)) FROM dummy_rast WHERE rid = "
+"1;\n"
+"\n"
+" st_astext \n"
+"--------------\n"
+" POINT(1.5 2)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2656
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_PixelAsPolygon\"/>, <xref linkend="
+"\"RT_ST_PixelAsPolygons\"/>, <xref linkend=\"RT_ST_PixelAsPoint\"/>, <xref "
+"linkend=\"RT_ST_PixelAsPoints\"/>, <xref linkend=\"RT_ST_PixelAsCentroids\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2670
+#, no-c-format
+msgid "ST_PixelAsCentroids"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2671
+#, no-c-format
+msgid ""
+"<refpurpose>Returns the centroid (point geometry) for each pixel of a raster "
+"band along with the value, the X and the Y raster coordinates of each pixel. "
+"The point geometry is the centroid of the area represented by a pixel.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:2677
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_PixelAsCentroids</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>band=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=TRUE</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2688
+#, no-c-format
+msgid ""
+"<para>Returns the centroid (point geometry) for each pixel of a raster band "
+"along with the value, the X and the Y raster coordinates of each pixel. The "
+"point geometry is the centroid of the area represented by a pixel.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2696
+#, no-c-format
+msgid ""
+"SELECT x, y, val, ST_AsText(geom) FROM (SELECT (ST_PixelAsCentroids(rast, "
+"1)).* FROM dummy_rast WHERE rid = 2) foo;\n"
+" x | y | val | st_astext \n"
+"---+---+-----+--------------------------------\n"
+" 1 | 1 | 253 | POINT(3427927.775 5793243.975)\n"
+" 2 | 1 | 254 | POINT(3427927.825 5793243.975)\n"
+" 3 | 1 | 253 | POINT(3427927.875 5793243.975)\n"
+" 4 | 1 | 254 | POINT(3427927.925 5793243.975)\n"
+" 5 | 1 | 254 | POINT(3427927.975 5793243.975)\n"
+" 1 | 2 | 253 | POINT(3427927.775 5793243.925)\n"
+" 2 | 2 | 254 | POINT(3427927.825 5793243.925)\n"
+" 3 | 2 | 254 | POINT(3427927.875 5793243.925)\n"
+" 4 | 2 | 253 | POINT(3427927.925 5793243.925)\n"
+" 5 | 2 | 249 | POINT(3427927.975 5793243.925)\n"
+" 1 | 3 | 250 | POINT(3427927.775 5793243.875)\n"
+" 2 | 3 | 254 | POINT(3427927.825 5793243.875)\n"
+" 3 | 3 | 254 | POINT(3427927.875 5793243.875)\n"
+" 4 | 3 | 252 | POINT(3427927.925 5793243.875)\n"
+" 5 | 3 | 249 | POINT(3427927.975 5793243.875)\n"
+" 1 | 4 | 251 | POINT(3427927.775 5793243.825)\n"
+" 2 | 4 | 253 | POINT(3427927.825 5793243.825)\n"
+" 3 | 4 | 254 | POINT(3427927.875 5793243.825)\n"
+" 4 | 4 | 254 | POINT(3427927.925 5793243.825)\n"
+" 5 | 4 | 253 | POINT(3427927.975 5793243.825)\n"
+" 1 | 5 | 252 | POINT(3427927.775 5793243.775)\n"
+" 2 | 5 | 250 | POINT(3427927.825 5793243.775)\n"
+" 3 | 5 | 254 | POINT(3427927.875 5793243.775)\n"
+" 4 | 5 | 254 | POINT(3427927.925 5793243.775)\n"
+" 5 | 5 | 254 | POINT(3427927.975 5793243.775)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2701
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_PixelAsPolygon\"/>, <xref linkend="
+"\"RT_ST_PixelAsPolygons\"/>, <xref linkend=\"RT_ST_PixelAsPoint\"/>, <xref "
+"linkend=\"RT_ST_PixelAsPoints\"/>, <xref linkend=\"RT_ST_PixelAsCentroid\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2715
+#, no-c-format
+msgid "ST_Value"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2716
+#, no-c-format
+msgid ""
+"Returns the value of a given band in a given columnx, rowy pixel or at a "
+"particular geometric point. Band numbers start at 1 and assumed to be 1 if "
+"not specified. If <varname>exclude_nodata_value</varname> is set to false, "
+"then all pixels include <varname>nodata</varname> pixels are considered to "
+"intersect and return value. If <varname>exclude_nodata_value</varname> is "
+"not passed in then reads it from metadata of raster."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:2720
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>double precision <function>ST_Value</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>pt</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision <function>ST_Value</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>bandnum</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>pt</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision <function>ST_Value</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>columnx</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>rowy</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision <function>ST_Value</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>bandnum</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>columnx</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>rowy</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2755
+#, no-c-format
+msgid ""
+"Returns the value of a given band in a given columnx, rowy pixel or at a "
+"given geometry point. Band numbers start at 1 and band is assumed to be 1 if "
+"not specified. If <varname>exclude_nodata_value</varname> is set to true, "
+"then only non <varname>nodata</varname> pixels are considered. If "
+"<varname>exclude_nodata_value</varname> is set to false, then all pixels are "
+"considered."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2758
+#, no-c-format
+msgid "Enhanced: 2.0.0 exclude_nodata_value optional argument was added."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2763
+#, no-c-format
+msgid ""
+"-- get raster values at particular postgis geometry points\n"
+"-- the srid of your geometry should be same as for your raster\n"
+"SELECT rid, ST_Value(rast, foo.pt_geom) As b1pval, ST_Value(rast, 2, foo."
+"pt_geom) As b2pval\n"
+"FROM dummy_rast CROSS JOIN (SELECT ST_SetSRID(ST_Point(3427927.77, "
+"5793243.76), 0) As pt_geom) As foo\n"
+"WHERE rid=2;\n"
+"\n"
+" rid | b1pval | b2pval\n"
+"-----+--------+--------\n"
+" 2 | 252 | 79\n"
+" \n"
+" \n"
+"-- general fictitious example using a real table\n"
+"SELECT rid, ST_Value(rast, 3, sometable.geom) As b3pval\n"
+"FROM sometable\n"
+"WHERE ST_Intersects(rast,sometable.geom);"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2764
+#, no-c-format
+msgid ""
+"SELECT rid, ST_Value(rast, 1, 1, 1) As b1pval, \n"
+" ST_Value(rast, 2, 1, 1) As b2pval, ST_Value(rast, 3, 1, 1) As b3pval\n"
+"FROM dummy_rast\n"
+"WHERE rid=2;\n"
+"\n"
+" rid | b1pval | b2pval | b3pval\n"
+"-----+--------+--------+--------\n"
+" 2 | 253 | 78 | 70"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2766
+#, no-c-format
+msgid ""
+"--- Get all values in bands 1,2,3 of each pixel --\n"
+"SELECT x, y, ST_Value(rast, 1, x, y) As b1val, \n"
+" ST_Value(rast, 2, x, y) As b2val, ST_Value(rast, 3, x, y) As b3val\n"
+"FROM dummy_rast CROSS JOIN\n"
+"generate_series(1, 1000) As x CROSS JOIN generate_series(1, 1000) As y\n"
+"WHERE rid = 2 AND x <= ST_Width(rast) AND y <= ST_Height(rast);\n"
+"\n"
+" x | y | b1val | b2val | b3val\n"
+"---+---+-------+-------+-------\n"
+" 1 | 1 | 253 | 78 | 70\n"
+" 1 | 2 | 253 | 96 | 80\n"
+" 1 | 3 | 250 | 99 | 90\n"
+" 1 | 4 | 251 | 89 | 77\n"
+" 1 | 5 | 252 | 79 | 62\n"
+" 2 | 1 | 254 | 98 | 86\n"
+" 2 | 2 | 254 | 118 | 108\n"
+" :\n"
+" :"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2768
+#, no-c-format
+msgid ""
+"--- Get all values in bands 1,2,3 of each pixel same as above but returning "
+"the upper left point point of each pixel --\n"
+"SELECT ST_AsText(ST_SetSRID(\n"
+" ST_Point(ST_UpperLeftX(rast) + ST_ScaleX(rast)*x, \n"
+" ST_UpperLeftY(rast) + ST_ScaleY(rast)*y), \n"
+" ST_SRID(rast))) As uplpt\n"
+" , ST_Value(rast, 1, x, y) As b1val, \n"
+" ST_Value(rast, 2, x, y) As b2val, ST_Value(rast, 3, x, y) As b3val\n"
+"FROM dummy_rast CROSS JOIN\n"
+"generate_series(1,1000) As x CROSS JOIN generate_series(1,1000) As y\n"
+"WHERE rid = 2 AND x <= ST_Width(rast) AND y <= ST_Height(rast);\n"
+"\n"
+" uplpt | b1val | b2val | b3val\n"
+"-----------------------------+-------+-------+-------\n"
+" POINT(3427929.25 5793245.5) | 253 | 78 | 70\n"
+" POINT(3427929.25 5793247) | 253 | 96 | 80\n"
+" POINT(3427929.25 5793248.5) | 250 | 99 | 90\n"
+":"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2769
+#, no-c-format
+msgid ""
+"--- Get a polygon formed by union of all pixels \n"
+" that fall in a particular value range and intersect particular "
+"polygon --\n"
+"SELECT ST_AsText(ST_Union(pixpolyg)) As shadow\n"
+"FROM (SELECT ST_Translate(ST_MakeEnvelope(\n"
+" ST_UpperLeftX(rast), ST_UpperLeftY(rast), \n"
+" ST_UpperLeftX(rast) + ST_ScaleX(rast),\n"
+" ST_UpperLeftY(rast) + ST_ScaleY(rast), 0\n"
+" ), ST_ScaleX(rast)*x, ST_ScaleY(rast)*y\n"
+" ) As pixpolyg, ST_Value(rast, 2, x, y) As b2val\n"
+" FROM dummy_rast CROSS JOIN\n"
+"generate_series(1,1000) As x CROSS JOIN generate_series(1,1000) As y\n"
+"WHERE rid = 2 \n"
+" AND x <= ST_Width(rast) AND y <= ST_Height(rast)) As foo\n"
+"WHERE \n"
+" ST_Intersects(\n"
+" pixpolyg, \n"
+" ST_GeomFromText('POLYGON((3427928 5793244,3427927.75 "
+"5793243.75,3427928 5793243.75,3427928 5793244))',0)\n"
+" ) AND b2val != 254;\n"
+"\n"
+"\n"
+" shadow\n"
+"------------------------------------------------------------------------------------\n"
+" MULTIPOLYGON(((3427928 5793243.9,3427928 5793243.85,3427927.95 "
+"5793243.85,3427927.95 5793243.9,\n"
+" 3427927.95 5793243.95,3427928 5793243.95,3427928.05 5793243.95,3427928.05 "
+"5793243.9,3427928 5793243.9)),((3427927.95 5793243.9,3427927.95 579324\n"
+"3.85,3427927.9 5793243.85,3427927.85 5793243.85,3427927.85 "
+"5793243.9,3427927.9 5793243.9,3427927.9 5793243.95,\n"
+"3427927.95 5793243.95,3427927.95 5793243.9)),((3427927.85 "
+"5793243.75,3427927.85 5793243.7,3427927.8 5793243.7,3427927.8 5793243.75\n"
+",3427927.8 5793243.8,3427927.8 5793243.85,3427927.85 5793243.85,3427927.85 "
+"5793243.8,3427927.85 5793243.75)),\n"
+"((3427928.05 5793243.75,3427928.05 5793243.7,3427928 5793243.7,3427927.95 "
+"5793243.7,3427927.95 5793243.75,3427927.95 5793243.8,3427\n"
+"927.95 5793243.85,3427928 5793243.85,3427928 5793243.8,3427928.05 "
+"5793243.8,\n"
+"3427928.05 5793243.75)),((3427927.95 5793243.75,3427927.95 "
+"5793243.7,3427927.9 5793243.7,3427927.85 5793243.7,\n"
+"3427927.85 5793243.75,3427927.85 5793243.8,3427927.85 5793243.85,3427927.9 "
+"5793243.85,\n"
+"3427927.95 5793243.85,3427927.95 5793243.8,3427927.95 5793243.75)))"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2771
+#, no-c-format
+msgid ""
+"--- Checking all the pixels of a large raster tile can take a long time.\n"
+"--- You can dramatically improve speed at some lose of precision by orders "
+"of magnitude \n"
+"-- by sampling pixels using the step optional parameter of "
+"generate_series. \n"
+"-- This next example does the same as previous but by checking 1 for every "
+"4 (2x2) pixels and putting in the last checked\n"
+"-- putting in the checked pixel as the value for subsequent 4\n"
+" \n"
+"SELECT ST_AsText(ST_Union(pixpolyg)) As shadow\n"
+"FROM (SELECT ST_Translate(ST_MakeEnvelope(\n"
+" ST_UpperLeftX(rast), ST_UpperLeftY(rast), \n"
+" ST_UpperLeftX(rast) + ST_ScaleX(rast)*2,\n"
+" ST_UpperLeftY(rast) + ST_ScaleY(rast)*2, 0\n"
+" ), ST_ScaleX(rast)*x, ST_ScaleY(rast)*y\n"
+" ) As pixpolyg, ST_Value(rast, 2, x, y) As b2val\n"
+" FROM dummy_rast CROSS JOIN\n"
+"generate_series(1,1000,2) As x CROSS JOIN generate_series(1,1000,2) As y\n"
+"WHERE rid = 2 \n"
+" AND x <= ST_Width(rast) AND y <= ST_Height(rast) ) As foo\n"
+"WHERE \n"
+" ST_Intersects(\n"
+" pixpolyg, \n"
+" ST_GeomFromText('POLYGON((3427928 5793244,3427927.75 "
+"5793243.75,3427928 5793243.75,3427928 5793244))',0)\n"
+" ) AND b2val != 254;\n"
+"\n"
+" shadow\n"
+"------------------------------------------------------------------------------------\n"
+" MULTIPOLYGON(((3427927.9 5793243.85,3427927.8 5793243.85,3427927.8 "
+"5793243.95,\n"
+" 3427927.9 5793243.95,3427928 5793243.95,3427928.1 5793243.95,3427928.1 "
+"5793243.85,3427928 5793243.85,3427927.9 5793243.85)),\n"
+" ((3427927.9 5793243.65,3427927.8 5793243.65,3427927.8 5793243.75,3427927.8 "
+"5793243.85,3427927.9 5793243.85,\n"
+" 3427928 5793243.85,3427928 5793243.75,3427928.1 5793243.75,3427928.1 "
+"5793243.65,3427928 5793243.65,3427927.9 5793243.65)))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2776
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_NumBands\"/>, <xref linkend=\"RT_ST_PixelAsPolygon\"/"
+">, <xref linkend=\"RT_ST_ScaleX\"/>, , <xref linkend=\"RT_ST_ScaleY\"/>, "
+"<xref linkend=\"RT_ST_UpperLeftX\"/>, <xref linkend=\"RT_ST_UpperLeftY\"/>, "
+"<xref linkend=\"RT_ST_SRID\"/>, <xref linkend=\"ST_AsText\"/>, , <xref "
+"linkend=\"ST_Point\"/>, <xref linkend=\"ST_MakeEnvelope\"/>, <xref linkend="
+"\"ST_Intersects\"/>, <xref linkend=\"ST_Intersection\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2786
+#, no-c-format
+msgid "ST_NearestValue"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2787
+#, no-c-format
+msgid ""
+"Returns the nearest non-<varname>NODATA</varname> value of a given band's "
+"pixel specified by a columnx and rowy or a geometric point expressed in the "
+"same spatial reference coordinate system as the raster."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:2793
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>double precision <function>ST_NearestValue</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>bandnum</"
+"parameter></paramdef> <paramdef><type>geometry </type> <parameter>pt</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision <function>ST_NearestValue</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>geometry </type> <parameter>pt</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision <function>ST_NearestValue</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>bandnum</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>columnx</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>rowy</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision <function>ST_NearestValue</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>columnx</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>rowy</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2830
+#, no-c-format
+msgid ""
+"Returns the nearest non-<varname>NODATA</varname> value of a given band in a "
+"given columnx, rowy pixel or at a specific geometric point. If the columnx, "
+"rowy pixel or the pixel at the specified geometric point is <varname>NODATA</"
+"varname>, the function will find the nearest pixel to the columnx, rowy "
+"pixel or geometric point whose value is not <varname>NODATA</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2833 reference_raster.xml:2920
+#, no-c-format
+msgid ""
+"Band numbers start at 1 and <varname>bandnum</varname> is assumed to be 1 if "
+"not specified. If <varname>exclude_nodata_value</varname> is set to false, "
+"then all pixels include <varname>nodata</varname> pixels are considered to "
+"intersect and return value. If <varname>exclude_nodata_value</varname> is "
+"not passed in then reads it from metadata of raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2838
+#, no-c-format
+msgid "ST_NearestValue is a drop-in replacement for ST_Value."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2847
+#, no-c-format
+msgid ""
+"-- pixel 2x2 has value\n"
+"SELECT\n"
+" ST_Value(rast, 2, 2) AS value,\n"
+" ST_NearestValue(rast, 2, 2) AS nearestvalue\n"
+"FROM (\n"
+" SELECT\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(5, "
+"5, -2, 2, 1, -1, 0, 0, 0),\n"
+" '8BUI'::"
+"text, 1, 0\n"
+" ),\n"
+" 1, 1, 0.\n"
+" ),\n"
+" 2, 3, 0.\n"
+" ),\n"
+" 3, 5, 0.\n"
+" ),\n"
+" 4, 2, 0.\n"
+" ),\n"
+" 5, 4, 0.\n"
+" ) AS rast\n"
+") AS foo\n"
+"\n"
+" value | nearestvalue \n"
+"-------+--------------\n"
+" 1 | 1"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2849
+#, no-c-format
+msgid ""
+"-- pixel 2x3 is NODATA\n"
+"SELECT\n"
+" ST_Value(rast, 2, 3) AS value,\n"
+" ST_NearestValue(rast, 2, 3) AS nearestvalue\n"
+"FROM (\n"
+" SELECT\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(5, "
+"5, -2, 2, 1, -1, 0, 0, 0),\n"
+" '8BUI'::"
+"text, 1, 0\n"
+" ),\n"
+" 1, 1, 0.\n"
+" ),\n"
+" 2, 3, 0.\n"
+" ),\n"
+" 3, 5, 0.\n"
+" ),\n"
+" 4, 2, 0.\n"
+" ),\n"
+" 5, 4, 0.\n"
+" ) AS rast\n"
+") AS foo\n"
+"\n"
+" value | nearestvalue \n"
+"-------+--------------\n"
+" | 1"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2855
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Value\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2865
+#, no-c-format
+msgid "ST_Neighborhood"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2866
+#, no-c-format
+msgid ""
+"Returns a 2-D double precision array of the non-<varname>NODATA</varname> "
+"values around a given band's pixel specified by either a columnX and rowY or "
+"a geometric point expressed in the same spatial reference coordinate system "
+"as the raster."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:2872
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>double precision[][] <function>ST_Neighborhood</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>bandnum</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>columnX</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>rowY</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceX</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceY</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision[][] <function>ST_Neighborhood</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>columnX</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>rowY</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceX</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceY</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision[][] <function>ST_Neighborhood</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>bandnum</"
+"parameter></paramdef> <paramdef><type>geometry </type> <parameter>pt</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceX</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceY</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision[][] <function>ST_Neighborhood</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>geometry </type> <parameter>pt</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceX</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>distanceY</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2917
+#, no-c-format
+msgid ""
+"Returns a 2-D double precision array of the non-<varname>NODATA</varname> "
+"values around a given band's pixel specified by either a columnX and rowY or "
+"a geometric point expressed in the same spatial reference coordinate system "
+"as the raster. The <varname>distanceX</varname> and <varname>distanceY</"
+"varname> parameters define the number of pixels around the specified pixel "
+"in the X and Y axes, e.g. I want all values within 3 pixel distance along "
+"the X axis and 2 pixel distance along the Y axis around my pixel of "
+"interest. The center value of the 2-D array will be the value at the pixel "
+"specified by the columnX and rowY or the geometric point."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2924
+#, no-c-format
+msgid ""
+"The number of elements along each axis of the returning 2-D array is 2 * "
+"(<varname>distanceX</varname>|<varname>distanceY</varname>) + 1. So for a "
+"<varname>distanceX</varname> and <varname>distanceY</varname> of 1, the "
+"returning array will be 3x3."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2929
+#, no-c-format
+msgid ""
+"The 2-D array output can be passed along to any of the raster processing "
+"builtin functions, e.g. ST_Min4ma, ST_Sum4ma, ST_Mean4ma."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2939
+#, no-c-format
+msgid ""
+"-- pixel 2x2 has value\n"
+"SELECT\n"
+" ST_Neighborhood(rast, 2, 2, 1, 1)\n"
+"FROM (\n"
+" SELECT\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, "
+"0),\n"
+" '8BUI'::text, 1, 0\n"
+" ),\n"
+" 1, 1, 1, ARRAY[\n"
+" [0, 1, 1, 1, 1],\n"
+" [1, 1, 1, 0, 1],\n"
+" [1, 0, 1, 1, 1],\n"
+" [1, 1, 1, 1, 0],\n"
+" [1, 1, 0, 1, 1]\n"
+" ]::double precision[],\n"
+" 1\n"
+" ) AS rast\n"
+") AS foo\n"
+"\n"
+" st_neighborhood \n"
+"---------------------------------\n"
+" {{NULL,1,1},{1,1,NULL},{1,1,1}}"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2941
+#, no-c-format
+msgid ""
+"-- pixel 2x3 is NODATA\n"
+"SELECT\n"
+" ST_Neighborhood(rast, 2, 3, 1, 1)\n"
+"FROM (\n"
+" SELECT\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, "
+"0),\n"
+" '8BUI'::text, 1, 0\n"
+" ),\n"
+" 1, 1, 1, ARRAY[\n"
+" [0, 1, 1, 1, 1],\n"
+" [1, 1, 1, 0, 1],\n"
+" [1, 0, 1, 1, 1],\n"
+" [1, 1, 1, 1, 0],\n"
+" [1, 1, 0, 1, 1]\n"
+" ]::double precision[],\n"
+" 1\n"
+" ) AS rast\n"
+") AS foo\n"
+"\n"
+" st_neighborhood \n"
+"------------------------------\n"
+" {{1,1,1},{1,NULL,1},{1,1,1}}"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:2943
+#, no-c-format
+msgid ""
+"-- pixel 3x3 has value\n"
+"-- exclude_nodata_value = FALSE\n"
+"SELECT\n"
+" ST_Neighborhood(rast, 3, 3, 1, 1, false)\n"
+"FROM (\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, "
+"0),\n"
+" '8BUI'::text, 1, 0\n"
+" ),\n"
+" 1, 1, 1, ARRAY[\n"
+" [0, 1, 1, 1, 1],\n"
+" [1, 1, 1, 0, 1],\n"
+" [1, 0, 1, 1, 1],\n"
+" [1, 1, 1, 1, 0],\n"
+" [1, 1, 0, 1, 1]\n"
+" ]::double precision[],\n"
+" 1\n"
+" ) AS rast\n"
+") AS foo\n"
+"\n"
+" st_neighborhood \n"
+"---------------------------\n"
+" {{1,0,1},{1,1,1},{0,1,1}}"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:2949
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Min4ma\"/>, <xref linkend=\"RT_ST_Max4ma\"/>, <xref "
+"linkend=\"RT_ST_Sum4ma\"/>, <xref linkend=\"RT_ST_Mean4ma\"/>, <xref linkend="
+"\"RT_ST_Range4ma\"/>, <xref linkend=\"RT_ST_Distinct4ma\"/>, <xref linkend="
+"\"RT_ST_StdDev4ma\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:2966
+#, no-c-format
+msgid "ST_SetValue"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:2967
+#, no-c-format
+msgid ""
+"Returns modified raster resulting from setting the value of a given band in "
+"a given columnx, rowy pixel or at a pixel that intersects a particular "
+"geometric point. Band numbers start at 1 and assumed to be 1 if not "
+"specified."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:2971
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_SetValue</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>pt</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>newvalue</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_SetValue</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>bandnum</parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>pt</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>newvalue</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_SetValue</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>columnx</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>rowy</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>newvalue</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_SetValue</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>bandnum</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>columnx</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>rowy</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>newvalue</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3005
+#, no-c-format
+msgid ""
+"Returns modified raster resulting from setting the specified pixel value to "
+"new value for the designed band given the row column location or a geometric "
+"point location. If no band is specified, then band 1 is assumed."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3008
+#, no-c-format
+msgid "Setting by geometry currently only works for points."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3014
+#, no-c-format
+msgid ""
+"-- Geometry example\n"
+"SELECT (foo.geomval).val, ST_AsText(ST_Union((foo.geomval).geom))\n"
+"FROM (SELECT ST_DumpAsPolygons(\n"
+" ST_SetValue(rast,1,\n"
+" ST_Point(3427927.75, 5793243.95),\n"
+" 50)\n"
+" ) As geomval\n"
+"FROM dummy_rast\n"
+"where rid = 2) As foo\n"
+"WHERE (foo.geomval).val < 250\n"
+"GROUP BY (foo.geomval).val;\n"
+"\n"
+" val | st_astext\n"
+"-----+-------------------------------------------------------------------\n"
+" 50 | POLYGON((3427927.75 5793244,3427927.75 5793243.95,3427927.8 "
+"579324 ...\n"
+" 249 | POLYGON((3427927.95 5793243.95,3427927.95 5793243.85,3427928 57932 ..."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3016
+#, no-c-format
+msgid ""
+"-- Store the changed raster --\n"
+" UPDATE dummy_rast SET rast = ST_SetValue(rast,1, "
+"ST_Point(3427927.75, 5793243.95),100)\n"
+" WHERE rid = 2 ;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3020 reference_raster.xml:6296
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_DumpAsPolygons\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3026
+#, no-c-format
+msgid "ST_SetValues"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3027
+#, no-c-format
+msgid ""
+"Returns modified raster resulting from setting the values of a given band."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3031
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_SetValues</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>columnx</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>rowy</parameter></paramdef> "
+"<paramdef><type>double precision[][] </type> <parameter>newvalueset</"
+"parameter></paramdef> <paramdef><type>boolean[][] </type> "
+"<parameter>noset=NULL</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>keepnodata=FALSE</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_SetValues</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>columnx</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>rowy</parameter></paramdef> "
+"<paramdef><type>double precision[][] </type> <parameter>newvalueset</"
+"parameter></paramdef> <paramdef><type>double precision </type> "
+"<parameter>nosetvalue</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>keepnodata=FALSE</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_SetValues</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>columnx</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>rowy</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>width</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>height</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>newvalue</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>keepnodata=FALSE</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_SetValues</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>columnx</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>rowy</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>width</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>height</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>newvalue</parameter></paramdef> <paramdef><type>boolean </"
+"type> <parameter>keepnodata=FALSE</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3082
+#, no-c-format
+msgid ""
+"Returns modified raster resulting from setting specified pixels to new "
+"value(s) for the designated band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3086
+#, no-c-format
+msgid ""
+"For Variant 1, the specific pixels to be set are determined by the "
+"<varname>columnx</varname>, <varname>rowy</varname> pixel coordinates and "
+"the dimensions of the <varname>newvalueset</varname> array. <varname>noset</"
+"varname> can be used to prevent pixels with values present in "
+"<varname>newvalueset</varname> from being set (due to PostgreSQL not "
+"permitting ragged/jagged arrays). If <varname>keepnodata</varname> is TRUE, "
+"those pixels whose values are NODATA will not be set with the corresponding "
+"value in <varname>newvalueset</varname>. See example Variant 1."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3090
+#, no-c-format
+msgid ""
+"Variant 2 is like Variant 1 but with a simple double precision "
+"<varname>nosetvalue</varname> instead of a boolean <varname>noset</varname> "
+"array. Elements in <varname>newvalueset</varname> with the "
+"<varname>nosetvalue</varname> value with be skipped. See example Variant 2."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3094
+#, no-c-format
+msgid ""
+"For Variant 3, the specific pixels to be set are determined by the "
+"<varname>columnx</varname>, <varname>rowy</varname> pixel coordinates, "
+"<varname>width</varname> and <varname>height</varname>. If "
+"<varname>keepnodata</varname> is TRUE, those pixels whose values are NODATA "
+"will not be set with the corresponding value in <varname>newvalueset</"
+"varname>. See example Variant 3."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3098
+#, no-c-format
+msgid ""
+"Variant 4 is the same as Variant 3 with the exception that it assumes that "
+"the first band's pixels of <varname>rast</varname> will be set."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:3107 reference_raster.xml:5583
+#, no-c-format
+msgid "Examples: Variant 1"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3109
+#, no-c-format
+msgid ""
+"/*\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 1 | 1 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | => | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, "
+"0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 2, 2, ARRAY[[9, 9], [9, 9]]::double precision[]"
+"[]\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | 1\n"
+" 1 | 2 | 1\n"
+" 1 | 3 | 1\n"
+" 2 | 1 | 1\n"
+" 2 | 2 | 9\n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 1\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3111
+#, no-c-format
+msgid ""
+"/*\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 9 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | => | 9 | | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 9 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, "
+"0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 1, 1, ARRAY[[9, 9, 9], [9, NULL, 9], [9, 9, 9]]::"
+"double precision[][]\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | 9\n"
+" 1 | 2 | 9\n"
+" 1 | 3 | 9\n"
+" 2 | 1 | 9\n"
+" 2 | 2 | \n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 9\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3113
+#, no-c-format
+msgid ""
+"/*\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 9 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | => | 1 | | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 9 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, "
+"0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 1, 1,\n"
+" ARRAY[[9, 9, 9], [9, NULL, 9], [9, 9, 9]]::"
+"double precision[][],\n"
+" ARRAY[[false], [true]]::boolean[][]\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | 9\n"
+" 1 | 2 | 1\n"
+" 1 | 3 | 9\n"
+" 2 | 1 | 9\n"
+" 2 | 2 | \n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 9\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3115
+#, no-c-format
+msgid ""
+"/*\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| | 1 | 1 | | | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | => | 1 | | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 9 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_SetValue(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, "
+"-1, 0, 0, 0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 1, 1, NULL\n"
+" ),\n"
+" 1, 1, 1,\n"
+" ARRAY[[9, 9, 9], [9, NULL, 9], [9, 9, 9]]::"
+"double precision[][],\n"
+" ARRAY[[false], [true]]::boolean[][],\n"
+" TRUE\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | \n"
+" 1 | 2 | 1\n"
+" 1 | 3 | 9\n"
+" 2 | 1 | 9\n"
+" 2 | 2 | \n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 9\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:3120
+#, no-c-format
+msgid "Examples: Variant 2"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3122
+#, no-c-format
+msgid ""
+"/*\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 1 | 1 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | => | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, "
+"0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 1, 1, ARRAY[[-1, -1, -1], [-1, 9, 9], [-1, 9, "
+"9]]::double precision[][], -1\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | 1\n"
+" 1 | 2 | 1\n"
+" 1 | 3 | 1\n"
+" 2 | 1 | 1\n"
+" 2 | 2 | 9\n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 1\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3124
+#, no-c-format
+msgid ""
+"/*\n"
+"This example is like the previous one. Instead of nosetvalue = -1, "
+"nosetvalue = NULL\n"
+"\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 1 | 1 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | => | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, "
+"0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 1, 1, ARRAY[[NULL, NULL, NULL], [NULL, 9, 9], "
+"[NULL, 9, 9]]::double precision[][], NULL::double precision\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | 1\n"
+" 1 | 2 | 1\n"
+" 1 | 3 | 1\n"
+" 2 | 1 | 1\n"
+" 2 | 2 | 9\n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 1\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:3129
+#, no-c-format
+msgid "Examples: Variant 3"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3131
+#, no-c-format
+msgid ""
+"/*\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 1 | 1 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | => | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, "
+"0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 2, 2, 2, 2, 9\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | 1\n"
+" 1 | 2 | 1\n"
+" 1 | 3 | 1\n"
+" 2 | 1 | 1\n"
+" 2 | 2 | 9\n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 1\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3133
+#, no-c-format
+msgid ""
+"/*\n"
+"The ST_SetValues() does the following...\n"
+"\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 1 | 1 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | | 1 | => | 1 | | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"| 1 | 1 | 1 | | 1 | 9 | 9 |\n"
+"+ - + - + - + + - + - + - +\n"
+"*/\n"
+"SELECT\n"
+" (poly).x,\n"
+" (poly).y,\n"
+" (poly).val\n"
+"FROM (\n"
+"SELECT\n"
+" ST_PixelAsPolygons(\n"
+" ST_SetValues(\n"
+" ST_SetValue(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(3, 3, 0, 0, 1, "
+"-1, 0, 0, 0),\n"
+" 1, '8BUI', 1, 0\n"
+" ),\n"
+" 1, 2, 2, NULL\n"
+" ),\n"
+" 1, 2, 2, 2, 2, 9, TRUE\n"
+" )\n"
+" ) AS poly\n"
+") foo\n"
+"ORDER BY 1, 2;\n"
+"\n"
+" x | y | val \n"
+"---+---+-----\n"
+" 1 | 1 | 1\n"
+" 1 | 2 | 1\n"
+" 1 | 3 | 1\n"
+" 2 | 1 | 1\n"
+" 2 | 2 | \n"
+" 2 | 3 | 9\n"
+" 3 | 1 | 1\n"
+" 3 | 2 | 9\n"
+" 3 | 3 | 9"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3139
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_SetValue\"/>, <xref linkend=\"RT_ST_PixelAsPolygons"
+"\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3149
+#, no-c-format
+msgid "ST_PixelOfValue"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3150
+#, no-c-format
+msgid ""
+"Get the columnx, rowy coordinates of the pixel whose value equals the search "
+"value."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3156
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>setof record <function>ST_PixelOfValue</function></"
+"funcdef> <paramdef> <type>raster </type> <parameter>rast</parameter> </"
+"paramdef> <paramdef> <type>integer </type> <parameter>nband</parameter> </"
+"paramdef> <paramdef> <type>double precision[] </type> <parameter>search</"
+"parameter> </paramdef> <paramdef> <type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>setof record "
+"<function>ST_PixelOfValue</function></funcdef> <paramdef> <type>raster </"
+"type> <parameter>rast</parameter> </paramdef> <paramdef> <type>double "
+"precision[] </type> <parameter>search</parameter> </paramdef> <paramdef> "
+"<type>boolean </type> <parameter>exclude_nodata_value=true</parameter> </"
+"paramdef> </funcprototype> <funcprototype> <funcdef>setof record "
+"<function>ST_PixelOfValue</function></funcdef> <paramdef> <type>raster </"
+"type> <parameter>rast</parameter> </paramdef> <paramdef> <type>integer </"
+"type> <parameter>nband</parameter> </paramdef> <paramdef> <type>double "
+"precision </type> <parameter>search</parameter> </paramdef> <paramdef> "
+"<type>boolean </type> <parameter>exclude_nodata_value=true</parameter> </"
+"paramdef> </funcprototype> <funcprototype> <funcdef>setof record "
+"<function>ST_PixelOfValue</function></funcdef> <paramdef> <type>raster </"
+"type> <parameter>rast</parameter> </paramdef> <paramdef> <type>double "
+"precision </type> <parameter>search</parameter> </paramdef> <paramdef> "
+"<type>boolean </type> <parameter>exclude_nodata_value=true</parameter> </"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3217
+#, no-c-format
+msgid ""
+"Get the columnx, rowy coordinates of the pixel whose value equals the search "
+"value. If no band is specified, then band 1 is assumed."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3226
+#, no-c-format
+msgid ""
+"SELECT\n"
+" (pixels).*\n"
+"FROM (\n"
+" SELECT\n"
+" ST_PixelOfValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_SetValue(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(5, "
+"5, -2, 2, 1, -1, 0, 0, 0),\n"
+" '8BUI'::"
+"text, 1, 0\n"
+" ),\n"
+" 1, 1, 0\n"
+" ),\n"
+" 2, 3, 0\n"
+" ),\n"
+" 3, 5, 0\n"
+" ),\n"
+" 4, 2, 0\n"
+" ),\n"
+" 5, 4, 255\n"
+" )\n"
+" , 1, ARRAY[1, 255]) AS pixels\n"
+") AS foo\n"
+"\n"
+" val | x | y \n"
+"-----+---+---\n"
+" 1 | 1 | 2\n"
+" 1 | 1 | 3\n"
+" 1 | 1 | 4\n"
+" 1 | 1 | 5\n"
+" 1 | 2 | 1\n"
+" 1 | 2 | 2\n"
+" 1 | 2 | 4\n"
+" 1 | 2 | 5\n"
+" 1 | 3 | 1\n"
+" 1 | 3 | 2\n"
+" 1 | 3 | 3\n"
+" 1 | 3 | 4\n"
+" 1 | 4 | 1\n"
+" 1 | 4 | 3\n"
+" 1 | 4 | 4\n"
+" 1 | 4 | 5\n"
+" 1 | 5 | 1\n"
+" 1 | 5 | 2\n"
+" 1 | 5 | 3\n"
+" 255 | 5 | 4\n"
+" 1 | 5 | 5"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:3234
+#, no-c-format
+msgid "Raster Editors"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3238
+#, no-c-format
+msgid "ST_SetGeoReference"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3239
+#, no-c-format
+msgid ""
+"Set Georeference 6 georeference parameters in a single call. Numbers should "
+"be separated by white space. Accepts inputs in GDAL or ESRI format. Default "
+"is GDAL."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:3244
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_SetGeoReference</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>georefcoords</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter>format=GDAL</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3256
+#, no-c-format
+msgid ""
+"Set Georeference 6 georeference parameters in a single call. Accepts inputs "
+"in 'GDAL' or 'ESRI' format. Default is GDAL. If 6 coordinates are not "
+"provided will return null."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3259
+#, no-c-format
+msgid "scalex skewy skewx scaley upperleftx upperlefty"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3261
+#, no-c-format
+msgid ""
+"scalex skewy skewx scaley upperleftx + scalex*0.5 upperlefty + scaley*0.5"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3267
+#, no-c-format
+msgid ""
+"UPDATE dummy_rast SET rast = ST_SetGeoReference(rast, '2 0 0 3 0.5 "
+"0.5','GDAL') \n"
+" WHERE rid=1;\n"
+" \n"
+"-- same coordinates set in 'ESRI' format\n"
+"UPDATE dummy_rast SET rast = ST_SetGeoReference(rast, '2 0 0 3 1.5 "
+"2','ESRI') \n"
+" WHERE rid=1;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3272
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_ScaleX\"/>, <xref linkend=\"RT_ST_ScaleY\"/>, <xref "
+"linkend=\"RT_ST_UpperLeftX\"/>, <xref linkend=\"RT_ST_UpperLeftY\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3278
+#, no-c-format
+msgid "ST_SetRotation"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3279
+#, no-c-format
+msgid "Set the rotation of the raster in radian."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:3284
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_SetRotation</function></funcdef> "
+"<paramdef><type>raster</type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>float8</type> <parameter>rotation</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3295
+#, no-c-format
+msgid ""
+"Uniformly rotate the raster. Rotation is in radian. Refer to <ulink url="
+"\"http://en.wikipedia.org/wiki/World_file\">World File</ulink> for more "
+"details."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3301
+#, no-c-format
+msgid ""
+"SELECT \n"
+" ST_ScaleX(rast1), ST_ScaleY(rast1), ST_SkewX(rast1), ST_SkewY(rast1),\n"
+" ST_ScaleX(rast2), ST_ScaleY(rast2), ST_SkewX(rast2), ST_SkewY(rast2) \n"
+"FROM (\n"
+" SELECT ST_SetRotation(rast, 15) AS rast1, rast as rast2 FROM dummy_rast\n"
+") AS foo;\n"
+" st_scalex | st_scaley | st_skewx | "
+"st_skewy | st_scalex | st_scaley | st_skewx | st_skewy\n"
+"---------------------+---------------------+--------------------"
+"+--------------------+-----------+-----------+----------+----------\n"
+" -1.51937582571764 | -2.27906373857646 | 1.95086352047135 | "
+"1.30057568031423 | 2 | 3 | 0 | 0\n"
+" -0.0379843956429411 | -0.0379843956429411 | 0.0325143920078558 | "
+"0.0325143920078558 | 0.05 | -0.05 | 0 | 0"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3314
+#, no-c-format
+msgid "ST_SetScale"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3315
+#, no-c-format
+msgid ""
+"Sets the X and Y size of pixels in units of coordinate reference system. "
+"Number units/pixel width/height."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3319
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_SetScale</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>xy</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>raster <function>ST_SetScale</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>float8 </type> <parameter>x</"
+"parameter></paramdef> <paramdef><type>float8 </type> <parameter>y</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3338
+#, no-c-format
+msgid ""
+"Sets the X and Y size of pixels in units of coordinate reference system. "
+"Number units/pixel width/height. If only one unit passed in, assumed X and Y "
+"are the same number."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3341
+#, no-c-format
+msgid ""
+"ST_SetScale is different from <xref linkend=\"RT_ST_Rescale\"/> in that "
+"ST_SetScale do not resample the raster to match the raster extent. It only "
+"changes the metadata (or georeference) of the raster to correct an "
+"originally mis-specified scaling. ST_Rescale results in a raster having "
+"different width and height computed to fit the geographic extent of the "
+"input raster. ST_SetScale do not modify the width, nor the height of the "
+"raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3343
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 In WKTRaster versions this was called ST_SetPixelSize. This "
+"was changed in 2.0.0."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3349
+#, no-c-format
+msgid ""
+"UPDATE dummy_rast \n"
+" SET rast = ST_SetScale(rast, 1.5)\n"
+"WHERE rid = 2;\n"
+"\n"
+"SELECT ST_ScaleX(rast) As pixx, ST_ScaleY(rast) As pixy, Box3D(rast) As "
+"newbox\n"
+"FROM dummy_rast\n"
+"WHERE rid = 2;\n"
+"\n"
+" pixx | pixy | newbox\n"
+"------+------+----------------------------------------------\n"
+" 1.5 | 1.5 | BOX(3427927.75 5793244 0, 3427935.25 5793251.5 0)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3350
+#, no-c-format
+msgid ""
+"UPDATE dummy_rast \n"
+" SET rast = ST_SetScale(rast, 1.5, 0.55)\n"
+"WHERE rid = 2;\n"
+"\n"
+"SELECT ST_ScaleX(rast) As pixx, ST_ScaleY(rast) As pixy, Box3D(rast) As "
+"newbox\n"
+"FROM dummy_rast\n"
+"WHERE rid = 2;\n"
+"\n"
+" pixx | pixy | newbox\n"
+"------+------+--------------------------------------------\n"
+" 1.5 | 0.55 | BOX(3427927.75 5793244 0,3427935.25 5793247 0)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3356
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_ScaleY\"/>, <xref linkend=\"RT_Box3D\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3362
+#, no-c-format
+msgid "ST_SetSkew"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3363
+#, no-c-format
+msgid ""
+"Sets the georeference X and Y skew (or rotation parameter). If only one is "
+"passed in, sets X and Y to the same value."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3367
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_SetSkew</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>float8 </type> <parameter>skewxy</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>raster <function>ST_SetSkew</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>float8 </type> <parameter>skewx</"
+"parameter></paramdef> <paramdef><type>float8 </type> <parameter>skewy</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3385
+#, no-c-format
+msgid ""
+"Sets the georeference X and Y skew (or rotation parameter). If only one is "
+"passed in, sets X and Y to the same value. Refer to <ulink url=\"http://en."
+"wikipedia.org/wiki/World_file\">World File</ulink> for more details."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3392
+#, no-c-format
+msgid ""
+"-- Example 1 \n"
+"UPDATE dummy_rast SET rast = ST_SetSkew(rast,1,2) WHERE rid = 1;\n"
+"SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy, \n"
+" ST_GeoReference(rast) as georef\n"
+"FROM dummy_rast WHERE rid = 1;\n"
+"\n"
+"rid | skewx | skewy | georef\n"
+"----+-------+-------+--------------\n"
+" 1 | 1 | 2 | 2.0000000000\n"
+" : 2.0000000000\n"
+" : 1.0000000000\n"
+" : 3.0000000000\n"
+" : 0.5000000000\n"
+" : 0.5000000000"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3394
+#, no-c-format
+msgid ""
+"-- Example 2 set both to same number:\n"
+"UPDATE dummy_rast SET rast = ST_SetSkew(rast,0) WHERE rid = 1;\n"
+"SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy, \n"
+" ST_GeoReference(rast) as georef\n"
+"FROM dummy_rast WHERE rid = 1;\n"
+" \n"
+" rid | skewx | skewy | georef\n"
+"-----+-------+-------+--------------\n"
+" 1 | 0 | 0 | 2.0000000000\n"
+" : 0.0000000000\n"
+" : 0.0000000000\n"
+" : 3.0000000000\n"
+" : 0.5000000000\n"
+" : 0.5000000000"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3401
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_SetGeoReference\"/>, <xref linkend=\"RT_ST_SkewX\"/"
+">, <xref linkend=\"RT_ST_SkewY\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3407
+#, no-c-format
+msgid "ST_SetSRID"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3409
+#, no-c-format
+msgid ""
+"Sets the SRID of a raster to a particular integer srid defined in the "
+"spatial_ref_sys table."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:3414
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_SetSRID</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3429
+#, no-c-format
+msgid "Sets the SRID on a raster to a particular integer value."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3432
+#, no-c-format
+msgid ""
+"This function does not transform the raster in any way - it simply sets meta "
+"data defining the spatial ref of the coordinate reference system that it's "
+"currently in. Useful for transformations later."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3442
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3449
+#, no-c-format
+msgid "ST_SetUpperLeft"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3450
+#, no-c-format
+msgid ""
+"Sets the value of the upper left corner of the pixel to projected X and Y "
+"coordinates."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:3455
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_SetUpperLeft</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>y</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3467
+#, no-c-format
+msgid ""
+"Set the value of the upper left corner of raster to the projected X "
+"coordinates"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3473
+#, no-c-format
+msgid ""
+"SELECT ST_SetUpperLeft(rast,-71.01,42.37) \n"
+"FROM dummy_rast\n"
+"WHERE rid = 2;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3479
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_UpperLeftY\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3485
+#, no-c-format
+msgid "ST_Resample"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3486
+#, no-c-format
+msgid ""
+"Resample a raster using a specified resampling algorithm, new dimensions, an "
+"arbitrary grid corner and a set of raster georeferencing attributes defined "
+"or borrowed from another raster. New pixel values are computed using the "
+"NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline "
+"or Lanczos resampling algorithm. Default is NearestNeighbor."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3490
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_Resample</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>width</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>height</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>srid=same_as_rast</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>gridx=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>gridy=NULL</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>skewx=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewy=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Resample</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>srid=NULL</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>scalex=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>scaley=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>gridx=NULL</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>gridy=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>skewx=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> <parameter>skewy=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbor</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision </type> <parameter>maxerr=0.125</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Resample</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>raster </type> "
+"<parameter>ref</parameter></paramdef> <paramdef choice=\"opt\"><type>text </"
+"type> <parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>usescale=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_Resample</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>raster </type> <parameter>ref</parameter></paramdef> "
+"<paramdef><type>boolean </type> <parameter>usescale</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3542
+#, no-c-format
+msgid ""
+"Resample a raster using a specified resampling algorithm, new dimensions "
+"(width & height), a grid corner (gridx & gridy) and a set of raster "
+"georeferencing attributes (scalex, scaley, skewx & skewy) defined or "
+"borrowed from another raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3544
+#, no-c-format
+msgid ""
+"New pixel values are computed using the NearestNeighbor (english or american "
+"spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. "
+"Default is NearestNeighbor which is the fastest but produce the worst "
+"interpolation."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3546 reference_raster.xml:3603
+#, no-c-format
+msgid ""
+"A maxerror percent of 0.125 is used if no <varname>maxerr</varname> is "
+"specified."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3548 reference_raster.xml:3607
+#: reference_raster.xml:3667 reference_raster.xml:3746
+#, no-c-format
+msgid "Only works if raster is in a known spatial reference system (SRID)."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3549 reference_raster.xml:3605
+#: reference_raster.xml:3669 reference_raster.xml:3748
+#, no-c-format
+msgid ""
+"Refer to: <ulink url=\"http://www.gdal.org/gdalwarp.html\">GDAL Warp "
+"resampling methods</ulink> for more details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3550 reference_raster.xml:3611
+#: reference_raster.xml:3673 reference_raster.xml:3752
+#: reference_raster.xml:3805
+#, no-c-format
+msgid "Availability: 2.0.0 Requires GDAL 1.6.1+"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3556
+#, no-c-format
+msgid ""
+"SELECT ST_Width(orig) As orig_width, ST_Width(reduce_100) As new_width\n"
+" FROM (\n"
+" SELECT rast As orig, ST_Resample(rast,100,100) As reduce_100 \n"
+" FROM aerials.boston \n"
+" WHERE ST_Intersects(rast,\n"
+" ST_Transform(\n"
+" ST_MakeEnvelope(-71.128, 42.2392,-71.1277, 42.2397, "
+"4326),26986) ) \n"
+" limit 1 ) As foo;\n"
+" orig_width | new_width\n"
+"------------+-------------\n"
+" 200 | 100"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3561
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3567
+#, no-c-format
+msgid "ST_Rescale"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3568
+#, no-c-format
+msgid ""
+"Resample a raster by adjusting only its scale (or pixel size). New pixel "
+"values are computed using the NearestNeighbor (english or american "
+"spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. "
+"Default is NearestNeighbor."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3573
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_Rescale</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>scalexy</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Rescale</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>scalex</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>scaley</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>text </type> <parameter>algorithm=NearestNeighbour</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>maxerr=0.125</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3597
+#, no-c-format
+msgid ""
+"Resample a raster by adjusting only its scale (or pixel size). New pixel "
+"values are computed using the NearestNeighbor (english or american "
+"spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The "
+"default is NearestNeighbor which is the fastest but results in the worst "
+"interpolation."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3599
+#, no-c-format
+msgid ""
+"<varname>scalex</varname> and <varname>scaley</varname> define the new pixel "
+"size. scaley must often be negative to get well oriented raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3601
+#, no-c-format
+msgid ""
+"When the new scalex or scaley is not a divisor of the raster width or "
+"height, the extent of the resulting raster is expanded to encompass the "
+"extent of the provided raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3609
+#, no-c-format
+msgid ""
+"ST_Rescale is different from <xref linkend=\"RT_ST_SetScale\"/> in that "
+"ST_SetScale do not resample the raster to match the raster extent. "
+"ST_SetScale only changes the metadata (or georeference) of the raster to "
+"correct an originally mis-specified scaling. ST_Rescale results in a raster "
+"having different width and height computed to fit the geographic extent of "
+"the input raster. ST_SetScale do not modify the width, nor the height of the "
+"raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3616
+#, no-c-format
+msgid ""
+"A simple example rescaling a raster from a pixel size of 0.001 degree to a "
+"pixel size of 0.0015 degree."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3618
+#, no-c-format
+msgid ""
+"-- the original raster pixel size\n"
+"SELECT ST_PixelWidth(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 0.001, "
+"-0.001, 0, 0, 4269), '8BUI'::text, 1, 0)) width\n"
+"\n"
+" width\n"
+"----------\n"
+"0.001\n"
+"\n"
+"-- the rescaled raster raster pixel size\n"
+"SELECT ST_PixelWidth(ST_Rescale(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, "
+"0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0015)) width\n"
+"\n"
+" width\n"
+"----------\n"
+"0.0015"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3623
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_ScaleX\"/>, <xref linkend=\"RT_ST_ScaleY\"/>, <xref "
+"linkend=\"RT_ST_Resample\"/>, <xref linkend=\"RT_ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3629
+#, no-c-format
+msgid "ST_Reskew"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3630
+#, no-c-format
+msgid ""
+"Resample a raster by adjusting only its skew (or rotation parameters). New "
+"pixel values are computed using the NearestNeighbor (english or american "
+"spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. "
+"Default is NearestNeighbor."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3635
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_Reskew</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>skewxy</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Reskew</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>skewx</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>skewy</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>text </type> <parameter>algorithm=NearestNeighbour</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>maxerr=0.125</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3659
+#, no-c-format
+msgid ""
+"Resample a raster by adjusting only its skew (or rotation parameters). New "
+"pixel values are computed using the NearestNeighbor (english or american "
+"spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The "
+"default is NearestNeighbor which is the fastest but results in the worst "
+"interpolation."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3661
+#, no-c-format
+msgid ""
+"<varname>skewx</varname> and <varname>skewy</varname> define the new skew."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3663 reference_raster.xml:3742
+#, no-c-format
+msgid ""
+"The extent of the new raster will encompass the extent of the provided "
+"raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3665 reference_raster.xml:3744
+#, no-c-format
+msgid ""
+"A maxerror percent of 0.125 if no <varname>maxerr</varname> is specified."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3671
+#, no-c-format
+msgid ""
+"ST_Reskew is different from <xref linkend=\"RT_ST_SetSkew\"/> in that "
+"ST_SetSkew do not resample the raster to match the raster extent. ST_SetSkew "
+"only changes the metadata (or georeference) of the raster to correct an "
+"originally mis-specified skew. ST_Reskew results in a raster having "
+"different width and height computed to fit the geographic extent of the "
+"input raster. ST_SetSkew do not modify the width, nor the height of the "
+"raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3678
+#, no-c-format
+msgid ""
+"A simple example reskewing a raster from a skew of 0.0 to a skew of 0.0015."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3680
+#, no-c-format
+msgid ""
+"-- the original raster pixel size\n"
+"SELECT ST_Rotation(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 0.001, "
+"-0.001, 0, 0, 4269), '8BUI'::text, 1, 0))\n"
+" \n"
+"-- the rescaled raster raster pixel size\n"
+"SELECT ST_Rotation(ST_Reskew(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, "
+"0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0015))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3686
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Rescale\"/>, <xref linkend=\"RT_ST_SetSkew\"/>, "
+"<xref linkend=\"RT_ST_SetRotation\"/>, <xref linkend=\"RT_ST_SkewX\"/>, "
+"<xref linkend=\"RT_ST_SkewY\"/>, <xref linkend=\"RT_ST_Transform\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3692
+#, no-c-format
+msgid "ST_SnapToGrid"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3693
+#, no-c-format
+msgid ""
+"Resample a raster by snapping it to a grid. New pixel values are computed "
+"using the NearestNeighbor (english or american spelling), Bilinear, Cubic, "
+"CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3698
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_SnapToGrid</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>gridx</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>gridy</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>scalex=DEFAULT 0</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision </type> <parameter>scaley=DEFAULT 0</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_SnapToGrid</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>gridx</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>gridy</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>scalex</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>scaley</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_SnapToGrid</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>gridx</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>gridy</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>scalexy</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbour</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3737
+#, no-c-format
+msgid ""
+"Resample a raster by snapping it to a grid defined by an arbitrary pixel "
+"corner (gridx & gridy) and optionally a pixel size (scalex & "
+"scaley). New pixel values are computed using the NearestNeighbor (english or "
+"american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling "
+"algorithm. The default is NearestNeighbor which is the fastest but results "
+"in the worst interpolation."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3739
+#, no-c-format
+msgid ""
+"<varname>gridx</varname> and <varname>gridy</varname> define any arbitrary "
+"pixel corner of the new grid. This is not necessarily the upper left corner "
+"of the new raster and it does not have to be inside or on the edge of the "
+"new raster extent."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3741
+#, no-c-format
+msgid ""
+"You can optionnal define the pixel size of the new grid with "
+"<varname>scalex</varname> and <varname>scaley</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3750
+#, no-c-format
+msgid ""
+"Use <xref linkend=\"RT_ST_Resample\"/> if you need more control over the "
+"grid parameters."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3757
+#, no-c-format
+msgid "A simple example snapping a raster to a slightly different grid."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3759
+#, no-c-format
+msgid ""
+"-- the original raster pixel size\n"
+"SELECT ST_UpperLeftX(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0.001, "
+"-0.001, 0, 0, 4269), '8BUI'::text, 1, 0))\n"
+" \n"
+"-- the rescaled raster raster pixel size\n"
+"SELECT ST_UpperLeftX(ST_SnapToGrid(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, "
+"0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0002, 0.0002))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3765
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Rescale\"/>, <xref linkend=\"RT_ST_UpperLeftX\"/>, "
+"<xref linkend=\"RT_ST_UpperLeftY\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3771
+#, no-c-format
+msgid "ST_Transform"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3772
+#, no-c-format
+msgid ""
+"Reprojects a raster in a known spatial reference system to another known "
+"spatial reference system using specified resampling algorithm. Options are "
+"NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos defaulting to "
+"NearestNeighbor."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3776
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_Transform</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>scalex</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>scaley</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>algorithm=NearestNeighbor</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision </type> <parameter>maxerr=0.125</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Transform</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid</parameter></paramdef> <paramdef choice=\"opt\"><type>text </"
+"type> <parameter>algorithm=NearestNeighbor</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>maxerr=0.125</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>scalex</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>scaley</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3802
+#, no-c-format
+msgid ""
+"Reprojects a raster in a known spatial reference system to another known "
+"spatial reference system using specified pixel warping algorithm. Uses "
+"'NearestNeighbor' if no algorithm is specified and maxerror percent of 0.125 "
+"if no maxerr is specified."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3804
+#, no-c-format
+msgid ""
+"Algorithm options are: 'NearestNeighbor', 'Bilinear', 'Cubic', "
+"'CubicSpline', and 'Lanczos'. Refer to: <ulink url=\"http://www.gdal.org/"
+"gdalwarp.html\">GDAL Warp resampling methods</ulink> for more details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3806
+#, no-c-format
+msgid ""
+"If you find your transformation support is not working right, you may need "
+"to set the environment variable PROJSO to the .so or .dll projection library "
+"your PostGIS is using. This just needs to have the name of the file. So for "
+"example on windows, you would in Control Panel -> System -> Environment "
+"Variables add a system variable called <varname>PROJSO</varname> and set it "
+"to <varname>libproj.dll</varname> (if you are using proj 4.6.1). You'll have "
+"to restart your PostgreSQL service/daemon after this change."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3813
+#, no-c-format
+msgid ""
+"SELECT ST_Width(mass_stm) As w_before, ST_Width(wgs_84) As w_after,\n"
+" ST_Height(mass_stm) As h_before, ST_Height(wgs_84) As h_after\n"
+" FROM \n"
+" ( SELECT rast As mass_stm, ST_Transform(rast,4326) As wgs_84\n"
+" , ST_Transform(rast,4326, 'Bilinear') AS wgs_84_bilin\n"
+" FROM aerials.o_2_boston \n"
+" WHERE ST_Intersects(rast,\n"
+" ST_Transform(ST_MakeEnvelope(-71.128, "
+"42.2392,-71.1277, 42.2397, 4326),26986) )\n"
+" LIMIT 1) As foo;\n"
+" \n"
+" w_before | w_after | h_before | h_after\n"
+"----------+---------+----------+---------\n"
+" 200 | 228 | 200 | 170"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3823
+#, no-c-format
+msgid "original mass state plane meters (mass_stm)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3832
+#, no-c-format
+msgid "After transform to wgs 84 long lat (wgs_84)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3841
+#, no-c-format
+msgid ""
+"After transform to wgs 84 long lat with bilinear algorithm instead of NN "
+"default (wgs_84_bilin)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3853
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_SetSRID\"/>"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:3859
+#, no-c-format
+msgid "Raster Band Editors"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3863
+#, no-c-format
+msgid "ST_SetBandNoDataValue"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3864
+#, no-c-format
+msgid ""
+"Sets the value for the given band that represents no data. Band 1 is assumed "
+"if no band is specified. To mark a band as having no nodata value, set the "
+"nodata value = NULL."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3868
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_SetBandNoDataValue</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>nodatavalue</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_SetBandNoDataValue</function></funcdef> <paramdef><type>raster "
+"</type> <parameter>rast</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>band</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>nodatavalue</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>boolean </type> <parameter>forcechecking=false</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3889
+#, no-c-format
+msgid ""
+"Sets the value that represents no data for the band. Band 1 is assumed if "
+"not specified. This will affect results from <xref linkend=\"RT_ST_Polygon\"/"
+">, <xref linkend=\"RT_ST_DumpAsPolygons\"/>, and the ST_PixelAs...() "
+"functions."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3895
+#, no-c-format
+msgid ""
+"-- change just first band no data value\n"
+"UPDATE dummy_rast \n"
+" SET rast = ST_SetBandNoDataValue(rast,1, 254) \n"
+"WHERE rid = 2;\n"
+"\n"
+"-- change no data band value of bands 1,2,3\n"
+"UPDATE dummy_rast \n"
+" SET rast = \n"
+" ST_SetBandNoDataValue(\n"
+" ST_SetBandNoDataValue(\n"
+" ST_SetBandNoDataValue(\n"
+" rast,1, 254)\n"
+" ,2,99),\n"
+" 3,108) \n"
+" WHERE rid = 2;\n"
+" \n"
+"-- wipe out the nodata value this will ensure all pixels are considered for "
+"all processing functions\n"
+"UPDATE dummy_rast \n"
+" SET rast = ST_SetBandNoDataValue(rast,1, NULL) \n"
+"WHERE rid = 2;"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3907
+#, no-c-format
+msgid "ST_SetBandIsNoData"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3908
+#, no-c-format
+msgid ""
+"Sets the isnodata flag of the band to TRUE. You may want to call this "
+"function if ST_BandIsNoData(rast, band) != ST_BandIsNodata(rast, band, "
+"TRUE). This is, if the isnodata flag is dirty. Band 1 is assumed if no band "
+"is specified."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:3917
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_SetBandIsNoData</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>band=1</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3928
+#, no-c-format
+msgid ""
+"Sets the isnodata flag for the band to true. Band 1 is assumed if not "
+"specified. This function should be called only when the flag is considered "
+"dirty. This is, when the result calling <xref linkend=\"RT_ST_BandIsNoData\"/"
+"> is different using TRUE as last argument and without using it"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3935
+#, no-c-format
+msgid ""
+"Currently, the loader (raster2pgsql.py) is not able to set the isnodata flag "
+"for bands. So, this is the fastest way to set it to TRUE, without changing "
+"any other band value"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:3944
+#, no-c-format
+msgid ""
+"-- Create dummy table with one raster column\n"
+"create table dummy_rast (rid integer, rast raster);\n"
+"\n"
+"-- Add raster with two bands, one pixel/band. In the first band, nodatavalue "
+"= pixel value = 3.\n"
+"-- In the second band, nodatavalue = 13, pixel value = 4\n"
+"insert into dummy_rast values(1,\n"
+"(\n"
+"'01' -- little endian (uint8 ndr)\n"
+"|| \n"
+"'0000' -- version (uint16 0)\n"
+"||\n"
+"'0200' -- nBands (uint16 0)\n"
+"||\n"
+"'17263529ED684A3F' -- scaleX (float64 0.000805965234044584)\n"
+"||\n"
+"'F9253529ED684ABF' -- scaleY (float64 -0.00080596523404458)\n"
+"||\n"
+"'1C9F33CE69E352C0' -- ipX (float64 -75.5533328537098)\n"
+"||\n"
+"'718F0E9A27A44840' -- ipY (float64 49.2824585505576)\n"
+"||\n"
+"'ED50EB853EC32B3F' -- skewX (float64 0.000211812383858707)\n"
+"||\n"
+"'7550EB853EC32B3F' -- skewY (float64 0.000211812383858704)\n"
+"||\n"
+"'E6100000' -- SRID (int32 4326)\n"
+"||\n"
+"'0100' -- width (uint16 1)\n"
+"||\n"
+"'0100' -- height (uint16 1)\n"
+"||\n"
+"'4' -- hasnodatavalue set to true, isnodata value set to false (when it "
+"should be true)\n"
+"||\n"
+"'2' -- first band type (4BUI) \n"
+"||\n"
+"'03' -- novalue==3\n"
+"||\n"
+"'03' -- pixel(0,0)==3 (same that nodata)\n"
+"||\n"
+"'0' -- hasnodatavalue set to false\n"
+"||\n"
+"'5' -- second band type (16BSI)\n"
+"||\n"
+"'0D00' -- novalue==13\n"
+"||\n"
+"'0400' -- pixel(0,0)==4\n"
+")::raster\n"
+");\n"
+"\n"
+"select st_bandisnodata(rast, 1) from dummy_rast where rid = 1; -- Expected "
+"false\n"
+"select st_bandisnodata(rast, 1, TRUE) from dummy_rast where rid = 1; -- "
+"Expected true\n"
+"\n"
+"-- The isnodata flag is dirty. We are going to set it to true\n"
+"update dummy_rast set rast = st_setbandisnodata(rast, 1) where rid = 1;\n"
+"\n"
+"\n"
+"select st_bandisnodata(rast, 1) from dummy_rast where rid = 1; -- Expected "
+"true"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3950
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_NumBands\"/>, <xref linkend="
+"\"RT_ST_SetBandNoDataValue\"/>, <xref linkend=\"RT_ST_BandIsNoData\"/>"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:3959
+#, no-c-format
+msgid "Raster Band Statistics and Analytics"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:3962
+#, no-c-format
+msgid "ST_Count"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:3963
+#, no-c-format
+msgid ""
+"Returns the number of pixels in a given band of a raster or raster coverage. "
+"If no band is specified defaults to band 1. If exclude_nodata_value is set "
+"to true, will only count pixels that are not equal to the nodata value."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:3967
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>bigint <function>ST_Count</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>nband=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>bigint <function>ST_Count</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>boolean </type> <parameter>exclude_nodata_value</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>bigint "
+"<function>ST_Count</function></funcdef> <paramdef><type>text </type> "
+"<parameter>rastertable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>rastercolumn</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>nband=1</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>boolean </type> <parameter>exclude_nodata_value=true</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bigint "
+"<function>ST_Count</function></funcdef> <paramdef><type>text </type> "
+"<parameter>rastertable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>rastercolumn</parameter></paramdef> <paramdef><type>boolean </"
+"type> <parameter>exclude_nodata_value</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3998
+#, no-c-format
+msgid ""
+"Returns the number of pixels in a given band of a raster or raster coverage. "
+"If no band is specified <varname>nband</varname> defaults to 1."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:3999
+#, no-c-format
+msgid ""
+"If <varname>exclude_nodata_value</varname> is set to true, will only count "
+"pixels with value not equal to the <varname>nodata</varname> value of the "
+"raster. Set <varname>exclude_nodata_value</varname> to false to get count "
+"all pixels"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4006
+#, no-c-format
+msgid ""
+"--example will count all pixels not 249 and one will count all pixels. --\n"
+"SELECT rid, ST_Count(ST_SetBandNoDataValue(rast,249)) As exclude_nodata, \n"
+" ST_Count(ST_SetBandNoDataValue(rast,249),false) As include_nodata\n"
+" FROM dummy_rast WHERE rid=2;\n"
+" \n"
+"rid | exclude_nodata | include_nodata\n"
+"-----+----------------+----------------\n"
+" 2 | 23 | 25"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4017
+#, no-c-format
+msgid "ST_Histogram"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4018
+#, no-c-format
+msgid ""
+"Returns a set of record summarizing a raster or raster coverage data "
+"distribution separate bin ranges. Number of bins are autocomputed if not "
+"specified."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4022
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>SETOF record <function>ST_Histogram</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> <parameter>nband=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>integer </type> <parameter>bins=autocomputed</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision[] </type> "
+"<parameter>width=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>right=false</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>SETOF record <function>ST_Histogram</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>nband</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>bins</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision[] </"
+"type> <parameter>width=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>right=false</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>SETOF record <function>ST_Histogram</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>nband</"
+"parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>exclude_nodata_value</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>bins</parameter></paramdef> "
+"<paramdef><type>boolean </type> <parameter>right</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>SETOF record <function>ST_Histogram</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>nband</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>bins</"
+"parameter></paramdef> <paramdef><type>boolean </type> <parameter>right</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>SETOF record "
+"<function>ST_Histogram</function></funcdef> <paramdef><type>text </type> "
+"<parameter>rastertable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>rastercolumn</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>nband</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>bins</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>right</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>SETOF record <function>ST_Histogram</function></funcdef> "
+"<paramdef><type>text </type> <parameter>rastertable</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>rastercolumn</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>boolean </type> <parameter>exclude_nodata_value</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>bins</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>right</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>SETOF record "
+"<function>ST_Histogram</function></funcdef> <paramdef><type>text </type> "
+"<parameter>rastertable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>rastercolumn</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>nband=1</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>boolean </type> <parameter>exclude_nodata_value=true</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>bins=autocomputed</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision[] </type> <parameter>width=NULL</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>right=false</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>SETOF record <function>ST_Histogram</function></"
+"funcdef> <paramdef><type>text </type> <parameter>rastertable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>rastercolumn</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> <parameter>nband=1</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>bins</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision[] </"
+"type> <parameter>width=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>right=false</parameter></paramdef> </"
+"funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4104
+#, no-c-format
+msgid ""
+"Returns set of records consisting of min, max, count, percent for a given "
+"raster band for each bin. If no band is specified <varname>nband</varname> "
+"defaults to 1."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4105
+#, no-c-format
+msgid ""
+"By default only considers pixel values not equal to the <varname>nodata</"
+"varname> value . Set <varname>exclude_nodata_value</varname> to false to get "
+"count all pixels."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:4109
+#, no-c-format
+msgid "<parameter>width </parameter><type>double precision[]</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4110
+#, no-c-format
+msgid ""
+"width: an array indicating the width of each category/bin. If the number of "
+"bins is greater than the number of widths, the widths are repeated."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4111
+#, no-c-format
+msgid ""
+"Example: 9 bins, widths are [a, b, c] will have the output be [a, b, c, a, "
+"b, c, a, b, c]"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:4114
+#, no-c-format
+msgid "<parameter>bins </parameter><type>integer</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4115
+#, no-c-format
+msgid ""
+"Number of breakouts -- this is the number of records you'll get back from "
+"the function if specified. If not specified then the number of breakouts is "
+"autocomputed."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:4119
+#, no-c-format
+msgid "<parameter>right </parameter><type>boolean</type>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4120
+#, no-c-format
+msgid ""
+"compute the histogram from the right rather than from the left (default). "
+"This changes the criteria for evaluating a value x from [a, b) to (a, b]"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4127
+#, no-c-format
+msgid ""
+"Example: Single raster tile - compute histograms for bands 1, 2, 3 and "
+"autocompute bins"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4128
+#, no-c-format
+msgid ""
+"SELECT band, (stats).*\n"
+"FROM (SELECT rid, band, ST_Histogram(rast, band) As stats\n"
+" FROM dummy_rast CROSS JOIN generate_series(1,3) As band\n"
+" WHERE rid=2) As foo;\n"
+" \n"
+" band | min | max | count | percent\n"
+"------+-------+-------+-------+---------\n"
+" 1 | 249 | 250 | 2 | 0.08\n"
+" 1 | 250 | 251 | 2 | 0.08\n"
+" 1 | 251 | 252 | 1 | 0.04\n"
+" 1 | 252 | 253 | 2 | 0.08\n"
+" 1 | 253 | 254 | 18 | 0.72\n"
+" 2 | 78 | 113.2 | 11 | 0.44\n"
+" 2 | 113.2 | 148.4 | 4 | 0.16\n"
+" 2 | 148.4 | 183.6 | 4 | 0.16\n"
+" 2 | 183.6 | 218.8 | 1 | 0.04\n"
+" 2 | 218.8 | 254 | 5 | 0.2\n"
+" 3 | 62 | 100.4 | 11 | 0.44\n"
+" 3 | 100.4 | 138.8 | 5 | 0.2\n"
+" 3 | 138.8 | 177.2 | 4 | 0.16\n"
+" 3 | 177.2 | 215.6 | 1 | 0.04\n"
+" 3 | 215.6 | 254 | 4 | 0.16"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4132
+#, no-c-format
+msgid "Example: Just band 2 but for 6 bins"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4133
+#, no-c-format
+msgid ""
+"SELECT (stats).*\n"
+"FROM (SELECT rid, ST_Histogram(rast, 2,6) As stats\n"
+" FROM dummy_rast \n"
+" WHERE rid=2) As foo;\n"
+" \n"
+" min | max | count | percent\n"
+"------------+------------+-------+---------\n"
+" 78 | 107.333333 | 9 | 0.36\n"
+" 107.333333 | 136.666667 | 6 | 0.24\n"
+" 136.666667 | 166 | 0 | 0\n"
+" 166 | 195.333333 | 4 | 0.16\n"
+" 195.333333 | 224.666667 | 1 | 0.04\n"
+" 224.666667 | 254 | 5 | 0.2\n"
+"(6 rows)\n"
+" \n"
+"-- Same as previous but we explicitly control the pixel value range of each "
+"bin. \n"
+"SELECT (stats).*\n"
+"FROM (SELECT rid, ST_Histogram(rast, 2,6,ARRAY[0.5,1,4,100,5]) As stats\n"
+" FROM dummy_rast \n"
+" WHERE rid=2) As foo;\n"
+" \n"
+" min | max | count | percent\n"
+"-------+-------+-------+----------\n"
+" 78 | 78.5 | 1 | 0.08\n"
+" 78.5 | 79.5 | 1 | 0.04\n"
+" 79.5 | 83.5 | 0 | 0\n"
+" 83.5 | 183.5 | 17 | 0.0068\n"
+" 183.5 | 188.5 | 0 | 0\n"
+" 188.5 | 254 | 6 | 0.003664\n"
+"(6 rows)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4138
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_SummaryStats\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4147
+#, no-c-format
+msgid "ST_Quantile"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4148
+#, no-c-format
+msgid ""
+"<refpurpose>Compute quantiles for a raster or raster table coverage in the "
+"context of the sample or population. Thus, a value could be examined to be "
+"at the raster's 25%, 50%, 75% percentile.</refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4152
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>SETOF record <function>ST_Quantile</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> <parameter>nband=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision[] </type> <parameter>quantiles=NULL</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>SETOF record "
+"<function>ST_Quantile</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>double precision[] </"
+"type> <parameter>quantiles</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>SETOF record <function>ST_Quantile</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>nband</parameter></"
+"paramdef> <paramdef><type>double precision[] </type> <parameter>quantiles</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>double "
+"precision <function>ST_Quantile</function></funcdef> <paramdef><type>raster "
+"</type> <parameter>rast</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>quantile</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>double precision "
+"<function>ST_Quantile</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>exclude_nodata_value</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>quantile=NULL</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>double precision "
+"<function>ST_Quantile</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>nband</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>quantile</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>double precision <function>ST_Quantile</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>nband</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>exclude_nodata_value</"
+"parameter></paramdef> <paramdef><type>double precision </type> "
+"<parameter>quantile</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>double precision <function>ST_Quantile</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>quantile</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>SETOF record "
+"<function>ST_Quantile</function></funcdef> <paramdef><type>text </type> "
+"<parameter>rastertable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>rastercolumn</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>nband=1</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>boolean </type> <parameter>exclude_nodata_value=true</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision[] </"
+"type> <parameter>quantiles=NULL</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>SETOF record <function>ST_Quantile</function></"
+"funcdef> <paramdef><type>text </type> <parameter>rastertable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>rastercolumn</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>nband</parameter></"
+"paramdef> <paramdef><type>double precision[] </type> <parameter>quantiles</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4224
+#, no-c-format
+msgid ""
+"<para>Compute quantiles for a raster or raster table coverage in the context "
+"of the sample or population. Thus, a value could be examined to be at the "
+"raster's 25%, 50%, 75% percentile.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4225 reference_raster.xml:4442
+#, no-c-format
+msgid ""
+"If <varname>exclude_nodata_value</varname> is set to false, will also count "
+"pixels with no data."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4232
+#, no-c-format
+msgid ""
+"UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;\n"
+"--Example will consider only pixels of band 1 that are not 249 and in named "
+"quantiles --\n"
+"\n"
+"SELECT (pvq).*\n"
+"FROM (SELECT ST_Quantile(rast, ARRAY[0.25,0.75]) As pvq\n"
+" FROM dummy_rast WHERE rid=2) As foo\n"
+" ORDER BY (pvq).quantile;\n"
+" \n"
+" quantile | value\n"
+"----------+-------\n"
+" 0.25 | 253\n"
+" 0.75 | 254\n"
+" \n"
+"SELECT ST_Quantile(rast, 0.75) As value\n"
+" FROM dummy_rast WHERE rid=2;\n"
+" \n"
+"value\n"
+"------\n"
+" 254"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4233
+#, no-c-format
+msgid ""
+"--real live example. Quantile of all pixels in band 2 intersecting a "
+"geometry\n"
+"SELECT rid, (ST_Quantile(rast,2)).* As pvc\n"
+" FROM o_4_boston \n"
+" WHERE ST_Intersects(rast, \n"
+" ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 "
+"892200,224706 892151,224486 892151))',26986)\n"
+" )\n"
+"ORDER BY value, quantile,rid\n"
+";\n"
+" \n"
+" \n"
+" rid | quantile | value\n"
+"-----+----------+-------\n"
+" 1 | 0 | 0\n"
+" 2 | 0 | 0\n"
+" 14 | 0 | 1\n"
+" 15 | 0 | 2\n"
+" 14 | 0.25 | 37\n"
+" 1 | 0.25 | 42\n"
+" 15 | 0.25 | 47\n"
+" 2 | 0.25 | 50\n"
+" 14 | 0.5 | 56\n"
+" 1 | 0.5 | 64\n"
+" 15 | 0.5 | 66\n"
+" 2 | 0.5 | 77\n"
+" 14 | 0.75 | 81\n"
+" 15 | 0.75 | 87\n"
+" 1 | 0.75 | 94\n"
+" 2 | 0.75 | 106\n"
+" 14 | 1 | 199\n"
+" 1 | 1 | 244\n"
+" 2 | 1 | 255\n"
+" 15 | 1 | 255"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4238 reference_raster.xml:4457
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_SetBandNoDataValue\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4244
+#, no-c-format
+msgid "ST_SummaryStats"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4245
+#, no-c-format
+msgid ""
+"Returns record consisting of count, sum, mean, stddev, min, max for a given "
+"raster band of a raster or raster coverage. Band 1 is assumed is no band is "
+"specified."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4249
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>record <function>ST_SummaryStats</function></"
+"funcdef> <paramdef><type>text </type> <parameter>rastertable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>rastercolumn</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>exclude_nodata_value</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>record "
+"<function>ST_SummaryStats</function></funcdef> <paramdef><type>raster </"
+"type> <parameter>rast</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>exclude_nodata_value</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>record <function>ST_SummaryStats</function></"
+"funcdef> <paramdef><type>text </type> <parameter>rastertable</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>rastercolumn</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> <parameter>nband=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>record <function>ST_SummaryStats</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>nband</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>exclude_nodata_value</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4285
+#, no-c-format
+msgid ""
+"Returns record consisting of count, sum, mean, stddev, min, max for a given "
+"raster band of a raster or raster coverage. If no band is specified "
+"<varname>nband</varname> defaults to 1."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4287
+#, no-c-format
+msgid ""
+"By default only considers pixel values not equal to the <varname>nodata</"
+"varname> value. Set <varname>exclude_nodata_value</varname> to false to get "
+"count of all pixels."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4289
+#, no-c-format
+msgid ""
+"By default will sample all pixels. To get faster response, set "
+"<varname>sample_percent</varname> to lower than 1"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4294
+#, no-c-format
+msgid "Example: Single raster tile"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4295
+#, no-c-format
+msgid ""
+"SELECT rid, band, (stats).*\n"
+"FROM (SELECT rid, band, ST_SummaryStats(rast, band) As stats\n"
+" FROM dummy_rast CROSS JOIN generate_series(1,3) As band\n"
+" WHERE rid=2) As foo;\n"
+" \n"
+" rid | band | count | sum | mean | stddev | min | max\n"
+"-----+------+-------+------+------------+-----------+-----+-----\n"
+" 2 | 1 | 23 | 5821 | 253.086957 | 1.248061 | 250 | 254\n"
+" 2 | 2 | 25 | 3682 | 147.28 | 59.862188 | 78 | 254\n"
+" 2 | 3 | 25 | 3290 | 131.6 | 61.647384 | 62 | 254"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4299
+#, no-c-format
+msgid "Example: Summarize pixels that intersect buildings of interest"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4300
+#, no-c-format
+msgid ""
+"This example took 574ms on PostGIS windows 64-bit with all of Boston "
+"Buildings and aerial Tiles (tiles each 150x150 pixels ~ 134,000 tiles), "
+"~102,000 building records"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4302
+#, no-c-format
+msgid ""
+"WITH \n"
+"-- our features of interest\n"
+" feat AS (SELECT gid As building_id, geom_26986 As geom FROM buildings AS "
+"b \n"
+" WHERE gid IN(100, 103,150)\n"
+" ),\n"
+"-- clip band 2 of raster tiles to boundaries of builds\n"
+"-- then get stats for these clipped regions\n"
+" b_stats AS\n"
+" (SELECT building_id, (stats).*\n"
+"FROM (SELECT building_id, ST_SummaryStats(ST_Clip(rast,2,geom)) As stats\n"
+" FROM aerials.boston\n"
+" INNER JOIN feat\n"
+" ON ST_Intersects(feat.geom,rast) \n"
+" ) As foo\n"
+" )\n"
+"-- finally summarize stats\n"
+"SELECT building_id, SUM(count) As num_pixels\n"
+" , MIN(min) As min_pval\n"
+" , MAX(max) As max_pval\n"
+" , SUM(mean*count)/SUM(count) As avg_pval\n"
+" FROM b_stats\n"
+" WHERE count > 0\n"
+" GROUP BY building_id\n"
+" ORDER BY building_id;\n"
+" building_id | num_pixels | min_pval | max_pval | avg_pval\n"
+"-------------+------------+----------+----------+------------------\n"
+" 100 | 1090 | 1 | 255 | 61.0697247706422\n"
+" 103 | 655 | 7 | 182 | 70.5038167938931\n"
+" 150 | 895 | 2 | 252 | 185.642458100559"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4306
+#, no-c-format
+msgid "Example: Raster coverage"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4307
+#, no-c-format
+msgid ""
+"-- stats for each band --\n"
+"SELECT band, (stats).*\n"
+"FROM (SELECT band, ST_SummaryStats('o_4_boston','rast', band) As stats\n"
+" FROM generate_series(1,3) As band) As foo;\n"
+" \n"
+" band | count | sum | mean | stddev | min | max\n"
+"------+---------+--------+------------------+------------------+-----+-----\n"
+" 1 | 8450000 | 725799 | 82.7064349112426 | 45.6800222638537 | 0 | 255\n"
+" 2 | 8450000 | 700487 | 81.4197705325444 | 44.2161184161765 | 0 | 255\n"
+" 3 | 8450000 | 575943 | 74.682739408284 | 44.2143885481407 | 0 | 255\n"
+" \n"
+"-- For a table -- will get better speed if set sampling to less than 100%\n"
+"-- Here we set to 25% and get a much faster answer\n"
+"SELECT band, (stats).*\n"
+"FROM (SELECT band, ST_SummaryStats('o_4_boston','rast', band,true,0.25) As "
+"stats\n"
+" FROM generate_series(1,3) As band) As foo;\n"
+" \n"
+" band | count | sum | mean | stddev | min | max\n"
+"------+---------+--------+------------------+------------------+-----+-----\n"
+" 1 | 2112500 | 180686 | 82.6890480473373 | 45.6961043857248 | 0 | 255\n"
+" 2 | 2112500 | 174571 | 81.448503668639 | 44.2252623171821 | 0 | 255\n"
+" 3 | 2112500 | 144364 | 74.6765884023669 | 44.2014869384578 | 0 | 255"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4312
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Clip\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4321
+#, no-c-format
+msgid "ST_ValueCount"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4322
+#, no-c-format
+msgid ""
+"Returns a set of records containing a pixel band value and count of the "
+"number of pixels in a given band of a raster (or a raster coverage) that "
+"have a given set of values. If no band is specified defaults to band 1. By "
+"default nodata value pixels are not counted. and all other values in the "
+"pixel are output and pixel band values are rounded to the nearest integer."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4327
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>SETOF record <function>ST_ValueCount</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> <parameter>nband=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision[] </type> <parameter>searchvalues=NULL</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>roundto=0</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>OUT value</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>OUT count</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>SETOF record "
+"<function>ST_ValueCount</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>nband</parameter></paramdef> <paramdef><type>double precision[] </"
+"type> <parameter>searchvalues</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>roundto=0</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>OUT value</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>OUT count</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>SETOF record "
+"<function>ST_ValueCount</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>double precision[] </"
+"type> <parameter>searchvalues</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>roundto=0</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>OUT value</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>OUT count</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bigint "
+"<function>ST_ValueCount</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>double precision </"
+"type> <parameter>searchvalue</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>roundto=0</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>bigint "
+"<function>ST_ValueCount</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>nband</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>exclude_nodata_value</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>searchvalue</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>roundto=0</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>bigint <function>ST_ValueCount</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>searchvalue</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>roundto=0</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>SETOF record <function>ST_ValueCount</function></funcdef> "
+"<paramdef><type>text </type> <parameter>rastertable</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>rastercolumn</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>nband=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=true</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision[] </type> <parameter>searchvalues=NULL</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>roundto=0</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>OUT value</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>OUT count</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>SETOF record "
+"<function>ST_ValueCount</function></funcdef> <paramdef><type>text </type> "
+"<parameter>rastertable</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>rastercolumn</parameter></paramdef> <paramdef><type>double "
+"precision[] </type> <parameter>searchvalues</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>double precision </type> <parameter>roundto=0</"
+"parameter></paramdef> <paramdef><type>double precision </type> "
+"<parameter>OUT value</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>OUT count</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>SETOF record <function>ST_ValueCount</function></funcdef> "
+"<paramdef><type>text </type> <parameter>rastertable</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>rastercolumn</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>double precision[] </type> <parameter>searchvalues</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>roundto=0</parameter></paramdef> <paramdef><type>double "
+"precision </type> <parameter>OUT value</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>OUT count</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>bigint<function>ST_ValueCount</"
+"function></funcdef> <paramdef><type>text </type> <parameter>rastertable</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>rastercolumn</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>nband</"
+"parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>exclude_nodata_value</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>searchvalue</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>roundto=0</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>bigint <function>ST_ValueCount</function></funcdef> "
+"<paramdef><type>text </type> <parameter>rastertable</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>rastercolumn</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>searchvalue</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>roundto=0</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>bigint <function>ST_ValueCount</function></funcdef> "
+"<paramdef><type>text </type> <parameter>rastertable</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>rastercolumn</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>searchvalue</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>roundto=0</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4440
+#, no-c-format
+msgid ""
+"Returns a set of records with columns <varname>value</varname> "
+"<varname>count</varname> which contain the pixel band value and count of "
+"pixels in the raster tile or raster coverage of selected band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4441
+#, no-c-format
+msgid ""
+"If no band is specified <varname>nband</varname> defaults to 1. If no "
+"<varname>searchvalues</varname> are specified, will return all pixel values "
+"found in the raster or raster coverage. If one searchvalue is given, will "
+"return an integer instead of records denoting the count of pixels having "
+"that pixel band value"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4449
+#, no-c-format
+msgid ""
+"UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;\n"
+"--Example will count only pixels of band 1 that are not 249. --\n"
+"\n"
+"SELECT (pvc).*\n"
+"FROM (SELECT ST_ValueCount(rast) As pvc\n"
+" FROM dummy_rast WHERE rid=2) As foo\n"
+" ORDER BY (pvc).value;\n"
+" \n"
+" value | count\n"
+"-------+-------\n"
+" 250 | 2\n"
+" 251 | 1\n"
+" 252 | 2\n"
+" 253 | 6\n"
+" 254 | 12\n"
+" \n"
+"-- Example will coount all pixels of band 1 including 249 --\n"
+"SELECT (pvc).*\n"
+"FROM (SELECT ST_ValueCount(rast,1,false) As pvc\n"
+" FROM dummy_rast WHERE rid=2) As foo\n"
+" ORDER BY (pvc).value;\n"
+" \n"
+" value | count\n"
+"-------+-------\n"
+" 249 | 2\n"
+" 250 | 2\n"
+" 251 | 1\n"
+" 252 | 2\n"
+" 253 | 6\n"
+" 254 | 12\n"
+" \n"
+"-- Example will count only non-nodata value pixels of band 2\n"
+"SELECT (pvc).*\n"
+"FROM (SELECT ST_ValueCount(rast,2) As pvc\n"
+" FROM dummy_rast WHERE rid=2) As foo\n"
+" ORDER BY (pvc).value;\n"
+" value | count\n"
+"-------+-------\n"
+" 78 | 1\n"
+" 79 | 1\n"
+" 88 | 1\n"
+" 89 | 1\n"
+" 96 | 1\n"
+" 97 | 1\n"
+" 98 | 1\n"
+" 99 | 2\n"
+" 112 | 2\n"
+":"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4450
+#, no-c-format
+msgid ""
+"--real live example. Count all the pixels in an aerial raster tile band 2 "
+"intersecting a geometry \n"
+"-- and return only the pixel band values that have a count > 500\n"
+"SELECT (pvc).value, SUM((pvc).count) As total\n"
+"FROM (SELECT ST_ValueCount(rast,2) As pvc\n"
+" FROM o_4_boston \n"
+" WHERE ST_Intersects(rast, \n"
+" ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 "
+"892200,224706 892151,224486 892151))',26986)\n"
+" ) \n"
+" ) As foo\n"
+" GROUP BY (pvc).value\n"
+" HAVING SUM((pvc).count) > 500\n"
+" ORDER BY (pvc).value;\n"
+" \n"
+" value | total\n"
+"-------+-----\n"
+" 51 | 502\n"
+" 54 | 521"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4452
+#, no-c-format
+msgid ""
+"-- Just return count of pixels in each raster tile that have value of 100 of "
+"tiles that intersect a specific geometry --\n"
+"SELECT rid, ST_ValueCount(rast,2,100) As count\n"
+" FROM o_4_boston \n"
+" WHERE ST_Intersects(rast, \n"
+" ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 "
+"892200,224706 892151,224486 892151))',26986)\n"
+" ) ;\n"
+"\n"
+" rid | count\n"
+"-----+-------\n"
+" 1 | 56\n"
+" 2 | 95\n"
+" 14 | 37\n"
+" 15 | 64"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4463
+#, no-c-format
+msgid "Raster Outputs"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4466
+#, no-c-format
+msgid "ST_AsBinary"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4467
+#, no-c-format
+msgid ""
+"Return the Well-Known Binary (WKB) representation of the raster without SRID "
+"meta data."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:4472
+#, no-c-format
+msgid ""
+"<funcdef>bytea <function>ST_AsBinary</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4482
+#, no-c-format
+msgid ""
+"Returns the Binary representation of the raster. There are 2 variants of the "
+"function. The first variant takes no endian encoding parameter and defaults "
+"to little endian. The second variant takes a second argument denoting the "
+"encoding - using little-endian ('NDR') or big-endian ('XDR') encoding."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4485
+#, no-c-format
+msgid ""
+"This is useful in binary cursors to pull data out of the database without "
+"converting it to a string representation."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4492
+#, no-c-format
+msgid ""
+"SELECT ST_AsBinary(rast) As rastbin\n"
+"FROM dummy_rast WHERE rid=1;\n"
+"\n"
+" rastbin\n"
+"---------------------------------------------------------------------------------\n"
+"\\001\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000@"
+"\\000\\000\\000\\000\\000\\000\\010@\\\n"
+"000\\000\\000\\000\\000\\000\\340?\\000\\000\\000\\000\\000\\000\\340?"
+"\\000\\000\\000\\000\\000\\00\n"
+"0\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\012\\000\\000\\000\\012\\000\\024\\000"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4499
+#, no-c-format
+msgid "ST_AsGDALRaster"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4500
+#, no-c-format
+msgid ""
+"Return the raster tile in the designated GDAL Raster format. Raster formats "
+"are one of those supported by your compiled library. Use ST_GDALRasters() to "
+"get a list of formats supported by your library."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:4505
+#, no-c-format
+msgid ""
+"<funcdef>bytea <function>ST_AsGDALRaster</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>format</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>options=NULL</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>srid=sameassource</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4519
+#, no-c-format
+msgid ""
+"Returns the raster tile in the designated format. Arguments are itemized "
+"below:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4522
+#, no-c-format
+msgid ""
+"<varname>format</varname> format to output. This is dependent on the drivers "
+"compiled in your libgdal library. Generally available are 'JPEG', 'GTIff', "
+"'PNG'. Use <xref linkend=\"RT_ST_GDALDrivers\"/> to get a list of formats "
+"supported by your library."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4527
+#, no-c-format
+msgid ""
+"<varname>options</varname> text array of GDAL options. Valid options are "
+"dependent on the format. Refer to <ulink url=\"http://www.gdal.org/"
+"frmt_various.html\">GDAL Raster format options</ulink> for more details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4532
+#, no-c-format
+msgid ""
+"<varname>srs</varname> The proj4text or srtext (from spatial_ref_sys) to "
+"embed in the image"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4541
+#, no-c-format
+msgid "JPEG Output Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4543
+#, no-c-format
+msgid ""
+"SELECT ST_AsGDALRaster(rast, 'JPEG') As rastjpg\n"
+"FROM dummy_rast WHERE rid=1;\n"
+"\n"
+"SELECT ST_AsGDALRaster(rast, 'JPEG', ARRAY!['QUALITY=50']) As rastjpg\n"
+"FROM dummy_rast WHERE rid=2;"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4548
+#, no-c-format
+msgid "GTIFF Output Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4550
+#, no-c-format
+msgid ""
+"SELECT ST_AsGDALRaster(rast, 'GTiff') As rastjpg\n"
+"FROM dummy_rast WHERE rid=2;\n"
+"\n"
+"-- Out GeoTiff with jpeg compression, 90% quality\n"
+"SELECT ST_AsGDALRaster(rast, 'GTiff', \n"
+" ARRAY['COMPRESS=JPEG', 'JPEG_QUALITY=90'], \n"
+" 4269) As rasttiff\n"
+"FROM dummy_rast WHERE rid=2;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4557
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_GDALDrivers\"/>, <xref linkend=\"RT_ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4563
+#, no-c-format
+msgid "ST_AsJPEG"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4564
+#, no-c-format
+msgid ""
+"Return the raster tile selected bands as a single Joint Photographic Exports "
+"Group (JPEG) image (byte array). If no band is specified and 1 or more than "
+"3 bands, then only the first band is used. If only 3 bands then all 3 bands "
+"are used and mapped to RGB."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4568
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>bytea <function>ST_AsJPEG</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>options=NULL</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bytea "
+"<function>ST_AsJPEG</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>nband</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>quality</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>bytea <function>ST_AsJPEG</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>options=NULL</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bytea "
+"<function>ST_AsJPEG</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer[] </type> "
+"<parameter>nbands</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text[] </type> <parameter>options=NULL</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>bytea <function>ST_AsJPEG</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast</"
+"parameter></paramdef> <paramdef><type>integer[] </type> <parameter>nbands</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>quality</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4604
+#, no-c-format
+msgid ""
+"Returns the selected bands of the raster as a single Joint Photographic "
+"Exports Group Image (JPEG). Use <xref linkend=\"RT_ST_AsGDALRaster\"/> if "
+"you need to export as less common raster types. If no band is specified and "
+"1 or more than 3 bands, then only the first band is used. If 3 bands then "
+"all 3 bands are used. There are many variants of the function with many "
+"options. These are itemized below:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4607 reference_raster.xml:4698
+#, no-c-format
+msgid "<varname>nband</varname> is for single band exports."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4612
+#, no-c-format
+msgid ""
+"<varname>nbands</varname> is an array of bands to export (note that max is 3 "
+"for JPEG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band "
+"3 to Red, band 2 to green and band 1 to blue"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4617
+#, no-c-format
+msgid ""
+"<varname>quality</varname> number from 0 to 100. The higher the number the "
+"crisper the image."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4622
+#, no-c-format
+msgid ""
+"<varname>options</varname> text Array of GDAL options as defined for JPEG "
+"(look at create_options for JPEG <xref linkend=\"RT_ST_GDALDrivers\"/>). For "
+"JPEG valid ones are <varname>PROGRESSIVE</varname> ON or OFF and "
+"<varname>QUALITY</varname> a range from 0 to 100 and default to 75. Refer to "
+"<ulink url=\"http://www.gdal.org/frmt_various.html\">GDAL Raster format "
+"options</ulink> for more details."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4639
+#, no-c-format
+msgid "Examples: Output"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4641
+#, no-c-format
+msgid ""
+"-- output first 3 bands 75% quality\n"
+"SELECT ST_AsJPEG(rast) As rastjpg\n"
+" FROM dummy_rast WHERE rid=2;\n"
+" \n"
+"-- output only first band as 90% quality\n"
+"SELECT ST_AsJPEG(rast,1,90) As rastjpg\n"
+" FROM dummy_rast WHERE rid=2;\n"
+" \n"
+"-- output first 3 bands (but make band 2 Red, band 1 green, and band 3 blue, "
+"progressive and 90% quality\n"
+"SELECT ST_AsJPEG(rast,ARRAY[2,1,3],ARRAY['QUALITY=90','PROGRESSIVE=ON']) As "
+"rastjpg\n"
+" FROM dummy_rast WHERE rid=2;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4648
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_GDALDrivers\"/>, <xref linkend=\"RT_ST_AsGDALRaster"
+"\"/>, <xref linkend=\"RT_ST_AsPNG\"/>, <xref linkend=\"RT_ST_AsTIFF\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4654
+#, no-c-format
+msgid "ST_AsPNG"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4655
+#, no-c-format
+msgid ""
+"Return the raster tile selected bands as a single portable network graphics "
+"(PNG) image (byte array). If 1, 3, or 4 bands in raster and no bands are "
+"specified, then all bands are used. If more 2 or more than 4 bands and no "
+"bands specified, then only band 1 is used. Bands are mapped to RGB or RGBA "
+"space."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4659
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>bytea <function>ST_AsPNG</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>options=NULL</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bytea "
+"<function>ST_AsPNG</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>nband</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>compression</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>bytea <function>ST_AsPNG</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>options=NULL</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>bytea "
+"<function>ST_AsPNG</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer[] </type> "
+"<parameter>nbands</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>compression</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>bytea <function>ST_AsPNG</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer[] </type> <parameter>nbands</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>options=NULL</"
+"parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4695
+#, no-c-format
+msgid ""
+"Returns the selected bands of the raster as a single Portable Network "
+"Graphics Image (PNG). Use <xref linkend=\"RT_ST_AsGDALRaster\"/> if you need "
+"to export as less common raster types. If no band is specified, then the "
+"first 3 bands are exported. There are many variants of the function with "
+"many options. If no <varname>srid</varname> is specified then then srid of "
+"the raster is used. These are itemized below:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4703 reference_raster.xml:4786
+#, no-c-format
+msgid ""
+"<varname>nbands</varname> is an array of bands to export (note that max is 3 "
+"for PNG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band "
+"3 to Red, band 2 to green and band 1 to blue"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4708
+#, no-c-format
+msgid ""
+"<varname>compression</varname> number from 1 to 9. The higher the number the "
+"greater the compression."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4713
+#, no-c-format
+msgid ""
+"<varname>options</varname> text Array of GDAL options as defined for PNG "
+"(look at create_options for PNG of <xref linkend=\"RT_ST_GDALDrivers\"/>). "
+"For PNG valid one is only ZLEVEL (amount of time to spend on compression -- "
+"default 6) e.g. ARRAY['ZLEVEL=9']. WORLDFILE is not allowed since the "
+"function would have to output two outputs. Refer to <ulink url=\"http://www."
+"gdal.org/frmt_various.html\">GDAL Raster format options</ulink> for more "
+"details."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4732
+#, no-c-format
+msgid ""
+"SELECT ST_AsPNG(rast) As rastpng\n"
+"FROM dummy_rast WHERE rid=2;\n"
+"\n"
+"-- export the first 3 bands and map band 3 to Red, band 1 to Green, band 2 "
+"to blue\n"
+"SELECT ST_AsPNG(rast, ARRAY[3,1,2]) As rastpng\n"
+"FROM dummy_rast WHERE rid=2;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4739
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_AsGDALRaster\"/>, <xref linkend="
+"\"RT_Raster_Applications\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4745
+#, no-c-format
+msgid "ST_AsTIFF"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4746
+#, no-c-format
+msgid ""
+"Return the raster selected bands as a single TIFF image (byte array). If no "
+"band is specified, then will try to use all bands."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4750
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>bytea <function>ST_AsTIFF</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>options=''</"
+"parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>srid=sameassource</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>bytea <function>ST_AsTIFF</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter>compression=''</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>srid=sameassource</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>bytea <function>ST_AsTIFF</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer[] </type> <parameter>nbands</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text </type> <parameter>compression=''</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>srid=sameassource</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>bytea <function>ST_AsTIFF</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer[] </type> <parameter>nbands</parameter></paramdef> "
+"<paramdef><type>text[] </type> <parameter>options</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>srid=sameassource</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4783
+#, no-c-format
+msgid ""
+"Returns the selected bands of the raster as a single Tagged Image File "
+"Format (TIFF). If no band is specified, will try to use all bands. This is a "
+"wrapper around <xref linkend=\"RT_ST_AsGDALRaster\"/>. Use <xref linkend="
+"\"RT_ST_AsGDALRaster\"/> if you need to export as less common raster types. "
+"There are many variants of the function with many options. If no spatial "
+"reference SRS text is present, the spatial reference of the raster is used. "
+"These are itemized below:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4791
+#, no-c-format
+msgid ""
+"<varname>compression</varname> Compression expression -- JPEG90 (or some "
+"other percent), LZW, JPEG, DEFLATE9."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4796
+#, no-c-format
+msgid ""
+"<varname>options</varname> text Array of GDAL create options as defined for "
+"GTiff (look at create_options for GTiff of <xref linkend=\"RT_ST_GDALDrivers"
+"\"/>). or refer to <ulink url=\"http://www.gdal.org/frmt_various.html\">GDAL "
+"Raster format options</ulink> for more details."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4801
+#, no-c-format
+msgid ""
+"<varname>srid</varname> srid of spatial_ref_sys of the raster. This is used "
+"to populate the georeference information"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4810
+#, no-c-format
+msgid "Examples: Use jpeg compression 90%"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4812
+#, no-c-format
+msgid ""
+"SELECT ST_AsTIFF(rast, 'JPEG90') As rasttiff\n"
+"FROM dummy_rast WHERE rid=2;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4819
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_AsGDALRaster\"/>, <xref linkend=\"RT_ST_SRID\"/>"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4825
+#, no-c-format
+msgid "Raster Processing"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4828
+#, no-c-format
+msgid "Box3D"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4829
+#, no-c-format
+msgid "Returns the box 3d representation of the enclosing box of the raster."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:4834
+#, no-c-format
+msgid ""
+"<funcdef>box3d <function>Box3D</function></funcdef> <paramdef><type>raster </"
+"type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4844
+#, no-c-format
+msgid "Returns the box representing the extent of the raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4845
+#, no-c-format
+msgid ""
+"The polygon is defined by the corner points of the bounding box "
+"((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MAXX</"
+"varname>, <varname>MAXY</varname>))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4849
+#, no-c-format
+msgid ""
+"Changed: 2.0.0 In pre-2.0 versions, there used to be a box2d instead of "
+"box3d. Since box2d is a deprecated type, this was changed to box3d."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4855
+#, no-c-format
+msgid ""
+"SELECT rid, Box3D(rast) As rastbox\n"
+"FROM dummy_rast;\n"
+"\n"
+"rid | rastbox\n"
+"----+-------------------------------------------------\n"
+"1 | BOX3D(0.5 0.5 0,20.5 60.5 0)\n"
+"2 | BOX3D(3427927.75 5793243.5 0,3427928 5793244 0)"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:4867
+#, no-c-format
+msgid "ST_Clip"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:4868
+#, no-c-format
+msgid ""
+"Returns the raster clipped by the input geometry. If no band is specified "
+"all bands are returned. If <varname>crop</varname> is not specified, true is "
+"assumed meaning the output raster is cropped."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:4873
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_Clip</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>geometry </type> <parameter>geom</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision[] </type> "
+"<parameter>nodataval=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>boolean </type> <parameter>crop=true</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>raster <function>ST_Clip</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>geom</parameter></"
+"paramdef> <paramdef><type>boolean </type> <parameter>crop</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Clip</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>band</parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>geom</parameter></paramdef> <paramdef><type>boolean </type> "
+"<parameter>crop</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4902
+#, no-c-format
+msgid ""
+"Returns a raster that is clipped by the input geometry <varname>geom</"
+"varname>. If no band is specified all bands are returned."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4904
+#, no-c-format
+msgid ""
+"Rasters resulting from ST_Clip must have a nodata value assigned for areas "
+"clipped, one for each band. If none are provided and the input raster do not "
+"have a nodata value defined, nodata values of the resulting raster are set "
+"to ST_MinPossibleValue(ST_BandPixelType(rast, band)). When the number of "
+"nodata value in the array is smaller than the number of band, the last one "
+"in the array is used for the remaining bands. If the number of nodata value "
+"is greater than the number of band, the extra nodata values are ignored. All "
+"variants accepting an array of nodata values also accept a single value "
+"which will be assigned to each band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4906
+#, no-c-format
+msgid ""
+"If <varname>crop</varname> is not specified, true is assumed meaning the "
+"output raster is cropped to the intersection of the <varname>geom</"
+"varname>and <varname>rast</varname> extents. If <varname>crop</varname> is "
+"set to false, the new raster gets the same extent as <varname>rast</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4910
+#, no-c-format
+msgid ""
+"Examples here use Massachusetts aerial data available on MassGIS site <ulink "
+"url=\"http://www.mass.gov/mgis/colororthos2008.htm\">MassGIS Aerial Orthos</"
+"ulink>. Coordinates are in Massachusetts State Plane Meters."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4914
+#, no-c-format
+msgid "Examples: 1 band clipping"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4915
+#, no-c-format
+msgid ""
+"-- Clip the first band of an aerial tile by a 20 meter buffer.\n"
+"SELECT ST_Clip(rast, 1,\n"
+" ST_Buffer(ST_Centroid(ST_Envelope(rast)),20)\n"
+" ) from aerials.boston\n"
+"WHERE rid = 4;"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4917
+#, no-c-format
+msgid ""
+"-- Demonstrate effect of crop on final dimensions of raster\n"
+"-- Note how final extent is clipped to that of the geometry\n"
+"-- if crop = true\n"
+"SELECT ST_XMax(ST_Envelope(ST_Clip(rast, 1, clipper, true))) As "
+"xmax_w_trim,\n"
+" ST_XMax(clipper) As xmax_clipper,\n"
+" ST_XMax(ST_Envelope(ST_Clip(rast, 1, clipper, false))) As "
+"xmax_wo_trim,\n"
+" ST_XMax(ST_Envelope(rast)) As xmax_rast_orig\n"
+"FROM (SELECT rast, ST_Buffer(ST_Centroid(ST_Envelope(rast)),6) As clipper\n"
+" FROM aerials.boston\n"
+"WHERE rid = 6) As foo;\n"
+"\n"
+" xmax_w_trim | xmax_clipper | xmax_wo_trim | xmax_rast_orig\n"
+"------------------+------------------+------------------+------------------\n"
+" 230657.436173996 | 230657.436173996 | 230666.436173996 | 230666.436173996"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4927 reference_raster.xml:4957
+#: reference_raster.xml:4988
+#, no-c-format
+msgid "Full raster tile before clipping"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4936 reference_raster.xml:4997
+#, no-c-format
+msgid "After Clipping"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4946
+#, no-c-format
+msgid ""
+"Examples: 1 band clipping with no crop and add back other bands unchanged"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4947
+#, no-c-format
+msgid ""
+"-- Same example as before, but we need to set crop to false to be able to "
+"use ST_AddBand\n"
+"-- because ST_AddBand requires all bands be the same Width and height\n"
+"SELECT ST_AddBand(ST_Clip(rast, 1,\n"
+" ST_Buffer(ST_Centroid(ST_Envelope(rast)),20),false\n"
+" ), ARRAY[ST_Band(rast,2),ST_Band(rast,3)] ) from aerials.boston\n"
+"WHERE rid = 6;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:4966
+#, no-c-format
+msgid "After Clipping - surreal"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:4976
+#, no-c-format
+msgid "Examples: Clip all bands"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:4977
+#, no-c-format
+msgid ""
+"-- Clip all bands of an aerial tile by a 20 meter buffer.\n"
+"-- Only difference is we don't specify a specific band to clip\n"
+"-- so all bands are clipped\n"
+"SELECT ST_Clip(rast,\n"
+" ST_Buffer(ST_Centroid(ST_Envelope(rast)), 20), \n"
+" false\n"
+" ) from aerials.boston\n"
+"WHERE rid = 4;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5009
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Intersection\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5015
+#, no-c-format
+msgid "ST_ConvexHull"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5016
+#, no-c-format
+msgid ""
+"Return the convex hull geometry of the raster including pixel values equal "
+"to BandNoDataValue. For regular shaped and non-skewed rasters, this gives "
+"the same result as ST_Envelope so only useful for irregularly shaped or "
+"skewed rasters."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:5023
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_ConvexHull</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5033
+#, no-c-format
+msgid ""
+"Return the convex hull geometry of the raster including the NoDataBandValue "
+"band pixels. For regular shaped and non-skewed rasters, this gives more or "
+"less the same result as ST_Envelope so only useful for irregularly shaped or "
+"skewed rasters."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5037
+#, no-c-format
+msgid ""
+"ST_Envelope floors the coordinates and hence add a little buffer around the "
+"raster so the answer is subtly different from ST_ConvexHull which does not "
+"floor."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5044
+#, no-c-format
+msgid ""
+"Refer to <ulink url=\"http://trac.osgeo.org/postgis/wiki/WKTRaster/"
+"SpecificationWorking01\">PostGIS Raster Specification</ulink> for a diagram "
+"of this."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5052
+#, no-c-format
+msgid ""
+"-- Note envelope and convexhull are more or less the same\n"
+"SELECT ST_AsText(ST_ConvexHull(rast)) As convhull, \n"
+" ST_AsText(ST_Envelope(rast)) As env\n"
+"FROM dummy_rast WHERE rid=1;\n"
+"\n"
+" convhull | "
+"env\n"
+"\n"
+"--------------------------------------------------------"
+"+-----------------------\n"
+" POLYGON((0.5 0.5,20.5 0.5,20.5 60.5,0.5 60.5,0.5 0.5)) | POLYGON((0 0,20 "
+"0,20 60,0 60,0 0))"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5059
+#, no-c-format
+msgid ""
+"-- now we skew the raster \n"
+"-- note how the convex hull and envelope are now different\n"
+"SELECT ST_AsText(ST_ConvexHull(rast)) As convhull, \n"
+" ST_AsText(ST_Envelope(rast)) As env\n"
+"FROM (SELECT ST_SetRotation(rast, 0.1, 0.1) As rast \n"
+" FROM dummy_rast WHERE rid=1) As foo;\n"
+" \n"
+" convhull | "
+"env\n"
+"\n"
+"--------------------------------------------------------"
+"+------------------------------------\n"
+" POLYGON((0.5 0.5,20.5 1.5,22.5 61.5,2.5 60.5,0.5 0.5)) | POLYGON((0 0,22 "
+"0,22 61,0 61,0 0))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5071
+#, no-c-format
+msgid ", <xref linkend=\"ST_ConvexHull\"/>, <xref linkend=\"ST_AsText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5077
+#, no-c-format
+msgid "ST_DumpAsPolygons"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5078
+#, no-c-format
+msgid ""
+"Returns a set of geomval (geom,val) rows, from a given raster band. If no "
+"band number is specified, band num defaults to 1."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:5083
+#, no-c-format
+msgid ""
+"<funcdef>setof geomval <function>ST_DumpAsPolygons</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>band_num=1</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>boolean </type> "
+"<parameter>exclude_nodata_value=TRUE</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5094
+#, no-c-format
+msgid ""
+"This is a set-returning function (SRF). It returns a set of geomval rows, "
+"formed by a geometry (geom) and a pixel band value (val). Each polygon is "
+"the union of all pixels for that band that have the same pixel value denoted "
+"by val."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5098
+#, no-c-format
+msgid ""
+"ST_DumpAsPolygon is useful for polygonizing rasters. It is the reverse of a "
+"GROUP BY in that it creates new rows. For example it can be used to expand a "
+"single raster into multiple POLYGONS/MULTIPOLYGONS."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5102
+#, no-c-format
+msgid "Availability: Requires GDAL 1.7 or higher."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5103
+#, no-c-format
+msgid ""
+"If there is a no data value set for a band, pixels with that value will not "
+"be returned."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5104
+#, no-c-format
+msgid ""
+"If you only care about count of pixels with a given value in a raster, it is "
+"faster to use <xref linkend=\"RT_ST_ValueCount\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5106
+#, no-c-format
+msgid ""
+"This is different than ST_PixelAsPolygons where one geometry is returned for "
+"each pixel regardless of pixel value."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5114
+#, no-c-format
+msgid ""
+"SELECT val, ST_AsText(geom) As geomwkt\n"
+"FROM (\n"
+"SELECT (ST_DumpAsPolygons(rast)).*\n"
+"FROM dummy_rast \n"
+"WHERE rid = 2\n"
+") As foo\n"
+"WHERE val BETWEEN 249 and 251\n"
+"ORDER BY val;\n"
+"\n"
+" val | geomwkt\n"
+"-----"
+"+--------------------------------------------------------------------------\n"
+" 249 | POLYGON((3427927.95 5793243.95,3427927.95 5793243.85,3427928 "
+"5793243.85,\n"
+" 3427928 5793243.95,3427927.95 5793243.95))\n"
+" 250 | POLYGON((3427927.75 5793243.9,3427927.75 5793243.85,3427927.8 "
+"5793243.85,\n"
+" 3427927.8 5793243.9,3427927.75 5793243.9))\n"
+" 250 | POLYGON((3427927.8 5793243.8,3427927.8 5793243.75,3427927.85 "
+"5793243.75,\n"
+" 3427927.85 5793243.8, 3427927.8 5793243.8))\n"
+" 251 | POLYGON((3427927.75 5793243.85,3427927.75 5793243.8,3427927.8 "
+"5793243.8,\n"
+" 3427927.8 5793243.85,3427927.75 5793243.85))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5118
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Value\"/>, <xref linkend=\"RT_ST_Polygon\"/>, <xref "
+"linkend=\"RT_ST_ValueCount\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5124
+#, no-c-format
+msgid "ST_Envelope"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5125
+#, no-c-format
+msgid "Returns the polygon representation of the extent of the raster."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:5130
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Envelope</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5140
+#, no-c-format
+msgid ""
+"Returns the polygon representation of the extent of the raster in spatial "
+"coordinate units defined by srid. It is a float8 minimum bounding box "
+"represented as a polygon."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5141
+#, no-c-format
+msgid ""
+"The polygon is defined by the corner points of the bounding box "
+"((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</"
+"varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</"
+"varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), "
+"(<varname>MINX</varname>, <varname>MINY</varname>))"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5152
+#, no-c-format
+msgid ""
+"SELECT rid, ST_AsText(ST_Envelope(rast)) As envgeomwkt\n"
+"FROM dummy_rast;\n"
+"\n"
+" rid | envgeomwkt\n"
+"-----+--------------------------------------------------------------------\n"
+" 1 | POLYGON((0 0,20 0,20 60,0 60,0 0))\n"
+" 2 | POLYGON((3427927 5793243,3427928 5793243,\n"
+" 3427928 5793244,3427927 5793244, 3427927 5793243))"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5158
+#, no-c-format
+msgid ", <xref linkend=\"ST_AsText\"/>, <xref linkend=\"RT_ST_SRID\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5164
+#, no-c-format
+msgid "ST_HillShade"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5165
+#, no-c-format
+msgid ""
+"Returns the hypothetical illumination of an elevation raster band using "
+"provided azimuth, altitude, brightness and elevation scale inputs. Useful "
+"for visualizing terrain."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:5169
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_HillShade</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>band</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef><type>double precision </type> <parameter>azimuth</parameter></"
+"paramdef> <paramdef><type>double precision </type> <parameter>altitude</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>double precision </"
+"type> <parameter>max_bright=255</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision </type> <parameter>elevation_scale=1</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5185
+#, no-c-format
+msgid ""
+"Returns the hypothetical illumination of an elevation raster band using the "
+"azimuth, altitude, brightness, and elevation scale inputs. Utilizes map "
+"algebra and applies the hill shade equation to neighboring pixels."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5186
+#, no-c-format
+msgid ""
+"The hill shade equation is: <programlisting>max_bright * "
+"( (cos(zenith)*cos(slope)) + (sin(zenith)*sin(slope)*cos(azimuth - "
+"aspect)) )</programlisting>."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5192 reference_raster.xml:5257
+#: reference_raster.xml:5322
+#, no-c-format
+msgid "Examples - coming soon"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5193 reference_raster.xml:5258
+#: reference_raster.xml:5323
+#, no-c-format
+msgid "coming soon"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5207
+#, no-c-format
+msgid "ST_Aspect"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5208
+#, no-c-format
+msgid ""
+"Returns the surface aspect of an elevation raster band. Useful for analyzing "
+"terrain."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:5212
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_Aspect</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>band</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5224
+#, no-c-format
+msgid ""
+"Returns the surface aspect of an elevation raster band. Utilizes map algebra "
+"and applies the aspect equation to neighboring pixels."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5226 reference_raster.xml:5291
+#, no-c-format
+msgid "Given the following representation of a 3x3 neighborhood of pixels:"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5232 reference_raster.xml:5297
+#, no-c-format
+msgid "<entry>A</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5233 reference_raster.xml:5298
+#, no-c-format
+msgid "<entry>B</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5234 reference_raster.xml:5299
+#, no-c-format
+msgid "<entry>C</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5237 reference_raster.xml:5302
+#, no-c-format
+msgid "<entry>D</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5238 reference_raster.xml:5303
+#, no-c-format
+msgid "<entry>E</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5239 reference_raster.xml:5304
+#, no-c-format
+msgid "<entry>F</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5242 reference_raster.xml:5307
+#, no-c-format
+msgid "<entry>G</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5243 reference_raster.xml:5308
+#, no-c-format
+msgid "<entry>H</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_raster.xml:5244 reference_raster.xml:5309
+#, no-c-format
+msgid "<entry>I</entry>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5250
+#, no-c-format
+msgid ""
+"The equation for the pixel aspect of cell E is: atan2((((G + 2H + I) - (A + "
+"2B + C)) / 8), -(((C + 2F + I) - (A + 2D + G)) / 8))"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5272
+#, no-c-format
+msgid "ST_Slope"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5273
+#, no-c-format
+msgid ""
+"Returns the surface slope of an elevation raster band. Useful for analyzing "
+"terrain."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:5277
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_Slope</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>band</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5289
+#, no-c-format
+msgid ""
+"Returns the surface slope of an elevation raster band. Utilizes map algebra "
+"and applies the slope equation to neighboring pixels."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5315
+#, no-c-format
+msgid ""
+"The equation for the pixel slope of cell E is: atan(sqrt(((c + 2f + i) - (a "
+"+ 2d + g) / 8)^2 + (((g + 2h + i) - (a + 2b + c)) / 8) ^ 2))"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5337
+#, no-c-format
+msgid "ST_Intersection"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5338
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a raster or a set of geometry-pixelvalue pairs "
+"representing the shared portion of two rasters or the geometrical "
+"intersection of a vectorization of the raster and a geometry.</refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:5342
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>setof geomval <function>ST_Intersection</function></"
+"funcdef> <paramdef><type>geometry </type> <parameter>geom</parameter></"
+"paramdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>band_num=1</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>setof geomval <function>ST_Intersection</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>geometry </type> <parameter>geom</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>setof geomval "
+"<function>ST_Intersection</function></funcdef> <paramdef><type>raster </"
+"type> <parameter>rast</parameter></paramdef> <paramdef><type>integer </type> "
+"<parameter>band_num</parameter></paramdef> <paramdef><type>geometry </type> "
+"<parameter>geom</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>raster <function>ST_Intersection</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast1</parameter></paramdef> "
+"<paramdef><type>raster </type> <parameter>rast2</parameter></paramdef> "
+"<paramdef><type>double precision[] </type> <parameter>nodataval</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Intersection</function></funcdef> <paramdef><type>raster </"
+"type> <parameter>rast1</parameter></paramdef> <paramdef><type>raster </type> "
+"<parameter>rast2</parameter></paramdef> <paramdef choice=\"opt\"><type>text "
+"</type> <parameter>returnband='BOTH'</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>double precision[] </type> <parameter>nodataval=NULL</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Intersection</function></funcdef> <paramdef><type>raster </"
+"type> <parameter>rast1</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>band_num1</parameter></paramdef> <paramdef><type>raster </"
+"type> <parameter>rast2</parameter></paramdef> <paramdef><type>integer </"
+"type> <parameter>band_num2</parameter></paramdef> <paramdef><type>double "
+"precision[] </type> <parameter>nodataval</parameter></paramdef> </"
+"funcprototype> <funcprototype> <funcdef>raster <function>ST_Intersection</"
+"function></funcdef> <paramdef><type>raster </type> <parameter>rast1</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>band_num1</"
+"parameter></paramdef> <paramdef><type>raster </type> <parameter>rast2</"
+"parameter></paramdef> <paramdef><type>integer </type> <parameter>band_num2</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>returnband='BOTH'</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>double precision[] </type> <parameter>nodataval=NULL</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5402
+#, no-c-format
+msgid ""
+"<para>Returns a raster or a set of geometry-pixelvalue pairs representing "
+"the shared portion of two rasters or the geometrical intersection of a "
+"vectorization of the raster and a geometry.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5404
+#, no-c-format
+msgid ""
+"The first three variants, returning a setof geomval, works in vector space. "
+"The raster is first vectorized (using ST_DumpAsPolygon) into a set of "
+"geomval rows and those rows are then intersected with the geometry using the "
+"ST_Intersection(geometry, geometry) PostGIS function. Geometries "
+"intersecting only with a nodata value area of a raster returns an empty "
+"geometry. They are normally excluded from the results by the proper usage of "
+"ST_Intersect in the WHERE clause."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5406
+#, no-c-format
+msgid ""
+"You can access the geometry and the value parts of the resulting set of "
+"geomval by surrounding them with parenthesis and adding '.geom' or '.val' at "
+"the end of the expression. e.g. (ST_Intersection(rast, geom)).geom"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5408
+#, no-c-format
+msgid ""
+"The other variants, returning a raster, works in raster space. They are "
+"using the two rasters version of ST_MapAlgebraExpr to perform the "
+"intersection."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5410
+#, no-c-format
+msgid ""
+"The extent of the resulting raster corresponds to the geometrical "
+"intersection of the two raster extents. The resulting raster includes "
+"'BAND1', 'BAND2' or 'BOTH' bands, following what is passed as the "
+"<varname>returnband</varname> parameter. Nodata value areas present in any "
+"band results in nodata value areas in every bands of the result. In other "
+"words, any pixel intersecting with a nodata value pixel becomes a nodata "
+"value pixel in the result."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5412
+#, no-c-format
+msgid ""
+"Rasters resulting from ST_Intersection must have a nodata value assigned for "
+"areas not intersecting. You can define or replace the nodata value for any "
+"resulting band by providing a <varname>nodataval[]</varname> array of one or "
+"two nodata values depending if you request 'BAND1', 'BAND2' or 'BOTH' bands. "
+"The first value in the array replace the nodata value in the first band and "
+"the second value replace the nodata value in the second band. If one input "
+"band do not have a nodata value defined and none are provided as an array, "
+"one is chosen using the ST_MinPossibleValue function. All variant accepting "
+"an array of nodata value can also accept a single value which will be "
+"assigned to each requested band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5414
+#, no-c-format
+msgid "In all variants, if no band number is specified band 1 is assumed."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5416
+#, no-c-format
+msgid ""
+"To get more control on the resulting extent or on what to return when "
+"encountering a nodata value, use the two rasters version of <xref linkend="
+"\"RT_ST_MapAlgebraExpr2\"/>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5418
+#, no-c-format
+msgid ""
+"To compute the intersection of a raster band with a geometry in raster "
+"space, use <xref linkend=\"RT_ST_Clip\"/>. ST_Clip works on multiple bands "
+"rasters and does not return a band corresponding to the rasterized geometry."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5420
+#, no-c-format
+msgid ""
+"ST_Intersection should be used in conjunction with ST_Intersects and an "
+"index on the raster column and/or the geometry column."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5422
+#, no-c-format
+msgid ""
+"Enhanced: 2.0.0 - Intersection in the raster space was introduced. In "
+"earlier pre-2.0.0 versions, only intersection performed in vector space were "
+"supported."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5426
+#, no-c-format
+msgid "Examples: Geometry, Raster -- resulting in geometry vals"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5428
+#, no-c-format
+msgid ""
+"SELECT foo.rid, foo.gid, \n"
+" ST_AsText((foo.geomval).geom) As geomwkt, (foo.geomval).val\n"
+"FROM\n"
+" (\n"
+"SELECT A.rid, g.gid , ST_Intersection(A.rast, g.geom) As geomval\n"
+" FROM dummy_rast AS A CROSS JOIN \n"
+" (VALUES (1, ST_Point(3427928, 5793243.85) ) ,\n"
+" (2, ST_GeomFromText('LINESTRING(3427927.85 "
+"5793243.75,3427927.8 5793243.75,3427927.8 5793243.8)') ),\n"
+" (3, ST_GeomFromText('LINESTRING(1 2, 3 4)') )\n"
+" ) As g(gid,geom)\n"
+"WHERE A.rid =2 ) As foo;\n"
+"\n"
+" rid | gid | "
+"geomwkt "
+"| val\n"
+"-----+-----"
+"+---------------------------------------------------------------------------------------------\n"
+" 2 | 1 | POINT(3427928 "
+"5793243.85) "
+"| 249\n"
+" 2 | 1 | POINT(3427928 "
+"5793243.85) "
+"| 253\n"
+" 2 | 2 | POINT(3427927.85 "
+"5793243.75) | "
+"254\n"
+" 2 | 2 | POINT(3427927.8 "
+"5793243.8) "
+"| 251\n"
+" 2 | 2 | POINT(3427927.8 "
+"5793243.8) "
+"| 253\n"
+" 2 | 2 | LINESTRING(3427927.8 5793243.75,3427927.8 5793243.8) "
+"| 252\n"
+" 2 | 2 | MULTILINESTRING((3427927.8 5793243.8,3427927.8 5793243.75),...) "
+"| 250\n"
+" 2 | 3 | GEOMETRYCOLLECTION EMPTY"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5433
+#, no-c-format
+msgid "Example: Raster, Geometry -- resulting is a raster"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5434
+#, no-c-format
+msgid "Examples coming soon"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5441
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Intersects\"/>, <xref linkend="
+"\"RT_ST_MapAlgebraExpr2\"/>, <xref linkend=\"RT_ST_Clip\"/>, <xref linkend="
+"\"ST_AsText\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5447
+#, no-c-format
+msgid "ST_MapAlgebra"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5448
+#, no-c-format
+msgid ""
+"<refpurpose>Returns a one-band raster given one or more input rasters, band "
+"indexes and one user-specified callback function.</refpurpose>"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:5454
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebra</function></funcdef> "
+"<paramdef><type>rastbandarg[] </type> <parameter>rastbandargset</parameter></"
+"paramdef> <paramdef><type>regprocedure </type> <parameter>callbackfunc</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>pixeltype=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>extenttype=INTERSECTION</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>raster </type> "
+"<parameter>customextent=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>distancex=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>distancey=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text[] </type> "
+"<parameter>VARIADIC userargs=NULL</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebra</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer[] </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>regprocedure </type> <parameter>callbackfunc</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>pixeltype=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>extenttype=FIRST</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>raster </type> <parameter>customextent=NULL</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>distancex=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>distancey=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>VARIADIC "
+"userargs=NULL</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>raster <function>ST_MapAlgebra</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>regprocedure </type> <parameter>callbackfunc</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>pixeltype=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>extenttype=FIRST</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>raster </type> <parameter>customextent=NULL</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>integer </type> "
+"<parameter>distancex=0</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>distancey=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>text[] </type> <parameter>VARIADIC "
+"userargs=NULL</parameter></paramdef> </funcprototype> <funcprototype> "
+"<funcdef>raster <function>ST_MapAlgebra</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast1</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband1</parameter></paramdef> "
+"<paramdef><type>raster </type> <parameter>rast2</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband2</parameter></paramdef> "
+"<paramdef><type>regprocedure </type> <parameter>callbackfunc</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>pixeltype=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>extenttype=INTERSECTION</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>raster </type> "
+"<parameter>customextent=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>integer </type> <parameter>distancex=0</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>distancey=0</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text[] </type> "
+"<parameter>VARIADIC userargs=NULL</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5515
+#, no-c-format
+msgid ""
+"<para>Returns a one-band raster given one or more input rasters, band "
+"indexes and one user-specified callback function.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5519
+#, no-c-format
+msgid ""
+"The <varname>tworastuserfunc</varname> parameter must be the name and "
+"signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example "
+"PL/pgSQL function example is: <programlisting>\n"
+"CREATE OR REPLACE FUNCTION sample_callbackfunc(value double precision[][][], "
+"position integer[][], VARIADIC userargs text[])\n"
+" RETURNS double precision\n"
+" AS $$\n"
+" BEGIN\n"
+" RETURN 0;\n"
+" END;\n"
+" $$ LANGUAGE 'plpgsql' IMMUTABLE;\n"
+" </programlisting> The "
+"<varname>callbackfunc</varname> must have three arguments: a 3-dimension "
+"double precision array, a 2-dimension double precision array and a variadic "
+"1-dimension text array. The first argument <varname>value</varname> is the "
+"set of values (as double precision) from all input rasters. The three "
+"dimensions (where indexes are 1-based) are: raster #, row y, column x. The "
+"second argument <varname>position</varname> is the set of pixel positions "
+"from the output raster and input rasters. The outer dimension (where indexes "
+"are 0-based) is the raster #. The position at outer dimension index 0 is the "
+"output raster's pixel position. For each outer dimension, there are two "
+"elements in the inner dimension for X and Y. The third argument "
+"<varname>userargs</varname> is for passing through any user-specified "
+"arguments."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5526
+#, no-c-format
+msgid ""
+"Passing a <type>regprocedure</type> argument to a SQL function requires the "
+"full function signature to be passed, then cast to a <type>regprocedure</"
+"type> type. To pass the above example PL/pgSQL function as an argument, the "
+"SQL for the argument is: <programlisting>\n"
+"'sample_callbackfunc(double precision[], integer[], text[])'::regprocedure\n"
+" </programlisting> Note that the "
+"argument contains the name of the function, the types of the function "
+"arguments, quotes around the name and argument types, and a cast to a "
+"<type>regprocedure</type>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5534
+#, no-c-format
+msgid ""
+"The third argument to the <varname>callbackfunc</varname> is a "
+"<type>variadic text</type> array. All trailing text arguments are passed "
+"through to the specified <varname>callbackfunc</varname>, and are contained "
+"in the <varname>userargs</varname> argument."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5539 reference_raster.xml:5998
+#: reference_raster.xml:6095
+#, no-c-format
+msgid ""
+"For more information about the VARIADIC keyword, please refer to the "
+"PostgreSQL documentation and the \"SQL Functions with Variable Numbers of "
+"Arguments\" section of <ulink url=\"http://www.postgresql.org/docs/current/"
+"static/xfunc-sql.html\">Query Language (SQL) Functions</ulink>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5545
+#, no-c-format
+msgid ""
+"The <type>text[]</type> argument to the <varname>callbackfunc</varname> is "
+"required, regardless of whether you choose to pass any arguments to the "
+"callback function for processing or not."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5550
+#, no-c-format
+msgid ""
+"If <varname>pixeltype</varname> is passed in, the one band of the new raster "
+"will be of that pixeltype. If pixeltype is passed NULL or left out, the new "
+"raster band will have the same pixeltype as the specified band of the first "
+"raster (for extent types: INTERSECTION, UNION, FIRST, CUSTOM) or the "
+"specified band of the appropriate raster (for extent types: SECOND, LAST). "
+"If in doubt, always specify <varname>pixeltype</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5554
+#, no-c-format
+msgid ""
+"Possible values for <varname>extenttype</varname> are: INTERSECTION "
+"(default), UNION, FIRST (default for one raster variants), SECOND, LAST, "
+"CUSTOM. If <varname>extentype</varname> is CUSTOM, a raster must be provided "
+"for <varname>customextent</varname>. See example 4 of Variant 1."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5558
+#, no-c-format
+msgid ""
+"Variant 1 accepts an array of <varname>rastbandarg</varname> allowing the "
+"use of a map algebra operation on many rasters and/or many bands. See "
+"example Variant 1."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5562
+#, no-c-format
+msgid ""
+"Variants 2 and 3 operate upon one or more bands of one raster. See example "
+"Variant 2 and 3."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5566
+#, no-c-format
+msgid ""
+"Variant 4 operate upon two rasters with one band per raster. See example "
+"Variant 4."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5585
+#, no-c-format
+msgid ""
+"-- one raster, one band\n"
+"WITH foo AS (\n"
+" SELECT 1 AS rid, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, "
+"0, 0), 1, '16BUI', 1, 0) AS rast\n"
+")\n"
+"SELECT\n"
+" ST_MapAlgebra(\n"
+" ARRAY[ROW(rast, 1)]::rastbandarg[],\n"
+" 'sample_callbackfunc(double precision[], int[], text[])'::"
+"regprocedure\n"
+" ) AS rast\n"
+"FROM foo"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5587
+#, no-c-format
+msgid ""
+"-- one raster, several bands\n"
+"WITH foo AS (\n"
+" SELECT 1 AS rid, "
+"ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, "
+"0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast\n"
+")\n"
+"SELECT\n"
+" ST_MapAlgebra(\n"
+" ARRAY[ROW(rast, 3), ROW(rast, 1), ROW(rast, 3), ROW(rast, "
+"2)]::rastbandarg[],\n"
+" 'sample_callbackfunc(double precision[], int[], text[])'::"
+"regprocedure\n"
+" ) AS rast\n"
+"FROM foo"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5589
+#, no-c-format
+msgid ""
+"-- several rasters, several bands\n"
+"WITH foo AS (\n"
+" SELECT 1 AS rid, "
+"ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, "
+"0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast UNION "
+"ALL\n"
+" SELECT 2 AS rid, "
+"ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 1, 1, -1, 0, 0, "
+"0), 1, '16BUI', 2, 0), 2, '8BUI', 20, 0), 3, '32BUI', 300, 0) AS rast\n"
+")\n"
+"SELECT\n"
+" ST_MapAlgebra(\n"
+" ARRAY[ROW(t1.rast, 3), ROW(t2.rast, 1), ROW(t2.rast, 3), "
+"ROW(t1.rast, 2)]::rastbandarg[],\n"
+" 'sample_callbackfunc(double precision[], int[], text[])'::"
+"regprocedure\n"
+" ) AS rast\n"
+"FROM foo t1\n"
+"CROSS JOIN foo t2\n"
+"WHERE t1.rid = 1\n"
+" AND t2.rid = 2"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5591
+#, no-c-format
+msgid ""
+"-- complete example of tiles of a coverage with neighborhood\n"
+"WITH foo AS (\n"
+" SELECT 0 AS rid, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, "
+"0, 0), 1, '16BUI', 1, 0) AS rast UNION ALL\n"
+" SELECT 1, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, 0, 1, -1, 0, 0, 0), "
+"1, '16BUI', 2, 0) AS rast UNION ALL\n"
+" SELECT 2, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, 0, 1, -1, 0, 0, 0), "
+"1, '16BUI', 3, 0) AS rast UNION ALL\n"
+"\n"
+" SELECT 3, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, -2, 1, -1, 0, 0, "
+"0), 1, '16BUI', 10, 0) AS rast UNION ALL\n"
+" SELECT 4, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, -2, 1, -1, 0, 0, "
+"0), 1, '16BUI', 20, 0) AS rast UNION ALL\n"
+" SELECT 5, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, -2, 1, -1, 0, 0, "
+"0), 1, '16BUI', 30, 0) AS rast UNION ALL\n"
+"\n"
+" SELECT 6, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, -4, 1, -1, 0, 0, "
+"0), 1, '16BUI', 100, 0) AS rast UNION ALL\n"
+" SELECT 7, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, -4, 1, -1, 0, 0, "
+"0), 1, '16BUI', 200, 0) AS rast UNION ALL\n"
+" SELECT 8, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, -4, 1, -1, 0, 0, "
+"0), 1, '16BUI', 300, 0) AS rast\n"
+")\n"
+"SELECT\n"
+" t1.rid,\n"
+" ST_MapAlgebra(\n"
+" ARRAY[ROW(ST_Union(t2.rast), 1)]::rastbandarg[],\n"
+" 'sample_callbackfunc(double precision[], int[], text[])'::"
+"regprocedure,\n"
+" '32BUI',\n"
+" 'CUSTOM', t1.rast,\n"
+" 1, 1\n"
+" ) AS rast\n"
+"FROM raster_nmapalgebra_in t1\n"
+"CROSS JOIN raster_nmapalgebra_in t2\n"
+"WHERE t1.rid = 4\n"
+" AND t2.rid BETWEEN 0 AND 8\n"
+" AND ST_Intersects(t1.rast, t2.rast)\n"
+"GROUP BY t1.rid, t1.rast"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5596
+#, no-c-format
+msgid "Examples: Variants 2 and 3"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5598
+#, no-c-format
+msgid ""
+"-- one raster, several bands\n"
+"WITH foo AS (\n"
+" SELECT 1 AS rid, "
+"ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, "
+"0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast\n"
+")\n"
+"SELECT\n"
+" ST_MapAlgebra(\n"
+" rast, ARRAY[3, 1, 3, 2]::integer[],\n"
+" 'sample_callbackfunc(double precision[], int[], text[])'::"
+"regprocedure\n"
+" ) AS rast\n"
+"FROM foo"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5600
+#, no-c-format
+msgid ""
+"-- one raster, one band\n"
+"WITH foo AS (\n"
+" SELECT 1 AS rid, "
+"ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, "
+"0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast\n"
+")\n"
+"SELECT\n"
+" ST_MapAlgebra(\n"
+" rast, 2,\n"
+" 'sample_callbackfunc(double precision[], int[], text[])'::"
+"regprocedure\n"
+" ) AS rast\n"
+"FROM foo"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5605
+#, no-c-format
+msgid "Examples: Variant 4"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5607
+#, no-c-format
+msgid ""
+"-- two rasters, two bands\n"
+"WITH foo AS (\n"
+" SELECT 1 AS rid, "
+"ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, "
+"0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast UNION "
+"ALL\n"
+" SELECT 2 AS rid, "
+"ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 1, 1, -1, 0, 0, "
+"0), 1, '16BUI', 2, 0), 2, '8BUI', 20, 0), 3, '32BUI', 300, 0) AS rast\n"
+")\n"
+"SELECT\n"
+" ST_MapAlgebra(\n"
+" t1.rast, 2,\n"
+" t2.rast, 1,\n"
+" 'sample_callbackfunc(double precision[], int[], text[])'::"
+"regprocedure\n"
+" ) AS rast\n"
+"FROM foo t1\n"
+"CROSS JOIN foo t2\n"
+"WHERE t1.rid = 1\n"
+" AND t2.rid = 2"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5614
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Union\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5625 reference_raster.xml:5712
+#, no-c-format
+msgid "ST_MapAlgebraExpr"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5626
+#, no-c-format
+msgid ""
+"1 raster band version: Creates a new one band raster formed by applying a "
+"valid PostgreSQL algebraic operation on the input raster band and of "
+"pixeltype provided. Band 1 is assumed if no band is specified."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:5630
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraExpr</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>band</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>pixeltype</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>expression</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>nodataval=NULL</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraExpr</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>pixeltype</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>expression</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>nodataval=NULL</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5653
+#, no-c-format
+msgid ""
+"Creates a new one band raster formed by applying a valid PostgreSQL "
+"algebraic operation defined by the <varname>expression</varname> on the "
+"input raster (<varname>rast</varname>). If no <varname>band</varname> is "
+"specified band 1 is assumed. The new raster will have the same georeference, "
+"width, and height as the original raster but will only have one band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5655 reference_raster.xml:5988
+#, no-c-format
+msgid ""
+"If <varname>pixeltype</varname> is passed in, then the new raster will have "
+"a band of that pixeltype. If pixeltype is passed NULL, then the new raster "
+"band will have the same pixeltype as the input <varname>rast</varname> band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5657
+#, no-c-format
+msgid ""
+"In the expression you can use the term <varname>[rast]</varname> to refer to "
+"the pixel value of the original band, <varname>[rast.x]</varname> to refer "
+"to the 1-based pixel column index, <varname>[rast.y]</varname> to refer to "
+"the 1-based pixel row index."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5669 reference_raster.xml:5806
+#: reference_raster.xml:6008
+#, no-c-format
+msgid ""
+"Create a new 1 band raster from our original that is a function of modulo 2 "
+"of the original raster band."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5670
+#, no-c-format
+msgid ""
+"ALTER TABLE dummy_rast ADD COLUMN map_rast raster;\n"
+"UPDATE dummy_rast SET map_rast = ST_MapAlgebraExpr(rast,"
+"NULL,'mod([rast],2)') WHERE rid = 2;\n"
+"\n"
+"SELECT ST_Value(rast,1,i,j) As origval, ST_Value(map_rast, 1, i, j) As "
+"mapval\n"
+"FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN "
+"generate_series(1,3) AS j\n"
+"WHERE rid = 2;\n"
+"\n"
+" origval | mapval\n"
+"---------+--------\n"
+" 253 | 1\n"
+" 254 | 0\n"
+" 253 | 1\n"
+" 253 | 1\n"
+" 254 | 0\n"
+" 254 | 0\n"
+" 250 | 0\n"
+" 254 | 0\n"
+" 254 | 0"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5671
+#, no-c-format
+msgid ""
+"Create a new 1 band raster of pixel-type 2BUI from our original that is "
+"reclassified and set the nodata value to be 0."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5672
+#, no-c-format
+msgid ""
+"ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;\n"
+"UPDATE dummy_rast SET map_rast2 = ST_MapAlgebraExpr(rast,'2BUI','CASE WHEN "
+"[rast] BETWEEN 100 and 250 THEN 1 \n"
+"WHEN [rast] = 252 THEN 2 \n"
+"WHEN [rast] BETWEEN 253 and 254 THEN 3 ELSE 0 END', '0') WHERE rid = 2;\n"
+"\n"
+"SELECT DISTINCT ST_Value(rast,1,i,j) As origval, ST_Value(map_rast2, 1, i, "
+"j) As mapval\n"
+"FROM dummy_rast CROSS JOIN generate_series(1, 5) AS i CROSS JOIN "
+"generate_series(1,5) AS j\n"
+"WHERE rid = 2;\n"
+"\n"
+" origval | mapval\n"
+"---------+--------\n"
+" 249 | 1\n"
+" 250 | 1\n"
+" 251 |\n"
+" 252 | 2\n"
+" 253 | 3\n"
+" 254 | 3\n"
+" \n"
+"SELECT ST_BandPixelType(map_rast2) As b1pixtyp\n"
+"FROM dummy_rast WHERE rid = 2;\n"
+"\n"
+" b1pixtyp\n"
+"----------\n"
+" 2BUI"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5682 reference_raster.xml:6021
+#, no-c-format
+msgid "original (column rast-view)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5691 reference_raster.xml:6029
+#, no-c-format
+msgid "rast_view_ma"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5699 reference_raster.xml:6037
+#, no-c-format
+msgid ""
+"Create a new 3 band raster same pixel type from our original 3 band raster "
+"with first band altered by map algebra and remaining 2 bands unaltered."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5701
+#, no-c-format
+msgid ""
+"SELECT ST_AddBand(\n"
+"ST_AddBand(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(rast_view),\n"
+" ST_MapAlgebraExpr(rast_view,1,"
+"NULL,'tan([rast])*[rast]')\n"
+" ), \n"
+" ST_Band(rast_view,2)\n"
+" ),\n"
+" ST_Band(rast_view, 3) As rast_view_ma\n"
+")\n"
+"FROM wind\n"
+"WHERE rid=167;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5706
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_MapAlgebraFct\"/>, <xref linkend="
+"\"RT_ST_BandPixelType\"/>, <xref linkend=\"RT_ST_GeoReference\"/>, <xref "
+"linkend=\"RT_ST_Value\"/>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5713
+#, no-c-format
+msgid ""
+"2 raster band version: Creates a new one band raster formed by applying a "
+"valid PostgreSQL algebraic operation on the two input raster bands and of "
+"pixeltype provided. band 1 of each raster is assumed if no band numbers are "
+"specified. The resulting raster will be aligned (scale, skew and pixel "
+"corners) on the grid defined by the first raster and have its extent defined "
+"by the \"extenttype\" parameter. Values for \"extenttype\" can be: "
+"INTERSECTION, UNION, FIRST, SECOND."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:5717
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraExpr</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast1</parameter></"
+"paramdef> <paramdef><type>raster </type> <parameter>rast2</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>expression</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>pixeltype=same_as_rast1_band</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>text </type> <parameter>extenttype=INTERSECTION</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>nodata1expr=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>nodata2expr=NULL</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>nodatanodataval=NULL</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraExpr</function></"
+"funcdef> <paramdef><type>raster </type> <parameter>rast1</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>band1</parameter></"
+"paramdef> <paramdef><type>raster </type> <parameter>rast2</parameter></"
+"paramdef> <paramdef><type>integer </type> <parameter>band2</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>expression</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>pixeltype=same_as_rast1_band</parameter></paramdef> <paramdef "
+"choice=\"opt\"><type>text </type> <parameter>extenttype=INTERSECTION</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text </type> "
+"<parameter>nodata1expr=NULL</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text </type> <parameter>nodata2expr=NULL</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>nodatanodataval=NULL</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5749
+#, no-c-format
+msgid ""
+"Creates a new one band raster formed by applying a valid PostgreSQL "
+"algebraic operation to the two bands defined by the <varname>expression</"
+"varname> on the two input raster bands <varname>rast1</varname>, "
+"(<varname>rast2</varname>). If no <varname>band1</varname>, <varname>band2</"
+"varname> is specified band 1 is assumed. The resulting raster will be "
+"aligned (scale, skew and pixel corners) on the grid defined by the first "
+"raster. The resulting raster will have the extent defined by the "
+"<varname>extenttype</varname> parameter."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:5754
+#, no-c-format
+msgid "expression"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5755
+#, no-c-format
+msgid ""
+"A PostgreSQL algebraic expression involving the two rasters and PostgreSQL "
+"defined functions/operators that will define the pixel value when pixels "
+"intersect. e.g. (([rast1] + [rast2])/2.0)::integer"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:5758 reference_raster.xml:6190
+#, no-c-format
+msgid "pixeltype"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5759
+#, no-c-format
+msgid ""
+"The resulting pixel type of the output raster. Must be one listed in <xref "
+"linkend=\"RT_ST_BandPixelType\"/>, left out or set to NULL. If not passed in "
+"or set to NULL, will default to the pixeltype of the first raster."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:5762
+#, no-c-format
+msgid "extenttype"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5763
+#, no-c-format
+msgid "Controls the extent of resulting raster"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5766
+#, no-c-format
+msgid ""
+"<varname>INTERSECTION</varname> - The extent of the new raster is the "
+"intersection of the two rasters. This is the default."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5769
+#, no-c-format
+msgid ""
+"<varname>UNION</varname> - The extent of the new raster is the union of the "
+"two rasters."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5772
+#, no-c-format
+msgid ""
+"<varname>FIRST</varname> - The extent of the new raster is the same as the "
+"one of the first raster."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5775
+#, no-c-format
+msgid ""
+"<varname>SECOND</varname> - The extent of the new raster is the same as the "
+"one of the second raster."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:5781
+#, no-c-format
+msgid "nodata1expr"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5782
+#, no-c-format
+msgid ""
+"An algebraic expression involving only <varname>rast2</varname> or a "
+"constant that defines what to return when pixels of <varname>rast1</varname> "
+"are nodata values and spatially corresponding rast2 pixels have values."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:5785
+#, no-c-format
+msgid "nodata2expr"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5786
+#, no-c-format
+msgid ""
+"An algebraic expression involving only <varname>rast1</varname> or a "
+"constant that defines what to return when pixels of <varname>rast2</varname> "
+"are nodata values and spatially corresponding rast1 pixels have values."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:5789
+#, no-c-format
+msgid "nodatanodataval"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5790
+#, no-c-format
+msgid ""
+"A numeric constant to return when spatially corresponding rast1 and rast2 "
+"pixels are both nodata values."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5795
+#, no-c-format
+msgid ""
+"If <varname>pixeltype</varname> is passed in, then the new raster will have "
+"a band of that pixeltype. If pixeltype is passed NULL or no pixel type "
+"specified, then the new raster band will have the same pixeltype as the "
+"input <varname>rast1</varname> band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5796
+#, no-c-format
+msgid ""
+"Use the term <varname>[rast1.val]</varname> <varname>[rast2.val]</varname> "
+"to refer to the pixel value of the original raster bands and <varname>[rast1."
+"x]</varname>, <varname>[rast1.y]</varname> etc. to refer to the column / row "
+"positions of the pixels."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5804
+#, no-c-format
+msgid "Example: 2 Band Intersection and Union"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5807
+#, no-c-format
+msgid ""
+"--Create a cool set of rasters --\n"
+"DROP TABLE IF EXISTS fun_shapes; \n"
+"CREATE TABLE fun_shapes(rid serial PRIMARY KEY, fun_name text, rast "
+"raster);\n"
+"\n"
+"-- Insert some cool shapes around Boston in Massachusetts state plane meters "
+"--\n"
+"INSERT INTO fun_shapes(fun_name, rast)\n"
+"VALUES ('ref', ST_AsRaster(ST_MakeEnvelope(235229, 899970, 237229, "
+"901930,26986),200,200,'8BUI',0,0));\n"
+"\n"
+"INSERT INTO fun_shapes(fun_name,rast)\n"
+"WITH ref(rast) AS (SELECT rast FROM fun_shapes WHERE fun_name = 'ref' ) \n"
+"SELECT 'area' AS fun_name, ST_AsRaster(ST_Buffer(ST_SetSRID(ST_Point(236229, "
+"900930),26986), 1000), \n"
+" ref.rast,'8BUI', 10, 0) As rast\n"
+"FROM ref\n"
+"UNION ALL\n"
+"SELECT 'rand bubbles', \n"
+" ST_AsRaster( \n"
+" (SELECT ST_Collect(geom)\n"
+" FROM (SELECT ST_Buffer(ST_SetSRID(ST_Point(236229 + i*random()*100, "
+"900930 + j*random()*100),26986), random()*20) As geom\n"
+" FROM generate_series(1,10) As i, "
+"generate_series(1,10) As j\n"
+" ) As foo ), ref.rast,'8BUI', 200, 0) \n"
+"FROM ref;\n"
+"\n"
+"--map them -\n"
+"SELECT ST_MapAlgebraExpr(\n"
+" area.rast, bub.rast, '[rast2.val]', '8BUI', 'INTERSECTION', "
+"'[rast2.val]', '[rast1.val]') As interrast,\n"
+" ST_MapAlgebraExpr(\n"
+" area.rast, bub.rast, '[rast2.val]', '8BUI', 'UNION', "
+"'[rast2.val]', '[rast1.val]') As unionrast\n"
+"FROM \n"
+" (SELECT rast FROM fun_shapes WHERE\n"
+" fun_name = 'area') As area\n"
+"CROSS JOIN (SELECT rast \n"
+"FROM fun_shapes WHERE\n"
+" fun_name = 'rand bubbles') As bub"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5817
+#, no-c-format
+msgid "mapalgebra intersection"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5826
+#, no-c-format
+msgid "map algebra union"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5836 reference_raster.xml:6103
+#, no-c-format
+msgid "Example: Overlaying rasters on a canvas as separate bands"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5837
+#, no-c-format
+msgid ""
+"-- we use ST_AsPNG to render the image so all single band ones look grey --\n"
+"WITH mygeoms \n"
+" AS ( SELECT 2 As bnum, ST_Buffer(ST_Point(1,5),10) As geom\n"
+" UNION ALL\n"
+" SELECT 3 AS bnum, \n"
+" ST_Buffer(ST_GeomFromText('LINESTRING(50 50,150 150,150 "
+"50)'), 10,'join=bevel') As geom\n"
+" UNION ALL\n"
+" SELECT 1 As bnum, \n"
+" ST_Buffer(ST_GeomFromText('LINESTRING(60 50,150 150,150 "
+"50)'), 5,'join=bevel') As geom\n"
+" ),\n"
+" -- define our canvas to be 1 to 1 pixel to geometry\n"
+" canvas\n"
+" AS (SELECT ST_AddBand(ST_MakeEmptyRaster(200, \n"
+" 200, \n"
+" ST_XMin(e)::integer, ST_YMax(e)::integer, 1, -1, 0, 0) , '8BUI'::"
+"text,0) As rast\n"
+" FROM (SELECT ST_Extent(geom) As e,\n"
+" Max(ST_SRID(geom)) As srid \n"
+" from mygeoms \n"
+" ) As foo\n"
+" ),\n"
+" rbands AS (SELECT ARRAY(SELECT ST_MapAlgebraExpr(canvas.rast, "
+"ST_AsRaster(m.geom, canvas.rast, '8BUI', 100),\n"
+" '[rast2.val]', '8BUI', 'FIRST', '[rast2.val]', '[rast1."
+"val]') As rast\n"
+" FROM mygeoms AS m CROSS JOIN canvas\n"
+" ORDER BY m.bnum) As rasts\n"
+" )\n"
+" SELECT rasts[1] As rast1 , rasts[2] As rast2, rasts[3] As rast3, "
+"ST_AddBand(\n"
+" ST_AddBand(rasts[1],rasts[2]), rasts[3]) As final_rast\n"
+" FROM rbands;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5848
+#, no-c-format
+msgid "rast1"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5857
+#, no-c-format
+msgid "rast2"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5868
+#, no-c-format
+msgid "rast3"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5878
+#, no-c-format
+msgid "final_rast"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:5888
+#, no-c-format
+msgid ""
+"Example: Overlay 2 meter boundary of select parcels over an aerial imagery"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:5889
+#, no-c-format
+msgid ""
+"-- Create new 3 band raster composed of first 2 clipped bands, and overlay "
+"of 3rd band with our geometry\n"
+"-- This query took 3.6 seconds on PostGIS windows 64-bit install\n"
+"WITH pr AS\n"
+"-- Note the order of operation: we clip all the rasters to dimensions of our "
+"region\n"
+"(SELECT ST_Clip(rast,ST_Expand(geom,50) ) As rast, g.geom\n"
+" FROM aerials.o_2_boston AS r INNER JOIN\n"
+"-- union our parcels of interest so they form a single geometry we can later "
+"intersect with\n"
+" (SELECT ST_Union(ST_Transform(the_geom,26986)) AS geom \n"
+" FROM landparcels WHERE pid IN('0303890000', '0303900000')) "
+"As g\n"
+" ON ST_Intersects(rast::geometry, ST_Expand(g.geom,50))\n"
+"),\n"
+"-- we then union the raster shards together\n"
+"-- ST_Union on raster is kinda of slow but much faster the smaller you can "
+"get the rasters\n"
+"-- therefore we want to clip first and then union\n"
+"prunion AS\n"
+"(SELECT ST_AddBand(NULL, ARRAY[ST_Union(rast,1),ST_Union(rast,2),"
+"ST_Union(rast,3)] ) As clipped,geom\n"
+"FROM pr\n"
+"GROUP BY geom)\n"
+"-- return our final raster which is the unioned shard with \n"
+"-- with the overlay of our parcel boundaries\n"
+"-- add first 2 bands, then mapalgebra of 3rd band + geometry\n"
+"SELECT ST_AddBand(ST_Band(clipped,ARRAY[1,2])\n"
+" , ST_MapAlgebraExpr(ST_Band(clipped,3), "
+"ST_AsRaster(ST_Buffer(ST_Boundary(geom),2),clipped, '8BUI',250),\n"
+" '[rast2.val]', '8BUI', 'FIRST', '[rast2.val]', '[rast1.val]') ) As "
+"rast\n"
+"FROM prunion;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5900
+#, no-c-format
+msgid "The blue lines are the boundaries of select parcels"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5911
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_AddBand\"/>, <xref linkend=\"RT_ST_AsPNG\"/>, <xref "
+"linkend=\"RT_ST_AsRaster\"/>, <xref linkend=\"RT_ST_MapAlgebraFct\"/>, <xref "
+"linkend=\"RT_ST_BandPixelType\"/>, <xref linkend=\"RT_ST_GeoReference\"/>, "
+"<xref linkend=\"RT_ST_Value\"/> , <xref linkend=\"RT_ST_Union\"/>, <xref "
+"linkend=\"ST_Union\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:5918 reference_raster.xml:6049
+#, no-c-format
+msgid "ST_MapAlgebraFct"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:5919
+#, no-c-format
+msgid ""
+"1 band version - Creates a new one band raster formed by applying a valid "
+"PostgreSQL function on the input raster band and of pixeltype prodived. Band "
+"1 is assumed if no band is specified."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:5923
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraFct</function></"
+"funcdef> <paramdef><type>raster</type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>regprocedure</type> <parameter>onerasteruserfunc</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_MapAlgebraFct</function></funcdef> <paramdef><type>raster</"
+"type> <parameter>rast</parameter></paramdef> <paramdef><type>regprocedure</"
+"type> <parameter>onerasteruserfunc</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_MapAlgebraFct</function></funcdef> <paramdef><type>raster</"
+"type> <parameter>rast</parameter></paramdef> <paramdef><type>text</type> "
+"<parameter>pixeltype</parameter></paramdef> <paramdef><type>regprocedure</"
+"type> <parameter>onerasteruserfunc</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraFct</function></"
+"funcdef> <paramdef><type>raster</type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>text</type> <parameter>pixeltype</parameter></"
+"paramdef> <paramdef><type>regprocedure</type> <parameter>onerasteruserfunc</"
+"parameter></paramdef> <paramdef><type>text[]</type> <parameter>VARIADIC "
+"args</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_MapAlgebraFct</function></funcdef> <paramdef><type>raster</"
+"type> <parameter>rast</parameter></paramdef> <paramdef><type>integer</type> "
+"<parameter>band</parameter></paramdef> <paramdef><type>regprocedure</type> "
+"<parameter>onerasteruserfunc</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraFct</function></"
+"funcdef> <paramdef><type>raster</type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>band</parameter></"
+"paramdef> <paramdef><type>regprocedure</type> <parameter>onerasteruserfunc</"
+"parameter></paramdef> <paramdef><type>text[]</type> <parameter>VARIADIC "
+"args</parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_MapAlgebraFct</function></funcdef> <paramdef><type>raster</"
+"type> <parameter>rast</parameter></paramdef> <paramdef><type>integer</type> "
+"<parameter>band</parameter></paramdef> <paramdef><type>text</type> "
+"<parameter>pixeltype</parameter></paramdef> <paramdef><type>regprocedure</"
+"type> <parameter>onerasteruserfunc</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraFct</function></"
+"funcdef> <paramdef><type>raster</type> <parameter>rast</parameter></"
+"paramdef> <paramdef><type>integer</type> <parameter>band</parameter></"
+"paramdef> <paramdef><type>text</type> <parameter>pixeltype</parameter></"
+"paramdef> <paramdef><type>regprocedure</type> <parameter>onerasteruserfunc</"
+"parameter></paramdef> <paramdef><type>text[]</type> <parameter>VARIADIC "
+"args</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5986
+#, no-c-format
+msgid ""
+"Creates a new one band raster formed by applying a valid PostgreSQL function "
+"specified by the <varname>onerasteruserfunc</varname> on the input raster "
+"(<varname>rast</varname>). If no <varname>band</varname> is specified, band "
+"1 is assumed. The new raster will have the same georeference, width, and "
+"height as the original raster but will only have one band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5990
+#, no-c-format
+msgid ""
+"The <varname>onerasteruserfunc</varname> parameter must be the name and "
+"signature of a SQL or PL/pgSQL function, cast to a regprocedure. A very "
+"simple and quite useless PL/pgSQL function example is: "
+"<programlisting>CREATE OR REPLACE FUNCTION simple_function(pixel FLOAT, pos "
+"INTEGER[], VARIADIC args TEXT[])\n"
+" RETURNS FLOAT\n"
+" AS $$ BEGIN\n"
+" RETURN 0.0;\n"
+" END; $$\n"
+" LANGUAGE 'plpgsql' IMMUTABLE;</programlisting> The "
+"<varname>userfunction</varname> may accept two or three arguments: a float "
+"value, an optional integer array, and a variadic text array. The first "
+"argument is the value of an individual raster cell (regardless of the raster "
+"datatype). The second argument is the position of the current processing "
+"cell in the form '{x,y}'. The third argument indicates that all remaining "
+"parameters to <xref linkend=\"RT_ST_MapAlgebraFct\"/> shall be passed "
+"through to the <varname>userfunction</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5994
+#, no-c-format
+msgid ""
+"Passing a <type>regprodedure</type> argument to a SQL function requires the "
+"full function signature to be passed, then cast to a <type>regprocedure</"
+"type> type. To pass the above example PL/pgSQL function as an argument, the "
+"SQL for the argument is:<programlisting>'simple_function(float,integer[],"
+"text[])'::regprocedure</programlisting>Note that the argument contains the "
+"name of the function, the types of the function arguments, quotes around the "
+"name and argument types, and a cast to a <type>regprocedure</type>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:5996
+#, no-c-format
+msgid ""
+"The third argument to the <varname>userfunction</varname> is a "
+"<type>variadic text</type> array. All trailing text arguments to any <xref "
+"linkend=\"RT_ST_MapAlgebraFct\"/> call are passed through to the specified "
+"<varname>userfunction</varname>, and are contained in the <varname>args</"
+"varname> argument."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6000
+#, no-c-format
+msgid ""
+"The <type>text[]</type> argument to the <varname>userfunction</varname> is "
+"required, regardless of whether you choose to pass any arguments to your "
+"user function for processing or not."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6009
+#, no-c-format
+msgid ""
+"ALTER TABLE dummy_rast ADD COLUMN map_rast raster;\n"
+"CREATE FUNCTION mod_fct(pixel float, pos integer[], variadic args text[])\n"
+"RETURNS float\n"
+"AS $$\n"
+"BEGIN\n"
+" RETURN pixel::integer % 2;\n"
+"END;\n"
+"$$\n"
+"LANGUAGE 'plpgsql' IMMUTABLE;\n"
+"\n"
+"UPDATE dummy_rast SET map_rast = ST_MapAlgebraFct(rast,NULL,'mod_fct(float,"
+"integer[],text[])'::regprocedure) WHERE rid = 2;\n"
+"\n"
+"SELECT ST_Value(rast,1,i,j) As origval, ST_Value(map_rast, 1, i, j) As "
+"mapval\n"
+"FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN "
+"generate_series(1,3) AS j\n"
+"WHERE rid = 2;\n"
+"\n"
+" origval | mapval\n"
+"---------+--------\n"
+" 253 | 1\n"
+" 254 | 0\n"
+" 253 | 1\n"
+" 253 | 1\n"
+" 254 | 0\n"
+" 254 | 0\n"
+" 250 | 0\n"
+" 254 | 0\n"
+" 254 | 0"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6010
+#, no-c-format
+msgid ""
+"Create a new 1 band raster of pixel-type 2BUI from our original that is "
+"reclassified and set the nodata value to a passed parameter to the user "
+"function (0)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6011
+#, no-c-format
+msgid ""
+"ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;\n"
+"CREATE FUNCTION classify_fct(pixel float, pos integer[], variadic args "
+"text[])\n"
+"RETURNS float\n"
+"AS\n"
+"$$\n"
+"DECLARE\n"
+" nodata float := 0;\n"
+"BEGIN\n"
+" IF NOT args[1] IS NULL THEN\n"
+" nodata := args[1];\n"
+" END IF;\n"
+" IF pixel < 251 THEN\n"
+" RETURN 1;\n"
+" ELSIF pixel = 252 THEN\n"
+" RETURN 2;\n"
+" ELSIF pixel > 252 THEN\n"
+" RETURN 3;\n"
+" ELSE\n"
+" RETURN nodata;\n"
+" END IF;\n"
+"END;\n"
+"$$\n"
+"LANGUAGE 'plpgsql';\n"
+"UPDATE dummy_rast SET map_rast2 = "
+"ST_MapAlgebraFct(rast,'2BUI','classify_fct(float,integer[],text[])'::"
+"regprocedure, '0') WHERE rid = 2;\n"
+"\n"
+"SELECT DISTINCT ST_Value(rast,1,i,j) As origval, ST_Value(map_rast2, 1, i, "
+"j) As mapval\n"
+"FROM dummy_rast CROSS JOIN generate_series(1, 5) AS i CROSS JOIN "
+"generate_series(1,5) AS j\n"
+"WHERE rid = 2;\n"
+"\n"
+" origval | mapval\n"
+"---------+--------\n"
+" 249 | 1\n"
+" 250 | 1\n"
+" 251 |\n"
+" 252 | 2\n"
+" 253 | 3\n"
+" 254 | 3\n"
+" \n"
+"SELECT ST_BandPixelType(map_rast2) As b1pixtyp\n"
+"FROM dummy_rast WHERE rid = 2;\n"
+"\n"
+" b1pixtyp\n"
+"----------\n"
+" 2BUI"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6038
+#, no-c-format
+msgid ""
+"CREATE FUNCTION rast_plus_tan(pixel float, pos integer[], variadic args "
+"text[])\n"
+"RETURNS float\n"
+"AS\n"
+"$$\n"
+"BEGIN\n"
+" RETURN tan(pixel) * pixel;\n"
+"END;\n"
+"$$\n"
+"LANGUAGE 'plpgsql';\n"
+"\n"
+"SELECT ST_AddBand(\n"
+" ST_AddBand(\n"
+" ST_AddBand(\n"
+" ST_MakeEmptyRaster(rast_view),\n"
+" ST_MapAlgebraFct(rast_view,1,"
+"NULL,'rast_plus_tan(float,integer[],text[])'::regprocedure)\n"
+" ), \n"
+" ST_Band(rast_view,2)\n"
+" ),\n"
+" ST_Band(rast_view, 3) As rast_view_ma\n"
+")\n"
+"FROM wind\n"
+"WHERE rid=167;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6043 reference_raster.xml:6143
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_BandPixelType\"/>, <xref linkend=\"RT_ST_GeoReference"
+"\"/>, <xref linkend=\"RT_ST_SetValue\"/>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6050
+#, no-c-format
+msgid ""
+"2 band version - Creates a new one band raster formed by applying a valid "
+"PostgreSQL function on the 2 input raster bands and of pixeltype prodived. "
+"Band 1 is assumed if no band is specified. Extent type defaults to "
+"INTERSECTION if not specified."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:6054
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_MapAlgebraFct</function></"
+"funcdef> <paramdef><type>raster</type> <parameter>rast1</parameter></"
+"paramdef> <paramdef><type>raster</type> <parameter>rast2</parameter></"
+"paramdef> <paramdef><type>regprocedure</type> <parameter>tworastuserfunc</"
+"parameter></paramdef> <paramdef choice=\"opt\"><type>text</type> "
+"<parameter>pixeltype=same_as_rast1</parameter></paramdef> <paramdef choice="
+"\"opt\"><type>text</type> <parameter>extenttype=INTERSECTION</parameter></"
+"paramdef> <paramdef><type>text[]</type> <parameter>VARIADIC userargs</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_MapAlgebraFct</function></funcdef> <paramdef><type>raster</"
+"type> <parameter>rast1</parameter></paramdef> <paramdef><type>integer</type> "
+"<parameter>band1</parameter></paramdef> <paramdef><type>raster</type> "
+"<parameter>rast2</parameter></paramdef> <paramdef><type>integer</type> "
+"<parameter>band2</parameter></paramdef> <paramdef><type>regprocedure</type> "
+"<parameter>tworastuserfunc</parameter></paramdef> <paramdef choice=\"opt"
+"\"><type>text</type> <parameter>pixeltype=same_as_rast1</parameter></"
+"paramdef> <paramdef choice=\"opt\"><type>text</type> "
+"<parameter>extenttype=INTERSECTION</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC userargs</parameter></"
+"paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6082
+#, no-c-format
+msgid ""
+"Creates a new one band raster formed by applying a valid PostgreSQL function "
+"specified by the <varname>tworastuserfunc</varname> on the input raster "
+"<varname>rast1</varname>, <varname>rast2</varname>. If no <varname>band1</"
+"varname> or <varname>band2</varname> is specified, band 1 is assumed. The "
+"new raster will have the same georeference, width, and height as the "
+"original rasters but will only have one band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6084
+#, no-c-format
+msgid ""
+"If <varname>pixeltype</varname> is passed in, then the new raster will have "
+"a band of that pixeltype. If pixeltype is passed NULL or left out, then the "
+"new raster band will have the same pixeltype as the input <varname>rast1</"
+"varname> band."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6086
+#, no-c-format
+msgid ""
+"The <varname>tworastuserfunc</varname> parameter must be the name and "
+"signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example "
+"PL/pgSQL function example is: <programlisting>CREATE OR REPLACE FUNCTION "
+"simple_function_for_two_rasters(pixel1 FLOAT, pixel2 FLOAT, pos INTEGER[], "
+"VARIADIC args TEXT[])\n"
+" RETURNS FLOAT\n"
+" AS $$ BEGIN\n"
+" RETURN 0.0;\n"
+" END; $$\n"
+" LANGUAGE 'plpgsql' IMMUTABLE;</programlisting> The "
+"<varname>tworastuserfunc</varname> may accept three or four arguments: a "
+"double precision value, a double precision value, an optional integer array, "
+"and a variadic text array. The first argument is the value of an individual "
+"raster cell in <varname>rast1</varname> (regardless of the raster datatype). "
+"The second argument is an individual raster cell value in <varname>rast2</"
+"varname>. The third argument is the position of the current processing cell "
+"in the form '{x,y}'. The fourth argument indicates that all remaining "
+"parameters to <xref linkend=\"RT_ST_MapAlgebraFct2\"/> shall be passed "
+"through to the <varname>tworastuserfunc</varname>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6091
+#, no-c-format
+msgid ""
+"Passing a <type>regprodedure</type> argument to a SQL function requires the "
+"full function signature to be passed, then cast to a <type>regprocedure</"
+"type> type. To pass the above example PL/pgSQL function as an argument, the "
+"SQL for the argument is:<programlisting>'simple_function(double precision, "
+"double precision, integer[], text[])'::regprocedure</programlisting>Note "
+"that the argument contains the name of the function, the types of the "
+"function arguments, quotes around the name and argument types, and a cast to "
+"a <type>regprocedure</type>."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6093
+#, no-c-format
+msgid ""
+"The third argument to the <varname>tworastuserfunc</varname> is a "
+"<type>variadic text</type> array. All trailing text arguments to any <xref "
+"linkend=\"RT_ST_MapAlgebraFct2\"/> call are passed through to the specified "
+"<varname>tworastuserfunc</varname>, and are contained in the "
+"<varname>userargs</varname> argument."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6097
+#, no-c-format
+msgid ""
+"The <type>text[]</type> argument to the <varname>tworastuserfunc</varname> "
+"is required, regardless of whether you choose to pass any arguments to your "
+"user function for processing or not."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6104
+#, no-c-format
+msgid ""
+"-- define our user defined function --\n"
+"CREATE OR REPLACE FUNCTION raster_mapalgebra_union(\n"
+" rast1 double precision,\n"
+" rast2 double precision,\n"
+" pos integer[],\n"
+" VARIADIC userargs text[]\n"
+")\n"
+" RETURNS double precision\n"
+" AS $$\n"
+" DECLARE\n"
+" BEGIN\n"
+" CASE\n"
+" WHEN rast1 IS NOT NULL AND rast2 IS NOT NULL THEN\n"
+" RETURN ((rast1 + rast2)/2.);\n"
+" WHEN rast1 IS NULL AND rast2 IS NULL THEN\n"
+" RETURN NULL;\n"
+" WHEN rast1 IS NULL THEN\n"
+" RETURN rast2;\n"
+" ELSE\n"
+" RETURN rast1;\n"
+" END CASE;\n"
+"\n"
+" RETURN NULL;\n"
+" END;\n"
+" $$ LANGUAGE 'plpgsql' IMMUTABLE COST 1000;\n"
+"\n"
+"-- prep our test table of rasters\n"
+"DROP TABLE IF EXISTS map_shapes;\n"
+"CREATE TABLE map_shapes(rid serial PRIMARY KEY, rast raster, bnum integer, "
+"descrip text);\n"
+"INSERT INTO map_shapes(rast,bnum, descrip)\n"
+"WITH mygeoms \n"
+" AS ( SELECT 2 As bnum, ST_Buffer(ST_Point(90,90),30) As geom, 'circle' "
+"As descrip\n"
+" UNION ALL\n"
+" SELECT 3 AS bnum, \n"
+" ST_Buffer(ST_GeomFromText('LINESTRING(50 50,150 150,150 "
+"50)'), 15) As geom, 'big road' As descrip\n"
+" UNION ALL\n"
+" SELECT 1 As bnum, \n"
+" ST_Translate(ST_Buffer(ST_GeomFromText('LINESTRING(60 50,150 "
+"150,150 50)'), 8,'join=bevel'), 10,-6) As geom, 'small road' As descrip\n"
+" ),\n"
+" -- define our canvas to be 1 to 1 pixel to geometry\n"
+" canvas\n"
+" AS ( SELECT ST_AddBand(ST_MakeEmptyRaster(250, \n"
+" 250, \n"
+" ST_XMin(e)::integer, ST_YMax(e)::integer, 1, -1, 0, 0 ) , '8BUI'::"
+"text,0) As rast\n"
+" FROM (SELECT ST_Extent(geom) As e,\n"
+" Max(ST_SRID(geom)) As srid \n"
+" from mygeoms \n"
+" ) As foo\n"
+" )\n"
+"-- return our rasters aligned with our canvas\n"
+"SELECT ST_AsRaster(m.geom, canvas.rast, '8BUI', 240) As rast, bnum, descrip\n"
+" FROM mygeoms AS m CROSS JOIN canvas\n"
+"UNION ALL \n"
+"SELECT canvas.rast, 4, 'canvas'\n"
+"FROM canvas;\n"
+"\n"
+"-- Map algebra on single band rasters and then collect with ST_AddBand\n"
+"INSERT INTO map_shapes(rast,bnum,descrip)\n"
+"SELECT ST_AddBand(ST_AddBand(rasts[1], rasts[2]),rasts[3]), 4, 'map bands "
+"overlay fct union (canvas)'\n"
+" FROM (SELECT ARRAY(SELECT ST_MapAlgebraFct(m1.rast, m2.rast, \n"
+" 'raster_mapalgebra_union(double precision, double "
+"precision, integer[], text[])'::regprocedure, '8BUI', 'FIRST')\n"
+" FROM map_shapes As m1 CROSS JOIN map_shapes As m2\n"
+" WHERE m1.descrip = 'canvas' AND m2.descrip <> "
+"'canvas' ORDER BY m2.bnum) As rasts) As foo;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6115
+#, no-c-format
+msgid "map bands overlay (canvas) (R: small road, G: circle, B: big road)"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6125
+#, no-c-format
+msgid "User Defined function that takes extra args"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6126
+#, no-c-format
+msgid ""
+"CREATE OR REPLACE FUNCTION raster_mapalgebra_userargs(\n"
+" rast1 double precision,\n"
+" rast2 double precision,\n"
+" pos integer[],\n"
+" VARIADIC userargs text[]\n"
+")\n"
+" RETURNS double precision\n"
+" AS $$\n"
+" DECLARE\n"
+" BEGIN\n"
+" CASE\n"
+" WHEN rast1 IS NOT NULL AND rast2 IS NOT NULL THEN\n"
+" RETURN least(userargs[1]::integer,(rast1 + "
+"rast2)/2.);\n"
+" WHEN rast1 IS NULL AND rast2 IS NULL THEN\n"
+" RETURN userargs[2]::integer;\n"
+" WHEN rast1 IS NULL THEN\n"
+" RETURN greatest(rast2,random()*userargs[3]::"
+"integer)::integer;\n"
+" ELSE\n"
+" RETURN greatest(rast1, random()*userargs[4]::"
+"integer)::integer;\n"
+" END CASE;\n"
+"\n"
+" RETURN NULL;\n"
+" END;\n"
+" $$ LANGUAGE 'plpgsql' VOLATILE COST 1000;\n"
+" \n"
+"SELECT ST_MapAlgebraFct(m1.rast, 1, m1.rast, 3,\n"
+" 'raster_mapalgebra_userargs(double precision, double "
+"precision, integer[], text[])'::regprocedure,\n"
+" '8BUI', 'INTERSECT', "
+"'100','200','200','0') \n"
+" FROM map_shapes As m1\n"
+" WHERE m1.descrip = 'map bands overlay fct union "
+"(canvas)';"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6133
+#, no-c-format
+msgid "user defined with extra args and different bands from same raster"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6149
+#, no-c-format
+msgid "ST_MapAlgebraFctNgb"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6151
+#, no-c-format
+msgid ""
+"1-band version: Map Algebra Nearest Neighbor using user-defined PostgreSQL "
+"function. Return a raster which values are the result of a PLPGSQL user "
+"function involving a neighborhood of values from the input raster band."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6156
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_MapAlgebraFctNgb</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>band</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>ngbwidth</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>ngbheight</parameter></paramdef> "
+"<paramdef><type>regprocedure </type> <parameter>onerastngbuserfunc</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>nodatamode</"
+"parameter></paramdef> <paramdef><type>text[] </type> <parameter>VARIADIC "
+"args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6174
+#, no-c-format
+msgid ""
+"(one raster version) Return a raster which values are the result of a "
+"PLPGSQL user function involving a neighborhood of values from the input "
+"raster band. The user function takes the neighborhood of pixel values as an "
+"array of numbers, for each pixel, returns the result from the user function, "
+"replacing pixel value of currently inspected pixel with the function result."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:6182
+#, no-c-format
+msgid "rast"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6183
+#, no-c-format
+msgid "Raster on which the user function is evaluated."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:6186
+#, no-c-format
+msgid "band"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6187
+#, no-c-format
+msgid "Band number of the raster to be evaluated. Default to 1."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6191
+#, no-c-format
+msgid ""
+"The resulting pixel type of the output raster. Must be one listed in <xref "
+"linkend=\"RT_ST_BandPixelType\"/> or left out or set to NULL. If not passed "
+"in or set to NULL, will default to the pixeltype of the <varname>rast</"
+"varname>. Results are truncated if they are larger than what is allowed for "
+"the pixeltype."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:6194
+#, no-c-format
+msgid "ngbwidth"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6195
+#, no-c-format
+msgid "The width of the neighborhood, in cells."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:6198
+#, no-c-format
+msgid "ngbheight"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6199
+#, no-c-format
+msgid "The height of the neighborhood, in cells."
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:6202
+#, no-c-format
+msgid "onerastngbuserfunc"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6203
+#, no-c-format
+msgid ""
+"PLPGSQL/psql user function to apply to neighborhood pixels of a single band "
+"of a raster. The first element is a 2-dimensional array of numbers "
+"representing the rectangular pixel neighborhood"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:6207
+#, no-c-format
+msgid "nodatamode"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6208
+#, no-c-format
+msgid ""
+"Defines what value to pass to the function for a neighborhood pixel that is "
+"nodata or NULL"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6209
+#, no-c-format
+msgid ""
+"'ignore': any NODATA values encountered in the neighborhood are ignored by "
+"the computation -- this flag must be sent to the user callback function, and "
+"the user function decides how to ignore it."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6210
+#, no-c-format
+msgid ""
+"'NULL': any NODATA values encountered in the neighborhood will cause the "
+"resulting pixel to be NULL -- the user callback function is skipped in this "
+"case."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6211
+#, no-c-format
+msgid ""
+"'value': any NODATA values encountered in the neighborhood are replaced by "
+"the reference pixel (the one in the center of the neighborhood). Note that "
+"if this value is NODATA, the behavior is the same as 'NULL' (for the "
+"affected neighborhood)"
+msgstr ""
+
+#. Tag: term
+#: reference_raster.xml:6215
+#, no-c-format
+msgid "args"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6216
+#, no-c-format
+msgid "Arguments to pass into the user function."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6227
+#, no-c-format
+msgid ""
+"Examples utilize the katrina raster loaded as a single tile described in "
+"<ulink url=\"http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html\">http://"
+"trac.osgeo.org/gdal/wiki/frmts_wtkraster.html</ulink> and then prepared in "
+"the <xref linkend=\"RT_ST_Rescale\"/> examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6230
+#, no-c-format
+msgid ""
+"--\n"
+"-- A simple 'callback' user function that averages up all the values in a "
+"neighborhood.\n"
+"--\n"
+"CREATE OR REPLACE FUNCTION rast_avg(matrix float[][], nodatamode text, "
+"variadic args text[])\n"
+" RETURNS float AS\n"
+" $$\n"
+" DECLARE\n"
+" _matrix float[][];\n"
+" x1 integer;\n"
+" x2 integer;\n"
+" y1 integer;\n"
+" y2 integer;\n"
+" sum float;\n"
+" BEGIN\n"
+" _matrix := matrix;\n"
+" sum := 0;\n"
+" FOR x in array_lower(matrix, 1)..array_upper(matrix, 1) LOOP\n"
+" FOR y in array_lower(matrix, 2)..array_upper(matrix, 2) LOOP\n"
+" sum := sum + _matrix[x][y];\n"
+" END LOOP;\n"
+" END LOOP;\n"
+" RETURN (sum*1.0/(array_upper(matrix,1)*array_upper(matrix,2) ))::"
+"integer ;\n"
+" END;\n"
+" $$\n"
+"LANGUAGE 'plpgsql' IMMUTABLE COST 1000;\n"
+" \n"
+"-- now we apply to our raster averaging pixels within 2 pixels of each other "
+"in X and Y direction --\n"
+"SELECT ST_MapAlgebraFctNgb(rast, 1, '8BUI', 4,4,\n"
+" 'rast_avg(float[][], text, text[])'::regprocedure, 'NULL', "
+"NULL) As nn_with_border\n"
+" FROM katrinas_rescaled \n"
+" limit 1;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6241
+#, no-c-format
+msgid "First band of our raster"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6249
+#, no-c-format
+msgid "new raster after averaging pixels withing 4x4 pixels of each other"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6262
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_MapAlgebraExpr\"/>, <xref linkend=\"RT_ST_Rescale\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6268
+#, no-c-format
+msgid "ST_Polygon"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6269
+#, no-c-format
+msgid ""
+"Returns a multipolygon geometry formed by the union of pixels that have a "
+"pixel value that is not no data value. If no band number is specified, band "
+"num defaults to 1."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6275
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Polygon</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>integer </type> <parameter>band_num=1</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6285
+#, no-c-format
+msgid "Availability: 0.1.6 Requires GDAL 1.7 or higher."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6286
+#, no-c-format
+msgid ""
+"Enhanced: 2.1.0 Improved Speed (fully C-Based) and the returning "
+"multipolygon is ensured to be valid."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6287
+#, no-c-format
+msgid ""
+"Changed: 2.1.0 In prior versions would sometimes return a polygon, changed "
+"to always return multipolygon."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6292
+#, no-c-format
+msgid ""
+"-- by default no data band value is 0 or not set, so polygon will return a "
+"square polygon \n"
+"SELECT ST_AsText(ST_Polygon(rast)) As geomwkt\n"
+"FROM dummy_rast\n"
+"WHERE rid = 2;\n"
+"\n"
+"geomwkt\n"
+"--------------------------------------------\n"
+"MULTIPOLYGON(((3427927.75 5793244,3427928 5793244,3427928 "
+"5793243.75,3427927.75 5793243.75,3427927.75 5793244)))\n"
+" \n"
+" \n"
+"-- now we change the no data value of first band\n"
+"UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,1,254)\n"
+"WHERE rid = 2;\n"
+"SELECt rid, ST_BandNoDataValue(rast)\n"
+"from dummy_rast where rid = 2;\n"
+"\n"
+"-- ST_Polygon excludes the pixel value 254 and returns a multipolygon\n"
+"SELECT ST_AsText(ST_Polygon(rast)) As geomwkt\n"
+"FROM dummy_rast\n"
+"WHERE rid = 2;\n"
+"\n"
+"geomwkt\n"
+"---------------------------------------------------------\n"
+"MULTIPOLYGON(((3427927.9 5793243.95,3427927.85 5793243.95,3427927.85 "
+"5793244,3427927.9 5793244,3427927.9 5793243.95)),((3427928 "
+"5793243.85,3427928 5793243.8,3427927.95 5793243.8,3427927.95 "
+"5793243.85,3427927.9 5793243.85,3427927.9 5793243.9,3427927.9 "
+"5793243.95,3427927.95 5793243.95,3427928 5793243.95,3427928 5793243.85)),"
+"((3427927.8 5793243.75,3427927.75 5793243.75,3427927.75 5793243.8,3427927.75 "
+"5793243.85,3427927.75 5793243.9,3427927.75 5793244,3427927.8 "
+"5793244,3427927.8 5793243.9,3427927.8 5793243.85,3427927.85 "
+"5793243.85,3427927.85 5793243.8,3427927.85 5793243.75,3427927.8 "
+"5793243.75)))\n"
+"\n"
+"-- Or if you want the no data value different for just one time\n"
+"\n"
+"SELECT ST_AsText(\n"
+" ST_Polygon(\n"
+" ST_SetBandNoDataValue(rast,1,252)\n"
+" )\n"
+" ) As geomwkt\n"
+"FROM dummy_rast\n"
+"WHERE rid =2;\n"
+"\n"
+"geomwkt\n"
+"---------------------------------\n"
+"MULTIPOLYGON(((3427928 5793243.85,3427928 5793243.8,3427928 "
+"5793243.75,3427927.85 5793243.75,3427927.8 5793243.75,3427927.8 "
+"5793243.8,3427927.75 5793243.8,3427927.75 5793243.85,3427927.75 "
+"5793243.9,3427927.75 5793244,3427927.8 5793244,3427927.85 5793244,3427927.9 "
+"5793244,3427928 5793244,3427928 5793243.95,3427928 5793243.85),(3427927.9 "
+"5793243.9,3427927.9 5793243.85,3427927.95 5793243.85,3427927.95 "
+"5793243.9,3427927.9 5793243.9)))"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6302
+#, no-c-format
+msgid "ST_Reclass"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6303
+#, no-c-format
+msgid ""
+"Creates a new raster composed of band types reclassified from original. The "
+"nband is the band to be changed. If nband is not specified assumed to be 1. "
+"All other bands are returned unchanged. Use case: convert a 16BUI band to a "
+"8BUI and so forth for simpler rendering as viewable formats."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:6308
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>raster <function>ST_Reclass</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer </type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>reclassexpr</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>pixeltype</parameter></paramdef> "
+"<paramdef choice=\"opt\"><type>double precision </type> "
+"<parameter>nodataval=NULL</parameter></paramdef> </funcprototype> "
+"<funcprototype> <funcdef>raster <function>ST_Reclass</function></funcdef> "
+"<paramdef><type>raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>reclassarg[] </type> <parameter>VARIADIC reclassargset</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>raster "
+"<function>ST_Reclass</function></funcdef> <paramdef><type>raster </type> "
+"<parameter>rast</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>reclassexpr</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>pixeltype</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6336
+#, no-c-format
+msgid ""
+"Creates a new raster formed by applying a valid PostgreSQL algebraic "
+"operation defined by the <varname>reclassexpr</varname> on the input raster "
+"(<varname>rast</varname>). If no <varname>band</varname> is specified band 1 "
+"is assumed. The new raster will have the same georeference, width, and "
+"height as the original raster. Bands not designated will come back "
+"unchanged. Refer to <xref linkend=\"reclassarg\"/> for description of valid "
+"reclassification expressions."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6340
+#, no-c-format
+msgid ""
+"The bands of the new raster will have pixel type of <varname>pixeltype</"
+"varname>. If <varname>reclassargset</varname> is passed in then each "
+"reclassarg defines behavior of each band generated."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6347
+#, no-c-format
+msgid "Examples Basic"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6349
+#, no-c-format
+msgid ""
+"Create a new raster from the original where band 2 is converted from 8BUI to "
+"4BUI and all values from 101-254 are set to nodata value."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6350
+#, no-c-format
+msgid ""
+"ALTER TABLE dummy_rast ADD COLUMN reclass_rast raster;\n"
+"UPDATE dummy_rast SET reclass_rast = ST_Reclass(rast,2,'0-87:1-10, "
+"88-100:11-15, 101-254:0-0', '4BUI',0) WHERE rid = 2;\n"
+"\n"
+"SELECT i as col, j as row, ST_Value(rast,2,i,j) As origval, \n"
+" ST_Value(reclass_rast, 2, i, j) As reclassval, \n"
+" ST_Value(reclass_rast, 2, i, j, false) As reclassval_include_nodata\n"
+"FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN "
+"generate_series(1,3) AS j\n"
+"WHERE rid = 2;\n"
+"\n"
+" col | row | origval | reclassval | reclassval_include_nodata\n"
+"-----+-----+---------+------------+---------------------------\n"
+" 1 | 1 | 78 | 9 | 9\n"
+" 2 | 1 | 98 | 14 | 14\n"
+" 3 | 1 | 122 | | 0\n"
+" 1 | 2 | 96 | 14 | 14\n"
+" 2 | 2 | 118 | | 0\n"
+" 3 | 2 | 180 | | 0\n"
+" 1 | 3 | 99 | 15 | 15\n"
+" 2 | 3 | 112 | | 0\n"
+" 3 | 3 | 169 | | 0"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6354
+#, no-c-format
+msgid "Example: Advanced using multiple reclassargs"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6356
+#, no-c-format
+msgid ""
+"Create a new raster from the original where band 1,2,3 is converted to "
+"1BB,4BUI, 4BUI respectively and reclassified. Note this uses the variadic "
+"<varname>reclassarg</varname> argument which can take as input an indefinite "
+"number of reclassargs (theoretically as many bands as you have)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6358
+#, no-c-format
+msgid ""
+"UPDATE dummy_rast SET reclass_rast = \n"
+" ST_Reclass(rast,\n"
+" ROW(2,'0-87]:1-10, (87-100]:11-15, (101-254]:0-0', '4BUI',NULL)::"
+"reclassarg,\n"
+" ROW(1,'0-253]:1, 254:0', '1BB', NULL)::reclassarg,\n"
+" ROW(3,'0-70]:1, (70-86:2, [86-150):3, [150-255:4', '4BUI', NULL)::"
+"reclassarg\n"
+" ) WHERE rid = 2;\n"
+"\n"
+"SELECT i as col, j as row,ST_Value(rast,1,i,j) As ov1, "
+"ST_Value(reclass_rast, 1, i, j) As rv1, \n"
+" ST_Value(rast,2,i,j) As ov2, ST_Value(reclass_rast, 2, i, j) As rv2, \n"
+" ST_Value(rast,3,i,j) As ov3, ST_Value(reclass_rast, 3, i, j) As rv3\n"
+"FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN "
+"generate_series(1,3) AS j\n"
+"WHERE rid = 2;\n"
+"\n"
+"col | row | ov1 | rv1 | ov2 | rv2 | ov3 | rv3\n"
+"----+-----+-----+-----+-----+-----+-----+-----\n"
+" 1 | 1 | 253 | 1 | 78 | 9 | 70 | 1\n"
+" 2 | 1 | 254 | 0 | 98 | 14 | 86 | 3\n"
+" 3 | 1 | 253 | 1 | 122 | 0 | 100 | 3\n"
+" 1 | 2 | 253 | 1 | 96 | 14 | 80 | 2\n"
+" 2 | 2 | 254 | 0 | 118 | 0 | 108 | 3\n"
+" 3 | 2 | 254 | 0 | 180 | 0 | 162 | 4\n"
+" 1 | 3 | 250 | 1 | 99 | 15 | 90 | 3\n"
+" 2 | 3 | 254 | 0 | 112 | 0 | 108 | 3\n"
+" 3 | 3 | 254 | 0 | 169 | 0 | 175 | 4"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6361
+#, no-c-format
+msgid ""
+"Example: Advanced Map a single band 32BF raster to multiple viewable bands"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6363
+#, no-c-format
+msgid ""
+"Create a new 3 band (8BUI,8BUI,8BUI viewable raster) from a raster that has "
+"only one 32bf band"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6364
+#, no-c-format
+msgid ""
+"ALTER TABLE wind ADD COLUMN rast_view raster;\n"
+"UPDATE wind \n"
+" set rast_view = ST_AddBand( NULL,\n"
+" ARRAY[\n"
+" ST_Reclass(rast, 1,'0.1-10]:1-10,9-10]:11,(11-33:0'::text, "
+"'8BUI'::text,0),\n"
+" ST_Reclass(rast,1, '11-33):0-255,[0-32:0,(34-1000:0'::text, "
+"'8BUI'::text,0), \n"
+" ST_Reclass(rast,1,'0-32]:0,(32-100:100-255'::text, '8BUI'::"
+"text,0)\n"
+" ]\n"
+" ) ;"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6370
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Band\"/>, <xref linkend=\"RT_ST_BandPixelType\"/>, "
+"<xref linkend=\"RT_ST_MakeEmptyRaster\"/>, <xref linkend=\"reclassarg\"/>, "
+"<xref linkend=\"RT_ST_Value\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6376
+#, no-c-format
+msgid "ST_Union"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6377
+#, no-c-format
+msgid ""
+"Returns the union of a set of raster tiles into a single raster composed of "
+"1 or more bands."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6382
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_Union</function></funcdef> "
+"<paramdef><type>setof raster </type> <parameter>rast</parameter></paramdef>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6388
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_Union</function></funcdef> "
+"<paramdef><type>setof raster </type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>unionarg[] </type> <parameter>unionargset</parameter></"
+"paramdef>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6395
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_Union</function></funcdef> "
+"<paramdef><type>setof raster</type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>nband</parameter></paramdef>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6402
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_Union</function></funcdef> "
+"<paramdef><type>setof raster</type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>uniontype</parameter></paramdef>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6409
+#, no-c-format
+msgid ""
+"<funcdef>raster <function>ST_Union</function></funcdef> "
+"<paramdef><type>setof raster</type> <parameter>rast</parameter></paramdef> "
+"<paramdef><type>integer</type> <parameter>nband</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>uniontype</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6421
+#, no-c-format
+msgid ""
+"Returns the union of a set of raster tiles into a single raster composed of "
+"at least one band. If <varname>nband</varname> is not specified, band 1 is "
+"assumed. The resulting raster's extent is the extent of the whole set. In "
+"the case of intersection, the resulting value is defined by "
+"<varname>uniontype</varname> which is one of the following: LAST (default), "
+"FIRST, MIN, MAX, COUNT, SUM, MEAN."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6424
+#, no-c-format
+msgid "Enhanced: 2.1.0 Improved Speed (fully C-Based)."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6425
+#, no-c-format
+msgid ""
+"Changed: 2.1.0 ST_Union(rast) now unions all bands of all input rasters. "
+"Prior versions only unioned the first band of all input rasters."
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6429
+#, no-c-format
+msgid "Examples: Reconstitute a single band chunked raster tile"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6430
+#, no-c-format
+msgid ""
+"-- this creates a single band from first band of raster tiles\n"
+"-- that form the original file system tile\n"
+"SELECT filename, ST_Union(rast,1) As file_rast\n"
+"FROM sometable WHERE filename IN('dem01', 'dem02') GROUP BY filename;"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6434 reference_raster.xml:6442
+#, no-c-format
+msgid ""
+"Examples: Return a multi-band raster that is the union of tiles intersecting "
+"geometry"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6435
+#, no-c-format
+msgid ""
+"-- this creates a multi band raster collecting all the tiles that intersect "
+"a line -- Note: In 2.0, this would have just returned a single band raster "
+"-- , new union works on all bands by default -- this is equivalent to "
+"unionarg: ARRAY[ROW(1, 'LAST'), ROW(2, 'LAST'), ROW(3, 'LAST')]::unionarg[]"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6439
+#, no-c-format
+msgid ""
+"SELECT ST_Union(rast)\n"
+"FROM aerials.boston\n"
+"WHERE ST_Intersects(rast, ST_GeomFromText('LINESTRING(230486 887771, 230500 "
+"88772)',26986) );"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6443
+#, no-c-format
+msgid ""
+"Here we use the longer syntax if we only wanted a subset of bands or we want "
+"to change order of bands"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6444
+#, no-c-format
+msgid ""
+"-- this creates a multi band raster collecting all the tiles that intersect "
+"a line\n"
+"SELECT ST_Union(rast,ARRAY[ROW(2, 'LAST'), ROW(1, 'LAST'), ROW(3, 'LAST')]::"
+"unionarg[])\n"
+"FROM aerials.boston\n"
+"WHERE ST_Intersects(rast, ST_GeomFromText('LINESTRING(230486 887771, 230500 "
+"88772)',26986) );"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6450
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Envelope\"/>, <xref linkend=\"RT_ST_ConvexHull\"/>, "
+"<xref linkend=\"RT_ST_Clip\"/>"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6461
+#, no-c-format
+msgid "Raster Processing Builtin Functions"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6464
+#, no-c-format
+msgid "ST_Min4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6465
+#, no-c-format
+msgid ""
+"Raster processing function that calculates the minimum pixel value in a "
+"neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6470
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_Min4ma</function></funcdef> "
+"<paramdef><type>float8[][]</type> <parameter>matrix</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>nodatamode</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6482
+#, no-c-format
+msgid "Calculate the minimum pixel value in a neighborhood of pixels."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6485 reference_raster.xml:6535
+#: reference_raster.xml:6585 reference_raster.xml:6635
+#: reference_raster.xml:6684 reference_raster.xml:6734
+#: reference_raster.xml:6784 reference_raster.xml:6855
+#: reference_raster.xml:6904
+#, no-c-format
+msgid ""
+"This function is a specialized callback function for use as a callback "
+"parameter to <xref linkend=\"RT_ST_MapAlgebraFctNgb\"/>."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6494
+#, no-c-format
+msgid ""
+"SELECT \n"
+" rid,\n"
+" st_value(\n"
+" st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_min4ma(float[][],text,"
+"text[])'::regprocedure, 'ignore', NULL), 2, 2\n"
+" ) \n"
+"FROM dummy_rast \n"
+"WHERE rid = 2;\n"
+" rid | st_value\n"
+"-----+----------\n"
+" 2 | 250\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6500
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Max4ma\"/>, <xref linkend=\"RT_ST_Sum4ma\"/>, <xref "
+"linkend=\"RT_ST_Mean4ma\"/>, <xref linkend=\"RT_ST_Range4ma\"/>, <xref "
+"linkend=\"RT_ST_Distinct4ma\"/> <xref linkend=\"RT_ST_StdDev4ma\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6514
+#, no-c-format
+msgid "ST_Max4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6515
+#, no-c-format
+msgid ""
+"Raster processing function that calculates the maximum pixel value in a "
+"neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6520
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_Max4ma</function></funcdef> "
+"<paramdef><type>float8[][]</type> <parameter>matrix</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>nodatamode</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6532
+#, no-c-format
+msgid "Calculate the maximum pixel value in a neighborhood of pixels."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6544
+#, no-c-format
+msgid ""
+"SELECT \n"
+" rid,\n"
+" st_value(\n"
+" st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_max4ma(float[][],text,"
+"text[])'::regprocedure, 'ignore', NULL), 2, 2\n"
+" ) \n"
+"FROM dummy_rast \n"
+"WHERE rid = 2;\n"
+" rid | st_value\n"
+"-----+----------\n"
+" 2 | 254\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6550
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Min4ma\"/>, <xref linkend=\"RT_ST_Sum4ma\"/>, <xref "
+"linkend=\"RT_ST_Mean4ma\"/>, <xref linkend=\"RT_ST_Range4ma\"/>, <xref "
+"linkend=\"RT_ST_Distinct4ma\"/> <xref linkend=\"RT_ST_StdDev4ma\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6564
+#, no-c-format
+msgid "ST_Sum4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6565
+#, no-c-format
+msgid ""
+"Raster processing function that calculates the sum of all pixel values in a "
+"neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6570
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_Sum4ma</function></funcdef> "
+"<paramdef><type>float8[][]</type> <parameter>matrix</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>nodatamode</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6582
+#, no-c-format
+msgid "Calculate the sum of all pixel values in a neighborhood of pixels."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6594
+#, no-c-format
+msgid ""
+"SELECT \n"
+" rid,\n"
+" st_value(\n"
+" st_mapalgebrafctngb(rast, 1, '32BF', 1, 1, 'st_sum4ma(float[][],text,"
+"text[])'::regprocedure, 'ignore', NULL), 2, 2\n"
+" ) \n"
+"FROM dummy_rast \n"
+"WHERE rid = 2;\n"
+" rid | st_value\n"
+"-----+----------\n"
+" 2 | 2279\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6600
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Min4ma\"/>, <xref linkend=\"RT_ST_Max4ma\"/>, <xref "
+"linkend=\"RT_ST_Mean4ma\"/>, <xref linkend=\"RT_ST_Range4ma\"/>, <xref "
+"linkend=\"RT_ST_Distinct4ma\"/> <xref linkend=\"RT_ST_StdDev4ma\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6614
+#, no-c-format
+msgid "ST_Mean4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6615
+#, no-c-format
+msgid ""
+"Raster processing function that calculates the mean pixel value in a "
+"neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6620
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_Mean4ma</function></funcdef> "
+"<paramdef><type>float8[][]</type> <parameter>matrix</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>nodatamode</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6632
+#, no-c-format
+msgid "Calculate the mean pixel value in a neighborhood of pixels."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6644
+#, no-c-format
+msgid ""
+"SELECT \n"
+" rid,\n"
+" st_value(\n"
+" st_mapalgebrafctngb(rast, 1, '32BF', 1, 1, 'st_mean4ma(float[][],"
+"text,text[])'::regprocedure, 'ignore', NULL), 2, 2\n"
+" ) \n"
+"FROM dummy_rast \n"
+"WHERE rid = 2;\n"
+" rid | st_value\n"
+"-----+------------------\n"
+" 2 | 253.222229003906\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6650
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Min4ma\"/>, <xref linkend=\"RT_ST_Max4ma\"/>, <xref "
+"linkend=\"RT_ST_Sum4ma\"/>, <xref linkend=\"RT_ST_Range4ma\"/>, <xref "
+"linkend=\"RT_ST_StdDev4ma\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6663
+#, no-c-format
+msgid "ST_Range4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6664
+#, no-c-format
+msgid ""
+"Raster processing function that calculates the range of pixel values in a "
+"neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6669
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_Range4ma</function></funcdef> "
+"<paramdef><type>float8[][]</type> <parameter>matrix</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>nodatamode</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6681
+#, no-c-format
+msgid "Calculate the range of pixel values in a neighborhood of pixels."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6693
+#, no-c-format
+msgid ""
+"SELECT \n"
+" rid,\n"
+" st_value(\n"
+" st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_range4ma(float[][],text,"
+"text[])'::regprocedure, 'ignore', NULL), 2, 2\n"
+" ) \n"
+"FROM dummy_rast \n"
+"WHERE rid = 2;\n"
+" rid | st_value\n"
+"-----+----------\n"
+" 2 | 4\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6699 reference_raster.xml:6749
+#: reference_raster.xml:6799
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Min4ma\"/>, <xref linkend=\"RT_ST_Max4ma\"/>, <xref "
+"linkend=\"RT_ST_Sum4ma\"/>, <xref linkend=\"RT_ST_Mean4ma\"/>, <xref linkend="
+"\"RT_ST_Distinct4ma\"/> <xref linkend=\"RT_ST_StdDev4ma\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6713
+#, no-c-format
+msgid "ST_Distinct4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6714
+#, no-c-format
+msgid ""
+"Raster processing function that calculates the number of unique pixel values "
+"in a neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6719
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_Distinct4ma</function></funcdef> "
+"<paramdef><type>float8[][]</type> <parameter>matrix</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>nodatamode</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6731
+#, no-c-format
+msgid ""
+"Calculate the number of unique pixel values in a neighborhood of pixels."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6743
+#, no-c-format
+msgid ""
+"SELECT \n"
+" rid,\n"
+" st_value(\n"
+" st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_distinct4ma(float[][],"
+"text,text[])'::regprocedure, 'ignore', NULL), 2, 2\n"
+" ) \n"
+"FROM dummy_rast \n"
+"WHERE rid = 2;\n"
+" rid | st_value\n"
+"-----+----------\n"
+" 2 | 3\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6763
+#, no-c-format
+msgid "ST_StdDev4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6764
+#, no-c-format
+msgid ""
+"Raster processing function that calculates the standard deviation of pixel "
+"values in a neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6769
+#, no-c-format
+msgid ""
+"<funcdef>float8 <function>ST_StdDev4ma</function></funcdef> "
+"<paramdef><type>float8[][]</type> <parameter>matrix</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>nodatamode</parameter></paramdef> "
+"<paramdef><type>text[]</type> <parameter>VARIADIC args</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6781
+#, no-c-format
+msgid ""
+"Calculate the standard deviation of pixel values in a neighborhood of pixels."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6793
+#, no-c-format
+msgid ""
+"SELECT \n"
+" rid,\n"
+" st_value(\n"
+" st_mapalgebrafctngb(rast, 1, '32BF', 1, 1, 'st_stddev4ma(float[][],"
+"text,text[])'::regprocedure, 'ignore', NULL), 2, 2\n"
+" ) \n"
+"FROM dummy_rast \n"
+"WHERE rid = 2;\n"
+" rid | st_value\n"
+"-----+------------------\n"
+" 2 | 1.30170822143555\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6813
+#, no-c-format
+msgid "ST_InvDistWeight4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6814
+#, no-c-format
+msgid ""
+"Raster processing function that interpolates a pixel's value from the "
+"pixel's neighborhood."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6819
+#, no-c-format
+msgid ""
+"<funcdef>double precision <function>ST_InvDistWeight4ma</function></funcdef> "
+"<paramdef><type>double precision[][]</type> <parameter>matrix</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>nodatamode</parameter></"
+"paramdef> <paramdef><type>text[]</type> <parameter>VARIADIC args</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6831
+#, no-c-format
+msgid ""
+"Calculate an interpolated value for a pixel using the Inverse Distance "
+"Weighted method."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6833
+#, no-c-format
+msgid ""
+"There are two optional parameters that can be passed through <varname>args</"
+"varname>. The first parameter is the power factor (variable k in the "
+"equation below) between 0 and 1 used in the Inverse Distance Weighted "
+"equation. If not specified, default value is 1. The second parameter is the "
+"weight percentage applied only when the value of the pixel of interest is "
+"included with the interpolated value from the neighborhood. If not specified "
+"and the pixel of interest has a value, that value is returned."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6837
+#, no-c-format
+msgid "The basic inverse distance weight equation is:"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6846
+#, no-c-format
+msgid "k = power factor, a real number between 0 and 1"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6863 reference_raster.xml:6912
+#, no-c-format
+msgid "-- NEEDS EXAMPLE"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6868
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_MinDist4ma\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6877
+#, no-c-format
+msgid "ST_MinDist4ma"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6878
+#, no-c-format
+msgid ""
+"Raster processing function that returns the minimum distance (in number of "
+"pixels) between the pixel of interest and a neighboring pixel with value."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6883
+#, no-c-format
+msgid ""
+"<funcdef>double precision <function>ST_MinDist4ma</function></funcdef> "
+"<paramdef><type>double precision[][]</type> <parameter>matrix</parameter></"
+"paramdef> <paramdef><type>text </type> <parameter>nodatamode</parameter></"
+"paramdef> <paramdef><type>text[]</type> <parameter>VARIADIC args</"
+"parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6895
+#, no-c-format
+msgid ""
+"Return the shortest distance (in number of pixels) between the pixel of "
+"interest and the closest pixel with value in the neighborhood."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6898
+#, no-c-format
+msgid ""
+"The intent of this function is to provide an informative data point that "
+"helps infer the usefulness of the pixel of interest's interpolated value "
+"from <xref linkend=\"RT_ST_InvDistWeight4ma\"/>. This function is "
+"particularly useful when the neighborhood is sparsely populated."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6917
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_InvDistWeight4ma\"/>"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:6927
+#, no-c-format
+msgid "Raster Operators"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6930
+#, no-c-format
+msgid "&&"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6932
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box intersects B's bounding "
+"box."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6937
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>&&</function></funcdef> <paramdef> "
+"<type>raster </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>raster </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6958
+#, no-c-format
+msgid ""
+"The <varname>&&</varname> operator returns <varname>TRUE</varname> "
+"if the bounding box of raster A intersects the bounding box of raster B."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:6960 reference_raster.xml:7939
+#: reference_raster.xml:8040 reference_raster.xml:8133
+#, no-c-format
+msgid ""
+"This operand will make use of any indexes that may be available on the "
+"rasters."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:6968
+#, no-c-format
+msgid ""
+"SELECT A.rid As a_rid, B.rid As b_rid, A.rast && B.rast As "
+"intersect\n"
+" FROM dummy_rast AS A CROSS JOIN dummy_rast AS B LIMIT 3;\n"
+"\n"
+" a_rid | b_rid | intersect\n"
+"-------+-------+---------\n"
+" 2 | 2 | t\n"
+" 2 | 3 | f\n"
+" 2 | 1 | f"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:6974
+#, no-c-format
+msgid "&<"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:6976
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is to the left of B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:6981
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>&<</function></funcdef> <paramdef> "
+"<type>raster </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>raster </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7002
+#, no-c-format
+msgid ""
+"The <varname>&<</varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of raster A overlaps or is to the left of the bounding box "
+"of raster B, or more accurately, overlaps or is NOT to the right of the "
+"bounding box of raster B."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7006 reference_raster.xml:7051
+#, no-c-format
+msgid ""
+"This operand will make use of any indexes that may be available on the "
+"geometries."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7013
+#, no-c-format
+msgid ""
+"SELECT A.rid As a_rid, B.rid As b_rid, A.rast &< B.rast As overleft\n"
+" FROM dummy_rast AS A CROSS JOIN dummy_rast AS B;\n"
+"\n"
+"a_rid | b_rid | overleft\n"
+"------+-------+----------\n"
+" 2 | 2 | t\n"
+" 2 | 3 | f\n"
+" 2 | 1 | f\n"
+" 3 | 2 | t\n"
+" 3 | 3 | t\n"
+" 3 | 1 | f\n"
+" 1 | 2 | t\n"
+" 1 | 3 | t\n"
+" 1 | 1 | t"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7019
+#, no-c-format
+msgid "&>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7021
+#, no-c-format
+msgid ""
+"Returns <varname>TRUE</varname> if A's bounding box is to the right of B's."
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_raster.xml:7026
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>&></function></funcdef> <paramdef> "
+"<type>raster </type> <parameter>A</parameter> </paramdef> <paramdef> "
+"<type>raster </type> <parameter>B</parameter> </paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7047
+#, no-c-format
+msgid ""
+"The <varname>&></varname> operator returns <varname>TRUE</varname> if "
+"the bounding box of raster A overlaps or is to the right of the bounding box "
+"of raster B, or more accurately, overlaps or is NOT to the left of the "
+"bounding box of raster B."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7058
+#, no-c-format
+msgid ""
+"SELECT A.rid As a_rid, B.rid As b_rid, A.rast &> B.rast As overright\n"
+" FROM dummy_rast AS A CROSS JOIN dummy_rast AS B;\n"
+"\n"
+" a_rid | b_rid | overright\n"
+"-------+-------+----------\n"
+" 2 | 2 | t\n"
+" 2 | 3 | t\n"
+" 2 | 1 | t\n"
+" 3 | 2 | f\n"
+" 3 | 3 | t\n"
+" 3 | 1 | f\n"
+" 1 | 2 | f\n"
+" 1 | 3 | t\n"
+" 1 | 1 | t"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:7064
+#, no-c-format
+msgid "Raster and Raster Band Spatial Relationships"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7068
+#, no-c-format
+msgid "ST_Contains"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7069
+#, no-c-format
+msgid ""
+"Return true if no points of raster rastB lie in the exterior of raster rastA "
+"and at least one point of the interior of rastB lies in the interior of "
+"rastA."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7075
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Contains</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Contains</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rastA</"
+"parameter> </paramdef> <paramdef> <type>raster </type> <parameter>rastB</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7114
+#, no-c-format
+msgid ""
+"Raster rastA contains rastB if and only if no points of rastB lie in the "
+"exterior of rastA and at least one point of the interior of rastB lies in "
+"the interior of rastA. If the band number is not provided (or set to NULL), "
+"only the convex hull of the raster is considered in the test. If the band "
+"number is provided, only those pixels with value (not NODATA) are considered "
+"in the test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7119 reference_raster.xml:7212
+#: reference_raster.xml:7293 reference_raster.xml:7374
+#: reference_raster.xml:7584 reference_raster.xml:7668
+#: reference_raster.xml:7748
+#, no-c-format
+msgid ""
+"This function will make use of any indexes that may be available on the "
+"rasters."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7125
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_Contains(ST_Polygon(raster), geometry) or "
+"ST_Contains(geometry, ST_Polygon(raster))."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7131
+#, no-c-format
+msgid ""
+"ST_Contains() is the inverse of ST_Within(). So, ST_Contains(rastA, rastB) "
+"implies ST_Within(rastB, rastA)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7142
+#, no-c-format
+msgid ""
+"-- specified band numbers\n"
+"SELECT r1.rid, r2.rid, ST_Contains(r1.rast, 1, r2.rast, 1) FROM dummy_rast "
+"r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 1;\n"
+"\n"
+"NOTICE: The first raster provided has no bands\n"
+" rid | rid | st_contains \n"
+"-----+-----+-------------\n"
+" 1 | 1 | \n"
+" 1 | 2 | f"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7144
+#, no-c-format
+msgid ""
+"-- no band numbers specified\n"
+"SELECT r1.rid, r2.rid, ST_Contains(r1.rast, r2.rast) FROM dummy_rast r1 "
+"CROSS JOIN dummy_rast r2 WHERE r1.rid = 1;\n"
+" rid | rid | st_contains \n"
+"-----+-----+-------------\n"
+" 1 | 1 | t\n"
+" 1 | 2 | f"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7148
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Within\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7157
+#, no-c-format
+msgid "ST_ContainsProperly"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7158
+#, no-c-format
+msgid ""
+"Return true if rastB intersects the interior of rastA but not the boundary "
+"or exterior of rastA."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7164
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_ContainsProperly</function></"
+"funcdef> <paramdef> <type>raster </type> <parameter>rastA</parameter> </"
+"paramdef> <paramdef> <type>integer </type> <parameter>nbandA</parameter> </"
+"paramdef> <paramdef> <type>raster </type> <parameter>rastB</parameter> </"
+"paramdef> <paramdef> <type>integer </type> <parameter>nbandB</parameter> </"
+"paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>ST_ContainsProperly</function></funcdef> <paramdef> <type>raster </"
+"type> <parameter>rastA</parameter> </paramdef> <paramdef> <type>raster </"
+"type> <parameter>rastB</parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7203
+#, no-c-format
+msgid ""
+"Raster rastA contains properly rastB if rastB intersects the interior of "
+"rastA but not the boundary or exterior of rastA. If the band number is not "
+"provided (or set to NULL), only the convex hull of the raster is considered "
+"in the test. If the band number is provided, only those pixels with value "
+"(not NODATA) are considered in the test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7207
+#, no-c-format
+msgid "Raster rastA does not contain properly itself but does contain itself."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7218
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_ContainsProperly(ST_Polygon(raster), geometry) or "
+"ST_ContainsProperly(geometry, ST_Polygon(raster))."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7229
+#, no-c-format
+msgid ""
+"SELECT r1.rid, r2.rid, ST_ContainsProperly(r1.rast, 1, r2.rast, 1) FROM "
+"dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_containsproperly \n"
+"-----+-----+---------------------\n"
+" 2 | 1 | f\n"
+" 2 | 2 | f"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7233
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Contains\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7242
+#, no-c-format
+msgid "ST_Covers"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7243
+#, no-c-format
+msgid "Return true if no points of raster rastB lie outside raster rastA."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7249
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Covers</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Covers</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rastA</"
+"parameter> </paramdef> <paramdef> <type>raster </type> <parameter>rastB</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7288
+#, no-c-format
+msgid ""
+"Raster rastA covers rastB if and only if no points of rastB lie in the "
+"exterior of rastA. If the band number is not provided (or set to NULL), only "
+"the convex hull of the raster is considered in the test. If the band number "
+"is provided, only those pixels with value (not NODATA) are considered in the "
+"test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7299
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_Covers(ST_Polygon(raster), geometry) or "
+"ST_Covers(geometry, ST_Polygon(raster))."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7310
+#, no-c-format
+msgid ""
+"SELECT r1.rid, r2.rid, ST_Covers(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 "
+"CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_covers \n"
+"-----+-----+-----------\n"
+" 2 | 1 | f\n"
+" 2 | 2 | t"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7314
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_CoveredBy\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7323
+#, no-c-format
+msgid "ST_CoveredBy"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7324
+#, no-c-format
+msgid "Return true if no points of raster rastA lie outside raster rastB."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7330
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_CoveredBy</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_CoveredBy</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rastA</"
+"parameter> </paramdef> <paramdef> <type>raster </type> <parameter>rastB</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7369
+#, no-c-format
+msgid ""
+"Raster rastA is covered by rastB if and only if no points of rastA lie in "
+"the exterior of rastB. If the band number is not provided (or set to NULL), "
+"only the convex hull of the raster is considered in the test. If the band "
+"number is provided, only those pixels with value (not NODATA) are considered "
+"in the test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7380
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_CoveredBy(ST_Polygon(raster), geometry) or "
+"ST_CoveredBy(geometry, ST_Polygon(raster))."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7391
+#, no-c-format
+msgid ""
+"SELECT r1.rid, r2.rid, ST_CoveredBy(r1.rast, 1, r2.rast, 1) FROM dummy_rast "
+"r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_coveredby \n"
+"-----+-----+--------------\n"
+" 2 | 1 | f\n"
+" 2 | 2 | t"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7395
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Covers\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7404
+#, no-c-format
+msgid "ST_Disjoint"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7405
+#, no-c-format
+msgid "Return true if raster rastA does not spatially intersect rastB."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7411
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Disjoint</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Disjoint</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rastA</"
+"parameter> </paramdef> <paramdef> <type>raster </type> <parameter>rastB</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7450
+#, no-c-format
+msgid ""
+"Raster rastA and rastB are disjointed if they do not share any space "
+"together. If the band number is not provided (or set to NULL), only the "
+"convex hull of the raster is considered in the test. If the band number is "
+"provided, only those pixels with value (not NODATA) are considered in the "
+"test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7455
+#, no-c-format
+msgid "This function does NOT use any indexes."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7461
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_Disjoint(ST_Polygon(raster), geometry)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7472
+#, no-c-format
+msgid ""
+"-- rid = 1 has no bands, hence the NOTICE and the NULL value for "
+"st_disjoint\n"
+"SELECT r1.rid, r2.rid, ST_Disjoint(r1.rast, 1, r2.rast, 1) FROM dummy_rast "
+"r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+"NOTICE: The second raster provided has no bands\n"
+" rid | rid | st_disjoint \n"
+"-----+-----+-------------\n"
+" 2 | 1 | \n"
+" 2 | 2 | f"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7474
+#, no-c-format
+msgid ""
+"-- this time, without specifying band numbers\n"
+"SELECT r1.rid, r2.rid, ST_Disjoint(r1.rast, r2.rast) FROM dummy_rast r1 "
+"CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_disjoint \n"
+"-----+-----+-------------\n"
+" 2 | 1 | t\n"
+" 2 | 2 | f"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7487
+#, no-c-format
+msgid "ST_Intersects"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7488
+#, no-c-format
+msgid "Return true if raster rastA spatially intersects raster rastB."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7492
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Intersects</function></"
+"funcdef> <paramdef> <type>raster </type> <parameter>rastA</parameter> </"
+"paramdef> <paramdef> <type>integer </type> <parameter>nbandA</parameter> </"
+"paramdef> <paramdef> <type>raster </type> <parameter>rastB</parameter> </"
+"paramdef> <paramdef> <type>integer </type> <parameter>nbandB</parameter> </"
+"paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>ST_Intersects</function></funcdef> <paramdef> <type>raster </type> "
+"<parameter>rastA</parameter> </paramdef> <paramdef> <type>raster </type> "
+"<parameter>rastB</parameter> </paramdef> </funcprototype> <funcprototype> "
+"<funcdef>boolean <function>ST_Intersects</function></funcdef> <paramdef> "
+"<type>raster </type> <parameter>rast</parameter> </paramdef> <paramdef> "
+"<type>integer </type> <parameter>nband</parameter> </paramdef> <paramdef> "
+"<type>geometry </type> <parameter>geommin</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Intersects</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rast</"
+"parameter> </paramdef> <paramdef> <type>geometry </type> <parameter>geommin</"
+"parameter> </paramdef> <paramdef choice=\"opt\"> <type>integer </type> "
+"<parameter>nband=NULL</parameter> </paramdef> </funcprototype> "
+"<funcprototype> <funcdef>boolean <function>ST_Intersects</function></"
+"funcdef> <paramdef> <type>geometry </type> <parameter>geommin</parameter> </"
+"paramdef> <paramdef> <type>raster </type> <parameter>rast</parameter> </"
+"paramdef> <paramdef choice=\"opt\"> <type>integer </type> "
+"<parameter>nband=NULL</parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7579
+#, no-c-format
+msgid ""
+"Return true if raster rastA spatially intersects raster rastB. If the band "
+"number is not provided (or set to NULL), only the convex hull of the raster "
+"is considered in the test. If the band number is provided, only those pixels "
+"with value (not NODATA) are considered in the test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7589
+#, no-c-format
+msgid "Enhanced: 2.0.0 support raster/raster intersects was introduced."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7594
+#, no-c-format
+msgid ""
+"Changed: 2.1.0 The behavior of the ST_Intersects(raster, geometry) variants "
+"changed to match that of ST_Intersects(geometry, raster)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7603
+#, no-c-format
+msgid ""
+"-- different bands of same raster\n"
+"SELECT ST_Intersects(rast, 2, rast, 3) FROM dummy_rast WHERE rid = 2;\n"
+"\n"
+" st_intersects \n"
+"---------------\n"
+" t"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7608
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_Disjoint\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7617
+#, no-c-format
+msgid "ST_Overlaps"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7618
+#, no-c-format
+msgid ""
+"Return true if raster rastA and rastB intersect but one does not completely "
+"contain the other."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7624
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Overlaps</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Overlaps</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rastA</"
+"parameter> </paramdef> <paramdef> <type>raster </type> <parameter>rastB</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7663
+#, no-c-format
+msgid ""
+"Return true if raster rastA spatially overlaps raster rastB. This means that "
+"rastA and rastB intersect but one does not completely contain the other. If "
+"the band number is not provided (or set to NULL), only the convex hull of "
+"the raster is considered in the test. If the band number is provided, only "
+"those pixels with value (not NODATA) are considered in the test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7674
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_Overlaps(ST_Polygon(raster), geometry)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7685
+#, no-c-format
+msgid ""
+"-- comparing different bands of same raster\n"
+"SELECT ST_Overlaps(rast, 1, rast, 2) FROM dummy_rast WHERE rid = 2;\n"
+"\n"
+" st_overlaps \n"
+"-------------\n"
+" f"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7697
+#, no-c-format
+msgid "ST_Touches"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7698
+#, no-c-format
+msgid ""
+"Return true if raster rastA and rastB have at least one point in common but "
+"their interiors do not intersect."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7704
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Touches</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Touches</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rastA</"
+"parameter> </paramdef> <paramdef> <type>raster </type> <parameter>rastB</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7743
+#, no-c-format
+msgid ""
+"Return true if raster rastA spatially touches raster rastB. This means that "
+"rastA and rastB have at least one point in common but their interiors do not "
+"intersect. If the band number is not provided (or set to NULL), only the "
+"convex hull of the raster is considered in the test. If the band number is "
+"provided, only those pixels with value (not NODATA) are considered in the "
+"test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7754
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_Touches(ST_Polygon(raster), geometry)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7765
+#, no-c-format
+msgid ""
+"SELECT r1.rid, r2.rid, ST_Touches(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 "
+"CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_touches \n"
+"-----+-----+------------\n"
+" 2 | 1 | f\n"
+" 2 | 2 | f"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7777
+#, no-c-format
+msgid "ST_SameAlignment"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7779
+#, no-c-format
+msgid ""
+"Returns true if rasters have same skew, scale, spatial ref and false if they "
+"don't with notice detailing issue."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7783
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_SameAlignment</function></"
+"funcdef> <paramdef> <type>raster </type> <parameter>rastA</parameter> </"
+"paramdef> <paramdef> <type>raster </type> <parameter>rastB</parameter> </"
+"paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>ST_SameAlignment</function></funcdef> <paramdef> <type>double "
+"precision </type> <parameter>ulx1</parameter> </paramdef> <paramdef> "
+"<type>double precision </type> <parameter>uly1</parameter> </paramdef> "
+"<paramdef> <type>double precision </type> <parameter>scalex1</parameter> </"
+"paramdef> <paramdef> <type>double precision </type> <parameter>scaley1</"
+"parameter> </paramdef> <paramdef> <type>double precision </type> "
+"<parameter>skewx1</parameter> </paramdef> <paramdef> <type>double precision "
+"</type> <parameter>skewy1</parameter> </paramdef> <paramdef> <type>double "
+"precision </type> <parameter>ulx2</parameter> </paramdef> <paramdef> "
+"<type>double precision </type> <parameter>uly2</parameter> </paramdef> "
+"<paramdef> <type>double precision </type> <parameter>scalex2</parameter> </"
+"paramdef> <paramdef> <type>double precision </type> <parameter>scaley2</"
+"parameter> </paramdef> <paramdef> <type>double precision </type> "
+"<parameter>skewx2</parameter> </paramdef> <paramdef> <type>double precision "
+"</type> <parameter>skewy2</parameter> </paramdef> </funcprototype> "
+"<funcprototype> <funcdef>boolean <function>ST_SameAlignment</function></"
+"funcdef> <paramdef> <type>raster set </type> <parameter>rastfield</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7862
+#, no-c-format
+msgid ""
+"Non-Aggregate version (Variants 1 and 2): Returns true if the two rasters "
+"(either provided directly or made using the values for upperleft, scale, "
+"skew and srid) have the same scale, skew, srid and at least one of any of "
+"the four corners of any pixel of one raster falls on any corner of the grid "
+"of the other raster. Returns false if they don't and a NOTICE detailing the "
+"alignment issue."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7866
+#, no-c-format
+msgid ""
+"Aggregate version (Variant 3): From a set of rasters, returns true if all "
+"rasters in the set are aligned. The ST_SameAlignment() function is an "
+"\"aggregate\" function in the terminology of PostgreSQL. That means that it "
+"operates on rows of data, in the same way the SUM() and AVG() functions do."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7871
+#, no-c-format
+msgid "Enhanced: 2.1.0 addition of Aggegrate variant"
+msgstr ""
+
+#. Tag: title
+#: reference_raster.xml:7875
+#, no-c-format
+msgid "Examples: Rasters"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7877
+#, no-c-format
+msgid ""
+"SELECT ST_SameAlignment(\n"
+" ST_MakeEmptyRaster(1, 1, 0, 0, 1, 1, 0, 0),\n"
+" ST_MakeEmptyRaster(1, 1, 0, 0, 1, 1, 0, 0)\n"
+") as sm;\n"
+"\n"
+"sm\n"
+"----\n"
+"t"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7878
+#, no-c-format
+msgid ""
+"SELECT ST_SameAlignment(A.rast,b.rast)\n"
+" FROM dummy_rast AS A CROSS JOIN dummy_rast AS B;\n"
+"\n"
+" NOTICE: The two rasters provided have different SRIDs\n"
+"NOTICE: The two rasters provided have different SRIDs\n"
+" st_samealignment\n"
+"------------------\n"
+" t\n"
+" f\n"
+" f\n"
+" f"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7882
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_MakeEmptyRaster\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7888
+#, no-c-format
+msgid "ST_Within"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7889
+#, no-c-format
+msgid ""
+"Return true if no points of raster rastA lie in the exterior of raster rastB "
+"and at least one point of the interior of rastA lies in the interior of "
+"rastB."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7895
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_Within</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> </"
+"funcprototype> <funcprototype> <funcdef>boolean <function>ST_Within</"
+"function></funcdef> <paramdef> <type>raster </type> <parameter>rastA</"
+"parameter> </paramdef> <paramdef> <type>raster </type> <parameter>rastB</"
+"parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7934
+#, no-c-format
+msgid ""
+"Raster rastA is within rastB if and only if no points of rastA lie in the "
+"exterior of rastB and at least one point of the interior of rastA lies in "
+"the interior of rastB. If the band number is not provided (or set to NULL), "
+"only the convex hull of the raster is considered in the test. If the band "
+"number is provided, only those pixels with value (not NODATA) are considered "
+"in the test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7945
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_Within(ST_Polygon(raster), geometry) or "
+"ST_Within(geometry, ST_Polygon(raster))."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7951
+#, no-c-format
+msgid ""
+"ST_Within() is the inverse of ST_Contains(). So, ST_Within(rastA, rastB) "
+"implies ST_Contains(rastB, rastA)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:7962
+#, no-c-format
+msgid ""
+"SELECT r1.rid, r2.rid, ST_Within(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 "
+"CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_within \n"
+"-----+-----+-----------\n"
+" 2 | 1 | f\n"
+" 2 | 2 | t"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:7966
+#, no-c-format
+msgid ""
+", <xref linkend=\"RT_ST_Contains\"/>, <xref linkend=\"RT_ST_DWithin\"/>, "
+"<xref linkend=\"RT_ST_DFullyWithin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:7977
+#, no-c-format
+msgid "ST_DWithin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:7978
+#, no-c-format
+msgid ""
+"Return true if rasters rastA and rastB are within the specified distance of "
+"each other."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:7984
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_DWithin</function></funcdef> "
+"<paramdef> <type>raster </type> <parameter>rastA</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandA</parameter> </paramdef> "
+"<paramdef> <type>raster </type> <parameter>rastB</parameter> </paramdef> "
+"<paramdef> <type>integer </type> <parameter>nbandB</parameter> </paramdef> "
+"<paramdef> <type>double precision </type> <parameter>distance_of_srid</"
+"parameter> </paramdef> </funcprototype> <funcprototype> <funcdef>boolean "
+"<function>ST_DWithin</function></funcdef> <paramdef> <type>raster </type> "
+"<parameter>rastA</parameter> </paramdef> <paramdef> <type>raster </type> "
+"<parameter>rastB</parameter> </paramdef> <paramdef> <type>double precision </"
+"type> <parameter>distance_of_srid</parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:8031
+#, no-c-format
+msgid ""
+"Return true if rasters rastA and rastB are within the specified distance of "
+"each other. If the band number is not provided (or set to NULL), only the "
+"convex hull of the raster is considered in the test. If the band number is "
+"provided, only those pixels with value (not NODATA) are considered in the "
+"test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:8035 reference_raster.xml:8128
+#, no-c-format
+msgid ""
+"The distance is specified in units defined by the spatial reference system "
+"of the rasters. For this function to make sense, the source rasters must "
+"both be of the same coordinate projection, having the same SRID."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:8046
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_DWithin(ST_Polygon(raster), geometry)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:8057
+#, no-c-format
+msgid ""
+"SELECT r1.rid, r2.rid, ST_DWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM "
+"dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_dwithin \n"
+"-----+-----+------------\n"
+" 2 | 1 | f\n"
+" 2 | 2 | t"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:8061
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_DFullyWithin\"/>"
+msgstr ""
+
+#. Tag: refname
+#: reference_raster.xml:8070
+#, no-c-format
+msgid "ST_DFullyWithin"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_raster.xml:8071
+#, no-c-format
+msgid ""
+"Return true if rasters rastA and rastB are fully within the specified "
+"distance of each other."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_raster.xml:8077
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>boolean <function>ST_DFullyWithin</function></"
+"funcdef> <paramdef> <type>raster </type> <parameter>rastA</parameter> </"
+"paramdef> <paramdef> <type>integer </type> <parameter>nbandA</parameter> </"
+"paramdef> <paramdef> <type>raster </type> <parameter>rastB</parameter> </"
+"paramdef> <paramdef> <type>integer </type> <parameter>nbandB</parameter> </"
+"paramdef> <paramdef> <type>double precision </type> "
+"<parameter>distance_of_srid</parameter> </paramdef> </funcprototype> "
+"<funcprototype> <funcdef>boolean <function>ST_DFullyWithin</function></"
+"funcdef> <paramdef> <type>raster </type> <parameter>rastA</parameter> </"
+"paramdef> <paramdef> <type>raster </type> <parameter>rastB</parameter> </"
+"paramdef> <paramdef> <type>double precision </type> "
+"<parameter>distance_of_srid</parameter> </paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:8124
+#, no-c-format
+msgid ""
+"Return true if rasters rastA and rastB are fully within the specified "
+"distance of each other. If the band number is not provided (or set to NULL), "
+"only the convex hull of the raster is considered in the test. If the band "
+"number is provided, only those pixels with value (not NODATA) are considered "
+"in the test."
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:8139
+#, no-c-format
+msgid ""
+"To test the spatial relationship of a raster and a geometry, use ST_Polygon "
+"on the raster, e.g. ST_DFullyWithin(ST_Polygon(raster), geometry)."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_raster.xml:8150
+#, no-c-format
+msgid ""
+"SELECT r1.rid, r2.rid, ST_DFullyWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM "
+"dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;\n"
+"\n"
+" rid | rid | st_dfullywithin \n"
+"-----+-----+-----------------\n"
+" 2 | 1 | f\n"
+" 2 | 2 | t"
+msgstr ""
+
+#. Tag: para
+#: reference_raster.xml:8154
+#, no-c-format
+msgid ", <xref linkend=\"RT_ST_DWithin\"/>"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2013-05-12 08:39+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_sfcgal.xml:4
+#, no-c-format
+msgid "Using SFCGAL Advanced 2D/3D functions"
+msgstr ""
+
+#. Tag: para
+#: reference_sfcgal.xml:5
+#, no-c-format
+msgid "TODO Introduction part"
+msgstr ""
+
+#. Tag: para
+#: reference_sfcgal.xml:8
+#, no-c-format
+msgid "TODO Install part"
+msgstr ""
+
+#. Tag: refname
+#: reference_sfcgal.xml:14
+#, no-c-format
+msgid "ST_Extrude"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_sfcgal.xml:16
+#, no-c-format
+msgid "Extrude a surface to a related volume"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_sfcgal.xml:21
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Extrude</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>x</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>y</parameter></paramdef> "
+"<paramdef><type>float</type> <parameter>z</parameter></paramdef>"
+msgstr ""
+
+#. Tag: title
+#: reference_sfcgal.xml:32 reference_sfcgal.xml:61 reference_sfcgal.xml:90
+#: reference_sfcgal.xml:119 reference_sfcgal.xml:148 reference_sfcgal.xml:177
+#: reference_sfcgal.xml:206
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_sfcgal.xml:34 reference_sfcgal.xml:63 reference_sfcgal.xml:92
+#: reference_sfcgal.xml:121 reference_sfcgal.xml:150 reference_sfcgal.xml:179
+#: reference_sfcgal.xml:208
+#, no-c-format
+msgid "Availability"
+msgstr ""
+
+#. Tag: para
+#: reference_sfcgal.xml:35 reference_sfcgal.xml:64 reference_sfcgal.xml:93
+#: reference_sfcgal.xml:122 reference_sfcgal.xml:151 reference_sfcgal.xml:180
+#: reference_sfcgal.xml:209
+#, no-c-format
+msgid "&sfcgal_required;"
+msgstr ""
+
+#. Tag: para
+#: reference_sfcgal.xml:36 reference_sfcgal.xml:65 reference_sfcgal.xml:94
+#: reference_sfcgal.xml:123 reference_sfcgal.xml:152 reference_sfcgal.xml:181
+#: reference_sfcgal.xml:210
+#, no-c-format
+msgid "&Z_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_sfcgal.xml:37 reference_sfcgal.xml:66 reference_sfcgal.xml:95
+#: reference_sfcgal.xml:124 reference_sfcgal.xml:153 reference_sfcgal.xml:182
+#: reference_sfcgal.xml:211
+#, no-c-format
+msgid "&P_support;"
+msgstr ""
+
+#. Tag: para
+#: reference_sfcgal.xml:38 reference_sfcgal.xml:67 reference_sfcgal.xml:96
+#: reference_sfcgal.xml:125 reference_sfcgal.xml:154 reference_sfcgal.xml:183
+#: reference_sfcgal.xml:212
+#, no-c-format
+msgid "&T_support;"
+msgstr ""
+
+#. Tag: refname
+#: reference_sfcgal.xml:46
+#, no-c-format
+msgid "ST_StraightSkeleton"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_sfcgal.xml:48
+#, no-c-format
+msgid "Compute a straight skeleton from a geometry"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_sfcgal.xml:53
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_StraightSkeleton</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: refname
+#: reference_sfcgal.xml:75
+#, no-c-format
+msgid "ST_IsPlanar"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_sfcgal.xml:77
+#, no-c-format
+msgid "Check if a surface is or not planar"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_sfcgal.xml:82
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>ST_IsPlanar</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: refname
+#: reference_sfcgal.xml:104
+#, no-c-format
+msgid "ST_Orientation"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_sfcgal.xml:106
+#, no-c-format
+msgid "Determine surface orientation"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_sfcgal.xml:111
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>ST_Orientation</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: refname
+#: reference_sfcgal.xml:133
+#, no-c-format
+msgid "ST_ForceLHR"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_sfcgal.xml:135
+#, no-c-format
+msgid "Force LHR orientation"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_sfcgal.xml:140
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_ForceLHR</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>"
+msgstr ""
+
+#. Tag: refname
+#: reference_sfcgal.xml:161
+#, no-c-format
+msgid "ST_MinkowskiSum"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_sfcgal.xml:163
+#, no-c-format
+msgid "Perform Minkowski sum"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_sfcgal.xml:168
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Minkowski</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom1</parameter></paramdef> "
+"<paramdef><type>geometry</type> <parameter>geom2</parameter></paramdef>"
+msgstr ""
+
+#. Tag: refname
+#: reference_sfcgal.xml:191
+#, no-c-format
+msgid "ST_Tesselate"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_sfcgal.xml:193
+#, no-c-format
+msgid "Perform surface Tesselation"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_sfcgal.xml:198
+#, no-c-format
+msgid ""
+"<funcdef>geometry <function>ST_Tesselate</function></funcdef> "
+"<paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reference_transaction.xml:3
+#, no-c-format
+msgid "Long Transactions Support"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:5
+#, no-c-format
+msgid ""
+"This module and associated pl/pgsql functions have been implemented to "
+"provide long locking support required by <ulink url=\"http://www."
+"opengeospatial.org/standards/wfs\">Web Feature Service</ulink> specification."
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:10
+#, no-c-format
+msgid ""
+"Users must use <ulink url=\"http://www.postgresql.org/docs/current/static/"
+"transaction-iso.html\">serializable transaction level</ulink> otherwise "
+"locking mechanism would break."
+msgstr ""
+
+#. Tag: refname
+#: reference_transaction.xml:18
+#, no-c-format
+msgid "AddAuth"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_transaction.xml:20
+#, no-c-format
+msgid ""
+"<refpurpose>Add an authorization token to be used in current transaction.</"
+"refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_transaction.xml:25
+#, no-c-format
+msgid ""
+"<funcdef>boolean <function>AddAuth</function></funcdef> <paramdef><type>text "
+"</type> <parameter>auth_token</parameter></paramdef>"
+msgstr ""
+
+#. Tag: title
+#: reference_transaction.xml:33 reference_transaction.xml:83
+#: reference_transaction.xml:130 reference_transaction.xml:177
+#: reference_transaction.xml:241 reference_transaction.xml:284
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:35
+#, no-c-format
+msgid ""
+"<para>Add an authorization token to be used in current transaction.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:37
+#, no-c-format
+msgid ""
+"Creates/adds to a temp table called temp_lock_have_table the current "
+"transaction identifier and authorization token key."
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:40 reference_transaction.xml:92
+#: reference_transaction.xml:138 reference_transaction.xml:185
+#: reference_transaction.xml:248 reference_transaction.xml:289
+#, no-c-format
+msgid "Availability: 1.1.3"
+msgstr ""
+
+#. Tag: title
+#: reference_transaction.xml:45 reference_transaction.xml:98
+#: reference_transaction.xml:144 reference_transaction.xml:191
+#: reference_transaction.xml:253 reference_transaction.xml:294
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_transaction.xml:47
+#, no-c-format
+msgid ""
+"SELECT LockRow('towns', '353', 'priscilla');\n"
+" BEGIN TRANSACTION;\n"
+" SELECT AddAuth('joey');\n"
+" UPDATE towns SET the_geom = "
+"ST_Translate(the_geom,2,2) WHERE gid = 353;\n"
+" COMMIT;\n"
+"\n"
+"\n"
+" ---Error--\n"
+" ERROR: UPDATE where \"gid\" = '353' requires authorization "
+"'priscilla'"
+msgstr ""
+
+#. Tag: title
+#: reference_transaction.xml:52 reference_transaction.xml:105
+#: reference_transaction.xml:151 reference_transaction.xml:198
+#: reference_transaction.xml:260 reference_transaction.xml:301
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: reference_transaction.xml:60
+#, no-c-format
+msgid "CheckAuth"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_transaction.xml:62
+#, no-c-format
+msgid ""
+"Creates trigger on a table to prevent/allow updates and deletes of rows "
+"based on authorization token."
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_transaction.xml:66
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>integer <function>CheckAuth</function></funcdef> "
+"<paramdef><type>text </type> <parameter>a_schema_name</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>a_table_name</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>a_key_column_name</parameter></"
+"paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>CheckAuth</function></funcdef> <paramdef><type>text </type> "
+"<parameter>a_table_name</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>a_key_column_name</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:85
+#, no-c-format
+msgid ""
+"Creates trigger on a table to prevent/allow updates and deletes of rows "
+"based on authorization token. Identify rows using <rowid_col> column."
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:87
+#, no-c-format
+msgid ""
+"If a_schema_name is not passed in, then searches for table in current schema."
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:88
+#, no-c-format
+msgid ""
+"If an authorization trigger already exists on this table function errors."
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:89
+#, no-c-format
+msgid "If Transaction support is not enabled, function throws an exception."
+msgstr ""
+
+#. Tag: programlisting
+#: reference_transaction.xml:100
+#, no-c-format
+msgid ""
+"SELECT CheckAuth('public', 'towns', 'gid');\n"
+" result\n"
+" ------\n"
+" 0"
+msgstr ""
+
+#. Tag: refname
+#: reference_transaction.xml:113
+#, no-c-format
+msgid "DisableLongTransactions"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_transaction.xml:115
+#, no-c-format
+msgid ""
+"<refpurpose>Disable long transaction support. This function removes the long "
+"transaction support metadata tables, and drops all triggers attached to lock-"
+"checked tables.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_transaction.xml:122
+#, no-c-format
+msgid ""
+"<funcdef>text <function>DisableLongTransactions</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:132
+#, no-c-format
+msgid ""
+"<para>Disable long transaction support. This function removes the long "
+"transaction support metadata tables, and drops all triggers attached to lock-"
+"checked tables.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:135
+#, no-c-format
+msgid ""
+"Drops meta table called <varname>authorization_table</varname> and a view "
+"called <varname>authorized_tables</varname> and all triggers called "
+"<varname>checkauthtrigger</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_transaction.xml:146
+#, no-c-format
+msgid ""
+"SELECT DisableLongTransactions();\n"
+"--result--\n"
+"Long transactions support disabled"
+msgstr ""
+
+#. Tag: refname
+#: reference_transaction.xml:159
+#, no-c-format
+msgid "EnableLongTransactions"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_transaction.xml:161
+#, no-c-format
+msgid ""
+"<refpurpose>Enable long transaction support. This function creates the "
+"required metadata tables, needs to be called once before using the other "
+"functions in this section. Calling it twice is harmless.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_transaction.xml:169
+#, no-c-format
+msgid ""
+"<funcdef>text <function>EnableLongTransactions</function></funcdef> "
+"<paramdef></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:179
+#, no-c-format
+msgid ""
+"<para>Enable long transaction support. This function creates the required "
+"metadata tables, needs to be called once before using the other functions in "
+"this section. Calling it twice is harmless.</para>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:183
+#, no-c-format
+msgid ""
+"Creates a meta table called <varname>authorization_table</varname> and a "
+"view called <varname>authorized_tables</varname>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_transaction.xml:193
+#, no-c-format
+msgid ""
+"SELECT EnableLongTransactions();\n"
+"--result--\n"
+"Long transactions support enabled"
+msgstr ""
+
+#. Tag: refname
+#: reference_transaction.xml:206
+#, no-c-format
+msgid "LockRow"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_transaction.xml:208
+#, no-c-format
+msgid "Set lock/authorization for specific row in table"
+msgstr ""
+
+#. Tag: funcsynopsis
+#: reference_transaction.xml:212
+#, no-c-format
+msgid ""
+"<funcprototype> <funcdef>integer <function>LockRow</function></funcdef> "
+"<paramdef><type>text </type> <parameter>a_schema_name</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>a_table_name</parameter></paramdef> "
+"<paramdef><type>text </type> <parameter>a_row_key</parameter></paramdef> "
+"<paramdef><type>text</type> <parameter>an_auth_token</parameter></paramdef> "
+"<paramdef><type>timestamp</type> <parameter>expire_dt</parameter></paramdef> "
+"</funcprototype> <funcprototype> <funcdef>integer <function>LockRow</"
+"function></funcdef> <paramdef><type>text </type> <parameter>a_table_name</"
+"parameter></paramdef> <paramdef><type>text </type> <parameter>a_row_key</"
+"parameter></paramdef> <paramdef><type>text</type> <parameter>an_auth_token</"
+"parameter></paramdef> <paramdef><type>timestamp</type> <parameter>expire_dt</"
+"parameter></paramdef> </funcprototype> <funcprototype> <funcdef>integer "
+"<function>LockRow</function></funcdef> <paramdef><type>text </type> "
+"<parameter>a_table_name</parameter></paramdef> <paramdef><type>text </type> "
+"<parameter>a_row_key</parameter></paramdef> <paramdef><type>text</type> "
+"<parameter>an_auth_token</parameter></paramdef> </funcprototype>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:243
+#, no-c-format
+msgid ""
+"Set lock/authorization for specific row in table <authid> is a text "
+"value, <expires> is a timestamp defaulting to now()+1hour. Returns 1 "
+"if lock has been assigned, 0 otherwise (already locked by other auth)"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_transaction.xml:255
+#, no-c-format
+msgid ""
+"SELECT LockRow('public', 'towns', '2', 'joey');\n"
+"LockRow\n"
+"-------\n"
+"1\n"
+"\n"
+"--Joey has already locked the record and Priscilla is out of luck\n"
+"SELECT LockRow('public', 'towns', '2', 'priscilla');\n"
+"LockRow\n"
+"-------\n"
+"0"
+msgstr ""
+
+#. Tag: refname
+#: reference_transaction.xml:268
+#, no-c-format
+msgid "UnlockRows"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_transaction.xml:270
+#, no-c-format
+msgid ""
+"<refpurpose>Remove all locks held by specified authorization id. Returns the "
+"number of locks released.</refpurpose>"
+msgstr ""
+
+#. Tag: funcprototype
+#: reference_transaction.xml:276
+#, no-c-format
+msgid ""
+"<funcdef>integer <function>UnlockRows</function></funcdef> "
+"<paramdef><type>text </type> <parameter>auth_token</parameter></paramdef>"
+msgstr ""
+
+#. Tag: para
+#: reference_transaction.xml:286
+#, no-c-format
+msgid ""
+"<para>Remove all locks held by specified authorization id. Returns the "
+"number of locks released.</para>"
+msgstr ""
+
+#. Tag: programlisting
+#: reference_transaction.xml:296
+#, no-c-format
+msgid ""
+"SELECT LockRow('towns', '353', 'priscilla');\n"
+" SELECT LockRow('towns', '2', 'priscilla');\n"
+" SELECT UnLockRows('priscilla');\n"
+" UnLockRows\n"
+" ------------\n"
+" 2"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 21:04+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: para
+#: reference_type.xml:5
+#, no-c-format
+msgid ""
+"This section lists the PostgreSQL data types installed by PostGIS. Note we "
+"describe the casting behavior of these which is very important especially "
+"when designing your own functions."
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:8
+#, no-c-format
+msgid ""
+"A Cast is when one type is coerced into another type. PostgreSQL is unique "
+"from most databases in that it allows you to define casting behavior for "
+"custom types and the functions used for casting. A cast can be specified as "
+"automatic in which case, you do not have to do a CAST(myfoo As otherfootype) "
+"or myfoo::otherfootype if you are feeding it to a function that only works "
+"with otherfootype and there is an automatic cast in place for it."
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:13
+#, no-c-format
+msgid ""
+"The danger of relying on automatic cast behavior is when you have an "
+"overloaded function say one that takes a box2d and one that takes a box3d "
+"but no geometry. What happens is that both functions are equally good to use "
+"with geometry since geometry has an autocast for both -- so you end up with "
+"an ambiguous function error. To force PostgreSQL to choose, you do a "
+"CAST(mygeom As box3d) or mygeom::box3d."
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:17
+#, no-c-format
+msgid ""
+"<emphasis>At least as of PostgreSQL 8.3</emphasis> - Everything can be CAST "
+"to text (presumably because of the magical unknown type), so no defined "
+"CASTS for that need to be present for you to CAST an object to text."
+msgstr ""
+
+#. Tag: title
+#: reference_type.xml:20
+#, no-c-format
+msgid "PostgreSQL PostGIS Geometry/Geography/Box Types"
+msgstr ""
+
+#. Tag: refname
+#: reference_type.xml:24
+#, no-c-format
+msgid "<refname>box2d</refname>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_type.xml:25
+#, no-c-format
+msgid ""
+"A box composed of x min, ymin, xmax, ymax. Often used to return the 2d "
+"enclosing box of a geometry."
+msgstr ""
+
+#. Tag: title
+#: reference_type.xml:29 reference_type.xml:40 reference_type.xml:79
+#: reference_type.xml:136 reference_type.xml:155
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:30
+#, no-c-format
+msgid ""
+"box2d is a spatial data type used to represent the enclosing box of a "
+"geometry or set of geometries. ST_Extent in earlier versions prior to "
+"PostGIS 1.4 would return a box2d."
+msgstr ""
+
+#. Tag: refname
+#: reference_type.xml:35
+#, no-c-format
+msgid "<refname>box3d</refname>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_type.xml:36
+#, no-c-format
+msgid ""
+"A box composed of x min, ymin, zmin, xmax, ymax, zmax. Often used to return "
+"the 3d extent of a geometry or collection of geometries."
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:41
+#, no-c-format
+msgid ""
+"box3d is a postgis spatial data type used to represent the enclosing box of "
+"a geometry or set of geometries. ST_3DExtent returns a box3d object."
+msgstr ""
+
+#. Tag: title
+#: reference_type.xml:45 reference_type.xml:84 reference_type.xml:160
+#, no-c-format
+msgid "Casting Behavior"
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:46 reference_type.xml:85 reference_type.xml:161
+#, no-c-format
+msgid ""
+"This section lists the automatic as well as explicit casts allowed for this "
+"data type"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:51 reference_type.xml:90 reference_type.xml:166
+#, no-c-format
+msgid "Cast To"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:52 reference_type.xml:91 reference_type.xml:167
+#, no-c-format
+msgid "Behavior"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:55 reference_type.xml:94
+#, no-c-format
+msgid "<entry>box</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:56 reference_type.xml:60 reference_type.xml:64
+#: reference_type.xml:95 reference_type.xml:99 reference_type.xml:103
+#: reference_type.xml:107 reference_type.xml:111 reference_type.xml:115
+#, no-c-format
+msgid "automatic"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:59 reference_type.xml:98
+#, no-c-format
+msgid "<entry>box2d</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:63 reference_type.xml:170
+#, no-c-format
+msgid "<entry>geometry</entry>"
+msgstr ""
+
+#. Tag: refname
+#: reference_type.xml:74
+#, no-c-format
+msgid "<refname>geometry</refname>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_type.xml:75
+#, no-c-format
+msgid "Planar spatial data type."
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:80
+#, no-c-format
+msgid ""
+"geometry is a fundamental postgis spatial data type used to represent a "
+"feature in the Euclidean coordinate system."
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:102
+#, no-c-format
+msgid "<entry>box3d</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:106
+#, no-c-format
+msgid "bytea"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:110
+#, no-c-format
+msgid "<entry>geography</entry>"
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:114
+#, no-c-format
+msgid "text"
+msgstr ""
+
+#. Tag: title
+#: reference_type.xml:123 reference_type.xml:143 reference_type.xml:179
+#, no-c-format
+msgid "See Also"
+msgstr ""
+
+#. Tag: refname
+#: reference_type.xml:130
+#, no-c-format
+msgid "geometry_dump"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_type.xml:131
+#, no-c-format
+msgid ""
+"A spatial datatype with two fields - geom (holding a geometry object) and "
+"path[] (a 1-d array holding the position of the geometry within the dumped "
+"object.)"
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:137
+#, no-c-format
+msgid ""
+"geometry_dump is a compound data type consisting of a geometry object "
+"referenced by the .geom field and path[] a 1-dimensional integer array "
+"(starting at 1 e.g. path[1] to get first element) array that defines the "
+"navigation path within the dumped geometry to find this element. It is used "
+"by the ST_Dump* family of functions as an output type to explode a more "
+"complex geometry into its constituent parts and location of parts."
+msgstr ""
+
+#. Tag: refname
+#: reference_type.xml:150
+#, no-c-format
+msgid "<refname>geography</refname>"
+msgstr ""
+
+#. Tag: refpurpose
+#: reference_type.xml:151
+#, no-c-format
+msgid "Ellipsoidal spatial data type."
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:156
+#, no-c-format
+msgid ""
+"geography is a spatial data type used to represent a feature in the round-"
+"earth coordinate system."
+msgstr ""
+
+#. Tag: entry
+#: reference_type.xml:171
+#, no-c-format
+msgid "explicit"
+msgstr ""
+
+#. Tag: para
+#: reference_type.xml:180
+#, no-c-format
+msgid ", <xref linkend=\"PostGIS_Geography\"/>"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: release_notes.xml:3
+#, no-c-format
+msgid "Appendix"
+msgstr ""
+
+#. Tag: subtitle
+#: release_notes.xml:4
+#, no-c-format
+msgid "Release Notes"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:6
+#, no-c-format
+msgid "Release 2.0.1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:7
+#, no-c-format
+msgid "Release date: 2012/06/22"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:8
+#, no-c-format
+msgid ""
+"This is a bug fix release, addressing issues that have been filed since the "
+"2.0.0 release."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:10 release_notes.xml:165 release_notes.xml:179
+#: release_notes.xml:217 release_notes.xml:255 release_notes.xml:286
+#, no-c-format
+msgid "Bug Fixes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:11
+#, no-c-format
+msgid "#1264, fix st_dwithin(geog, geog, 0)."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:12
+#, no-c-format
+msgid "#1468 shp2pgsql-gui table column schema get shifted"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:13
+#, no-c-format
+msgid "#1694, fix building with clang. (vince)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:14
+#, no-c-format
+msgid "#1708, improve restore of pre-PostGIS 2.0 backups."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:15
+#, no-c-format
+msgid "#1714, more robust handling of high topology tolerance."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:16
+#, no-c-format
+msgid "#1755, ST_GeographyFromText support for higher dimensions."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:17
+#, no-c-format
+msgid "#1759, loading transformed shapefiles in raster enabled db."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:18
+#, no-c-format
+msgid ""
+"#1761, handling of subdatasets in NetCDF, HDF4 and HDF5 in raster2pgsql."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:19
+#, no-c-format
+msgid "#1763, topology.toTopoGeom use with custom search_path."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:20
+#, no-c-format
+msgid "#1766, don't let ST_RemEdge* destroy peripheral TopoGeometry objects."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:21
+#, no-c-format
+msgid "#1774, Clearer error on setting an edge geometry to an invalid one."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:22
+#, no-c-format
+msgid "#1775, ST_ChangeEdgeGeom collision detection with 2-vertex target."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:23
+#, no-c-format
+msgid "#1776, fix ST_SymDifference(empty, geom) to return geom."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:24
+#, no-c-format
+msgid "#1779, install SQL comment files."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:25
+#, no-c-format
+msgid "#1782, fix spatial reference string handling in raster."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:26
+#, no-c-format
+msgid "#1789, fix false edge-node crossing report in ValidateTopology."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:27
+#, no-c-format
+msgid "#1790, fix toTopoGeom handling of duplicated primitives."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:28
+#, no-c-format
+msgid "#1791, fix ST_Azimuth with very close but distinct points."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:29
+#, no-c-format
+msgid "#1797, fix (ValidateTopology(xxx)).* syntax calls."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:30
+#, no-c-format
+msgid "#1805, put back the 900913 SRID entry."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:31
+#, no-c-format
+msgid "#1813, Only show readable relations in metadata tables."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:32
+#, no-c-format
+msgid ""
+"#1819, fix floating point issues with ST_World2RasterCoord and "
+"ST_Raster2WorldCoord variants."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:34
+#, no-c-format
+msgid "#1820 compilation on 9.2beta1."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:35
+#, no-c-format
+msgid "#1822, topology load on PostgreSQL 9.2beta1."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:36
+#, no-c-format
+msgid "#1825, fix prepared geometry cache lookup"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:37
+#, no-c-format
+msgid "#1829, fix uninitialized read in GeoJSON parser"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:38
+#, no-c-format
+msgid ""
+"#1834, revise postgis extension to only backup user specified spatial_ref_sys"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:40
+#, no-c-format
+msgid "#1839, handling of subdatasets in GeoTIFF in raster2pgsql."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:41
+#, no-c-format
+msgid "#1840, fix logic of when to compute # of tiles in raster2pgsql."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:42
+#, no-c-format
+msgid "#1851, fix spatial_ref_system parameters for EPSG:3844"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:43
+#, no-c-format
+msgid "#1857, fix failure to detect endpoint mismatch in ST_AddEdge*Face*"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:44
+#, no-c-format
+msgid ""
+"#1865, data loss in postgis_restore.pl when data rows have leading dashes."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:46
+#, no-c-format
+msgid "#1867, catch invalid topology name passed to topogeo_add*"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:47
+#, no-c-format
+msgid "#1872, fix ST_ApproxSummarystats to prevent division by zero"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:48
+#, no-c-format
+msgid ""
+"#1873, fix ptarray_locate_point to return interpolated Z/M values for on-the-"
+"line case"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:50
+#, no-c-format
+msgid ""
+"#1875, ST_SummaryStats returns NULL for all parameters except count when "
+"count is zero"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:52
+#, no-c-format
+msgid "#1881, shp2pgsql-gui -- editing a field sometimes triggers removing row"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:54
+#, no-c-format
+msgid ""
+"#1883, Geocoder install fails trying to run create_census_base_tables() "
+"(Brian Panulla)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:58 release_notes.xml:148 release_notes.xml:349
+#: release_notes.xml:404
+#, no-c-format
+msgid "Enhancements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:59
+#, no-c-format
+msgid "More detailed exception message from topology editing functions."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:60
+#, no-c-format
+msgid "#1786, improved build dependencies"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:61
+#, no-c-format
+msgid "#1806, speedup of ST_BuildArea, ST_MakeValid and ST_GetFaceGeometry."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:62
+#, no-c-format
+msgid "#1812, Add lwgeom_normalize in LIBLWGEOM for more stable testing."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:66
+#, no-c-format
+msgid "Release 2.0.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:67
+#, no-c-format
+msgid "Release date: 2012/04/03"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:68
+#, no-c-format
+msgid ""
+"This is a major release. A hard upgrade is required. Yes this means a full "
+"dump reload and some special preparations if you are using obsolete "
+"functions. Refer to <xref linkend=\"hard_upgrade\"/> for details on "
+"upgrading. Refer to <xref linkend=\"NewFunctions_2_0\"/> for more details "
+"and changed/new functions."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:72
+#, no-c-format
+msgid "Testers - Our unsung heroes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:73
+#, no-c-format
+msgid ""
+"We are most indebted to the numerous members in the PostGIS community who "
+"were brave enough to test out the new features in this release. No major "
+"release can be successful without these folk."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:76
+#, no-c-format
+msgid ""
+"Below are those who have been most valiant, provided very detailed and "
+"thorough bug reports, and detailed analysis."
+msgstr ""
+
+#. Tag: member
+#: release_notes.xml:80
+#, no-c-format
+msgid "Andrea Peri - Lots of testing on topology, checking for correctness"
+msgstr ""
+
+#. Tag: member
+#: release_notes.xml:81
+#, no-c-format
+msgid "Andreas Forø Tollefsen - raster testing"
+msgstr ""
+
+#. Tag: member
+#: release_notes.xml:82
+#, no-c-format
+msgid "Chris English - topology stress testing loader functions"
+msgstr ""
+
+#. Tag: member
+#: release_notes.xml:83
+#, no-c-format
+msgid "Salvatore Larosa - topology robustness testing"
+msgstr ""
+
+#. Tag: member
+#: release_notes.xml:84
+#, no-c-format
+msgid ""
+"Brian Hamlin - Benchmarking (also experimental experimental branches before "
+"they are folded into core) , general testing of various pieces including "
+"Tiger and Topology. Testing on various server VMs"
+msgstr ""
+
+#. Tag: member
+#: release_notes.xml:89
+#, no-c-format
+msgid "Mike Pease - Tiger geocoder testing - very detailed reports of issues"
+msgstr ""
+
+#. Tag: member
+#: release_notes.xml:90
+#, no-c-format
+msgid "Tom van Tilburg - raster testing"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:94
+#, no-c-format
+msgid "Important / Breaking Changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:95
+#, no-c-format
+msgid ""
+"#722, #302, Most deprecated functions removed (over 250 functions) (Regina "
+"Obe, Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:96
+#, no-c-format
+msgid "Unknown SRID changed from -1 to 0. (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:97
+#, no-c-format
+msgid ""
+"-- (most deprecated in 1.2) removed non-ST variants buffer, length, "
+"intersects (and internal functions renamed) etc."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:99
+#, no-c-format
+msgid ""
+"-- If you have been using deprecated functions CHANGE your apps or suffer "
+"the consequences. If you don't see a function documented -- it ain't "
+"supported or it is an internal function. Some constraints in older tables "
+"were built with deprecated functions. If you restore you may need to rebuild "
+"table constraints with populate_geometry_columns(). If you have applications "
+"or tools that rely on deprecated functions, please refer to <link linkend="
+"\"legacy_faq\"></link> for more details."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:104
+#, no-c-format
+msgid ""
+"#944 geometry_columns is now a view instead of a table (Paul Ramsey, Regina "
+"Obe) for tables created the old way reads (srid, type, dims) constraints for "
+"geometry columns created with type modifiers reads rom column definition"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:109
+#, no-c-format
+msgid ""
+"#1081, #1082, #1084, #1088 - Mangement functions support typmod geometry "
+"column creation functions now default to typmod creation (Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:112
+#, no-c-format
+msgid ""
+"#1083 probe_geometry_columns(), rename_geometry_table_constraints(), "
+"fix_geometry_columns(); removed - now obsolete with geometry_column view "
+"(Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:116
+#, no-c-format
+msgid "#817 Renaming old 3D functions to the convention ST_3D (Nicklas Avén)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:117
+#, no-c-format
+msgid ""
+"#548 (sorta), ST_NumGeometries,ST_GeometryN now returns 1 (or the geometry) "
+"instead of null for single geometries (Sandro Santilli, Maxime van Noppen)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:121 release_notes.xml:321 release_notes.xml:385
+#: release_notes.xml:682
+#, no-c-format
+msgid "New Features"
+msgstr ""
+
+#. Tag: ulink
+#: release_notes.xml:122
+#, no-c-format
+msgid ""
+"KNN Gist index based centroid (<->) and box (<#>) distance "
+"operators (Paul Ramsey / funded by Vizzuality)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:123
+#, no-c-format
+msgid ""
+"Support for TIN and PolyHedralSurface and enhancement of many functions to "
+"support 3D (Olivier Courtin / Oslandia)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:124
+#, no-c-format
+msgid ""
+"<ulink url=\"http://trac.osgeo.org/postgis/wiki/WKTRaster/PlanningAndFunding"
+"\">Raster support integrated and documented</ulink> (Pierre Racine, Jorge "
+"Arévalo, Mateusz Loskot, Sandro Santilli, David Zwarg, Regina Obe, Bborie "
+"Park) (Company developer and funding: University Laval, Deimos Space, "
+"CadCorp, Michigan Tech Research Institute, Azavea, Paragon Corporation, UC "
+"Davis Center for Vectorborne Diseases)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:127
+#, no-c-format
+msgid ""
+"Making spatial indexes 3D aware - in progress (Paul Ramsey, Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:128
+#, no-c-format
+msgid ""
+"Topology support improved (more functions), documented, testing (Sandro "
+"Santilli / Faunalia for RT-SIGTA), Andrea Peri, Regina Obe, Jose Carlos "
+"Martinez Llari"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:129
+#, no-c-format
+msgid "3D relationship and measurement support functions (Nicklas Avén)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:130
+#, no-c-format
+msgid ""
+"ST_3DDistance, ST_3DClosestPoint, ST_3DIntersects, ST_3DShortestLine and "
+"more..."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:131
+#, no-c-format
+msgid "N-Dimensional spatial indexes (Paul Ramsey / OpenGeo)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:132
+#, no-c-format
+msgid "ST_Split (Sandro Santilli / Faunalia for RT-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:133
+#, no-c-format
+msgid "ST_IsValidDetail (Sandro Santilli / Faunalia for RT-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:134
+#, no-c-format
+msgid "ST_MakeValid (Sandro Santilli / Faunalia for RT-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:135
+#, no-c-format
+msgid "ST_RemoveRepeatedPoints (Sandro Santilli / Faunalia for RT-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:136
+#, no-c-format
+msgid ""
+"ST_GeometryN and ST_NumGeometries support for non-collections (Sandro "
+"Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:137
+#, no-c-format
+msgid "ST_IsCollection (Sandro Santilli, Maxime van Noppen)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:138
+#, no-c-format
+msgid "ST_SharedPaths (Sandro Santilli / Faunalia for RT-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:139
+#, no-c-format
+msgid "ST_Snap (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:140
+#, no-c-format
+msgid "ST_RelateMatch (Sandro Santilli / Faunalia for RT-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:141
+#, no-c-format
+msgid "ST_ConcaveHull (Regina Obe and Leo Hsu / Paragon Corporation)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:142
+#, no-c-format
+msgid "ST_UnaryUnion (Sandro Santilli / Faunalia for RT-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:143
+#, no-c-format
+msgid "ST_AsX3D (Regina Obe / Arrival 3D funding)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:144
+#, no-c-format
+msgid "ST_OffsetCurve (Sandro Santilli, Rafal Magda)"
+msgstr ""
+
+#. Tag: ulink
+#: release_notes.xml:145
+#, no-c-format
+msgid "ST_GeomFromGeoJSON (Kashif Rasul, Paul Ramsey / Vizzuality funding)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:149
+#, no-c-format
+msgid ""
+"Made shape file loader tolerant of truncated multibyte values found in some "
+"free worldwide shapefiles (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:150
+#, no-c-format
+msgid ""
+"Lots of bug fixes and enhancements to shp2pgsql Beefing up regression tests "
+"for loaders Reproject support for both geometry and geography during import "
+"(Jeff Adams / Azavea, Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:154
+#, no-c-format
+msgid ""
+"pgsql2shp conversion from predefined list (Loic Dachary / Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:156
+#, no-c-format
+msgid ""
+"Shp-pgsql GUI loader - support loading multiple files at a time. (Mark "
+"Leslie)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:157
+#, no-c-format
+msgid ""
+"Extras - upgraded tiger_geocoder from using old TIGER format to use new "
+"TIGER shp and file structure format (Stephen Frost)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:158
+#, no-c-format
+msgid ""
+"Extras - revised tiger_geocoder to work with TIGER census 2010 data, "
+"addition of reverse geocoder function, various bug fixes, accuracy "
+"enhancements, limit max result return, speed improvements, loading routines. "
+"(Regina Obe, Leo Hsu / Paragon Corporation / funding provided by Hunter "
+"Systems Group)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:161
+#, no-c-format
+msgid "Overall Documentation proofreading and corrections. (Kasif Rasul)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:162
+#, no-c-format
+msgid ""
+"Cleanup PostGIS JDBC classes, revise to use Maven build. (Maria Arias de "
+"Reyna, Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:166
+#, no-c-format
+msgid "#1335 ST_AddPoint returns incorrect result on Linux (Even Rouault)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:169
+#, no-c-format
+msgid "Release specific credits"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:170
+#, no-c-format
+msgid ""
+"We thank <ulink url=\"http://blog.opengeo.org/2012/02/01/it-goes-up-to-2-0/"
+"\">U.S Department of State Human Information Unit (HIU)</ulink> and <ulink "
+"url=\"http://blog.cartodb.com/post/17318840209/postgis-core-committer-sandro-"
+"santilli-joins-cartodb\">Vizzuality</ulink> for general monetary support to "
+"get PostGIS 2.0 out the door."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:175
+#, no-c-format
+msgid "Release 1.5.4"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:176
+#, no-c-format
+msgid "Release date: 2012/05/07"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:177
+#, no-c-format
+msgid ""
+"This is a bug fix release, addressing issues that have been filed since the "
+"1.5.3 release."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:180
+#, no-c-format
+msgid "#547, ST_Contains memory problems (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:181
+#, no-c-format
+msgid "#621, Problem finding intersections with geography (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:182
+#, no-c-format
+msgid "#627, PostGIS/PostgreSQL process die on invalid geometry (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:183
+#, no-c-format
+msgid "#810, Increase accuracy of area calculation (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:184
+#, no-c-format
+msgid ""
+"#852, improve spatial predicates robustness (Sandro Santilli, Nicklas Avén)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:185
+#, no-c-format
+msgid ""
+"#877, ST_Estimated_Extent returns NULL on empty tables (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:186
+#, no-c-format
+msgid "#1028, ST_AsSVG kills whole postgres server when fails (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:187
+#, no-c-format
+msgid "#1056, Fix boxes of arcs and circle stroking code (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:188
+#, no-c-format
+msgid ""
+"#1121, populate_geometry_columns using deprecated functions (Regin Obe, Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:189
+#, no-c-format
+msgid "#1135, improve testsuite predictability (Andreas 'ads' Scherbaum)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:190
+#, no-c-format
+msgid "#1146, images generator crashes (bronaugh)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:191
+#, no-c-format
+msgid "#1170, North Pole intersection fails (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:192
+#, no-c-format
+msgid "#1179, ST_AsText crash with bad value (kjurka)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:193
+#, no-c-format
+msgid "#1184, honour DESTDIR in documentation Makefile (Bryce L Nordgren)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:194
+#, no-c-format
+msgid "#1227, server crash on invalid GML"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:195
+#, no-c-format
+msgid "#1252, SRID appearing in WKT (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:196
+#, no-c-format
+msgid "#1264, st_dwithin(g, g, 0) doesn't work (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:197
+#, no-c-format
+msgid "#1344, allow exporting tables with invalid geometries (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:198
+#, no-c-format
+msgid "#1389, wrong proj4text for SRID 31300 and 31370 (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:199
+#, no-c-format
+msgid "#1406, shp2pgsql crashes when loading into geography (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:200
+#, no-c-format
+msgid "#1595, fixed SRID redundancy in ST_Line_SubString (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:201
+#, no-c-format
+msgid "#1596, check SRID in UpdateGeometrySRID (Mike Toews, Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:202
+#, no-c-format
+msgid "#1602, fix ST_Polygonize to retain Z (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:203
+#, no-c-format
+msgid "#1697, fix crash with EMPTY entries in GiST index (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:204
+#, no-c-format
+msgid "#1772, fix ST_Line_Locate_Point with collapsed input (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:205
+#, no-c-format
+msgid "#1799, Protect ST_Segmentize from max_length=0 (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:206
+#, no-c-format
+msgid "Alter parameter order in 900913 (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:207
+#, no-c-format
+msgid "Support builds with \"gmake\" (Greg Troxel)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:212
+#, no-c-format
+msgid "Release 1.5.3"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:213
+#, no-c-format
+msgid "Release date: 2011/06/25"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:214
+#, no-c-format
+msgid ""
+"This is a bug fix release, addressing issues that have been filed since the "
+"1.5.2 release. If you are running PostGIS 1.3+, a soft upgrade is sufficient "
+"otherwise a hard upgrade is recommended."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:218
+#, no-c-format
+msgid ""
+"#1056, produce correct bboxes for arc geometries, fixes index errors (Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:220
+#, no-c-format
+msgid ""
+"#1007, ST_IsValid crash fix requires GEOS 3.3.0+ or 3.2.3+ (Sandro Santilli, "
+"reported by Birgit Laggner)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:222
+#, no-c-format
+msgid ""
+"#940, support for PostgreSQL 9.1 beta 1 (Regina Obe, Paul Ramsey, patch "
+"submitted by stl)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:224
+#, no-c-format
+msgid ""
+"#845, ST_Intersects precision error (Sandro Santilli, Nicklas Avén) Reported "
+"by cdestigter"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:226
+#, no-c-format
+msgid "#884, Unstable results with ST_Within, ST_Intersects (Chris Hodgson)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:227
+#, no-c-format
+msgid "#779, shp2pgsql -S option seems to fail on points (Jeff Adams)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:228
+#, no-c-format
+msgid "#666, ST_DumpPoints is not null safe (Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:229
+#, no-c-format
+msgid "#631, Update NZ projections for grid transformation support (jpalmer)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:230
+#, no-c-format
+msgid ""
+"#630, Peculiar Null treatment in arrays in ST_Collect (Chris Hodgson) "
+"Reported by David Bitner"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:232
+#, no-c-format
+msgid "#624, Memory leak in ST_GeogFromText (ryang, Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:233
+#, no-c-format
+msgid ""
+"#609, Bad source code in manual section 5.2 Java Clients (simoc, Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:234
+#, no-c-format
+msgid "#604, shp2pgsql usage touchups (Mike Toews, Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:235
+#, no-c-format
+msgid ""
+"#573 ST_Union fails on a group of linestrings Not a PostGIS bug, fixed in "
+"GEOS 3.3.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:237
+#, no-c-format
+msgid ""
+"#457 ST_CollectionExtract returns non-requested type (Nicklas Avén, Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:239
+#, no-c-format
+msgid "#441 ST_AsGeoJson Bbox on GeometryCollection error (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:240
+#, no-c-format
+msgid ""
+"#411 Ability to backup invalid geometries (Sando Santilli) Reported by "
+"Regione Toscana"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:242
+#, no-c-format
+msgid "#409 ST_AsSVG - degraded (Olivier Courtin) Reported by Sdikiy"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:244
+#, no-c-format
+msgid ""
+"#373 Documentation syntax error in hard upgrade (Paul Ramsey) Reported by "
+"psvensso"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:250
+#, no-c-format
+msgid "Release 1.5.2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:251
+#, no-c-format
+msgid "Release date: 2010/09/27"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:252
+#, no-c-format
+msgid ""
+"This is a bug fix release, addressing issues that have been filed since the "
+"1.5.1 release. If you are running PostGIS 1.3+, a soft upgrade is sufficient "
+"otherwise a hard upgrade is recommended."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:256
+#, no-c-format
+msgid ""
+"Loader: fix handling of empty (0-verticed) geometries in shapefiles. (Sandro "
+"Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:257
+#, no-c-format
+msgid ""
+"#536, Geography ST_Intersects, ST_Covers, ST_CoveredBy and Geometry "
+"ST_Equals not using spatial index (Regina Obe, Nicklas Aven)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:258
+#, no-c-format
+msgid "#573, Improvement to ST_Contains geography (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:259
+#, no-c-format
+msgid ""
+"Loader: Add support for command-q shutdown in Mac GTK build (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:260
+#, no-c-format
+msgid ""
+"#393, Loader: Add temporary patch for large DBF files (Maxime Guillaud, Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:261
+#, no-c-format
+msgid "#507, Fix wrong OGC URN in GeoJSON and GML output (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:262
+#, no-c-format
+msgid ""
+"spatial_ref_sys.sql Add datum conversion for projection SRID 3021 (Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:263
+#, no-c-format
+msgid ""
+"Geography - remove crash for case when all geographies are out of the "
+"estimate (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:264
+#, no-c-format
+msgid "#469, Fix for array_aggregation error (Greg Stark, Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:265
+#, no-c-format
+msgid ""
+"#532, Temporary geography tables showing up in other user sessions (Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:266
+#, no-c-format
+msgid "#562, ST_Dwithin errors for large geographies (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:267
+#, no-c-format
+msgid ""
+"#513, shape loading GUI tries to make spatial index when loading DBF only "
+"mode (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:268
+#, no-c-format
+msgid ""
+"#527, shape loading GUI should always append log messages (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:269
+#, no-c-format
+msgid "#504, shp2pgsql should rename xmin/xmax fields (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:270
+#, no-c-format
+msgid ""
+"#458, postgis_comments being installed in contrib instead of version folder "
+"(Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:271
+#, no-c-format
+msgid ""
+"#474, Analyzing a table with geography column crashes server (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:272
+#, no-c-format
+msgid "#581, LWGEOM-expand produces inconsistent results (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:273
+#, no-c-format
+msgid ""
+"#513, Add dbf filter to shp2pgsql-gui and allow uploading dbf only (Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:274
+#, no-c-format
+msgid "Fix further build issues against PostgreSQL 9.0 (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:275
+#, no-c-format
+msgid "#572, Password whitespace for Shape File (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:276
+#, no-c-format
+msgid ""
+"#603, shp2pgsql: \"-w\" produces invalid WKT for MULTI* objects. (Mark Cave-"
+"Ayland)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:281
+#, no-c-format
+msgid "Release 1.5.1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:282
+#, no-c-format
+msgid "Release date: 2010/03/11"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:283
+#, no-c-format
+msgid ""
+"This is a bug fix release, addressing issues that have been filed since the "
+"1.4.1 release. If you are running PostGIS 1.3+, a soft upgrade is sufficient "
+"otherwise a hard upgrade is recommended."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:287
+#, no-c-format
+msgid ""
+"#410, update embedded bbox when applying ST_SetPoint, ST_AddPoint "
+"ST_RemovePoint to a linestring (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:288
+#, no-c-format
+msgid ""
+"#411, allow dumping tables with invalid geometries (Sandro Santilli, for "
+"Regione Toscana-SIGTA)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:289
+#, no-c-format
+msgid ""
+"#414, include geography_columns view when running upgrade scripts (Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:290
+#, no-c-format
+msgid ""
+"#419, allow support for multilinestring in ST_Line_Substring (Paul Ramsey, "
+"for Lidwala Consulting Engineers)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:291
+#, no-c-format
+msgid "#421, fix computed string length in ST_AsGML() (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:292
+#, no-c-format
+msgid ""
+"#441, fix GML generation with heterogeneous collections (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:293
+#, no-c-format
+msgid ""
+"#443, incorrect coordinate reversal in GML 3 generation (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:294
+#, no-c-format
+msgid ""
+"#450, #451, wrong area calculation for geography features that cross the "
+"date line (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:295
+#, no-c-format
+msgid "Ensure support for upcoming 9.0 PgSQL release (Paul Ramsey)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:300
+#, no-c-format
+msgid "Release 1.5.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:301
+#, no-c-format
+msgid "Release date: 2010/02/04"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:302
+#, no-c-format
+msgid ""
+"This release provides support for geographic coordinates (lat/lon) via a new "
+"GEOGRAPHY type. Also performance enhancements, new input format support (GML,"
+"KML) and general upkeep."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:305 release_notes.xml:372
+#, no-c-format
+msgid "API Stability"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:306
+#, no-c-format
+msgid ""
+"The public API of PostGIS will not change during minor (0.0.X) releases."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:307
+#, no-c-format
+msgid ""
+"The definition of the =~ operator has changed from an exact geometric "
+"equality check to a bounding box equality check."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:311 release_notes.xml:377
+#, no-c-format
+msgid "Compatibility"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:312
+#, no-c-format
+msgid "GEOS, Proj4, and LibXML2 are now mandatory dependencies"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:313
+#, no-c-format
+msgid "The library versions below are the minimum requirements for PostGIS 1.5"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:314
+#, no-c-format
+msgid "PostgreSQL 8.3 and higher on all platforms"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:315
+#, no-c-format
+msgid "GEOS 3.1 and higher only (GEOS 3.2+ to take advantage of all features)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:316
+#, no-c-format
+msgid "LibXML2 2.5+ related to new ST_GeomFromGML/KML functionality"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:317
+#, no-c-format
+msgid "Proj4 4.5 and higher only"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:323
+#, no-c-format
+msgid "Added Hausdorff distance calculations (#209) (Vincent Picavet)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:324
+#, no-c-format
+msgid ""
+"Added parameters argument to ST_Buffer operation to support one-sided "
+"buffering and other buffering styles (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:325
+#, no-c-format
+msgid ""
+"Addition of other Distance related visualization and analysis functions "
+"(Nicklas Aven)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:327
+#, no-c-format
+msgid "ST_ClosestPoint"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:328
+#, no-c-format
+msgid "ST_DFullyWithin"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:329
+#, no-c-format
+msgid "ST_LongestLine"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:330
+#, no-c-format
+msgid "ST_MaxDistance"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:331
+#, no-c-format
+msgid "ST_ShortestLine"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:333
+#, no-c-format
+msgid "ST_DumpPoints (Maxime van Noppen)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:334
+#, no-c-format
+msgid "KML, GML input via ST_GeomFromGML and ST_GeomFromKML (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:335
+#, no-c-format
+msgid "Extract homogeneous collection with ST_CollectionExtract (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:336
+#, no-c-format
+msgid ""
+"Add measure values to an existing linestring with ST_AddMeasure (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:337
+#, no-c-format
+msgid "History table implementation in utils (George Silva)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:338
+#, no-c-format
+msgid "Geography type and supporting functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:340
+#, no-c-format
+msgid "Spherical algorithms (Dave Skea)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:341
+#, no-c-format
+msgid "Object/index implementation (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:342
+#, no-c-format
+msgid "Selectivity implementation (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:343
+#, no-c-format
+msgid "Serializations to KML, GML and JSON (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:344
+#, no-c-format
+msgid ""
+"ST_Area, ST_Distance, ST_DWithin, ST_GeogFromText, ST_GeogFromWKB, "
+"ST_Intersects, ST_Covers, ST_Buffer (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:350
+#, no-c-format
+msgid "Performance improvements to ST_Distance (Nicklas Aven)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:351
+#, no-c-format
+msgid "Documentation updates and improvements (Regina Obe, Kevin Neufeld)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:352
+#, no-c-format
+msgid "Testing and quality control (Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:353
+#, no-c-format
+msgid "PostGIS 1.5 support PostgreSQL 8.5 trunk (Guillaume Lelarge)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:354
+#, no-c-format
+msgid "Win32 support and improvement of core shp2pgsql-gui (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:355
+#, no-c-format
+msgid "In place 'make check' support (Paul Ramsey)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:359 release_notes.xml:425 release_notes.xml:610
+#: release_notes.xml:661 release_notes.xml:712 release_notes.xml:846
+#: release_notes.xml:912 release_notes.xml:1022 release_notes.xml:1129
+#: release_notes.xml:1249 release_notes.xml:1314 release_notes.xml:1361
+#, no-c-format
+msgid "Bug fixes"
+msgstr ""
+
+#. Tag: ulink
+#: release_notes.xml:360
+#, no-c-format
+msgid ""
+"http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS"
+"+1.5.0&order=priority"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:365
+#, no-c-format
+msgid "Release 1.4.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:366
+#, no-c-format
+msgid "Release date: 2009/07/24"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:367
+#, no-c-format
+msgid ""
+"This release provides performance enhancements, improved internal structures "
+"and testing, new features, and upgraded documentation. If you are running "
+"PostGIS 1.1+, a soft upgrade is sufficient otherwise a hard upgrade is "
+"recommended."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:373
+#, no-c-format
+msgid ""
+"As of the 1.4 release series, the public API of PostGIS will not change "
+"during minor releases."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:378
+#, no-c-format
+msgid "The versions below are the *minimum* requirements for PostGIS 1.4"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:379
+#, no-c-format
+msgid "PostgreSQL 8.2 and higher on all platforms"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:380
+#, no-c-format
+msgid "GEOS 3.0 and higher only"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:381
+#, no-c-format
+msgid "PROJ4 4.5 and higher only"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:386
+#, no-c-format
+msgid ""
+"ST_Union() uses high-speed cascaded union when compiled against GEOS 3.1+ "
+"(Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:388
+#, no-c-format
+msgid "ST_ContainsProperly() requires GEOS 3.1+"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:389
+#, no-c-format
+msgid ""
+"ST_Intersects(), ST_Contains(), ST_Within() use high-speed cached prepared "
+"geometry against GEOS 3.1+ (Paul Ramsey / funded by Zonar Systems)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:390
+#, no-c-format
+msgid ""
+"Vastly improved documentation and reference manual (Regina Obe & Kevin "
+"Neufeld)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:391
+#, no-c-format
+msgid "Figures and diagram examples in the reference manual (Kevin Neufeld)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:392
+#, no-c-format
+msgid ""
+"ST_IsValidReason() returns readable explanations for validity failures (Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:393
+#, no-c-format
+msgid ""
+"ST_GeoHash() returns a geohash.org signature for geometries (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:394
+#, no-c-format
+msgid "GTK+ multi-platform GUI for shape file loading (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:395
+#, no-c-format
+msgid "ST_LineCrossingDirection() returns crossing directions (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:396
+#, no-c-format
+msgid ""
+"ST_LocateBetweenElevations() returns sub-string based on Z-ordinate. (Paul "
+"Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:397
+#, no-c-format
+msgid ""
+"Geometry parser returns explicit error message about location of syntax "
+"errors (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:398
+#, no-c-format
+msgid "ST_AsGeoJSON() return JSON formatted geometry (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:399
+#, no-c-format
+msgid ""
+"Populate_Geometry_Columns() -- automatically add records to geometry_columns "
+"for TABLES and VIEWS (Kevin Neufeld)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:400
+#, no-c-format
+msgid ""
+"ST_MinimumBoundingCircle() -- returns the smallest circle polygon that can "
+"encompass a geometry (Bruce Rindahl)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:405
+#, no-c-format
+msgid ""
+"Core geometry system moved into independent library, liblwgeom. (Mark Cave-"
+"Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:406
+#, no-c-format
+msgid ""
+"New build system uses PostgreSQL \"pgxs\" build bootstrapper. (Mark Cave-"
+"Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:407
+#, no-c-format
+msgid "Debugging framework formalized and simplified. (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:408
+#, no-c-format
+msgid ""
+"All build-time #defines generated at configure time and placed in headers "
+"for easier cross-platform support (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:409
+#, no-c-format
+msgid "Logging framework formalized and simplified (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:410
+#, no-c-format
+msgid ""
+"Expanded and more stable support for CIRCULARSTRING, COMPOUNDCURVE and "
+"CURVEPOLYGON, better parsing, wider support in functions (Mark Leslie & "
+"Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:411
+#, no-c-format
+msgid "Improved support for OpenSolaris builds (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:412
+#, no-c-format
+msgid "Improved support for MSVC builds (Mateusz Loskot)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:413
+#, no-c-format
+msgid "Updated KML support (Olivier Courtin)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:414
+#, no-c-format
+msgid "Unit testing framework for liblwgeom (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:415
+#, no-c-format
+msgid ""
+"New testing framework to comprehensively exercise every PostGIS function "
+"(Regine Obe)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:416
+#, no-c-format
+msgid ""
+"Performance improvements to all geometry aggregate functions (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:417
+#, no-c-format
+msgid ""
+"Support for the upcoming PostgreSQL 8.4 (Mark Cave-Ayland, Talha Bin Rizwan)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:418
+#, no-c-format
+msgid ""
+"Shp2pgsql and pgsql2shp re-worked to depend on the common parsing/unparsing "
+"code in liblwgeom (Mark Cave-Ayland)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:419
+#, no-c-format
+msgid ""
+"Use of PDF DbLatex to build PDF docs and preliminary instructions for build "
+"(Jean David Techer)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:420
+#, no-c-format
+msgid ""
+"Automated User documentation build (PDF and HTML) and Developer Doxygen "
+"Documentation (Kevin Neufeld)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:421
+#, no-c-format
+msgid ""
+"Automated build of document images using ImageMagick from WKT geometry text "
+"files (Kevin Neufeld)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:422
+#, no-c-format
+msgid "More attractive CSS for HTML documentation (Dane Springmeyer)"
+msgstr ""
+
+#. Tag: ulink
+#: release_notes.xml:426
+#, no-c-format
+msgid ""
+"http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS"
+"+1.4.0&order=priority"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:431
+#, no-c-format
+msgid "Release 1.3.6"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:432
+#, no-c-format
+msgid "Release date: 2009/05/04"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:433
+#, no-c-format
+msgid ""
+"If you are running PostGIS 1.1+, a soft upgrade is sufficient otherwise a "
+"hard upgrade is recommended. This release adds support for PostgreSQL 8.4, "
+"exporting prj files from the database with shape data, some crash fixes for "
+"shp2pgsql, and several small bug fixes in the handling of \"curve\" types, "
+"logical error importing dbf only files, improved error handling of "
+"AddGeometryColumns."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:440
+#, no-c-format
+msgid "Release 1.3.5"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:441
+#, no-c-format
+msgid "Release date: 2008/12/15"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:442
+#, no-c-format
+msgid ""
+"If you are running PostGIS 1.1+, a soft upgrade is sufficient otherwise a "
+"hard upgrade is recommended. This release is a bug fix release to address a "
+"failure in ST_Force_Collection and related functions that critically affects "
+"using MapServer with LINE layers."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:449
+#, no-c-format
+msgid "Release 1.3.4"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:450
+#, no-c-format
+msgid "Release date: 2008/11/24"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:451
+#, no-c-format
+msgid ""
+"This release adds support for GeoJSON output, building with PostgreSQL 8.4, "
+"improves documentation quality and output aesthetics, adds function-level "
+"SQL documentation, and improves performance for some spatial predicates "
+"(point-in-polygon tests)."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:456
+#, no-c-format
+msgid ""
+"Bug fixes include removal of crashers in handling circular strings for many "
+"functions, some memory leaks removed, a linear referencing failure for "
+"measures on vertices, and more. See the NEWS file for details."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:463
+#, no-c-format
+msgid "Release 1.3.3"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:465
+#, no-c-format
+msgid "Release date: 2008/04/12"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:467
+#, no-c-format
+msgid ""
+"This release fixes bugs shp2pgsql, adds enhancements to SVG and KML support, "
+"adds a ST_SimplifyPreserveTopology function, makes the build more sensitive "
+"to GEOS versions, and fixes a handful of severe but rare failure cases."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:474
+#, no-c-format
+msgid "Release 1.3.2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:476
+#, no-c-format
+msgid "Release date: 2007/12/01"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:478
+#, no-c-format
+msgid ""
+"This release fixes bugs in ST_EndPoint() and ST_Envelope, improves support "
+"for JDBC building and OS/X, and adds better support for GML output with "
+"ST_AsGML(), including GML3 output."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:484
+#, no-c-format
+msgid "Release 1.3.1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:486
+#, no-c-format
+msgid "Release date: 2007/08/13"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:488
+#, no-c-format
+msgid ""
+"This release fixes some oversights in the previous release around version "
+"numbering, documentation, and tagging."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:493
+#, no-c-format
+msgid "Release 1.3.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:495
+#, no-c-format
+msgid "Release date: 2007/08/09"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:497
+#, no-c-format
+msgid ""
+"This release provides performance enhancements to the relational functions, "
+"adds new relational functions and begins the migration of our function names "
+"to the SQL-MM convention, using the spatial type (SP) prefix."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:503
+#, no-c-format
+msgid "Added Functionality"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:505
+#, no-c-format
+msgid "JDBC: Added Hibernate Dialect (thanks to Norman Barker)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:507
+#, no-c-format
+msgid ""
+"Added ST_Covers and ST_CoveredBy relational functions. Description and "
+"justification of these functions can be found at <ulink url=\"http://lin-ear-"
+"th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html"
+"\">http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-"
+"spatial.html</ulink>"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:511
+#, no-c-format
+msgid "Added ST_DWithin relational function."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:515
+#, no-c-format
+msgid "Performance Enhancements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:517
+#, no-c-format
+msgid ""
+"Added cached and indexed point-in-polygon short-circuits for the functions "
+"ST_Contains, ST_Intersects, ST_Within and ST_Disjoint"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:520
+#, no-c-format
+msgid ""
+"Added inline index support for relational functions (except ST_Disjoint)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:525
+#, no-c-format
+msgid "Other Changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:527
+#, no-c-format
+msgid ""
+"Extended curved geometry support into the geometry accessor and some "
+"processing functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:530
+#, no-c-format
+msgid ""
+"Began migration of functions to the SQL-MM naming convention; using a "
+"spatial type (ST) prefix."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:533
+#, no-c-format
+msgid "Added initial support for PostgreSQL 8.3"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:538
+#, no-c-format
+msgid "Release 1.2.1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:540
+#, no-c-format
+msgid "Release date: 2007/01/11"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:542
+#, no-c-format
+msgid ""
+"This release provides bug fixes in PostgreSQL 8.2 support and some small "
+"performance enhancements."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:546 release_notes.xml:574 release_notes.xml:1796
+#, no-c-format
+msgid "Changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:548
+#, no-c-format
+msgid "Fixed point-in-polygon shortcut bug in Within()."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:550
+#, no-c-format
+msgid "Fixed PostgreSQL 8.2 NULL handling for indexes."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:552
+#, no-c-format
+msgid "Updated RPM spec files."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:554
+#, no-c-format
+msgid "Added short-circuit for Transform() in no-op case."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:556
+#, no-c-format
+msgid ""
+"JDBC: Fixed JTS handling for multi-dimensional geometries (thanks to Thomas "
+"Marti for hint and partial patch). Additionally, now JavaDoc is compiled and "
+"packaged. Fixed classpath problems with GCJ. Fixed pgjdbc 8.2 compatibility, "
+"losing support for jdk 1.3 and older."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:565
+#, no-c-format
+msgid "Release 1.2.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:567
+#, no-c-format
+msgid "Release date: 2006/12/08"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:569
+#, no-c-format
+msgid ""
+"This release provides type definitions along with serialization/"
+"deserialization capabilities for SQL-MM defined curved geometries, as well "
+"as performance enhancements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:576
+#, no-c-format
+msgid "Added curved geometry type support for serialization/deserialization"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:579
+#, no-c-format
+msgid ""
+"Added point-in-polygon shortcircuit to the Contains and Within functions to "
+"improve performance for these cases."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:585
+#, no-c-format
+msgid "Release 1.1.6"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:587
+#, no-c-format
+msgid "Release date: 2006/11/02"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:589
+#, no-c-format
+msgid ""
+"This is a bugfix release, in particular fixing a critical error with GEOS "
+"interface in 64bit systems. Includes an updated of the SRS parameters and an "
+"improvement in reprojections (take Z in consideration). Upgrade is "
+"<emphasis>encouraged</emphasis>."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:595 release_notes.xml:646 release_notes.xml:697
+#: release_notes.xml:752 release_notes.xml:831 release_notes.xml:897
+#: release_notes.xml:970 release_notes.xml:1114 release_notes.xml:1171
+#: release_notes.xml:1234 release_notes.xml:1292 release_notes.xml:1350
+#: release_notes.xml:1390 release_notes.xml:1442 release_notes.xml:1494
+#: release_notes.xml:1533 release_notes.xml:1570 release_notes.xml:1637
+#: release_notes.xml:1734 release_notes.xml:1788
+#, no-c-format
+msgid "Upgrading"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:597 release_notes.xml:648 release_notes.xml:699
+#: release_notes.xml:754 release_notes.xml:833 release_notes.xml:899
+#, no-c-format
+msgid ""
+"If you are upgrading from release 1.0.3 or later follow the <link linkend="
+"\"soft_upgrade\">soft upgrade</link> procedure."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:600 release_notes.xml:651 release_notes.xml:702
+#: release_notes.xml:757 release_notes.xml:836 release_notes.xml:902
+#: release_notes.xml:978 release_notes.xml:1119 release_notes.xml:1176
+#: release_notes.xml:1239
+#, no-c-format
+msgid ""
+"If you are upgrading from a release <emphasis>between 1.0.0RC6 and 1.0.2</"
+"emphasis> (inclusive) and really want a live upgrade read the <link linkend="
+"\"rel_1.0.3_upgrading\">upgrade section</link> of the 1.0.3 release notes "
+"chapter."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:605 release_notes.xml:656 release_notes.xml:707
+#: release_notes.xml:762 release_notes.xml:841 release_notes.xml:907
+#: release_notes.xml:983 release_notes.xml:1124 release_notes.xml:1181
+#: release_notes.xml:1244
+#, no-c-format
+msgid ""
+"Upgrade from any release prior to 1.0.0RC6 requires an <link linkend="
+"\"hard_upgrade\">hard upgrade</link>."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:612
+#, no-c-format
+msgid "fixed CAPI change that broke 64-bit platforms"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:614
+#, no-c-format
+msgid "loader/dumper: fixed regression tests and usage output"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:616
+#, no-c-format
+msgid "Fixed setSRID() bug in JDBC, thanks to Thomas Marti"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:620 release_notes.xml:804 release_notes.xml:875
+#: release_notes.xml:1089 release_notes.xml:1215 release_notes.xml:1516
+#: release_notes.xml:1553 release_notes.xml:1605 release_notes.xml:1707
+#: release_notes.xml:1770
+#, no-c-format
+msgid "Other changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:622
+#, no-c-format
+msgid "use Z ordinate in reprojections"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:624
+#, no-c-format
+msgid "spatial_ref_sys.sql updated to EPSG 6.11.1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:626
+#, no-c-format
+msgid ""
+"Simplified Version.config infrastructure to use a single pack of version "
+"variables for everything."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:629
+#, no-c-format
+msgid "Include the Version.config in loader/dumper USAGE messages"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:632
+#, no-c-format
+msgid "Replace hand-made, fragile JDBC version parser with Properties"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:638
+#, no-c-format
+msgid "Release 1.1.5"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:640
+#, no-c-format
+msgid "Release date: 2006/10/13"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:642
+#, no-c-format
+msgid ""
+"This is an bugfix release, including a critical segfault on win32. Upgrade "
+"is <emphasis>encouraged</emphasis>."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:663
+#, no-c-format
+msgid ""
+"Fixed MingW link error that was causing pgsql2shp to segfault on Win32 when "
+"compiled for PostgreSQL 8.2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:666
+#, no-c-format
+msgid "fixed nullpointer Exception in Geometry.equals() method in Java"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:669
+#, no-c-format
+msgid ""
+"Added EJB3Spatial.odt to fulfill the GPL requirement of distributing the "
+"\"preferred form of modification\""
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:672
+#, no-c-format
+msgid "Removed obsolete synchronization from JDBC Jts code."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:674
+#, no-c-format
+msgid ""
+"Updated heavily outdated README files for shp2pgsql/pgsql2shp by merging "
+"them with the manpages."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:677
+#, no-c-format
+msgid ""
+"Fixed version tag in jdbc code that still said \"1.1.3\" in the \"1.1.4\" "
+"release."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:684
+#, no-c-format
+msgid "Added -S option for non-multi geometries to shp2pgsql"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:689
+#, no-c-format
+msgid "Release 1.1.4"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:691
+#, no-c-format
+msgid "Release date: 2006/09/27"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:693
+#, no-c-format
+msgid ""
+"This is an bugfix release including some improvements in the Java interface. "
+"Upgrade is <emphasis>encouraged</emphasis>."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:714
+#, no-c-format
+msgid "Fixed support for PostgreSQL 8.2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:716
+#, no-c-format
+msgid "Fixed bug in collect() function discarding SRID of input"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:718
+#, no-c-format
+msgid "Added SRID match check in MakeBox2d and MakeBox3d"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:720
+#, no-c-format
+msgid "Fixed regress tests to pass with GEOS-3.0.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:722
+#, no-c-format
+msgid "Improved pgsql2shp run concurrency."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:726
+#, no-c-format
+msgid "Java changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:728
+#, no-c-format
+msgid ""
+"reworked JTS support to reflect new upstream JTS developers' attitude to "
+"SRID handling. Simplifies code and drops build depend on GNU trove."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:732
+#, no-c-format
+msgid ""
+"Added EJB2 support generously donated by the \"Geodetix s.r.l. Company\" "
+"<ulink url=\"http://www.geodetix.it/\">http://www.geodetix.it/</ulink>"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:735
+#, no-c-format
+msgid ""
+"Added EJB3 tutorial / examples donated by Norman Barker <nbarker@ittvis."
+"com>"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:738
+#, no-c-format
+msgid "Reorganized java directory layout a little."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:743
+#, no-c-format
+msgid "Release 1.1.3"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:745
+#, no-c-format
+msgid "Release date: 2006/06/30"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:747
+#, no-c-format
+msgid ""
+"This is an bugfix release including also some new functionalities (most "
+"notably long transaction support) and portability enhancements. Upgrade is "
+"<emphasis>encouraged</emphasis>."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:767
+#, no-c-format
+msgid "Bug fixes / correctness"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:769
+#, no-c-format
+msgid "BUGFIX in distance(poly,poly) giving wrong results."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:771
+#, no-c-format
+msgid "BUGFIX in pgsql2shp successful return code."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:773
+#, no-c-format
+msgid "BUGFIX in shp2pgsql handling of MultiLine WKT."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:775
+#, no-c-format
+msgid "BUGFIX in affine() failing to update bounding box."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:777
+#, no-c-format
+msgid ""
+"WKT parser: forbidden construction of multigeometries with EMPTY elements "
+"(still supported for GEOMETRYCOLLECTION)."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:782 release_notes.xml:858 release_notes.xml:931
+#, no-c-format
+msgid "New functionalities"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:784
+#, no-c-format
+msgid "NEW Long Transactions support."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:786
+#, no-c-format
+msgid "NEW DumpRings() function."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:788
+#, no-c-format
+msgid "NEW AsHEXEWKB(geom, XDR|NDR) function."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:792 release_notes.xml:1683
+#, no-c-format
+msgid "JDBC changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:794
+#, no-c-format
+msgid "Improved regression tests: MultiPoint and scientific ordinates"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:797
+#, no-c-format
+msgid "Fixed some minor bugs in jdbc code"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:799
+#, no-c-format
+msgid ""
+"Added proper accessor functions for all fields in preparation of making "
+"those fields private later"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:806
+#, no-c-format
+msgid "NEW regress test support for loader/dumper."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:808
+#, no-c-format
+msgid "Added --with-proj-libdir and --with-geos-libdir configure switches."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:811
+#, no-c-format
+msgid "Support for build Tru64 build."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:813
+#, no-c-format
+msgid "Use Jade for generating documentation."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:815
+#, no-c-format
+msgid "Don't link pgsql2shp to more libs then required."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:817
+#, no-c-format
+msgid "Initial support for PostgreSQL 8.2."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:822
+#, no-c-format
+msgid "Release 1.1.2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:824
+#, no-c-format
+msgid "Release date: 2006/03/30"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:826
+#, no-c-format
+msgid ""
+"This is an bugfix release including some new functions and portability "
+"enhancements. Upgrade is <emphasis>encouraged</emphasis>."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:848
+#, no-c-format
+msgid "BUGFIX in SnapToGrid() computation of output bounding box"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:850
+#, no-c-format
+msgid "BUGFIX in EnforceRHR()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:852
+#, no-c-format
+msgid "jdbc2 SRID handling fixes in JTS code"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:854
+#, no-c-format
+msgid "Fixed support for 64bit archs"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:860
+#, no-c-format
+msgid "Regress tests can now be run *before* postgis installation"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:863
+#, no-c-format
+msgid "New affine() matrix transformation functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:865
+#, no-c-format
+msgid "New rotate{,X,Y,Z}() function"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:867
+#, no-c-format
+msgid "Old translating and scaling functions now use affine() internally"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:870
+#, no-c-format
+msgid ""
+"Embedded access control in estimated_extent() for builds against pgsql >= "
+"8.0.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:877
+#, no-c-format
+msgid "More portable ./configure script"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:879
+#, no-c-format
+msgid "Changed ./run_test script to have more sane default behaviour"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:885
+#, no-c-format
+msgid "Release 1.1.1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:887
+#, no-c-format
+msgid "Release date: 2006/01/23"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:889
+#, no-c-format
+msgid ""
+"This is an important Bugfix release, upgrade is <emphasis>highly "
+"recommended</emphasis>. Previous version contained a bug in postgis_restore."
+"pl preventing <link linkend=\"hard_upgrade\">hard upgrade</link> procedure "
+"to complete and a bug in GEOS-2.2+ connector preventing GeometryCollection "
+"objects to be used in topological operations."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:914
+#, no-c-format
+msgid "Fixed a premature exit in postgis_restore.pl"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:916
+#, no-c-format
+msgid "BUGFIX in geometrycollection handling of GEOS-CAPI connector"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:919
+#, no-c-format
+msgid "Solaris 2.7 and MingW support improvements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:921
+#, no-c-format
+msgid "BUGFIX in line_locate_point()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:923
+#, no-c-format
+msgid "Fixed handling of postgresql paths"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:925
+#, no-c-format
+msgid "BUGFIX in line_substring()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:927
+#, no-c-format
+msgid "Added support for localized cluster in regress tester"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:933
+#, no-c-format
+msgid "New Z and M interpolation in line_substring()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:935
+#, no-c-format
+msgid "New Z and M interpolation in line_interpolate_point()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:937
+#, no-c-format
+msgid "added NumInteriorRing() alias due to OpenGIS ambiguity"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:942
+#, no-c-format
+msgid "Release 1.1.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:944
+#, no-c-format
+msgid "Release date: 2005/12/21"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:946
+#, no-c-format
+msgid ""
+"This is a Minor release, containing many improvements and new things. Most "
+"notably: build procedure greatly simplified; transform() performance "
+"drastically improved; more stable GEOS connectivity (CAPI support); lots of "
+"new functions; draft topology support."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:951
+#, no-c-format
+msgid ""
+"It is <emphasis>highly recommended</emphasis> that you upgrade to GEOS-2.2.x "
+"before installing PostGIS, this will ensure future GEOS upgrades won't "
+"require a rebuild of the PostGIS library."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:956
+#, no-c-format
+msgid "Credits"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:958
+#, no-c-format
+msgid ""
+"This release includes code from Mark Cave Ayland for caching of proj4 "
+"objects. Markus Schaber added many improvements in his JDBC2 code. Alex "
+"Bodnaru helped with PostgreSQL source dependency relief and provided Debian "
+"specfiles. Michael Fuhr tested new things on Solaris arch. David Techer and "
+"Gerald Fenoy helped testing GEOS C-API connector. Hartmut Tschauner provided "
+"code for the azimuth() function. Devrim GUNDUZ provided RPM specfiles. Carl "
+"Anderson helped with the new area building functions. See the <link linkend="
+"\"credits\">credits</link> section for more names."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:972
+#, no-c-format
+msgid ""
+"If you are upgrading from release 1.0.3 or later you <emphasis>DO NOT</"
+"emphasis> need a dump/reload. Simply sourcing the new lwpostgis_upgrade.sql "
+"script in all your existing databases will work. See the <link linkend="
+"\"soft_upgrade\">soft upgrade</link> chapter for more information."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:988
+#, no-c-format
+msgid "New functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:990
+#, no-c-format
+msgid "scale() and transscale() companion methods to translate()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:992
+#, no-c-format
+msgid "line_substring()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:994
+#, no-c-format
+msgid "line_locate_point()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:996
+#, no-c-format
+msgid "M(point)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:998
+#, no-c-format
+msgid "LineMerge(geometry)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1000
+#, no-c-format
+msgid "shift_longitude(geometry)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1002
+#, no-c-format
+msgid "azimuth(geometry)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1004
+#, no-c-format
+msgid "locate_along_measure(geometry, float8)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1006
+#, no-c-format
+msgid "locate_between_measures(geometry, float8, float8)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1008
+#, no-c-format
+msgid "SnapToGrid by point offset (up to 4d support)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1010
+#, no-c-format
+msgid "BuildArea(any_geometry)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1012
+#, no-c-format
+msgid "OGC BdPolyFromText(linestring_wkt, srid)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1014
+#, no-c-format
+msgid "OGC BdMPolyFromText(linestring_wkt, srid)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1016
+#, no-c-format
+msgid "RemovePoint(linestring, offset)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1018
+#, no-c-format
+msgid "ReplacePoint(linestring, offset, point)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1024
+#, no-c-format
+msgid "Fixed memory leak in polygonize()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1026
+#, no-c-format
+msgid "Fixed bug in lwgeom_as_anytype cast functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1028
+#, no-c-format
+msgid ""
+"Fixed USE_GEOS, USE_PROJ and USE_STATS elements of postgis_version() output "
+"to always reflect library state."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1033
+#, no-c-format
+msgid "Function semantic changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1035
+#, no-c-format
+msgid "SnapToGrid doesn't discard higher dimensions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1037
+#, no-c-format
+msgid ""
+"Changed Z() function to return NULL if requested dimension is not available"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1042
+#, no-c-format
+msgid "Performance improvements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1044
+#, no-c-format
+msgid "Much faster transform() function, caching proj4 objects"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1046
+#, no-c-format
+msgid ""
+"Removed automatic call to fix_geometry_columns() in AddGeometryColumns() and "
+"update_geometry_stats()"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1051
+#, no-c-format
+msgid "JDBC2 works"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1053
+#, no-c-format
+msgid "Makefile improvements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1055 release_notes.xml:1091
+#, no-c-format
+msgid "JTS support improvements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1057
+#, no-c-format
+msgid "Improved regression test system"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1059
+#, no-c-format
+msgid "Basic consistency check method for geometry collections"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1061
+#, no-c-format
+msgid "Support for (Hex)(E)wkb"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1063
+#, no-c-format
+msgid "Autoprobing DriverWrapper for HexWKB / EWKT switching"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1065
+#, no-c-format
+msgid "fix compile problems in ValueSetter for ancient jdk releases."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1068
+#, no-c-format
+msgid "fix EWKT constructors to accept SRID=4711; representation"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1070
+#, no-c-format
+msgid "added preliminary read-only support for java2d geometries"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1074
+#, no-c-format
+msgid "Other new things"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1076
+#, no-c-format
+msgid ""
+"Full autoconf-based configuration, with PostgreSQL source dependency relief"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1079
+#, no-c-format
+msgid "GEOS C-API support (2.2.0 and higher)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1081
+#, no-c-format
+msgid "Initial support for topology modelling"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1083
+#, no-c-format
+msgid "Debian and RPM specfiles"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1085
+#, no-c-format
+msgid "New lwpostgis_upgrade.sql script"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1093
+#, no-c-format
+msgid "Stricter mapping between DBF and SQL integer and string attributes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1096
+#, no-c-format
+msgid "Wider and cleaner regression test suite"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1098
+#, no-c-format
+msgid "old jdbc code removed from release"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1100
+#, no-c-format
+msgid "obsoleted direct use of postgis_proc_upgrade.pl"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1102
+#, no-c-format
+msgid "scripts version unified with release version"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1107
+#, no-c-format
+msgid "Release 1.0.6"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1109
+#, no-c-format
+msgid "Release date: 2005/12/06"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1111 release_notes.xml:1347
+#, no-c-format
+msgid "Contains a few bug fixes and improvements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1116 release_notes.xml:1173
+#, no-c-format
+msgid ""
+"If you are upgrading from release 1.0.3 or later you <emphasis>DO NOT</"
+"emphasis> need a dump/reload."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1131
+#, no-c-format
+msgid ""
+"Fixed palloc(0) call in collection deserializer (only gives problem with --"
+"enable-cassert)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1134
+#, no-c-format
+msgid "Fixed bbox cache handling bugs"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1136
+#, no-c-format
+msgid "Fixed geom_accum(NULL, NULL) segfault"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1138
+#, no-c-format
+msgid "Fixed segfault in addPoint()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1140
+#, no-c-format
+msgid "Fixed short-allocation in lwcollection_clone()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1142
+#, no-c-format
+msgid "Fixed bug in segmentize()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1144
+#, no-c-format
+msgid "Fixed bbox computation of SnapToGrid output"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1148 release_notes.xml:1266 release_notes.xml:1328
+#: release_notes.xml:1374
+#, no-c-format
+msgid "Improvements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1150
+#, no-c-format
+msgid "Initial support for postgresql 8.2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1152
+#, no-c-format
+msgid "Added missing SRID mismatch checks in GEOS ops"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1157
+#, no-c-format
+msgid "Release 1.0.5"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1159
+#, no-c-format
+msgid "Release date: 2005/11/25"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1161
+#, no-c-format
+msgid ""
+"Contains memory-alignment fixes in the library, a segfault fix in loader's "
+"handling of UTF8 attributes and a few improvements and cleanups."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1166
+#, no-c-format
+msgid ""
+"Return code of shp2pgsql changed from previous releases to conform to unix "
+"standards (return 0 on success)."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1186 release_notes.xml:1401 release_notes.xml:1453
+#: release_notes.xml:1502 release_notes.xml:1544 release_notes.xml:1578
+#: release_notes.xml:1645 release_notes.xml:1742
+#, no-c-format
+msgid "Library changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1188
+#, no-c-format
+msgid "Fixed memory alignment problems"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1190
+#, no-c-format
+msgid "Fixed computation of null values fraction in analyzer"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1192
+#, no-c-format
+msgid "Fixed a small bug in the getPoint4d_p() low-level function"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1195
+#, no-c-format
+msgid "Speedup of serializer functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1197
+#, no-c-format
+msgid "Fixed a bug in force_3dm(), force_3dz() and force_4d()"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1201
+#, no-c-format
+msgid "Loader changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1203
+#, no-c-format
+msgid "Fixed return code of shp2pgsql"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1205
+#, no-c-format
+msgid "Fixed back-compatibility issue in loader (load of null shapefiles)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1208
+#, no-c-format
+msgid "Fixed handling of trailing dots in dbf numerical attributes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1211
+#, no-c-format
+msgid "Segfault fix in shp2pgsql (utf8 encoding)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1217
+#, no-c-format
+msgid "Schema aware postgis_proc_upgrade.pl, support for pgsql 7.2+"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1220
+#, no-c-format
+msgid "New \"Reporting Bugs\" chapter in manual"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1225
+#, no-c-format
+msgid "Release 1.0.4"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1227
+#, no-c-format
+msgid "Release date: 2005/09/09"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1229
+#, no-c-format
+msgid ""
+"Contains important bug fixes and a few improvements. In particular, it fixes "
+"a memory leak preventing successful build of GiST indexes for large spatial "
+"tables."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1236
+#, no-c-format
+msgid ""
+"If you are upgrading from release 1.0.3 you <emphasis>DO NOT</emphasis> need "
+"a dump/reload."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1251
+#, no-c-format
+msgid "Memory leak plugged in GiST indexing"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1253
+#, no-c-format
+msgid "Segfault fix in transform() handling of proj4 errors"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1255
+#, no-c-format
+msgid "Fixed some proj4 texts in spatial_ref_sys (missing +proj)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1257
+#, no-c-format
+msgid ""
+"Loader: fixed string functions usage, reworked NULL objects check, fixed "
+"segfault on MULTILINESTRING input."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1260
+#, no-c-format
+msgid "Fixed bug in MakeLine dimension handling"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1262
+#, no-c-format
+msgid "Fixed bug in translate() corrupting output bounding box"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1268
+#, no-c-format
+msgid "Documentation improvements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1270
+#, no-c-format
+msgid "More robust selectivity estimator"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1272
+#, no-c-format
+msgid "Minor speedup in distance()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1274
+#, no-c-format
+msgid "Minor cleanups"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1276
+#, no-c-format
+msgid "GiST indexing cleanup"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1278
+#, no-c-format
+msgid "Looser syntax acceptance in box3d parser"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1283
+#, no-c-format
+msgid "Release 1.0.3"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1285
+#, no-c-format
+msgid "Release date: 2005/08/08"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1287
+#, no-c-format
+msgid ""
+"Contains some bug fixes - <emphasis>including a severe one affecting "
+"correctness of stored geometries</emphasis> - and a few improvements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1294
+#, no-c-format
+msgid ""
+"Due to a bug in a bounding box computation routine, the upgrade procedure "
+"requires special attention, as bounding boxes cached in the database could "
+"be incorrect."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1298
+#, no-c-format
+msgid ""
+"An <link linkend=\"hard_upgrade\">hard upgrade</link> procedure (dump/"
+"reload) will force recomputation of all bounding boxes (not included in "
+"dumps). This is <emphasis>required</emphasis> if upgrading from releases "
+"prior to 1.0.0RC6."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1303
+#, no-c-format
+msgid ""
+"If you are upgrading from versions 1.0.0RC6 or up, this release includes a "
+"perl script (utils/rebuild_bbox_caches.pl) to force recomputation of "
+"geometries' bounding boxes and invoke all operations required to propagate "
+"eventual changes in them (geometry statistics update, reindexing). Invoke "
+"the script after a make install (run with no args for syntax help). "
+"Optionally run utils/postgis_proc_upgrade.pl to refresh postgis procedures "
+"and functions signatures (see <link linkend=\"soft_upgrade\">Soft upgrade</"
+"link>)."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1316
+#, no-c-format
+msgid "Severe bugfix in lwgeom's 2d bounding box computation"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1318
+#, no-c-format
+msgid "Bugfix in WKT (-w) POINT handling in loader"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1320
+#, no-c-format
+msgid "Bugfix in dumper on 64bit machines"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1322
+#, no-c-format
+msgid "Bugfix in dumper handling of user-defined queries"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1324
+#, no-c-format
+msgid "Bugfix in create_undef.pl script"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1330
+#, no-c-format
+msgid "Small performance improvement in canonical input function"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1332
+#, no-c-format
+msgid "Minor cleanups in loader"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1334
+#, no-c-format
+msgid "Support for multibyte field names in loader"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1336
+#, no-c-format
+msgid "Improvement in the postgis_restore.pl script"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1338
+#, no-c-format
+msgid "New rebuild_bbox_caches.pl util script"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1343
+#, no-c-format
+msgid "Release 1.0.2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1345
+#, no-c-format
+msgid "Release date: 2005/07/04"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1352 release_notes.xml:1392
+#, no-c-format
+msgid ""
+"If you are upgrading from release 1.0.0RC6 or up you <emphasis>DO NOT</"
+"emphasis> need a dump/reload."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1355 release_notes.xml:1395
+#, no-c-format
+msgid ""
+"Upgrading from older releases requires a dump/reload. See the <link linkend="
+"\"upgrading\">upgrading</link> chapter for more informations."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1363
+#, no-c-format
+msgid "Fault tolerant btree ops"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1365
+#, no-c-format
+msgid "Memory leak plugged in pg_error"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1367
+#, no-c-format
+msgid "Rtree index fix"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1369
+#, no-c-format
+msgid "Cleaner build scripts (avoided mix of CFLAGS and CXXFLAGS)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1376
+#, no-c-format
+msgid "New index creation capabilities in loader (-I switch)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1378
+#, no-c-format
+msgid "Initial support for postgresql 8.1dev"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1383
+#, no-c-format
+msgid "Release 1.0.1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1385
+#, no-c-format
+msgid "Release date: 2005/05/24"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1387
+#, no-c-format
+msgid "Contains a few bug fixes and some improvements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1403
+#, no-c-format
+msgid "BUGFIX in 3d computation of length_spheroid()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1405
+#, no-c-format
+msgid "BUGFIX in join selectivity estimator"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1409 release_notes.xml:1465
+#, no-c-format
+msgid "Other changes/additions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1411
+#, no-c-format
+msgid "BUGFIX in shp2pgsql escape functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1413
+#, no-c-format
+msgid "better support for concurrent postgis in multiple schemas"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1415
+#, no-c-format
+msgid "documentation fixes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1417
+#, no-c-format
+msgid "jdbc2: compile with \"-target 1.2 -source 1.2\" by default"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1419
+#, no-c-format
+msgid "NEW -k switch for pgsql2shp"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1421
+#, no-c-format
+msgid "NEW support for custom createdb options in postgis_restore.pl"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1424
+#, no-c-format
+msgid "BUGFIX in pgsql2shp attribute names unicity enforcement"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1426
+#, no-c-format
+msgid "BUGFIX in Paris projections definitions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1428
+#, no-c-format
+msgid "postgis_restore.pl cleanups"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1433
+#, no-c-format
+msgid "Release 1.0.0"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1435
+#, no-c-format
+msgid "Release date: 2005/04/19"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1437
+#, no-c-format
+msgid ""
+"Final 1.0.0 release. Contains a few bug fixes, some improvements in the "
+"loader (most notably support for older postgis versions), and more docs."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1444
+#, no-c-format
+msgid ""
+"If you are upgrading from release 1.0.0RC6 you <emphasis>DO NOT</emphasis> "
+"need a dump/reload."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1447 release_notes.xml:1538
+#, no-c-format
+msgid ""
+"Upgrading from any other precedent release requires a dump/reload. See the "
+"<link linkend=\"upgrading\">upgrading</link> chapter for more informations."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1455
+#, no-c-format
+msgid "BUGFIX in transform() releasing random memory address"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1457
+#, no-c-format
+msgid "BUGFIX in force_3dm() allocating less memory then required"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1460
+#, no-c-format
+msgid "BUGFIX in join selectivity estimator (defaults, leaks, tuplecount, sd)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1467
+#, no-c-format
+msgid "BUGFIX in shp2pgsql escape of values starting with tab or single-quote"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1470
+#, no-c-format
+msgid "NEW manual pages for loader/dumper"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1472
+#, no-c-format
+msgid "NEW shp2pgsql support for old (HWGEOM) postgis versions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1474
+#, no-c-format
+msgid "NEW -p (prepare) flag for shp2pgsql"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1476
+#, no-c-format
+msgid "NEW manual chapter about OGC compliancy enforcement"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1478
+#, no-c-format
+msgid "NEW autoconf support for JTS lib"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1480
+#, no-c-format
+msgid "BUGFIX in estimator testers (support for LWGEOM and schema parsing)"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1486
+#, no-c-format
+msgid "Release 1.0.0RC6"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1488
+#, no-c-format
+msgid "Release date: 2005/03/30"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1490
+#, no-c-format
+msgid ""
+"Sixth release candidate for 1.0.0. Contains a few bug fixes and cleanups."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1496 release_notes.xml:1572 release_notes.xml:1639
+#: release_notes.xml:1736 release_notes.xml:1790
+#, no-c-format
+msgid ""
+"You need a dump/reload to upgrade from precedent releases. See the <link "
+"linkend=\"upgrading\">upgrading</link> chapter for more informations."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1504
+#, no-c-format
+msgid "BUGFIX in multi()"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1506
+#, no-c-format
+msgid "early return [when noop] from multi()"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1510 release_notes.xml:1596 release_notes.xml:1669
+#: release_notes.xml:1761
+#, no-c-format
+msgid "Scripts changes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1512
+#, no-c-format
+msgid "dropped {x,y}{min,max}(box2d) functions"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1518
+#, no-c-format
+msgid "BUGFIX in postgis_restore.pl scrip"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1520
+#, no-c-format
+msgid "BUGFIX in dumper's 64bit support"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1525
+#, no-c-format
+msgid "Release 1.0.0RC5"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1527
+#, no-c-format
+msgid "Release date: 2005/03/25"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1529
+#, no-c-format
+msgid ""
+"Fifth release candidate for 1.0.0. Contains a few bug fixes and a "
+"improvements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1535
+#, no-c-format
+msgid ""
+"If you are upgrading from release 1.0.0RC4 you <emphasis>DO NOT</emphasis> "
+"need a dump/reload."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1546
+#, no-c-format
+msgid "BUGFIX (segfaulting) in box3d computation (yes, another!)."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1549
+#, no-c-format
+msgid "BUGFIX (segfaulting) in estimated_extent()."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1555
+#, no-c-format
+msgid "Small build scripts and utilities refinements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1557
+#, no-c-format
+msgid "Additional performance tips documented."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1562
+#, no-c-format
+msgid "Release 1.0.0RC4"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1564
+#, no-c-format
+msgid "Release date: 2005/03/18"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1566
+#, no-c-format
+msgid ""
+"Fourth release candidate for 1.0.0. Contains bug fixes and a few "
+"improvements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1580
+#, no-c-format
+msgid "BUGFIX (segfaulting) in geom_accum()."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1582
+#, no-c-format
+msgid "BUGFIX in 64bit architectures support."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1584
+#, no-c-format
+msgid "BUGFIX in box3d computation function with collections."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1586
+#, no-c-format
+msgid "NEW subselects support in selectivity estimator."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1588
+#, no-c-format
+msgid "Early return from force_collection."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1590
+#, no-c-format
+msgid "Consistency check fix in SnapToGrid()."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1592
+#, no-c-format
+msgid "Box2d output changed back to 15 significant digits."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1598
+#, no-c-format
+msgid "NEW distance_sphere() function."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1600
+#, no-c-format
+msgid ""
+"Changed get_proj4_from_srid implementation to use PL/PGSQL instead of SQL."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1607
+#, no-c-format
+msgid "BUGFIX in loader and dumper handling of MultiLine shapes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1609
+#, no-c-format
+msgid "BUGFIX in loader, skipping all but first hole of polygons."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1612
+#, no-c-format
+msgid "jdbc2: code cleanups, Makefile improvements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1614
+#, no-c-format
+msgid ""
+"FLEX and YACC variables set *after* pgsql Makefile.global is included and "
+"only if the pgsql *stripped* version evaluates to the empty string"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1618
+#, no-c-format
+msgid "Added already generated parser in release"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1620
+#, no-c-format
+msgid "Build scripts refinements"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1622
+#, no-c-format
+msgid "improved version handling, central Version.config"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1624
+#, no-c-format
+msgid "improvements in postgis_restore.pl"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1629
+#, no-c-format
+msgid "Release 1.0.0RC3"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1631
+#, no-c-format
+msgid "Release date: 2005/02/24"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1633
+#, no-c-format
+msgid ""
+"Third release candidate for 1.0.0. Contains many bug fixes and improvements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1647
+#, no-c-format
+msgid "BUGFIX in transform(): missing SRID, better error handling."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1650
+#, no-c-format
+msgid "BUGFIX in memory alignment handling"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1652
+#, no-c-format
+msgid ""
+"BUGFIX in force_collection() causing mapserver connector failures on simple "
+"(single) geometry types."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1655
+#, no-c-format
+msgid "BUGFIX in GeometryFromText() missing to add a bbox cache."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1657
+#, no-c-format
+msgid "reduced precision of box2d output."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1659
+#, no-c-format
+msgid "prefixed DEBUG macros with PGIS_ to avoid clash with pgsql one"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1662
+#, no-c-format
+msgid "plugged a leak in GEOS2POSTGIS converter"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1664
+#, no-c-format
+msgid "Reduced memory usage by early releasing query-context palloced one."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1671
+#, no-c-format
+msgid "BUGFIX in 72 index bindings."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1673
+#, no-c-format
+msgid ""
+"BUGFIX in probe_geometry_columns() to work with PG72 and support multiple "
+"geometry columns in a single table"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1676
+#, no-c-format
+msgid "NEW bool::text cast"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1678
+#, no-c-format
+msgid "Some functions made IMMUTABLE from STABLE, for performance improvement."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1685
+#, no-c-format
+msgid "jdbc2: small patches, box2d/3d tests, revised docs and license."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1688
+#, no-c-format
+msgid "jdbc2: bug fix and testcase in for pgjdbc 8.0 type autoregistration"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1691
+#, no-c-format
+msgid ""
+"jdbc2: Removed use of jdk1.4 only features to enable build with older jdk "
+"releases."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1694
+#, no-c-format
+msgid "jdbc2: Added support for building against pg72jdbc2.jar"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1696
+#, no-c-format
+msgid "jdbc2: updated and cleaned makefile"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1698
+#, no-c-format
+msgid "jdbc2: added BETA support for jts geometry classes"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1700
+#, no-c-format
+msgid "jdbc2: Skip known-to-fail tests against older PostGIS servers."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1703
+#, no-c-format
+msgid "jdbc2: Fixed handling of measured geometries in EWKT."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1709
+#, no-c-format
+msgid "new performance tips chapter in manual"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1711
+#, no-c-format
+msgid "documentation updates: pgsql72 requirement, lwpostgis.sql"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1713
+#, no-c-format
+msgid "few changes in autoconf"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1715
+#, no-c-format
+msgid "BUILDDATE extraction made more portable"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1717
+#, no-c-format
+msgid "fixed spatial_ref_sys.sql to avoid vacuuming the whole database."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1720
+#, no-c-format
+msgid ""
+"spatial_ref_sys: changed Paris entries to match the ones distributed with 0."
+"x."
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1726
+#, no-c-format
+msgid "Release 1.0.0RC2"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1728
+#, no-c-format
+msgid "Release date: 2005/01/26"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1730
+#, no-c-format
+msgid ""
+"Second release candidate for 1.0.0 containing bug fixes and a few "
+"improvements."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1744
+#, no-c-format
+msgid "BUGFIX in pointarray box3d computation"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1746
+#, no-c-format
+msgid "BUGFIX in distance_spheroid definition"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1748
+#, no-c-format
+msgid "BUGFIX in transform() missing to update bbox cache"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1750
+#, no-c-format
+msgid "NEW jdbc driver (jdbc2)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1752
+#, no-c-format
+msgid "GEOMETRYCOLLECTION(EMPTY) syntax support for backward compatibility"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1755
+#, no-c-format
+msgid "Faster binary outputs"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1757
+#, no-c-format
+msgid "Stricter OGC WKB/WKT constructors"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1763
+#, no-c-format
+msgid "More correct STABLE, IMMUTABLE, STRICT uses in lwpostgis.sql"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1766
+#, no-c-format
+msgid "stricter OGC WKB/WKT constructors"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1772
+#, no-c-format
+msgid "Faster and more robust loader (both i18n and not)"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1774
+#, no-c-format
+msgid "Initial autoconf script"
+msgstr ""
+
+#. Tag: title
+#: release_notes.xml:1779
+#, no-c-format
+msgid "Release 1.0.0RC1"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1781
+#, no-c-format
+msgid "Release date: 2005/01/13"
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1783
+#, no-c-format
+msgid ""
+"This is the first candidate of a major postgis release, with internal "
+"storage of postgis types redesigned to be smaller and faster on indexed "
+"queries."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1798
+#, no-c-format
+msgid "Faster canonical input parsing."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1800
+#, no-c-format
+msgid "Lossless canonical output."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1802
+#, no-c-format
+msgid "EWKB Canonical binary IO with PG>73."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1804
+#, no-c-format
+msgid ""
+"Support for up to 4d coordinates, providing lossless shapefile->postgis-"
+">shapefile conversion."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1807
+#, no-c-format
+msgid ""
+"New function: UpdateGeometrySRID(), AsGML(), SnapToGrid(), ForceRHR(), "
+"estimated_extent(), accum()."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1810
+#, no-c-format
+msgid "Vertical positioning indexed operators."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1812
+#, no-c-format
+msgid "JOIN selectivity function."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1814
+#, no-c-format
+msgid "More geometry constructors / editors."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1816
+#, no-c-format
+msgid "PostGIS extension API."
+msgstr ""
+
+#. Tag: para
+#: release_notes.xml:1818
+#, no-c-format
+msgid "UTF8 support in loader."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: reporting.xml:3
+#, no-c-format
+msgid "Reporting Problems"
+msgstr ""
+
+#. Tag: title
+#: reporting.xml:6
+#, no-c-format
+msgid "Reporting Software Bugs"
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:8
+#, no-c-format
+msgid ""
+"Reporting bugs effectively is a fundamental way to help PostGIS development. "
+"The most effective bug report is that enabling PostGIS developers to "
+"reproduce it, so it would ideally contain a script triggering it and every "
+"information regarding the environment in which it was detected. Good enough "
+"info can be extracted running <code>SELECT postgis_full_version()</code> "
+"[for postgis] and <code>SELECT version()</code> [for postgresql]."
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:16
+#, no-c-format
+msgid ""
+"If you aren't using the latest release, it's worth taking a look at its "
+"<ulink url=\"http://svn.osgeo.org/postgis/trunk/NEWS\">release changelog</"
+"ulink> first, to find out if your bug has already been fixed."
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:21
+#, no-c-format
+msgid ""
+"Using the <ulink url=\"http://trac.osgeo.org/postgis/\">PostGIS bug tracker</"
+"ulink> will ensure your reports are not discarded, and will keep you "
+"informed on its handling process. Before reporting a new bug please query "
+"the database to see if it is a known one, and if it is please add any new "
+"information you have about it."
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:28
+#, no-c-format
+msgid ""
+"You might want to read Simon Tatham's paper about <ulink url=\"http://www."
+"chiark.greenend.org.uk/~sgtatham/bugs.html\">How to Report Bugs Effectively</"
+"ulink> before filing a new report."
+msgstr ""
+
+#. Tag: title
+#: reporting.xml:34
+#, no-c-format
+msgid "Reporting Documentation Issues"
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:36
+#, no-c-format
+msgid ""
+"The documentation should accurately reflect the features and behavior of the "
+"software. If it doesn't, it could be because of a software bug or because "
+"the documentation is in error or deficient."
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:40
+#, no-c-format
+msgid ""
+"Documentation issues can also be reported to the <ulink url=\"http://trac."
+"osgeo.org/postgis\">PostGIS bug tracker</ulink>."
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:44
+#, no-c-format
+msgid ""
+"If your revision is trivial, just describe it in a new bug tracker issue, "
+"being specific about its location in the documentation."
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:47
+#, no-c-format
+msgid ""
+"If your changes are more extensive, a Subversion patch is definitely "
+"preferred. This is a four step process on Unix (assuming you already have "
+"<ulink url=\"http://subversion.apache.org/\">Subversion</ulink> installed):"
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:54
+#, no-c-format
+msgid "Check out a copy of PostGIS' Subversion trunk. On Unix, type:"
+msgstr ""
+
+#. Tag: command
+#: reporting.xml:57
+#, no-c-format
+msgid "svn checkout http://svn.osgeo.org/postgis/trunk/"
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:60
+#, no-c-format
+msgid "This will be stored in the directory ./trunk"
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:64
+#, no-c-format
+msgid ""
+"Make your changes to the documentation with your favorite text editor. On "
+"Unix, type (for example):"
+msgstr ""
+
+#. Tag: command
+#: reporting.xml:67
+#, no-c-format
+msgid "vim trunk/doc/postgis.xml"
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:69
+#, no-c-format
+msgid ""
+"Note that the documentation is written in DocBook XML rather than HTML, so "
+"if you are not familiar with it please follow the example of the rest of the "
+"documentation."
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:75
+#, no-c-format
+msgid ""
+"Make a patch file containing the differences from the master copy of the "
+"documentation. On Unix, type:"
+msgstr ""
+
+#. Tag: command
+#: reporting.xml:78
+#, no-c-format
+msgid "svn diff trunk/doc/postgis.xml > doc.patch"
+msgstr ""
+
+#. Tag: para
+#: reporting.xml:83
+#, no-c-format
+msgid "Attach the patch to a new issue in bug tracker."
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: using_postgis_app.xml:3
+#, no-c-format
+msgid "Using PostGIS Geometry: Building Applications"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:5
+#, no-c-format
+msgid "Using MapServer"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:7
+#, no-c-format
+msgid ""
+"The Minnesota MapServer is an internet web-mapping server which conforms to "
+"the OpenGIS Web Mapping Server specification."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:12
+#, no-c-format
+msgid ""
+"The MapServer homepage is at <ulink url=\"http://mapserver.org\">http://"
+"mapserver.org</ulink>."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:17
+#, no-c-format
+msgid ""
+"The OpenGIS Web Map Specification is at <ulink url=\"http://www."
+"opengeospatial.org/standards/wms\">http://www.opengeospatial.org/standards/"
+"wms</ulink>."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:23
+#, no-c-format
+msgid "Basic Usage"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:25
+#, no-c-format
+msgid ""
+"To use PostGIS with MapServer, you will need to know about how to configure "
+"MapServer, which is beyond the scope of this documentation. This section "
+"will cover specific PostGIS issues and configuration details."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:30
+#, no-c-format
+msgid "To use PostGIS with MapServer, you will need:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:34
+#, no-c-format
+msgid "Version 0.6 or newer of PostGIS."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:38
+#, no-c-format
+msgid "Version 3.5 or newer of MapServer."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:42
+#, no-c-format
+msgid ""
+"MapServer accesses PostGIS/PostgreSQL data like any other PostgreSQL client "
+"-- using the <filename>libpq</filename> interface. This means that MapServer "
+"can be installed on any machine with network access to the PostGIS server, "
+"and use PostGIS as a source of data. The faster the connection between the "
+"systems, the better."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:50
+#, no-c-format
+msgid ""
+"Compile and install MapServer, with whatever options you desire, including "
+"the \"--with-postgis\" configuration option."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:55
+#, no-c-format
+msgid "In your MapServer map file, add a PostGIS layer. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:58
+#, no-c-format
+msgid ""
+"LAYER \n"
+" CONNECTIONTYPE postgis \n"
+" NAME \"widehighways\" \n"
+" # Connect to a remote spatial database\n"
+" CONNECTION \"user=dbuser dbname=gisdatabase host=bigserver\"\n"
+" PROCESSING \"CLOSE_CONNECTION=DEFER\"\n"
+" # Get the lines from the 'geom' column of the 'roads' table \n"
+" DATA \"geom from roads using srid=4326 using unique gid\" \n"
+" STATUS ON\n"
+" TYPE LINE \n"
+" # Of the lines in the extents, only render the wide highways \n"
+" FILTER \"type = 'highway' and numlanes >= 4\" \n"
+" CLASS \n"
+" # Make the superhighways brighter and 2 pixels wide\n"
+" EXPRESSION ([numlanes] >= 6) \n"
+" STYLE\n"
+" COLOR 255 22 22 \n"
+" WIDTH 2 \n"
+" END\n"
+" END \n"
+" CLASS \n"
+" # All the rest are darker and only 1 pixel wide \n"
+" EXPRESSION ([numlanes] < 6) \n"
+" STYLE\n"
+" COLOR 205 92 82\n"
+" END\n"
+" END \n"
+"END"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:60
+#, no-c-format
+msgid "In the example above, the PostGIS-specific directives are as follows:"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_app.xml:65
+#, no-c-format
+msgid "CONNECTIONTYPE"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:68
+#, no-c-format
+msgid "For PostGIS layers, this is always \"postgis\"."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_app.xml:73
+#, no-c-format
+msgid "CONNECTION"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:76
+#, no-c-format
+msgid ""
+"The database connection is governed by the a 'connection string' which is a "
+"standard set of keys and values like this (with the default values in <"
+">):"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:80
+#, no-c-format
+msgid ""
+"user=<username> password=<password> dbname=<username> "
+"hostname=<server> port=<5432>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:84
+#, no-c-format
+msgid ""
+"An empty connection string is still valid, and any of the key/value pairs "
+"can be omitted. At a minimum you will generally supply the database name and "
+"username to connect with."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_app.xml:92
+#, no-c-format
+msgid "DATA"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:95
+#, no-c-format
+msgid ""
+"The form of this parameter is \"<geocolumn> from <tablename> "
+"using srid=<srid> using unique <primary key>\" where the column "
+"is the spatial column to be rendered to the map, the SRID is SRID used by "
+"the column and the primary key is the table primary key (or any other "
+"uniquely-valued column with an index)."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:99
+#, no-c-format
+msgid ""
+"You can omit the \"using srid\" and \"using unique\" clauses and MapServer "
+"will automatically determine the correct values if possible, but at the cost "
+"of running a few extra queries on the server for each map draw."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_app.xml:106
+#, no-c-format
+msgid "PROCESSING"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:109
+#, no-c-format
+msgid ""
+"Putting in a CLOSE_CONNECTION=DEFER if you have multiple layers reuses "
+"existing connections instead of closing them. This improves speed. Refer to "
+"for <ulink url=\"http://blog.cleverelephant.ca/2008/10/mapserverpostgis-"
+"performance-tips.html\">MapServer PostGIS Performance Tips</ulink> for a "
+"more detailed explanation."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_app.xml:115
+#, no-c-format
+msgid "FILTER"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:118
+#, no-c-format
+msgid ""
+"The filter must be a valid SQL string corresponding to the logic normally "
+"following the \"WHERE\" keyword in a SQL query. So, for example, to render "
+"only roads with 6 or more lanes, use a filter of \"num_lanes >= 6\"."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:128
+#, no-c-format
+msgid ""
+"In your spatial database, ensure you have spatial (GiST) indexes built for "
+"any the layers you will be drawing."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:131
+#, no-c-format
+msgid ""
+"CREATE INDEX [indexname] ON [tablename] USING GIST ( [geometrycolumn] );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:135
+#, no-c-format
+msgid ""
+"If you will be querying your layers using MapServer you will also need to "
+"use the \"using unique\" clause in your DATA statement."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:138
+#, no-c-format
+msgid ""
+"MapServer requires unique identifiers for each spatial record when doing "
+"queries, and the PostGIS module of MapServer uses the unique value you "
+"specify in order to provide these unique identifiers. Using the table "
+"primary key is the best practice."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:147
+#, no-c-format
+msgid "Frequently Asked Questions"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:152
+#, no-c-format
+msgid ""
+"When I use an <varname>EXPRESSION</varname> in my map file, the condition "
+"never returns as true, even though I know the values exist in my table."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:158
+#, no-c-format
+msgid ""
+"Unlike shape files, PostGIS field names have to be referenced in EXPRESSIONS "
+"using <emphasis>lower case</emphasis>."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:162
+#, no-c-format
+msgid "EXPRESSION ([numlanes] >= 6)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:168
+#, no-c-format
+msgid ""
+"The FILTER I use for my Shape files is not working for my PostGIS table of "
+"the same data."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:173
+#, no-c-format
+msgid ""
+"Unlike shape files, filters for PostGIS layers use SQL syntax (they are "
+"appended to the SQL statement the PostGIS connector generates for drawing "
+"layers in MapServer)."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:177
+#, no-c-format
+msgid "FILTER \"type = 'highway' and numlanes >= 4\""
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:183
+#, no-c-format
+msgid ""
+"My PostGIS layer draws much slower than my Shape file layer, is this normal?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:188
+#, no-c-format
+msgid ""
+"In general, the more features you are drawing into a given map, the more "
+"likely it is that PostGIS will be slower than Shape files. For maps with "
+"relatively few features (100s), PostGIS will often be faster. For maps with "
+"high feature density (1000s), PostGIS will always be slower."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:194
+#, no-c-format
+msgid ""
+"If you are finding substantial draw performance problems, it is possible "
+"that you have not built a spatial index on your table."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:198
+#, no-c-format
+msgid ""
+"postgis# CREATE INDEX geotable_gix ON geotable USING GIST ( geocolumn ); \n"
+"postgis# VACUUM ANALYZE;"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:204
+#, no-c-format
+msgid ""
+"My PostGIS layer draws fine, but queries are really slow. What is wrong?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:209
+#, no-c-format
+msgid ""
+"For queries to be fast, you must have a unique key for your spatial table "
+"and you must have an index on that unique key."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:213
+#, no-c-format
+msgid ""
+"You can specify what unique key for mapserver to use with the <varname>USING "
+"UNIQUE</varname> clause in your <varname>DATA</varname> line:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:217
+#, no-c-format
+msgid "DATA \"geom FROM geotable USING UNIQUE gid\""
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:224
+#, no-c-format
+msgid ""
+"Can I use \"geography\" columns (new in PostGIS 1.5) as a source for "
+"MapServer layers?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:229
+#, no-c-format
+msgid ""
+"Yes! MapServer understands geography columns as being the same as geometry "
+"columns, but always using an SRID of 4326. Just make sure to include a "
+"\"using srid=4326\" clause in your <varname>DATA</varname> statement. "
+"Everything else works exactly the same as with geometry."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:234
+#, no-c-format
+msgid "DATA \"geog FROM geogtable USING SRID=4326 USING UNIQUE gid\""
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:244
+#, no-c-format
+msgid "Advanced Usage"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:246
+#, no-c-format
+msgid ""
+"The <varname>USING</varname> pseudo-SQL clause is used to add some "
+"information to help mapserver understand the results of more complex "
+"queries. More specifically, when either a view or a subselect is used as the "
+"source table (the thing to the right of \"FROM\" in a <varname>DATA</"
+"varname> definition) it is more difficult for mapserver to automatically "
+"determine a unique identifier for each row and also the SRID for the table. "
+"The <varname>USING</varname> clause can provide mapserver with these two "
+"pieces of information as follows:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:255
+#, no-c-format
+msgid ""
+"DATA \"geom FROM (\n"
+" SELECT \n"
+" table1.geom AS geom, \n"
+" table1.gid AS gid, \n"
+" table2.data AS data \n"
+" FROM table1 \n"
+" LEFT JOIN table2 \n"
+" ON table1.id = table2.id\n"
+") AS new_table USING UNIQUE gid USING SRID=4326\""
+msgstr ""
+
+#. Tag: term
+#: using_postgis_app.xml:259
+#, no-c-format
+msgid "USING UNIQUE <uniqueid>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:262
+#, no-c-format
+msgid ""
+"MapServer requires a unique id for each row in order to identify the row "
+"when doing map queries. Normally it identifies the primary key from the "
+"system tables. However, views and subselects don't automatically have an "
+"known unique column. If you want to use MapServer's query functionality, you "
+"need to ensure your view or subselect includes a uniquely valued column, and "
+"declare it with <varname>USING UNIQUE</varname>. For example, you could "
+"explicitly select nee of the table's primary key values for this purpose, or "
+"any other column which is guaranteed to be unique for the result set."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:273
+#, no-c-format
+msgid ""
+"\"Querying a Map\" is the action of clicking on a map to ask for information "
+"about the map features in that location. Don't confuse \"map queries\" with "
+"the SQL query in a <varname>DATA</varname> definition."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_app.xml:282
+#, no-c-format
+msgid "USING SRID=<srid>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:285
+#, no-c-format
+msgid ""
+"PostGIS needs to know which spatial referencing system is being used by the "
+"geometries in order to return the correct data back to MapServer. Normally "
+"it is possible to find this information in the \"geometry_columns\" table in "
+"the PostGIS database, however, this is not possible for tables which are "
+"created on the fly such as subselects and views. So the <varname>USING "
+"SRID=</varname> option allows the correct SRID to be specified in the "
+"<varname>DATA</varname> definition."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:300
+#, no-c-format
+msgid "Examples"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:302
+#, no-c-format
+msgid ""
+"Lets start with a simple example and work our way up. Consider the following "
+"MapServer layer definition:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:305
+#, no-c-format
+msgid ""
+"LAYER \n"
+" CONNECTIONTYPE postgis \n"
+" NAME \"roads\"\n"
+" CONNECTION \"user=theuser password=thepass dbname=thedb host=theserver\" \n"
+" DATA \"geom from roads\" \n"
+" STATUS ON \n"
+" TYPE LINE \n"
+" CLASS \n"
+" STYLE\n"
+" COLOR 0 0 0 \n"
+" END\n"
+" END \n"
+"END"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:307
+#, no-c-format
+msgid ""
+"This layer will display all the road geometries in the roads table as black "
+"lines."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:310
+#, no-c-format
+msgid ""
+"Now lets say we want to show only the highways until we get zoomed in to at "
+"least a 1:100000 scale - the next two layers will achieve this effect:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:314
+#, no-c-format
+msgid ""
+"LAYER \n"
+" CONNECTIONTYPE postgis \n"
+" CONNECTION \"user=theuser password=thepass dbname=thedb host=theserver\" \n"
+" PROCESSING \"CLOSE_CONNECTION=DEFER\"\n"
+" DATA \"geom from roads\"\n"
+" MINSCALE 100000 \n"
+" STATUS ON \n"
+" TYPE LINE \n"
+" FILTER \"road_type = 'highway'\" \n"
+" CLASS \n"
+" COLOR 0 0 0 \n"
+" END \n"
+"END \n"
+"LAYER \n"
+" CONNECTIONTYPE postgis \n"
+" CONNECTION \"user=theuser password=thepass dbname=thedb host=theserver\"\n"
+" PROCESSING \"CLOSE_CONNECTION=DEFER\"\n"
+" DATA \"geom from roads\" \n"
+" MAXSCALE 100000 \n"
+" STATUS ON \n"
+" TYPE LINE\n"
+" CLASSITEM road_type \n"
+" CLASS \n"
+" EXPRESSION \"highway\" \n"
+" STYLE\n"
+" WIDTH 2 \n"
+" COLOR 255 0 0 \n"
+" END\n"
+" END \n"
+" CLASS \n"
+" STYLE\n"
+" COLOR 0 0 0 \n"
+" END\n"
+" END \n"
+"END"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:316
+#, no-c-format
+msgid ""
+"The first layer is used when the scale is greater than 1:100000, and "
+"displays only the roads of type \"highway\" as black lines. The "
+"<varname>FILTER</varname> option causes only roads of type \"highway\" to be "
+"displayed."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:321
+#, no-c-format
+msgid ""
+"The second layer is used when the scale is less than 1:100000, and will "
+"display highways as double-thick red lines, and other roads as regular black "
+"lines."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:325
+#, no-c-format
+msgid ""
+"So, we have done a couple of interesting things using only MapServer "
+"functionality, but our <varname>DATA</varname> SQL statement has remained "
+"simple. Suppose that the name of the road is stored in another table (for "
+"whatever reason) and we need to do a join to get it and label our roads."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:331
+#, no-c-format
+msgid ""
+"LAYER \n"
+" CONNECTIONTYPE postgis\n"
+" CONNECTION \"user=theuser password=thepass dbname=thedb host=theserver\" \n"
+" DATA \"geom FROM (SELECT roads.gid AS gid, roads.geom AS geom, \n"
+" road_names.name as name FROM roads LEFT JOIN road_names ON \n"
+" roads.road_name_id = road_names.road_name_id) \n"
+" AS named_roads USING UNIQUE gid USING SRID=4326\" \n"
+" MAXSCALE 20000 \n"
+" STATUS ON \n"
+" TYPE ANNOTATION \n"
+" LABELITEM name\n"
+" CLASS \n"
+" LABEL \n"
+" ANGLE auto \n"
+" SIZE 8 \n"
+" COLOR 0 192 0 \n"
+" TYPE truetype \n"
+" FONT arial\n"
+" END\n"
+" END \n"
+"END"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:333
+#, no-c-format
+msgid ""
+"This annotation layer adds green labels to all the roads when the scale gets "
+"down to 1:20000 or less. It also demonstrates how to use an SQL join in a "
+"<varname>DATA</varname> definition."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:340
+#, no-c-format
+msgid "Java Clients (JDBC)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:342
+#, no-c-format
+msgid ""
+"Java clients can access PostGIS \"geometry\" objects in the PostgreSQL "
+"database either directly as text representations or using the JDBC extension "
+"objects bundled with PostGIS. In order to use the extension objects, the "
+"\"postgis.jar\" file must be in your CLASSPATH along with the \"postgresql."
+"jar\" JDBC driver package."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:348
+#, no-c-format
+msgid ""
+"import java.sql.*; \n"
+"import java.util.*; \n"
+"import java.lang.*; \n"
+"import org.postgis.*; \n"
+"\n"
+"public class JavaGIS { \n"
+"\n"
+"public static void main(String[] args) { \n"
+"\n"
+" java.sql.Connection conn; \n"
+"\n"
+" try { \n"
+" /* \n"
+" * Load the JDBC driver and establish a connection. \n"
+" */\n"
+" Class.forName(\"org.postgresql.Driver\"); \n"
+" String url = \"jdbc:postgresql://localhost:5432/database\"; \n"
+" conn = DriverManager.getConnection(url, \"postgres\", \"\"); \n"
+" /* \n"
+" * Add the geometry types to the connection. Note that you \n"
+" * must cast the connection to the pgsql-specific connection \n"
+" * implementation before calling the addDataType() method. \n"
+" */\n"
+" ((org.postgresql.PGConnection)conn).addDataType(\"geometry\",Class."
+"forName(\"org.postgis.PGgeometry\"));\n"
+" ((org.postgresql.PGConnection)conn).addDataType(\"box3d\",Class."
+"forName(\"org.postgis.PGbox3d\"));\n"
+" /* \n"
+" * Create a statement and execute a select query. \n"
+" */ \n"
+" Statement s = conn.createStatement(); \n"
+" ResultSet r = s.executeQuery(\"select geom,id from geomtable\"); \n"
+" while( r.next() ) { \n"
+" /* \n"
+" * Retrieve the geometry as an object then cast it to the geometry "
+"type. \n"
+" * Print things out. \n"
+" */ \n"
+" PGgeometry geom = (PGgeometry)r.getObject(1); \n"
+" int id = r.getInt(2); \n"
+" System.out.println(\"Row \" + id + \":\");\n"
+" System.out.println(geom.toString()); \n"
+" } \n"
+" s.close(); \n"
+" conn.close(); \n"
+" } \n"
+"catch( Exception e ) { \n"
+" e.printStackTrace(); \n"
+" } \n"
+"} \n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:350
+#, no-c-format
+msgid ""
+"The \"PGgeometry\" object is a wrapper object which contains a specific "
+"topological geometry object (subclasses of the abstract class \"Geometry\") "
+"depending on the type: Point, LineString, Polygon, MultiPoint, "
+"MultiLineString, MultiPolygon."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_app.xml:355
+#, no-c-format
+msgid ""
+"PGgeometry geom = (PGgeometry)r.getObject(1); \n"
+"if( geom.getType() == Geometry.POLYGON ) { \n"
+" Polygon pl = (Polygon)geom.getGeometry(); \n"
+" for( int r = 0; r < pl.numRings(); r++) { \n"
+" LinearRing rng = pl.getRing(r); \n"
+" System.out.println(\"Ring: \" + r); \n"
+" for( int p = 0; p < rng.numPoints(); p++ ) { \n"
+" Point pt = rng.getPoint(p); \n"
+" System.out.println(\"Point: \" + p);\n"
+" System.out.println(pt.toString()); \n"
+" } \n"
+" } \n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:357
+#, no-c-format
+msgid ""
+"The JavaDoc for the extension objects provides a reference for the various "
+"data accessor functions in the geometric objects."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:362
+#, no-c-format
+msgid "C Clients (libpq)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_app.xml:364 using_postgis_app.xml:369
+#: using_postgis_app.xml:375
+#, no-c-format
+msgid "<para>...</para>"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:367
+#, no-c-format
+msgid "Text Cursors"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_app.xml:373
+#, no-c-format
+msgid "Binary Cursors"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2013-11-27 16:31+0000\n"
+"Last-Translator: Sandro Santilli <strk@keybit.net>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: using_postgis_dataman.xml:3
+#, no-c-format
+msgid "Using PostGIS: Data Management and Queries"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:6
+#, no-c-format
+msgid "GIS Objects"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:8
+#, no-c-format
+msgid ""
+"The GIS objects supported by PostGIS are a superset of the \"Simple Features"
+"\" defined by the OpenGIS Consortium (OGC). As of version 0.9, PostGIS "
+"supports all the objects and functions specified in the OGC \"Simple "
+"Features for SQL\" specification."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:13
+#, no-c-format
+msgid ""
+"PostGIS extends the standard with support for 3DZ,3DM and 4D coordinates."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:17
+#, no-c-format
+msgid "OpenGIS WKB and WKT"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:19
+#, no-c-format
+msgid ""
+"The OpenGIS specification defines two standard ways of expressing spatial "
+"objects: the Well-Known Text (WKT) form and the Well-Known Binary (WKB) "
+"form. Both WKT and WKB include information about the type of the object and "
+"the coordinates which form the object."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:24
+#, no-c-format
+msgid ""
+"Examples of the text representations (WKT) of the spatial objects of the "
+"features are as follows:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:29
+#, no-c-format
+msgid "POINT(0 0)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:33
+#, no-c-format
+msgid "LINESTRING(0 0,1 1,1 2)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:37
+#, no-c-format
+msgid "POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:41
+#, no-c-format
+msgid "MULTIPOINT(0 0,1 2)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:45
+#, no-c-format
+msgid "MULTILINESTRING((0 0,1 1,1 2),(2 3,3 2,5 4))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:49
+#, no-c-format
+msgid ""
+"MULTIPOLYGON(((0 0,4 0,4 4,0 4,0 0),(1 1,2 1,2 2,1 2,1 1)), ((-1 -1,-1 -2,-2 "
+"-2,-2 -1,-1 -1)))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:54
+#, no-c-format
+msgid "GEOMETRYCOLLECTION(POINT(2 3),LINESTRING(2 3,3 4))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:58
+#, no-c-format
+msgid ""
+"The OpenGIS specification also requires that the internal storage format of "
+"spatial objects include a spatial referencing system identifier (SRID). The "
+"SRID is required when creating spatial objects for insertion into the "
+"database."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:63 using_postgis_dataman.xml:151
+#, no-c-format
+msgid ""
+"Input/Output of these formats are available using the following interfaces:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:66
+#, no-c-format
+msgid ""
+"bytea WKB = ST_AsBinary(geometry);\n"
+"text WKT = ST_AsText(geometry);\n"
+"geometry = ST_GeomFromWKB(bytea WKB, SRID);\n"
+"geometry = ST_GeometryFromText(text WKT, SRID);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:68
+#, no-c-format
+msgid ""
+"For example, a valid insert statement to create and insert an OGC spatial "
+"object would be:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:71
+#, no-c-format
+msgid ""
+"INSERT INTO geotable ( the_geom, the_name )\n"
+" VALUES ( ST_GeomFromText('POINT(-126.4 45.32)', 312), 'A Place');"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:75
+#, no-c-format
+msgid "PostGIS EWKB, EWKT and Canonical Forms"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:77
+#, no-c-format
+msgid ""
+"OGC formats only support 2d geometries, and the associated SRID is *never* "
+"embedded in the input/output representations."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:80
+#, no-c-format
+msgid ""
+"PostGIS extended formats are currently superset of OGC one (every valid WKB/"
+"WKT is a valid EWKB/EWKT) but this might vary in the future, specifically if "
+"OGC comes out with a new format conflicting with our extensions. Thus you "
+"SHOULD NOT rely on this feature!"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:85
+#, no-c-format
+msgid ""
+"PostGIS EWKB/EWKT add 3dm,3dz,4d coordinates support and embedded SRID "
+"information."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:88
+#, no-c-format
+msgid ""
+"Examples of the text representations (EWKT) of the extended spatial objects "
+"of the features are as follows. The * ones are new in this version of "
+"PostGIS:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:93
+#, no-c-format
+msgid "POINT(0 0 0) -- XYZ"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:97
+#, no-c-format
+msgid "SRID=32632;POINT(0 0) -- XY with SRID"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:101
+#, no-c-format
+msgid "POINTM(0 0 0) -- XYM"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:105
+#, no-c-format
+msgid "POINT(0 0 0 0) -- XYZM"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:109
+#, no-c-format
+msgid "SRID=4326;MULTIPOINTM(0 0 0,1 2 1) -- XYM with SRID"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:113
+#, no-c-format
+msgid "MULTILINESTRING((0 0 0,1 1 0,1 2 1),(2 3 1,3 2 1,5 4 1))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:118
+#, no-c-format
+msgid ""
+"POLYGON((0 0 0,4 0 0,4 4 0,0 4 0,0 0 0),(1 1 0,2 1 0,2 2 0,1 2 0,1 1 0))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:123
+#, no-c-format
+msgid ""
+"MULTIPOLYGON(((0 0 0,4 0 0,4 4 0,0 4 0,0 0 0),(1 1 0,2 1 0,2 2 0,1 2 0,1 1 "
+"0)),((-1 -1 0,-1 -2 0,-2 -2 0,-2 -1 0,-1 -1 0)))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:128
+#, no-c-format
+msgid "GEOMETRYCOLLECTIONM( POINTM(2 3 9), LINESTRINGM(2 3 4, 3 4 5) )"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:132
+#, no-c-format
+msgid "MULTICURVE( (0 0, 5 5), CIRCULARSTRING(4 0, 4 4, 8 4) )"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:136
+#, no-c-format
+msgid ""
+"POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), ((0 0 0, 0 1 0, 1 "
+"1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)), ((1 1 0, 1 1 1, "
+"1 0 1, 1 0 0, 1 1 0)), ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 "
+"1, 1 1 1, 0 1 1, 0 0 1)) )"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:142
+#, no-c-format
+msgid "TRIANGLE ((0 0, 0 9, 9 0, 0 0))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:146
+#, no-c-format
+msgid "TIN( ((0 0 0, 0 0 1, 0 1 0, 0 0 0)), ((0 0 0, 0 1 0, 1 1 0, 0 0 0)) )"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:154
+#, no-c-format
+msgid ""
+"bytea EWKB = ST_AsEWKB(geometry);\n"
+"text EWKT = ST_AsEWKT(geometry);\n"
+"geometry = ST_GeomFromEWKB(bytea EWKB);\n"
+"geometry = ST_GeomFromEWKT(text EWKT);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:156
+#, no-c-format
+msgid ""
+"For example, a valid insert statement to create and insert a PostGIS spatial "
+"object would be:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:159
+#, no-c-format
+msgid ""
+"INSERT INTO geotable ( the_geom, the_name )\n"
+" VALUES ( ST_GeomFromEWKT('SRID=312;POINTM(-126.4 45.32 15)'), 'A Place' )"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:161
+#, no-c-format
+msgid ""
+"The \"canonical forms\" of a PostgreSQL type are the representations you get "
+"with a simple query (without any function call) and the one which is "
+"guaranteed to be accepted with a simple insert, update or copy. For the "
+"postgis 'geometry' type these are:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:164
+#, no-c-format
+msgid ""
+"- Output\n"
+" - binary: EWKB\n"
+" ascii: HEXEWKB (EWKB in hex form)\n"
+"- Input\n"
+" - binary: EWKB\n"
+" ascii: HEXEWKB|EWKT"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:166
+#, no-c-format
+msgid ""
+"For example this statement reads EWKT and returns HEXEWKB in the process of "
+"canonical ascii input/output:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:169
+#, no-c-format
+msgid ""
+"=# SELECT 'SRID=4;POINT(0 0)'::geometry;\n"
+"\n"
+"geometry\n"
+"----------------------------------------------------\n"
+"01010000200400000000000000000000000000000000000000\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:172
+#, no-c-format
+msgid "SQL-MM Part 3"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:174
+#, no-c-format
+msgid ""
+"The SQL Multimedia Applications Spatial specification extends the simple "
+"features for SQL spec by defining a number of circularly interpolated curves."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:178
+#, no-c-format
+msgid ""
+"The SQL-MM definitions include 3dm, 3dz and 4d coordinates, but do not allow "
+"the embedding of SRID information."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:181
+#, no-c-format
+msgid ""
+"The well-known text extensions are not yet fully supported. Examples of some "
+"simple curved geometries are shown below:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:186
+#, no-c-format
+msgid "CIRCULARSTRING(0 0, 1 1, 1 0)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:187
+#, no-c-format
+msgid "CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:188
+#, no-c-format
+msgid ""
+"The CIRCULARSTRING is the basic curve type, similar to a LINESTRING in the "
+"linear world. A single segment required three points, the start and end "
+"points (first and third) and any other point on the arc. The exception to "
+"this is for a closed circle, where the start and end points are the same. In "
+"this case the second point MUST be the center of the arc, ie the opposite "
+"side of the circle. To chain arcs together, the last point of the previous "
+"arc becomes the first point of the next arc, just like in LINESTRING. This "
+"means that a valid circular string must have an odd number of points greated "
+"than 1."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:201
+#, no-c-format
+msgid "COMPOUNDCURVE(CIRCULARSTRING(0 0, 1 1, 1 0),(1 0, 0 1))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:202
+#, no-c-format
+msgid ""
+"A compound curve is a single, continuous curve that has both curved "
+"(circular) segments and linear segments. That means that in addition to "
+"having well-formed components, the end point of every component (except the "
+"last) must be coincident with the start point of the following component."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:210
+#, no-c-format
+msgid ""
+"CURVEPOLYGON(CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0),(1 1, 3 3, 3 1, 1 1))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:212
+#, no-c-format
+msgid ""
+"Example compound curve in a curve polygon: "
+"CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(0 0,2 0, 2 1, 2 3, 4 3),(4 3, 4 5, "
+"1 4, 0 0)), CIRCULARSTRING(1.7 1, 1.4 0.4, 1.6 0.4, 1.6 0.5, 1.7 1) )"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:216
+#, no-c-format
+msgid ""
+"A CURVEPOLYGON is just like a polygon, with an outer ring and zero or more "
+"inner rings. The difference is that a ring can take the form of a circular "
+"string, linear string or compound string."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:220
+#, no-c-format
+msgid "As of PostGIS 1.4 PostGIS supports compound curves in a curve polygon."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:224
+#, no-c-format
+msgid "MULTICURVE((0 0, 5 5),CIRCULARSTRING(4 0, 4 4, 8 4))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:225
+#, no-c-format
+msgid ""
+"The MULTICURVE is a collection of curves, which can include linear strings, "
+"circular strings or compound strings."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:230
+#, no-c-format
+msgid ""
+"MULTISURFACE(CURVEPOLYGON(CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0),(1 1, 3 3, "
+"3 1, 1 1)),((10 10, 14 12, 11 10, 10 10),(11 11, 11.5 11, 11 11.5, 11 11)))"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:233
+#, no-c-format
+msgid ""
+"This is a collection of surfaces, which can be (linear) polygons or curve "
+"polygons."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:239
+#, no-c-format
+msgid ""
+"PostGIS prior to 1.4 does not support compound curves in a curve polygon, "
+"but PostGIS 1.4 and above do support the use of Compound Curves in a Curve "
+"Polygon."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:245
+#, no-c-format
+msgid ""
+"All floating point comparisons within the SQL-MM implementation are "
+"performed to a specified tolerance, currently 1E-8."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:251
+#, no-c-format
+msgid "PostGIS Geography Type"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:253
+#, no-c-format
+msgid ""
+"The geography type provides native support for spatial features represented "
+"on \"geographic\" coordinates (sometimes called \"geodetic\" coordinates, or "
+"\"lat/lon\", or \"lon/lat\"). Geographic coordinates are spherical "
+"coordinates expressed in angular units (degrees)."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:255
+#, no-c-format
+msgid ""
+"The basis for the PostGIS geometry type is a plane. The shortest path "
+"between two points on the plane is a straight line. That means calculations "
+"on geometries (areas, distances, lengths, intersections, etc) can be "
+"calculated using cartesian mathematics and straight line vectors."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:257
+#, no-c-format
+msgid ""
+"The basis for the PostGIS geographic type is a sphere. The shortest path "
+"between two points on the sphere is a great circle arc. That means that "
+"calculations on geographies (areas, distances, lengths, intersections, etc) "
+"must be calculated on the sphere, using more complicated mathematics. For "
+"more accurate measurements, the calculations must take the actual spheroidal "
+"shape of the world into account, and the mathematics becomes very "
+"complicated indeed."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:259
+#, no-c-format
+msgid ""
+"Because the underlying mathematics is much more complicated, there are fewer "
+"functions defined for the geography type than for the geometry type. Over "
+"time, as new algorithms are added, the capabilities of the geography type "
+"will expand."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:262
+#, no-c-format
+msgid ""
+"One restriction is that it only supports WGS 84 long lat (SRID:4326). It "
+"uses a new data type called geography. None of the GEOS functions support "
+"this new type. As a workaround one can convert back and forth between "
+"geometry and geography types."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:266
+#, no-c-format
+msgid ""
+"The new geography type uses the PostgreSQL 8.3+ typmod definition format so "
+"that a table with a geography field can be added in a single step. All the "
+"standard OGC formats except for curves are supported."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:270
+#, no-c-format
+msgid "Geography Basics"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:271
+#, no-c-format
+msgid ""
+"The geography type only supports the simplest of simple features. Standard "
+"geometry type data will autocast to geography if it is of SRID 4326. You can "
+"also use the EWKT and EWKB conventions to insert data."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:276
+#, no-c-format
+msgid "POINT: Creating a table with 2d point geometry:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:277
+#, no-c-format
+msgid ""
+"CREATE TABLE testgeog(gid serial PRIMARY KEY, the_geog "
+"geography(POINT,4326) );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:278
+#, no-c-format
+msgid "Creating a table with z coordinate point"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:279
+#, no-c-format
+msgid ""
+"CREATE TABLE testgeog(gid serial PRIMARY KEY, the_geog "
+"geography(POINTZ,4326) );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:282
+#, no-c-format
+msgid "LINESTRING"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:285
+#, no-c-format
+msgid "POLYGON"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:288
+#, no-c-format
+msgid "MULTIPOINT"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:291
+#, no-c-format
+msgid "MULTILINESTRING"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:294
+#, no-c-format
+msgid "MULTIPOLYGON"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:297
+#, no-c-format
+msgid "GEOMETRYCOLLECTION"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:301
+#, no-c-format
+msgid ""
+"The new geography fields don't get registered in the "
+"<varname>geometry_columns</varname>. They get registered in a new view "
+"called geography_columns which is a view against the system catalogs so is "
+"always automatically kept up to date without need for an AddGeom... like "
+"function."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:305
+#, no-c-format
+msgid ""
+"Now, check the \"geography_columns\" view and see that your table is listed."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:307
+#, no-c-format
+msgid ""
+"You can create a new table with a GEOGRAPHY column using the CREATE TABLE "
+"syntax. Unlike GEOMETRY, there is no need to run a separate "
+"AddGeometryColumns() process to register the column in metadata."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:311
+#, no-c-format
+msgid ""
+"CREATE TABLE global_points ( \n"
+" id SERIAL PRIMARY KEY,\n"
+" name VARCHAR(64),\n"
+" location GEOGRAPHY(POINT,4326)\n"
+" );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:314
+#, no-c-format
+msgid ""
+"Note that the location column has type GEOGRAPHY and that geography type "
+"supports two optional modifier: a type modifier that restricts the kind of "
+"shapes and dimensions allowed in the column; an SRID modifier that restricts "
+"the coordinate reference identifier to a particular number."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:315
+#, no-c-format
+msgid ""
+"Allowable values for the type modifier are: POINT, LINESTRING, POLYGON, "
+"MULTIPOINT, MULTILINESTRING, MULTIPOLYGON. The modifier also supports "
+"dimensionality restrictions through suffixes: Z, M and ZM. So, for example a "
+"modifier of 'LINESTRINGM' would only allow line strings with three "
+"dimensions in, and would treat the third dimension as a measure. Similarly, "
+"'POINTZM' would expect four dimensional data."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:317
+#, no-c-format
+msgid ""
+"The SRID modifier is currently of limited use: only 4326 (WGS84) is allowed "
+"as a value. If you do not specify an SRID, the a value 0 (undefined "
+"spheroid) will be used, and all calculations will proceed using WGS84 "
+"anyways."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:318
+#, no-c-format
+msgid ""
+"In the future, alternate SRIDs will allow calculations on spheroids other "
+"than WGS84."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:319
+#, no-c-format
+msgid ""
+"Once you have created your table, you can see it in the GEOGRAPHY_COLUMNS "
+"table:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:320
+#, no-c-format
+msgid ""
+"-- See the contents of the metadata view\n"
+"SELECT * FROM geography_columns;"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:322
+#, no-c-format
+msgid ""
+"You can insert data into the table the same as you would if it was using a "
+"GEOMETRY column:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:324
+#, no-c-format
+msgid ""
+"-- Add some data into the test table\n"
+"INSERT INTO global_points (name, location) VALUES ('Town', "
+"ST_GeographyFromText('SRID=4326;POINT(-110 30)') );\n"
+"INSERT INTO global_points (name, location) VALUES ('Forest', "
+"ST_GeographyFromText('SRID=4326;POINT(-109 29)') );\n"
+"INSERT INTO global_points (name, location) VALUES ('London', "
+"ST_GeographyFromText('SRID=4326;POINT(0 49)') );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:326
+#, no-c-format
+msgid ""
+"Creating an index works the same as GEOMETRY. PostGIS will note that the "
+"column type is GEOGRAPHY and create an appropriate sphere-based index "
+"instead of the usual planar index used for GEOMETRY."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:329
+#, no-c-format
+msgid ""
+"-- Index the test table with a spherical index\n"
+" CREATE INDEX global_points_gix ON global_points USING GIST ( location );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:332
+#, no-c-format
+msgid ""
+"Query and measurement functions use units of meters. So distance parameters "
+"should be expressed in meters, and return values should be expected in "
+"meters (or square meters for areas)."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:334
+#, no-c-format
+msgid ""
+"-- Show a distance query and note, London is outside the 1000km tolerance\n"
+" SELECT name FROM global_points WHERE ST_DWithin(location, "
+"ST_GeographyFromText('SRID=4326;POINT(-110 29)'), 1000000);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:337
+#, no-c-format
+msgid ""
+"You can see the power of GEOGRAPHY in action by calculating the how close a "
+"plane flying from Seattle to London (LINESTRING(-122.33 47.606, 0.0 51.5)) "
+"comes to Reykjavik (POINT(-21.96 64.15))."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:339
+#, no-c-format
+msgid ""
+"-- Distance calculation using GEOGRAPHY (122.2km)\n"
+" SELECT ST_Distance('LINESTRING(-122.33 47.606, 0.0 51.5)'::geography, "
+"'POINT(-21.96 64.15)':: geography);"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:342
+#, no-c-format
+msgid ""
+"-- Distance calculation using GEOMETRY (13.3 \"degrees\")\n"
+" SELECT ST_Distance('LINESTRING(-122.33 47.606, 0.0 51.5)'::geometry, "
+"'POINT(-21.96 64.15)':: geometry);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:345
+#, no-c-format
+msgid ""
+"The GEOGRAPHY type calculates the true shortest distance over the sphere "
+"between Reykjavik and the great circle flight path between Seattle and "
+"London."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:347
+#, no-c-format
+msgid ""
+"<ulink url=\"http://gc.kls2.com/cgi-bin/gc?PATH=SEA-LHR\">Great Circle "
+"mapper</ulink> The GEOMETRY type calculates a meaningless cartesian distance "
+"between Reykjavik and the straight line path from Seattle to London plotted "
+"on a flat map of the world. The nominal units of the result might be called "
+"\"degrees\", but the result doesn't correspond to any true angular "
+"difference between the points, so even calling them \"degrees\" is "
+"inaccurate."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:351
+#, no-c-format
+msgid "When to use Geography Data type over Geometry data type"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:352
+#, no-c-format
+msgid ""
+"The new GEOGRAPHY type allows you to store data in longitude/latitude "
+"coordinates, but at a cost: there are fewer functions defined on GEOGRAPHY "
+"than there are on GEOMETRY; those functions that are defined take more CPU "
+"time to execute."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:353
+#, no-c-format
+msgid ""
+"The type you choose should be conditioned on the expected working area of "
+"the application you are building. Will your data span the globe or a large "
+"continental area, or is it local to a state, county or municipality?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:355
+#, no-c-format
+msgid ""
+"If your data is contained in a small area, you might find that choosing an "
+"appropriate projection and using GEOMETRY is the best solution, in terms of "
+"performance and functionality available."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:356
+#, no-c-format
+msgid ""
+"If your data is global or covers a continental region, you may find that "
+"GEOGRAPHY allows you to build a system without having to worry about "
+"projection details. You store your data in longitude/latitude, and use the "
+"functions that have been defined on GEOGRAPHY."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:358
+#, no-c-format
+msgid ""
+"If you don't understand projections, and you don't want to learn about them, "
+"and you're prepared to accept the limitations in functionality available in "
+"GEOGRAPHY, then it might be easier for you to use GEOGRAPHY than GEOMETRY. "
+"Simply load your data up as longitude/latitude and go from there."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:361
+#, no-c-format
+msgid ""
+"Refer to <xref linkend=\"PostGIS_TypeFunctionMatrix\"/> for compare between "
+"what is supported for Geography vs. Geometry. For a brief listing and "
+"description of Geography functions, refer to <xref linkend="
+"\"PostGIS_GeographyFunctions\"/>"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:367
+#, no-c-format
+msgid "Geography Advanced FAQ"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:371
+#, no-c-format
+msgid "Do you calculate on the sphere or the spheroid?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:375
+#, no-c-format
+msgid ""
+"By default, all distance and area calculations are done on the spheroid. You "
+"should find that the results of calculations in local areas match up will "
+"with local planar results in good local projections. Over larger areas, the "
+"spheroidal calculations will be more accurate than any calculation done on a "
+"projected plane."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:378
+#, no-c-format
+msgid ""
+"All the geography functions have the option of using a sphere calculation, "
+"by setting a final boolean parameter to 'FALSE'. This will somewhat speed up "
+"calculations, particularly for cases where the geometries are very simple."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:384
+#, no-c-format
+msgid "What about the date-line and the poles?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:388
+#, no-c-format
+msgid ""
+"All the calculations have no conception of date-line or poles, the "
+"coordinates are spherical (longitude/latitude) so a shape that crosses the "
+"dateline is, from a calculation point of view, no different from any other "
+"shape."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:396
+#, no-c-format
+msgid "What is the longest arc you can process?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:400
+#, no-c-format
+msgid ""
+"We use great circle arcs as the \"interpolation line\" between two points. "
+"That means any two points are actually joined up two ways, depending on "
+"which direction you travel along the great circle. All our code assumes that "
+"the points are joined by the *shorter* of the two paths along the great "
+"circle. As a consequence, shapes that have arcs of more than 180 degrees "
+"will not be correctly modelled."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:407
+#, no-c-format
+msgid ""
+"Why is it so slow to calculate the area of Europe / Russia / insert big "
+"geographic region here ?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:411
+#, no-c-format
+msgid ""
+"Because the polygon is so darned huge! Big areas are bad for two reasons: "
+"their bounds are huge, so the index tends to pull the feature no matter what "
+"query you run; the number of vertices is huge, and tests (distance, "
+"containment) have to traverse the vertex list at least once and sometimes N "
+"times (with N being the number of vertices in the other candidate feature)."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:416
+#, no-c-format
+msgid ""
+"As with GEOMETRY, we recommend that when you have very large polygons, but "
+"are doing queries in small areas, you \"denormalize\" your geometric data "
+"into smaller chunks so that the index can effectively subquery parts of the "
+"object and so queries don't have to pull out the whole object every time. "
+"Just because you *can* store all of Europe in one polygon doesn't mean you "
+"*should*."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:425
+#, no-c-format
+msgid "Using OpenGIS Standards"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:427
+#, no-c-format
+msgid ""
+"The OpenGIS \"Simple Features Specification for SQL\" defines standard GIS "
+"object types, the functions required to manipulate them, and a set of meta-"
+"data tables. In order to ensure that meta-data remain consistent, operations "
+"such as creating and removing a spatial column are carried out through "
+"special procedures defined by OpenGIS."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:433
+#, no-c-format
+msgid ""
+"There are two OpenGIS meta-data tables: <varname>SPATIAL_REF_SYS</varname> "
+"and <varname>GEOMETRY_COLUMNS</varname>. The <varname>SPATIAL_REF_SYS</"
+"varname> table holds the numeric IDs and textual descriptions of coordinate "
+"systems used in the spatial database."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:440
+#, no-c-format
+msgid "The SPATIAL_REF_SYS Table and Spatial Reference Systems"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:442
+#, no-c-format
+msgid ""
+"The spatial_ref_sys table is a PostGIS included and OGC compliant database "
+"table that lists over 3000 known <ulink url=\"http://www.sharpgis.net/"
+"post/2007/05/Spatial-references2c-coordinate-systems2c-projections2c-"
+"datums2c-ellipsoids-e28093-confusing.aspx\">spatial reference systems</"
+"ulink> and details needed to transform/reproject between them."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:446
+#, no-c-format
+msgid ""
+"Although the PostGIS spatial_ref_sys table contains over 3000 of the more "
+"commonly used spatial reference system definitions that can be handled by "
+"the proj library, it does not contain all known to man and you can even "
+"define your own custom projection if you are familiar with proj4 constructs. "
+"Keep in mind that most spatial reference systems are regional and have no "
+"meaning when used outside of the bounds they were intended for."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:449
+#, no-c-format
+msgid ""
+"An excellent resource for finding spatial reference systems not defined in "
+"the core set is <ulink url=\"http://spatialreference.org/\">http://"
+"spatialreference.org/</ulink>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:451
+#, no-c-format
+msgid ""
+"Some of the more commonly used spatial reference systems are: <ulink url="
+"\"http://spatialreference.org/ref/epsg/4326/\">4326 - WGS 84 Long Lat</"
+"ulink>, <ulink url=\"http://spatialreference.org/ref/epsg/4269/\">4269 - NAD "
+"83 Long Lat</ulink>, <ulink url=\"http://spatialreference.org/ref/epsg/3395/"
+"\">3395 - WGS 84 World Mercator</ulink>, <ulink url=\"http://"
+"spatialreference.org/ref/epsg/2163/\">2163 - US National Atlas Equal Area</"
+"ulink>, Spatial reference systems for each NAD 83, WGS 84 UTM zone - UTM "
+"zones are one of the most ideal for measurement, but only cover 6-degree "
+"regions."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:457
+#, no-c-format
+msgid ""
+"Various US state plane spatial reference systems (meter or feet based) - "
+"usually one or 2 exists per US state. Most of the meter ones are in the core "
+"set, but many of the feet based ones or ESRI created ones you will need to "
+"pull from <ulink url=\"http://spatialreference.org\">spatialreference.org</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:461
+#, no-c-format
+msgid ""
+"For details on determining which UTM zone to use for your area of interest, "
+"check out the <ulink url=\"http://trac.osgeo.org/postgis/wiki/"
+"UsersWikiplpgsqlfunctionsDistance\">utmzone PostGIS plpgsql helper function</"
+"ulink>."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:465
+#, no-c-format
+msgid "The <varname>SPATIAL_REF_SYS</varname> table definition is as follows:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:468
+#, no-c-format
+msgid ""
+"CREATE TABLE spatial_ref_sys (\n"
+" srid INTEGER NOT NULL PRIMARY KEY,\n"
+" auth_name VARCHAR(256),\n"
+" auth_srid INTEGER,\n"
+" srtext VARCHAR(2048),\n"
+" proj4text VARCHAR(2048)\n"
+")"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:470
+#, no-c-format
+msgid "The <varname>SPATIAL_REF_SYS</varname> columns are as follows:"
+msgstr ""
+
+#. Tag: ulink
+#: using_postgis_dataman.xml:475
+#, no-c-format
+msgid "<ulink url=\"http://en.wikipedia.org/wiki/SRID\">SRID</ulink>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:478
+#, no-c-format
+msgid ""
+"An integer value that uniquely identifies the Spatial Referencing System "
+"(SRS) within the database."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:484
+#, no-c-format
+msgid "AUTH_NAME"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:487
+#, no-c-format
+msgid ""
+"The name of the standard or standards body that is being cited for this "
+"reference system. For example, \"EPSG\" would be a valid <varname>AUTH_NAME</"
+"varname>."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:494
+#, no-c-format
+msgid "AUTH_SRID"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:497
+#, no-c-format
+msgid ""
+"The ID of the Spatial Reference System as defined by the Authority cited in "
+"the <varname>AUTH_NAME</varname>. In the case of EPSG, this is where the "
+"EPSG projection code would go."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:504
+#, no-c-format
+msgid "SRTEXT"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:507
+#, no-c-format
+msgid ""
+"The Well-Known Text representation of the Spatial Reference System. An "
+"example of a WKT SRS representation is:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:510
+#, no-c-format
+msgid ""
+"PROJCS[\"NAD83 / UTM Zone 10N\",\n"
+" GEOGCS[\"NAD83\",\n"
+" DATUM[\"North_American_Datum_1983\",\n"
+" SPHEROID[\"GRS 1980\",6378137,298.257222101]\n"
+" ],\n"
+" PRIMEM[\"Greenwich\",0],\n"
+" UNIT[\"degree\",0.0174532925199433]\n"
+" ],\n"
+" PROJECTION[\"Transverse_Mercator\"],\n"
+" PARAMETER[\"latitude_of_origin\",0],\n"
+" PARAMETER[\"central_meridian\",-123],\n"
+" PARAMETER[\"scale_factor\",0.9996],\n"
+" PARAMETER[\"false_easting\",500000],\n"
+" PARAMETER[\"false_northing\",0],\n"
+" UNIT[\"metre\",1]\n"
+"]"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:512
+#, no-c-format
+msgid ""
+"For a listing of EPSG projection codes and their corresponding WKT "
+"representations, see <ulink url=\"http://www.opengeospatial.org/\">http://"
+"www.opengeospatial.org/</ulink>. For a discussion of WKT in general, see the "
+"OpenGIS \"Coordinate Transformation Services Implementation Specification\" "
+"at <ulink url=\"http://www.opengeospatial.org/standards\">http://www."
+"opengeospatial.org/standards</ulink>. For information on the European "
+"Petroleum Survey Group (EPSG) and their database of spatial reference "
+"systems, see <ulink url=\"http://www.epsg.org/\">http://www.epsg.org</ulink>."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:525
+#, no-c-format
+msgid "PROJ4TEXT"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:528
+#, no-c-format
+msgid ""
+"PostGIS uses the Proj4 library to provide coordinate transformation "
+"capabilities. The <varname>PROJ4TEXT</varname> column contains the Proj4 "
+"coordinate definition string for a particular SRID. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:533
+#, no-c-format
+msgid "+proj=utm +zone=10 +ellps=clrk66 +datum=NAD27 +units=m"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:535
+#, no-c-format
+msgid ""
+"For more information about, see the Proj4 web site at <ulink url=\"http://"
+"trac.osgeo.org/proj/\">http://trac.osgeo.org/proj/</ulink>. The "
+"<filename>spatial_ref_sys.sql</filename> file contains both <varname>SRTEXT</"
+"varname> and <varname>PROJ4TEXT</varname> definitions for all EPSG "
+"projections."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:546
+#, no-c-format
+msgid "The GEOMETRY_COLUMNS VIEW"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:548
+#, no-c-format
+msgid ""
+"In versions of PostGIS prior to 2.0.0, geometry_columns was a table that "
+"could be directly edited, and sometimes got out of synch with the actual "
+"definition of the geometry columns. In PostGIS 2.0.0, "
+"<varname>GEOMETRY_COLUMNS</varname> became a view with the same front-facing "
+"structure as prior versions, but reading from database system catalogs Its "
+"structure is as follows:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:552
+#, no-c-format
+msgid "\\d geometry_columns"
+msgstr ""
+
+#. Tag: screen
+#: using_postgis_dataman.xml:553
+#, no-c-format
+msgid ""
+"View \"public.geometry_columns\"\n"
+" Column | Type | Modifiers\n"
+"-------------------+------------------------+-----------\n"
+" f_table_catalog | character varying(256) |\n"
+" f_table_schema | character varying(256) |\n"
+" f_table_name | character varying(256) |\n"
+" f_geometry_column | character varying(256) |\n"
+" coord_dimension | integer |\n"
+" srid | integer |\n"
+" type | character varying(30) |"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:555
+#, no-c-format
+msgid "The column meanings have not changed from prior versions and are:"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:559
+#, no-c-format
+msgid "F_TABLE_CATALOG, F_TABLE_SCHEMA, F_TABLE_NAME"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:562
+#, no-c-format
+msgid ""
+"The fully qualified name of the feature table containing the geometry "
+"column. Note that the terms \"catalog\" and \"schema\" are Oracle-ish. There "
+"is not PostgreSQL analogue of \"catalog\" so that column is left blank -- "
+"for \"schema\" the PostgreSQL schema name is used (<varname>public</varname> "
+"is the default)."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:571
+#, no-c-format
+msgid "F_GEOMETRY_COLUMN"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:574
+#, no-c-format
+msgid "The name of the geometry column in the feature table."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:579
+#, no-c-format
+msgid "COORD_DIMENSION"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:582
+#, no-c-format
+msgid "The spatial dimension (2, 3 or 4 dimensional) of the column."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:588
+#, no-c-format
+msgid "<term>SRID</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:591
+#, no-c-format
+msgid ""
+"The ID of the spatial reference system used for the coordinate geometry in "
+"this table. It is a foreign key reference to the <varname>SPATIAL_REF_SYS</"
+"varname>."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:598
+#, no-c-format
+msgid "TYPE"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:601
+#, no-c-format
+msgid ""
+"The type of the spatial object. To restrict the spatial column to a single "
+"type, use one of: POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, "
+"MULTIPOLYGON, GEOMETRYCOLLECTION or corresponding XYM versions POINTM, "
+"LINESTRINGM, POLYGONM, MULTIPOINTM, MULTILINESTRINGM, MULTIPOLYGONM, "
+"GEOMETRYCOLLECTIONM. For heterogeneous (mixed-type) collections, you can use "
+"\"GEOMETRY\" as the type."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:610
+#, no-c-format
+msgid ""
+"This attribute is (probably) not part of the OpenGIS specification, but is "
+"required for ensuring type homogeneity."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:620
+#, no-c-format
+msgid "Creating a Spatial Table"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:622
+#, no-c-format
+msgid ""
+"Creating a table with spatial data, can be done in one step. As shown in the "
+"following example which creates a roads table with a 2D linestring geometry "
+"column in WGS84 long lat"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:624
+#, no-c-format
+msgid ""
+"CREATE TABLE ROADS ( ID int4\n"
+" , ROAD_NAME varchar(25), geom geometry(LINESTRING,4326) );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:626
+#, no-c-format
+msgid ""
+"We can add additional columns using standard ALTER TABLE command as we do in "
+"this next example where we add a 3-D linestring."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:627
+#, no-c-format
+msgid "ALTER TABLE roads ADD COLUMN geom2 geometry(LINESTRINGZ,4326);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:629
+#, no-c-format
+msgid ""
+"For backwards compability, you can still create a spatial table in two "
+"stages using the management functions."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:633
+#, no-c-format
+msgid "Create a normal non-spatial table."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:635
+#, no-c-format
+msgid ""
+"For example: <command>CREATE TABLE ROADS ( ID int4, ROAD_NAME varchar(25) )</"
+"command>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:640
+#, no-c-format
+msgid ""
+"Add a spatial column to the table using the OpenGIS \"AddGeometryColumn\" "
+"function. Refer to <xref linkend=\"AddGeometryColumn\"/> for more details."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:643
+#, no-c-format
+msgid ""
+"The syntax is: <programlisting>AddGeometryColumn(\n"
+" <schema_name>,\n"
+" <table_name>,\n"
+" <column_name>,\n"
+" <srid>,\n"
+" <type>,\n"
+" <dimension>\n"
+")</programlisting> Or, using current schema:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:643
+#, no-c-format
+msgid ""
+"AddGeometryColumn(\n"
+" <table_name>,\n"
+" <column_name>,\n"
+" <srid>,\n"
+" <type>,\n"
+" <dimension>\n"
+")"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:645
+#, no-c-format
+msgid ""
+"Example1: <command>SELECT AddGeometryColumn('public', 'roads', 'geom', 423, "
+"'LINESTRING', 2)</command>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:648
+#, no-c-format
+msgid ""
+"Example2: <command>SELECT AddGeometryColumn( 'roads', 'geom', 423, "
+"'LINESTRING', 2)</command>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:653
+#, no-c-format
+msgid ""
+"Here is an example of SQL used to create a table and add a spatial column "
+"(assuming that an SRID of 128 exists already):"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:656
+#, no-c-format
+msgid ""
+"CREATE TABLE parks (\n"
+" park_id INTEGER,\n"
+" park_name VARCHAR,\n"
+" park_date DATE,\n"
+" park_type VARCHAR\n"
+");\n"
+"SELECT AddGeometryColumn('parks', 'park_geom', 128, 'MULTIPOLYGON', 2 );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:658
+#, no-c-format
+msgid ""
+"Here is another example, using the generic \"geometry\" type and the "
+"undefined SRID value of 0:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:661
+#, no-c-format
+msgid ""
+"CREATE TABLE roads (\n"
+" road_id INTEGER,\n"
+" road_name VARCHAR\n"
+");\n"
+"SELECT AddGeometryColumn( 'roads', 'roads_geom', 0, 'GEOMETRY', 3 );"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:665
+#, no-c-format
+msgid "Manually Registering Geometry Columns in geometry_columns"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:666
+#, no-c-format
+msgid ""
+"The AddGeometryColumn() approach creates a geometry column and also "
+"registers the new column in the geometry_columns table. If your software "
+"utilizes geometry_columns, then any geometry columns you need to query by "
+"must be registered in this view. Starting with PoastGIS 2.0, "
+"geometry_columns is no longer editable and all geometry columns are "
+"autoregistered."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:670
+#, no-c-format
+msgid ""
+"However they may be registered as a generic geometry column if the column "
+"was not defined as a specific type during creation."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:672
+#, no-c-format
+msgid ""
+"Two of the cases where this may happen, but you can't use AddGeometryColumn, "
+"is in the case of SQL Views and bulk inserts. For these cases, you can "
+"correct the registration in the geometry_columns table by constraining the "
+"column. Note in PostGIS 2.0+ if your column is typmod based, the creation "
+"process would register it correctly, so no need to do anything."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:677
+#, no-c-format
+msgid ""
+"--Lets say you have a view created like this\n"
+"CREATE VIEW public.vwmytablemercator AS\n"
+" SELECT gid, ST_Transform(geom,3395) As geom, f_name\n"
+" FROM public.mytable;\n"
+" \n"
+"-- For it to register correctly in PostGIS 2.0+ \n"
+"-- You need to cast the geometry\n"
+"--\n"
+"DROP VIEW public.vwmytablemercator;\n"
+"CREATE VIEW public.vwmytablemercator AS\n"
+" SELECT gid, ST_Transform(geom,3395)::geometry(Geometry, 3395) As "
+"geom, f_name\n"
+" FROM public.mytable;\n"
+" \n"
+"-- If you know the geometry type for sure is a 2D POLYGON then you could do\n"
+"DROP VIEW public.vwmytablemercator;\n"
+"CREATE VIEW public.vwmytablemercator AS\n"
+" SELECT gid, ST_Transform(geom,3395)::geometry(Polygon, 3395) As "
+"geom, f_name\n"
+" FROM public.mytable;"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:678
+#, no-c-format
+msgid ""
+"--Lets say you created a derivative table by doing a bulk insert\n"
+"SELECT poi.gid, poi.geom, citybounds.city_name\n"
+"INTO myschema.my_special_pois\n"
+"FROM poi INNER JOIN citybounds ON ST_Intersects(citybounds.geom, poi.geom);\n"
+"\n"
+"--Create 2d index on new table\n"
+"CREATE INDEX idx_myschema_myspecialpois_geom_gist\n"
+" ON myschema.my_special_pois USING gist(geom);\n"
+" \n"
+"-- If your points are 3D points or 3M points, \n"
+"-- then you might want to create an nd index instead of a 2d index\n"
+"-- like so\n"
+"CREATE INDEX my_special_pois_geom_gist_nd \n"
+" ON my_special_pois USING gist(geom gist_geometry_ops_nd);\n"
+"\n"
+"--To manually register this new table's geometry column in geometry_columns\n"
+"-- Note that this approach will work for both PostGIS 2.0+ and PostGIS 1.4+\n"
+"-- For PostGIS 2.0 it will also change the underlying structure of the table "
+"to\n"
+"-- to make the column typmod based.\n"
+"-- For PostGIS prior to 2.0, this technique can also be used to register "
+"views\n"
+"SELECT populate_geometry_columns('myschema.my_special_pois'::regclass); \n"
+"\n"
+"--If you are using PostGIS 2.0 and for whatever reason, you\n"
+"-- you need the old constraint based definition behavior \n"
+"-- (such as case of inherited tables where all children do not have the same "
+"type and srid)\n"
+"-- set new optional use_typmod argument to false\n"
+"SELECT populate_geometry_columns('myschema.my_special_pois'::regclass, "
+"false);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:680
+#, no-c-format
+msgid ""
+"Although the old-constraint based method is still supported, a constraint-"
+"based geomentry column used directly in a view, will not register correctly "
+"in geometry_columns, as will a typmod one. In this example we define a "
+"column using typmod and another using constraints."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:683
+#, no-c-format
+msgid ""
+"CREATE TABLE pois_ny(gid SERIAL PRIMARY KEY\n"
+" , poi_name text, cat varchar(20)\n"
+" , geom geometry(POINT,4326) );\n"
+"SELECT AddGeometryColumn('pois_ny', 'geom_2160', 2160, 'POINT', 2, false);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:684
+#, no-c-format
+msgid "If we run in psql"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:685
+#, no-c-format
+msgid "\\d pois_ny;"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:686
+#, no-c-format
+msgid ""
+"We observe they are defined differently -- one is typmod, one is constraint"
+msgstr ""
+
+#. Tag: screen
+#: using_postgis_dataman.xml:687
+#, no-c-format
+msgid ""
+"Table \"public.pois_ny\"\n"
+" Column | Type | Modifiers\n"
+"\n"
+"-----------+-----------------------"
+"+------------------------------------------------------\n"
+" gid | integer | not null default "
+"nextval('pois_ny_gid_seq'::regclass)\n"
+" poi_name | text |\n"
+" cat | character varying(20) |\n"
+" geom | geometry(Point,4326) |\n"
+" geom_2160 | geometry |\n"
+"Indexes:\n"
+" \"pois_ny_pkey\" PRIMARY KEY, btree (gid)\n"
+"Check constraints:\n"
+" \"enforce_dims_geom_2160\" CHECK (st_ndims(geom_2160) = 2)\n"
+" \"enforce_geotype_geom_2160\" CHECK (geometrytype(geom_2160) = 'POINT'::"
+"text \n"
+" OR geom_2160 IS NULL)\n"
+" \"enforce_srid_geom_2160\" CHECK (st_srid(geom_2160) = 2160)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:688
+#, no-c-format
+msgid "In geometry_columns, they both register correctly"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:689
+#, no-c-format
+msgid ""
+"SELECT f_table_name, f_geometry_column, srid, type \n"
+" FROM geometry_columns \n"
+" WHERE f_table_name = 'pois_ny';"
+msgstr ""
+
+#. Tag: screen
+#: using_postgis_dataman.xml:690
+#, no-c-format
+msgid ""
+"f_table_name | f_geometry_column | srid | type\n"
+"-------------+-------------------+------+-------\n"
+"pois_ny | geom | 4326 | POINT\n"
+"pois_ny | geom_2160 | 2160 | POINT"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:691
+#, no-c-format
+msgid "However -- if we were to create a view like this"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:692
+#, no-c-format
+msgid ""
+"CREATE VIEW vw_pois_ny_parks AS \n"
+"SELECT * \n"
+" FROM pois_ny \n"
+" WHERE cat='park';\n"
+" \n"
+"SELECT f_table_name, f_geometry_column, srid, type \n"
+" FROM geometry_columns \n"
+" WHERE f_table_name = 'vw_pois_ny_parks';"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:693
+#, no-c-format
+msgid ""
+"The typmod based geom view column registers correctly, but the constraint "
+"based one does not."
+msgstr ""
+
+#. Tag: screen
+#: using_postgis_dataman.xml:695
+#, no-c-format
+msgid ""
+"f_table_name | f_geometry_column | srid | type\n"
+"------------------+-------------------+------+----------\n"
+" vw_pois_ny_parks | geom | 4326 | POINT\n"
+" vw_pois_ny_parks | geom_2160 | 0 | GEOMETRY"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:697
+#, no-c-format
+msgid ""
+"This may change in future versions of PostGIS, but for now To force the "
+"constraint based view column to register correctly, we need to do this:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:699
+#, no-c-format
+msgid ""
+"DROP VIEW vw_pois_ny_parks;\n"
+"CREATE VIEW vw_pois_ny_parks AS \n"
+"SELECT gid, poi_name, cat\n"
+" , geom\n"
+" , geom_2160::geometry(POINT,2160) As geom_2160 \n"
+" FROM pois_ny \n"
+" WHERE cat='park';\n"
+"SELECT f_table_name, f_geometry_column, srid, type \n"
+" FROM geometry_columns \n"
+" WHERE f_table_name = 'vw_pois_ny_parks';"
+msgstr ""
+
+#. Tag: screen
+#: using_postgis_dataman.xml:700
+#, no-c-format
+msgid ""
+"f_table_name | f_geometry_column | srid | type\n"
+"------------------+-------------------+------+-------\n"
+" vw_pois_ny_parks | geom | 4326 | POINT\n"
+" vw_pois_ny_parks | geom_2160 | 2160 | POINT"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:704
+#, no-c-format
+msgid "Ensuring OpenGIS compliancy of geometries"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:706
+#, no-c-format
+msgid ""
+"PostGIS is compliant with the Open Geospatial Consortium’s (OGC) OpenGIS "
+"Specifications. As such, many PostGIS methods require, or more accurately, "
+"assume that geometries that are operated on are both simple and valid. For "
+"example, it does not make sense to calculate the area of a polygon that has "
+"a hole defined outside of the polygon, or to construct a polygon from a non-"
+"simple boundary line."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:713
+#, no-c-format
+msgid ""
+"According to the OGC Specifications, a <emphasis>simple</emphasis> geometry "
+"is one that has no anomalous geometric points, such as self intersection or "
+"self tangency and primarily refers to 0 or 1-dimensional geometries (i.e. "
+"<varname>[MULTI]POINT, [MULTI]LINESTRING</varname>). Geometry validity, on "
+"the other hand, primarily refers to 2-dimensional geometries (i.e. "
+"<varname>[MULTI]POLYGON)</varname> and defines the set of assertions that "
+"characterizes a valid polygon. The description of each geometric class "
+"includes specific conditions that further detail geometric simplicity and "
+"validity."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:723
+#, no-c-format
+msgid ""
+"A <varname>POINT</varname> is inheritably <emphasis>simple</emphasis> as a 0-"
+"dimensional geometry object."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:726
+#, no-c-format
+msgid ""
+"<varname>MULTIPOINT</varname>s are <emphasis>simple</emphasis> if no two "
+"coordinates (<varname>POINT</varname>s) are equal (have identical coordinate "
+"values)."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:730
+#, no-c-format
+msgid ""
+"A <varname>LINESTRING</varname> is <emphasis>simple</emphasis> if it does "
+"not pass through the same <varname>POINT</varname> twice (except for the "
+"endpoints, in which case it is referred to as a linear ring and additionally "
+"considered closed)."
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:745
+#, no-c-format
+msgid "<emphasis>(a)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:755
+#, no-c-format
+msgid "<emphasis>(b)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:767
+#, no-c-format
+msgid "<emphasis>(c)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:777
+#, no-c-format
+msgid "<emphasis>(d)</emphasis>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:787
+#, no-c-format
+msgid ""
+"<emphasis role=\"bold\">(a)</emphasis> and <emphasis role=\"bold\">(c)</"
+"emphasis> are simple <varname>LINESTRING</varname>s, <emphasis role=\"bold"
+"\">(b)</emphasis> and <emphasis role=\"bold\">(d)</emphasis> are not."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:796
+#, no-c-format
+msgid ""
+"A <varname>MULTILINESTRING</varname> is <emphasis>simple</emphasis> only if "
+"all of its elements are simple and the only intersection between any two "
+"elements occurs at <varname>POINT</varname>s that are on the boundaries of "
+"both elements."
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:811
+#, no-c-format
+msgid "<emphasis>(e)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:821
+#, no-c-format
+msgid "<emphasis>(f)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:831
+#, no-c-format
+msgid "<emphasis>(g)</emphasis>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:841
+#, no-c-format
+msgid ""
+"<emphasis role=\"bold\">(e)</emphasis> and <emphasis role=\"bold\">(f)</"
+"emphasis> are simple <varname>MULTILINESTRING</varname>s, <emphasis role="
+"\"bold\">(g)</emphasis> is not."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:850
+#, no-c-format
+msgid ""
+"By definition, a <varname>POLYGON</varname> is always <emphasis>simple</"
+"emphasis>. It is <emphasis>valid</emphasis> if no two rings in the boundary "
+"(made up of an exterior ring and interior rings) cross. The boundary of a "
+"<varname>POLYGON</varname> may intersect at a <varname>POINT</varname> but "
+"only as a tangent (i.e. not on a line). A <varname>POLYGON</varname> may not "
+"have cut lines or spikes and the interior rings must be contained entirely "
+"within the exterior ring."
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:868
+#, no-c-format
+msgid "<emphasis>(h)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:878
+#, no-c-format
+msgid "<emphasis>(i)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:888
+#, no-c-format
+msgid "<emphasis>(j)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:900
+#, no-c-format
+msgid "<emphasis>(k)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:910
+#, no-c-format
+msgid "<emphasis>(l)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:920
+#, no-c-format
+msgid "<emphasis>(m)</emphasis>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:929
+#, no-c-format
+msgid ""
+"<emphasis role=\"bold\">(h)</emphasis> and <emphasis role=\"bold\">(i)</"
+"emphasis> are valid <varname>POLYGON</varname>s, <emphasis role=\"bold\">(j-"
+"m)</emphasis> cannot be represented as single <varname>POLYGON</varname>s, "
+"but <emphasis role=\"bold\">(j)</emphasis> and <emphasis role=\"bold\">(m)</"
+"emphasis> could be represented as a valid <varname>MULTIPOLYGON</varname>."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:941
+#, no-c-format
+msgid ""
+"A <varname>MULTIPOLYGON</varname> is <emphasis>valid</emphasis> if and only "
+"if all of its elements are valid and the interiors of no two elements "
+"intersect. The boundaries of any two elements may touch, but only at a "
+"finite number of <varname>POINT</varname>s."
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:956
+#, no-c-format
+msgid "<emphasis>(n)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:966
+#, no-c-format
+msgid "<emphasis>(o)</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:976
+#, no-c-format
+msgid "<emphasis>(p)</emphasis>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:985
+#, no-c-format
+msgid ""
+"<emphasis role=\"bold\">(n)</emphasis> and <emphasis role=\"bold\">(o)</"
+"emphasis> are not valid <varname>MULTIPOLYGON</varname>s. <emphasis role="
+"\"bold\">(p)</emphasis>, however, is valid."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:994
+#, no-c-format
+msgid ""
+"Most of the functions implemented by the GEOS library rely on the assumption "
+"that your geometries are valid as specified by the OpenGIS Simple Feature "
+"Specification. To check simplicity or validity of geometries you can use the "
+"<link linkend=\"ST_IsSimple\">ST_IsSimple()</link> and <link linkend="
+"\"ST_IsValid\">ST_IsValid()</link>"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1000
+#, no-c-format
+msgid ""
+"-- Typically, it doesn't make sense to check\n"
+"-- for validity on linear features since it will always return TRUE.\n"
+"-- But in this example, PostGIS extends the definition of the OGC IsValid\n"
+"-- by returning false if a LineString has less than 2 *distinct* vertices.\n"
+"gisdb=# SELECT\n"
+" ST_IsValid('LINESTRING(0 0, 1 1)'),\n"
+" ST_IsValid('LINESTRING(0 0, 0 0, 0 0)');\n"
+"\n"
+" st_isvalid | st_isvalid\n"
+"------------+-----------\n"
+" t | f"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1002
+#, no-c-format
+msgid ""
+"By default, PostGIS does not apply this validity check on geometry input, "
+"because testing for validity needs lots of CPU time for complex geometries, "
+"especially polygons. If you do not trust your data sources, you can manually "
+"enforce such a check to your tables by adding a check constraint:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1008
+#, no-c-format
+msgid ""
+"ALTER TABLE mytable\n"
+" ADD CONSTRAINT geometry_valid_check\n"
+" CHECK (ST_IsValid(the_geom));"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1010
+#, no-c-format
+msgid ""
+"If you encounter any strange error messages such as \"GEOS Intersection() "
+"threw an error!\" or \"JTS Intersection() threw an error!\" when calling "
+"PostGIS functions with valid input geometries, you likely found an error in "
+"either PostGIS or one of the libraries it uses, and you should contact the "
+"PostGIS developers. The same is true if a PostGIS function returns an "
+"invalid geometry for valid input."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1018
+#, no-c-format
+msgid ""
+"Strictly compliant OGC geometries cannot have Z or M values. The <link "
+"linkend=\"ST_IsValid\">ST_IsValid()</link> function won't consider higher "
+"dimensioned geometries invalid! Invocations of <link linkend="
+"\"AddGeometryColumn\">AddGeometryColumn()</link> will add a constraint "
+"checking geometry dimensions, so it is enough to specify 2 there."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1028
+#, no-c-format
+msgid "Dimensionally Extended 9 Intersection Model (DE-9IM)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1030
+#, no-c-format
+msgid ""
+"It is sometimes the case that the typical spatial predicates (<xref linkend="
+"\"ST_Contains\"/>, <xref linkend=\"ST_Crosses\"/>, <xref linkend="
+"\"ST_Intersects\"/>, <xref linkend=\"ST_Touches\"/>, ...) are insufficient "
+"in and of themselves to adequately provide that desired spatial filter."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1042
+#, no-c-format
+msgid ""
+"For example, consider a linear dataset representing a road network. It may "
+"be the task of a GIS analyst to identify all road segments that cross each "
+"other, not at a point, but on a line, perhaps invalidating some business "
+"rule. In this case, <xref linkend=\"ST_Crosses\"/> does not adequately "
+"provide the necessary spatial filter since, for linear features, it returns "
+"<varname>true</varname> only where they cross at a point."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1049
+#, no-c-format
+msgid ""
+"One two-step solution might be to first perform the actual intersection "
+"(<xref linkend=\"ST_Intersection\"/>) of pairs of road segments that "
+"spatially intersect (<xref linkend=\"ST_Intersects\"/>), and then compare "
+"the intersection's <xref linkend=\"ST_GeometryType\"/> with "
+"'<varname>LINESTRING</varname>' (properly dealing with cases that return "
+"<varname>GEOMETRYCOLLECTION</varname>s of <varname>[MULTI]POINT</varname>s, "
+"<varname>[MULTI]LINESTRING</varname>s, etc.)."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1057
+#, no-c-format
+msgid "A more elegant / faster solution may indeed be desirable."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1071
+#, no-c-format
+msgid ""
+"A second [theoretical] example may be that of a GIS analyst trying to locate "
+"all wharfs or docks that intersect a lake's boundary on a line and where "
+"only one end of the wharf is up on shore. In other words, where a wharf is "
+"within, but not completely within a lake, intersecting the boundary of a "
+"lake on a line, and where the wharf's endpoints are both completely within "
+"and on the boundary of the lake. The analyst may need to use a combination "
+"of spatial predicates to isolate the sought after features:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1082
+#, no-c-format
+msgid "(lake, wharf) = TRUE"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1086
+#, no-c-format
+msgid "(lake, wharf) = FALSE"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1090
+#, no-c-format
+msgid "(<xref linkend=\"ST_Intersection\"/>(wharf, lake)) = 'LINESTRING'"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1095
+#, no-c-format
+msgid ""
+"(<xref linkend=\"ST_Multi\"/>(<xref linkend=\"ST_Intersection\"/>(<xref "
+"linkend=\"ST_Boundary\"/>(wharf), <xref linkend=\"ST_Boundary\"/>(lake)))) = "
+"1"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1098
+#, no-c-format
+msgid "... (needless to say, this could get quite complicated)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1107
+#, no-c-format
+msgid ""
+"So enters the Dimensionally Extended 9 Intersection Model, or DE-9IM for "
+"short."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1111
+#, no-c-format
+msgid "Theory"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1113
+#, no-c-format
+msgid ""
+"According to the <ulink url=\"http://www.opengeospatial.org/standards/sfs"
+"\">OpenGIS Simple Features Implementation Specification for SQL</ulink>, "
+"\"the basic approach to comparing two geometries is to make pair-wise tests "
+"of the intersections between the Interiors, Boundaries and Exteriors of the "
+"two geometries and to classify the relationship between the two geometries "
+"based on the entries in the resulting 'intersection' matrix.\""
+msgstr ""
+
+#. Tag: glossterm
+#: using_postgis_dataman.xml:1124
+#, no-c-format
+msgid "<glossterm>Boundary</glossterm>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1127
+#, no-c-format
+msgid ""
+"The boundary of a geometry is the set of geometries of the next lower "
+"dimension. For <varname>POINT</varname>s, which have a dimension of 0, the "
+"boundary is the empty set. The boundary of a <varname>LINESTRING</varname> "
+"are the two endpoints. For <varname>POLYGON</varname>s, the boundary is the "
+"linework that make up the exterior and interior rings."
+msgstr ""
+
+#. Tag: glossterm
+#: using_postgis_dataman.xml:1138
+#, no-c-format
+msgid "<glossterm>Interior</glossterm>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1141
+#, no-c-format
+msgid ""
+"The interior of a geometry are those points of a geometry that are left when "
+"the boundary is removed. For <varname>POINT</varname>s, the interior is the "
+"<varname>POINT</varname> itself. The interior of a <varname>LINESTRING</"
+"varname> are the set of real points between the endpoints. For "
+"<varname>POLYGON</varname>s, the interior is the areal surface inside the "
+"polygon."
+msgstr ""
+
+#. Tag: glossterm
+#: using_postgis_dataman.xml:1152
+#, no-c-format
+msgid "<glossterm>Exterior</glossterm>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1155
+#, no-c-format
+msgid ""
+"The exterior of a geometry is the universe, an areal surface, not on the "
+"interior or boundary of the geometry."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1162
+#, no-c-format
+msgid ""
+"Given geometry <emphasis>a</emphasis>, where the <emphasis>I(a)</emphasis>, "
+"<emphasis>B(a)</emphasis>, and <emphasis>E(a)</emphasis> are the "
+"<emphasis>Interior</emphasis>, <emphasis>Boundary</emphasis>, and "
+"<emphasis>Exterior</emphasis> of a, the mathematical representation of the "
+"matrix is:"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:1174 using_postgis_dataman.xml:1184
+#: using_postgis_dataman.xml:1377 using_postgis_dataman.xml:1390
+#, no-c-format
+msgid "<emphasis role=\"bold\">Interior</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:1176 using_postgis_dataman.xml:1227
+#: using_postgis_dataman.xml:1380 using_postgis_dataman.xml:1413
+#, no-c-format
+msgid "<emphasis role=\"bold\">Boundary</emphasis>"
+msgstr ""
+
+#. Tag: emphasis
+#: using_postgis_dataman.xml:1178 using_postgis_dataman.xml:1270
+#: using_postgis_dataman.xml:1383 using_postgis_dataman.xml:1436
+#, no-c-format
+msgid "<emphasis role=\"bold\">Exterior</emphasis>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1188
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( I(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">I(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1201
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( I(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">B(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1214
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( I(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">E(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1231
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( B(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">I(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1244
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( B(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">B(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1257
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( B(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">E(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1274
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( E(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">I(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1287
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( E(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">B(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: mml:mrow
+#: using_postgis_dataman.xml:1300
+#, no-c-format
+msgid ""
+"<mml:mtext mathvariant=\"italic\">dim( E(a)</mml:mtext> <mml:mo>∩</mml:mo> "
+"<mml:mtext mathvariant=\"italic\">E(b) )</mml:mtext>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1315
+#, no-c-format
+msgid ""
+"Where <emphasis>dim(a)</emphasis> is the dimension of <emphasis>a</emphasis> "
+"as specified by <xref linkend=\"ST_Dimension\"/> but has the domain of "
+"<literal>{0,1,2,T,F,*}</literal>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1322
+#, no-c-format
+msgid "<literal>0</literal> => point"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1326
+#, no-c-format
+msgid "<literal>1</literal> => line"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1330
+#, no-c-format
+msgid "<literal>2</literal> => area"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1334
+#, no-c-format
+msgid "<literal>T</literal> => <literal>{0,1,2}</literal>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1339
+#, no-c-format
+msgid "<literal>F</literal> => empty set"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1343
+#, no-c-format
+msgid "<literal>*</literal> => don't care"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1347
+#, no-c-format
+msgid "Visually, for two overlapping polygonal geometries, this looks like:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1394 using_postgis_dataman.xml:1406
+#: using_postgis_dataman.xml:1440 using_postgis_dataman.xml:1452
+#, no-c-format
+msgid "<emphasis>dim(...) = </emphasis><emphasis role=\"bold\">2</emphasis>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1400 using_postgis_dataman.xml:1417
+#: using_postgis_dataman.xml:1429 using_postgis_dataman.xml:1446
+#, no-c-format
+msgid "<emphasis>dim(...) = </emphasis><emphasis role=\"bold\">1</emphasis>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1423
+#, no-c-format
+msgid "<emphasis>dim(...) = </emphasis><emphasis role=\"bold\">0</emphasis>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1464
+#, no-c-format
+msgid ""
+"Read from left to right and from top to bottom, the dimensional matrix is "
+"represented, '<emphasis role=\"bold\">212101212</emphasis>'."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1467
+#, no-c-format
+msgid ""
+"A relate matrix that would therefore represent our first example of two "
+"lines that intersect on a line would be: '<emphasis role=\"bold\">1*1***1**</"
+"emphasis>'"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1471
+#, no-c-format
+msgid ""
+"-- Identify road segments that cross on a line\n"
+"SELECT a.id\n"
+"FROM roads a, roads b\n"
+"WHERE a.id != b.id \n"
+"AND a.geom && b.geom\n"
+"AND ST_Relate(a.geom, b.geom, '1*1***1**');"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1473
+#, no-c-format
+msgid ""
+"A relate matrix that represents the second example of wharfs partly on the "
+"lake's shoreline would be '<emphasis role=\"bold\">102101FF2</emphasis>'"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1477
+#, no-c-format
+msgid ""
+"-- Identify wharfs partly on a lake's shoreline\n"
+"SELECT a.lake_id, b.wharf_id\n"
+"FROM lakes a, wharfs b\n"
+"WHERE a.geom && b.geom\n"
+"AND ST_Relate(a.geom, b.geom, '102101FF2');"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1479
+#, no-c-format
+msgid "For more information or reading, see:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1483
+#, no-c-format
+msgid ""
+"<ulink url=\"http://www.opengeospatial.org/standards/sfs\">OpenGIS Simple "
+"Features Implementation Specification for SQL</ulink> (version 1.1, section "
+"2.1.13.2)"
+msgstr ""
+
+#. Tag: ulink
+#: using_postgis_dataman.xml:1488
+#, no-c-format
+msgid ""
+"Dimensionally Extended Nine-Intersection Model (DE-9IM) by Christian Strobl"
+msgstr ""
+
+#. Tag: ulink
+#: using_postgis_dataman.xml:1492
+#, no-c-format
+msgid "GeoTools: Point Set Theory and the DE-9IM Matrix"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1495
+#, no-c-format
+msgid "<emphasis>Encyclopedia of GIS</emphasis> By Hui Xiong"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1505
+#, no-c-format
+msgid "Loading GIS Data"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1507
+#, no-c-format
+msgid ""
+"Once you have created a spatial table, you are ready to upload GIS data to "
+"the database. Currently, there are two ways to get data into a PostGIS/"
+"PostgreSQL database: using formatted SQL statements or using the Shape file "
+"loader/dumper."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1513 using_postgis_dataman.xml:1789
+#, no-c-format
+msgid "Using SQL"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1515
+#, no-c-format
+msgid ""
+"If you can convert your data to a text representation, then using formatted "
+"SQL might be the easiest way to get your data into PostGIS. As with Oracle "
+"and other SQL databases, data can be bulk loaded by piping a large text file "
+"full of SQL \"INSERT\" statements into the SQL terminal monitor."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1521
+#, no-c-format
+msgid ""
+"A data upload file (<filename>roads.sql</filename> for example) might look "
+"like this:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1524
+#, no-c-format
+msgid ""
+"BEGIN;\n"
+"INSERT INTO roads (road_id, roads_geom, road_name)\n"
+" VALUES (1,ST_GeomFromText('LINESTRING(191232 243118,191108 "
+"243242)',-1),'Jeff Rd');\n"
+"INSERT INTO roads (road_id, roads_geom, road_name)\n"
+" VALUES (2,ST_GeomFromText('LINESTRING(189141 244158,189265 "
+"244817)',-1),'Geordie Rd');\n"
+"INSERT INTO roads (road_id, roads_geom, road_name)\n"
+" VALUES (3,ST_GeomFromText('LINESTRING(192783 228138,192612 "
+"229814)',-1),'Paul St');\n"
+"INSERT INTO roads (road_id, roads_geom, road_name)\n"
+" VALUES (4,ST_GeomFromText('LINESTRING(189412 252431,189631 "
+"259122)',-1),'Graeme Ave');\n"
+"INSERT INTO roads (road_id, roads_geom, road_name)\n"
+" VALUES (5,ST_GeomFromText('LINESTRING(190131 224148,190871 "
+"228134)',-1),'Phil Tce');\n"
+"INSERT INTO roads (road_id, roads_geom, road_name)\n"
+" VALUES (6,ST_GeomFromText('LINESTRING(198231 263418,198213 "
+"268322)',-1),'Dave Cres');\n"
+"COMMIT;"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1526
+#, no-c-format
+msgid ""
+"The data file can be piped into PostgreSQL very easily using the \"psql\" "
+"SQL terminal monitor:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1529
+#, no-c-format
+msgid "psql -d [database] -f roads.sql"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1533
+#, no-c-format
+msgid "Using the Loader"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1535
+#, no-c-format
+msgid ""
+"The <filename>shp2pgsql</filename> data loader converts ESRI Shape files "
+"into SQL suitable for insertion into a PostGIS/PostgreSQL database either in "
+"geometry or geography format. The loader has several operating modes "
+"distinguished by command line flags:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1540
+#, no-c-format
+msgid ""
+"In addition to the shp2pgsql command-line loader, there is an "
+"<filename>shp2pgsql-gui</filename> graphical interface with most of the "
+"options as the command-line loader, but may be easier to use for one-off non-"
+"scripted loading or if you are new to PostGIS. It can also be configured as "
+"a plugin to PgAdminIII."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1547
+#, no-c-format
+msgid "(c|a|d|p) These are mutually exclusive options:"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1552
+#, no-c-format
+msgid "<term>-c</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1554
+#, no-c-format
+msgid ""
+"Creates a new table and populates it from the shapefile. <emphasis>This is "
+"the default mode.</emphasis>"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1562
+#, no-c-format
+msgid "<term>-a</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1564
+#, no-c-format
+msgid ""
+"Appends data from the Shape file into the database table. Note that to use "
+"this option to load multiple files, the files must have the same attributes "
+"and same data types."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1573 using_postgis_dataman.xml:1948
+#, no-c-format
+msgid "<term>-d</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1575
+#, no-c-format
+msgid ""
+"Drops the database table before creating a new table with the data in the "
+"Shape file."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1583
+#, no-c-format
+msgid "<term>-p</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1585
+#, no-c-format
+msgid ""
+"Only produces the table creation SQL code, without adding any actual data. "
+"This can be used if you need to completely separate the table creation and "
+"data loading steps."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1598
+#, no-c-format
+msgid "<term>-?</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1600
+#, no-c-format
+msgid "Display help screen."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1607
+#, no-c-format
+msgid "<term>-D</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1609
+#, no-c-format
+msgid ""
+"Use the PostgreSQL \"dump\" format for the output data. This can be combined "
+"with -a, -c and -d. It is much faster to load than the default \"insert\" "
+"SQL format. Use this for very large data sets."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1618
+#, no-c-format
+msgid "-s [<FROM_SRID%gt;:]<SRID>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1620
+#, no-c-format
+msgid ""
+"Creates and populates the geometry tables with the specified SRID. "
+"Optionally specifies that the input shapefile uses the given FROM_SRID, in "
+"which case the geometries will be reprojected to the target SRID. FROM_SRID "
+"cannot be specified with -D."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1631
+#, no-c-format
+msgid "<term>-k</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1633
+#, no-c-format
+msgid ""
+"Keep identifiers' case (column, schema and attributes). Note that attributes "
+"in Shapefile are all UPPERCASE."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1641
+#, no-c-format
+msgid "<term>-i</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1643
+#, no-c-format
+msgid ""
+"Coerce all integers to standard 32-bit integers, do not create 64-bit "
+"bigints, even if the DBF header signature appears to warrant it."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1651
+#, no-c-format
+msgid "<term>-I</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1653
+#, no-c-format
+msgid "Create a GiST index on the geometry column."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1659
+#, no-c-format
+msgid "<term>-S</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1661
+#, no-c-format
+msgid ""
+"Generate simple geometries instead of MULTI geometries. Will only succeed if "
+"all the geometries are actually single (I.E. a MULTIPOLYGON with a single "
+"shell, or or a MULTIPOINT with a single vertex)."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1670
+#, no-c-format
+msgid "-t <dimensionality>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1672
+#, no-c-format
+msgid ""
+"Force the output geometry to have the specified dimensionality. Use the "
+"following strings to indicate the dimensionality: 2D, 3DZ, 3DM, 4D."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1676
+#, no-c-format
+msgid ""
+"If the input has fewer dimensions that specified, the output will have those "
+"dimensions filled in with zeroes. If the input has more dimensions that "
+"specified, the unwanted dimensions will be stripped."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1685
+#, no-c-format
+msgid "<term>-w</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1687
+#, no-c-format
+msgid ""
+"Output WKT format, instead of WKB. Note that this can introduce coordinate "
+"drifts due to loss of precision."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1695
+#, no-c-format
+msgid "<term>-e</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1697
+#, no-c-format
+msgid ""
+"Execute each statement on its own, without using a transaction. This allows "
+"loading of the majority of good data when there are some bad geometries that "
+"generate errors. Note that this cannot be used with the -D flag as the \"dump"
+"\" format always uses a transaction."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1707
+#, no-c-format
+msgid "-W <encoding>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1709
+#, no-c-format
+msgid ""
+"Specify encoding of the input data (dbf file). When used, all attributes of "
+"the dbf are converted from the specified encoding to UTF8. The resulting SQL "
+"output will contain a <code>SET CLIENT_ENCODING to UTF8</code> command, so "
+"that the backend will be able to reconvert from UTF8 to whatever encoding "
+"the database is configured to use internally."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1719
+#, no-c-format
+msgid "-N <policy>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1721
+#, no-c-format
+msgid "NULL geometries handling policy (insert*,skip,abort)"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1727
+#, no-c-format
+msgid "<term>-n</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1729
+#, no-c-format
+msgid ""
+"-n Only import DBF file. If your data has no corresponding shapefile, it "
+"will automatically switch to this mode and load just the dbf. So setting "
+"this flag is only needed if you have a full shapefile set, and you only want "
+"the attribute data and no geometry."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1737
+#, no-c-format
+msgid "<term>-G</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1739
+#, no-c-format
+msgid ""
+"Use geography type instead of geometry (requires lon/lat data) in WGS84 long "
+"lat (SRID=4326)"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1745
+#, no-c-format
+msgid "-T <tablespace>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1747
+#, no-c-format
+msgid ""
+"Specify the tablespace for the new table. Indexes will still use the default "
+"tablespace unless the -X parameter is also used. The PostgreSQL "
+"documentation has a good description on when to use custom tablespaces."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1755
+#, no-c-format
+msgid "-X <tablespace>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1757
+#, no-c-format
+msgid ""
+"Specify the tablespace for the new table's indexes. This applies to the "
+"primary key index, and the GIST spatial index if -I is also used."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1765
+#, no-c-format
+msgid ""
+"An example session using the loader to create an input file and uploading it "
+"might look like this:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1770
+#, no-c-format
+msgid ""
+"# shp2pgsql -c -D -s 4269 -i -I shaperoads.shp myschema.roadstable > "
+"roads.sql\n"
+"# psql -d roadsdb -f roads.sql"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1772
+#, no-c-format
+msgid "A conversion and upload can be done all in one step using UNIX pipes:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1776
+#, no-c-format
+msgid "# shp2pgsql shaperoads.shp myschema.roadstable | psql -d roadsdb"
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1781
+#, no-c-format
+msgid "Retrieving GIS Data"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1783
+#, no-c-format
+msgid ""
+"Data can be extracted from the database using either SQL or the Shape file "
+"loader/dumper. In the section on SQL we will discuss some of the operators "
+"available to do comparisons and queries on spatial tables."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1791
+#, no-c-format
+msgid ""
+"The most straightforward means of pulling data out of the database is to use "
+"a SQL select query to reduce the number of RECORDS and COLUMNS returned and "
+"dump the resulting columns into a parsable text file:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1796
+#, no-c-format
+msgid ""
+"db=# SELECT road_id, ST_AsText(road_geom) AS geom, road_name FROM roads;\n"
+"\n"
+"road_id | geom | road_name\n"
+"--------+-----------------------------------------+-----------\n"
+" 1 | LINESTRING(191232 243118,191108 243242) | Jeff Rd\n"
+" 2 | LINESTRING(189141 244158,189265 244817) | Geordie Rd\n"
+" 3 | LINESTRING(192783 228138,192612 229814) | Paul St\n"
+" 4 | LINESTRING(189412 252431,189631 259122) | Graeme Ave\n"
+" 5 | LINESTRING(190131 224148,190871 228134) | Phil Tce\n"
+" 6 | LINESTRING(198231 263418,198213 268322) | Dave Cres\n"
+" 7 | LINESTRING(218421 284121,224123 241231) | Chris Way\n"
+"(6 rows)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1798
+#, no-c-format
+msgid ""
+"However, there will be times when some kind of restriction is necessary to "
+"cut down the number of fields returned. In the case of attribute-based "
+"restrictions, just use the same SQL syntax as normal with a non-spatial "
+"table. In the case of spatial restrictions, the following operators are "
+"available/useful:"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1806
+#, no-c-format
+msgid "&&"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1809
+#, no-c-format
+msgid ""
+"This operator tells whether the bounding box of one geometry intersects the "
+"bounding box of another."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1815
+#, no-c-format
+msgid "ST_OrderingEquals"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1818
+#, no-c-format
+msgid ""
+"This tests whether two geometries are geometrically identical. For example, "
+"if 'POLYGON((0 0,1 1,1 0,0 0))' is the same as 'POLYGON((0 0,1 1,1 0,0 "
+"0))' (it is)."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1825
+#, no-c-format
+msgid "<term>=</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1828
+#, no-c-format
+msgid ""
+"This operator is a little more naive, it only tests whether the bounding "
+"boxes of two geometries are the same."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1834
+#, no-c-format
+msgid ""
+"Next, you can use these operators in queries. Note that when specifying "
+"geometries and boxes on the SQL command line, you must explicitly turn the "
+"string representations into geometries by using the \"ST_GeomFromText()\" "
+"function. The 312 is a fictitious spatial reference system that matches our "
+"data. So, for example:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1840
+#, no-c-format
+msgid ""
+"SELECT road_id, road_name\n"
+" FROM roads\n"
+" WHERE ST_OrderingEquals(roads_geom , ST_GeomFromText('LINESTRING(191232 "
+"243118,191108 243242)',312) ) ;"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1842
+#, no-c-format
+msgid ""
+"The above query would return the single record from the \"ROADS_GEOM\" table "
+"in which the geometry was equal to that value."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1845
+#, no-c-format
+msgid ""
+"When using the \"&&\" operator, you can specify either a BOX3D as "
+"the comparison feature or a GEOMETRY. When you specify a GEOMETRY, however, "
+"its bounding box will be used for the comparison."
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1850
+#, no-c-format
+msgid ""
+"SELECT road_id, road_name\n"
+"FROM roads\n"
+"WHERE roads_geom && ST_GeomFromText('POLYGON((...))',312);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1852
+#, no-c-format
+msgid ""
+"The above query will use the bounding box of the polygon for comparison "
+"purposes."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1855
+#, no-c-format
+msgid ""
+"The most common spatial query will probably be a \"frame-based\" query, used "
+"by client software, like data browsers and web mappers, to grab a \"map frame"
+"\" worth of data for display. Using a \"BOX3D\" object for the frame, such a "
+"query looks like this:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1860
+#, no-c-format
+msgid ""
+"SELECT ST_AsText(roads_geom) AS geom\n"
+"FROM roads\n"
+"WHERE\n"
+" roads_geom && ST_MakeEnvelope(191232, 243117,191232, 243119,312);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1862
+#, no-c-format
+msgid ""
+"Note the use of the SRID 312, to specify the projection of the envelope."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1866
+#, no-c-format
+msgid "Using the Dumper"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1868
+#, no-c-format
+msgid ""
+"The <filename>pgsql2shp</filename> table dumper connects directly to the "
+"database and converts a table (possibly defined by a query) into a shape "
+"file. The basic syntax is:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1872
+#, no-c-format
+msgid ""
+"pgsql2shp [<options>] <database> [<schema>.]<table>"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:1874
+#, no-c-format
+msgid "pgsql2shp [<options>] <database> <query>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1876
+#, no-c-format
+msgid "The commandline options are:"
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1880
+#, no-c-format
+msgid "-f <filename>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1883
+#, no-c-format
+msgid "Write the output to a particular filename."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1888
+#, no-c-format
+msgid "-h <host>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1891
+#, no-c-format
+msgid "The database host to connect to."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1896
+#, no-c-format
+msgid "-p <port>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1899
+#, no-c-format
+msgid "The port to connect to on the database host."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1904
+#, no-c-format
+msgid "-P <password>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1907
+#, no-c-format
+msgid "The password to use when connecting to the database."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1912
+#, no-c-format
+msgid "-u <user>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1915
+#, no-c-format
+msgid "The username to use when connecting to the database."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1920
+#, no-c-format
+msgid "-g <geometry column>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1923
+#, no-c-format
+msgid ""
+"In the case of tables with multiple geometry columns, the geometry column to "
+"use when writing the shape file."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1929
+#, no-c-format
+msgid "<term>-b</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1932
+#, no-c-format
+msgid ""
+"Use a binary cursor. This will make the operation faster, but will not work "
+"if any NON-geometry attribute in the table lacks a cast to text."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1939
+#, no-c-format
+msgid "<term>-r</term>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1942
+#, no-c-format
+msgid ""
+"Raw mode. Do not drop the <varname>gid</varname> field, or escape column "
+"names."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1951
+#, no-c-format
+msgid ""
+"For backward compatibility: write a 3-dimensional shape file when dumping "
+"from old (pre-1.0.0) postgis databases (the default is to write a 2-"
+"dimensional shape file in that case). Starting from postgis-1.0.0+, "
+"dimensions are fully encoded."
+msgstr ""
+
+#. Tag: term
+#: using_postgis_dataman.xml:1959
+#, no-c-format
+msgid "-m <varname>filename</varname>"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1961
+#, no-c-format
+msgid ""
+"Remap identifiers to ten character names. The content of the file is lines "
+"of two symbols separated by a single white space and no trailing or leading "
+"space: VERYLONGSYMBOL SHORTONE ANOTHERVERYLONGSYMBOL SHORTER etc."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:1974
+#, no-c-format
+msgid "Building Indexes"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1976
+#, no-c-format
+msgid ""
+"Indexes are what make using a spatial database for large data sets possible. "
+"Without indexing, any search for a feature would require a \"sequential scan"
+"\" of every record in the database. Indexing speeds up searching by "
+"organizing the data into a search tree which can be quickly traversed to "
+"find a particular record. PostgreSQL supports three kinds of indexes by "
+"default: B-Tree indexes, R-Tree indexes, and GiST indexes."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1986
+#, no-c-format
+msgid ""
+"B-Trees are used for data which can be sorted along one axis; for example, "
+"numbers, letters, dates. GIS data cannot be rationally sorted along one axis "
+"(which is greater, (0,0) or (0,1) or (1,0)?) so B-Tree indexing is of no use "
+"for us."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:1993
+#, no-c-format
+msgid ""
+"R-Trees break up data into rectangles, and sub-rectangles, and sub-sub "
+"rectangles, etc. R-Trees are used by some spatial databases to index GIS "
+"data, but the PostgreSQL R-Tree implementation is not as robust as the GiST "
+"implementation."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2000
+#, no-c-format
+msgid ""
+"GiST (Generalized Search Trees) indexes break up data into \"things to one "
+"side\", \"things which overlap\", \"things which are inside\" and can be "
+"used on a wide range of data-types, including GIS data. PostGIS uses an R-"
+"Tree index implemented on top of GiST to index GIS data."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:2009
+#, no-c-format
+msgid "GiST Indexes"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2011
+#, no-c-format
+msgid ""
+"GiST stands for \"Generalized Search Tree\" and is a generic form of "
+"indexing. In addition to GIS indexing, GiST is used to speed up searches on "
+"all kinds of irregular data structures (integer arrays, spectral data, etc) "
+"which are not amenable to normal B-Tree indexing."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2016
+#, no-c-format
+msgid ""
+"Once a GIS data table exceeds a few thousand rows, you will want to build an "
+"index to speed up spatial searches of the data (unless all your searches are "
+"based on attributes, in which case you'll want to build a normal index on "
+"the attribute fields)."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2021
+#, no-c-format
+msgid ""
+"The syntax for building a GiST index on a \"geometry\" column is as follows:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2024
+#, no-c-format
+msgid "CREATE INDEX [indexname] ON [tablename] USING GIST ( [geometryfield] );"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2025
+#, no-c-format
+msgid ""
+"The above syntax will always build a 2D-index. To get the an n-dimensional "
+"index supported in PostGIS 2.0+ for the geometry type, you can create one "
+"using this syntax"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2026
+#, no-c-format
+msgid ""
+"CREATE INDEX [indexname] ON [tablename] USING GIST ([geometryfield] "
+"gist_geometry_ops_nd);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2028
+#, no-c-format
+msgid ""
+"Building a spatial index is a computationally intensive exercise: on tables "
+"of around 1 million rows, on a 300MHz Solaris machine, we have found "
+"building a GiST index takes about 1 hour. After building an index, it is "
+"important to force PostgreSQL to collect table statistics, which are used to "
+"optimize query plans:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2034
+#, no-c-format
+msgid ""
+"VACUUM ANALYZE [table_name] [(column_name)];\n"
+"-- This is only needed for PostgreSQL 7.4 installations and below\n"
+"SELECT UPDATE_GEOMETRY_STATS([table_name], [column_name]);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2036
+#, no-c-format
+msgid ""
+"GiST indexes have two advantages over R-Tree indexes in PostgreSQL. Firstly, "
+"GiST indexes are \"null safe\", meaning they can index columns which include "
+"null values. Secondly, GiST indexes support the concept of \"lossiness\" "
+"which is important when dealing with GIS objects larger than the PostgreSQL "
+"8K page size. Lossiness allows PostgreSQL to store only the \"important\" "
+"part of an object in an index -- in the case of GIS objects, just the "
+"bounding box. GIS objects larger than 8K will cause R-Tree indexes to fail "
+"in the process of being built."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:2048
+#, no-c-format
+msgid "Using Indexes"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2050
+#, no-c-format
+msgid ""
+"Ordinarily, indexes invisibly speed up data access: once the index is built, "
+"the query planner transparently decides when to use index information to "
+"speed up a query plan. Unfortunately, the PostgreSQL query planner does not "
+"optimize the use of GiST indexes well, so sometimes searches which should "
+"use a spatial index instead default to a sequence scan of the whole table."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2057
+#, no-c-format
+msgid ""
+"If you find your spatial indexes are not being used (or your attribute "
+"indexes, for that matter) there are a couple things you can do:"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2063
+#, no-c-format
+msgid ""
+"Firstly, make sure statistics are gathered about the number and "
+"distributions of values in a table, to provide the query planner with better "
+"information to make decisions around index usage. For PostgreSQL 7.4 "
+"installations and below this is done by running "
+"<command>update_geometry_stats([table_name, column_name])</command> (compute "
+"distribution) and <command>VACUUM ANALYZE [table_name] [column_name]</"
+"command> (compute number of values). Starting with PostgreSQL 8.0 running "
+"<command>VACUUM ANALYZE</command> will do both operations. You should "
+"regularly vacuum your databases anyways -- many PostgreSQL DBAs have "
+"<command>VACUUM</command> run as an off-peak cron job on a regular basis."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2077
+#, no-c-format
+msgid ""
+"If vacuuming does not work, you can force the planner to use the index "
+"information by using the <command>SET ENABLE_SEQSCAN=OFF</command> command. "
+"You should only use this command sparingly, and only on spatially indexed "
+"queries: generally speaking, the planner knows better than you do about when "
+"to use normal B-Tree indexes. Once you have run your query, you should "
+"consider setting <varname>ENABLE_SEQSCAN</varname> back on, so that other "
+"queries will utilize the planner as normal."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2087
+#, no-c-format
+msgid ""
+"As of version 0.6, it should not be necessary to force the planner to use "
+"the index with <varname>ENABLE_SEQSCAN</varname>."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2094
+#, no-c-format
+msgid ""
+"If you find the planner wrong about the cost of sequential vs index scans "
+"try reducing the value of random_page_cost in postgresql.conf or using SET "
+"random_page_cost=#. Default value for the parameter is 4, try setting it to "
+"1 or 2. Decrementing the value makes the planner more inclined of using "
+"Index scans."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:2105
+#, no-c-format
+msgid "Complex Queries"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2107
+#, no-c-format
+msgid ""
+"The <emphasis>raison d'etre</emphasis> of spatial database functionality is "
+"performing queries inside the database which would ordinarily require "
+"desktop GIS functionality. Using PostGIS effectively requires knowing what "
+"spatial functions are available, and ensuring that appropriate indexes are "
+"in place to provide good performance. The SRID of 312 used in these examples "
+"is purely for demonstration. You should be using a REAL SRID listed in the "
+"the spatial_ref_sys table and one that matches the projection of your data. "
+"If your data has no spatial reference system specified, you should be "
+"THINKING very thoughtfully why it doesn't and maybe it should. If your "
+"reason is because you are modeling something that doesn't have a geographic "
+"spatial reference system defined such as the internals of a molecule or a "
+"good location on Mars to transport the human race in the event of a nuclear "
+"holocaust, then simply leave out the SRID or make one up and insert it in "
+"the <varname>spatial_ref_sys</varname> table."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:2121
+#, no-c-format
+msgid "Taking Advantage of Indexes"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2123
+#, no-c-format
+msgid ""
+"When constructing a query it is important to remember that only the bounding-"
+"box-based operators such as && can take advantage of the GiST "
+"spatial index. Functions such as <varname>ST_Distance()</varname> cannot use "
+"the index to optimize their operation. For example, the following query "
+"would be quite slow on a large table:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2130
+#, no-c-format
+msgid ""
+"SELECT the_geom\n"
+"FROM geom_table\n"
+"WHERE ST_Distance(the_geom, ST_GeomFromText('POINT(100000 200000)', 312)) "
+"< 100"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2132
+#, no-c-format
+msgid ""
+"This query is selecting all the geometries in geom_table which are within "
+"100 units of the point (100000, 200000). It will be slow because it is "
+"calculating the distance between each point in the table and our specified "
+"point, ie. one <varname>ST_Distance()</varname> calculation for each row in "
+"the table. We can avoid this by using the && operator to reduce the "
+"number of distance calculations required:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2139
+#, no-c-format
+msgid ""
+"SELECT the_geom\n"
+"FROM geom_table\n"
+"WHERE ST_DWithin(the_geom, ST_MakeEnvelope(90900, 190900, 100100, "
+"200100,312), 100)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2141
+#, no-c-format
+msgid ""
+"This query selects the same geometries, but it does it in a more efficient "
+"way. Assuming there is a GiST index on the_geom, the query planner will "
+"recognize that it can use the index to reduce the number of rows before "
+"calculating the result of the <varname>ST_distance()</varname> function. "
+"Notice that the <varname>ST_MakeEnvelope</varname> geometry which is used in "
+"the && operation is a 200 unit square box centered on the original "
+"point - this is our \"query box\". The && operator uses the index to "
+"quickly reduce the result set down to only those geometries which have "
+"bounding boxes that overlap the \"query box\". Assuming that our query box "
+"is much smaller than the extents of the entire geometry table, this will "
+"drastically reduce the number of distance calculations that need to be done."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:2155
+#, no-c-format
+msgid "Change in Behavior"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2157
+#, no-c-format
+msgid ""
+"As of PostGIS 1.3.0, most of the Geometry Relationship Functions, with the "
+"notable exceptions of ST_Disjoint and ST_Relate, include implicit bounding "
+"box overlap operators."
+msgstr ""
+
+#. Tag: title
+#: using_postgis_dataman.xml:2164
+#, no-c-format
+msgid "Examples of Spatial SQL"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2166
+#, no-c-format
+msgid ""
+"The examples in this section will make use of two tables, a table of linear "
+"roads, and a table of polygonal municipality boundaries. The table "
+"definitions for the <varname>bc_roads</varname> table is:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2170
+#, no-c-format
+msgid ""
+"Column | Type | Description\n"
+"------------+-------------------+-------------------\n"
+"gid | integer | Unique ID\n"
+"name | character varying | Road Name\n"
+"the_geom | geometry | Location Geometry (Linestring)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2172
+#, no-c-format
+msgid ""
+"The table definition for the <varname>bc_municipality</varname> table is:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2175
+#, no-c-format
+msgid ""
+"Column | Type | Description\n"
+"-----------+-------------------+-------------------\n"
+"gid | integer | Unique ID\n"
+"code | integer | Unique ID\n"
+"name | character varying | City / Town Name\n"
+"the_geom | geometry | Location Geometry (Polygon)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2180
+#, no-c-format
+msgid "What is the total length of all roads, expressed in kilometers?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2185
+#, no-c-format
+msgid "You can answer this question with a very simple piece of SQL:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2188
+#, no-c-format
+msgid ""
+"SELECT sum(ST_Length(the_geom))/1000 AS km_roads FROM bc_roads;\n"
+"\n"
+"km_roads\n"
+"------------------\n"
+"70842.1243039643\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2194
+#, no-c-format
+msgid "How large is the city of Prince George, in hectares?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2198
+#, no-c-format
+msgid ""
+"This query combines an attribute condition (on the municipality name) with a "
+"spatial calculation (of the area):"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2202
+#, no-c-format
+msgid ""
+"SELECT\n"
+" ST_Area(the_geom)/10000 AS hectares\n"
+"FROM bc_municipality\n"
+"WHERE name = 'PRINCE GEORGE';\n"
+"\n"
+"hectares\n"
+"------------------\n"
+"32657.9103824927\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2208
+#, no-c-format
+msgid "What is the largest municipality in the province, by area?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2213
+#, no-c-format
+msgid ""
+"This query brings a spatial measurement into the query condition. There are "
+"several ways of approaching this problem, but the most efficient is below:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2217
+#, no-c-format
+msgid ""
+"SELECT\n"
+" name,\n"
+" ST_Area(the_geom)/10000 AS hectares\n"
+"FROM\n"
+" bc_municipality\n"
+"ORDER BY hectares DESC\n"
+"LIMIT 1;\n"
+"\n"
+"name | hectares\n"
+"---------------+-----------------\n"
+"TUMBLER RIDGE | 155020.02556131\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2219
+#, no-c-format
+msgid ""
+"Note that in order to answer this query we have to calculate the area of "
+"every polygon. If we were doing this a lot it would make sense to add an "
+"area column to the table that we could separately index for performance. By "
+"ordering the results in a descending direction, and them using the "
+"PostgreSQL \"LIMIT\" command we can easily pick off the largest value "
+"without using an aggregate function like max()."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2231
+#, no-c-format
+msgid "What is the length of roads fully contained within each municipality?"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2236
+#, no-c-format
+msgid ""
+"This is an example of a \"spatial join\", because we are bringing together "
+"data from two tables (doing a join) but using a spatial interaction "
+"condition (\"contained\") as the join condition rather than the usual "
+"relational approach of joining on a common key:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2242
+#, no-c-format
+msgid ""
+"SELECT\n"
+" m.name,\n"
+" sum(ST_Length(r.the_geom))/1000 as roads_km\n"
+"FROM\n"
+" bc_roads AS r,\n"
+" bc_municipality AS m\n"
+"WHERE\n"
+" ST_Contains(m.the_geom,r.the_geom)\n"
+"GROUP BY m.name\n"
+"ORDER BY roads_km;\n"
+"\n"
+"name | roads_km\n"
+"----------------------------+------------------\n"
+"SURREY | 1539.47553551242\n"
+"VANCOUVER | 1450.33093486576\n"
+"LANGLEY DISTRICT | 833.793392535662\n"
+"BURNABY | 773.769091404338\n"
+"PRINCE GEORGE | 694.37554369147\n"
+"..."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2244
+#, no-c-format
+msgid ""
+"This query takes a while, because every road in the table is summarized into "
+"the final result (about 250K roads for our particular example table). For "
+"smaller overlays (several thousand records on several hundred) the response "
+"can be very fast."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2253
+#, no-c-format
+msgid "Create a new table with all the roads within the city of Prince George."
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2258
+#, no-c-format
+msgid ""
+"This is an example of an \"overlay\", which takes in two tables and outputs "
+"a new table that consists of spatially clipped or cut resultants. Unlike the "
+"\"spatial join\" demonstrated above, this query actually creates new "
+"geometries. An overlay is like a turbo-charged spatial join, and is useful "
+"for more exact analysis work:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2265
+#, no-c-format
+msgid ""
+"CREATE TABLE pg_roads as\n"
+"SELECT\n"
+" ST_Intersection(r.the_geom, m.the_geom) AS intersection_geom,\n"
+" ST_Length(r.the_geom) AS rd_orig_length,\n"
+" r.*\n"
+"FROM\n"
+" bc_roads AS r,\n"
+" bc_municipality AS m\n"
+"WHERE m.name = 'PRINCE GEORGE' AND ST_Intersects(r.the_geom, m.the_geom);"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2271
+#, no-c-format
+msgid "What is the length in kilometers of \"Douglas St\" in Victoria?"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2276
+#, no-c-format
+msgid ""
+"SELECT\n"
+" sum(ST_Length(r.the_geom))/1000 AS kilometers\n"
+"FROM\n"
+" bc_roads r,\n"
+" bc_municipality m\n"
+"WHERE r.name = 'Douglas St' AND m.name = 'VICTORIA'\n"
+" AND ST_Contains(m.the_geom, r.the_geom) ;\n"
+"\n"
+"kilometers\n"
+"------------------\n"
+"4.89151904172838\n"
+"(1 row)"
+msgstr ""
+
+#. Tag: para
+#: using_postgis_dataman.xml:2282
+#, no-c-format
+msgid "What is the largest municipality polygon that has a hole?"
+msgstr ""
+
+#. Tag: programlisting
+#: using_postgis_dataman.xml:2287
+#, no-c-format
+msgid ""
+"SELECT gid, name, ST_Area(the_geom) AS area\n"
+"FROM bc_municipality\n"
+"WHERE ST_NRings(the_geom) > 1\n"
+"ORDER BY area DESC LIMIT 1;\n"
+"\n"
+"gid | name | area\n"
+"-----+--------------+------------------\n"
+"12 | SPALLUMCHEEN | 257374619.430216\n"
+"(1 row)"
+msgstr ""
--- /dev/null
+# SOME DESCRIPTIVE TITLE.
+#
+# Translators:
+# wotankeld <arek.matoszka@gmail.com>, 2013-2014
+msgid ""
+msgstr ""
+"Project-Id-Version: PostGIS\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2012-09-14 17:50+0000\n"
+"PO-Revision-Date: 2014-01-21 10:49+0000\n"
+"Last-Translator: wotankeld <arek.matoszka@gmail.com>\n"
+"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/"
+"language/pl/)\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2);\n"
+
+#. Tag: title
+#: using_raster_dataman.xml:3
+#, no-c-format
+msgid "Raster Data Management, Queries, and Applications"
+msgstr "Zarządzanie danymi rastrowymi, kwerendy i aplikacje"
+
+#. Tag: title
+#: using_raster_dataman.xml:5
+#, no-c-format
+msgid "Loading and Creating Rasters"
+msgstr "Wczytywanie i tworzenie rastrów"
+
+#. Tag: para
+#: using_raster_dataman.xml:6
+#, no-c-format
+msgid ""
+"For most use cases, you will create PostGIS rasters by loading existing "
+"raster files using the packaged <varname>raster2pgsql</varname> raster "
+"loader."
+msgstr ""
+"W większości przypadków tworzenie rastrów w PostGIS będzie odbywa się "
+"poprzez wczytywanie istniejących plików rastrowych używając pakietu "
+"<varname>raster2pgsql</varname>."
+
+#. Tag: title
+#: using_raster_dataman.xml:9
+#, no-c-format
+msgid "Using raster2pgsql to load rasters"
+msgstr "Wykorzystanie raster2pgsql do wczytywania plików rastrowych."
+
+#. Tag: para
+#: using_raster_dataman.xml:10
+#, no-c-format
+msgid ""
+"The <varname>raster2pgsql</varname> is a raster loader executable that loads "
+"GDAL supported raster formats into sql suitable for loading into a PostGIS "
+"raster table. It is capable of loading folders of raster files as well as "
+"creating overviews of rasters."
+msgstr ""
+"<varname>raster2pgsql</varname> jest programem wykonywalnym, które wczytuje "
+"pliki rastrowe obsługiwane przez GDAL jako sql dostosowany do ładowania "
+"danych do tabeli rastrów PostGIS. Program potrafi zarówno wczytywać foldery "
+"plików rastrowych jak i tworzyć przegląd rastrów."
+
+#. Tag: para
+#: using_raster_dataman.xml:13
+#, no-c-format
+msgid ""
+"Since the raster2pgsql is compiled as part of PostGIS most often (unless you "
+"compile your own GDAL library), the raster types supported by the executable "
+"will be the same as those compiled in the GDAL dependency library. To get a "
+"list of raster types your particular raster2pgsql supports use the <varname>-"
+"G</varname> switch. These should be the same as those provided by your "
+"PostGIS install documented here <xref linkend=\"RT_ST_GDALDrivers\"/> if you "
+"are using the same gdal library for both."
+msgstr ""
+"Ponieważ raster2pgsql jest kompilowany najczęściej jako część PostGIS (z "
+"wyłączeniem sytuacji, kiedy użytkownik sam kompiluje bibliotekę GDAL), "
+"obsługiwane przez niego formaty rastrów będą zgodne zależną biblioteką GDAL. "
+"Aby uzyskać listę obsługiwanych formatów należy użyć opcji <varname>-G</"
+"varname>. Lista obsługiwanych formatów, zakładając, że w obu przypadkach "
+"używana jest ta sama wersja biblioteki GDAL, powinna być zgodna z "
+"dokumentacją PostGIS dostępną tutaj <xref linkend=\"RT_ST_GDALDrivers\"/>."
+
+#. Tag: para
+#: using_raster_dataman.xml:16
+#, no-c-format
+msgid ""
+"The older version of this tool was a python script. The executable has "
+"replaced the python script. If you still find the need for the Python script "
+"Examples of the python one can be found at <ulink url=\"http://trac.osgeo."
+"org/gdal/wiki/frmts_wtkraster.html\">GDAL PostGIS Raster Driver Usage</"
+"ulink>. Please note that the raster2pgsql python script may not work with "
+"future versions of PostGIS raster and is no longer supported."
+msgstr ""
+"Poprzednie wersje narzędzia były stworzone jako skrypty w języku python. "
+"Obecnie pliki wykonywalne zastąpiły te skrypty. Jeżeli nadal potrzebujesz "
+"przykładów skryptów wykorzystujących starą wersję narzędzie, możesz je "
+"znaleźć w <ulink url=\"http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html"
+"\">GDAL PostGIS Raster Driver Usage</ulink>. Proszę jednak zwrócić uwagę, na "
+"fakt, iż raster2pgsql w wersji python może nie działać w kolejnych wersjach "
+"PostGIS i nie jest będzie dłużej wspierany."
+
+#. Tag: para
+#: using_raster_dataman.xml:21
+#, no-c-format
+msgid ""
+"When creating overviews of a specific factor from a set of rasters that are "
+"aligned, it is possible for the overviews to not align. Visit <ulink url="
+"\"http://trac.osgeo.org/postgis/ticket/1764\">http://trac.osgeo.org/postgis/"
+"ticket/1764</ulink> for an example where the overviews do not align."
+msgstr ""
+"Tworząc podglądy rastrów dla zbioru przylegających do siebie rastrów, przy "
+"określonym współczyniku, możliwym jest, że podglądy rastrów nie będą do "
+"siebie przylegać. Odwiedź <ulink url=\"http://trac.osgeo.org/postgis/"
+"ticket/1764\">http://trac.osgeo.org/postgis/ticket/1764</ulink> aby zobaczyć "
+"przykład, w którym podglądy nie przylegają do siebie."
+
+#. Tag: para
+#: using_raster_dataman.xml:25
+#, no-c-format
+msgid "EXAMPLE USAGE:"
+msgstr "Przykłady użycia:"
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:26
+#, no-c-format
+msgid ""
+"raster2pgsql <varname>raster_options_go_here</varname> <varname>raster_file</"
+"varname> <varname>someschema</varname>.<varname>sometable</varname> > out."
+"sql"
+msgstr ""
+"raster2pgsql <varname>opcje</varname> <varname>plik_rastra</varname> "
+"<varname>nazwa_schematu</varname>.<varname>nazwa_tabeli</varname> > out."
+"sql"
+
+#. Tag: term
+#: using_raster_dataman.xml:30
+#, no-c-format
+msgid "<term>-?</term>"
+msgstr "<term>-?</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:32
+#, no-c-format
+msgid ""
+"Display help screen. Help will also display if you don't pass in any "
+"arguments."
+msgstr ""
+"Wyświetla ekran pomocy. Pomoc zostanie wyświetlona również w sytuacji gdy "
+"nie zostanie podany żaden argument."
+
+#. Tag: term
+#: using_raster_dataman.xml:39
+#, no-c-format
+msgid "<term>-G</term>"
+msgstr "<term>-G</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:41
+#, no-c-format
+msgid "Print the supported raster formats."
+msgstr "Wyświetla na ekranie listę wspieranych formatów rastrowych."
+
+#. Tag: term
+#: using_raster_dataman.xml:48
+#, no-c-format
+msgid "(c|a|d|p) These are mutually exclusive options:"
+msgstr "(c|a|d|p) Są opcjami wzajemnie wykluczającymi się:"
+
+#. Tag: term
+#: using_raster_dataman.xml:53
+#, no-c-format
+msgid "<term>-c</term>"
+msgstr "<term>-c</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:55
+#, no-c-format
+msgid ""
+"Create new table and populate it with raster(s), <emphasis>this is the "
+"default mode</emphasis>"
+msgstr ""
+"Tworzy nową tabelę i wypełnia ją rastrem (rastrami), <emphasis>jest to tryb "
+"domyślny</emphasis>"
+
+#. Tag: term
+#: using_raster_dataman.xml:62
+#, no-c-format
+msgid "<term>-a</term>"
+msgstr "<term>-a</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:64
+#, no-c-format
+msgid "Append raster(s) to an existing table."
+msgstr "Dopisuje raster (rastry) do istniejącej tabeli."
+
+#. Tag: term
+#: using_raster_dataman.xml:71
+#, no-c-format
+msgid "<term>-d</term>"
+msgstr "<term>-d</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:73
+#, no-c-format
+msgid "Drop table, create new one and populate it with raster(s)"
+msgstr "Usuwa istniejącą tabelę, tworzy nową i wypełnia ją rastrem (rastrami)"
+
+#. Tag: term
+#: using_raster_dataman.xml:80
+#, no-c-format
+msgid "<term>-p</term>"
+msgstr "<term>-p</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:82
+#, no-c-format
+msgid "Prepare mode, only create the table."
+msgstr "Tryb przygotowania, tworzy tabelę."
+
+#. Tag: term
+#: using_raster_dataman.xml:93
+#, no-c-format
+msgid ""
+"Raster processing: Applying constraints for proper registering in raster "
+"catalogs"
+msgstr ""
+"Przetwarzanie rastrów: Stosowanie ograniczeń w celu poprawnej rejestracji w "
+"katalogach rastrów"
+
+#. Tag: term
+#: using_raster_dataman.xml:98
+#, no-c-format
+msgid "<term>-C</term>"
+msgstr "<term>-C</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:100
+#, no-c-format
+msgid ""
+"Apply raster constraints -- srid, pixelsize etc. to ensure raster is "
+"properly registered in <varname>raster_columns</varname> view."
+msgstr ""
+"Użyj ograniczenia -- srid, rozmiar_piksela itd. aby zapewnić poprawną "
+"rejestrację rastra w widoku <varname>raster_columns</varname>."
+
+#. Tag: term
+#: using_raster_dataman.xml:106
+#, no-c-format
+msgid "<term>-x</term>"
+msgstr "<term>-x</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:108
+#, no-c-format
+msgid ""
+"Disable setting the max extent constraint. Only applied if -C flag is also "
+"used."
+msgstr ""
+"Wyłącza ustawienie ograniczenia maksymalnego zakresu przestrzennego. Używane "
+"wyłącznie jeżeli użyto też flagi -C."
+
+#. Tag: term
+#: using_raster_dataman.xml:114
+#, no-c-format
+msgid "<term>-r</term>"
+msgstr "<term>-r</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:116
+#, no-c-format
+msgid ""
+"Set the regular blocking constraint. Only applied if -C flag is also used."
+msgstr ""
+
+#. Tag: term
+#: using_raster_dataman.xml:127
+#, no-c-format
+msgid ""
+"Raster processing: Optional parameters used to manipulate input raster "
+"dataset"
+msgstr ""
+"Przetwarzanie rastrów: Opcjonalne parametry stosowane do manipulowania "
+"rastrowymi danymi wejściowymi."
+
+#. Tag: term
+#: using_raster_dataman.xml:132
+#, no-c-format
+msgid "-s <SRID>"
+msgstr "-s <SRID>"
+
+#. Tag: para
+#: using_raster_dataman.xml:134
+#, no-c-format
+msgid ""
+"Assign output raster with specified SRID. If not provided or is zero, "
+"raster's metadata will be checked to determine an appropriate SRID."
+msgstr ""
+"Przypisuje rastrowi wynikowemu określony SRID. Jeżeli wartość nie podana "
+"albo równa 0, metadane rastra zostaną sprawdzone w celu ustalenia "
+"odpowiedniego SRID."
+
+#. Tag: term
+#: using_raster_dataman.xml:141
+#, no-c-format
+msgid "-b BAND"
+msgstr "-b ZAKRES"
+
+#. Tag: para
+#: using_raster_dataman.xml:143
+#, no-c-format
+msgid ""
+"Index (1-based) of band to extract from raster. For more than one band "
+"index, separate with comma (,). If unspecified, all bands of raster will be "
+"extracted."
+msgstr ""
+"Indeks (numerowany od 1) zakresu, który będzie wydobyty z rastra. Dla więcej "
+"niż jednego zakresu należy numery rozdzielić przecinkiem (,). Jeżeli wartość "
+"nie podana użyte będą wszystkie zakresy rastra."
+
+#. Tag: term
+#: using_raster_dataman.xml:151
+#, no-c-format
+msgid "-t TILE_SIZE"
+msgstr "-t ROZMIAR_KAFLA"
+
+#. Tag: para
+#: using_raster_dataman.xml:153
+#, no-c-format
+msgid ""
+"Cut raster into tiles to be inserted one per table row. <varname>TILE_SIZE</"
+"varname> is expressed as WIDTHxHEIGHT."
+msgstr ""
+"Dzieli raster na kafle celem ładowania ich pojedynczo jako wiersze w tabeli. "
+"<varname>ROZMIAR_KAFLA</varname> jest wyrażony jako SZEROKOŚĆxWYSOKOŚĆ."
+
+#. Tag: term
+#: using_raster_dataman.xml:160
+#, no-c-format
+msgid "-R, --register"
+msgstr "-R, --register"
+
+#. Tag: para
+#: using_raster_dataman.xml:162
+#, no-c-format
+msgid "Register the raster as a filesystem (out-db) raster."
+msgstr "Rejestruje raster jako raster w systemie plikowym (out-db)."
+
+#. Tag: para
+#: using_raster_dataman.xml:163
+#, no-c-format
+msgid ""
+"Only the metadata of the raster and path location to the raster is stored in "
+"the database (not the pixels)."
+msgstr ""
+"Jedynie metadane i ścieżka dostępu do pliku rastrowego są przechowywane w "
+"bazie danych (nie wartości pikseli)."
+
+#. Tag: term
+#: using_raster_dataman.xml:168
+#, no-c-format
+msgid "-l <varname>OVERVIEW_FACTOR</varname>"
+msgstr "-l <varname>WSPÓŁCZYNNIK</varname>"
+
+#. Tag: para
+#: using_raster_dataman.xml:169
+#, no-c-format
+msgid ""
+"Create overview of the raster. For more than one factor, separate with "
+"comma(,). Overview table name follows the pattern o_<varname>overview "
+"factor</varname>_<varname>table</varname>. Created overview is stored in the "
+"database and is not affected by -R. Note that your generated sql file will "
+"contain both the main table and overview tables."
+msgstr ""
+"Tworzy przegląd rastra. W przypadku więcej niż jednego współczynnika, należy "
+"je rozdzielić przecinkiem (,). Nazwa tabeli przeglądu jest tworzona zgodnie "
+"ze wzorcem: o_<varname>WSPÓŁCZYNNIK</varname>_<varname>tabela</varname>. "
+"Utworzony przegląd jest przechowywany w bazie danych i nie jest podatny na "
+"flagę -R. Należy zauważyć, że wygenerowany plik sql będzie zawierała zarówno "
+"główną tabelę, jak i tabele przeglądów."
+
+#. Tag: term
+#: using_raster_dataman.xml:177
+#, no-c-format
+msgid "-N <varname>NODATA</varname>"
+msgstr "-N <varname>NODATA</varname>"
+
+#. Tag: para
+#: using_raster_dataman.xml:179
+#, no-c-format
+msgid "NODATA value to use on bands without a NODATA value."
+msgstr "NODATA wartość, która zostanie użyta dla zakresów bez wartości NODATA."
+
+#. Tag: term
+#: using_raster_dataman.xml:191
+#, no-c-format
+msgid "Optional parameters used to manipulate database objects"
+msgstr "Opcjonalne parametru używane do manipulacji obiektami bazodanowymi."
+
+#. Tag: term
+#: using_raster_dataman.xml:196
+#, no-c-format
+msgid "<term>-q</term>"
+msgstr "<term>-q</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:198
+#, no-c-format
+msgid "Wrap PostgreSQL identifiers in quotes"
+msgstr "Opakowuje identyfikatory PostgreSQL w cudzysłowy"
+
+#. Tag: term
+#: using_raster_dataman.xml:203
+#, no-c-format
+msgid "-f COLUMN"
+msgstr "-f KOLMUNA"
+
+#. Tag: para
+#: using_raster_dataman.xml:205
+#, no-c-format
+msgid "Specify name of destination raster column, default is 'rast'"
+msgstr ""
+"Określa nazwę docelowej kolumny rastrowej, domyślnie przyjmuje wartość 'rast'"
+
+#. Tag: term
+#: using_raster_dataman.xml:211
+#, no-c-format
+msgid "<term>-F</term>"
+msgstr "<term>-F</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:213
+#, no-c-format
+msgid "Add a column with the name of the file"
+msgstr "Dodaje kolumnę z nazwą pliku"
+
+#. Tag: term
+#: using_raster_dataman.xml:218
+#, no-c-format
+msgid "<term>-I</term>"
+msgstr "<term>-I</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:220
+#, no-c-format
+msgid "Create a GiST index on the raster column."
+msgstr "Tworzy indeks GiST na kolumnie rastrowej."
+
+#. Tag: term
+#: using_raster_dataman.xml:227
+#, no-c-format
+msgid "<term>-M</term>"
+msgstr "<term>-M</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:229
+#, no-c-format
+msgid "Vacuum analyze the raster table."
+msgstr "Wykonuje VACUUM i ANALYZE na tabeli rastrowej."
+
+#. Tag: term
+#: using_raster_dataman.xml:236
+#, no-c-format
+msgid "-T <varname>tablespace</varname>"
+msgstr "-T <varname>przestrzeń_tabel</varname>"
+
+#. Tag: para
+#: using_raster_dataman.xml:238
+#, no-c-format
+msgid ""
+"Specify the tablespace for the new table. Note that indices (including the "
+"primary key) will still use the default tablespace unless the -X flag is "
+"also used."
+msgstr ""
+"Określa przestrzeń tabel dla tworzonej tabeli. Należy zauważyć, że indeksy "
+"(włączając klucz główny) w dalszym ciągu będą używały domyślnej przestrzeni "
+"tabel, chyba że użyta zostanie dodatkowo flaga -X."
+
+#. Tag: term
+#: using_raster_dataman.xml:247
+#, no-c-format
+msgid "-X <varname>tablespace</varname>"
+msgstr "-X <varname>przestrzeń_tabel</varname>"
+
+#. Tag: para
+#: using_raster_dataman.xml:249
+#, no-c-format
+msgid ""
+"Specify the tablespace for the table's new index. This applies to the "
+"primary key and the spatial index if the -I flag is used."
+msgstr ""
+"Określa przestrzeń tabel dla tworzonych indeksów. Dotyczy klucza głównego "
+"oraz, jeśli użyto flagi -I, indeksu przestrzennego."
+
+#. Tag: term
+#: using_raster_dataman.xml:258
+#, no-c-format
+msgid "<term>-Y</term>"
+msgstr "<term>-Y</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:260
+#, no-c-format
+msgid "Use copy statements instead of insert statements."
+msgstr "Używa instrukcji copy zamiast instrukcji insert."
+
+#. Tag: term
+#: using_raster_dataman.xml:271
+#, no-c-format
+msgid "<term>-e</term>"
+msgstr "<term>-e</term>"
+
+#. Tag: para
+#: using_raster_dataman.xml:272
+#, no-c-format
+msgid "Execute each statement individually, do not use a transaction."
+msgstr "Wykonuje każdą instrukcję osobno, nie korzystając z transakcji."
+
+#. Tag: term
+#: using_raster_dataman.xml:276
+#, no-c-format
+msgid "-E ENDIAN"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:277
+#, no-c-format
+msgid ""
+"Control endianness of generated binary output of raster; specify 0 for XDR "
+"and 1 for NDR (default); only NDR output is supported now"
+msgstr ""
+
+#. Tag: term
+#: using_raster_dataman.xml:281
+#, no-c-format
+msgid "-V <varname>version</varname>"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:282
+#, no-c-format
+msgid ""
+"Specify version of output format. Default is 0. Only 0 is supported at this "
+"time."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:285
+#, no-c-format
+msgid ""
+"An example session using the loader to create an input file and uploading it "
+"chunked in 100x100 tiles might look like this:"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:286
+#, no-c-format
+msgid ""
+"You can leave the schema name out e.g <varname>demelevation</varname> "
+"instead of <varname>public.demelevation</varname> and the raster table will "
+"be created in the default schema of the database or user"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:288
+#, no-c-format
+msgid ""
+"raster2pgsql -s 4236 -I -C -M *.tif -F -t 100x100 public.demelevation > elev."
+"sql\n"
+"psql -d gisdb -f elev.sql"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:290
+#, no-c-format
+msgid "A conversion and upload can be done all in one step using UNIX pipes:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:292
+#, no-c-format
+msgid ""
+"raster2pgsql -s 4236 -I -C -M *.tif -F -t 100x100 public.demelevation | psql "
+"-d gisdb"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:294
+#, no-c-format
+msgid ""
+"Load rasters Massachusetts state plane meters aerial tiles into a schema "
+"called <varname>aerial</varname> and create a full view, 2 and 4 level "
+"overview tables, use copy mode for inserting (no intermediary file just "
+"straight to db), and -e don't force everything in a transaction (good if you "
+"want to see data in tables right away without waiting). Break up the rasters "
+"into 128x128 pixel tiles and apply raster constraints. Use copy mode instead "
+"of table insert. (-F) Include a field called filename to hold the name of "
+"the file the tiles were cut from."
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:296
+#, no-c-format
+msgid ""
+"raster2pgsql -I -C -e -Y -F -s 26986 -t 128x128 -l 2,4 bostonaerials2008/*."
+"jpg aerials.boston | psql -U postgres -d gisdb -h localhost -p 5432"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:298
+#, no-c-format
+msgid ""
+"--get a list of raster types supported:\n"
+"raster2pgsql -G"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:300
+#, no-c-format
+msgid "The -G commands outputs a list something like"
+msgstr ""
+
+#. Tag: screen
+#: using_raster_dataman.xml:301
+#, no-c-format
+msgid ""
+"Available GDAL raster formats:\n"
+" Virtual Raster\n"
+" GeoTIFF\n"
+" National Imagery Transmission Format\n"
+" Raster Product Format TOC format\n"
+" ECRG TOC format\n"
+" Erdas Imagine Images (.img)\n"
+" CEOS SAR Image\n"
+" CEOS Image\n"
+" JAXA PALSAR Product Reader (Level 1.1/1.5)\n"
+" Ground-based SAR Applications Testbed File Format (.gff)\n"
+" ELAS\n"
+" Arc/Info Binary Grid\n"
+" Arc/Info ASCII Grid\n"
+" GRASS ASCII Grid\n"
+" SDTS Raster\n"
+" DTED Elevation Raster\n"
+" Portable Network Graphics\n"
+" JPEG JFIF\n"
+" In Memory Raster\n"
+" Japanese DEM (.mem)\n"
+" Graphics Interchange Format (.gif)\n"
+" Graphics Interchange Format (.gif)\n"
+" Envisat Image Format\n"
+" Maptech BSB Nautical Charts\n"
+" X11 PixMap Format\n"
+" MS Windows Device Independent Bitmap\n"
+" SPOT DIMAP\n"
+" AirSAR Polarimetric Image\n"
+" RadarSat 2 XML Product\n"
+" PCIDSK Database File\n"
+" PCRaster Raster File\n"
+" ILWIS Raster Map\n"
+" SGI Image File Format 1.0\n"
+" SRTMHGT File Format\n"
+" Leveller heightfield\n"
+" Terragen heightfield\n"
+" USGS Astrogeology ISIS cube (Version 3)\n"
+" USGS Astrogeology ISIS cube (Version 2)\n"
+" NASA Planetary Data System\n"
+" EarthWatch .TIL\n"
+" ERMapper .ers Labelled\n"
+" NOAA Polar Orbiter Level 1b Data Set\n"
+" FIT Image\n"
+" GRIdded Binary (.grb)\n"
+" Raster Matrix Format\n"
+" EUMETSAT Archive native (.nat)\n"
+" Idrisi Raster A.1\n"
+" Intergraph Raster\n"
+" Golden Software ASCII Grid (.grd)\n"
+" Golden Software Binary Grid (.grd)\n"
+" Golden Software 7 Binary Grid (.grd)\n"
+" COSAR Annotated Binary Matrix (TerraSAR-X)\n"
+" TerraSAR-X Product\n"
+" DRDC COASP SAR Processor Raster\n"
+" R Object Data Store\n"
+" Portable Pixmap Format (netpbm)\n"
+" USGS DOQ (Old Style)\n"
+" USGS DOQ (New Style)\n"
+" ENVI .hdr Labelled\n"
+" ESRI .hdr Labelled\n"
+" Generic Binary (.hdr Labelled)\n"
+" PCI .aux Labelled\n"
+" Vexcel MFF Raster\n"
+" Vexcel MFF2 (HKV) Raster\n"
+" Fuji BAS Scanner Image\n"
+" GSC Geogrid\n"
+" EOSAT FAST Format\n"
+" VTP .bt (Binary Terrain) 1.3 Format\n"
+" Erdas .LAN/.GIS\n"
+" Convair PolGASP\n"
+" Image Data and Analysis\n"
+" NLAPS Data Format\n"
+" Erdas Imagine Raw\n"
+" DIPEx\n"
+" FARSITE v.4 Landscape File (.lcp)\n"
+" NOAA Vertical Datum .GTX\n"
+" NADCON .los/.las Datum Grid Shift\n"
+" NTv2 Datum Grid Shift\n"
+" ACE2\n"
+" Snow Data Assimilation System\n"
+" Swedish Grid RIK (.rik)\n"
+" USGS Optional ASCII DEM (and CDED)\n"
+" GeoSoft Grid Exchange Format\n"
+" Northwood Numeric Grid Format .grd/.tab\n"
+" Northwood Classified Grid Format .grc/.tab\n"
+" ARC Digitized Raster Graphics\n"
+" Standard Raster Product (ASRP/USRP)\n"
+" Magellan topo (.blx)\n"
+" SAGA GIS Binary Grid (.sdat)\n"
+" Kml Super Overlay\n"
+" ASCII Gridded XYZ\n"
+" HF2/HFZ heightfield raster\n"
+" OziExplorer Image File\n"
+" USGS LULC Composite Theme Grid\n"
+" Arc/Info Export E00 GRID\n"
+" ZMap Plus Grid\n"
+" NOAA NGS Geoid Height Grids"
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:304
+#, no-c-format
+msgid "Creating rasters using PostGIS raster functions"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:305
+#, no-c-format
+msgid ""
+"On many occasions, you'll want to create rasters and raster tables right in "
+"the database. There are a plethora of functions to do that. The general "
+"steps to follow."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:307
+#, no-c-format
+msgid ""
+"Create a table with a raster column to hold the new raster records which can "
+"be accomplished with:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:308
+#, no-c-format
+msgid "CREATE TABLE myrasters(rid serial primary key, rast raster);"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:311
+#, no-c-format
+msgid ""
+"There are many functions to help with that goal. If you are creating rasters "
+"not as a derivative of other rasters, you will want to start with: <xref "
+"linkend=\"RT_ST_MakeEmptyRaster\"/>, followed by <xref linkend="
+"\"RT_ST_AddBand\"/>"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:313
+#, no-c-format
+msgid ""
+"You can also create rasters from geometries. To achieve that you'll want to "
+"use <xref linkend=\"RT_ST_AsRaster\"/> perhaps accompanied with other "
+"functions such as <xref linkend=\"RT_ST_Union\"/> or <xref linkend="
+"\"RT_ST_MapAlgebraFct2\"/> or any of the family of other map algebra "
+"functions."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:315
+#, no-c-format
+msgid ""
+"There are even many more options for creating new raster tables from "
+"existing tables. For example you can create a raster table in a different "
+"projection from an existing one using <xref linkend=\"RT_ST_Transform\"/>"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:317
+#, no-c-format
+msgid ""
+"Once you are done populating your table initially, you'll want to create a "
+"spatial index on the raster column with something like:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:318
+#, no-c-format
+msgid ""
+"CREATE INDEX myrasters_rast_st_convexhull_idx ON myrasters USING "
+"gist( ST_ConvexHull(rast) );"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:319
+#, no-c-format
+msgid ""
+"Note the use of <xref linkend=\"RT_ST_ConvexHull\"/> since most raster "
+"operators are based on the convex hull of the rasters."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:320
+#, no-c-format
+msgid ""
+"Pre-2.0 versions of PostGIS raster were based on the envelop rather than the "
+"convex hull. For the spatial indexes to work properly you'll need to drop "
+"those and replace with convex hull based index."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:321
+#, no-c-format
+msgid ""
+"Apply raster constraints using <xref linkend=\"RT_AddRasterConstraints\"/>"
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:326
+#, no-c-format
+msgid "Raster Catalogs"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:327
+#, no-c-format
+msgid ""
+"There are two raster catalog views that come packaged with PostGIS. Both "
+"views utilize information embedded in the constraints of the raster tables. "
+"As a result the catalog views are always consistent with the raster data in "
+"the tables since the constraints are enforced."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:331
+#, no-c-format
+msgid ""
+"<varname>raster_columns</varname> this view catalogs all the raster table "
+"columns in your database."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:334
+#, no-c-format
+msgid ""
+"<varname>raster_overviews</varname> this view catalogs all the raster table "
+"columns in your database that serve as overviews for a finer grained table. "
+"Tables of this type are generated when you use the <varname>-l</varname> "
+"switch during load."
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:338
+#, no-c-format
+msgid "Raster Columns Catalog"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:339
+#, no-c-format
+msgid ""
+"The <varname>raster_columns</varname> is a catalog of all raster table "
+"columns in your database that are of type raster. It is a view utilizing the "
+"constraints on the tables so the information is always consistent even if "
+"you restore one raster table from a backup of another database. The "
+"following columns exist in the <varname>raster_columns</varname> catalog."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:341
+#, no-c-format
+msgid ""
+"If you created your tables not with the loader or forgot to specify the "
+"<varname>-C</varname> flag during load, you can enforce the constraints "
+"after the fact using <xref linkend=\"RT_AddRasterConstraints\"/> so that the "
+"<varname>raster_columns</varname> catalog registers the common information "
+"about your raster tiles."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:346
+#, no-c-format
+msgid ""
+"<varname>r_table_catalog</varname> The database the table is in. This will "
+"always read the current database."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:349
+#, no-c-format
+msgid ""
+"<varname>r_table_schema</varname> The database schema the raster table "
+"belongs to."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:352
+#, no-c-format
+msgid "<varname>r_table_name</varname> raster table"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:355
+#, no-c-format
+msgid ""
+"<varname>r_raster_column</varname> the column in the <varname>r_table_name</"
+"varname> table that is of type raster. There is nothing in PostGIS "
+"preventing you from having multiple raster columns per table so its possible "
+"to have a raster table listed multiple times with a different raster column "
+"for each."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:358
+#, no-c-format
+msgid ""
+"<varname>srid</varname> The spatial reference identifier of the raster. "
+"Should be an entry in the <xref linkend=\"spatial_ref_sys\"/>."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:361
+#, no-c-format
+msgid ""
+"<varname>scale_x</varname> The scaling between geometric spatial coordinates "
+"and pixel. This is only available if all tiles in the raster column have the "
+"same <varname>scale_x</varname> and this constraint is applied. Refer to "
+"<xref linkend=\"RT_ST_ScaleX\"/> for more details."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:364
+#, no-c-format
+msgid ""
+"<varname>scale_y</varname> The scaling between geometric spatial coordinates "
+"and pixel. This is only available if all tiles in the raster column have the "
+"same <varname>scale_y</varname> and the <varname>scale_y</varname> "
+"constraint is applied. Refer to <xref linkend=\"RT_ST_ScaleY\"/> for more "
+"details."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:367
+#, no-c-format
+msgid ""
+"<varname>blocksize_x</varname> The width (number of pixels across) of each "
+"raster tile . Refer to <xref linkend=\"RT_ST_Width\"/> for more details."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:370
+#, no-c-format
+msgid ""
+"<varname>blocksize_y</varname> The width (number of pixels down) of each "
+"raster tile . Refer to <xref linkend=\"RT_ST_Height\"/> for more details."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:373
+#, no-c-format
+msgid ""
+"<varname>same_alignment</varname> A boolean that is true if all the raster "
+"tiles have the same alignment . Refer to <xref linkend=\"RT_ST_SameAlignment"
+"\"/> for more details."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:376
+#, no-c-format
+msgid ""
+"<varname>regular_blocking</varname> This is a true/false constraint flag set "
+"on the table to denote that the tiles do not overlap, are of the same "
+"alignment, pixel size, srid etc. It is not really validated but just taken "
+"as a given so should be used for informational. In the future we plan to "
+"properly constrain this so that this inforamtion is guaranteed to be right "
+"when it returns <varname>true</varname>"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:379
+#, no-c-format
+msgid ""
+"<varname>num_bands</varname> The number of bands in each tile of your raster "
+"set. This is the same information as what is provided by"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:382
+#, no-c-format
+msgid ""
+"<varname>pixel_types</varname> An array defining the pixel type for each "
+"band. You will have the same number of elements in this array as you have "
+"number of bands. The pixel_types are one of the following defined in <xref "
+"linkend=\"RT_ST_BandPixelType\"/>."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:385
+#, no-c-format
+msgid ""
+"<varname>nodata_values</varname> An array of double precision numbers "
+"denoting the <varname>nodata_value</varname> for each band. You will have "
+"the same number of elements in this array as you have number of bands. These "
+"numbers define the pixel value for each band that should be ignored for most "
+"operations. This is similar information provided by <xref linkend="
+"\"RT_ST_BandNoDataValue\"/>."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:388
+#, no-c-format
+msgid ""
+"<varname>extent</varname> This is the extent of all the raster rows in your "
+"raster set. If you plan to load more data that will change the extent of the "
+"set, you'll want to run the <xref linkend=\"RT_DropRasterConstraints\"/> "
+"function before load and then reapply constraints with <xref linkend="
+"\"RT_AddRasterConstraints\"/> after load."
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:393
+#, no-c-format
+msgid "Raster Overviews"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:394
+#, no-c-format
+msgid ""
+"<varname>raster_overviews</varname> catalogs information about raster table "
+"columns used for overviews and additional information about them that is "
+"useful to know when utilizing overviews. Overview tables are cataloged in "
+"both <varname>raster_columns</varname> and <varname>raster_overviews</"
+"varname> because they are rasters in their own right but also serve an "
+"additional special purpose of being a lower resolution caricature of a "
+"higher resolution table. These are generated along-side the main raster "
+"table when you use the <varname>-l</varname> switch in raster loading."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:395
+#, no-c-format
+msgid ""
+"Overview tables contain the same constraints as other raster tables as well "
+"as additional informational only constraints specific to overviews."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:396
+#, no-c-format
+msgid ""
+"The information in <varname>raster_overviews</varname> does not duplicate "
+"the information in <varname>raster_columns</varname>. If you need the "
+"information about an overview table present in <varname>raster_columns</"
+"varname> you can join the <varname>raster_overviews</varname> and "
+"<varname>raster_columns</varname> together to get the full set of "
+"information you need."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:397
+#, no-c-format
+msgid "Two main reasons for overviews are:"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:399
+#, no-c-format
+msgid ""
+"Low resolution representation of the core tables commonly used for fast "
+"mapping zoom-out."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:400
+#, no-c-format
+msgid ""
+"Computations are generally faster to do on them than their higher resolution "
+"parents because there are fewer records and each pixel covers more "
+"territory. Though the computations are not as accurate as the high-res "
+"tables they support, they can be sufficient in many rule-of-thumb "
+"computations."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:403
+#, no-c-format
+msgid ""
+"The <varname>raster_overviews</varname> catalog contains the following "
+"columns of information."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:406
+#, no-c-format
+msgid ""
+"<varname>o_table_catalog</varname> The database the overview table is in. "
+"This will always read the current database."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:409
+#, no-c-format
+msgid ""
+"<varname>o_table_schema</varname> The database schema the overview raster "
+"table belongs to."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:412
+#, no-c-format
+msgid "<varname>o_table_name</varname> raster overview table name"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:415
+#, no-c-format
+msgid ""
+"<varname>o_raster_column</varname> the raster column in the overview table."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:419
+#, no-c-format
+msgid ""
+"<varname>r_table_catalog</varname> The database the raster table that this "
+"overview services is in. This will always read the current database."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:422
+#, no-c-format
+msgid ""
+"<varname>r_table_schema</varname> The database schema the raster table that "
+"this overview services belongs to."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:425
+#, no-c-format
+msgid ""
+"<varname>r_table_name</varname> raster table that this overview services."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:428
+#, no-c-format
+msgid ""
+"<varname>r_raster_column</varname> the raster column that this overview "
+"column services."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:431
+#, no-c-format
+msgid ""
+"<varname>overview_factor</varname> - this is the pyramid level of the "
+"overview table. The higher the number the lower the resolution of the table. "
+"raster2pgsql if given a folder of images, will compute overview of each "
+"image file and load separately. Level 1 is assumed and always the original "
+"file. Level 2 is will have each tile represent 4 of the original. So for "
+"example if you have a folder of 5000x5000 pixel image files that you chose "
+"to chunk 125x125, for each image file your base table will have (5000*5000)/"
+"(125*125) records = 1600, your (l=2) <varname>o_2</varname> table will have "
+"ceiling(1600/Power(2,2)) = 400 rows, your (l=3) <varname>o_3</varname> will "
+"have ceiling(1600/Power(2,3) ) = 200 rows. If your pixels aren't divisible "
+"by the size of your tiles, you'll get some scrap tiles (tiles not completely "
+"filled). Note that each overview tile generated by raster2pgsql has the same "
+"number of pixels as its parent, but is of a lower resolution where each "
+"pixel of it represents (Power(2,overview_factor) pixels of the original)."
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:443
+#, no-c-format
+msgid "Building Custom Applications with PostGIS Raster"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:444
+#, no-c-format
+msgid ""
+"The fact that PostGIS raster provides you with SQL functions to render "
+"rasters in known image formats gives you a lot of optoins for rendering "
+"them. For example you can use OpenOffice / LibreOffice for rendering as "
+"demonstrated in <ulink url=\"http://www.postgresonline.com/journal/"
+"archives/244-Rendering-PostGIS-Raster-graphics-with-LibreOffice-Base-Reports."
+"html\">Rendering PostGIS Raster graphics with LibreOffice Base Reports</"
+"ulink>. In addition you can use a wide variety of languages as demonstrated "
+"in this section."
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:447
+#, no-c-format
+msgid ""
+"PHP Example Outputting using ST_AsPNG in concert with other raster functions"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:448
+#, no-c-format
+msgid ""
+"In this section, we'll demonstrate how to use the PHP PostgreSQL driver and "
+"the <xref linkend=\"RT_ST_AsGDALRaster\"/> family of functions to output "
+"band 1,2,3 of a raster to a PHP request stream that can then be embedded in "
+"an img src html tag."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:451 using_raster_dataman.xml:463
+#, no-c-format
+msgid ""
+"The sample query demonstrates how to combine a whole bunch of raster "
+"functions together to grab all tiles that intersect a particular wgs 84 "
+"bounding box and then unions with <xref linkend=\"RT_ST_Union\"/> the "
+"intersecting tiles together returning all bands, transforms to user "
+"specified projection using <xref linkend=\"RT_ST_Transform\"/>, and then "
+"outputs the results as a png using <xref linkend=\"RT_ST_AsPNG\"/>."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:454
+#, no-c-format
+msgid ""
+"You would call the below using <programlisting>http://mywebserver/"
+"test_raster.php?srid=2249</programlisting> to get the raster image in "
+"Massachusetts state plane feet."
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:455
+#, no-c-format
+msgid ""
+"<![CDATA[<?php\n"
+"/** contents of test_raster.php **/\n"
+"$conn_str ='dbname=mydb host=localhost port=5432 user=myuser "
+"password=mypwd';\n"
+"$dbconn = pg_connect($conn_str);\n"
+"header('Content-Type: image/png'); \n"
+"/**If a particular projection was requested use it otherwise use mass state "
+"plane meters **/\n"
+"if (!empty( $_REQUEST['srid'] ) && is_numeric( $_REQUEST['srid']) ){\n"
+" $input_srid = intval($_REQUEST['srid']);\n"
+"}\n"
+"else { $input_srid = 26986; }\n"
+"/** The set bytea_output may be needed for PostgreSQL 9.0+, but not for 8.4 "
+"**/\n"
+"$sql = \"set bytea_output='escape';\n"
+"SELECT ST_AsPNG(ST_Transform(\n"
+" ST_AddBand(ST_Union(rast,1), ARRAY[ST_Union(rast,2),"
+"ST_Union(rast,3)])\n"
+" ,$input_srid) ) As new_rast\n"
+" FROM aerials.boston \n"
+" WHERE \n"
+" ST_Intersects(rast, ST_Transform(ST_MakeEnvelope(-71.1217, 42.227, "
+"-71.1210, 42.218,4326),26986) )\"; \n"
+"$result = pg_query($sql);\n"
+"$row = pg_fetch_row($result);\n"
+"pg_free_result($result);\n"
+"if ($row === false) return;\n"
+"echo pg_unescape_bytea($row[0]);\n"
+"?>]]>"
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:458
+#, no-c-format
+msgid ""
+"ASP.NET C# Example Outputting using ST_AsPNG in concert with other raster "
+"functions"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:459
+#, no-c-format
+msgid ""
+"In this section, we'll demonstrate how to use Npgsql PostgreSQL .NET driver "
+"and the <xref linkend=\"RT_ST_AsGDALRaster\"/> family of functions to output "
+"band 1,2,3 of a raster to a PHP request stream that can then be embedded in "
+"an img src html tag."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:462
+#, no-c-format
+msgid ""
+"You will need the npgsql .NET PostgreSQL driver for this exercise which you "
+"can get the latest of from <ulink url=\"http://npgsql.projects.postgresql."
+"org/\">http://npgsql.projects.postgresql.org/</ulink>. Just download the "
+"latest and drop into your ASP.NET bin folder and you'll be good to go."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:466
+#, no-c-format
+msgid ""
+"This is same example as <xref linkend=\"RT_PHP_Output\"/> except implemented "
+"in C#."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:467
+#, no-c-format
+msgid ""
+"You would call the below using <programlisting>http://mywebserver/TestRaster."
+"ashx?srid=2249</programlisting> to get the raster image in Massachusetts "
+"state plane feet."
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:468
+#, no-c-format
+msgid ""
+"-- web.config connection string section --\n"
+"<![CDATA[<connectionStrings>\n"
+" <add name=\"DSN\" \n"
+" connectionString=\"server=localhost;database=mydb;Port=5432;User "
+"Id=myuser;password=mypwd\"/>\n"
+"</connectionStrings>]]>"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:469
+#, no-c-format
+msgid ""
+"// Code for TestRaster.ashx\n"
+"<![CDATA[<%@ WebHandler Language=\"C#\" Class=\"TestRaster\" %>\n"
+"using System;\n"
+"using System.Data;\n"
+"using System.Web;\n"
+"using Npgsql;\n"
+"\n"
+"public class TestRaster : IHttpHandler\n"
+"{\n"
+" public void ProcessRequest(HttpContext context)\n"
+" {\n"
+" \n"
+" context.Response.ContentType = \"image/png\";\n"
+" context.Response.BinaryWrite(GetResults(context));\n"
+" \n"
+" }\n"
+"\n"
+" public bool IsReusable {\n"
+" get { return false; }\n"
+" }\n"
+"\n"
+" public byte[] GetResults(HttpContext context)\n"
+" {\n"
+" byte[] result = null;\n"
+" NpgsqlCommand command;\n"
+" string sql = null;\n"
+" int input_srid = 26986;\n"
+" try {\n"
+" using (NpgsqlConnection conn = new "
+"NpgsqlConnection(System.Configuration.ConfigurationManager."
+"ConnectionStrings[\"DSN\"].ConnectionString)) {\n"
+" conn.Open();\n"
+"\n"
+" if (context.Request[\"srid\"] != null)\n"
+" {\n"
+" input_srid = Convert.ToInt32(context.Request[\"srid"
+"\"]); \n"
+" }\n"
+" sql = @\"SELECT ST_AsPNG(\n"
+" ST_Transform(\n"
+" ST_AddBand(\n"
+" ST_Union(rast,1), ARRAY[ST_Union(rast,2),"
+"ST_Union(rast,3)])\n"
+" ,:input_srid) ) As "
+"new_rast \n"
+" FROM aerials.boston \n"
+" WHERE \n"
+" ST_Intersects(rast, \n"
+" ST_Transform(ST_MakeEnvelope(-71.1217, "
+"42.227, -71.1210, 42.218,4326),26986) )\";\n"
+" command = new NpgsqlCommand(sql, conn);\n"
+" command.Parameters.Add(new NpgsqlParameter(\"input_srid\", "
+"input_srid));\n"
+" \n"
+" \n"
+" result = (byte[]) command.ExecuteScalar();\n"
+" conn.Close();\n"
+" }\n"
+"\n"
+" }\n"
+" catch (Exception ex)\n"
+" {\n"
+" result = null;\n"
+" context.Response.Write(ex.Message.Trim());\n"
+" }\n"
+" return result;\n"
+" }\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:472
+#, no-c-format
+msgid "Java console app that outputs raster query as Image file"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:473
+#, no-c-format
+msgid ""
+"This is a simple java console app that takes a query that returns one image "
+"and outputs to specified file."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:474
+#, no-c-format
+msgid ""
+"You can download the latest PostgreSQL JDBC drivers from <ulink url=\"http://"
+"jdbc.postgresql.org/download.html\">http://jdbc.postgresql.org/download."
+"html</ulink>"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:475
+#, no-c-format
+msgid "You can compile the following code using a command something like:"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:476
+#, no-c-format
+msgid ""
+"set env CLASSPATH .:..\\postgresql-9.0-801.jdbc4.jar\n"
+"javac SaveQueryImage.java\n"
+"jar cfm SaveQueryImage.jar Manifest.txt *.class"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:477
+#, no-c-format
+msgid "And call it from the command-line with something like"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:478
+#, no-c-format
+msgid ""
+"java -jar SaveQueryImage.jar \"SELECT "
+"ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10, 'quad_segs=2'),150, 150, "
+"'8BUI',100));\" \"test.png\""
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:479
+#, no-c-format
+msgid ""
+"-- Manifest.txt --\n"
+"<![CDATA[Class-Path: postgresql-9.0-801.jdbc4.jar\n"
+"Main-Class: SaveQueryImage]]>"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:480
+#, no-c-format
+msgid ""
+"// Code for SaveQueryImage.java\n"
+"<![CDATA[import java.sql.Connection;\n"
+"import java.sql.SQLException;\n"
+"import java.sql.PreparedStatement;\n"
+"import java.sql.ResultSet;\n"
+"import java.io.*;\n"
+"\n"
+"public class SaveQueryImage {\n"
+" public static void main(String[] argv) {\n"
+" System.out.println(\"Checking if Driver is registered with "
+"DriverManager.\");\n"
+" \n"
+" try {\n"
+" //java.sql.DriverManager.registerDriver (new org.postgresql."
+"Driver());\n"
+" Class.forName(\"org.postgresql.Driver\");\n"
+" } \n"
+" catch (ClassNotFoundException cnfe) {\n"
+" System.out.println(\"Couldn't find the driver!\");\n"
+" cnfe.printStackTrace();\n"
+" System.exit(1);\n"
+" }\n"
+" \n"
+" Connection conn = null;\n"
+" \n"
+" try {\n"
+" conn = DriverManager.getConnection(\"jdbc:postgresql://"
+"localhost:5432/mydb\",\"myuser\", \"mypwd\");\n"
+" conn.setAutoCommit(false);\n"
+"\n"
+" PreparedStatement sGetImg = conn.prepareStatement(argv[0]);\n"
+" \n"
+" ResultSet rs = sGetImg.executeQuery();\n"
+" \n"
+" FileOutputStream fout;\n"
+" try\n"
+" {\n"
+" rs.next();\n"
+" /** Output to file name requested by user **/\n"
+" fout = new FileOutputStream(new File(argv[1]) );\n"
+" fout.write(rs.getBytes(1));\n"
+" fout.close();\n"
+" }\n"
+" catch(Exception e)\n"
+" {\n"
+" System.out.println(\"Can't create file\");\n"
+" e.printStackTrace();\n"
+" }\n"
+" \n"
+" rs.close();\n"
+" sGetImg.close();\n"
+" conn.close();\n"
+" } \n"
+" catch (SQLException se) {\n"
+" System.out.println(\"Couldn't connect: print out a stack trace and "
+"exit.\");\n"
+" se.printStackTrace();\n"
+" System.exit(1);\n"
+" } \n"
+" }\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:484
+#, no-c-format
+msgid "Use PLPython to dump out images via SQL"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:485
+#, no-c-format
+msgid ""
+"This is a plpython stored function that creates a file in the server "
+"directory for each record."
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:486
+#, no-c-format
+msgid ""
+"//plpython postgresql stored proc. Requires you have plpython installed\n"
+"<![CDATA[CREATE OR REPLACE FUNCTION write_file (param_bytes bytea, "
+"param_filepath text)\n"
+"RETURNS text\n"
+"AS $$\n"
+"f = open(param_filepath, 'wb+')\n"
+"f.write(param_bytes)\n"
+"return param_filepath\n"
+"$$ LANGUAGE plpythonu;]]>"
+msgstr ""
+
+#. Tag: programlisting
+#: using_raster_dataman.xml:487
+#, no-c-format
+msgid ""
+"--write out 5 images to the PostgreSQL server in varying sizes\n"
+"-- note the postgresql daemon account needs to have write access to folder\n"
+"-- this echos back the file names created;\n"
+" SELECT write_file(ST_AsPNG(\n"
+" ST_AsRaster(ST_Buffer(ST_Point(1,5),j*5, 'quad_segs=2'),150*j, "
+"150*j, '8BUI',100)),\n"
+" 'C:/temp/slices'|| j || '.png')\n"
+" FROM generate_series(1,5) As j;\n"
+" \n"
+" write_file\n"
+"---------------------\n"
+" C:/temp/slices1.png\n"
+" C:/temp/slices2.png\n"
+" C:/temp/slices3.png\n"
+" C:/temp/slices4.png\n"
+" C:/temp/slices5.png"
+msgstr ""
+
+#. Tag: title
+#: using_raster_dataman.xml:490
+#, no-c-format
+msgid "Outputting Rasters with PSQL"
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:491
+#, no-c-format
+msgid ""
+"Sadly PSQL doesn't have easy to use built-in functionality for outputting "
+"binaries. This is a bit of a hack and based on one of the suggestions "
+"outlined in <ulink url=\"http://people.planetpostgresql.org/andrew/index."
+"php?/archives/196-Clever-trick-challenge.html\">Clever Trick Challenge -- "
+"Outputting bytea with psql</ulink> that piggy backs on PostgreSQL somewhat "
+"legacy large object support. To use first launch your psql commandline "
+"connected to your database."
+msgstr ""
+
+#. Tag: para
+#: using_raster_dataman.xml:494
+#, no-c-format
+msgid ""
+"Unlike the python approach, this approach creates the file on your local "
+"computer."
+msgstr ""
+
+#. Tag: screen
+#: using_raster_dataman.xml:495
+#, no-c-format
+msgid ""
+"SELECT oid, lowrite(lo_open(oid, 131072), png) As num_bytes\n"
+" FROM \n"
+" ( VALUES (lo_create(0), \n"
+" ST_AsPNG( (SELECT rast FROM aerials.boston WHERE rid=1) ) \n"
+" ) ) As v(oid,png);\n"
+"-- you'll get an output something like --\n"
+" oid | num_bytes\n"
+"---------+-----------\n"
+" 2630819 | 74860\n"
+" \n"
+"-- next note the oid and do this replacing the c:/test.png to file path "
+"location\n"
+"-- on your local computer\n"
+" \\lo_export 2630819 'C:/temp/aerial_samp.png'\n"
+" \n"
+"-- this deletes the file from large object storage on db\n"
+"SELECT lo_unlink(2630819);"
+msgstr ""
projects / postgis / commitdiff