From 9780e902d34a2d35dfd767ff976f45cc82dba4c1 Mon Sep 17 00:00:00 2001 From: Darafei Praliaskouski Date: Sat, 3 Aug 2019 21:04:11 +0000 Subject: [PATCH] Update translation templates. git-svn-id: http://svn.osgeo.org/postgis/trunk@17665 b70326c6-7e19-0410-871a-916f4a2858ee --- doc/po/templates/extras.xml.pot | 4 +- .../extras_address_standardizer.xml.pot | 4 +- doc/po/templates/extras_historytable.xml.pot | 4 +- doc/po/templates/extras_tigergeocoder.xml.pot | 14 +- doc/po/templates/extras_topology.xml.pot | 1161 ++- doc/po/templates/faq.xml.pot | 4 +- doc/po/templates/faq_raster.xml.pot | 4 +- doc/po/templates/installation.xml.pot | 1358 ++-- doc/po/templates/introduction.xml.pot | 1069 ++- doc/po/templates/performance_tips.xml.pot | 34 +- doc/po/templates/postgis.xml.pot | 16 +- doc/po/templates/reference.xml.pot | 18 +- doc/po/templates/reference_accessor.xml.pot | 2811 ++++---- doc/po/templates/reference_bbox.xml.pot | 1178 ++++ doc/po/templates/reference_cluster.xml.pot | 466 ++ .../templates/reference_constructor.xml.pot | 3344 ++------- doc/po/templates/reference_editor.xml.pot | 1883 ++--- doc/po/templates/reference_exception.xml.pot | 4 +- doc/po/templates/reference_guc.xml.pot | 128 +- doc/po/templates/reference_input.xml.pot | 2373 +++++++ doc/po/templates/reference_lrs.xml.pot | 318 +- doc/po/templates/reference_management.xml.pot | 819 +-- doc/po/templates/reference_measure.xml.pot | 6201 ++++------------- doc/po/templates/reference_misc.xml.pot | 897 +-- doc/po/templates/reference_operator.xml.pot | 608 +- doc/po/templates/reference_output.xml.pot | 2032 +++--- doc/po/templates/reference_processing.xml.pot | 2577 +++---- doc/po/templates/reference_raster.xml.pot | 3555 +++++----- .../templates/reference_relationship.xml.pot | 2476 +++++++ doc/po/templates/reference_sfcgal.xml.pot | 426 +- doc/po/templates/reference_srs.xml.pot | 493 ++ doc/po/templates/reference_trajectory.xml.pot | 341 + .../templates/reference_transaction.xml.pot | 182 +- .../reference_transformation.xml.pot | 838 +++ .../reference_troubleshooting.xml.pot | 223 + doc/po/templates/reference_type.xml.pot | 234 +- doc/po/templates/reference_validation.xml.pot | 386 + doc/po/templates/reference_version.xml.pot | 731 ++ doc/po/templates/release_notes.xml.pot | 3142 +++++---- doc/po/templates/reporting.xml.pot | 4 +- doc/po/templates/using_postgis_app.xml.pot | 4 +- .../templates/using_postgis_dataman.xml.pot | 349 +- doc/po/templates/using_raster_dataman.xml.pot | 254 +- 43 files changed, 22998 insertions(+), 19969 deletions(-) create mode 100644 doc/po/templates/reference_bbox.xml.pot create mode 100644 doc/po/templates/reference_cluster.xml.pot create mode 100644 doc/po/templates/reference_input.xml.pot create mode 100644 doc/po/templates/reference_relationship.xml.pot create mode 100644 doc/po/templates/reference_srs.xml.pot create mode 100644 doc/po/templates/reference_trajectory.xml.pot create mode 100644 doc/po/templates/reference_transformation.xml.pot create mode 100644 doc/po/templates/reference_troubleshooting.xml.pot create mode 100644 doc/po/templates/reference_validation.xml.pot create mode 100644 doc/po/templates/reference_version.xml.pot diff --git a/doc/po/templates/extras.xml.pot b/doc/po/templates/extras.xml.pot index a4a309c83..c4c5ca6b7 100644 --- a/doc/po/templates/extras.xml.pot +++ b/doc/po/templates/extras.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:02+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/extras_address_standardizer.xml.pot b/doc/po/templates/extras_address_standardizer.xml.pot index b35a343f4..e6f28f398 100644 --- a/doc/po/templates/extras_address_standardizer.xml.pot +++ b/doc/po/templates/extras_address_standardizer.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-08-30 03:58+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/extras_historytable.xml.pot b/doc/po/templates/extras_historytable.xml.pot index 3ec6b4bdc..52ff90f90 100644 --- a/doc/po/templates/extras_historytable.xml.pot +++ b/doc/po/templates/extras_historytable.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:02+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/extras_tigergeocoder.xml.pot b/doc/po/templates/extras_tigergeocoder.xml.pot index 6ab40c04b..56f5992a1 100644 --- a/doc/po/templates/extras_tigergeocoder.xml.pot +++ b/doc/po/templates/extras_tigergeocoder.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -1395,7 +1395,9 @@ msgstr "" #. Tag: para #: extras_tigergeocoder.xml:549 #, no-c-format -msgid ", " +msgid "" +", , " msgstr "" #. Tag: refname @@ -1518,6 +1520,12 @@ msgstr "" msgid "SELECT loader_generate_nation_script('sh');" msgstr "" +#. Tag: para +#: extras_tigergeocoder.xml:606 +#, no-c-format +msgid ", " +msgstr "" + #. Tag: refname #: extras_tigergeocoder.xml:612 #, no-c-format diff --git a/doc/po/templates/extras_topology.xml.pot b/doc/po/templates/extras_topology.xml.pot index fc4b468ef..5a311ff21 100644 --- a/doc/po/templates/extras_topology.xml.pot +++ b/doc/po/templates/extras_topology.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-09-14 18:44+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -130,30 +130,30 @@ msgstr "" #, no-c-format msgid "" "A composite type that consists of a sequence number and edge number. This is " -"the return type for ST_GetFaceEdges" +"the return type for ST_GetFaceEdges." msgstr "" #. Tag: title #: extras_topology.xml:31 extras_topology.xml:50 extras_topology.xml:99 #: extras_topology.xml:139 extras_topology.xml:186 extras_topology.xml:263 -#: extras_topology.xml:310 extras_topology.xml:351 extras_topology.xml:391 -#: extras_topology.xml:432 extras_topology.xml:469 extras_topology.xml:597 -#: extras_topology.xml:645 extras_topology.xml:693 extras_topology.xml:737 -#: extras_topology.xml:785 extras_topology.xml:831 extras_topology.xml:877 -#: extras_topology.xml:932 extras_topology.xml:978 extras_topology.xml:1025 -#: extras_topology.xml:1082 extras_topology.xml:1148 extras_topology.xml:1220 -#: extras_topology.xml:1288 extras_topology.xml:1354 extras_topology.xml:1409 -#: extras_topology.xml:1457 extras_topology.xml:1504 extras_topology.xml:1547 -#: extras_topology.xml:1601 extras_topology.xml:1642 extras_topology.xml:1740 -#: extras_topology.xml:1842 extras_topology.xml:1884 extras_topology.xml:1926 -#: extras_topology.xml:1969 extras_topology.xml:2019 extras_topology.xml:2064 -#: extras_topology.xml:2125 extras_topology.xml:2183 extras_topology.xml:2224 -#: extras_topology.xml:2281 extras_topology.xml:2331 extras_topology.xml:2403 -#: extras_topology.xml:2457 extras_topology.xml:2528 extras_topology.xml:2604 -#: extras_topology.xml:2649 extras_topology.xml:2691 extras_topology.xml:2735 -#: extras_topology.xml:2766 extras_topology.xml:2804 extras_topology.xml:2852 -#: extras_topology.xml:2952 extras_topology.xml:3006 extras_topology.xml:3073 -#: extras_topology.xml:3125 +#: extras_topology.xml:310 extras_topology.xml:352 extras_topology.xml:392 +#: extras_topology.xml:433 extras_topology.xml:470 extras_topology.xml:598 +#: extras_topology.xml:646 extras_topology.xml:694 extras_topology.xml:738 +#: extras_topology.xml:786 extras_topology.xml:830 extras_topology.xml:874 +#: extras_topology.xml:929 extras_topology.xml:975 extras_topology.xml:1022 +#: extras_topology.xml:1079 extras_topology.xml:1145 extras_topology.xml:1217 +#: extras_topology.xml:1285 extras_topology.xml:1351 extras_topology.xml:1406 +#: extras_topology.xml:1454 extras_topology.xml:1501 extras_topology.xml:1544 +#: extras_topology.xml:1598 extras_topology.xml:1639 extras_topology.xml:1686 +#: extras_topology.xml:1737 extras_topology.xml:1786 extras_topology.xml:1836 +#: extras_topology.xml:1878 extras_topology.xml:1920 extras_topology.xml:1963 +#: extras_topology.xml:2013 extras_topology.xml:2058 extras_topology.xml:2119 +#: extras_topology.xml:2177 extras_topology.xml:2218 extras_topology.xml:2275 +#: extras_topology.xml:2320 extras_topology.xml:2392 extras_topology.xml:2446 +#: extras_topology.xml:2515 extras_topology.xml:2591 extras_topology.xml:2636 +#: extras_topology.xml:2678 extras_topology.xml:2722 extras_topology.xml:2753 +#: extras_topology.xml:2791 extras_topology.xml:2839 extras_topology.xml:2939 +#: extras_topology.xml:2993 extras_topology.xml:3060 extras_topology.xml:3109 #, no-c-format msgid "Description" msgstr "" @@ -189,7 +189,7 @@ msgstr "" #. Tag: refpurpose #: extras_topology.xml:47 #, no-c-format -msgid "A composite type representing a topologically defined geometry" +msgid "A composite type representing a topologically defined geometry." msgstr "" #. Tag: para @@ -277,24 +277,24 @@ msgstr "" #. Tag: title #: extras_topology.xml:88 extras_topology.xml:117 extras_topology.xml:169 #: extras_topology.xml:196 extras_topology.xml:288 extras_topology.xml:328 -#: extras_topology.xml:368 extras_topology.xml:410 extras_topology.xml:447 -#: extras_topology.xml:546 extras_topology.xml:622 extras_topology.xml:671 -#: extras_topology.xml:710 extras_topology.xml:759 extras_topology.xml:800 -#: extras_topology.xml:846 extras_topology.xml:892 extras_topology.xml:953 -#: extras_topology.xml:1000 extras_topology.xml:1056 extras_topology.xml:1121 -#: extras_topology.xml:1193 extras_topology.xml:1261 extras_topology.xml:1328 -#: extras_topology.xml:1377 extras_topology.xml:1426 extras_topology.xml:1476 -#: extras_topology.xml:1524 extras_topology.xml:1573 extras_topology.xml:1619 -#: extras_topology.xml:1660 extras_topology.xml:1714 extras_topology.xml:1761 -#: extras_topology.xml:1815 extras_topology.xml:1857 extras_topology.xml:1899 -#: extras_topology.xml:1941 extras_topology.xml:1992 extras_topology.xml:2037 -#: extras_topology.xml:2097 extras_topology.xml:2150 extras_topology.xml:2199 -#: extras_topology.xml:2258 extras_topology.xml:2301 extras_topology.xml:2380 -#: extras_topology.xml:2415 extras_topology.xml:2487 extras_topology.xml:2577 -#: extras_topology.xml:2618 extras_topology.xml:2668 extras_topology.xml:2709 -#: extras_topology.xml:2752 extras_topology.xml:2823 extras_topology.xml:2870 -#: extras_topology.xml:2984 extras_topology.xml:3037 extras_topology.xml:3098 -#: extras_topology.xml:3154 +#: extras_topology.xml:369 extras_topology.xml:411 extras_topology.xml:448 +#: extras_topology.xml:547 extras_topology.xml:623 extras_topology.xml:672 +#: extras_topology.xml:711 extras_topology.xml:760 extras_topology.xml:801 +#: extras_topology.xml:845 extras_topology.xml:889 extras_topology.xml:950 +#: extras_topology.xml:997 extras_topology.xml:1053 extras_topology.xml:1118 +#: extras_topology.xml:1190 extras_topology.xml:1258 extras_topology.xml:1325 +#: extras_topology.xml:1374 extras_topology.xml:1423 extras_topology.xml:1473 +#: extras_topology.xml:1521 extras_topology.xml:1570 extras_topology.xml:1616 +#: extras_topology.xml:1657 extras_topology.xml:1711 extras_topology.xml:1757 +#: extras_topology.xml:1809 extras_topology.xml:1851 extras_topology.xml:1893 +#: extras_topology.xml:1935 extras_topology.xml:1986 extras_topology.xml:2031 +#: extras_topology.xml:2091 extras_topology.xml:2144 extras_topology.xml:2193 +#: extras_topology.xml:2252 extras_topology.xml:2292 extras_topology.xml:2369 +#: extras_topology.xml:2404 extras_topology.xml:2476 extras_topology.xml:2564 +#: extras_topology.xml:2605 extras_topology.xml:2655 extras_topology.xml:2696 +#: extras_topology.xml:2739 extras_topology.xml:2810 extras_topology.xml:2857 +#: extras_topology.xml:2971 extras_topology.xml:3024 extras_topology.xml:3085 +#: extras_topology.xml:3138 #, no-c-format msgid "See Also" msgstr "" @@ -311,7 +311,7 @@ msgstr "" 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 ValidateTopology" +"varname>." msgstr "" #. Tag: para @@ -414,21 +414,21 @@ msgstr "" #. Tag: title #: extras_topology.xml:162 extras_topology.xml:190 extras_topology.xml:281 -#: extras_topology.xml:321 extras_topology.xml:362 extras_topology.xml:403 -#: extras_topology.xml:442 extras_topology.xml:540 extras_topology.xml:611 -#: extras_topology.xml:661 extras_topology.xml:704 extras_topology.xml:753 -#: extras_topology.xml:946 extras_topology.xml:993 extras_topology.xml:1049 -#: extras_topology.xml:1114 extras_topology.xml:1186 extras_topology.xml:1254 -#: extras_topology.xml:1322 extras_topology.xml:1371 extras_topology.xml:1518 -#: extras_topology.xml:1567 extras_topology.xml:1613 extras_topology.xml:1654 -#: extras_topology.xml:1706 extras_topology.xml:1754 extras_topology.xml:1807 -#: extras_topology.xml:1851 extras_topology.xml:1893 extras_topology.xml:1935 -#: extras_topology.xml:1985 extras_topology.xml:2031 extras_topology.xml:2252 -#: extras_topology.xml:2295 extras_topology.xml:2374 extras_topology.xml:2568 -#: extras_topology.xml:2614 extras_topology.xml:2662 extras_topology.xml:2703 -#: extras_topology.xml:2746 extras_topology.xml:2816 extras_topology.xml:2863 -#: extras_topology.xml:2975 extras_topology.xml:3042 extras_topology.xml:3091 -#: extras_topology.xml:3147 +#: extras_topology.xml:321 extras_topology.xml:363 extras_topology.xml:404 +#: extras_topology.xml:443 extras_topology.xml:541 extras_topology.xml:612 +#: extras_topology.xml:662 extras_topology.xml:705 extras_topology.xml:754 +#: extras_topology.xml:943 extras_topology.xml:990 extras_topology.xml:1046 +#: extras_topology.xml:1111 extras_topology.xml:1183 extras_topology.xml:1251 +#: extras_topology.xml:1319 extras_topology.xml:1368 extras_topology.xml:1515 +#: extras_topology.xml:1564 extras_topology.xml:1610 extras_topology.xml:1651 +#: extras_topology.xml:1703 extras_topology.xml:1750 extras_topology.xml:1801 +#: extras_topology.xml:1845 extras_topology.xml:1887 extras_topology.xml:1929 +#: extras_topology.xml:1979 extras_topology.xml:2025 extras_topology.xml:2246 +#: extras_topology.xml:2286 extras_topology.xml:2363 extras_topology.xml:2555 +#: extras_topology.xml:2601 extras_topology.xml:2649 extras_topology.xml:2690 +#: extras_topology.xml:2733 extras_topology.xml:2803 extras_topology.xml:2850 +#: extras_topology.xml:2962 extras_topology.xml:3029 extras_topology.xml:3078 +#: extras_topology.xml:3131 #, no-c-format msgid "Examples" msgstr "" @@ -484,7 +484,7 @@ msgstr "" #. Tag: refpurpose #: extras_topology.xml:183 #, no-c-format -msgid "An array of TopoElement objects" +msgid "An array of TopoElement objects." msgstr "" #. Tag: para @@ -631,12 +631,12 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:275 extras_topology.xml:316 extras_topology.xml:357 -#: extras_topology.xml:606 extras_topology.xml:698 extras_topology.xml:940 -#: extras_topology.xml:987 extras_topology.xml:1364 extras_topology.xml:1512 -#: extras_topology.xml:1561 extras_topology.xml:1607 extras_topology.xml:1648 -#: extras_topology.xml:1846 extras_topology.xml:1930 extras_topology.xml:2025 -#: extras_topology.xml:2465 extras_topology.xml:2811 +#: extras_topology.xml:275 extras_topology.xml:316 extras_topology.xml:358 +#: extras_topology.xml:607 extras_topology.xml:699 extras_topology.xml:937 +#: extras_topology.xml:984 extras_topology.xml:1361 extras_topology.xml:1509 +#: extras_topology.xml:1558 extras_topology.xml:1604 extras_topology.xml:1645 +#: extras_topology.xml:1840 extras_topology.xml:1924 extras_topology.xml:2019 +#: extras_topology.xml:2454 extras_topology.xml:2798 #, no-c-format msgid "Availability: 1.?" msgstr "" @@ -666,7 +666,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:290 extras_topology.xml:2710 extras_topology.xml:2753 +#: extras_topology.xml:290 extras_topology.xml:2697 extras_topology.xml:2740 #, no-c-format msgid ", " msgstr "" @@ -721,13 +721,13 @@ msgid "SELECT topology.DropTopology('ma_topo');" msgstr "" #. Tag: refname -#: extras_topology.xml:334 +#: extras_topology.xml:335 #, no-c-format msgid "DropTopoGeometryColumn" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:336 +#: extras_topology.xml:337 #, no-c-format msgid "" "Drops the topogeometry column from the table named table_nametext DropTopoGeometryColumn " @@ -747,7 +747,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:353 +#: extras_topology.xml:354 #, no-c-format msgid "" "Drops the topogeometry column from the table named table_namesetof record Populate_Topology_Layer " @@ -787,7 +787,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:393 +#: extras_topology.xml:394 #, no-c-format msgid "" "Adds missing entries to the topology.layer table by " @@ -797,7 +797,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:395 +#: extras_topology.xml:396 #, no-c-format msgid "" "It returns the list of entries created. Returned columns are " @@ -806,13 +806,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:398 +#: extras_topology.xml:399 #, no-c-format msgid "Availability: 2.3.0" msgstr "" #. Tag: programlisting -#: extras_topology.xml:404 +#: extras_topology.xml:405 #, no-c-format msgid "" "SELECT CreateTopology('strk_topo');\n" @@ -837,7 +837,7 @@ msgid "" msgstr "" #. Tag: screen -#: extras_topology.xml:405 +#: extras_topology.xml:406 #, no-c-format msgid "" "schema_name | table_name | feature_column\n" @@ -852,21 +852,21 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:417 +#: extras_topology.xml:418 #, no-c-format msgid "TopologySummary" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:419 +#: extras_topology.xml:420 #, no-c-format msgid "" -"Takes a topology name and provides summary totals of types of objects in " -"topology" +"Takes a topology name and provides summary totals of types of " +"objects in topology." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:424 +#: extras_topology.xml:425 #, no-c-format msgid "" "text TopologySummary " @@ -875,25 +875,26 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:434 +#: extras_topology.xml:435 #, no-c-format msgid "" -"Takes a topology name and provides summary totals of types of objects in " -"topology." +"Takes a topology name and provides summary totals of types of objects " +"in topology." msgstr "" #. Tag: para -#: extras_topology.xml:437 extras_topology.xml:656 extras_topology.xml:794 -#: extras_topology.xml:840 extras_topology.xml:886 extras_topology.xml:1888 -#: extras_topology.xml:2091 extras_topology.xml:2194 extras_topology.xml:2247 -#: extras_topology.xml:2369 extras_topology.xml:2609 extras_topology.xml:2858 -#: extras_topology.xml:2970 +#: extras_topology.xml:438 extras_topology.xml:657 extras_topology.xml:795 +#: extras_topology.xml:839 extras_topology.xml:883 extras_topology.xml:1698 +#: extras_topology.xml:1747 extras_topology.xml:1796 extras_topology.xml:1882 +#: extras_topology.xml:2085 extras_topology.xml:2188 extras_topology.xml:2241 +#: extras_topology.xml:2282 extras_topology.xml:2358 extras_topology.xml:2596 +#: extras_topology.xml:2845 extras_topology.xml:2957 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: programlisting -#: extras_topology.xml:443 +#: extras_topology.xml:444 #, no-c-format msgid "" "SELECT topology.topologysummary('city_data');\n" @@ -916,21 +917,21 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:454 +#: extras_topology.xml:455 #, no-c-format msgid "ValidateTopology" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:456 +#: extras_topology.xml:457 #, no-c-format msgid "" "Returns a set of validatetopology_returntype objects detailing issues with " -"topology" +"topology." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:461 +#: extras_topology.xml:462 #, no-c-format msgid "" "setof validatetopology_returntype ValidateTopology objects " @@ -948,131 +949,131 @@ msgid "" msgstr "" #. Tag: entry -#: extras_topology.xml:475 +#: extras_topology.xml:476 #, no-c-format msgid "Error" msgstr "" #. Tag: entry -#: extras_topology.xml:475 +#: extras_topology.xml:476 #, no-c-format msgid "id1" msgstr "" #. Tag: entry -#: extras_topology.xml:475 +#: extras_topology.xml:476 #, no-c-format msgid "id2" msgstr "" #. Tag: entry -#: extras_topology.xml:478 +#: extras_topology.xml:479 #, no-c-format msgid "edge crosses node" msgstr "" #. Tag: entry -#: extras_topology.xml:479 extras_topology.xml:484 extras_topology.xml:489 -#: extras_topology.xml:494 extras_topology.xml:495 extras_topology.xml:499 -#: extras_topology.xml:504 +#: extras_topology.xml:480 extras_topology.xml:485 extras_topology.xml:490 +#: extras_topology.xml:495 extras_topology.xml:496 extras_topology.xml:500 +#: extras_topology.xml:505 #, no-c-format msgid "edge_id" msgstr "" #. Tag: entry -#: extras_topology.xml:480 extras_topology.xml:500 extras_topology.xml:505 +#: extras_topology.xml:481 extras_topology.xml:501 extras_topology.xml:506 #, no-c-format msgid "node_id" msgstr "" #. Tag: entry -#: extras_topology.xml:483 +#: extras_topology.xml:484 #, no-c-format msgid "invalid edge" msgstr "" #. Tag: entry -#: extras_topology.xml:485 extras_topology.xml:490 extras_topology.xml:510 -#: extras_topology.xml:515 +#: extras_topology.xml:486 extras_topology.xml:491 extras_topology.xml:511 +#: extras_topology.xml:516 #, no-c-format msgid "null" msgstr "" #. Tag: entry -#: extras_topology.xml:488 +#: extras_topology.xml:489 #, no-c-format msgid "edge not simple" msgstr "" #. Tag: entry -#: extras_topology.xml:493 +#: extras_topology.xml:494 #, no-c-format msgid "edge crosses edge" msgstr "" #. Tag: entry -#: extras_topology.xml:498 +#: extras_topology.xml:499 #, no-c-format msgid "edge start node geometry mis-match" msgstr "" #. Tag: entry -#: extras_topology.xml:503 +#: extras_topology.xml:504 #, no-c-format msgid "edge end node geometry mis-match" msgstr "" #. Tag: entry -#: extras_topology.xml:508 +#: extras_topology.xml:509 #, no-c-format msgid "face without edges" msgstr "" #. Tag: entry -#: extras_topology.xml:509 extras_topology.xml:514 extras_topology.xml:519 -#: extras_topology.xml:520 +#: extras_topology.xml:510 extras_topology.xml:515 extras_topology.xml:520 +#: extras_topology.xml:521 #, no-c-format msgid "face_id" msgstr "" #. Tag: entry -#: extras_topology.xml:513 +#: extras_topology.xml:514 #, no-c-format msgid "face has no rings" msgstr "" #. Tag: entry -#: extras_topology.xml:518 +#: extras_topology.xml:519 #, no-c-format msgid "face overlaps face" msgstr "" #. Tag: entry -#: extras_topology.xml:523 +#: extras_topology.xml:524 #, no-c-format msgid "face within face" msgstr "" #. Tag: entry -#: extras_topology.xml:524 +#: extras_topology.xml:525 #, no-c-format msgid "inner face_id" msgstr "" #. Tag: entry -#: extras_topology.xml:525 +#: extras_topology.xml:526 #, no-c-format msgid "outer face_id" msgstr "" #. Tag: para -#: extras_topology.xml:532 +#: extras_topology.xml:533 #, no-c-format msgid "Availability: 1.0.0" msgstr "" #. Tag: para -#: extras_topology.xml:534 +#: extras_topology.xml:535 #, no-c-format msgid "" "Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false " @@ -1080,7 +1081,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:535 +#: extras_topology.xml:536 #, no-c-format msgid "" "Changed: 2.2.0 values for id1 and id2 were swapped for 'edge crosses node' " @@ -1088,7 +1089,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:541 +#: extras_topology.xml:542 #, no-c-format msgid "" "SELECT * FROM topology.ValidateTopology('ma_topo');\n" @@ -1098,31 +1099,31 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:547 +#: extras_topology.xml:548 #, no-c-format msgid ", " msgstr "" #. Tag: para -#: extras_topology.xml:555 +#: extras_topology.xml:556 #, no-c-format msgid "This section covers the topology functions for creating new topologies." msgstr "" #. Tag: title -#: extras_topology.xml:558 +#: extras_topology.xml:559 #, no-c-format msgid "Topology Constructors" msgstr "" #. Tag: refname -#: extras_topology.xml:562 +#: extras_topology.xml:563 #, no-c-format msgid "CreateTopology" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:563 +#: extras_topology.xml:564 #, no-c-format msgid "" "Creates a new topology schema and registers this new schema in the topology." @@ -1130,7 +1131,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:567 +#: extras_topology.xml:568 #, no-c-format msgid "" " integer CreateTopologytopology_name consisting " @@ -1169,7 +1170,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:603 +#: extras_topology.xml:604 #, no-c-format msgid "" "This is similar to the SQL/MM but a bit " @@ -1177,7 +1178,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:612 +#: extras_topology.xml:613 #, no-c-format msgid "" "This example creates a new schema called ma_topo that will store edges, " @@ -1187,19 +1188,19 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:614 +#: extras_topology.xml:615 #, no-c-format msgid "SELECT topology.CreateTopology('ma_topo',26986, 0.5);" msgstr "" #. Tag: para -#: extras_topology.xml:616 +#: extras_topology.xml:617 #, no-c-format msgid "Create Rhode Island topology in State Plane ft" msgstr "" #. Tag: programlisting -#: extras_topology.xml:617 +#: extras_topology.xml:618 #, no-c-format msgid "" "SELECT topology.CreateTopology('ri_topo',3438) As topoid;\n" @@ -1209,20 +1210,20 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:624 +#: extras_topology.xml:625 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:630 +#: extras_topology.xml:631 #, no-c-format msgid "CopyTopology" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:631 +#: extras_topology.xml:632 #, no-c-format msgid "" "Makes a copy of a topology structure (nodes, edges, faces, layers and " @@ -1230,7 +1231,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:636 +#: extras_topology.xml:637 #, no-c-format msgid "" "integer CopyTopology " @@ -1240,7 +1241,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:647 +#: extras_topology.xml:648 #, no-c-format msgid "" "Creates a new topology with name new_topology_name and " @@ -1250,7 +1251,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:651 +#: extras_topology.xml:652 #, no-c-format msgid "" "The new rows in topology.layer will contain synthesized values for " @@ -1260,31 +1261,31 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:662 +#: extras_topology.xml:663 #, no-c-format msgid "This example makes a backup of a topology called ma_topo" msgstr "" #. Tag: programlisting -#: extras_topology.xml:665 +#: extras_topology.xml:666 #, no-c-format msgid "SELECT topology.CopyTopology('ma_topo', 'ma_topo_bakup');" msgstr "" #. Tag: para -#: extras_topology.xml:673 extras_topology.xml:2259 +#: extras_topology.xml:674 extras_topology.xml:2253 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:679 +#: extras_topology.xml:680 #, no-c-format msgid "ST_InitTopoGeo" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:680 +#: extras_topology.xml:681 #, no-c-format msgid "" "Creates a new topology schema and registers this new schema in the topology." @@ -1292,7 +1293,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:685 +#: extras_topology.xml:686 #, no-c-format msgid "" "text ST_InitTopoGeo " @@ -1301,7 +1302,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:695 +#: extras_topology.xml:696 #, no-c-format msgid "" "This is an SQL-MM equivalent of CreateTopology but lacks the spatial " @@ -1310,14 +1311,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:699 +#: extras_topology.xml:700 #, 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:705 +#: extras_topology.xml:706 #, no-c-format msgid "" "SELECT topology.ST_InitTopoGeo('topo_schema_to_create') AS topocreation;\n" @@ -1327,13 +1328,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:719 +#: extras_topology.xml:720 #, no-c-format msgid "ST_CreateTopoGeo" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:721 +#: extras_topology.xml:722 #, no-c-format msgid "" "Adds a collection of geometries to a given empty topology and " @@ -1341,7 +1342,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:728 +#: extras_topology.xml:729 #, no-c-format msgid "" "text ST_CreateTopoGeo " @@ -1351,7 +1352,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:739 +#: extras_topology.xml:740 #, no-c-format msgid "" "Adds a collection of geometries to a given empty topology and returns " @@ -1359,29 +1360,29 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:743 +#: extras_topology.xml:744 #, no-c-format msgid "Useful for populating an empty topology." msgstr "" #. Tag: para -#: extras_topology.xml:747 extras_topology.xml:1043 extras_topology.xml:1108 -#: extras_topology.xml:1180 extras_topology.xml:1248 extras_topology.xml:1419 -#: extras_topology.xml:1469 extras_topology.xml:1979 extras_topology.xml:2145 -#: extras_topology.xml:2564 +#: extras_topology.xml:748 extras_topology.xml:1040 extras_topology.xml:1105 +#: extras_topology.xml:1177 extras_topology.xml:1245 extras_topology.xml:1416 +#: extras_topology.xml:1466 extras_topology.xml:1973 extras_topology.xml:2139 +#: extras_topology.xml:2551 #, no-c-format msgid "Availability: 2.0" msgstr "" #. Tag: para -#: extras_topology.xml:748 +#: extras_topology.xml:749 #, 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:754 +#: extras_topology.xml:755 #, no-c-format msgid "" "-- Populate topology --\n" @@ -1421,19 +1422,19 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:760 +#: extras_topology.xml:761 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:766 +#: extras_topology.xml:767 #, no-c-format msgid "TopoGeo_AddPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:768 +#: extras_topology.xml:769 #, no-c-format msgid "" "Adds a point to an existing topology using a tolerance and possibly " @@ -1441,27 +1442,27 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:775 +#: extras_topology.xml:776 #, no-c-format msgid "" "integer TopoGeo_AddPoint " -"varchar toponame " +"varchar atopology " "geometry apoint " "float8 tolerance" msgstr "" #. Tag: para -#: extras_topology.xml:787 +#: extras_topology.xml:788 #, no-c-format msgid "" -"Adds a point to an existing topology and return its identifier. The given " +"Adds a point to an existing topology and returns 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:801 +#: extras_topology.xml:802 #, no-c-format msgid "" ", , , SETOF integer TopoGeo_AddLineString " -"varchar toponame " +"varchar atopology " "geometry aline " "float8 tolerance" msgstr "" #. Tag: para -#: extras_topology.xml:833 +#: extras_topology.xml:832 #, no-c-format msgid "" -"Adds a linestring to an existing topology and return a set of edge " +"Adds a linestring to an existing topology and returns 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:847 +#: extras_topology.xml:846 #, no-c-format msgid "" ", , , integer TopoGeo_AddPolygon " +"SETOF integer TopoGeo_AddPolygon " "varchar atopology " "geometry apoly " -"float8 atolerancefloat8 tolerance" msgstr "" #. Tag: para -#: extras_topology.xml:879 +#: extras_topology.xml:876 #, no-c-format msgid "" -"Adds a polygon to an existing topology and return a set of face identifiers " +"Adds a polygon to an existing topology and returns 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:893 +#: extras_topology.xml:890 #, no-c-format msgid "" ", , , " @@ -1555,7 +1556,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:908 +#: extras_topology.xml:905 #, no-c-format msgid "" "This section covers topology functions for adding, moving, deleting, and " @@ -1564,19 +1565,19 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:911 +#: extras_topology.xml:908 #, no-c-format msgid "Topology Editors" msgstr "" #. Tag: refname -#: extras_topology.xml:915 +#: extras_topology.xml:912 #, no-c-format msgid "ST_AddIsoNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:917 +#: extras_topology.xml:914 #, no-c-format msgid "" "Adds an isolated node to a face in a topology and returns the nodeid of the " @@ -1584,7 +1585,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:922 +#: extras_topology.xml:919 #, no-c-format msgid "" "integer ST_AddIsoNode " @@ -1594,7 +1595,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:934 +#: extras_topology.xml:931 #, no-c-format msgid "" "Adds an isolated node with point location apoint to an " @@ -1603,7 +1604,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:935 +#: extras_topology.xml:932 #, no-c-format msgid "" "If the spatial reference system (srid) of the point geometry is not the same " @@ -1614,7 +1615,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:937 +#: extras_topology.xml:934 #, no-c-format msgid "" "If aface is not null and the apoint is " @@ -1622,13 +1623,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:941 +#: extras_topology.xml:938 #, no-c-format msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X+1.3.1" msgstr "" #. Tag: para -#: extras_topology.xml:954 +#: extras_topology.xml:951 #, no-c-format msgid "" ", , , " @@ -1636,13 +1637,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:960 +#: extras_topology.xml:957 #, no-c-format msgid "ST_AddIsoEdge" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:962 +#: extras_topology.xml:959 #, no-c-format msgid "" "Adds an isolated edge defined by geometry alinestringinteger ST_AddIsoEdge " @@ -1664,7 +1665,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:980 +#: extras_topology.xml:977 #, no-c-format msgid "" "Adds an isolated edge defined by geometry alinestringalinestring " @@ -1684,7 +1685,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:983 +#: extras_topology.xml:980 #, no-c-format msgid "" "If the alinestring is not within the face of the face the " @@ -1693,7 +1694,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:984 +#: extras_topology.xml:981 #, no-c-format msgid "" "If the anode and anothernode are not " @@ -1702,26 +1703,26 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:988 +#: extras_topology.xml:985 #, 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:1001 +#: extras_topology.xml:998 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1007 +#: extras_topology.xml:1004 #, no-c-format msgid "ST_AddEdgeNewFaces" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1009 +#: extras_topology.xml:1006 #, no-c-format msgid "" "Add a new edge and, if in doing so it splits a face, delete the original " @@ -1729,7 +1730,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1014 +#: extras_topology.xml:1011 #, no-c-format msgid "" "integer ST_AddEdgeNewFaces " @@ -1741,7 +1742,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1027 +#: extras_topology.xml:1024 #, no-c-format msgid "" "Add a new edge and, if in doing so it splits a face, delete the original " @@ -1750,14 +1751,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1033 extras_topology.xml:1099 extras_topology.xml:1162 -#: extras_topology.xml:1230 +#: extras_topology.xml:1030 extras_topology.xml:1096 extras_topology.xml:1159 +#: extras_topology.xml:1227 #, no-c-format msgid "Updates all existing joined edges and relationships accordingly." msgstr "" #. Tag: para -#: extras_topology.xml:1037 extras_topology.xml:1103 +#: extras_topology.xml:1034 extras_topology.xml:1100 #, no-c-format msgid "" "If any arguments are null, the given nodes are unknown (must already exist " @@ -1768,7 +1769,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1040 extras_topology.xml:1106 extras_topology.xml:1301 +#: extras_topology.xml:1037 extras_topology.xml:1103 extras_topology.xml:1298 #, no-c-format msgid "" "If the spatial reference system (srid) of the acurve " @@ -1776,20 +1777,20 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1044 +#: extras_topology.xml:1041 #, 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:1064 +#: extras_topology.xml:1061 #, no-c-format msgid "ST_AddEdgeModFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1066 +#: extras_topology.xml:1063 #, no-c-format msgid "" "Add a new edge and, if in doing so it splits a face, modify the original " @@ -1797,7 +1798,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1071 +#: extras_topology.xml:1068 #, no-c-format msgid "" "integer ST_AddEdgeModFace " @@ -1809,7 +1810,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1084 +#: extras_topology.xml:1081 #, no-c-format msgid "" "Add a new edge and, if doing so splits a face, modify the original face and " @@ -1817,7 +1818,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1089 +#: extras_topology.xml:1086 #, no-c-format msgid "" "If possible, the new face will be created on left side of the new edge. This " @@ -1826,26 +1827,26 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1095 +#: extras_topology.xml:1092 #, no-c-format msgid "Returns the id of the newly added edge." msgstr "" #. Tag: para -#: extras_topology.xml:1109 +#: extras_topology.xml:1106 #, 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:1129 +#: extras_topology.xml:1126 #, no-c-format msgid "ST_RemEdgeNewFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1131 +#: extras_topology.xml:1128 #, no-c-format msgid "" "Removes an edge and, if the removed edge separated two faces, " @@ -1853,7 +1854,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1139 +#: extras_topology.xml:1136 #, no-c-format msgid "" "integer ST_RemEdgeNewFace " @@ -1862,7 +1863,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1150 +#: extras_topology.xml:1147 #, no-c-format msgid "" "Removes an edge and, if the removed edge separated two faces, delete " @@ -1870,7 +1871,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1155 +#: extras_topology.xml:1152 #, no-c-format msgid "" "Returns the id of a newly created face or NULL, if no new face is created. " @@ -1880,7 +1881,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1166 +#: extras_topology.xml:1163 #, no-c-format msgid "" "Refuses to remove an edge participating in the definition of an existing " @@ -1889,7 +1890,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1173 extras_topology.xml:1241 +#: extras_topology.xml:1170 extras_topology.xml:1238 #, no-c-format msgid "" "If any arguments are null, the given edge is unknown (must already exist in " @@ -1898,20 +1899,20 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1181 +#: extras_topology.xml:1178 #, 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:1201 +#: extras_topology.xml:1198 #, no-c-format msgid "ST_RemEdgeModFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1203 +#: extras_topology.xml:1200 #, no-c-format msgid "" "Removes an edge and, if the removed edge separated two faces, delete one of " @@ -1919,7 +1920,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1211 +#: extras_topology.xml:1208 #, no-c-format msgid "" "integer ST_RemEdgeModFace " @@ -1928,7 +1929,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1222 +#: extras_topology.xml:1219 #, no-c-format msgid "" "Removes an edge and, if the removed edge separated two faces, delete one of " @@ -1939,7 +1940,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1234 +#: extras_topology.xml:1231 #, no-c-format msgid "" "Refuses to remove an edge partecipating in the definition of an existing " @@ -1948,20 +1949,20 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1249 +#: extras_topology.xml:1246 #, 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:1269 +#: extras_topology.xml:1266 #, no-c-format msgid "ST_ChangeEdgeGeom" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1271 +#: extras_topology.xml:1268 #, no-c-format msgid "" "Changes the shape of an edge without affecting the topology " @@ -1969,7 +1970,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1278 +#: extras_topology.xml:1275 #, no-c-format msgid "" "integer ST_ChangeEdgeGeom " @@ -1979,7 +1980,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1290 +#: extras_topology.xml:1287 #, no-c-format msgid "" "Changes the shape of an edge without affecting the topology structure." @@ -1987,7 +1988,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1293 +#: extras_topology.xml:1290 #, no-c-format msgid "" "If any arguments are null, the given edge does not exist in the " @@ -1999,14 +2000,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1302 +#: extras_topology.xml:1299 #, no-c-format msgid "" "If the new acurve is not simple, then an error is thrown." msgstr "" #. Tag: para -#: extras_topology.xml:1304 +#: extras_topology.xml:1301 #, no-c-format msgid "" "If moving the edge from old to new position would hit an obstacle then an " @@ -2014,26 +2015,26 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1310 extras_topology.xml:3082 extras_topology.xml:3138 +#: extras_topology.xml:1307 extras_topology.xml:3069 extras_topology.xml:3122 #, no-c-format msgid "Availability: 1.1.0" msgstr "" #. Tag: para -#: extras_topology.xml:1313 +#: extras_topology.xml:1310 #, no-c-format msgid "Enhanced: 2.0.0 adds topological consistency enforcement" msgstr "" #. Tag: para -#: extras_topology.xml:1317 +#: extras_topology.xml:1314 #, 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:1323 +#: extras_topology.xml:1320 #, no-c-format msgid "" "SELECT topology.ST_ChangeEdgeGeom('ma_topo', 1,\n" @@ -2044,13 +2045,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1337 +#: extras_topology.xml:1334 #, no-c-format msgid "ST_ModEdgeSplit" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1339 +#: extras_topology.xml:1336 #, no-c-format msgid "" "Split an edge by creating a new node along an existing edge, modifying the " @@ -2058,7 +2059,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1344 +#: extras_topology.xml:1341 #, no-c-format msgid "" "integer ST_ModEdgeSplit " @@ -2068,7 +2069,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1356 +#: extras_topology.xml:1353 #, no-c-format msgid "" "Split an edge by creating a new node along an existing edge, modifying the " @@ -2077,20 +2078,20 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1365 +#: extras_topology.xml:1362 #, no-c-format msgid "Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit" msgstr "" #. Tag: para -#: extras_topology.xml:1366 extras_topology.xml:1420 extras_topology.xml:1470 +#: extras_topology.xml:1363 extras_topology.xml:1417 extras_topology.xml:1467 #, 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:1372 +#: extras_topology.xml:1369 #, no-c-format msgid "" "-- Add an edge --\n" @@ -2110,7 +2111,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1378 +#: extras_topology.xml:1375 #, no-c-format msgid "" ", , , " @@ -2118,21 +2119,21 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1389 +#: extras_topology.xml:1386 #, no-c-format msgid "ST_ModEdgeHeal" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1391 +#: extras_topology.xml:1388 #, no-c-format msgid "" -"Heal two edges by deleting the node connecting them, modifying the first " +"Heals 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:1399 +#: extras_topology.xml:1396 #, no-c-format msgid "" "int ST_ModEdgeHeal " @@ -2142,31 +2143,31 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1411 +#: extras_topology.xml:1408 #, no-c-format msgid "" -"Heal two edges by deleting the node connecting them, modifying the first " +"Heals 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:1436 +#: extras_topology.xml:1433 #, no-c-format msgid "ST_NewEdgeHeal" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1438 +#: extras_topology.xml:1435 #, no-c-format msgid "" -"Heal two edges by deleting the node connecting them, deleting both edges, " +"Heals 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:1447 +#: extras_topology.xml:1444 #, no-c-format msgid "" "int ST_NewEdgeHeal " @@ -2176,23 +2177,23 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1459 +#: extras_topology.xml:1456 #, no-c-format msgid "" -"Heal two edges by deleting the node connecting them, deleting both edges, " +"Heals 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:1487 +#: extras_topology.xml:1484 #, no-c-format msgid "ST_MoveIsoNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1489 +#: extras_topology.xml:1486 #, no-c-format msgid "" "Moves an isolated node in a topology from one point to another. If new " @@ -2201,7 +2202,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1494 +#: extras_topology.xml:1491 #, no-c-format msgid "" "text ST_MoveIsoNode " @@ -2211,7 +2212,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1506 +#: extras_topology.xml:1503 #, no-c-format msgid "" "Moves an isolated node in a topology from one point to another. If new " @@ -2219,7 +2220,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1507 +#: extras_topology.xml:1504 #, no-c-format msgid "" "If any arguments are null, the apoint is not a point, the " @@ -2229,7 +2230,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1508 +#: extras_topology.xml:1505 #, no-c-format msgid "" "If the spatial reference system (srid) of the point geometry is not the same " @@ -2237,13 +2238,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1513 +#: extras_topology.xml:1510 #, no-c-format msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.2" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1519 +#: extras_topology.xml:1516 #, no-c-format msgid "" "-- Add an isolated node with no face --\n" @@ -2261,13 +2262,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1530 +#: extras_topology.xml:1527 #, no-c-format msgid "ST_NewEdgesSplit" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1532 +#: extras_topology.xml:1529 #, no-c-format msgid "" "Split an edge by creating a new node along an existing edge, deleting the " @@ -2276,7 +2277,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1537 +#: extras_topology.xml:1534 #, no-c-format msgid "" "integer ST_NewEdgesSplit " @@ -2286,7 +2287,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1549 +#: extras_topology.xml:1546 #, no-c-format msgid "" "Split an edge with edge id anedge by creating a new node " @@ -2297,7 +2298,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1557 +#: extras_topology.xml:1554 #, no-c-format msgid "" "If the spatial reference system (srid) of the point geometry is not the same " @@ -2308,13 +2309,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1562 +#: extras_topology.xml:1559 #, no-c-format msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.8" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1568 +#: extras_topology.xml:1565 #, no-c-format msgid "" "-- Add an edge --\n" @@ -2333,13 +2334,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1585 +#: extras_topology.xml:1582 #, no-c-format msgid "ST_RemoveIsoNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1587 +#: extras_topology.xml:1584 #, no-c-format msgid "" "Removes an isolated node and returns description of action. If " @@ -2348,7 +2349,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1592 +#: extras_topology.xml:1589 #, no-c-format msgid "" "text ST_RemoveIsoNode " @@ -2357,7 +2358,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1603 +#: extras_topology.xml:1600 #, no-c-format msgid "" "Removes an isolated node and returns description of action. If the " @@ -2366,14 +2367,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1608 extras_topology.xml:1649 +#: extras_topology.xml:1605 extras_topology.xml:1646 #, 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:1614 extras_topology.xml:1655 +#: extras_topology.xml:1611 extras_topology.xml:1652 #, no-c-format msgid "" "-- Remove an isolated node with no face --\n" @@ -2384,13 +2385,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1626 +#: extras_topology.xml:1623 #, no-c-format msgid "ST_RemoveIsoEdge" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1628 +#: extras_topology.xml:1625 #, no-c-format msgid "" "Removes an isolated edge and returns description of action. If " @@ -2398,7 +2399,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1633 +#: extras_topology.xml:1630 #, no-c-format msgid "" "text ST_RemoveIsoEdge " @@ -2407,7 +2408,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1644 +#: extras_topology.xml:1641 #, no-c-format msgid "" "Removes an isolated edge and returns description of action. If the " @@ -2415,41 +2416,41 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:1668 +#: extras_topology.xml:1665 #, no-c-format msgid "Topology Accessors" msgstr "" #. Tag: refname -#: extras_topology.xml:1671 +#: extras_topology.xml:1668 #, no-c-format msgid "GetEdgeByPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1673 +#: extras_topology.xml:1670 #, no-c-format -msgid "Find the edge-id of an edge that intersects a given point" +msgid "Finds the edge-id of an edge that intersects a given point." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1678 +#: extras_topology.xml:1675 #, no-c-format msgid "" "integer GetEdgeByPoint " "varchar atopology " "geometry apoint " -"float8 tol" +"float8 tol1" msgstr "" -#. Tag: title -#: extras_topology.xml:1689 +#. Tag: para +#: extras_topology.xml:1688 #, no-c-format -msgid "Retrieve the id of an edge that intersects a Point" +msgid "Retrieves the id of an edge that intersects a Point." msgstr "" #. Tag: para -#: extras_topology.xml:1691 +#: extras_topology.xml:1689 #, no-c-format msgid "" "The function returns an integer (id-edge) given a topology, a POINT and a " @@ -2457,13 +2458,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1692 +#: extras_topology.xml:1690 #, no-c-format -msgid "If the point doesn't intersect an edge, returns 0 (zero)." +msgid "" +"If apoint doesn't intersect an edge, returns 0 (zero)." msgstr "" #. Tag: para -#: extras_topology.xml:1693 +#: extras_topology.xml:1691 #, no-c-format msgid "" "If use tolerance > 0 and there is more than one edge near the point then an " @@ -2471,26 +2473,27 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1698 +#: extras_topology.xml:1695 extras_topology.xml:1744 extras_topology.xml:1793 #, no-c-format msgid "" -"If tolerance = 0, the function use ST_Intersects otherwise uses ST_DWithin." +"If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin." msgstr "" #. Tag: para -#: extras_topology.xml:1701 extras_topology.xml:1751 extras_topology.xml:1802 +#: extras_topology.xml:1697 extras_topology.xml:1746 extras_topology.xml:1795 +#: extras_topology.xml:2281 extras_topology.xml:2399 #, no-c-format -msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." +msgid "Performed by the GEOS module." msgstr "" #. Tag: para -#: extras_topology.xml:1707 extras_topology.xml:1808 +#: extras_topology.xml:1704 extras_topology.xml:1802 #, no-c-format msgid "These examples use edges we created in " msgstr "" #. Tag: programlisting -#: extras_topology.xml:1708 +#: extras_topology.xml:1705 #, no-c-format msgid "" "SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology." @@ -2502,7 +2505,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1709 +#: extras_topology.xml:1706 #, no-c-format msgid "" "SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As nearnode\n" @@ -2513,42 +2516,42 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1716 +#: extras_topology.xml:1713 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1726 +#: extras_topology.xml:1723 #, no-c-format msgid "GetFaceByPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1727 +#: extras_topology.xml:1724 #, no-c-format -msgid "Find the face-id of a face that intersects a given point" +msgid "Finds the face-id of a face that intersects a given point." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1731 +#: extras_topology.xml:1728 #, no-c-format msgid "" "integer GetFaceByPoint " "varchar atopology " "geometry apoint " -"float8 tol" +"float8 tol1" msgstr "" #. Tag: para -#: extras_topology.xml:1741 +#: extras_topology.xml:1739 #, no-c-format -msgid "Retrieve the id of a face that intersects a Point." +msgid "Retrieves the id of a face that intersects a Point." msgstr "" #. Tag: para -#: extras_topology.xml:1742 +#: extras_topology.xml:1740 #, no-c-format msgid "" "The function returns an integer (id-face) given a topology, a POINT and a " @@ -2556,13 +2559,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1743 +#: extras_topology.xml:1741 #, no-c-format -msgid "If the point doesn't intersect a face, returns 0 (zero)." +msgid "" +"If apoint doesn't intersect a face, returns 0 (zero)." msgstr "" #. Tag: para -#: extras_topology.xml:1744 +#: extras_topology.xml:1742 #, no-c-format msgid "" "If use tolerance > 0 and there is more than one face near the point then an " @@ -2570,20 +2574,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1748 -#, no-c-format -msgid "" -"If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin." -msgstr "" - -#. Tag: para -#: extras_topology.xml:1755 +#: extras_topology.xml:1751 #, no-c-format msgid "These examples use edges faces created in " msgstr "" #. Tag: programlisting -#: extras_topology.xml:1756 +#: extras_topology.xml:1752 #, no-c-format msgid "" "SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology." @@ -2596,7 +2593,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1757 +#: extras_topology.xml:1753 #, no-c-format msgid "" "SELECT topology.GetFaceByPoint('ma_topo',geom, 1) As nearnode\n" @@ -2607,73 +2604,66 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1762 +#: extras_topology.xml:1758 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1772 +#: extras_topology.xml:1768 #, no-c-format msgid "GetNodeByPoint" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1774 +#: extras_topology.xml:1770 #, no-c-format -msgid "Find the id of a node at a point location" +msgid "Finds the node-id of a node at a point location." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1779 +#: extras_topology.xml:1775 #, no-c-format msgid "" "integer GetNodeByPoint " "varchar atopology " -"geometry point " -"float8 tol" -msgstr "" - -#. Tag: title -#: extras_topology.xml:1790 -#, no-c-format -msgid "Retrieve the id of a node at a point location" +"geometry apoint " +"float8 tol1" msgstr "" #. Tag: para -#: extras_topology.xml:1792 +#: extras_topology.xml:1788 #, 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." +msgid "Retrieves the id of a node at a point location." msgstr "" #. Tag: para -#: extras_topology.xml:1793 +#: extras_topology.xml:1789 #, no-c-format -msgid "If there isn't a node at the point, it return 0 (zero)." +msgid "" +"The function returns an integer (id-node) given a topology, a POINT and a " +"tolerance. If tolerance = 0 means exact intersection, otherwise retrieves " +"the node from an interval." msgstr "" #. Tag: para -#: extras_topology.xml:1794 +#: extras_topology.xml:1790 #, no-c-format msgid "" -"If use tolerance > 0 and near the point there are more than one node it " -"throw an exception." +"If apoint doesn't intersect a node, returns 0 (zero)." msgstr "" #. Tag: para -#: extras_topology.xml:1799 +#: extras_topology.xml:1791 #, no-c-format msgid "" -"If tolerance = 0, the function use ST_Intersects otherwise will use " -"ST_DWithin." +"If use tolerance > 0 and there is more than one node near the point then an " +"exception is thrown." msgstr "" #. Tag: programlisting -#: extras_topology.xml:1809 +#: extras_topology.xml:1803 #, no-c-format msgid "" "SELECT topology.GetNodeByPoint('ma_topo',geom, 1) As nearnode\n" @@ -2684,7 +2674,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1810 +#: extras_topology.xml:1804 #, no-c-format msgid "" "SELECT topology.GetNodeByPoint('ma_topo',geom, 1000) As too_much_tolerance\n" @@ -2695,20 +2685,20 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1817 +#: extras_topology.xml:1811 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:1827 +#: extras_topology.xml:1821 #, no-c-format msgid "GetTopologyID" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1829 +#: extras_topology.xml:1823 #, no-c-format msgid "" "Returns the id of a topology in the topology.topology table " @@ -2716,7 +2706,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1834 extras_topology.xml:1876 +#: extras_topology.xml:1828 extras_topology.xml:1870 #, no-c-format msgid "" "integer GetTopologyID " @@ -2724,7 +2714,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1844 +#: extras_topology.xml:1838 #, no-c-format msgid "" "Returns the id of a topology in the topology.topology table given the " @@ -2732,7 +2722,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1852 +#: extras_topology.xml:1846 #, no-c-format msgid "" "SELECT topology.GetTopologyID('ma_topo') As topo_id;\n" @@ -2742,7 +2732,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1858 +#: extras_topology.xml:1852 #, no-c-format msgid "" ", , , " @@ -2750,13 +2740,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1869 +#: extras_topology.xml:1863 #, no-c-format msgid "GetTopologySRID" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1871 +#: extras_topology.xml:1865 #, no-c-format msgid "" "Returns the SRID of a topology in the topology.topology table given the name " @@ -2764,7 +2754,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1886 +#: extras_topology.xml:1880 #, no-c-format msgid "" "Returns the spatial reference id of a topology in the topology.topology " @@ -2772,7 +2762,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1894 +#: extras_topology.xml:1888 #, no-c-format msgid "" "SELECT topology.GetTopologySRID('ma_topo') As SRID;\n" @@ -2782,7 +2772,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1900 +#: extras_topology.xml:1894 #, no-c-format msgid "" ", , , " @@ -2790,19 +2780,19 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:1911 +#: extras_topology.xml:1905 #, no-c-format msgid "GetTopologyName" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:1913 +#: extras_topology.xml:1907 #, no-c-format msgid "Returns the name of a topology (schema) given the id of the topology." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1918 +#: extras_topology.xml:1912 #, no-c-format msgid "" "varchar GetTopologyName " @@ -2810,7 +2800,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1928 +#: extras_topology.xml:1922 #, no-c-format msgid "" "Returns the topology name (schema) of a topology from the topology.topology " @@ -2818,7 +2808,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1936 +#: extras_topology.xml:1930 #, no-c-format msgid "" "SELECT topology.GetTopologyName(1) As topo_name;\n" @@ -2828,7 +2818,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1942 +#: extras_topology.xml:1936 #, no-c-format msgid "" ", , , aface." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:1960 +#: extras_topology.xml:1954 #, no-c-format msgid "" "getfaceedges_returntype ST_GetFaceEdgesaface. Each " @@ -2867,7 +2857,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1973 +#: extras_topology.xml:1967 #, no-c-format msgid "" "Enumeration of each ring edges start from the edge with smallest identifier. " @@ -2876,14 +2866,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1980 +#: extras_topology.xml:1974 #, 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:1986 +#: extras_topology.xml:1980 #, no-c-format msgid "" "-- Returns the edges bounding face 1\n" @@ -2902,7 +2892,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:1987 +#: extras_topology.xml:1981 #, no-c-format msgid "" "-- Returns the sequence, edge id\n" @@ -2914,25 +2904,25 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:1993 +#: extras_topology.xml:1987 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: extras_topology.xml:2003 +#: extras_topology.xml:1997 #, no-c-format msgid "ST_GetFaceGeometry" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2005 +#: extras_topology.xml:1999 #, no-c-format msgid "Returns the polygon in the given topology with the specified face id." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2010 +#: extras_topology.xml:2004 #, no-c-format msgid "" "geometry ST_GetFaceGeometry " @@ -2941,7 +2931,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2021 +#: extras_topology.xml:2015 #, no-c-format msgid "" "Returns the polygon in the given topology with the specified face id. Builds " @@ -2949,14 +2939,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2026 +#: extras_topology.xml:2020 #, 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:2032 +#: extras_topology.xml:2026 #, no-c-format msgid "" "-- Returns the wkt of the polygon added with AddFace\n" @@ -2972,13 +2962,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:2044 +#: extras_topology.xml:2038 #, no-c-format msgid "GetRingEdges" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2046 +#: extras_topology.xml:2040 #, no-c-format msgid "" "Returns the ordered set of signed edge identifiers met by walking on an a " @@ -2986,7 +2976,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2054 +#: extras_topology.xml:2048 #, no-c-format msgid "" "getfaceedges_returntype GetRingEdges " @@ -2997,7 +2987,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2066 +#: extras_topology.xml:2060 #, no-c-format msgid "" "Returns the ordered set of signed edge identifiers met by walking on an a " @@ -3006,7 +2996,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2073 +#: extras_topology.xml:2067 #, no-c-format msgid "" "If you pass a positive edge id, the walk starts on the left side of the " @@ -3015,7 +3005,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2080 +#: extras_topology.xml:2074 #, no-c-format msgid "" "If max_edges is not null no more than those records are " @@ -3024,31 +3014,31 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2086 +#: extras_topology.xml:2080 #, no-c-format msgid "This function uses edge ring linking metadata." msgstr "" #. Tag: para -#: extras_topology.xml:2098 +#: extras_topology.xml:2092 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:2107 +#: extras_topology.xml:2101 #, no-c-format msgid "GetNodeEdges" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2109 +#: extras_topology.xml:2103 #, no-c-format msgid "Returns an ordered set of edges incident to the given node." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2116 +#: extras_topology.xml:2110 #, no-c-format msgid "" "getfaceedges_returntype GetNodeEdges " @@ -3057,7 +3047,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2127 +#: extras_topology.xml:2121 #, no-c-format msgid "" "Returns an ordered set of edges incident to the given node. Each output " @@ -3068,7 +3058,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2138 +#: extras_topology.xml:2132 #, no-c-format msgid "" "This function computes ordering rather than deriving from metadata and is " @@ -3076,13 +3066,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2151 +#: extras_topology.xml:2145 #, no-c-format msgid ", " msgstr "" #. Tag: para -#: extras_topology.xml:2164 +#: extras_topology.xml:2158 #, no-c-format msgid "" "This section covers the functions for processing topologies in non-standard " @@ -3090,25 +3080,25 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:2167 +#: extras_topology.xml:2161 #, no-c-format msgid "Topology Processing" msgstr "" #. Tag: refname -#: extras_topology.xml:2170 +#: extras_topology.xml:2164 #, no-c-format msgid "Polygonize" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2171 +#: extras_topology.xml:2165 #, no-c-format -msgid "Find and register all faces defined by topology edges" +msgid "Finds and registers all faces defined by topology edges." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2175 +#: extras_topology.xml:2169 #, no-c-format msgid "" "text Polygonize " @@ -3116,19 +3106,19 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2185 +#: extras_topology.xml:2179 #, no-c-format -msgid "Register all faces that can be built out a topology edge primitives." +msgid "Registers all faces that can be built out a topology edge primitives." msgstr "" #. Tag: para -#: extras_topology.xml:2186 +#: extras_topology.xml:2180 #, no-c-format msgid "The target topology is assumed to contain no self-intersecting edges." msgstr "" #. Tag: para -#: extras_topology.xml:2187 +#: extras_topology.xml:2181 #, no-c-format msgid "" "Already known faces are recognized, so it is safe to call Polygonize " @@ -3136,7 +3126,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2188 extras_topology.xml:2345 +#: extras_topology.xml:2182 extras_topology.xml:2334 #, no-c-format msgid "" "This function does not use nor set the next_left_edge and next_right_edge " @@ -3144,19 +3134,19 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2200 +#: extras_topology.xml:2194 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:2206 +#: extras_topology.xml:2200 #, no-c-format msgid "AddNode" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2208 +#: extras_topology.xml:2202 #, no-c-format msgid "" "Adds a point node to the node table in the specified topology schema and " @@ -3165,7 +3155,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2213 +#: extras_topology.xml:2207 #, no-c-format msgid "" "integer AddNode " @@ -3178,7 +3168,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2226 +#: extras_topology.xml:2220 #, no-c-format msgid "" "Adds a point node to the node table in the specified topology schema. The " @@ -3187,7 +3177,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2233 +#: extras_topology.xml:2227 #, no-c-format msgid "" "If any edge crossing the node is found either an exception is raised or the " @@ -3196,7 +3186,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2239 +#: extras_topology.xml:2233 #, no-c-format msgid "" "If computeContainingFace is true a newly added node would " @@ -3204,7 +3194,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2244 +#: extras_topology.xml:2238 #, no-c-format msgid "" "If the apoint geometry already exists as a node, the node " @@ -3212,7 +3202,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2253 +#: extras_topology.xml:2247 #, no-c-format msgid "" "SELECT topology.AddNode('ma_topo', ST_GeomFromText('POINT(227641.6 " @@ -3224,13 +3214,13 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:2265 +#: extras_topology.xml:2259 #, no-c-format msgid "AddEdge" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2267 +#: extras_topology.xml:2261 #, no-c-format msgid "" "Adds a linestring edge to the edge table and associated start and end points " @@ -3240,7 +3230,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2272 +#: extras_topology.xml:2266 #, no-c-format msgid "" "integer AddEdge " @@ -3249,7 +3239,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2283 +#: extras_topology.xml:2277 #, no-c-format msgid "" "Adds an edge to the edge table and associated nodes to the nodes table of " @@ -3259,7 +3249,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2285 +#: extras_topology.xml:2279 #, no-c-format msgid "" "If the aline geometry crosses, overlaps, contains or is " @@ -3268,7 +3258,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2286 +#: extras_topology.xml:2280 #, no-c-format msgid "" "The geometry of aline must have the same srid, " msgstr "" #. Tag: refname -#: extras_topology.xml:2312 +#: extras_topology.xml:2303 #, no-c-format msgid "AddFace" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2314 +#: extras_topology.xml:2305 #, no-c-format msgid "" "Registers a face primitive to a topology and gets its identifier." @@ -3330,7 +3314,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2321 +#: extras_topology.xml:2310 #, no-c-format msgid "" "integer AddFace " @@ -3341,7 +3325,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2333 +#: extras_topology.xml:2322 #, no-c-format msgid "" "Registers a face primitive to a topology and gets its identifier.apolygon geometry already exists as a face, then: " @@ -3378,7 +3362,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2359 +#: extras_topology.xml:2348 #, no-c-format msgid "" "When a new registration of an existing face is performed (force_new=true), " @@ -3388,7 +3372,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2366 +#: extras_topology.xml:2355 #, no-c-format msgid "" "The apolygon geometry must have the same sridgeometry ST_Simplify " -"TopoGeometry geomA " -"float tolerance" +"TopoGeometry tg " +"float8 tolerance" msgstr "" #. Tag: para -#: extras_topology.xml:2404 +#: extras_topology.xml:2393 #, no-c-format msgid "" "Returns a \"simplified\" geometry version of the given TopoGeometry using " @@ -3475,31 +3459,25 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2407 +#: extras_topology.xml:2396 #, no-c-format msgid "The returned geometry may be non-simple or non-valid." msgstr "" #. Tag: para -#: extras_topology.xml:2408 +#: extras_topology.xml:2397 #, no-c-format msgid "Splitting component edges may help retaining simplicity/validity." msgstr "" #. Tag: para -#: extras_topology.xml:2410 -#, no-c-format -msgid "Performed by the GEOS module." -msgstr "" - -#. Tag: para -#: extras_topology.xml:2411 extras_topology.xml:3030 +#: extras_topology.xml:2400 extras_topology.xml:3017 #, no-c-format msgid "Availability: 2.1.0" msgstr "" #. Tag: para -#: extras_topology.xml:2416 +#: extras_topology.xml:2405 #, no-c-format msgid "" "Geometry , , " @@ -3507,26 +3485,26 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2426 +#: extras_topology.xml:2415 #, no-c-format msgid "" "This section covers the topology functions for creating new topogeometries." msgstr "" #. Tag: title -#: extras_topology.xml:2429 +#: extras_topology.xml:2418 #, no-c-format msgid "TopoGeometry Constructors" msgstr "" #. Tag: refname -#: extras_topology.xml:2432 +#: extras_topology.xml:2421 #, no-c-format msgid "CreateTopoGeom" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2434 +#: extras_topology.xml:2423 #, no-c-format msgid "" "Creates a new topo geometry object from topo element array - tg_type: 1:" @@ -3534,7 +3512,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:2438 +#: extras_topology.xml:2427 #, no-c-format msgid "" " topogeometry CreateTopoGeomtoponame schema." +"Creates a topogeometry object for layer denoted by layer_id and registers it in the relations table in the toponame schema." msgstr "" #. Tag: para -#: extras_topology.xml:2460 +#: extras_topology.xml:2449 #, 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." +"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:2461 +#: extras_topology.xml:2450 #, no-c-format msgid "" "punctal layers are formed from set of nodes, lineal layers are formed from a " @@ -3576,20 +3555,20 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2463 +#: extras_topology.xml:2452 #, no-c-format msgid "" "Omitting the array of components generates an empty TopoGeometry object." msgstr "" #. Tag: title -#: extras_topology.xml:2470 +#: extras_topology.xml:2459 #, no-c-format msgid "Examples: Form from existing edges" msgstr "" #. Tag: para -#: extras_topology.xml:2471 +#: extras_topology.xml:2460 #, no-c-format msgid "" "Create a topogeom in ri_topo schema for layer 2 (our ri_roads), of type (2) " @@ -3597,7 +3576,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2472 +#: extras_topology.xml:2461 #, no-c-format msgid "" "INSERT INTO ri.ri_roads(road_name, topo) VALUES('Unknown', topology." @@ -3605,13 +3584,13 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:2477 +#: extras_topology.xml:2466 #, no-c-format msgid "Examples: Convert an areal geometry to best guess topogeometry" msgstr "" #. Tag: para -#: extras_topology.xml:2478 +#: extras_topology.xml:2467 #, no-c-format msgid "" "Lets say we have geometries that should be formed from a collection of " @@ -3621,7 +3600,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2480 +#: extras_topology.xml:2469 #, no-c-format msgid "" "-- create our topo geometry column --\n" @@ -3649,7 +3628,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2482 +#: extras_topology.xml:2471 #, no-c-format msgid "" "--the world is rarely perfect allow for some error\n" @@ -3685,7 +3664,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2488 +#: extras_topology.xml:2477 #, no-c-format msgid "" ", , topogeometry toTopoGeom." msgstr "" #. Tag: para -#: extras_topology.xml:2534 +#: extras_topology.xml:2521 #, no-c-format msgid "" "Topological primitives required to represent the input geometry will be " @@ -3739,7 +3718,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2541 +#: extras_topology.xml:2528 #, no-c-format msgid "" "Existing TopoGeometry objects (with the possible exception of " @@ -3747,7 +3726,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2546 +#: extras_topology.xml:2533 #, no-c-format msgid "" "When tolerance is given it will be used to snap the input " @@ -3755,7 +3734,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2551 +#: extras_topology.xml:2538 #, no-c-format msgid "" "In the first form a new TopoGeometry will be created for the given layer " @@ -3764,7 +3743,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2556 +#: extras_topology.xml:2543 #, no-c-format msgid "" "In the second form the primitives resulting from the conversion will be " @@ -3774,19 +3753,19 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2565 +#: extras_topology.xml:2552 #, no-c-format msgid "Enhanced: 2.1.0 adds the version taking an existing TopoGeometry." msgstr "" #. Tag: para -#: extras_topology.xml:2569 +#: extras_topology.xml:2556 #, no-c-format msgid "This is a full self-contained workflow" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2570 +#: extras_topology.xml:2557 #, no-c-format msgid "" "-- do this if you don't have a topology setup already\n" @@ -3820,7 +3799,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2572 +#: extras_topology.xml:2559 #, no-c-format msgid "" "-- Shrink all TopoGeometry polygons by 10 meters\n" @@ -3838,7 +3817,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2578 +#: extras_topology.xml:2565 #, no-c-format msgid "" ", , topoelementarray for a set of element_id, type " -"arrays (topoelements)" +"arrays (topoelements)." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2596 +#: extras_topology.xml:2583 #, no-c-format msgid "" "topoelementarray TopoElementArray_Agg from a set of " msgstr "" #. Tag: para -#: extras_topology.xml:2627 +#: extras_topology.xml:2614 #, no-c-format msgid "" "This section covers the topology functions for editing existing " @@ -3902,25 +3881,25 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:2630 +#: extras_topology.xml:2617 #, no-c-format msgid "TopoGeometry Editors" msgstr "" #. Tag: refname -#: extras_topology.xml:2634 +#: extras_topology.xml:2621 #, no-c-format msgid "clearTopoGeom" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2636 +#: extras_topology.xml:2623 #, no-c-format -msgid "Clears the content of a topo geometry" +msgid "Clears the content of a topo geometry." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2641 +#: extras_topology.xml:2628 #, no-c-format msgid "" "topogeometry clearTopoGeom " @@ -3929,7 +3908,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2651 +#: extras_topology.xml:2638 #, no-c-format msgid "" "Clears the content a turning it into an " @@ -3939,13 +3918,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2659 +#: extras_topology.xml:2646 #, no-c-format msgid "Availability: 2.1" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2663 +#: extras_topology.xml:2650 #, no-c-format msgid "" "-- Shrink all TopoGeometry polygons by 10 meters\n" @@ -3953,19 +3932,19 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:2677 +#: extras_topology.xml:2664 #, no-c-format msgid "TopoGeom_addElement" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2678 +#: extras_topology.xml:2665 #, no-c-format -msgid "Add an element to the definition of a TopoGeometry" +msgid "Adds an element to the definition of a TopoGeometry." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2682 +#: extras_topology.xml:2669 #, no-c-format msgid "" "topogeometry TopoGeom_addElement " @@ -3974,7 +3953,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2693 +#: extras_topology.xml:2680 #, no-c-format msgid "" "Adds a to the definition of a TopoGeometry " @@ -3982,13 +3961,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2700 extras_topology.xml:2743 +#: extras_topology.xml:2687 extras_topology.xml:2730 #, no-c-format msgid "Availability: 2.3" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2704 +#: extras_topology.xml:2691 #, no-c-format msgid "" "-- Add edge 5 to TopoGeometry tg\n" @@ -3996,19 +3975,19 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:2719 +#: extras_topology.xml:2706 #, no-c-format msgid "TopoGeom_remElement" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2721 +#: extras_topology.xml:2708 #, no-c-format -msgid "Remove an element from the definition of a TopoGeometry" +msgid "Removes an element from the definition of a TopoGeometry." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2726 +#: extras_topology.xml:2713 #, no-c-format msgid "" "topogeometry TopoGeom_remElement " @@ -4017,7 +3996,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2737 +#: extras_topology.xml:2724 #, no-c-format msgid "" "Removes a from the definition of a " @@ -4025,7 +4004,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2747 +#: extras_topology.xml:2734 #, no-c-format msgid "" "-- Remove face 43 from TopoGeometry tg\n" @@ -4033,40 +4012,40 @@ msgid "" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2763 +#: extras_topology.xml:2750 #, no-c-format -msgid "Adds a geometry shape to an existing topo geometry" +msgid "Adds a geometry shape to an existing topo geometry." msgstr "" #. Tag: para -#: extras_topology.xml:2767 +#: extras_topology.xml:2754 #, no-c-format -msgid "Refer to " +msgid "Refer to ." msgstr "" #. Tag: title -#: extras_topology.xml:2777 +#: extras_topology.xml:2764 #, no-c-format msgid "TopoGeometry Accessors" msgstr "" #. Tag: refname -#: extras_topology.xml:2781 +#: extras_topology.xml:2768 #, no-c-format msgid "GetTopoGeomElementArray" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2783 +#: extras_topology.xml:2770 #, no-c-format msgid "" "Returns a topoelementarray (an array of topoelements) " "containing the topological elements and type of the given TopoGeometry " -"(primitive elements)" +"(primitive elements)." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2788 +#: extras_topology.xml:2775 #, no-c-format msgid "" "topoelementarray GetTopoGeomElementArraytopoelementarray topoelement GetTopoGeomElementArray containing the topological " @@ -4096,7 +4075,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2808 extras_topology.xml:2855 +#: extras_topology.xml:2795 extras_topology.xml:2842 #, no-c-format msgid "" "tg_id is the topogeometry id of the topogeometry object in the topology in " @@ -4104,22 +4083,22 @@ msgid "" msgstr "" #. Tag: refname -#: extras_topology.xml:2829 +#: extras_topology.xml:2816 #, no-c-format msgid "GetTopoGeomElements" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2831 +#: extras_topology.xml:2818 #, no-c-format msgid "" "Returns a set of topoelement objects containing the " "topological element_id,element_type of the given TopoGeometry (primitive " -"elements)" +"elements)." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2836 +#: extras_topology.xml:2823 #, no-c-format msgid "" "setof topoelement GetTopoGeomElementssetof topoelement GetTopoGeomElements, , " @@ -4155,25 +4134,25 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:2884 +#: extras_topology.xml:2871 #, no-c-format msgid "TopoGeometry Outputs" msgstr "" #. Tag: refname -#: extras_topology.xml:2887 +#: extras_topology.xml:2874 #, no-c-format msgid "AsGML" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2889 +#: extras_topology.xml:2876 #, no-c-format msgid "Returns the GML representation of a topogeometry." msgstr "" #. Tag: funcsynopsis -#: extras_topology.xml:2893 +#: extras_topology.xml:2880 #, no-c-format msgid "" " text AsGML " @@ -4220,7 +4199,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2954 +#: extras_topology.xml:2941 #, no-c-format msgid "" "Returns the GML representation of a topogeometry in version GML3 format. If " @@ -4231,7 +4210,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2956 +#: extras_topology.xml:2943 #, no-c-format msgid "" "The visitedTable parameter, if given, is used for keeping " @@ -4246,7 +4225,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2962 +#: extras_topology.xml:2949 #, no-c-format msgid "" "CREATE TABLE visited (\n" @@ -4256,7 +4235,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2965 +#: extras_topology.xml:2952 #, no-c-format msgid "" "The idprefix parameter, if given, will be prepended to " @@ -4264,7 +4243,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2967 +#: extras_topology.xml:2954 #, no-c-format msgid "" "The gmlver parameter, if given, will be passed to the " @@ -4272,14 +4251,14 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2976 +#: extras_topology.xml:2963 #, no-c-format msgid "" "This uses the topo geometry we created in " msgstr "" #. Tag: programlisting -#: extras_topology.xml:2977 +#: extras_topology.xml:2964 #, no-c-format msgid "" "SELECT topology.AsGML(topo) As rdgml\n" @@ -4326,13 +4305,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2978 +#: extras_topology.xml:2965 #, no-c-format msgid "Same exercise as previous without namespace" msgstr "" #. Tag: programlisting -#: extras_topology.xml:2979 +#: extras_topology.xml:2966 #, no-c-format msgid "" "SELECT topology.AsGML(topo,'') As rdgml\n" @@ -4379,25 +4358,25 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:2985 +#: extras_topology.xml:2972 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:2990 +#: extras_topology.xml:2977 #, no-c-format msgid "AsTopoJSON" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:2992 +#: extras_topology.xml:2979 #, no-c-format msgid "Returns the TopoJSON representation of a topogeometry." msgstr "" #. Tag: funcprototype -#: extras_topology.xml:2997 +#: extras_topology.xml:2984 #, no-c-format msgid "" "text AsTopoJSON " @@ -4407,7 +4386,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3008 +#: extras_topology.xml:2995 #, no-c-format msgid "" "Returns the TopoJSON representation of a topogeometry. If " @@ -4417,7 +4396,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3011 +#: extras_topology.xml:2998 #, no-c-format msgid "" "The table, if given, is expected to have an \"arc_id\" field of type \"serial" @@ -4426,7 +4405,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3016 +#: extras_topology.xml:3003 #, no-c-format msgid "" "Arc indices in the TopoJSON output are 0-based but they are 1-based in the " @@ -4434,7 +4413,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3022 +#: extras_topology.xml:3009 #, no-c-format msgid "" "A full TopoJSON document will be need to contain, in addition to the " @@ -4444,13 +4423,13 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3031 +#: extras_topology.xml:3018 #, no-c-format msgid "Enhanced: 2.2.1 added support for puntal inputs" msgstr "" #. Tag: programlisting -#: extras_topology.xml:3043 +#: extras_topology.xml:3030 #, no-c-format msgid "" "CREATE TEMP TABLE edgemap(arc_id serial, edge_id int unique);\n" @@ -4510,7 +4489,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3051 +#: extras_topology.xml:3038 #, no-c-format msgid "" "This section lists the Topology functions used to check relationships " @@ -4518,19 +4497,19 @@ msgid "" msgstr "" #. Tag: title -#: extras_topology.xml:3054 +#: extras_topology.xml:3041 #, no-c-format msgid "Topology Spatial Relationships" msgstr "" #. Tag: refname -#: extras_topology.xml:3057 +#: extras_topology.xml:3044 #, no-c-format msgid "Equals" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:3059 +#: extras_topology.xml:3046 #, no-c-format msgid "" "Returns true if two topogeometries are composed of the same topology " @@ -4538,7 +4517,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:3064 +#: extras_topology.xml:3051 #, no-c-format msgid "" "boolean Equals " @@ -4547,7 +4526,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3075 +#: extras_topology.xml:3062 #, no-c-format msgid "" "Returns true if two topogeometries are composed of the same topology " @@ -4555,7 +4534,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3079 +#: extras_topology.xml:3066 #, no-c-format msgid "" "This function not supported for topogeometries that are geometry " @@ -4564,31 +4543,31 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3086 extras_topology.xml:3142 +#: extras_topology.xml:3073 extras_topology.xml:3126 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: programlisting -#: extras_topology.xml:3093 extras_topology.xml:3149 +#: extras_topology.xml:3080 extras_topology.xml:3133 #, no-c-format msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3100 +#: extras_topology.xml:3087 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: extras_topology.xml:3106 +#: extras_topology.xml:3093 #, no-c-format msgid "Intersects" msgstr "" #. Tag: refpurpose -#: extras_topology.xml:3108 +#: extras_topology.xml:3095 #, no-c-format msgid "" "Returns true if any pair of primitives from the two " @@ -4596,7 +4575,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: extras_topology.xml:3116 +#: extras_topology.xml:3100 #, no-c-format msgid "" "boolean Intersects " @@ -4605,7 +4584,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3127 +#: extras_topology.xml:3111 #, no-c-format msgid "" "Returns true if any pair of primitives from the two topogeometries " @@ -4613,7 +4592,7 @@ msgid "" msgstr "" #. Tag: para -#: extras_topology.xml:3134 +#: extras_topology.xml:3118 #, no-c-format msgid "" "This function not supported for topogeometries that are geometry " diff --git a/doc/po/templates/faq.xml.pot b/doc/po/templates/faq.xml.pot index ee21646c2..94f52fe57 100644 --- a/doc/po/templates/faq.xml.pot +++ b/doc/po/templates/faq.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/faq_raster.xml.pot b/doc/po/templates/faq_raster.xml.pot index 9e85eb31f..12940b7d0 100644 --- a/doc/po/templates/faq_raster.xml.pot +++ b/doc/po/templates/faq_raster.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/installation.xml.pot b/doc/po/templates/installation.xml.pot index d747bb7af..b0e8fa68d 100644 --- a/doc/po/templates/installation.xml.pot +++ b/doc/po/templates/installation.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -225,7 +225,7 @@ msgid "" "Setting environment variables varies depending on OS. For PostgreSQL " "installed on Ubuntu or Debian via apt-postgresql, the preferred way is to " "edit /etc/postgresql/10/" -"main/environment where 9.3 refers to " +"main/environment where 10 refers to " "version of PostgreSQL and main refers to the cluster." msgstr "" @@ -311,7 +311,7 @@ msgstr "" #: installation.xml:106 #, no-c-format msgid "" -"Proj4 reprojection library, version 4.9.0 or greater. Proj4 4.9 or above is " +"Proj4 reprojection library, version 4.6.0 or greater. Proj4 4.9 or above is " "needed to take advantage of improved geodetic. The Proj4 library is used to " "provide coordinate reprojection support within PostGIS. Proj4 is available " "for download from http://trac." @@ -322,17 +322,14 @@ msgstr "" #: installation.xml:118 #, no-c-format msgid "" -"GEOS geometry library, version 3.5 or greater, but GEOS 3.7+ is recommended " -"to take full advantage of all the new functions and features. You should " -"have at least GEOS 3.5, without which you will be missing some major " -"enhancements such as and . GEOS is available for download from http://trac.osgeo.org/geos/ and 3.5+ is " -"backward-compatible with older versions so fairly safe to upgrade." +"GEOS geometry library, version 3.6 or greater, but GEOS 3.7+ is recommended " +"to take full advantage of all the new functions and features. GEOS is " +"available for download from " +"http://trac.osgeo.org/geos/ ." msgstr "" #. Tag: para -#: installation.xml:127 +#: installation.xml:126 #, no-c-format msgid "" "LibXML2, version 2.5.x or higher. LibXML2 is currently used in some imports " @@ -342,7 +339,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:134 +#: installation.xml:133 #, no-c-format msgid "" "JSON-C, version 0.9 or higher. JSON-C is currently used to import GeoJSON " @@ -352,7 +349,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:142 +#: installation.xml:141 #, no-c-format msgid "" "GDAL, version 1.8 or higher (1.9 or higher is strongly recommended since " @@ -362,7 +359,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:152 +#: installation.xml:151 #, no-c-format msgid "" "If compiling with PostgreSQL+JIT, LLVM version >=6 is required protobuf-c." +"protobuf-c/protobuf-c\">protobuf-c. By default, Postgis will use " +"Wagyu to validate MVT polygons faster which requires a c++11 compiler. It " +"will use CXXFLAGS and the same compiler as the PostgreSQL installation. To " +"disable this and use GEOS instead use the --without-wagyu " +"during the configure step." msgstr "" #. Tag: para -#: installation.xml:206 +#: installation.xml:207 #, no-c-format msgid "" "CUnit (CUnit). This is needed for regression testing. " @@ -443,7 +444,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:212 +#: installation.xml:213 #, no-c-format msgid "" "DocBook (xsltproc) is required for building the " @@ -452,7 +453,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:223 +#: installation.xml:224 #, no-c-format msgid "" "DBLatex (dblatex) is required for building the " @@ -461,7 +462,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:234 +#: installation.xml:235 #, no-c-format msgid "" "ImageMagick (convert) is required to generate the " @@ -470,13 +471,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:247 +#: installation.xml:248 #, no-c-format msgid "Getting the Source" msgstr "" #. Tag: para -#: installation.xml:249 +#: installation.xml:250 #, no-c-format msgid "" "Retrieve the PostGIS source archive from the downloads website postgis-&last_release_version; svn repository http://svn.osgeo.org/postgis/trunk/ ." +"apache.org/\"> svn repository https://svn.osgeo.org/postgis/trunk/ ." msgstr "" #. Tag: programlisting -#: installation.xml:276 +#: installation.xml:277 #, no-c-format msgid "" -"svn checkout http://svn.osgeo.org/postgis/trunk/ postgis-" +"svn checkout https://svn.osgeo.org/postgis/trunk/ postgis-" "&last_release_version;" msgstr "" #. Tag: para -#: installation.xml:278 +#: installation.xml:279 #, no-c-format msgid "" "Change into the newly created postgis-&last_release_version;PostGIS Windows " -"download site We also have very bleeding-edge windows experimental " -"builds 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" +"PostGIS Windows " +"download site We also have very bleeding-edge windows experimental builds " +"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:302 +#: installation.xml:303 #, no-c-format msgid "" "The PostGIS module is an extension to the PostgreSQL backend server. As " @@ -583,7 +584,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:310 +#: installation.xml:311 #, no-c-format msgid "" "Refer to the PostgreSQL installation guides if you haven't already installed " @@ -592,7 +593,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:320 +#: installation.xml:321 #, no-c-format msgid "" "For GEOS functionality, when you install PostgresSQL you may need to " @@ -600,13 +601,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:325 +#: installation.xml:326 #, no-c-format msgid "LDFLAGS=-lstdc++ ./configure [YOUR OPTIONS HERE]" msgstr "" #. Tag: para -#: installation.xml:327 +#: installation.xml:328 #, no-c-format msgid "" "This is a workaround for bogus C++ exceptions interaction with older " @@ -616,7 +617,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:335 +#: installation.xml:336 #, no-c-format msgid "" "The following steps outline the configuration and compilation of the PostGIS " @@ -624,13 +625,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:342 +#: installation.xml:343 #, no-c-format msgid "Configuration" msgstr "" #. Tag: para -#: installation.xml:344 +#: installation.xml:345 #, no-c-format msgid "" "As with most linux installations, the first step is to generate the Makefile " @@ -639,7 +640,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:354 +#: installation.xml:355 #, no-c-format msgid "" "With no additional parameters, this command will attempt to automatically " @@ -662,13 +663,26 @@ msgstr "" #: installation.xml:373 #, 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 " +"Starting with PostGIS 3.0, the library files generated by default will no " +"longer have the minor version as part of the file name. This means all " +"PostGIS 3 libs will end in postgis-3. This was done to make " +"pg_upgrade easier, with downside that you can only install one version " +"PostGIS 3 series in your server. To get the old behavior of file including " +"the minor version: e.g. postgis-3.0 add this switch to your " +"configure statement." +msgstr "" + +#. Tag: para +#: installation.xml:388 +#, no-c-format +msgid "" +"This is the location the PostGIS loader executables and shared libs will be " +"installed. By default, this location is the same as the detected PostgreSQL " "installation." msgstr "" #. Tag: para -#: installation.xml:380 +#: installation.xml:395 #, no-c-format msgid "" "This parameter is currently broken, as the package will only install into " @@ -678,7 +692,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:395 +#: installation.xml:410 #, no-c-format msgid "" "PostgreSQL provides a utility called pg_config to enable " @@ -689,7 +703,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:409 +#: installation.xml:424 #, no-c-format msgid "" "GDAL, a required library, provides functionality needed for raster support " @@ -700,7 +714,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:423 +#: installation.xml:438 #, no-c-format msgid "" "GEOS, a required geometry library, provides a utility called geos-" @@ -711,7 +725,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:437 +#: installation.xml:452 #, no-c-format msgid "" "LibXML is the library required for doing GeomFromKML/GML processes. It " @@ -724,7 +738,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:455 +#: installation.xml:470 #, no-c-format msgid "" "Proj4 is a reprojection library required by PostGIS. Use this parameter " @@ -733,13 +747,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:467 +#: installation.xml:482 #, no-c-format msgid "Directory where iconv is installed." msgstr "" #. Tag: para -#: installation.xml:476 +#: installation.xml:491 #, no-c-format msgid "" "JSON-C is an MIT-" @@ -750,7 +764,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:488 +#: installation.xml:503 #, no-c-format msgid "" "PCRE is an BSD-licensed Perl " @@ -761,7 +775,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:500 +#: installation.xml:515 #, no-c-format msgid "" "Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-" @@ -769,13 +783,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:509 +#: installation.xml:524 #, no-c-format msgid "Compile without raster support." msgstr "" #. Tag: para -#: installation.xml:517 +#: installation.xml:532 #, no-c-format msgid "" "Disable topology support. There is no corresponding library as all logic " @@ -783,7 +797,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:526 +#: installation.xml:541 #, no-c-format msgid "" "By default PostGIS will try to detect gettext support and compile with it, " @@ -797,7 +811,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:537 +#: installation.xml:552 #, no-c-format msgid "" "By default PostGIS will not install with sfcgal support without this switch. " @@ -806,7 +820,18 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:545 +#: installation.xml:561 +#, no-c-format +msgid "" +"When building with MVT support, Postgis will use Wagyu to clip and validate MVT polygons. Wagyu " +"is the fastest alternative and guarantees producing correct values for this " +"specific case, but it requires a C++-11 compiler. With this optional " +"argument you can disable using this library; GEOS will be used instead." +msgstr "" + +#. Tag: para +#: installation.xml:568 #, no-c-format msgid "" "If you obtained PostGIS from the configure script that in " @@ -823,7 +848,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:562 +#: installation.xml:585 #, no-c-format msgid "" "If you instead obtained PostGIS as a tarball, running ./autogen.shPostGIS was built " @@ -854,7 +879,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:587 +#: installation.xml:610 #, no-c-format msgid "" "As of PostGIS v1.4.0, all the functions have comments generated from the " @@ -867,13 +892,13 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:597 installation.xml:621 +#: installation.xml:620 installation.xml:644 #, no-c-format msgid "make comments" msgstr "" #. Tag: para -#: installation.xml:600 +#: installation.xml:623 #, no-c-format msgid "" "Introduced in PostGIS 2.0. This generates html cheat sheets suitable for " @@ -885,7 +910,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:605 +#: installation.xml:628 #, no-c-format msgid "" "You can download some pre-built ones available in html and pdf from make check uses psql to run tests and as such can use psql " +"environment variables. Common ones useful to override are PGUSER,PGPORT, and PGHOST. Refer to " +"psql environment variables" msgstr "" #. Tag: para -#: installation.xml:627 +#: installation.xml:652 #, 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." +"and PostgreSQL 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:629 +#: installation.xml:654 #, no-c-format msgid "" "If you want to install the extensions manually on a separate server " @@ -997,7 +1012,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:636 +#: installation.xml:661 #, no-c-format msgid "" "These are the control files that denote information such as the version of " @@ -1006,7 +1021,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:642 +#: installation.xml:667 #, no-c-format msgid "" "All the files in the /sql folder of each extension. Note that these need to " @@ -1016,7 +1031,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:648 +#: installation.xml:673 #, no-c-format msgid "" "Once you do that, you should see postgis, " @@ -1025,7 +1040,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:649 +#: installation.xml:674 #, no-c-format msgid "" "If you are using psql, you can verify that the extensions are installed by " @@ -1033,7 +1048,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:650 +#: installation.xml:675 #, no-c-format msgid "" "SELECT name, default_version,installed_version\n" @@ -1048,6 +1063,8 @@ msgid "" "&last_release_version;\n" " postgis | &last_release_version; | " "&last_release_version;\n" +" postgis_raster | &last_release_version; | " +"&last_release_version;\n" " postgis_sfcgal | &last_release_version; |\n" " postgis_tiger_geocoder | &last_release_version; | " "&last_release_version;\n" @@ -1056,7 +1073,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:652 +#: installation.xml:677 #, no-c-format msgid "" "If you have the extension installed in the database you are querying, you'll " @@ -1068,7 +1085,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:656 +#: installation.xml:681 #, no-c-format msgid "" "If you have the extensions available, you can install postgis extension in " @@ -1077,10 +1094,11 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:657 +#: installation.xml:682 #, no-c-format msgid "" "CREATE EXTENSION postgis;\n" +"CREATE EXTENSION postgis_raster;\n" "CREATE EXTENSION postgis_sfcgal;\n" "CREATE EXTENSION fuzzystrmatch; --needed for postgis_tiger_geocoder\n" "--optional used by postgis_tiger_geocoder, or can be used standalone\n" @@ -1091,7 +1109,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:659 +#: installation.xml:684 #, no-c-format msgid "" "In psql you can use to see what versions you have installed and also what " @@ -1099,7 +1117,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:660 +#: installation.xml:685 #, no-c-format msgid "" "\\connect mygisdb\n" @@ -1108,7 +1126,7 @@ msgid "" msgstr "" #. Tag: screen -#: installation.xml:662 +#: installation.xml:687 #, no-c-format msgid "" "List of installed extensions\n" @@ -1135,7 +1153,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:664 +#: installation.xml:689 #, no-c-format msgid "" "Extension tables spatial_ref_sys, layerLD_LIBRARY_PATH environment variable." msgstr "" #. Tag: para -#: installation.xml:703 +#: installation.xml:728 #, no-c-format msgid "" "Currently, the make check relies on the PATH " @@ -1220,21 +1238,21 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:715 +#: installation.xml:740 #, no-c-format msgid "" "If successful, the output of the test should be similar to the following:" msgstr "" #. Tag: programlisting -#: installation.xml:720 +#: installation.xml:745 #, no-c-format msgid "" -"CUnit - A unit testing framework for C - Version 2.1-2\n" +"CUnit - A unit testing framework for C - Version 2.1-3\n" " http://cunit.sourceforge.net/\n" "\n" "\n" -"Suite: computational_geometry\n" +"Suite: algorithm\n" " Test: test_lw_segment_side ...passed\n" " Test: test_lw_segment_intersects ...passed\n" " Test: test_lwline_crossing_short_lines ...passed\n" @@ -1243,7 +1261,11 @@ msgid "" " Test: test_lwpoint_set_ordinate ...passed\n" " Test: test_lwpoint_get_ordinate ...passed\n" " Test: test_point_interpolate ...passed\n" +" Test: test_lwline_interpolate_points ...passed\n" +" Test: test_lwline_interpolate_point_3d ...passed\n" " Test: test_lwline_clip ...passed\n" +" Test: test_lwpoly_clip ...passed\n" +" Test: test_lwtriangle_clip ...passed\n" " Test: test_lwline_clip_big ...passed\n" " Test: test_lwmline_clip ...passed\n" " Test: test_geohash_point ...passed\n" @@ -1252,6 +1274,14 @@ msgid "" " Test: test_geohash_point_as_int ...passed\n" " Test: test_isclosed ...passed\n" " Test: test_lwgeom_simplify ...passed\n" +" Test: test_lw_arc_center ...passed\n" +" Test: test_point_density ...passed\n" +" Test: test_kmeans ...passed\n" +" Test: test_median_handles_3d_correctly ...passed\n" +" Test: test_median_robustness ...passed\n" +" Test: test_lwpoly_construct_circle ...passed\n" +" Test: test_trim_bits ...passed\n" +" Test: test_lwgeom_remove_repeated_points ...passed\n" "Suite: buildarea\n" " Test: buildarea1 ...passed\n" " Test: buildarea2 ...passed\n" @@ -1264,7 +1294,10 @@ msgid "" "Suite: geometry_clean\n" " Test: test_lwgeom_make_valid ...passed\n" "Suite: clip_by_rectangle\n" -" Test: test_lwgeom_clip_by_rect ...passed\n" +" Test: test_lwgeom_clip_by_rect ...DEBUG1: lwgeom_clip_by_rect: GEOS Error: " +"IllegalArgumentException: Invalid number of points in LinearRing found 3 - " +"must be 0 or >= 4\n" +"passed\n" "Suite: force_sfs\n" " Test: test_sfs_11 ...passed\n" " Test: test_sfs_12 ...passed\n" @@ -1273,7 +1306,6 @@ msgid "" " Test: test_sphere_direction ...passed\n" " Test: test_sphere_project ...passed\n" " Test: test_lwgeom_area_sphere ...passed\n" -" Test: test_signum ...passed\n" " Test: test_gbox_from_spherical_coordinates ...passed\n" " Test: test_gserialized_get_gbox_geocentric ...passed\n" " Test: test_clairaut ...passed\n" @@ -1293,20 +1325,31 @@ msgid "" " Test: test_lwgeom_segmentize_sphere ...passed\n" " Test: test_ptarray_contains_point_sphere ...passed\n" " Test: test_ptarray_contains_point_sphere_iowa ...passed\n" -"Suite: GEOS\n" +" Test: test_gbox_to_string_truncated ...passed\n" +"Suite: geos\n" " Test: test_geos_noop ...passed\n" " Test: test_geos_subdivide ...passed\n" " Test: test_geos_linemerge ...passed\n" -"Suite: Clustering\n" +" Test: test_geos_offsetcurve ...passed\n" +" Test: test_geos_offsetcurve_crash ...passed\n" +" Test: test_geos_makevalid ...passed\n" +"Suite: clustering\n" " Test: basic_test ...passed\n" " Test: nonsequential_test ...passed\n" " Test: basic_distance_test ...passed\n" " Test: single_input_test ...passed\n" " Test: empty_inputs_test ...passed\n" -"Suite: Clustering Union-Find\n" +" Test: multipoint_test ...passed\n" +" Test: dbscan_test ...passed\n" +" Test: dbscan_test_3612a ...passed\n" +" Test: dbscan_test_3612b ...passed\n" +" Test: dbscan_test_3612c ...passed\n" +"Suite: clustering_unionfind\n" " Test: test_unionfind_create ...passed\n" " Test: test_unionfind_union ...passed\n" " Test: test_unionfind_ordered_by_cluster ...passed\n" +" Test: test_unionfind_path_compression ...passed\n" +" Test: test_unionfind_collapse_cluster_ids ...passed\n" "Suite: homogenize\n" " Test: test_coll_point ...passed\n" " Test: test_coll_line ...passed\n" @@ -1321,6 +1364,13 @@ msgid "" " Test: in_geojson_test_srid ...passed\n" " Test: in_geojson_test_bbox ...passed\n" " Test: in_geojson_test_geoms ...passed\n" +"Suite: iterator\n" +" Test: test_point_count ...passed\n" +" Test: test_ordering ...passed\n" +" Test: test_modification ...passed\n" +" Test: test_mixed_rw_access ...passed\n" +" Test: test_cannot_modify_read_only ...passed\n" +" Test: test_no_memory_leaked_when_iterator_is_partially_used ...passed\n" "Suite: twkb_input\n" " Test: test_twkb_in_point ...passed\n" " Test: test_twkb_in_linestring ...passed\n" @@ -1333,7 +1383,9 @@ msgid "" "Suite: serialization/deserialization\n" " Test: test_typmod_macros ...passed\n" " Test: test_flags_macros ...passed\n" -" Test: test_serialized_srid ...passed\n" +" Test: test_serialized_srid ...NOTICE: SRID value -3005 converted to the " +"officially unknown SRID value 0\n" +"passed\n" " Test: test_gserialized_from_lwgeom_size ...passed\n" " Test: test_gbox_serialized_size ...passed\n" " Test: test_lwgeom_from_gserialized ...passed\n" @@ -1342,7 +1394,7 @@ msgid "" " Test: test_geometry_type_from_string ...passed\n" " Test: test_lwcollection_extract ...passed\n" " Test: test_lwgeom_free ...passed\n" -" Test: test_lwgeom_flip_coordinates ...passed\n" +" Test: test_lwgeom_swap_ordinates ...passed\n" " Test: test_f2d ...passed\n" " Test: test_lwgeom_clone ...passed\n" " Test: test_lwgeom_force_clockwise ...passed\n" @@ -1353,12 +1405,31 @@ msgid "" " Test: test_lwgeom_as_curve ...passed\n" " Test: test_lwgeom_scale ...passed\n" " Test: test_gserialized_is_empty ...passed\n" +" Test: test_gserialized_peek_gbox_p_no_box_when_empty ...passed\n" +" Test: test_gserialized_peek_gbox_p_gets_correct_box ...passed\n" +" Test: test_gserialized_peek_gbox_p_fails_for_unsupported_cases ...passed\n" " Test: test_gbox_same_2d ...passed\n" +" Test: test_signum_macro ...passed\n" +"Suite: lwstroke\n" +" Test: test_lwcurve_linearize ...passed\n" +" Test: test_unstroke ...passed\n" "Suite: measures\n" " Test: test_mindistance2d_tolerance ...passed\n" +" Test: test_mindistance3d_tolerance ...NOTICE: One or both of the " +"geometries is missing z-value. The unknown z-value will be regarded as \"any " +"value\"\n" +"NOTICE: One or both of the geometries is missing z-value. The unknown z-" +"value will be regarded as \"any value\"\n" +"passed\n" " Test: test_rect_tree_contains_point ...passed\n" " Test: test_rect_tree_intersects_tree ...passed\n" -" Test: test_lwgeom_segmentize2d ...passed\n" +" Test: test_lwgeom_segmentize2d ...NOTICE: ptarray.c:448 - " +"ptarray_segmentize2d: Too many segments required (1.000000e+101)\n" +"NOTICE: liblwgeom code interrupted\n" +"NOTICE: liblwgeom code interrupted\n" +"NOTICE: liblwgeom code interrupted\n" +"NOTICE: liblwgeom code interrupted\n" +"passed\n" " Test: test_lwgeom_locate_along ...passed\n" " Test: test_lw_dist2d_pt_arc ...passed\n" " Test: test_lw_dist2d_seg_arc ...passed\n" @@ -1367,10 +1438,25 @@ msgid "" " Test: test_lw_dist2d_pt_ptarrayarc ...passed\n" " Test: test_lw_dist2d_ptarray_ptarrayarc ...passed\n" " Test: test_lwgeom_tcpa ...passed\n" -" Test: test_lwgeom_is_trajectory ...passed\n" +" Test: test_lwgeom_is_trajectory ...NOTICE: Geometry is not a LINESTRING\n" +"NOTICE: Line does not have M dimension\n" +"NOTICE: Measure of vertex 1 (1) not bigger than measure of vertex 0 (1)\n" +"NOTICE: Measure of vertex 1 (0) not bigger than measure of vertex 0 (1)\n" +"NOTICE: Measure of vertex 2 (2) not bigger than measure of vertex 1 (3)\n" +"passed\n" +" Test: test_rect_tree_distance_tree ...passed\n" "Suite: effectivearea\n" " Test: do_test_lwgeom_effectivearea_lines ...passed\n" " Test: do_test_lwgeom_effectivearea_polys ...passed\n" +"Suite: chaikin\n" +" Test: do_test_chaikin_lines ...passed\n" +" Test: do_test_chaikin_polygons ...passed\n" +"Suite: filterm\n" +" Test: do_test_filterm_single_geometries ...passed\n" +" Test: do_test_filterm_collections ...passed\n" +"Suite: minimum_bounding_circle\n" +" Test: basic_test ...passed\n" +" Test: test_empty ...passed\n" "Suite: miscellaneous\n" " Test: test_misc_force_2d ...passed\n" " Test: test_misc_simplify ...passed\n" @@ -1378,6 +1464,9 @@ msgid "" " Test: test_misc_area ...passed\n" " Test: test_misc_wkb ...passed\n" " Test: test_grid ...passed\n" +" Test: test_grid_in_place ...passed\n" +" Test: test_clone ...passed\n" +" Test: test_lwmpoint_from_lwgeom ...passed\n" "Suite: noding\n" " Test: test_lwgeom_node ...passed\n" "Suite: encoded_polyline_output\n" @@ -1421,7 +1510,6 @@ msgid "" " Test: test_ptarray_locate_point ...passed\n" " Test: test_ptarray_isccw ...passed\n" " Test: test_ptarray_signed_area ...passed\n" -" Test: test_ptarray_unstroke ...passed\n" " Test: test_ptarray_insert_point ...passed\n" " Test: test_ptarray_contains_point ...passed\n" " Test: test_ptarrayarc_contains_point ...passed\n" @@ -1432,7 +1520,7 @@ msgid "" " Test: test_lwprint_optional_format ...passed\n" " Test: test_lwprint_oddball_formats ...passed\n" " Test: test_lwprint_bad_formats ...passed\n" -"Suite: SFCGAL\n" +"Suite: sfcgal\n" " Test: test_sfcgal_noop ...passed\n" "Suite: split\n" " Test: test_lwline_split_by_point_to ...passed\n" @@ -1445,7 +1533,7 @@ msgid "" " Test: tin_parse ...passed\n" " Test: polyhedralsurface_parse ...passed\n" " Test: surface_dimension ...passed\n" -"Suite: Internal Spatial Trees\n" +"Suite: spatial_trees\n" " Test: test_tree_circ_create ...passed\n" " Test: test_tree_circ_pip ...passed\n" " Test: test_tree_circ_pip2 ...passed\n" @@ -1453,6 +1541,9 @@ msgid "" " Test: test_tree_circ_distance_threshold ...passed\n" "Suite: triangulate\n" " Test: test_lwgeom_delaunay_triangulation ...passed\n" +" Test: test_lwgeom_voronoi_diagram ...passed\n" +" Test: test_lwgeom_voronoi_diagram_expected_empty ...passed\n" +" Test: test_lwgeom_voronoi_diagram_custom_envelope ...passed\n" "Suite: twkb_output\n" " Test: test_twkb_out_point ...passed\n" " Test: test_twkb_out_linestring ...passed\n" @@ -1510,6 +1601,7 @@ msgid "" " Test: test_wkt_in_tin ...passed\n" " Test: test_wkt_in_polyhedralsurface ...passed\n" " Test: test_wkt_in_errlocation ...passed\n" +" Test: test_wkt_double ...passed\n" "Suite: wkt_output\n" " Test: test_wkt_out_point ...passed\n" " Test: test_wkt_out_linestring ...passed\n" @@ -1523,72 +1615,68 @@ msgid "" " Test: test_wkt_out_curvpolygon ...passed\n" " Test: test_wkt_out_multicurve ...passed\n" " Test: test_wkt_out_multisurface ...passed\n" +"Suite: wrapx\n" +" Test: test_lwgeom_wrapx ...passed\n" "\n" "Run Summary: Type Total Ran Passed Failed Inactive\n" -" suites 38 38 n/a 0 0\n" -" tests 251 251 251 0 0\n" -" asserts 2468 2468 2468 0 n/a\n" +" suites 44 44 n/a 0 0\n" +" tests 300 300 300 0 0\n" +" asserts 4215 4215 4215 0 n/a\n" +"Elapsed time = 0.229 seconds\n" "\n" -"Elapsed time = 0.298 seconds\n" -"\n" -"Creating database 'postgis_reg'\n" -"Loading PostGIS into 'postgis_reg'\n" -" /projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/" -"postgis/postgis.sql\n" -" /projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/" -"postgis/postgis_comments.sql\n" -"Loading SFCGAL into 'postgis_reg'\n" -" /projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/" -"postgis/sfcgal.sql\n" -" /projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/" -"postgis/sfcgal_comments.sql\n" -"PostgreSQL 9.4.4, compiled by Visual C++ build 1800, 32-bit\n" -" Postgis 2.2.0dev - r13980 - 2015-08-23 06:13:07\n" -" scripts 2.2.0dev r13980\n" -" GEOS: 3.5.0-CAPI-1.9.0 r4088\n" -" PROJ: Rel. 4.9.1, 04 March 2015\n" -" SFCGAL: 1.1.0\n" +"PostgreSQL 12devel on x86_64-w64-mingw32, compiled by gcc.exe (x86_64-posix-" +"seh-rev0, Built by MinGW-W64 project) 8.1.0, 64-bit\n" +" Postgis 3.0.0dev - r17081 - 2018-11-28 18:50:02\n" +" scripts 3.0.0dev r17081\n" +" GEOS: 3.7.0-CAPI-1.11.0 673b9939\n" +" PROJ: Rel. 5.2.0, September 15th, 2018\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" -" loader/TSTPolygon ......... ok\n" -" loader/TSIPolygon ......... ok\n" -" loader/TSTIPolygon ......... ok\n" -" loader/PointWithSchema ..... ok\n" -" loader/NoTransPoint ......... ok\n" -" loader/NotReallyMultiPoint ......... ok\n" -" loader/MultiToSinglePoint ......... ok\n" -" loader/ReprojectPts ........ ok\n" -" loader/ReprojectPtsGeog ........ ok\n" -" loader/Latin1 .... ok\n" -" loader/Latin1-implicit .... ok\n" -" loader/mfile .... ok\n" -" dumper/literalsrid ....... ok\n" -" dumper/realtable ....... ok\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" +" ../loader/TSTPolygon ......... ok\n" +" ../loader/TSIPolygon ......... ok\n" +" ../loader/TSTIPolygon ......... ok\n" +" ../loader/PointWithSchema ..... ok\n" +" ../loader/NoTransPoint ......... ok\n" +" ../loader/NotReallyMultiPoint ......... ok\n" +" ../loader/MultiToSinglePoint ......... ok\n" +" ../loader/ReprojectPts ........ ok\n" +" ../loader/ReprojectPtsGeog ........ ok\n" +" ../loader/Latin1 .... ok\n" +" ../loader/Latin1-implicit .... ok\n" +" ../loader/mfile .... ok\n" +" ../dumper/literalsrid ....... ok\n" +" ../dumper/realtable ....... ok\n" " affine .. ok\n" " bestsrid .. ok\n" " binary .. ok\n" " boundary .. ok\n" +" chaikin .. ok\n" +" filterm .. ok\n" " cluster .. ok\n" " concave_hull .. ok\n" +" concave_hull_hard .. ok\n" " ctors .. ok\n" +" curvetoline .. ok\n" " dump .. ok\n" " dumppoints .. ok\n" " empty .. ok\n" +" estimatedextent .. ok\n" " forcecurve .. ok\n" " geography .. ok\n" +" geometric_median .. ok\n" " in_geohash .. ok\n" " in_gml .. ok\n" " in_kml .. ok\n" @@ -1598,14 +1686,19 @@ msgid "" " long_xact .. ok\n" " lwgeom_regress .. ok\n" " measures .. ok\n" +" minimum_bounding_circle .. ok\n" +" normalize .. ok\n" " operators .. ok\n" +" orientation .. ok\n" " out_geometry .. ok\n" " out_geography .. ok\n" " polygonize .. ok\n" " polyhedralsurface .. ok\n" " postgis_type_name .. ok\n" +" quantize_coordinates .. ok\n" " regress .. ok\n" " regress_bdpoly .. ok\n" +" regress_gist_index_nd .. ok\n" " regress_index .. ok\n" " regress_index_nulls .. ok\n" " regress_management .. ok\n" @@ -1618,6 +1711,7 @@ msgid "" " relate .. ok\n" " remove_repeated_points .. ok\n" " removepoint .. ok\n" +" reverse .. ok\n" " setpoint .. ok\n" " simplify .. ok\n" " simplifyvw .. ok\n" @@ -1640,9 +1734,11 @@ msgid "" " wkb .. ok\n" " wkt .. ok\n" " wmsservers .. ok\n" -" knn .. ok\n" +" knn_recheck .. ok\n" +" temporal_knn .. ok\n" " hausdorff .. ok\n" " regress_buffer_params .. ok\n" +" frechet .. ok\n" " offsetcurve .. ok\n" " relatematch .. ok\n" " isvaliddetail .. ok\n" @@ -1655,26 +1751,336 @@ msgid "" " delaunaytriangles .. ok\n" " clipbybox2d .. ok\n" " subdivide .. ok\n" +" voronoi .. ok\n" +" minimum_clearance .. ok\n" +" oriented_envelope .. ok\n" " in_geojson .. ok\n" +" regress_brin_index .. ok\n" +" regress_brin_index_3d .. ok\n" +" regress_brin_index_geography .. ok\n" +" regress_spgist_index_2d .. ok\n" +" regress_spgist_index_3d .. ok\n" +" regress_spgist_index_nd .. ok\n" +" mvt .. ok\n" +" geobuf .. ok\n" +" mvt_jsonb .. ok\n" +" uninstall .. ok (4643)\n" +"\n" +"Run tests: 134\n" +"Failed: 0\n" +"\n" +"\n" +"-- if you build with SFCGAL\n" +"\n" +"PostgreSQL 12devel on x86_64-w64-mingw32, compiled by gcc.exe (x86_64-posix-" +"seh-rev0, Built by MinGW-W64 project) 8.1.0, 64-bit\n" +" Postgis 3.0.0dev - r17081 - 2018-11-28 18:50:02\n" +" scripts 3.0.0dev r17081\n" +" GEOS: 3.7.0-CAPI-1.11.0 673b9939\n" +" PROJ: Rel. 5.2.0, September 15th, 2018\n" +" SFCGAL: 1.3.2\n" +"\n" +"Running tests\n" +"\n" " regress_sfcgal .. ok\n" -" sfcgal/empty .. ok\n" -" sfcgal/geography .. ok\n" -" sfcgal/legacy .. ok\n" -" sfcgal/measures .. ok\n" -" sfcgal/regress_ogc_prep .. ok\n" -" sfcgal/regress_ogc .. ok\n" -" sfcgal/regress .. ok\n" -" sfcgal/tickets .. ok\n" -" sfcgal/concave_hull .. ok\n" -" sfcgal/wmsservers .. ok\n" -" sfcgal/approximatemedialaxis .. ok\n" -" uninstall . /projects/postgis/branches/2.2/regress/00-regress-install/" -"share/contrib/postgis/uninstall_sfcgal.sql\n" -" /projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/" -"postgis/uninstall_postgis.sql\n" -". ok (4336)\n" +" empty .. ok\n" +" geography .. ok\n" +" legacy .. ok\n" +" measures .. ok\n" +" regress_ogc_prep .. ok\n" +" regress_ogc .. ok\n" +" regress .. ok\n" +" tickets .. ok\n" +" concave_hull .. ok\n" +" wmsservers .. ok\n" +" approximatemedialaxis .. ok\n" +" uninstall .. ok (4643)\n" +"\n" +"Run tests: 13\n" +"Failed: 0\n" +"\n" +"-- if you built with raster support\n" +"\n" +"\n" +"\n" +" CUnit - A unit testing framework for C - Version 2.1-2\n" +" http://cunit.sourceforge.net/\n" +"\n" +"\n" +"Suite: pixtype\n" +" Test: test_pixtype_size ...passed\n" +" Test: test_pixtype_alignment ...passed\n" +" Test: test_pixtype_name ...passed\n" +" Test: test_pixtype_index_from_name ...passed\n" +" Test: test_pixtype_get_min_value ...passed\n" +" Test: test_pixtype_compare_clamped_values ...passed\n" +"Suite: raster_basics\n" +" Test: test_raster_new ...passed\n" +" Test: test_raster_empty ...passed\n" +" Test: test_raster_metadata ...passed\n" +" Test: test_raster_clone ...passed\n" +" Test: test_raster_from_band ...passed\n" +" Test: test_raster_replace_band ...passed\n" +"Suite: band_basics\n" +" Test: test_band_metadata ...passed\n" +" Test: test_band_pixtype_1BB ...passed\n" +" Test: test_band_pixtype_2BUI ...passed\n" +" Test: test_band_pixtype_4BUI ...passed\n" +" Test: test_band_pixtype_8BUI ...passed\n" +" Test: test_band_pixtype_8BSI ...passed\n" +" Test: test_band_pixtype_16BUI ...passed\n" +" Test: test_band_pixtype_16BSI ...passed\n" +" Test: test_band_pixtype_32BUI ...passed\n" +" Test: test_band_pixtype_32BSI ...passed\n" +" Test: test_band_pixtype_32BF ...passed\n" +" Test: test_band_pixtype_64BF ...passed\n" +" Test: test_band_get_pixel_line ...WARNING: Limiting returning number " +"values to 1\n" +"WARNING: Attempting to get pixel values with out of range raster " +"coordinates: (5, 5)\n" +"passed\n" +" Test: test_band_new_offline_from_path ...passed\n" +"Suite: raster_wkb\n" +" Test: test_raster_wkb ...SRID value -1 converted to the officially unknown " +"SRID value 0\n" +"SRID value -1 converted to the officially unknown SRID value 0\n" +"SRID value -1 converted to the officially unknown SRID value 0\n" +"SRID value -1 converted to the officially unknown SRID value 0\n" +"SRID value -1 converted to the officially unknown SRID value 0\n" +"SRID value -1 converted to the officially unknown SRID value 0\n" +"passed\n" +"Suite: gdal\n" +" Test: test_gdal_configured ...passed\n" +" Test: test_gdal_drivers ...passed\n" +" Test: test_gdal_rasterize ...passed\n" +" Test: test_gdal_polygonize ...passed\n" +" Test: test_raster_to_gdal ...Warning 6: PNG driver doesn't support data " +"type Float64. Only eight bit (Byte) and sixteen bit (UInt16) bands " +"supported. Defaulting to Byte\n" +"\n" +"passed\n" +" Test: test_gdal_to_raster ...passed\n" +" Test: test_gdal_warp ...passed\n" +"Suite: raster_geometry\n" +" Test: test_raster_envelope ...passed\n" +" Test: test_raster_envelope_geom ...passed\n" +" Test: test_raster_convex_hull ...passed\n" +" Test: test_raster_surface ...INFO: Ring Self-intersection at or near point " +"2 -2\n" +"INFO: Ring Self-intersection at or near point 3 -3\n" +"passed\n" +" Test: test_raster_perimeter ...passed\n" +" Test: test_raster_pixel_as_polygon ...passed\n" +"Suite: raster_misc\n" +" Test: test_raster_cell_to_geopoint ...passed\n" +" Test: test_raster_geopoint_to_cell ...passed\n" +" Test: test_raster_from_two_rasters ...passed\n" +" Test: test_raster_compute_skewed_raster ...passed\n" +"Suite: band_stats\n" +" Test: test_band_stats ...passed\n" +" Test: test_band_value_count ...passed\n" +"Suite: band_misc\n" +" Test: test_band_get_nearest_pixel ...passed\n" +" Test: test_band_get_pixel_of_value ...passed\n" +" Test: test_pixel_set_to_array ...passed\n" +"Suite: mapalgebra\n" +" Test: test_raster_iterator ...passed\n" +" Test: test_band_reclass ...passed\n" +" Test: test_raster_colormap ...passed\n" +"Suite: spatial_relationship\n" +" Test: test_raster_geos_overlaps ...passed\n" +" Test: test_raster_geos_touches ...passed\n" +" Test: test_raster_geos_contains ...passed\n" +" Test: test_raster_geos_contains_properly ...passed\n" +" Test: test_raster_geos_covers ...passed\n" +" Test: test_raster_geos_covered_by ...passed\n" +" Test: test_raster_within_distance ...passed\n" +" Test: test_raster_fully_within_distance ...passed\n" +" Test: test_raster_intersects ...passed\n" +" Test: test_raster_same_alignment ...passed\n" +"Suite: misc\n" +" Test: test_rgb_to_hsv ...passed\n" +" Test: test_hsv_to_rgb ...passed\n" +" Test: test_util_gdal_open ...passed\n" +"\n" +"Run Summary: Type Total Ran Passed Failed Inactive\n" +" suites 12 12 n/a 0 0\n" +" tests 65 65 65 0 0\n" +" asserts 45896 45896 45896 0 n/a\n" +"\n" +"Elapsed time = 0.499 seconds\n" +"\n" +"Loading Raster into 'postgis_reg'\n" +"PostgreSQL 12devel on x86_64-w64-mingw32, compiled by gcc.exe (x86_64-posix-" +"seh-rev0, Built by MinGW-W64 project) 8.1.0, 64-bit\n" +" Postgis 3.0.0dev - r17081 - 2018-11-28 18:50:02\n" +" scripts 3.0.0dev r17081\n" +" raster scripts 3.0.0dev r17081\n" +" GEOS: 3.7.0-CAPI-1.11.0 673b9939\n" +" PROJ: Rel. 5.2.0, September 15th, 2018\n" +" GDAL: GDAL 2.3.1, released 2018/06/22\n" +"\n" +"Running tests\n" +"\n" +" check_gdal .. ok\n" +" load_outdb ... ok\n" +" check_raster_columns .. ok\n" +" check_raster_overviews .. ok\n" +" rt_io .. ok\n" +" rt_bytea .. ok\n" +" rt_wkb .. ok\n" +" box3d .. ok\n" +" rt_addband .. ok\n" +" rt_band .. ok\n" +" rt_tile .. ok\n" +" rt_dimensions .. ok\n" +" rt_scale .. ok\n" +" rt_pixelsize .. ok\n" +" rt_upperleft .. ok\n" +" rt_rotation .. ok\n" +" rt_georeference .. ok\n" +" rt_set_properties .. ok\n" +" rt_isempty .. ok\n" +" rt_hasnoband .. ok\n" +" rt_metadata .. ok\n" +" rt_rastertoworldcoord .. ok\n" +" rt_worldtorastercoord .. ok\n" +" rt_convexhull .. ok\n" +" rt_envelope .. ok\n" +" rt_band_properties .. ok\n" +" rt_set_band_properties .. ok\n" +" rt_pixelaspolygons .. ok\n" +" rt_pixelaspoints .. ok\n" +" rt_pixelascentroids .. ok\n" +" rt_setvalues_array .. ok\n" +" rt_summarystats .. ok\n" +" rt_count .. ok\n" +" rt_histogram .. ok\n" +" rt_quantile .. ok\n" +" rt_valuecount .. ok\n" +" rt_valuepercent .. ok\n" +" rt_bandmetadata .. ok\n" +" rt_pixelvalue .. ok\n" +" rt_neighborhood .. ok\n" +" rt_nearestvalue .. ok\n" +" rt_pixelofvalue .. ok\n" +" rt_polygon .. ok\n" +" rt_setbandpath .. ok\n" +" rt_utility .. ok\n" +" rt_fromgdalraster .. ok\n" +" rt_asgdalraster .. ok\n" +" rt_astiff .. ok\n" +" rt_asjpeg .. ok\n" +" rt_aspng .. ok\n" +" rt_reclass .. ok\n" +" rt_gdalwarp .. ok\n" +" rt_asraster .. ok\n" +" rt_dumpvalues .. ok\n" +" rt_makeemptycoverage .. ok\n" +" rt_createoverview .. ok\n" +" rt_mapalgebraexpr .. ok\n" +" rt_mapalgebrafct .. ok\n" +" rt_mapalgebraexpr_2raster .. ok\n" +" rt_mapalgebrafct_2raster .. ok\n" +" rt_mapalgebrafctngb .. ok\n" +" rt_mapalgebrafctngb_userfunc .. ok\n" +" rt_intersection .. ok\n" +" rt_clip .. ok\n" +" rt_mapalgebra .. ok\n" +" rt_mapalgebra_expr .. ok\n" +" rt_mapalgebra_mask .. ok\n" +" rt_union .. ok\n" +" rt_invdistweight4ma .. ok\n" +" rt_4ma .. ok\n" +" rt_setvalues_geomval .. ok\n" +" rt_elevation_functions .. ok\n" +" rt_colormap .. ok\n" +" rt_grayscale .. ok\n" +" rt_gist_relationships .. ok\n" +" rt_intersects .. ok\n" +" rt_samealignment .. ok\n" +" rt_geos_relationships .. ok\n" +" rt_iscoveragetile .. ok\n" +" bug_test_car5 .. ok\n" +" permitted_gdal_drivers .. ok\n" +" tickets .. ok\n" +" loader/Basic .. ok\n" +" loader/Projected ... ok\n" +" loader/BasicCopy .. ok\n" +" loader/BasicFilename .. ok\n" +" loader/BasicOutDB .. ok\n" +" loader/Tiled10x10 .. ok\n" +" loader/Tiled10x10Copy .. ok\n" +" loader/Tiled8x8 .. ok\n" +" clean .. ok\n" +" uninstall .. ok (4643)\n" +"\n" +"Run tests: 101\n" +"Failed: 0\n" +"\n" +"-- topology regress\n" +"PostgreSQL 12devel on x86_64-w64-mingw32, compiled by gcc.exe (x86_64-posix-" +"seh-rev0, Built by MinGW-W64 project) 8.1.0, 64-bit\n" +" Postgis 3.0.0dev - r17081 - 2018-11-28 18:50:02\n" +" scripts 3.0.0dev r17081\n" +" GEOS: 3.7.0-CAPI-1.11.0 673b9939\n" +" PROJ: Rel. 5.2.0, September 15th, 2018\n" "\n" -"Run tests: 118\n" +"Running tests\n" +"\n" +" regress/legacy_validate .. ok\n" +" regress/legacy_predicate .. ok\n" +" regress/legacy_invalid .. ok\n" +" regress/sqlmm .. ok\n" +" regress/legacy_query .. ok\n" +" regress/addnode .. ok\n" +" regress/addedge .. ok\n" +" regress/addface .. ok\n" +" regress/addface2.5d .. ok\n" +" regress/addtopogeometrycolumn .. ok\n" +" regress/polygonize .. ok\n" +" regress/st_addisoedge .. ok\n" +" regress/st_addisonode .. ok\n" +" regress/st_addedgemodface .. ok\n" +" regress/st_addedgenewfaces .. ok\n" +" regress/st_changeedgegeom .. ok\n" +" regress/st_createtopogeo .. ok\n" +" regress/st_getfacegeometry .. ok\n" +" regress/st_getfaceedges .. ok\n" +" regress/st_modedgeheal .. ok\n" +" regress/st_modedgesplit .. ok\n" +" regress/st_newedgeheal .. ok\n" +" regress/st_newedgessplit .. ok\n" +" regress/st_remedgenewface .. ok\n" +" regress/st_remedgemodface .. ok\n" +" regress/st_simplify .. ok\n" +" regress/topoelement .. ok\n" +" regress/topoelementarray_agg .. ok\n" +" regress/topogeo_addlinestring .. ok\n" +" regress/topogeo_addpoint .. ok\n" +" regress/topogeo_addpolygon .. ok\n" +" regress/topogeom_edit .. ok\n" +" regress/topogeometry_type .. ok\n" +" regress/topojson .. ok\n" +" regress/topologysummary .. ok\n" +" regress/topo2.5d .. ok\n" +" regress/totopogeom .. ok\n" +" regress/droptopology .. ok\n" +" regress/droptopogeometrycolumn .. ok\n" +" regress/copytopology .. ok\n" +" regress/createtopogeom .. ok\n" +" regress/createtopology .. ok\n" +" regress/gml .. ok\n" +" regress/getnodebypoint .. ok\n" +" regress/getedgebypoint .. ok\n" +" regress/getfacebypoint .. ok\n" +" regress/getringedges .. ok\n" +" regress/gettopogeomelements .. ok\n" +" regress/layertrigger .. ok\n" +" regress/validatetopology .. ok\n" +" uninstall .. ok (4643)\n" +"\n" +"Run tests: 51\n" "Failed: 0\n" "\n" "-- if you built --with-gui, you should see this too\n" @@ -1697,7 +2103,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:722 +#: installation.xml:747 #, no-c-format msgid "" "The postgis_tiger_geocoder and " @@ -1708,13 +2114,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:723 +#: installation.xml:748 #, no-c-format msgid "For address_standardizer:" msgstr "" #. Tag: programlisting -#: installation.xml:724 +#: installation.xml:749 #, no-c-format msgid "" "cd extensions/address_standardizer\n" @@ -1723,13 +2129,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:726 +#: installation.xml:751 #, no-c-format msgid "Output should look like:" msgstr "" #. Tag: screen -#: installation.xml:727 +#: installation.xml:752 #, no-c-format msgid "" "============== dropping database \"contrib_regression\" ==============\n" @@ -1749,7 +2155,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:729 +#: installation.xml:754 #, no-c-format msgid "" "For tiger geocoder, make sure you have postgis and fuzzystrmatch extensions " @@ -1758,7 +2164,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:730 +#: installation.xml:755 #, no-c-format msgid "" "cd extensions/postgis_tiger_geocoder\n" @@ -1767,13 +2173,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:731 +#: installation.xml:756 #, no-c-format msgid "output should look like:" msgstr "" #. Tag: screen -#: installation.xml:732 +#: installation.xml:757 #, no-c-format msgid "" "============== dropping database \"contrib_regression\" ==============\n" @@ -1799,25 +2205,25 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:736 +#: installation.xml:761 #, no-c-format msgid "Installation" msgstr "" #. Tag: para -#: installation.xml:738 +#: installation.xml:763 #, no-c-format msgid "To install PostGIS, type" msgstr "" #. Tag: command -#: installation.xml:743 +#: installation.xml:768 #, no-c-format msgid "make install" msgstr "" #. Tag: para -#: installation.xml:746 +#: installation.xml:771 #, no-c-format msgid "" "This will copy the PostGIS installation files into their appropriate " @@ -1826,7 +2232,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:754 +#: installation.xml:779 #, no-c-format msgid "" "The loader and dumper binaries are installed in [prefix]/binpostgis.sql, are installed in " @@ -1842,14 +2248,14 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:768 +#: installation.xml:793 #, no-c-format msgid "" "The PostGIS libraries are installed in [prefix]/lib." msgstr "" #. Tag: para -#: installation.xml:775 +#: installation.xml:800 #, no-c-format msgid "" "If you previously ran the make comments command to " @@ -1859,13 +2265,13 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:782 +#: installation.xml:807 #, no-c-format msgid "make comments-install" msgstr "" #. Tag: para -#: installation.xml:786 +#: installation.xml:811 #, no-c-format msgid "" "postgis_comments.sql, raster_comments.sqluninstall_legacy.sql to get rid of " @@ -1968,13 +2374,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:841 +#: installation.xml:866 #, no-c-format msgid "Create a spatially-enabled database without using extensions" msgstr "" #. Tag: para -#: installation.xml:843 +#: installation.xml:868 #, no-c-format msgid "" "This is generally only needed if you cannot or don't want to get PostGIS " @@ -1983,7 +2389,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:847 +#: installation.xml:872 #, no-c-format msgid "" "The first step in creating a PostGIS database is to create a simple " @@ -1991,7 +2397,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:855 +#: installation.xml:880 #, no-c-format msgid "" "Many of the PostGIS functions are written in the PL/pgSQL procedural " @@ -2002,13 +2408,13 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:863 +#: installation.xml:888 #, no-c-format msgid "createlang plpgsql [yourdatabase]" msgstr "" #. Tag: para -#: installation.xml:866 +#: installation.xml:891 #, no-c-format msgid "" "Now load the PostGIS object and function definitions into your database by " @@ -2018,13 +2424,13 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:874 +#: installation.xml:899 #, no-c-format msgid "psql -d [yourdatabase] -f postgis.sql" msgstr "" #. Tag: para -#: installation.xml:877 +#: installation.xml:902 #, no-c-format msgid "" "For a complete set of EPSG coordinate system definition identifiers, you can " @@ -2034,13 +2440,13 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:885 +#: installation.xml:910 #, no-c-format msgid "psql -d [yourdatabase] -f spatial_ref_sys.sql" msgstr "" #. Tag: para -#: installation.xml:888 +#: installation.xml:913 #, no-c-format msgid "" "If you wish to add comments to the PostGIS functions, the final step is to " @@ -2050,25 +2456,25 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:896 +#: installation.xml:921 #, no-c-format msgid "psql -d [yourdatabase] -f postgis_comments.sql" msgstr "" #. Tag: para -#: installation.xml:899 +#: installation.xml:924 #, no-c-format msgid "Install raster support" msgstr "" #. Tag: command -#: installation.xml:904 +#: installation.xml:929 #, no-c-format msgid "psql -d [yourdatabase] -f rtpostgis.sql" msgstr "" #. Tag: para -#: installation.xml:907 +#: installation.xml:932 #, no-c-format msgid "" "Install raster support comments. This will provide quick help info for each " @@ -2077,25 +2483,25 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:913 +#: installation.xml:938 #, no-c-format msgid "psql -d [yourdatabase] -f raster_comments.sql" msgstr "" #. Tag: para -#: installation.xml:915 +#: installation.xml:940 #, no-c-format msgid "Install topology support" msgstr "" #. Tag: command -#: installation.xml:920 +#: installation.xml:945 #, no-c-format msgid "psql -d [yourdatabase] -f topology/topology.sql" msgstr "" #. Tag: para -#: installation.xml:923 +#: installation.xml:948 #, no-c-format msgid "" "Install topology support comments. This will provide quick help info for " @@ -2104,13 +2510,13 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:929 +#: installation.xml:954 #, no-c-format msgid "psql -d [yourdatabase] -f topology/topology_comments.sql" msgstr "" #. Tag: para -#: installation.xml:934 +#: installation.xml:959 #, no-c-format msgid "" "There is an alternative legacy_minimal.sql you can run " @@ -2121,13 +2527,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:940 +#: installation.xml:965 #, no-c-format msgid "Installing and Using the address standardizer" msgstr "" #. Tag: para -#: installation.xml:941 +#: installation.xml:966 #, no-c-format msgid "" "The address_standardizer extension used to be a separate " @@ -2138,7 +2544,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:943 +#: installation.xml:968 #, no-c-format msgid "" "This standardizer can be used in conjunction with the PostGIS packaged tiger " @@ -2150,7 +2556,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:947 +#: installation.xml:972 #, no-c-format msgid "" "The address standardizer relies on PCRE which is usually already installed " @@ -2164,7 +2570,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:950 +#: installation.xml:975 #, no-c-format msgid "" "For Windows users, the PostGIS 2.1+ bundle is packaged with the " @@ -2173,26 +2579,26 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:953 +#: installation.xml:978 #, no-c-format msgid "" "Once you have installed, you can connect to your database and run the SQL:" msgstr "" #. Tag: programlisting -#: installation.xml:954 +#: installation.xml:979 #, no-c-format msgid "CREATE EXTENSION address_standardizer;" msgstr "" #. Tag: para -#: installation.xml:956 +#: installation.xml:981 #, no-c-format msgid "The following test requires no rules, gaz, or lex tables" msgstr "" #. Tag: programlisting -#: installation.xml:957 +#: installation.xml:982 #, no-c-format msgid "" "SELECT num, street, city, state, zip\n" @@ -2200,13 +2606,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:958 +#: installation.xml:983 #, no-c-format msgid "Output should be" msgstr "" #. Tag: screen -#: installation.xml:959 +#: installation.xml:984 #, no-c-format msgid "" "num | street | city | state | zip\n" @@ -2215,13 +2621,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:961 +#: installation.xml:986 #, no-c-format msgid "Installing Regex::Assemble" msgstr "" #. Tag: para -#: installation.xml:962 +#: installation.xml:987 #, no-c-format msgid "" "Perl Regex:Assemble is no longer needed for compiling address_standardizer " @@ -2233,31 +2639,31 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:963 +#: installation.xml:988 #, no-c-format msgid "cpan Regexp::Assemble" msgstr "" #. Tag: para -#: installation.xml:964 +#: installation.xml:989 #, no-c-format msgid "or if you are on Ubuntu / Debian you might need to do" msgstr "" #. Tag: programlisting -#: installation.xml:965 +#: installation.xml:990 #, no-c-format msgid "sudo perl -MCPAN -e \"install Regexp::Assemble\"" msgstr "" #. Tag: title -#: installation.xml:970 +#: installation.xml:995 #, no-c-format msgid "Installing, Upgrading Tiger Geocoder and loading data" msgstr "" #. Tag: para -#: installation.xml:972 +#: installation.xml:997 #, no-c-format msgid "" "Extras like Tiger geocoder may not be packaged in your PostGIS distribution. " @@ -2271,13 +2677,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:976 +#: installation.xml:1001 #, no-c-format msgid "Tiger Geocoder Enabling your PostGIS database: Using Extension" msgstr "" #. Tag: para -#: installation.xml:977 +#: installation.xml:1002 #, no-c-format msgid "" "If you are using PostgreSQL 9.1+ and PostGIS 2.1+, you can take advantage of " @@ -2285,7 +2691,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:979 +#: installation.xml:1004 #, no-c-format msgid "" "First get binaries for PostGIS 2.1+ or compile and install as usual. This " @@ -2293,7 +2699,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:980 +#: installation.xml:1005 #, no-c-format msgid "" "Connect to your database via psql or pgAdmin or some other tool and run the " @@ -2304,7 +2710,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:981 +#: installation.xml:1006 #, no-c-format msgid "" "CREATE EXTENSION postgis;\n" @@ -2316,7 +2722,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:983 +#: installation.xml:1008 #, no-c-format msgid "" "If you already have postgis_tiger_geocoder extension installed, and just " @@ -2324,7 +2730,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:984 +#: installation.xml:1009 #, no-c-format msgid "" "ALTER EXTENSION postgis UPDATE;\n" @@ -2332,7 +2738,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:985 +#: installation.xml:1010 #, no-c-format msgid "" "If you made custom entries or changes to tiger.loader_platformtiger.loader_platform table with " @@ -2379,7 +2785,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:993 +#: installation.xml:1018 #, no-c-format msgid "" "So for example to create a profile called debbie that follows shdeclare_sect column to " @@ -2408,7 +2814,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:997 +#: installation.xml:1022 #, no-c-format msgid "" "If you don't edit this loader_platform table, it will " @@ -2417,7 +2823,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:999 +#: installation.xml:1024 #, no-c-format msgid "" "As of PostGIS 2.4.1 the Zip code-5 digit tabulation area zcta5 function can use it if a boundary " @@ -2452,7 +2858,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1006 +#: installation.xml:1031 #, no-c-format msgid "" "Create a folder called gisdata on root of server or " @@ -2465,7 +2871,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1008 +#: installation.xml:1033 #, no-c-format msgid "" "Create a folder called temp in the gisdata folder or " @@ -2474,7 +2880,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1010 +#: installation.xml:1035 #, no-c-format msgid "" "Then run the SQL function " @@ -2483,7 +2889,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1011 +#: installation.xml:1036 #, no-c-format msgid "" "psql -c \"SELECT Loader_Generate_Nation_Script('debbie')\" -d geocoder -tA " @@ -2491,13 +2897,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1014 +#: installation.xml:1039 #, no-c-format msgid "Run the generated nation load commandline scripts." msgstr "" #. Tag: programlisting -#: installation.xml:1015 +#: installation.xml:1040 #, no-c-format msgid "" "cd /gisdata\n" @@ -2505,7 +2911,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1018 +#: installation.xml:1043 #, no-c-format msgid "" "After you are done running the nation script, you should have three tables " @@ -2514,13 +2920,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1019 +#: installation.xml:1044 #, no-c-format msgid "SELECT count(*) FROM tiger_data.county_all;" msgstr "" #. Tag: screen -#: installation.xml:1020 +#: installation.xml:1045 #, no-c-format msgid "" "count\n" @@ -2530,13 +2936,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1021 +#: installation.xml:1046 #, no-c-format msgid "SELECT count(*) FROM tiger_data.state_all;" msgstr "" #. Tag: screen -#: installation.xml:1022 +#: installation.xml:1047 #, no-c-format msgid "" "count\n" @@ -2546,7 +2952,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1025 +#: installation.xml:1050 #, no-c-format msgid "" "By default the tables corresponding to bg, " @@ -2557,7 +2963,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1027 +#: installation.xml:1052 #, no-c-format msgid "" "UPDATE tiger.loader_lookuptables SET load = true WHERE load = false AND " @@ -2565,7 +2971,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1028 +#: installation.xml:1053 #, no-c-format msgid "" "Alternatively you can load just these tables after loading state data using " @@ -2573,7 +2979,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1030 +#: installation.xml:1055 #, no-c-format msgid "" "For each state you want to load data for, generate a state script for the " @@ -2659,32 +3065,32 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1045 +#: installation.xml:1070 #, no-c-format msgid "" "Connect to your database with psql or pgAdmin and run the following command:" msgstr "" #. Tag: programlisting -#: installation.xml:1046 +#: installation.xml:1071 #, no-c-format msgid "CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;" msgstr "" #. Tag: title -#: installation.xml:1053 +#: installation.xml:1078 #, no-c-format msgid "Tiger Geocoder Enabling your PostGIS database: Not Using Extensions" msgstr "" #. Tag: para -#: installation.xml:1054 +#: installation.xml:1079 #, no-c-format msgid "First install PostGIS using the prior instructions." msgstr "" #. Tag: para -#: installation.xml:1058 installation.xml:1118 +#: installation.xml:1083 installation.xml:1143 #, no-c-format msgid "" "If you don't have an extras folder, download tiger_loader_2015.sql (or latest loader file " @@ -2719,7 +3125,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1072 +#: installation.xml:1097 #, no-c-format msgid "" "If you are installing Tiger geocoder for the first time edit either the " @@ -2730,7 +3136,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1076 +#: installation.xml:1101 #, no-c-format msgid "" "Verify that you now have a tiger schema in your database " @@ -2739,13 +3145,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1076 +#: installation.xml:1101 #, no-c-format msgid "ALTER DATABASE geocoder SET search_path=public, tiger;" msgstr "" #. Tag: para -#: installation.xml:1077 +#: installation.xml:1102 #, no-c-format msgid "" "The normalizing address functionality works more or less without any data " @@ -2753,7 +3159,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1078 +#: installation.xml:1103 #, no-c-format msgid "" "SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, " @@ -2764,13 +3170,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:1081 +#: installation.xml:1106 #, no-c-format msgid "Using Address Standardizer Extension with Tiger geocoder" msgstr "" #. Tag: para -#: installation.xml:1082 +#: installation.xml:1107 #, no-c-format msgid "" "One of the many complaints of folks is the address normalizer function unzip executable which is usually " @@ -2849,7 +3255,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1096 +#: installation.xml:1121 #, no-c-format msgid "" "For Windows, 7-zip which is a free compress/uncompress tool you can download " @@ -2857,7 +3263,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1098 +#: installation.xml:1123 #, no-c-format msgid "" "shp2pgsql commandline which is installed by default " @@ -2865,7 +3271,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1099 +#: installation.xml:1124 #, no-c-format msgid "" "wget which is a web grabber tool usually installed on " @@ -2873,7 +3279,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1100 +#: installation.xml:1125 #, no-c-format msgid "" "If you are on windows, you can get pre-compiled binaries from to " @@ -2904,7 +3310,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1108 +#: installation.xml:1133 #, no-c-format msgid "" "After the states you desire have been loaded, make sure to run the: " @@ -2913,7 +3319,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1110 +#: installation.xml:1135 #, no-c-format msgid "" "To test that things are working as they should, try to run a geocode on an " @@ -2921,13 +3327,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:1113 +#: installation.xml:1138 #, no-c-format msgid "Upgrading your Tiger Geocoder Install" msgstr "" #. Tag: para -#: installation.xml:1114 +#: installation.xml:1139 #, no-c-format msgid "" "If you have Tiger Geocoder packaged with 2.0+ already installed, you can " @@ -2937,13 +3343,13 @@ msgid "" msgstr "" #. Tag: command -#: installation.xml:1127 +#: installation.xml:1152 #, no-c-format msgid "cd postgis-&last_release_version;/extras/tiger_geocoder/tiger_2011" msgstr "" #. Tag: para -#: installation.xml:1130 +#: installation.xml:1155 #, no-c-format msgid "" "Locate the upgrade_geocoder.bat script If you are on " @@ -2952,7 +3358,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1133 +#: installation.xml:1158 #, no-c-format msgid "" "If you are upgrading from 2010 or 2011, make sure to unremark out the loader " @@ -2960,13 +3366,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1134 +#: installation.xml:1159 #, no-c-format msgid "Then run th corresponding script from the commandline." msgstr "" #. Tag: para -#: installation.xml:1138 +#: installation.xml:1163 #, no-c-format msgid "" "Next drop all nation tables and load up the new ones. Generate a drop script " @@ -2975,19 +3381,19 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1139 +#: installation.xml:1164 #, no-c-format msgid "SELECT drop_nation_tables_generate_script();" msgstr "" #. Tag: para -#: installation.xml:1140 +#: installation.xml:1165 #, no-c-format msgid "Run the generated drop SQL statements." msgstr "" #. Tag: para -#: installation.xml:1141 +#: installation.xml:1166 #, no-c-format msgid "" "Generate a nation load script with this SELECT statement as detailed in " @@ -2995,31 +3401,31 @@ msgid "" msgstr "" #. Tag: emphasis -#: installation.xml:1142 +#: installation.xml:1167 #, no-c-format msgid "For windows" msgstr "" #. Tag: programlisting -#: installation.xml:1143 +#: installation.xml:1168 #, no-c-format msgid "SELECT loader_generate_nation_script('windows');" msgstr "" #. Tag: emphasis -#: installation.xml:1144 +#: installation.xml:1169 #, no-c-format msgid "For unix/linux" msgstr "" #. Tag: programlisting -#: installation.xml:1145 +#: installation.xml:1170 #, no-c-format msgid "SELECT loader_generate_nation_script('sh');" msgstr "" #. Tag: para -#: installation.xml:1146 +#: installation.xml:1171 #, no-c-format msgid "" "Refer to for instructions on " @@ -3027,7 +3433,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1147 +#: installation.xml:1172 #, no-c-format msgid "" "You can have a mix of 2010/2011 state tables and can upgrade each state " @@ -3037,13 +3443,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:1153 +#: installation.xml:1178 #, no-c-format msgid "Create a spatially-enabled database from a template" msgstr "" #. Tag: para -#: installation.xml:1155 +#: installation.xml:1180 #, no-c-format msgid "" "Some packaged distributions of PostGIS (in particular the Win32 installers " @@ -3057,37 +3463,37 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1166 +#: installation.xml:1191 #, no-c-format msgid "From the shell:" msgstr "" #. Tag: programlisting -#: installation.xml:1170 +#: installation.xml:1195 #, no-c-format msgid "# createdb -T template_postgis my_spatial_db" msgstr "" #. Tag: para -#: installation.xml:1172 +#: installation.xml:1197 #, no-c-format msgid "From SQL:" msgstr "" #. Tag: programlisting -#: installation.xml:1176 +#: installation.xml:1201 #, no-c-format msgid "postgres=# CREATE DATABASE my_spatial_db TEMPLATE=template_postgis" msgstr "" #. Tag: title -#: installation.xml:1180 +#: installation.xml:1205 #, no-c-format msgid "Upgrading" msgstr "" #. Tag: para -#: installation.xml:1182 +#: installation.xml:1207 #, no-c-format msgid "" "Upgrading existing spatial databases can be tricky as it requires " @@ -3095,7 +3501,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1187 +#: installation.xml:1212 #, no-c-format msgid "" "Unfortunately not all definitions can be easily replaced in a live database, " @@ -3103,7 +3509,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1192 +#: installation.xml:1217 #, no-c-format msgid "" "PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and " @@ -3111,7 +3517,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1197 +#: installation.xml:1222 #, no-c-format msgid "" "Before attempting to upgrade PostGIS, it is always worth to backup your " @@ -3120,13 +3526,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:1204 +#: installation.xml:1229 #, no-c-format msgid "Soft upgrade" msgstr "" #. Tag: para -#: installation.xml:1206 +#: installation.xml:1231 #, no-c-format msgid "" "If you installed your database using extensions, you'll need to upgrade " @@ -3136,13 +3542,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:1210 +#: installation.xml:1235 #, no-c-format msgid "Soft Upgrade Pre 9.1+ or without extensions" msgstr "" #. Tag: para -#: installation.xml:1212 +#: installation.xml:1237 #, no-c-format msgid "" "This section applies only to those who installed PostGIS not using " @@ -3151,13 +3557,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1216 +#: installation.xml:1241 #, no-c-format msgid "can't drop ... because postgis extension depends on it" msgstr "" #. Tag: para -#: installation.xml:1218 +#: installation.xml:1243 #, no-c-format msgid "" "NOTE: if you are moving from PostGIS 1.* to PostGIS 2.* or from PostGIS 2.* " @@ -3166,7 +3572,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1225 +#: installation.xml:1250 #, no-c-format msgid "" "After compiling and installing (make install) you should find a set of " @@ -3175,7 +3581,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1232 +#: installation.xml:1257 #, no-c-format msgid "" "ls `pg_config --sharedir`/contrib/postgis-&last_release_version;/*_upgrade." @@ -3183,7 +3589,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1234 +#: installation.xml:1259 #, no-c-format msgid "" "Load them all in turn, starting from postgis_upgrade.sqlpostgis_upgrade.sql specific for " @@ -3234,7 +3640,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1263 +#: installation.xml:1288 #, no-c-format msgid "" "The function should inform you " @@ -3243,13 +3649,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:1270 +#: installation.xml:1295 #, no-c-format msgid "Soft Upgrade 9.1+ using extensions" msgstr "" #. Tag: para -#: installation.xml:1271 +#: installation.xml:1296 #, no-c-format msgid "" "If you originally installed PostGIS with extensions, then you need to " @@ -3258,7 +3664,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1272 +#: installation.xml:1297 #, no-c-format msgid "" "ALTER EXTENSION postgis UPDATE TO \"&last_release_version;\";\n" @@ -3266,19 +3672,19 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1273 +#: installation.xml:1298 #, no-c-format msgid "If you get an error notice something like:" msgstr "" #. Tag: programlisting -#: installation.xml:1274 +#: installation.xml:1299 #, no-c-format msgid "No migration path defined for ... to &last_release_version;" msgstr "" #. Tag: para -#: installation.xml:1275 +#: installation.xml:1300 #, no-c-format msgid "" "Then you'll need to backup your database, create a fresh one as described in " @@ -3287,13 +3693,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1276 +#: installation.xml:1301 #, no-c-format msgid "If you get a notice message like:" msgstr "" #. Tag: programlisting -#: installation.xml:1277 +#: installation.xml:1302 #, no-c-format msgid "" "Version \"&last_release_version;\" of extension \"postgis\" is already " @@ -3301,7 +3707,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1278 +#: installation.xml:1303 #, no-c-format msgid "" "Then everything is already up to date and you can safely ignore it. " @@ -3312,7 +3718,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1284 +#: installation.xml:1309 #, no-c-format msgid "" "ALTER EXTENSION postgis UPDATE TO \"&last_release_version;next\";\n" @@ -3320,7 +3726,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1285 +#: installation.xml:1310 #, no-c-format msgid "" "If you installed PostGIS originally without a version specified, you can " @@ -3330,7 +3736,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1289 +#: installation.xml:1314 #, no-c-format msgid "" "If you are upgrading PostGIS extension from a version prior to 3.0.0 you'll " @@ -3341,19 +3747,19 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1295 +#: installation.xml:1320 #, no-c-format msgid "DROP EXTENSION postgis_raster;" msgstr "" #. Tag: title -#: installation.xml:1304 +#: installation.xml:1329 #, no-c-format msgid "Hard upgrade" msgstr "" #. Tag: para -#: installation.xml:1306 +#: installation.xml:1331 #, no-c-format msgid "" "By HARD UPGRADE we mean full dump/reload of postgis-enabled databases. You " @@ -3364,7 +3770,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1315 +#: installation.xml:1340 #, no-c-format msgid "" "The dump/reload process is assisted by the postgis_restore.pl script which " @@ -3375,7 +3781,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1324 +#: installation.xml:1349 #, no-c-format msgid "" "Supplementary instructions for windows users are available at newdb database using " @@ -3451,7 +3857,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1390 +#: installation.xml:1415 #, no-c-format msgid "" "perl utils/postgis_restore.pl \"/somepath/olddb.backup\" | psql -h localhost " @@ -3459,13 +3865,13 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1396 +#: installation.xml:1421 #, no-c-format msgid "Errors may arise in the following cases:" msgstr "" #. Tag: para -#: installation.xml:1402 +#: installation.xml:1427 #, no-c-format msgid "" "Some of your views or functions make use of deprecated PostGIS objects. In " @@ -3478,7 +3884,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1414 +#: installation.xml:1439 #, no-c-format msgid "" "Some custom records of spatial_ref_sys in dump file have an invalid SRID " @@ -3492,37 +3898,49 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1428 +#: installation.xml:1453 #, 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 ), delete the invalid " -"entry from spatial_ref_sys and re-construct the check(s) with:" +"entry from spatial_ref_sys and re-construct the check(s) with: " +"ALTER TABLE spatial_ref_sys ADD CONSTRAINT " +"spatial_ref_sys_srid_check check (srid > 0 AND srid < 999000 ); ALTER TABLE spatial_ref_sys ADD PRIMARY " +"KEY(srid)); If you are upgrading an old database containing " +"french IGN cartography, you will have " +"probably SRIDs out of range and you will see, when importing your database, " +"issues like this : WARNING: SRID 310642222 converted to " +"999175 (in reserved zone) In this case, you can try " +"following steps : first throw out completely the IGN from the sql which is " +"resulting from postgis_restore.pl. So, after having run : " +"perl utils/postgis_restore.pl \"/somepath/olddb.backup\" > " +"oldbb.sql run this command : grep -v IGNF " +"olddb.sql > olddb-without-IGN.sql Create then your newdb, " +"activate the required Postgis extensions, and insert properly the french " +"system IGN with : this " +"script After these operations, import your data :" msgstr "" #. Tag: programlisting -#: installation.xml:1435 +#: installation.xml:1490 #, 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:1437 -#, no-c-format -msgid "ALTER TABLE spatial_ref_sys ADD PRIMARY KEY(srid));" +"psql -h localhost -p 5432 -U postgres -d newdb -f olddb-without-IGN.sql 2> " +"errors.txt" msgstr "" #. Tag: title -#: installation.xml:1448 +#: installation.xml:1501 #, no-c-format msgid "Common Problems during installation" msgstr "" #. Tag: para -#: installation.xml:1449 +#: installation.xml:1502 #, no-c-format msgid "" "There are several things to check when your installation or upgrade doesn't " @@ -3530,7 +3948,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1456 +#: installation.xml:1509 #, no-c-format msgid "" "Check that you have installed PostgreSQL &min_postgres_version; or newer, " @@ -3545,13 +3963,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1469 +#: installation.xml:1522 #, no-c-format msgid "SELECT version();" msgstr "" #. Tag: para -#: installation.xml:1471 +#: installation.xml:1524 #, no-c-format msgid "" "If you are running an RPM based distribution, you can check for the " @@ -3560,7 +3978,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1479 +#: installation.xml:1532 #, no-c-format msgid "" "If your upgrade fails, make sure you are restoring into a database that " @@ -3568,13 +3986,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1480 +#: installation.xml:1533 #, no-c-format msgid "SELECT postgis_full_version();" msgstr "" #. Tag: para -#: installation.xml:1484 +#: installation.xml:1537 #, no-c-format msgid "" "Also check that configure has correctly detected the location and version of " @@ -3582,7 +4000,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1491 +#: installation.xml:1544 #, no-c-format msgid "" "The output from configure is used to generate the postgis_config." @@ -3592,13 +4010,13 @@ msgid "" msgstr "" #. Tag: title -#: installation.xml:1504 +#: installation.xml:1557 #, no-c-format msgid "Loader/Dumper" msgstr "" #. Tag: para -#: installation.xml:1506 +#: installation.xml:1559 #, no-c-format msgid "" "The data loader and dumper are built and installed automatically as part of " @@ -3606,7 +4024,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: installation.xml:1511 +#: installation.xml:1564 #, no-c-format msgid "" "# cd postgis-&last_release_version;/loader\n" @@ -3615,7 +4033,7 @@ msgid "" msgstr "" #. Tag: para -#: installation.xml:1513 +#: installation.xml:1566 #, no-c-format msgid "" "The loader is called shp2pgsql and converts ESRI Shape " diff --git a/doc/po/templates/introduction.xml.pot b/doc/po/templates/introduction.xml.pot index 15c42d943..4e1865161 100644 --- a/doc/po/templates/introduction.xml.pot +++ b/doc/po/templates/introduction.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -24,7 +24,7 @@ msgstr "" #: introduction.xml:5 #, no-c-format msgid "" -"PostGIS is a spatial extender for the PostgreSQL relational database that " +"PostGIS is a spatial extension for the PostgreSQL relational database that " "was created 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 " @@ -36,8 +36,8 @@ msgstr "" #, no-c-format msgid "" "PostGIS is now a project of the OSGeo Foundation and is developed and funded " -"by many FOSS4G Developers as well as corporations all over the world that " -"gain great benefit from its functionality and versatility." +"by many FOSS4G developers and organizations all over the world that gain " +"great benefit from its functionality and versatility." msgstr "" #. Tag: para @@ -72,43 +72,28 @@ msgstr "" #. Tag: term #: introduction.xml:31 #, no-c-format -msgid "Mark Cave-Ayland" -msgstr "" - -#. Tag: para -#: introduction.xml:33 -#, no-c-format -msgid "" -"Coordinates bug fixing and maintenance effort, spatial index selectivity and " -"binding, loader/dumper, and Shapefile GUI Loader, integration of new and new " -"function enhancements." -msgstr "" - -#. Tag: term -#: introduction.xml:39 -#, no-c-format msgid "Regina Obe" msgstr "" #. Tag: para -#: introduction.xml:41 +#: introduction.xml:33 #, no-c-format msgid "" -"Buildbot Maintenance, windows production and experimental builds, " -"Documentation, alignment of PostGIS with PostgreSQL releases, general user " -"support on PostGIS newsgroup, X3D support, Tiger Geocoder Support, " +"Buildbot Maintenance, Windows production and experimental builds, " +"documentation, alignment of PostGIS with PostgreSQL releases, 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 +#: introduction.xml:41 #, no-c-format msgid "Bborie Park" msgstr "" #. Tag: para -#: introduction.xml:51 +#: introduction.xml:43 #, no-c-format msgid "" "Raster development, integration with GDAL, raster loader, user support, " @@ -116,13 +101,13 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:56 +#: introduction.xml:48 #, no-c-format msgid "Paul Ramsey (Chair)" msgstr "" #. Tag: para -#: introduction.xml:58 +#: introduction.xml:50 #, no-c-format msgid "" "Co-founder of PostGIS project. General bug fixing, geography support, " @@ -134,61 +119,61 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:65 +#: introduction.xml:57 #, no-c-format msgid "Sandro Santilli" msgstr "" #. Tag: para -#: introduction.xml:68 +#: introduction.xml:60 #, no-c-format msgid "" -"Bug fixes and maintenance, git mirrors management, integration of new GEOS " -"functionality and alignment with GEOS releases, Topology support, and Raster " -"framework and low level api functions." +"Bug fixes and maintenance, git mirror management, integration of new GEOS " +"functionality and alignment with GEOS releases, topology support, and raster " +"framework and low level API functions." msgstr "" #. Tag: title -#: introduction.xml:75 +#: introduction.xml:67 #, no-c-format msgid "Core Contributors Present" msgstr "" #. Tag: term -#: introduction.xml:78 +#: introduction.xml:70 #, no-c-format msgid "Jorge Arévalo" msgstr "" #. Tag: para -#: introduction.xml:80 +#: introduction.xml:72 #, no-c-format msgid "Raster development, GDAL driver support, loader" msgstr "" #. Tag: term -#: introduction.xml:85 +#: introduction.xml:77 #, no-c-format msgid "Nicklas Avén" msgstr "" #. Tag: para -#: introduction.xml:88 +#: introduction.xml:80 #, no-c-format msgid "" "Distance function enhancements (including 3D distance and relationship " -"functions) and additions, Tiny WKB output format (TWKB) (in development) and " -"general user support" +"functions) and additions, Tiny WKB (TWKB) output format and general user " +"support" msgstr "" #. Tag: term -#: introduction.xml:93 +#: introduction.xml:85 #, no-c-format msgid "Dan Baston" msgstr "" #. Tag: para -#: introduction.xml:96 +#: introduction.xml:88 #, no-c-format msgid "" "Geometry clustering function additions, other geometry algorithm " @@ -196,25 +181,37 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:101 +#: introduction.xml:93 #, no-c-format msgid "Olivier Courtin" msgstr "" #. Tag: para -#: introduction.xml:103 +#: introduction.xml:95 #, no-c-format -msgid "Input output XML (KML,GML)/GeoJSON functions, 3D support and bug fixes." +msgid "Input/output XML (KML,GML)/GeoJSON functions, 3D support and bug fixes." msgstr "" #. Tag: term -#: introduction.xml:108 +#: introduction.xml:100 +#, no-c-format +msgid "Martin Davis" +msgstr "" + +#. Tag: para +#: introduction.xml:102 +#, no-c-format +msgid "GEOS enhancements and documentation" +msgstr "" + +#. Tag: term +#: introduction.xml:107 #, no-c-format msgid "Björn Harrtell" msgstr "" #. Tag: para -#: introduction.xml:111 +#: introduction.xml:110 #, no-c-format msgid "" "MapBox Vector Tile and GeoBuf functions. Gogs testing and GitLab " @@ -222,71 +219,86 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:117 +#: introduction.xml:116 #, no-c-format msgid "Mateusz Loskot" msgstr "" #. Tag: para -#: introduction.xml:119 +#: introduction.xml:118 #, no-c-format msgid "" "CMake support for PostGIS, built original raster loader in python and low " -"level raster api functions" +"level raster API functions" msgstr "" #. Tag: term -#: introduction.xml:124 +#: introduction.xml:123 #, no-c-format msgid "Raúl Marín Rodríguez" msgstr "" #. Tag: para -#: introduction.xml:126 +#: introduction.xml:125 #, no-c-format msgid "Bug fixing" msgstr "" #. Tag: term -#: introduction.xml:131 +#: introduction.xml:130 #, no-c-format msgid "Darafei Praliaskouski" msgstr "" #. Tag: para -#: introduction.xml:134 +#: introduction.xml:133 #, no-c-format msgid "" "Index improvements, bug fixing and geometry/geography function improvements, " -"GitHub curator, and Travis bot maintenance." +"GitHub curation, and Travis bot maintenance." msgstr "" #. Tag: term -#: introduction.xml:140 +#: introduction.xml:139 #, no-c-format msgid "Pierre Racine" msgstr "" #. Tag: para -#: introduction.xml:142 +#: introduction.xml:141 #, no-c-format msgid "Raster overall architecture, prototyping, programming support" msgstr "" #. Tag: title -#: introduction.xml:148 +#: introduction.xml:147 #, no-c-format msgid "Core Contributors Past" msgstr "" #. Tag: term +#: introduction.xml:150 +#, no-c-format +msgid "Mark Cave-Ayland" +msgstr "" + +#. Tag: para #: introduction.xml:152 #, no-c-format +msgid "" +"Prior PSC Member. Coordinated bug fixing and maintenance effort, spatial " +"index selectivity and binding, loader/dumper, and Shapefile GUI Loader, " +"integration of new and new function enhancements." +msgstr "" + +#. Tag: term +#: introduction.xml:158 +#, no-c-format msgid "Chris Hodgson" msgstr "" #. Tag: para -#: introduction.xml:154 +#: introduction.xml:160 #, no-c-format msgid "" "Prior PSC Member. General development, site and buildbot maintenance, OSGeo " @@ -294,13 +306,13 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:159 +#: introduction.xml:165 #, no-c-format msgid "Kevin Neufeld" msgstr "" #. Tag: para -#: introduction.xml:161 +#: introduction.xml:167 #, no-c-format msgid "" "Prior PSC Member. Documentation and documentation support tools, buildbot " @@ -309,13 +321,13 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:167 +#: introduction.xml:173 #, no-c-format msgid "Dave Blasby" msgstr "" #. Tag: para -#: introduction.xml:170 +#: introduction.xml:176 #, no-c-format msgid "" "The original developer/Co-founder of PostGIS. Dave wrote the server side " @@ -323,27 +335,25 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:177 +#: introduction.xml:183 #, no-c-format msgid "Jeff Lounsbury" msgstr "" #. Tag: para -#: introduction.xml:179 +#: introduction.xml:185 #, no-c-format -msgid "" -"Original development of the Shape file loader/dumper. Current PostGIS " -"Project Owner representative." +msgid "Original development of the Shapefile loader/dumper." msgstr "" #. Tag: term -#: introduction.xml:185 +#: introduction.xml:191 #, no-c-format msgid "Mark Leslie" msgstr "" #. Tag: para -#: introduction.xml:187 +#: introduction.xml:193 #, no-c-format msgid "" "Ongoing maintenance and development of core functions. Enhanced curve " @@ -351,240 +361,911 @@ msgid "" msgstr "" #. Tag: term -#: introduction.xml:192 +#: introduction.xml:198 #, no-c-format msgid "David Zwarg" msgstr "" #. Tag: para -#: introduction.xml:194 +#: introduction.xml:200 #, no-c-format msgid "Raster development (mostly map algebra analytic functions)" msgstr "" #. Tag: title -#: introduction.xml:200 +#: introduction.xml:206 #, no-c-format msgid "Other Contributors" msgstr "" #. Tag: term -#: introduction.xml:203 +#: introduction.xml:209 #, no-c-format msgid "Individual Contributors" msgstr "" -#. Tag: para -#: introduction.xml:206 +#. Tag: member +#: introduction.xml:214 #, 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, " -"Jason Smith, Jeff Adams, Jose Carlos Martinez Llari, Julien Rouhaud, 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, Mike Toews, Nathan Wagner, Nathaniel Clay, Nikita " -"Shulga, Norman Vine, Rafal Magda, Ralph Mason, Rémi Cura, Richard Greenwood, " -"Silvio Grosso, Steffen Macke, Stephen Frost, Tom van Tilburg, Vincent Mora, " -"Vincent Picavet" +msgid "Alex Bodnaru" msgstr "" -#. Tag: term +#. Tag: member +#: introduction.xml:215 +#, no-c-format +msgid "Alex Mayrhofer" +msgstr "" + +#. Tag: member +#: introduction.xml:216 +#, no-c-format +msgid "Andrea Peri" +msgstr "" + +#. Tag: member +#: introduction.xml:217 +#, no-c-format +msgid "Andreas Forø Tollefsen" +msgstr "" + +#. Tag: member +#: introduction.xml:218 +#, no-c-format +msgid "Andreas Neumann" +msgstr "" + +#. Tag: member +#: introduction.xml:219 +#, no-c-format +msgid "Anne Ghisla" +msgstr "" + +#. Tag: member +#: introduction.xml:220 +#, no-c-format +msgid "Antoine Bajolet" +msgstr "" + +#. Tag: member +#: introduction.xml:221 +#, no-c-format +msgid "Artur Zakirov" +msgstr "" + +#. Tag: member +#: introduction.xml:222 +#, no-c-format +msgid "Barbara Phillipot" +msgstr "" + +#. Tag: member +#: introduction.xml:223 +#, no-c-format +msgid "Ben Jubb" +msgstr "" + +#. Tag: member +#: introduction.xml:224 +#, no-c-format +msgid "Bernhard Reiter" +msgstr "" + +#. Tag: member +#: introduction.xml:225 +#, no-c-format +msgid "Björn Esser" +msgstr "" + +#. Tag: member +#: introduction.xml:226 +#, no-c-format +msgid "Brian Hamlin" +msgstr "" + +#. Tag: member +#: introduction.xml:227 +#, no-c-format +msgid "Bruce Rindahl" +msgstr "" + +#. Tag: member +#: introduction.xml:228 +#, no-c-format +msgid "Bruno Wolff III" +msgstr "" + +#. Tag: member +#: introduction.xml:229 +#, no-c-format +msgid "Bryce L. Nordgren" +msgstr "" + +#. Tag: member +#: introduction.xml:230 +#, no-c-format +msgid "Carl Anderson" +msgstr "" + +#. Tag: member +#: introduction.xml:231 +#, no-c-format +msgid "Charlie Savage" +msgstr "" + +#. Tag: member +#: introduction.xml:232 +#, no-c-format +msgid "Christoph Berg" +msgstr "" + +#. Tag: member +#: introduction.xml:233 +#, no-c-format +msgid "Christoph Moench-Tegeder" +msgstr "" + +#. Tag: member +#: introduction.xml:234 +#, no-c-format +msgid "Dane Springmeyer" +msgstr "" + +#. Tag: member +#: introduction.xml:235 +#, no-c-format +msgid "Dave Fuhry" +msgstr "" + +#. Tag: member +#: introduction.xml:236 +#, no-c-format +msgid "David Garnier" +msgstr "" + +#. Tag: member +#: introduction.xml:237 +#, no-c-format +msgid "David Skea" +msgstr "" + +#. Tag: member +#: introduction.xml:238 +#, no-c-format +msgid "David Techer" +msgstr "" + +#. Tag: member +#: introduction.xml:239 +#, no-c-format +msgid "Dmitry Vasilyev" +msgstr "" + +#. Tag: member +#: introduction.xml:240 +#, no-c-format +msgid "Eduin Carrillo" +msgstr "" + +#. Tag: member +#: introduction.xml:241 +#, no-c-format +msgid "Eugene Antimirov" +msgstr "" + +#. Tag: member +#: introduction.xml:242 +#, no-c-format +msgid "Even Rouault" +msgstr "" + +#. Tag: member +#: introduction.xml:243 +#, no-c-format +msgid "Frank Warmerdam" +msgstr "" + +#. Tag: member +#: introduction.xml:244 +#, no-c-format +msgid "George Silva" +msgstr "" + +#. Tag: member +#: introduction.xml:245 +#, no-c-format +msgid "Gerald Fenoy" +msgstr "" + +#. Tag: member +#: introduction.xml:246 +#, no-c-format +msgid "Gino Lucrezi" +msgstr "" + +#. Tag: member +#: introduction.xml:247 +#, no-c-format +msgid "Greg Troxel" +msgstr "" + +#. Tag: member +#: introduction.xml:248 +#, no-c-format +msgid "Guillaume Lelarge" +msgstr "" + +#. Tag: member +#: introduction.xml:249 +#, no-c-format +msgid "Haribabu Kommi" +msgstr "" + +#. Tag: member +#: introduction.xml:250 +#, no-c-format +msgid "Havard Tveite" +msgstr "" + +#. Tag: member +#: introduction.xml:251 +#, no-c-format +msgid "IIDA Tetsushi" +msgstr "" + +#. Tag: member +#: introduction.xml:252 +#, no-c-format +msgid "Ingvild Nystuen" +msgstr "" + +#. Tag: member +#: introduction.xml:253 +#, no-c-format +msgid "Jackie Leng" +msgstr "" + +#. Tag: member +#: introduction.xml:254 +#, no-c-format +msgid "James Marca" +msgstr "" + +#. Tag: member +#: introduction.xml:255 +#, no-c-format +msgid "Jason Smith" +msgstr "" + +#. Tag: member +#: introduction.xml:256 +#, no-c-format +msgid "Jeff Adams" +msgstr "" + +#. Tag: member +#: introduction.xml:257 +#, no-c-format +msgid "Jonne Savolainen" +msgstr "" + +#. Tag: member +#: introduction.xml:258 +#, no-c-format +msgid "Jose Carlos Martinez Llari" +msgstr "" + +#. Tag: member +#: introduction.xml:259 +#, no-c-format +msgid "Jörg Habenicht" +msgstr "" + +#. Tag: member +#: introduction.xml:260 +#, no-c-format +msgid "Julien Rouhaud" +msgstr "" + +#. Tag: member +#: introduction.xml:261 +#, no-c-format +msgid "Kashif Rasul" +msgstr "" + +#. Tag: member +#: introduction.xml:262 +#, no-c-format +msgid "Klaus Foerster" +msgstr "" + +#. Tag: member +#: introduction.xml:263 +#, no-c-format +msgid "Kris Jurka" +msgstr "" + +#. Tag: member +#: introduction.xml:264 +#, no-c-format +msgid "Laurenz Albe" +msgstr "" + +#. Tag: member +#: introduction.xml:265 +#, no-c-format +msgid "Lars Roessiger" +msgstr "" + +#. Tag: member +#: introduction.xml:266 +#, no-c-format +msgid "Leo Hsu" +msgstr "" + +#. Tag: member +#: introduction.xml:267 +#, no-c-format +msgid "Loic Dachary" +msgstr "" + +#. Tag: member +#: introduction.xml:268 +#, no-c-format +msgid "Luca S. Percich" +msgstr "" + +#. Tag: member +#: introduction.xml:269 +#, no-c-format +msgid "Maria Arias de Reyna" +msgstr "" + +#. Tag: member #: introduction.xml:270 #, no-c-format -msgid "Corporate Sponsors" +msgid "Marc Ducobu" msgstr "" -#. Tag: para +#. Tag: member +#: introduction.xml:271 +#, no-c-format +msgid "Mark Sondheim" +msgstr "" + +#. Tag: member +#: introduction.xml:272 +#, no-c-format +msgid "Markus Schaber" +msgstr "" + +#. Tag: member #: introduction.xml:273 #, no-c-format -msgid "" -"These are corporate entities that have contributed developer time, hosting, " -"or direct monetary funding to the PostGIS project" +msgid "Markus Wanner" msgstr "" -#. Tag: para +#. Tag: member #: introduction.xml:274 #, no-c-format -msgid "" -"In alphabetical order: Arrival 3D, Associazione Italiana per l'Informazione " -"Geografica Libera (GFOSS.it), AusVet, Avencia, Azavea, Cadcorp, CampToCamp, " -"CartoDB, 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, Maponics, Michigan Tech Research Institute, Natural Resources Canada, " -"Norwegian Forest and Landscape Institute, Boundless (former OpenGeo), OSGeo, " -"Oslandia, Palantir Technologies, Paragon Corporation, R3 GIS, Refractions " -"Research, Regione Toscana - SITA, Safe Software, Sirius Corporation plc, " -"Stadt Uster, UC Davis Center for Vectorborne Diseases, University of Laval, " -"U.S Department of State (HIU), Zonar Systems" +msgid "Matt Amos" +msgstr "" + +#. Tag: member +#: introduction.xml:275 +#, no-c-format +msgid "Matthias Bay" +msgstr "" + +#. Tag: member +#: introduction.xml:276 +#, no-c-format +msgid "Maxime Guillaud" +msgstr "" + +#. Tag: member +#: introduction.xml:277 +#, no-c-format +msgid "Maxime van Noppen" +msgstr "" + +#. Tag: member +#: introduction.xml:278 +#, no-c-format +msgid "Michael Fuhr" +msgstr "" + +#. Tag: member +#: introduction.xml:279 +#, no-c-format +msgid "Mike Toews" +msgstr "" + +#. Tag: member +#: introduction.xml:280 +#, no-c-format +msgid "Nathan Wagner" +msgstr "" + +#. Tag: member +#: introduction.xml:281 +#, no-c-format +msgid "Nathaniel Clay" +msgstr "" + +#. Tag: member +#: introduction.xml:282 +#, no-c-format +msgid "Nikita Shulga" +msgstr "" + +#. Tag: member +#: introduction.xml:283 +#, no-c-format +msgid "Norman Vine" +msgstr "" + +#. Tag: member +#: introduction.xml:284 +#, no-c-format +msgid "Patricia Tozer" +msgstr "" + +#. Tag: member +#: introduction.xml:285 +#, no-c-format +msgid "Rafal Magda" +msgstr "" + +#. Tag: member +#: introduction.xml:286 +#, no-c-format +msgid "Ralph Mason" +msgstr "" + +#. Tag: member +#: introduction.xml:287 +#, no-c-format +msgid "Rémi Cura" +msgstr "" + +#. Tag: member +#: introduction.xml:288 +#, no-c-format +msgid "Richard Greenwood" +msgstr "" + +#. Tag: member +#: introduction.xml:289 +#, no-c-format +msgid "Roger Crew" +msgstr "" + +#. Tag: member +#: introduction.xml:290 +#, no-c-format +msgid "Ron Mayer" +msgstr "" + +#. Tag: member +#: introduction.xml:291 +#, no-c-format +msgid "Sebastiaan Couwenberg" +msgstr "" + +#. Tag: member +#: introduction.xml:292 +#, no-c-format +msgid "Sergey Fedoseev" +msgstr "" + +#. Tag: member +#: introduction.xml:293 +#, no-c-format +msgid "Shinichi Sugiyama" +msgstr "" + +#. Tag: member +#: introduction.xml:294 +#, no-c-format +msgid "Shoaib Burq" +msgstr "" + +#. Tag: member +#: introduction.xml:295 +#, no-c-format +msgid "Silvio Grosso" +msgstr "" + +#. Tag: member +#: introduction.xml:296 +#, no-c-format +msgid "Steffen Macke" +msgstr "" + +#. Tag: member +#: introduction.xml:297 +#, no-c-format +msgid "Stepan Kuzmin" +msgstr "" + +#. Tag: member +#: introduction.xml:298 +#, no-c-format +msgid "Stephen Frost" +msgstr "" + +#. Tag: member +#: introduction.xml:299 +#, no-c-format +msgid "Talha Rizwan" +msgstr "" + +#. Tag: member +#: introduction.xml:300 +#, no-c-format +msgid "Tom Glancy" +msgstr "" + +#. Tag: member +#: introduction.xml:301 +#, no-c-format +msgid "Tom van Tilburg" +msgstr "" + +#. Tag: member +#: introduction.xml:302 +#, no-c-format +msgid "Vincent Mora" +msgstr "" + +#. Tag: member +#: introduction.xml:303 +#, no-c-format +msgid "Vincent Picavet" +msgstr "" + +#. Tag: member +#: introduction.xml:304 +#, no-c-format +msgid "Volf Tomáš" msgstr "" #. Tag: term -#: introduction.xml:316 +#: introduction.xml:311 #, no-c-format -msgid "Crowd Funding Campaigns" +msgid "Corporate Sponsors" msgstr "" #. Tag: para -#: introduction.xml:319 +#: introduction.xml:314 #, 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 PostGIS newsgroup your " -"thoughts and together we can make it happen." +"These are corporate entities that have contributed developer time, hosting, " +"or direct monetary funding to the PostGIS project. In alphabetical order:" msgstr "" -#. Tag: para +#. Tag: ulink +#: introduction.xml:317 +#, no-c-format +msgid "Arrival 3D" +msgstr "" + +#. Tag: ulink +#: introduction.xml:318 +#, no-c-format +msgid "Associazione Italiana per l'Informazione Geografica Libera (GFOSS.it)" +msgstr "" + +#. Tag: ulink +#: introduction.xml:319 +#, no-c-format +msgid "AusVet" +msgstr "" + +#. Tag: simpara #: introduction.xml:320 #, no-c-format -msgid "" -"PostGIS 2.0.0 was the first release we tried this strategy. We used PledgeBank and we got two " -"successful campaigns out of it." +msgid "Avencia" msgstr "" -#. Tag: para +#. Tag: ulink #: introduction.xml:321 #, no-c-format -msgid "" -"postgistopology - 10 plus sponsors each " -"contributed $250 USD to build toTopoGeometry function and beef up topology " -"support in 2.0.0. It happened." +msgid "Azavea" msgstr "" -#. Tag: para +#. Tag: ulink #: introduction.xml:322 #, no-c-format -msgid "" -"postgis64windows - 20 someodd sponsors each " -"contributed $100 USD to pay for the work needed to work out PostGIS 64-bit " -"issues on windows. It happened. We now have a 64-bit release for PostGIS " -"2.0.1 available on PostgreSQL stack builder." +msgid "Boundless" msgstr "" -#. Tag: term +#. Tag: ulink +#: introduction.xml:323 +#, no-c-format +msgid "Cadcorp" +msgstr "" + +#. Tag: ulink +#: introduction.xml:324 +#, no-c-format +msgid "Camptocamp" +msgstr "" + +#. Tag: ulink +#: introduction.xml:325 +#, no-c-format +msgid "Carto" +msgstr "" + +#. Tag: ulink +#: introduction.xml:326 +#, no-c-format +msgid "City of Boston (DND)" +msgstr "" + +#. Tag: ulink #: introduction.xml:327 #, no-c-format -msgid "Important Support Libraries" +msgid "City of Helsinki" msgstr "" -#. Tag: para +#. Tag: ulink +#: introduction.xml:328 +#, no-c-format +msgid "Clever Elephant Solutions" +msgstr "" + +#. Tag: ulink +#: introduction.xml:329 +#, no-c-format +msgid "Cooperativa Alveo" +msgstr "" + +#. Tag: ulink #: introduction.xml:330 #, no-c-format -msgid "" -"The GEOS 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." +msgid "Deimos Space" msgstr "" -#. Tag: para +#. Tag: ulink +#: introduction.xml:331 +#, no-c-format +msgid "Faunalia" +msgstr "" + +#. Tag: ulink +#: introduction.xml:332 +#, no-c-format +msgid "Geographic Data BC" +msgstr "" + +#. Tag: ulink +#: introduction.xml:333 +#, no-c-format +msgid "Hunter Systems Group" +msgstr "" + +#. Tag: ulink +#: introduction.xml:334 +#, no-c-format +msgid "ISciences, LLC" +msgstr "" + +#. Tag: ulink #: introduction.xml:335 #, no-c-format -msgid "" -"The GDAL 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." +msgid "Lidwala Consulting Engineers" msgstr "" -#. Tag: para +#. Tag: ulink +#: introduction.xml:336 +#, no-c-format +msgid "LISAsoft" +msgstr "" + +#. Tag: simpara +#: introduction.xml:337 +#, no-c-format +msgid "Logical Tracking & Tracing International AG" +msgstr "" + +#. Tag: simpara +#: introduction.xml:338 +#, no-c-format +msgid "Maponics" +msgstr "" + +#. Tag: ulink +#: introduction.xml:339 +#, no-c-format +msgid "Michigan Tech Research Institute" +msgstr "" + +#. Tag: ulink #: introduction.xml:340 #, no-c-format -msgid "" -"The Proj4 cartographic " -"projection library, and the work of Gerald Evenden and Frank Warmerdam in " -"creating and maintaining it." +msgid "Natural Resources Canada" msgstr "" -#. Tag: para +#. Tag: simpara +#: introduction.xml:341 +#, no-c-format +msgid "Norwegian Forest and Landscape Institue" +msgstr "" + +#. Tag: ulink +#: introduction.xml:342 +#, no-c-format +msgid "OSGeo" +msgstr "" + +#. Tag: ulink +#: introduction.xml:343 +#, no-c-format +msgid "Oslandia" +msgstr "" + +#. Tag: ulink #: introduction.xml:344 #, no-c-format -msgid "" -"Last but not least, the PostgreSQL " -"DBMS, 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." +msgid "Palantir Technologies" msgstr "" -#. Tag: title +#. Tag: ulink +#: introduction.xml:345 +#, no-c-format +msgid "Paragon Corporation" +msgstr "" + +#. Tag: ulink +#: introduction.xml:346 +#, no-c-format +msgid "R3 GIS" +msgstr "" + +#. Tag: ulink +#: introduction.xml:347 +#, no-c-format +msgid "Refractions Research" +msgstr "" + +#. Tag: ulink +#: introduction.xml:348 +#, no-c-format +msgid "Regione Toscana - SITA" +msgstr "" + +#. Tag: ulink +#: introduction.xml:349 +#, no-c-format +msgid "Safe Software" +msgstr "" + +#. Tag: simpara +#: introduction.xml:350 +#, no-c-format +msgid "Sirius Corporation plc" +msgstr "" + +#. Tag: ulink +#: introduction.xml:351 +#, no-c-format +msgid "Stadt Uster" +msgstr "" + +#. Tag: ulink +#: introduction.xml:352 +#, no-c-format +msgid "UC Davis Center for Vectorborne Diseases" +msgstr "" + +#. Tag: ulink #: introduction.xml:353 #, no-c-format -msgid "More Information" +msgid "Université Laval" +msgstr "" + +#. Tag: ulink +#: introduction.xml:354 +#, no-c-format +msgid "U.S. Department of State (HIU)" +msgstr "" + +#. Tag: ulink +#: introduction.xml:355 +#, no-c-format +msgid "Zonar Systems" +msgstr "" + +#. Tag: term +#: introduction.xml:362 +#, no-c-format +msgid "Crowd Funding Campaigns" +msgstr "" + +#. Tag: para +#: introduction.xml:365 +#, 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 PostGIS newsgroup your " +"thoughts and together we can make it happen." msgstr "" #. Tag: para -#: introduction.xml:357 +#: introduction.xml:366 #, no-c-format msgid "" -"The latest software, documentation and news items are available at the " -"PostGIS web site, http://postgis.net." +"PostGIS 2.0.0 was the first release we tried this strategy. We used PledgeBank and we got two " +"successful campaigns out of it." msgstr "" #. Tag: para -#: introduction.xml:363 +#: introduction.xml:367 #, no-c-format msgid "" -"More information about the GEOS geometry operations library is available " -"at http://trac.osgeo.org/geos/." +"postgistopology - 10 plus sponsors each " +"contributed $250 USD to build toTopoGeometry function and beef up topology " +"support in 2.0.0. It happened." msgstr "" #. Tag: para -#: introduction.xml:369 +#: introduction.xml:368 #, no-c-format msgid "" -"More information about the Proj4 reprojection library is available at http://trac.osgeo.org/proj/." +"postgis64windows - 20 someodd sponsors each " +"contributed $100 USD to pay for the work needed to work out PostGIS 64-bit " +"issues on windows. It happened." +msgstr "" + +#. Tag: term +#: introduction.xml:373 +#, no-c-format +msgid "Important Support Libraries" msgstr "" #. Tag: para -#: introduction.xml:375 +#: introduction.xml:376 #, no-c-format msgid "" -"More information about the PostgreSQL database server is available at the " -"PostgreSQL main site http://www." -"postgresql.org." +"The GEOS geometry operations " +"library" msgstr "" #. Tag: para -#: introduction.xml:381 +#: introduction.xml:379 #, no-c-format msgid "" -"More information about GiST indexing is available at the PostgreSQL GiST " -"development site, http://www.sai.msu.su/~megera/postgres/gist/." +"The GDAL Geospatial Data " +"Abstraction Library used to power much of the raster functionality " +"introduced in PostGIS 2. In kind, improvements needed in GDAL to support " +"PostGIS are contributed back to the GDAL project." msgstr "" #. Tag: para -#: introduction.xml:387 +#: introduction.xml:384 #, no-c-format msgid "" -"More information about MapServer internet map server is available at http://mapserver.org." +"The PROJ cartographic " +"projection library" msgstr "" #. Tag: para -#: introduction.xml:393 +#: introduction.xml:387 #, no-c-format msgid "" -"The "Simple " -"Features for Specification for SQL" is available at the OpenGIS " -"Consortium web site: http://" -"www.opengeospatial.org/." +"Last but not least, PostgreSQL, 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 "" diff --git a/doc/po/templates/performance_tips.xml.pot b/doc/po/templates/performance_tips.xml.pot index 12f016dc4..b0bf87e3b 100644 --- a/doc/po/templates/performance_tips.xml.pot +++ b/doc/po/templates/performance_tips.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-08-24 19:57+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -492,30 +492,34 @@ msgstr "" msgid "SET maintenance_work_mem TO '1GB';" msgstr "" +#. Tag: ulink +#: performance_tips.xml:273 +#, no-c-format +msgid "max_parallel_workers_per_gather" +msgstr "" + #. Tag: para -#: performance_tips.xml:272 +#: performance_tips.xml:275 #, no-c-format msgid "" -"max_parallel_workers_per_gather This setting is only available " -"for PostgreSQL 9.6+ and will only affect PostGIS 2.3+, since only PostGIS " -"2.3+ supports parallel queries. If set to higher than 0, then some queries " -"such as those involving relation functions like ST_Intersects " -"can use multiple processes and can run more than twice as fast when doing " -"so. If you have a lot of processors to spare, you should change the value of " -"this to as many processors as you have. Also make sure to bump up " -"max_worker_processes to at least as high as this number." +"This setting is only available for PostgreSQL 9.6+ and will only affect " +"PostGIS 2.3+, since only PostGIS 2.3+ supports parallel queries. If set to " +"higher than 0, then some queries such as those involving relation functions " +"like ST_Intersects can use multiple processes and can run more " +"than twice as fast when doing so. If you have a lot of processors to spare, " +"you should change the value of this to as many processors as you have. Also " +"make sure to bump up max_worker_processes to at least as high " +"as this number." msgstr "" #. Tag: para -#: performance_tips.xml:282 +#: performance_tips.xml:284 #, no-c-format msgid "Default: 0" msgstr "" #. Tag: para -#: performance_tips.xml:287 +#: performance_tips.xml:289 #, no-c-format msgid "" "Sets the maximum number of workers that can be started by a single " diff --git a/doc/po/templates/postgis.xml.pot b/doc/po/templates/postgis.xml.pot index 7cb0e3546..2af47fef6 100644 --- a/doc/po/templates/postgis.xml.pot +++ b/doc/po/templates/postgis.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:02+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -15,19 +15,19 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: postgis.xml:128 +#: postgis.xml:136 #, no-c-format msgid "PostGIS &last_release_version; Manual" msgstr "" #. Tag: corpauthor -#: postgis.xml:132 +#: postgis.xml:140 #, no-c-format msgid "The PostGIS Development Group" msgstr "" #. Tag: affiliation -#: postgis.xml:138 +#: postgis.xml:146 #, no-c-format msgid "" "clever elephant\n" "Language-Team: LANGUAGE \n" @@ -46,10 +46,12 @@ msgstr "" #: reference.xml:16 #, no-c-format msgid "" -"&reference_type; &reference_guc; &reference_management; " -"&reference_constructor; &reference_accessor; &reference_editor; " -"&reference_output; &reference_operator; &reference_measure; " -"&reference_sfcgal; &reference_processing; &reference_lrs; " -"&reference_temporal; &reference_transaction; &reference_misc; " -"&reference_exception;" +"&reference_type; &reference_management; &reference_constructor; " +"&reference_accessor; &reference_editor; &reference_validation; " +"&reference_srs; &reference_input; &reference_output; &reference_operator; " +"&reference_relationship; &reference_measure; &reference_processing; " +"&reference_transformation; &reference_cluster; &reference_bbox; " +"&reference_lrs; &reference_trajectory; &reference_sfcgal; " +"&reference_transaction; &reference_version; &reference_guc; " +"&reference_troubleshooting;" msgstr "" diff --git a/doc/po/templates/reference_accessor.xml.pot b/doc/po/templates/reference_accessor.xml.pot index ad7722f4c..2488bf2d7 100644 --- a/doc/po/templates/reference_accessor.xml.pot +++ b/doc/po/templates/reference_accessor.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -29,13 +29,11 @@ msgstr "" #. Tag: refpurpose #: reference_accessor.xml:10 #, no-c-format -msgid "" -"Returns the type of the geometry as a string. Eg: 'LINESTRING', " -"'POLYGON', 'MULTIPOINT', etc." +msgid "Returns the type of a geometry as text." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:16 +#: reference_accessor.xml:15 #, no-c-format msgid "" "text GeometryType " @@ -43,43 +41,40 @@ msgid "" msgstr "" #. Tag: title -#: reference_accessor.xml:24 reference_accessor.xml:81 -#: reference_accessor.xml:162 reference_accessor.xml:210 -#: reference_accessor.xml:258 reference_accessor.xml:309 -#: reference_accessor.xml:370 reference_accessor.xml:441 -#: reference_accessor.xml:490 reference_accessor.xml:551 -#: reference_accessor.xml:602 reference_accessor.xml:667 -#: reference_accessor.xml:737 reference_accessor.xml:800 -#: reference_accessor.xml:859 reference_accessor.xml:914 -#: reference_accessor.xml:958 reference_accessor.xml:1009 -#: reference_accessor.xml:1066 reference_accessor.xml:1138 -#: reference_accessor.xml:1190 reference_accessor.xml:1249 -#: reference_accessor.xml:1295 reference_accessor.xml:1330 -#: reference_accessor.xml:1369 reference_accessor.xml:1409 -#: reference_accessor.xml:1452 reference_accessor.xml:1514 -#: reference_accessor.xml:1555 reference_accessor.xml:1599 -#: reference_accessor.xml:1656 reference_accessor.xml:1720 -#: reference_accessor.xml:1769 reference_accessor.xml:1812 -#: reference_accessor.xml:1865 reference_accessor.xml:1939 -#: reference_accessor.xml:1982 reference_accessor.xml:2027 -#: reference_accessor.xml:2073 reference_accessor.xml:2115 -#: reference_accessor.xml:2160 reference_accessor.xml:2206 -#: reference_accessor.xml:2248 reference_accessor.xml:2294 -#: reference_accessor.xml:2335 +#: reference_accessor.xml:23 reference_accessor.xml:79 +#: reference_accessor.xml:160 reference_accessor.xml:207 +#: reference_accessor.xml:252 reference_accessor.xml:310 +#: reference_accessor.xml:379 reference_accessor.xml:425 +#: reference_accessor.xml:475 reference_accessor.xml:536 +#: reference_accessor.xml:606 reference_accessor.xml:653 +#: reference_accessor.xml:714 reference_accessor.xml:760 +#: reference_accessor.xml:802 reference_accessor.xml:866 +#: reference_accessor.xml:935 reference_accessor.xml:997 +#: reference_accessor.xml:1054 reference_accessor.xml:1109 +#: reference_accessor.xml:1152 reference_accessor.xml:1202 +#: reference_accessor.xml:1250 reference_accessor.xml:1296 +#: reference_accessor.xml:1339 reference_accessor.xml:1374 +#: reference_accessor.xml:1413 reference_accessor.xml:1452 +#: reference_accessor.xml:1495 reference_accessor.xml:1556 +#: reference_accessor.xml:1596 reference_accessor.xml:1638 +#: reference_accessor.xml:1695 reference_accessor.xml:1759 +#: reference_accessor.xml:1810 reference_accessor.xml:1862 +#: reference_accessor.xml:1935 reference_accessor.xml:1979 +#: reference_accessor.xml:2024 reference_accessor.xml:2068 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_accessor.xml:26 +#: reference_accessor.xml:25 #, no-c-format msgid "" -"Returns the type of the geometry as a string. Eg: 'LINESTRING', " -"'POLYGON', 'MULTIPOINT', etc." +"Returns the type of the geometry as a string. Eg: 'LINESTRING', 'POLYGON', " +"'MULTIPOINT', etc." msgstr "" #. Tag: para -#: reference_accessor.xml:29 +#: reference_accessor.xml:28 #, no-c-format msgid "" "OGC SPEC s2.1.1.1 - Returns the name of the instantiable subtype of Geometry " @@ -88,7 +83,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:35 +#: reference_accessor.xml:34 #, no-c-format msgid "" "This function also indicates if the geometry is measured, by returning a " @@ -96,8 +91,9 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:38 reference_accessor.xml:504 -#: reference_accessor.xml:1414 +#: reference_accessor.xml:37 reference_accessor.xml:266 +#: reference_accessor.xml:326 reference_accessor.xml:667 +#: reference_accessor.xml:1457 #, no-c-format msgid "" "Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " @@ -105,101 +101,97 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:39 reference_accessor.xml:168 -#: reference_accessor.xml:506 reference_accessor.xml:613 -#: reference_accessor.xml:805 reference_accessor.xml:1085 -#: reference_accessor.xml:1258 reference_accessor.xml:1521 -#: reference_accessor.xml:1563 reference_accessor.xml:1673 -#: reference_accessor.xml:2078 +#: reference_accessor.xml:38 reference_accessor.xml:166 +#: reference_accessor.xml:669 reference_accessor.xml:813 +#: reference_accessor.xml:1003 reference_accessor.xml:1259 +#: reference_accessor.xml:1563 reference_accessor.xml:1604 +#: reference_accessor.xml:1712 reference_accessor.xml:1987 #, no-c-format msgid "&sfs_compliant;" msgstr "" #. Tag: para -#: reference_accessor.xml:40 reference_accessor.xml:170 -#: reference_accessor.xml:267 reference_accessor.xml:509 -#: reference_accessor.xml:814 reference_accessor.xml:879 -#: reference_accessor.xml:925 reference_accessor.xml:1336 -#: reference_accessor.xml:1374 reference_accessor.xml:1676 -#: reference_accessor.xml:1734 reference_accessor.xml:1777 -#: reference_accessor.xml:1821 reference_accessor.xml:1881 -#: reference_accessor.xml:1992 reference_accessor.xml:2037 -#: reference_accessor.xml:2125 reference_accessor.xml:2170 -#: reference_accessor.xml:2258 reference_accessor.xml:2300 -#: reference_accessor.xml:2345 +#: reference_accessor.xml:39 reference_accessor.xml:168 +#: reference_accessor.xml:273 reference_accessor.xml:328 +#: reference_accessor.xml:434 reference_accessor.xml:672 +#: reference_accessor.xml:766 reference_accessor.xml:1012 +#: reference_accessor.xml:1074 reference_accessor.xml:1120 +#: reference_accessor.xml:1308 reference_accessor.xml:1380 +#: reference_accessor.xml:1418 reference_accessor.xml:1715 +#: reference_accessor.xml:1773 reference_accessor.xml:1819 +#: reference_accessor.xml:1878 reference_accessor.xml:2075 #, no-c-format msgid "&curve_support;" msgstr "" #. Tag: para -#: reference_accessor.xml:41 reference_accessor.xml:96 -#: reference_accessor.xml:171 reference_accessor.xml:265 -#: reference_accessor.xml:399 reference_accessor.xml:450 -#: reference_accessor.xml:508 reference_accessor.xml:557 -#: reference_accessor.xml:615 reference_accessor.xml:696 -#: reference_accessor.xml:766 reference_accessor.xml:813 -#: reference_accessor.xml:878 reference_accessor.xml:1023 -#: reference_accessor.xml:1260 reference_accessor.xml:1300 -#: reference_accessor.xml:1335 reference_accessor.xml:1373 -#: reference_accessor.xml:1418 reference_accessor.xml:1520 -#: reference_accessor.xml:1616 reference_accessor.xml:1675 -#: reference_accessor.xml:1735 reference_accessor.xml:1819 -#: reference_accessor.xml:1947 reference_accessor.xml:1991 -#: reference_accessor.xml:2036 reference_accessor.xml:2080 -#: reference_accessor.xml:2124 reference_accessor.xml:2169 -#: reference_accessor.xml:2214 reference_accessor.xml:2257 -#: reference_accessor.xml:2299 reference_accessor.xml:2344 +#: reference_accessor.xml:40 reference_accessor.xml:94 +#: reference_accessor.xml:169 reference_accessor.xml:276 +#: reference_accessor.xml:331 reference_accessor.xml:389 +#: reference_accessor.xml:432 reference_accessor.xml:565 +#: reference_accessor.xml:615 reference_accessor.xml:671 +#: reference_accessor.xml:720 reference_accessor.xml:765 +#: reference_accessor.xml:815 reference_accessor.xml:895 +#: reference_accessor.xml:964 reference_accessor.xml:1011 +#: reference_accessor.xml:1073 reference_accessor.xml:1216 +#: reference_accessor.xml:1261 reference_accessor.xml:1307 +#: reference_accessor.xml:1344 reference_accessor.xml:1379 +#: reference_accessor.xml:1417 reference_accessor.xml:1461 +#: reference_accessor.xml:1562 reference_accessor.xml:1656 +#: reference_accessor.xml:1714 reference_accessor.xml:1774 +#: reference_accessor.xml:1817 reference_accessor.xml:1944 +#: reference_accessor.xml:1989 reference_accessor.xml:2034 +#: reference_accessor.xml:2074 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: para -#: reference_accessor.xml:42 reference_accessor.xml:172 -#: reference_accessor.xml:223 reference_accessor.xml:510 -#: reference_accessor.xml:558 reference_accessor.xml:817 -#: reference_accessor.xml:1337 reference_accessor.xml:1419 -#: reference_accessor.xml:1523 reference_accessor.xml:1617 -#: reference_accessor.xml:1884 +#: reference_accessor.xml:41 reference_accessor.xml:170 +#: reference_accessor.xml:220 reference_accessor.xml:274 +#: reference_accessor.xml:329 reference_accessor.xml:673 +#: reference_accessor.xml:721 reference_accessor.xml:1015 +#: reference_accessor.xml:1309 reference_accessor.xml:1381 +#: reference_accessor.xml:1462 reference_accessor.xml:1565 +#: reference_accessor.xml:1657 reference_accessor.xml:1881 #, no-c-format msgid "&P_support;" msgstr "" #. Tag: para -#: reference_accessor.xml:43 reference_accessor.xml:173 -#: reference_accessor.xml:224 reference_accessor.xml:511 -#: reference_accessor.xml:1420 reference_accessor.xml:1887 +#: reference_accessor.xml:42 reference_accessor.xml:171 +#: reference_accessor.xml:221 reference_accessor.xml:275 +#: reference_accessor.xml:330 reference_accessor.xml:674 +#: reference_accessor.xml:1310 reference_accessor.xml:1463 +#: reference_accessor.xml:1884 #, no-c-format msgid "&T_support;" msgstr "" #. Tag: title -#: reference_accessor.xml:49 reference_accessor.xml:101 -#: reference_accessor.xml:178 reference_accessor.xml:228 -#: reference_accessor.xml:277 reference_accessor.xml:331 -#: reference_accessor.xml:404 reference_accessor.xml:455 -#: reference_accessor.xml:563 reference_accessor.xml:621 -#: reference_accessor.xml:884 reference_accessor.xml:932 -#: reference_accessor.xml:977 reference_accessor.xml:1028 -#: reference_accessor.xml:1099 reference_accessor.xml:1155 -#: reference_accessor.xml:1215 reference_accessor.xml:1266 -#: reference_accessor.xml:1304 reference_accessor.xml:1342 -#: reference_accessor.xml:1379 reference_accessor.xml:1425 -#: reference_accessor.xml:1464 reference_accessor.xml:1527 -#: reference_accessor.xml:1568 reference_accessor.xml:1623 -#: reference_accessor.xml:1688 reference_accessor.xml:1742 -#: reference_accessor.xml:1782 reference_accessor.xml:1831 -#: reference_accessor.xml:1895 reference_accessor.xml:1953 -#: reference_accessor.xml:1997 reference_accessor.xml:2042 -#: reference_accessor.xml:2086 reference_accessor.xml:2130 -#: reference_accessor.xml:2175 reference_accessor.xml:2219 -#: reference_accessor.xml:2263 reference_accessor.xml:2305 -#: reference_accessor.xml:2350 +#: reference_accessor.xml:48 reference_accessor.xml:99 +#: reference_accessor.xml:176 reference_accessor.xml:225 +#: reference_accessor.xml:394 reference_accessor.xml:444 +#: reference_accessor.xml:497 reference_accessor.xml:570 +#: reference_accessor.xml:620 reference_accessor.xml:726 +#: reference_accessor.xml:771 reference_accessor.xml:821 +#: reference_accessor.xml:1079 reference_accessor.xml:1127 +#: reference_accessor.xml:1171 reference_accessor.xml:1221 +#: reference_accessor.xml:1267 reference_accessor.xml:1316 +#: reference_accessor.xml:1348 reference_accessor.xml:1386 +#: reference_accessor.xml:1423 reference_accessor.xml:1468 +#: reference_accessor.xml:1507 reference_accessor.xml:1569 +#: reference_accessor.xml:1609 reference_accessor.xml:1663 +#: reference_accessor.xml:1727 reference_accessor.xml:1781 +#: reference_accessor.xml:1829 reference_accessor.xml:1892 +#: reference_accessor.xml:1950 reference_accessor.xml:1995 +#: reference_accessor.xml:2039 reference_accessor.xml:2080 #, no-c-format msgid "Examples" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:51 +#: reference_accessor.xml:50 #, no-c-format msgid "" "SELECT GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 " @@ -210,7 +202,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:52 +#: reference_accessor.xml:51 #, no-c-format msgid "" "SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 " @@ -225,7 +217,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:53 +#: reference_accessor.xml:52 #, no-c-format msgid "" "SELECT GeometryType(geom) as result\n" @@ -250,47 +242,44 @@ msgid "" msgstr "" #. Tag: title -#: reference_accessor.xml:58 reference_accessor.xml:139 -#: reference_accessor.xml:185 reference_accessor.xml:233 -#: reference_accessor.xml:283 reference_accessor.xml:345 -#: reference_accessor.xml:409 reference_accessor.xml:460 -#: reference_accessor.xml:530 reference_accessor.xml:574 -#: reference_accessor.xml:628 reference_accessor.xml:702 -#: reference_accessor.xml:771 reference_accessor.xml:834 -#: reference_accessor.xml:890 reference_accessor.xml:983 -#: reference_accessor.xml:1034 reference_accessor.xml:1105 -#: reference_accessor.xml:1162 reference_accessor.xml:1222 -#: reference_accessor.xml:1272 reference_accessor.xml:1309 -#: reference_accessor.xml:1347 reference_accessor.xml:1386 -#: reference_accessor.xml:1430 reference_accessor.xml:1469 -#: reference_accessor.xml:1492 reference_accessor.xml:1532 -#: reference_accessor.xml:1573 reference_accessor.xml:1630 -#: reference_accessor.xml:1694 reference_accessor.xml:1748 -#: reference_accessor.xml:1787 reference_accessor.xml:1837 -#: reference_accessor.xml:1901 reference_accessor.xml:1959 -#: reference_accessor.xml:2004 reference_accessor.xml:2049 -#: reference_accessor.xml:2092 reference_accessor.xml:2137 -#: reference_accessor.xml:2182 reference_accessor.xml:2225 -#: reference_accessor.xml:2270 reference_accessor.xml:2312 -#: reference_accessor.xml:2357 +#: reference_accessor.xml:57 reference_accessor.xml:137 +#: reference_accessor.xml:183 reference_accessor.xml:230 +#: reference_accessor.xml:289 reference_accessor.xml:357 +#: reference_accessor.xml:401 reference_accessor.xml:450 +#: reference_accessor.xml:511 reference_accessor.xml:575 +#: reference_accessor.xml:625 reference_accessor.xml:693 +#: reference_accessor.xml:737 reference_accessor.xml:778 +#: reference_accessor.xml:828 reference_accessor.xml:901 +#: reference_accessor.xml:969 reference_accessor.xml:1032 +#: reference_accessor.xml:1085 reference_accessor.xml:1177 +#: reference_accessor.xml:1227 reference_accessor.xml:1273 +#: reference_accessor.xml:1353 reference_accessor.xml:1391 +#: reference_accessor.xml:1430 reference_accessor.xml:1473 +#: reference_accessor.xml:1512 reference_accessor.xml:1534 +#: reference_accessor.xml:1574 reference_accessor.xml:1614 +#: reference_accessor.xml:1670 reference_accessor.xml:1733 +#: reference_accessor.xml:1787 reference_accessor.xml:1835 +#: reference_accessor.xml:1898 reference_accessor.xml:1956 +#: reference_accessor.xml:2001 reference_accessor.xml:2045 +#: reference_accessor.xml:2087 #, no-c-format msgid "See Also" msgstr "" #. Tag: refname -#: reference_accessor.xml:64 +#: reference_accessor.xml:63 #, no-c-format msgid "ST_Boundary" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:66 +#: reference_accessor.xml:65 #, no-c-format -msgid "Returns the closure of the combinatorial boundary of this Geometry." +msgid "Returns the boundary of a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:72 +#: reference_accessor.xml:70 #, no-c-format msgid "" "geometry ST_Boundary " @@ -298,7 +287,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:83 +#: reference_accessor.xml:81 #, no-c-format msgid "" "Returns the closure of the combinatorial boundary of this Geometry. The " @@ -310,13 +299,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:90 +#: reference_accessor.xml:88 #, no-c-format msgid "Performed by the GEOS module" msgstr "" #. Tag: para -#: reference_accessor.xml:92 +#: reference_accessor.xml:90 #, no-c-format msgid "" "Prior to 2.0.0, this function throws an exception if used with " @@ -325,31 +314,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:94 +#: reference_accessor.xml:92 #, no-c-format msgid "&sfs_compliant; OGC SPEC s2.1.1.1" msgstr "" #. Tag: para -#: reference_accessor.xml:95 +#: reference_accessor.xml:93 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.14" msgstr "" #. Tag: para -#: reference_accessor.xml:97 +#: reference_accessor.xml:95 #, no-c-format msgid "Enhanced: 2.1.0 support for Triangle was introduced" msgstr "" #. Tag: para -#: reference_accessor.xml:112 +#: reference_accessor.xml:110 #, no-c-format msgid "Linestring with boundary points overlaid" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:115 +#: reference_accessor.xml:113 #, no-c-format msgid "" "SELECT ST_Boundary(geom)\n" @@ -358,7 +347,7 @@ msgid "" msgstr "" #. Tag: screen -#: reference_accessor.xml:116 +#: reference_accessor.xml:114 #, no-c-format msgid "" "-- ST_AsText output\n" @@ -366,13 +355,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:124 +#: reference_accessor.xml:122 #, no-c-format msgid "polygon holes with boundary multilinestring" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:127 +#: reference_accessor.xml:125 #, no-c-format msgid "" "SELECT ST_Boundary(geom)\n" @@ -384,7 +373,7 @@ msgid "" msgstr "" #. Tag: screen -#: reference_accessor.xml:128 +#: reference_accessor.xml:126 #, no-c-format msgid "" "-- ST_AsText output\n" @@ -393,7 +382,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:136 +#: reference_accessor.xml:134 #, no-c-format msgid "" "SELECT ST_AsText(ST_Boundary(ST_GeomFromText('LINESTRING(1 1,0 0, -1 " @@ -426,28 +415,26 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:141 +#: reference_accessor.xml:139 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_accessor.xml:147 +#: reference_accessor.xml:145 #, no-c-format msgid "ST_CoordDim" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:149 +#: reference_accessor.xml:147 #, no-c-format -msgid "" -"Return the coordinate dimension of the ST_Geometry value." +msgid "Return the coordinate dimension of a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:154 +#: reference_accessor.xml:152 #, no-c-format msgid "" "integer ST_CoordDim " @@ -455,25 +442,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:164 +#: reference_accessor.xml:162 #, no-c-format -msgid "Return the coordinate dimension of the ST_Geometry value." +msgid "Return the coordinate dimension of the ST_Geometry value." msgstr "" #. Tag: para -#: reference_accessor.xml:166 +#: reference_accessor.xml:164 #, no-c-format msgid "This is the MM compliant alias name for " msgstr "" #. Tag: para -#: reference_accessor.xml:169 +#: reference_accessor.xml:167 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.3" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:180 +#: reference_accessor.xml:178 #, no-c-format msgid "" "SELECT ST_CoordDim('CIRCULARSTRING(1 2 3, 1 3 4, 5 6 7, 8 9 10, 11 12 " @@ -487,21 +474,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:193 +#: reference_accessor.xml:191 #, no-c-format msgid "ST_Dimension" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:195 +#: reference_accessor.xml:193 #, no-c-format -msgid "" -"The inherent dimension of this Geometry object, which must be less than or " -"equal to the coordinate dimension." +msgid "Returns the topological dimension of a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:201 +#: reference_accessor.xml:198 #, no-c-format msgid "" "integer ST_Dimension " @@ -509,25 +494,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:212 +#: reference_accessor.xml:209 #, 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 " +"Return the topological 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 " "POINT, 1 for LINESTRING, 2 for " "POLYGON, and the largest dimension of the components of a " -"GEOMETRYCOLLECTION. If the dimension is unknown (empty " -"GEOMETRYCOLLECTION) 0 is returned." +"GEOMETRYCOLLECTION. If the dimension is unknown (e.g. for " +"an empty GEOMETRYCOLLECTION) 0 is returned." msgstr "" #. Tag: para -#: reference_accessor.xml:220 +#: reference_accessor.xml:217 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.2" msgstr "" #. Tag: para -#: reference_accessor.xml:221 +#: reference_accessor.xml:218 #, no-c-format msgid "" "Enhanced: 2.0.0 support for Polyhedral surfaces and TINs was introduced. No " @@ -535,7 +520,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:222 +#: reference_accessor.xml:219 #, no-c-format msgid "" "Prior to 2.0.0, this function throws an exception if used with empty " @@ -543,7 +528,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:230 +#: reference_accessor.xml:227 #, no-c-format msgid "" "SELECT ST_Dimension('GEOMETRYCOLLECTION(LINESTRING(1 1,0 0),POINT(0 0))');\n" @@ -553,361 +538,879 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:241 +#: reference_accessor.xml:238 #, no-c-format -msgid "ST_EndPoint" +msgid "ST_Dump" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:243 +#: reference_accessor.xml:239 #, no-c-format msgid "" -"Returns the last point of a LINESTRING or " -"CIRCULARLINESTRING geometry as a POINT." +"Returns a set of geometry_dump rows for the components of " +"a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:249 +#: reference_accessor.xml:244 #, no-c-format msgid "" -"boolean ST_EndPoint " -"geometry g" +"geometry_dump[] ST_Dump " +"geometry g1" msgstr "" #. Tag: para -#: reference_accessor.xml:260 +#: reference_accessor.xml:253 #, no-c-format msgid "" -"Returns the last point of a LINESTRING geometry as a " -"POINT or NULL if the input parameter " -"is not a LINESTRING." +"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_accessor.xml:264 +#: reference_accessor.xml:262 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 7.1.4" +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_accessor.xml:267 +#, no-c-format +msgid "Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher." msgstr "" #. Tag: para -#: reference_accessor.xml:268 reference_accessor.xml:1822 +#: reference_accessor.xml:269 reference_accessor.xml:1378 #, 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." +"Prior to 1.3.4, this function crashes if used with geometries that contain " +"CURVES. This is fixed in 1.3.4+" +msgstr "" + +#. Tag: title +#: reference_accessor.xml:280 reference_accessor.xml:680 +#, no-c-format +msgid "Standard Examples" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:279 +#: reference_accessor.xml:281 #, 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" +"SELECT sometable.field1, sometable.field1,\n" +" (ST_Dump(sometable.the_geom)).geom AS the_geom\n" +"FROM sometable;\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)" +"-- 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_accessor.xml:283 reference_accessor.xml:351 +#: reference_accessor.xml:685 +#, no-c-format +msgid "Polyhedral Surfaces, TIN and Triangle Examples" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:284 +#, 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_accessor.xml:286 +#, 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_accessor.xml:285 +#: reference_accessor.xml:290 #, no-c-format -msgid ", " +msgid "" +", , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:292 +#: reference_accessor.xml:296 #, no-c-format -msgid "ST_Envelope" +msgid "ST_DumpPoints" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:294 +#: reference_accessor.xml:297 #, no-c-format msgid "" -"Returns a geometry representing the double precision (float8) bounding box " -"of the supplied geometry." +"Returns a set of geometry_dump rows for the points in a " +"geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:300 +#: reference_accessor.xml:302 #, no-c-format msgid "" -"geometry ST_Envelope " -"geometry g1" +"geometry_dump[]ST_DumpPoints " +"geometry geom" msgstr "" #. Tag: para #: reference_accessor.xml:311 #, 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 " -"((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), " -"(MINX, MINY)). (PostGIS will add a " -"ZMIN/ZMAX coordinate as well)." +"This set-returning function (SRF) returns a set of geometry_dump rows formed by a geometry (geom) and an array of " +"integers (path)." msgstr "" #. Tag: para -#: reference_accessor.xml:321 +#: reference_accessor.xml:314 #, no-c-format msgid "" -"Degenerate cases (vertical lines, points) will return a geometry of lower " -"dimension than POLYGON, ie. POINT or " -"LINESTRING." +"The geom component of geometry_dump are all the POINTs that make up the supplied " +"geometry" msgstr "" #. Tag: para -#: reference_accessor.xml:325 +#: reference_accessor.xml:317 #, no-c-format msgid "" -"Availability: 1.5.0 behavior changed to output double precision instead of " -"float4" +"The path component of geometry_dump (an integer[]) is an index reference enumerating " +"the POINTs of the supplied geometry. For example, if a " +"LINESTRING is supplied, a path of {i} " +"is returned where i is the nth " +"coordinate in the LINESTRING. If a POLYGON is supplied, a path of {i,j} is returned where " +"i is the ring number (1 is outer; inner rings follow) and " +"j enumerates the POINTs (again 1-based " +"index)." msgstr "" #. Tag: para -#: reference_accessor.xml:326 reference_accessor.xml:923 -#: reference_accessor.xml:1021 reference_accessor.xml:1775 +#: reference_accessor.xml:325 #, no-c-format -msgid "&sfs_compliant; s2.1.1.1" +msgid "Enhanced: 2.1.0 Faster speed. Reimplemented as native-C." msgstr "" #. Tag: para #: reference_accessor.xml:327 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.15" +msgid "Availability: 1.5.0" msgstr "" -#. Tag: programlisting -#: reference_accessor.xml:333 +#. Tag: title +#: reference_accessor.xml:334 #, 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" -"" +msgid "Classic Explode a Table of LineStrings into nodes" msgstr "" -#. Tag: para -#: reference_accessor.xml:339 +#. Tag: programlisting +#: reference_accessor.xml:335 +#, 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_accessor.xml:338 #, no-c-format -msgid "Envelope of a point and linestring." +msgid "Standard Geometry Examples" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:342 +#: reference_accessor.xml:348 #, no-c-format msgid "" -"SELECT ST_AsText(ST_Envelope(\n" -" ST_Collect(\n" -" ST_GeomFromText('LINESTRING(55 75,125 150)'),\n" -" ST_Point(20, 80))\n" -" )) As wktenv;\n" -"wktenv\n" -"-----------\n" -"POLYGON((20 75,20 150,125 150,125 75,20 75))" +"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: para -#: reference_accessor.xml:347 +#. Tag: programlisting +#: reference_accessor.xml:352 #, no-c-format -msgid ", , " +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: refname +#. Tag: programlisting #: reference_accessor.xml:353 #, no-c-format -msgid "ST_BoundingDiagonal" +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: refpurpose -#: reference_accessor.xml:355 +#. Tag: programlisting +#: reference_accessor.xml:354 #, no-c-format -msgid "Returns the diagonal of the supplied geometry's bounding box." +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: funcprototype -#: reference_accessor.xml:360 +#. Tag: para +#: reference_accessor.xml:358 #, no-c-format msgid "" -"geometry ST_BoundingDiagonal " -"geometry geom " -"boolean fits=false" +", , , " msgstr "" -#. Tag: para -#: reference_accessor.xml:372 +#. Tag: refname +#: reference_accessor.xml:363 #, no-c-format -msgid "" -"Returns the diagonal of the supplied geometry's bounding box as linestring. " -"If the input geometry is empty, the diagonal line is also empty, otherwise " -"it is a 2-points linestring with minimum values of each dimension in its " -"start point and maximum values in its end point." +msgid "ST_DumpRings" msgstr "" -#. Tag: para -#: reference_accessor.xml:379 +#. Tag: refpurpose +#: reference_accessor.xml:365 #, no-c-format msgid "" -"The returned linestring geometry always retains SRID and dimensionality (Z " -"and M presence) of the input geometry." +"Returns a set of geometry_dump rows for the exterior and " +"interior rings of a Polygon." msgstr "" -#. Tag: para -#: reference_accessor.xml:384 +#. Tag: funcprototype +#: reference_accessor.xml:371 #, no-c-format msgid "" -"The fits parameter specifies if the best fit is needed. " -"If false, the diagonal of a somewhat larger bounding box can be accepted (is " -"faster to obtain for geometries with a lot of vertices). In any case the " -"bounding box of the returned diagonal line always covers the input geometry." +"geometry_dump[] ST_DumpRings " +"geometry a_polygon" msgstr "" #. Tag: para -#: reference_accessor.xml:392 +#: reference_accessor.xml:381 #, no-c-format msgid "" -"In degenerate cases (a single vertex in input) the returned linestring will " -"be topologically invalid (no interior). This does not make the return " -"semantically invalid." +"This is a set-returning function (SRF). It returns a set of " +"geometry_dump rows, defined as an integer[] and a geometry, 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_accessor.xml:398 +#: reference_accessor.xml:387 #, no-c-format -msgid "Availability: 2.2.0" +msgid "Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher." msgstr "" #. Tag: para -#: reference_accessor.xml:400 reference_accessor.xml:697 -#: reference_accessor.xml:767 +#: reference_accessor.xml:388 #, no-c-format -msgid "&M_support;" +msgid "" +"This only works for POLYGON geometries. It will not work for MULTIPOLYGONS" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:406 +#: reference_accessor.xml:396 #, no-c-format msgid "" -"-- Get the minimum X in a buffer around a point\n" -"SELECT ST_X(ST_StartPoint(ST_BoundingDiagonal(\n" -" ST_Buffer(ST_MakePoint(0,0),10)\n" -")));\n" -" st_x\n" -"------\n" -" -10" +"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_accessor.xml:410 +#: reference_accessor.xml:403 #, no-c-format msgid "" -", , , , , , " +", , , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:424 +#: reference_accessor.xml:409 #, no-c-format -msgid "ST_ExteriorRing" +msgid "ST_EndPoint" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:426 +#: reference_accessor.xml:411 #, no-c-format -msgid "" -"Returns a line string representing the exterior ring of the " -"POLYGON geometry. Return NULL if the geometry is not a " -"polygon. Will not work with MULTIPOLYGON" +msgid "Returns the last point of a LineString or CircularLineString." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:432 +#: reference_accessor.xml:416 #, no-c-format msgid "" -"geometry ST_ExteriorRing " -"geometry a_polygon" +"geometry ST_EndPoint " +"geometry g" msgstr "" #. Tag: para -#: reference_accessor.xml:443 +#: reference_accessor.xml:427 #, no-c-format msgid "" -"Returns a line string representing the exterior ring of the " -"POLYGON geometry. Return NULL if the geometry is not a " -"polygon." +"Returns the last point of a LINESTRING as a POINT. Returns NULL if the input is not a LINESTRING." msgstr "" #. Tag: para -#: reference_accessor.xml:446 +#: reference_accessor.xml:431 #, no-c-format -msgid "Only works with POLYGON geometry types" +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.4" msgstr "" #. Tag: para -#: reference_accessor.xml:448 reference_accessor.xml:967 +#: reference_accessor.xml:435 reference_accessor.xml:1820 #, no-c-format -msgid "&sfs_compliant; 2.1.5.1" -msgstr "" +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:446 +#, 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:449 +#: reference_accessor.xml:452 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:459 +#, no-c-format +msgid "ST_Envelope" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:461 +#, no-c-format +msgid "Returns a geometry representing the bounding box of a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:466 +#, no-c-format +msgid "" +"geometry ST_Envelope " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:477 +#, no-c-format +msgid "" +"Returns the double-precision (float8) minimum bounding box for the supplied " +"geometry, as a geometry. The polygon is defined by the corner points of the " +"bounding box ((MINX, MINY), " +"(MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), (MINX, MINY)). (PostGIS " +"will add a ZMIN/ZMAX coordinate as " +"well)." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:487 +#, no-c-format +msgid "" +"Degenerate cases (vertical lines, points) will return a geometry of lower " +"dimension than POLYGON, ie. POINT or " +"LINESTRING." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:491 +#, no-c-format +msgid "" +"Availability: 1.5.0 behavior changed to output double precision instead of " +"float4" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:492 reference_accessor.xml:1118 +#: reference_accessor.xml:1214 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:493 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.15" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:499 +#, 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" +"" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:505 +#, no-c-format +msgid "Envelope of a point and linestring." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:508 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Envelope(\n" +" ST_Collect(\n" +" ST_GeomFromText('LINESTRING(55 75,125 150)'),\n" +" ST_Point(20, 80))\n" +" )) As wktenv;\n" +"wktenv\n" +"-----------\n" +"POLYGON((20 75,20 150,125 150,125 75,20 75))" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:513 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:519 +#, no-c-format +msgid "ST_BoundingDiagonal" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:521 +#, no-c-format +msgid "Returns the diagonal of a geometry's bounding box." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:526 +#, no-c-format +msgid "" +"geometry ST_BoundingDiagonal " +"geometry geom " +"boolean fits=false" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:538 +#, no-c-format +msgid "" +"Returns the diagonal of the supplied geometry's bounding box as a " +"LineString. If the input geometry is empty, the diagonal line is also empty, " +"otherwise it is a 2-point LineString with the minimum values of each " +"dimension in its start point and the maximum values in its end point." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:545 +#, no-c-format +msgid "" +"The returned linestring geometry always retains SRID and dimensionality (Z " +"and M presence) of the input geometry." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:550 +#, no-c-format +msgid "" +"The fits parameter specifies if the best fit is needed. " +"If false, the diagonal of a somewhat larger bounding box can be accepted (is " +"faster to obtain for geometries with a lot of vertices). In any case the " +"bounding box of the returned diagonal line always covers the input geometry." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:558 +#, no-c-format +msgid "" +"In degenerate cases (a single vertex in input) the returned linestring will " +"be topologically invalid (no interior). This does not make the return " +"semantically invalid." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:564 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:566 reference_accessor.xml:896 +#: reference_accessor.xml:965 +#, no-c-format +msgid "&M_support;" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:572 +#, no-c-format +msgid "" +"-- Get the minimum X in a buffer around a point\n" +"SELECT ST_X(ST_StartPoint(ST_BoundingDiagonal(\n" +" ST_Buffer(ST_MakePoint(0,0),10)\n" +")));\n" +" st_x\n" +"------\n" +" -10" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:576 +#, no-c-format +msgid "" +", , , , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:590 +#, no-c-format +msgid "ST_ExteriorRing" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:592 +#, no-c-format +msgid "Returns a LineString representing the exterior ring of a Polygon." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:597 +#, no-c-format +msgid "" +"geometry ST_ExteriorRing " +"geometry a_polygon" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:608 +#, no-c-format +msgid "" +"Returns a line string representing the exterior ring of the " +"POLYGON geometry. Return NULL if the geometry is not a " +"polygon." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:611 +#, no-c-format +msgid "Only works with POLYGON geometry types" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:613 reference_accessor.xml:1161 +#, no-c-format +msgid "&sfs_compliant; 2.1.5.1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:614 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.2.3, 8.3.3" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:456 +#: reference_accessor.xml:621 #, no-c-format msgid "" "--If you have a table of polygons\n" @@ -935,29 +1438,26 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:462 +#: reference_accessor.xml:627 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_accessor.xml:472 +#: reference_accessor.xml:637 #, no-c-format msgid "ST_GeometryN" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:474 +#: reference_accessor.xml:639 #, 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." +msgid "Return the Nth geometry element of a geometry collection." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:481 +#: reference_accessor.xml:644 #, no-c-format msgid "" "geometry ST_GeometryN " @@ -966,7 +1466,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:492 +#: reference_accessor.xml:655 #, no-c-format msgid "" "Return the 1-based Nth geometry if the geometry is a GEOMETRYCOLLECTION, " @@ -975,7 +1475,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:497 +#: reference_accessor.xml:660 #, no-c-format msgid "" "Index is 1-based as for OGC specs since version 0.8.0. Previous versions " @@ -983,15 +1483,15 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:502 +#: reference_accessor.xml:665 #, 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." +"If you want to extract all geometries, of a geometry, is more efficient, and also works for singular geoms." msgstr "" #. Tag: para -#: reference_accessor.xml:505 +#: reference_accessor.xml:668 #, no-c-format msgid "" "Changed: 2.0.0 Prior versions would return NULL for singular geometries. " @@ -999,19 +1499,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:507 +#: reference_accessor.xml:670 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 9.1.5" msgstr "" -#. Tag: title -#: reference_accessor.xml:517 -#, no-c-format -msgid "Standard Examples" -msgstr "" - #. Tag: programlisting -#: reference_accessor.xml:519 +#: reference_accessor.xml:682 #, no-c-format msgid "" "--Extracting a subset of points from a 3d multipoint\n" @@ -1040,14 +1534,8 @@ msgid "" "WHERE n <= ST_NumGeometries(the_geom);" msgstr "" -#. Tag: title -#: reference_accessor.xml:522 -#, no-c-format -msgid "Polyhedral Surfaces, TIN and Triangle Examples" -msgstr "" - #. Tag: programlisting -#: reference_accessor.xml:523 +#: reference_accessor.xml:686 #, no-c-format msgid "" "-- Polyhedral surface example\n" @@ -1068,7 +1556,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:525 +#: reference_accessor.xml:688 #, no-c-format msgid "" "-- TIN --\n" @@ -1095,25 +1583,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:532 reference_accessor.xml:1534 +#: reference_accessor.xml:695 reference_accessor.xml:1576 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:538 +#: reference_accessor.xml:701 #, no-c-format msgid "ST_GeometryType" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:539 +#: reference_accessor.xml:702 #, no-c-format -msgid "Return the geometry type of the ST_Geometry value." +msgid "Returns the SQL-MM type of a geometry as text." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:544 +#: reference_accessor.xml:707 #, no-c-format msgid "" "text ST_GeometryType " @@ -1121,7 +1609,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:553 +#: reference_accessor.xml:716 #, no-c-format msgid "" "Returns the type of the geometry as a string. EG: 'ST_Linestring', " @@ -1132,20 +1620,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:555 reference_accessor.xml:815 -#: reference_accessor.xml:1333 +#: reference_accessor.xml:718 reference_accessor.xml:1013 +#: reference_accessor.xml:1377 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." msgstr "" #. Tag: para -#: reference_accessor.xml:556 +#: reference_accessor.xml:719 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:565 +#: reference_accessor.xml:728 #, no-c-format msgid "" "SELECT ST_GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 " @@ -1155,7 +1643,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:567 reference_accessor.xml:569 +#: reference_accessor.xml:730 reference_accessor.xml:732 #, no-c-format msgid "" "SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 " @@ -1170,46 +1658,94 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:571 +#: reference_accessor.xml:734 +#, 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:745 +#, no-c-format +msgid "ST_HasArc" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:747 +#, no-c-format +msgid "Tests if a geometry contains a circular arc" +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:752 +#, no-c-format +msgid "" +"boolean ST_HasArc " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:762 +#, no-c-format +msgid "" +"Returns true if a geometry or geometry collection contains a circular string" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:764 +#, no-c-format +msgid "Availability: 1.2.3?" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:773 +#, 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_accessor.xml:780 #, 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" +msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:584 +#: reference_accessor.xml:786 #, no-c-format msgid "ST_InteriorRingN" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:586 +#: reference_accessor.xml:788 #, 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." +msgid "Returns the Nth interior ring (hole) of a Polygon." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:593 +#: reference_accessor.xml:793 #, no-c-format msgid "" "geometry ST_InteriorRingN " @@ -1218,30 +1754,30 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:604 +#: reference_accessor.xml:804 #, 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." +"Returns the Nth interior linestring ring of the polygon geometry. Returns " +"NULL if the geometry is not a polygon or the given N is out of range. The " +"index starts at 1." msgstr "" #. Tag: para -#: reference_accessor.xml:610 +#: reference_accessor.xml:810 #, no-c-format msgid "" -"This will not work for MULTIPOLYGONs. Use in conjunction with ST_Dump for " -"MULTIPOLYGONS" +"This function does not support for MULTIPOLYGONs. Use in conjunction with " +" for MULTIPOLYGONS" msgstr "" #. Tag: para -#: reference_accessor.xml:614 +#: reference_accessor.xml:814 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.2.6, 8.3.5" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:623 +#: reference_accessor.xml:823 #, no-c-format msgid "" "SELECT ST_AsText(ST_InteriorRingN(the_geom, 1)) As the_geom\n" @@ -1252,7 +1788,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:630 +#: reference_accessor.xml:830 #, no-c-format msgid "" ", , , boolean ST_IsPolygonCCW " @@ -1282,7 +1818,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:669 +#: reference_accessor.xml:868 #, no-c-format msgid "" "Returns true if all polygonal components of the input geometry use a counter-" @@ -1291,13 +1827,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:675 reference_accessor.xml:745 +#: reference_accessor.xml:874 reference_accessor.xml:943 #, no-c-format msgid "Returns true if the geometry has no polygonal components." msgstr "" #. Tag: para -#: reference_accessor.xml:680 reference_accessor.xml:750 +#: reference_accessor.xml:879 reference_accessor.xml:948 #, no-c-format msgid "" "Closed linestrings are not considered polygonal components, so you would " @@ -1306,7 +1842,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:688 reference_accessor.xml:758 +#: reference_accessor.xml:887 reference_accessor.xml:956 #, no-c-format msgid "" "If a polygonal geometry does not use reversed orientation for interior rings " @@ -1316,28 +1852,28 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:703 reference_accessor.xml:772 +#: reference_accessor.xml:902 reference_accessor.xml:970 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_accessor.xml:713 +#: reference_accessor.xml:912 #, no-c-format msgid "ST_IsPolygonCW" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:716 +#: reference_accessor.xml:915 #, no-c-format msgid "" -"Returns true if all exterior rings are oriented clockwise and all interior " -"rings are oriented counter-clockwise." +"Tests if Polygons have exterior rings oriented clockwise and interior rings " +"oriented counter-clockwise." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:723 +#: reference_accessor.xml:921 #, no-c-format msgid "" " boolean ST_IsPolygonCW " @@ -1345,7 +1881,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:739 +#: reference_accessor.xml:937 #, no-c-format msgid "" "Returns true if all polygonal components of the input geometry use a " @@ -1354,21 +1890,21 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:782 +#: reference_accessor.xml:980 #, no-c-format msgid "ST_IsClosed" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:784 +#: reference_accessor.xml:982 #, no-c-format msgid "" -"Returns TRUE if the LINESTRING's start " -"and end points are coincident. For Polyhedral surface is closed (volumetric)." +"Tests if a LineStrings's start and end points are coincident. For a " +"PolyhedralSurface tests if it is closed (volumetric)." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:791 +#: reference_accessor.xml:988 #, no-c-format msgid "" "boolean ST_IsClosed " @@ -1376,22 +1912,22 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:802 +#: reference_accessor.xml:999 #, no-c-format msgid "" "Returns TRUE if the LINESTRING's start " -"and end points are coincident. For Polyhedral Surfaces, it tells you if the " +"and end points are coincident. For Polyhedral Surfaces, reports if the " "surface is areal (open) or volumetric (closed)." msgstr "" #. Tag: para -#: reference_accessor.xml:806 +#: reference_accessor.xml:1004 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.5, 9.3.3" msgstr "" #. Tag: para -#: reference_accessor.xml:808 +#: reference_accessor.xml:1006 #, no-c-format msgid "" "SQL-MM defines the result of ST_IsClosed(NULL)TRUE if the argument is a collection " -"(MULTI*, GEOMETRYCOLLECTION, ...)" +msgid "Tests if a geometry is a geometry collection type." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:851 +#: reference_accessor.xml:1046 #, no-c-format msgid "" "boolean ST_IsCollection " @@ -1500,33 +2034,33 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:861 +#: reference_accessor.xml:1056 #, no-c-format msgid "" -"Returns TRUE if the geometry type of the argument is " -"either:" +"Returns TRUE if the geometry type of the argument a " +"geometry collection type. Collection types are the following:" msgstr "" #. Tag: para -#: reference_accessor.xml:864 +#: reference_accessor.xml:1059 #, no-c-format msgid "GEOMETRYCOLLECTION" msgstr "" #. Tag: para -#: reference_accessor.xml:865 +#: reference_accessor.xml:1060 #, no-c-format msgid "MULTI{POINT,POLYGON,LINESTRING,CURVE,SURFACE}" msgstr "" #. Tag: para -#: reference_accessor.xml:866 +#: reference_accessor.xml:1061 #, no-c-format msgid "COMPOUNDCURVE" msgstr "" #. Tag: para -#: reference_accessor.xml:871 +#: reference_accessor.xml:1066 #, no-c-format msgid "" "This function analyzes the type of the geometry. This means that it will " @@ -1535,7 +2069,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:886 +#: reference_accessor.xml:1081 #, no-c-format msgid "" "postgis=# SELECT ST_IsCollection('LINESTRING(0 0, 1 1)'::geometry);\n" @@ -1571,21 +2105,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:898 +#: reference_accessor.xml:1093 #, no-c-format msgid "ST_IsEmpty" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:900 +#: reference_accessor.xml:1095 #, no-c-format -msgid "" -"Returns true if this Geometry is an empty geometrycollection, polygon, point " -"etc." +msgid "Tests if a geometry is empty." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:906 +#: reference_accessor.xml:1101 #, no-c-format msgid "" "boolean ST_IsEmpty " @@ -1593,7 +2125,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:916 +#: reference_accessor.xml:1111 #, no-c-format msgid "" "Returns true if this Geometry is an empty geometry. If true, then this " @@ -1601,7 +2133,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:919 +#: reference_accessor.xml:1114 #, no-c-format msgid "" "SQL-MM defines the result of ST_IsEmpty(NULL) to be 0, while PostGIS returns " @@ -1609,13 +2141,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:924 +#: reference_accessor.xml:1119 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.7" msgstr "" #. Tag: para -#: reference_accessor.xml:926 +#: reference_accessor.xml:1121 #, no-c-format msgid "" "Changed: 2.0.0 In prior versions of PostGIS " @@ -1624,7 +2156,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:934 +#: reference_accessor.xml:1129 #, no-c-format msgid "" "SELECT ST_IsEmpty(ST_GeomFromText('GEOMETRYCOLLECTION EMPTY'));\n" @@ -1661,21 +2193,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:941 +#: reference_accessor.xml:1136 #, no-c-format msgid "ST_IsRing" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:943 +#: reference_accessor.xml:1138 #, no-c-format -msgid "" -"Returns TRUE if this LINESTRING is " -"both closed and simple." +msgid "Tests if a LineString is closed and simple." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:949 +#: reference_accessor.xml:1143 #, no-c-format msgid "" "boolean ST_IsRing " @@ -1683,7 +2213,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:960 +#: reference_accessor.xml:1154 #, no-c-format msgid "" "Returns TRUE if this LINESTRING is " @@ -1694,13 +2224,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:968 +#: reference_accessor.xml:1162 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.6" msgstr "" #. Tag: para -#: reference_accessor.xml:970 +#: reference_accessor.xml:1164 #, no-c-format msgid "" "SQL-MM defines the result of ST_IsRing(NULL), , boolean ST_IsSimple " @@ -1759,7 +2288,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1011 +#: reference_accessor.xml:1204 #, no-c-format msgid "" "Returns true if this Geometry has no anomalous geometric points, such as " @@ -1769,7 +2298,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1017 +#: reference_accessor.xml:1210 #, no-c-format msgid "" "SQL-MM defines the result of ST_IsSimple(NULL) to be 0, while PostGIS " @@ -1777,13 +2306,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1022 +#: reference_accessor.xml:1215 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.8" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1030 +#: reference_accessor.xml:1223 #, no-c-format msgid "" "SELECT ST_IsSimple(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));\n" @@ -1801,400 +2330,185 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1042 +#: reference_accessor.xml:1235 #, no-c-format -msgid "ST_IsValid" +msgid "ST_M" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1044 -#, no-c-format -msgid "" -"Returns true if the ST_Geometry is " -"well formed." -msgstr "" - -#. Tag: funcsynopsis -#: reference_accessor.xml:1050 +#: reference_accessor.xml:1237 #, no-c-format -msgid "" -" boolean ST_IsValid " -"geometry g boolean ST_IsValid geometry g integer flags " +msgid "Returns the M coordinate of a Point." msgstr "" -#. Tag: para -#: reference_accessor.xml:1068 +#. Tag: funcprototype +#: reference_accessor.xml:1242 #, 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 \"Ensuring OpenGIS " -"compliancy of geometries\"" +"float ST_M geometry " +" a_point" msgstr "" #. Tag: para -#: reference_accessor.xml:1074 +#: reference_accessor.xml:1252 #, no-c-format msgid "" -"SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns " -"NULL." +"Return the M crdinate of a Point, or NULL if not available. Input must be a " +"Point." msgstr "" #. Tag: para -#: reference_accessor.xml:1078 +#: reference_accessor.xml:1256 #, 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 flags are documented in ." -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1086 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.9" +"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:1089 +#: reference_accessor.xml:1260 reference_accessor.xml:2033 #, no-c-format -msgid "" -"Neither OGC-SFS nor SQL-MM specifications include a flag argument for " -"ST_IsValid. The flag is a PostGIS extension." +msgid "&sqlmm_compliant;" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1101 -#, 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:1107 +#: reference_accessor.xml:1268 #, no-c-format msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_accessor.xml:1118 -#, no-c-format -msgid "ST_IsValidReason" -msgstr "" - -#. Tag: refpurpose -#: reference_accessor.xml:1120 -#, 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:1124 -#, no-c-format -msgid "" -" text ST_IsValidReason geometry geomA text " -"ST_IsValidReason geometry geomA integer flags " -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1140 -#, 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:1142 -#, 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:1144 -#, no-c-format -msgid "" -"Allowed flags are documented in ." -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1148 -#, no-c-format -msgid "Availability: 1.4 - requires GEOS >= 3.1.0." +"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:1149 +#: reference_accessor.xml:1275 #, no-c-format msgid "" -"Availability: 2.0 - requires GEOS >= 3.3.0 for the version taking flags." -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:1157 -#, 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:1164 -#, no-c-format -msgid ", " +", , , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1170 +#: reference_accessor.xml:1281 #, no-c-format -msgid "ST_IsValidDetail" +msgid "ST_MemSize" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1172 +#: reference_accessor.xml:1283 #, 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." +msgid "Returns the amount of memory space a geometry takes." msgstr "" -#. Tag: funcsynopsis -#: reference_accessor.xml:1176 +#. Tag: funcprototype +#: reference_accessor.xml:1288 #, no-c-format msgid "" -" valid_detail ST_IsValidDetail geometry geom valid_detail " -"ST_IsValidDetail geometry geom integer " -"flags " +"integer ST_MemSize " +"geometry geomA" msgstr "" #. Tag: para -#: reference_accessor.xml:1192 +#: reference_accessor.xml:1298 #, 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." +msgid "Returns the amount of memory space (in bytes) the geometry takes." msgstr "" #. Tag: para -#: reference_accessor.xml:1194 +#: reference_accessor.xml:1299 #, 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:1196 -#, no-c-format -msgid "The 'flags' argument is a bitfield. It can have the following values:" +"This complements the PostgreSQL built-in database " +"object functions pg_column_size, pg_size_pretty, pg_relation_size, " +"pg_total_relation_size." msgstr "" #. Tag: para -#: reference_accessor.xml:1200 +#: reference_accessor.xml:1301 #, 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." +"pg_relation_size which gives the byte size of a table may return byte size " +"lower than ST_MemSize. This is because pg_relation_size does not add toasted " +"table contribution and large geometries are stored in TOAST tables." msgstr "" #. Tag: para -#: reference_accessor.xml:1209 -#, no-c-format -msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:1217 -#, 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:1224 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_accessor.xml:1233 -#, no-c-format -msgid "ST_M" -msgstr "" - -#. Tag: refpurpose -#: reference_accessor.xml:1235 +#: reference_accessor.xml:1303 #, no-c-format msgid "" -"Return the M coordinate of the point, or NULL if not available. " -"Input must be a point." -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:1241 -#, no-c-format -msgid "" -"float ST_M geometry " -" a_point" +"pg_total_relation_size - includes, the table, the toasted tables, and the " +"indexes." msgstr "" #. Tag: para -#: reference_accessor.xml:1251 +#: reference_accessor.xml:1304 #, no-c-format msgid "" -"Return the M coordinate of the point, or NULL if not available. Input " -"must be a point." +"pg_column_size returns how much space a geometry would take in a column " +"considering compression, so may be lower than ST_MemSize" msgstr "" #. Tag: para -#: reference_accessor.xml:1255 +#: reference_accessor.xml:1311 #, 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:1259 reference_accessor.xml:2213 -#, no-c-format -msgid "&sqlmm_compliant;" +"Changed: 2.2.0 name changed to ST_MemSize to follow naming convention. In " +"prior versions this function was called ST_Mem_Size, old name deprecated " +"though still available." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1267 -#, 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:1274 +#: reference_accessor.xml:1318 #, no-c-format msgid "" -", , , " +"--Return how much byte space Boston takes up in our Mass data set\n" +"SELECT pg_size_pretty(SUM(ST_MemSize(the_geom))) as totgeomsum,\n" +"pg_size_pretty(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(the_geom) ELSE " +"0 END)) As bossum,\n" +"CAST(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(the_geom) ELSE 0 " +"END)*1.00 /\n" +" SUM(ST_MemSize(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_MemSize(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_MemSize(the_geom)) As geomsize,\n" +"sum(ST_MemSize(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_accessor.xml:1280 +#: reference_accessor.xml:1325 #, no-c-format msgid "ST_NDims" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1281 +#: reference_accessor.xml:1326 #, no-c-format -msgid "" -"Returns coordinate dimension of the geometry as a small int. Values are: 2,3 " -"or 4." +msgid "Returns the coordinate dimension of a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1287 +#: reference_accessor.xml:1331 #, no-c-format msgid "" "integer ST_NDims " @@ -2202,7 +2516,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1297 +#: reference_accessor.xml:1341 #, no-c-format msgid "" "Returns the coordinate dimension of the geometry. PostGIS supports 2 - (x," @@ -2211,7 +2525,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1306 +#: reference_accessor.xml:1350 #, no-c-format msgid "" "SELECT ST_NDims(ST_GeomFromText('POINT(1 1)')) As d2point,\n" @@ -2224,25 +2538,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1310 +#: reference_accessor.xml:1354 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_accessor.xml:1316 +#: reference_accessor.xml:1360 #, no-c-format msgid "ST_NPoints" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1317 +#: reference_accessor.xml:1361 #, no-c-format -msgid "Return the number of points (vertexes) in a geometry." +msgid "Returns the number of points (vertices) in a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1322 +#: reference_accessor.xml:1366 #, no-c-format msgid "" "integer ST_NPoints " @@ -2250,21 +2564,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1332 +#: reference_accessor.xml:1376 #, no-c-format msgid "Return the number of points in a geometry. Works for all geometries." msgstr "" -#. Tag: para -#: reference_accessor.xml:1334 -#, 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:1344 +#: reference_accessor.xml:1388 #, no-c-format msgid "" "SELECT ST_NPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 " @@ -2280,20 +2586,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1355 +#: reference_accessor.xml:1399 #, no-c-format msgid "ST_NRings" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1356 +#: reference_accessor.xml:1400 #, no-c-format -msgid "" -"If the geometry is a polygon or multi-polygon returns the number of rings." +msgid "Returns the number of rings in a polygonal geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1361 +#: reference_accessor.xml:1405 #, no-c-format msgid "" "integer ST_NRings " @@ -2301,7 +2606,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1371 +#: reference_accessor.xml:1415 #, no-c-format msgid "" "If the geometry is a polygon or multi-polygon returns the number of rings. " @@ -2309,7 +2614,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1381 +#: reference_accessor.xml:1425 #, no-c-format msgid "" "SELECT ST_NRings(the_geom) As Nrings, ST_NumInteriorRings(the_geom) As " @@ -2323,21 +2628,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1394 +#: reference_accessor.xml:1438 #, no-c-format msgid "ST_NumGeometries" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1395 +#: reference_accessor.xml:1439 #, 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." +msgid "Returns the number of elements in a geometry collection." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1401 +#: reference_accessor.xml:1444 #, no-c-format msgid "" "integer ST_NumGeometries " @@ -2345,7 +2648,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1411 +#: reference_accessor.xml:1454 #, no-c-format msgid "" "Returns the number of Geometries. If geometry is a GEOMETRYCOLLECTION (or " @@ -2354,7 +2657,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1415 +#: reference_accessor.xml:1458 #, no-c-format msgid "" "Changed: 2.0.0 In prior versions this would return NULL if the geometry was " @@ -2363,13 +2666,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1417 +#: reference_accessor.xml:1460 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 9.1.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1427 +#: reference_accessor.xml:1470 #, no-c-format msgid "" "--Prior versions would have returned NULL for this -- in 2.0.0 this returns " @@ -2389,25 +2692,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1432 +#: reference_accessor.xml:1475 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:1438 +#: reference_accessor.xml:1481 #, no-c-format msgid "ST_NumInteriorRings" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1439 +#: reference_accessor.xml:1482 #, no-c-format -msgid "Return the number of interior rings of a polygon geometry." +msgid "Returns the number of interior rings (holes) of a Polygon." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1444 +#: reference_accessor.xml:1487 #, no-c-format msgid "" "integer ST_NumInteriorRings " @@ -2415,7 +2718,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1454 +#: reference_accessor.xml:1497 #, no-c-format msgid "" "Return the number of interior rings of a polygon geometry. Return NULL if " @@ -2423,13 +2726,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1459 +#: reference_accessor.xml:1502 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.2.5" msgstr "" #. Tag: para -#: reference_accessor.xml:1460 +#: reference_accessor.xml:1503 #, no-c-format msgid "" "Changed: 2.0.0 - in prior versions it would allow passing a MULTIPOLYGON, " @@ -2437,7 +2740,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1466 +#: reference_accessor.xml:1509 #, no-c-format msgid "" "--If you have a regular polygon\n" @@ -2454,21 +2757,21 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1477 +#: reference_accessor.xml:1520 #, no-c-format msgid "ST_NumInteriorRing" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1478 +#: reference_accessor.xml:1521 #, no-c-format msgid "" -"Return the number of interior rings of a polygon in the geometry. Synonym " -"for ST_NumInteriorRings." +"Returns the number of interior rings (holes) of a Polygon. Aias for " +"ST_NumInteriorRings" msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1484 +#: reference_accessor.xml:1526 #, no-c-format msgid "" "integer ST_NumInteriorRing " @@ -2476,13 +2779,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1500 +#: reference_accessor.xml:1542 #, no-c-format msgid "ST_NumPatches" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1501 +#: reference_accessor.xml:1543 #, no-c-format msgid "" "Return the number of faces on a Polyhedral Surface. Will return null for non-" @@ -2490,7 +2793,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1506 +#: reference_accessor.xml:1548 #, no-c-format msgid "" "integer ST_NumPatches " @@ -2498,7 +2801,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1516 +#: reference_accessor.xml:1558 #, no-c-format msgid "" "Return the number of faces on a Polyhedral Surface. Will return null for non-" @@ -2507,19 +2810,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1519 reference_accessor.xml:1614 +#: reference_accessor.xml:1561 reference_accessor.xml:1654 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: para -#: reference_accessor.xml:1522 reference_accessor.xml:1615 +#: reference_accessor.xml:1564 reference_accessor.xml:1655 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: ?" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1529 +#: reference_accessor.xml:1571 #, no-c-format msgid "" "SELECT ST_NumPatches(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 " @@ -2534,20 +2837,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1540 +#: reference_accessor.xml:1582 #, no-c-format msgid "ST_NumPoints" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1541 +#: reference_accessor.xml:1583 #, no-c-format -msgid "" -"Return the number of points in an ST_LineString or ST_CircularString value." +msgid "Returns the number of points in a LineString or CircularString." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1547 +#: reference_accessor.xml:1588 #, no-c-format msgid "" "integer ST_NumPoints " @@ -2555,7 +2857,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1557 +#: reference_accessor.xml:1598 #, no-c-format msgid "" "Return the number of points in an ST_LineString or ST_CircularString value. " @@ -2566,13 +2868,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1564 +#: reference_accessor.xml:1605 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.2.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1570 +#: reference_accessor.xml:1611 #, no-c-format msgid "" "SELECT ST_NumPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 " @@ -2582,21 +2884,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1581 +#: reference_accessor.xml:1622 #, no-c-format msgid "ST_PatchN" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1583 +#: reference_accessor.xml:1624 #, no-c-format -msgid "" -"Return the 1-based Nth geometry (face) if the geometry is a " -"POLYHEDRALSURFACE, POLYHEDRALSURFACEM. Otherwise, return NULL." +msgid "Returns the Nth geometry (face) of a PolyhedralSurface." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1590 +#: reference_accessor.xml:1629 #, no-c-format msgid "" "geometry ST_PatchN " @@ -2605,31 +2905,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1601 +#: reference_accessor.xml:1640 #, 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." +">Returns the 1-based Nth geometry (face) if the geometry is a " +"POLYHEDRALSURFACE or POLYHEDRALSURFACEM. Otherwise, returns NULL. This " +"returns the same answer as ST_GeometryN for PolyhedralSurfaces. Using " +"ST_GeometryN is faster." msgstr "" #. Tag: para -#: reference_accessor.xml:1607 +#: reference_accessor.xml:1647 #, no-c-format msgid "Index is 1-based." msgstr "" #. Tag: para -#: reference_accessor.xml:1611 +#: reference_accessor.xml:1651 #, no-c-format msgid "" -"If you want to extract all geometries, of a geometry, ST_Dump is more " -"efficient." +"If you want to extract all elements of a geometry is more efficient." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1625 +#: reference_accessor.xml:1665 #, no-c-format msgid "" "--Extract the 2nd face of the polyhedral surface\n" @@ -2649,7 +2949,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1632 +#: reference_accessor.xml:1672 #, no-c-format msgid "" ", , , geometry ST_PointN " @@ -2681,7 +2980,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1658 +#: reference_accessor.xml:1697 #, no-c-format msgid "" "Return the Nth point in a single linestring or circular linestring in the " @@ -2691,7 +2990,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1663 +#: reference_accessor.xml:1702 #, no-c-format msgid "" "Index is 1-based as for OGC specs since version 0.8.0. Backward indexing " @@ -2700,21 +2999,21 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1669 +#: reference_accessor.xml:1708 #, no-c-format msgid "" -"If you want to get the nth point of each line string in a multilinestring, " +"If you want to get the Nth point of each LineString in a MultiLineString, " "use in conjunction with ST_Dump" msgstr "" #. Tag: para -#: reference_accessor.xml:1674 +#: reference_accessor.xml:1713 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.2.5, 7.3.5" msgstr "" #. Tag: para -#: reference_accessor.xml:1677 +#: reference_accessor.xml:1716 #, no-c-format msgid "" "Changed: 2.0.0 no longer works with single geometry multilinestrings. In " @@ -2724,13 +3023,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1680 +#: reference_accessor.xml:1719 #, no-c-format msgid "Changed: 2.3.0 : negative indexing available (-1 is last point)" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1690 +#: reference_accessor.xml:1729 #, no-c-format msgid "" "-- Extract all POINTs from a LINESTRING\n" @@ -2749,154 +3048,91 @@ msgid "" "(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)\n" -"\n" -"SELECT st_astext(f)\n" -"FROM ST_GeometryFromtext('LINESTRING(0 0 0, 1 1 1, 2 2 2)') as g\n" -" ,ST_PointN(g, -2) AS f -- 1 based index\n" -"\n" -"st_astext\n" -"----------\n" -"\"POINT Z (1 1 1)\"" -msgstr "" - -#. Tag: refname -#: reference_accessor.xml:1702 -#, no-c-format -msgid "ST_Points" -msgstr "" - -#. Tag: refpurpose -#: reference_accessor.xml:1703 -#, no-c-format -msgid "Returns a MultiPoint containing all of the coordinates of a geometry." -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:1709 -#, no-c-format -msgid "" -"geometry ST_Points " -"geometry geom " -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1722 -#, no-c-format -msgid "" -"Returns a MultiPoint containing all of the coordinates of a geometry. Does " -"not remove points that are duplicated in the input geometry, including start " -"and end points of ring geometries. (If this behavior is undesired, " -"duplicates may be removed using )." -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1730 -#, no-c-format -msgid "M and Z ordinates will be preserved if present." -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1737 -#, no-c-format -msgid "Availability: 2.3.0" -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:1744 -#, no-c-format -msgid "" -"SELECT ST_AsText(ST_Points('POLYGON Z ((30 10 4,10 30 5,40 40 6, 30 " -"10))'));\n" +"SELECT ST_AsText(ST_PointN(ST_GeomFromText('CIRCULARSTRING(1 2, 3 2, 1 2)'), " +"2));\n" "\n" -"--result\n" -"MULTIPOINT Z (30 10 4,10 30 5,40 40 6, 30 10 4)" +" st_astext\n" +"------------\n" +" POINT(3 2)\n" +"(1 row)\n" +"\n" +"SELECT ST_AsText(f)\n" +"FROM ST_GeomFromText('LINESTRING(0 0 0, 1 1 1, 2 2 2)') AS g\n" +" ,ST_PointN(g, -2) AS f; -- 1 based index\n" +"\n" +" st_astext\n" +"-----------------\n" +" POINT Z (1 1 1)\n" +"(1 row)" msgstr "" #. Tag: refname -#: reference_accessor.xml:1755 +#: reference_accessor.xml:1741 #, no-c-format -msgid "ST_SRID" +msgid "ST_Points" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1756 +#: reference_accessor.xml:1742 #, no-c-format -msgid "" -"Returns the spatial reference identifier for the ST_Geometry as defined in " -"spatial_ref_sys table." +msgid "Returns a MultiPoint containing all the coordinates of a geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1761 +#: reference_accessor.xml:1748 #, no-c-format msgid "" -"integer ST_SRID " -"geometry g1" +"geometry ST_Points " +"geometry geom " msgstr "" #. Tag: para -#: reference_accessor.xml:1771 +#: reference_accessor.xml:1761 #, no-c-format msgid "" -"Returns the spatial reference identifier for the ST_Geometry as defined in " -"spatial_ref_sys table. " +"Returns a MultiPoint containing all of the coordinates of a geometry. Does " +"not remove points that are duplicated in the input geometry, including start " +"and end points of ring geometries. (If this behavior is undesired, " +"duplicates may be removed using )." msgstr "" #. Tag: para -#: reference_accessor.xml:1772 +#: reference_accessor.xml:1769 #, 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." +msgid "M and Z coordinates will be preserved if present." msgstr "" #. Tag: para #: reference_accessor.xml:1776 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.5" +msgid "Availability: 2.3.0" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1784 -#, 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:1789 +#: reference_accessor.xml:1783 #, no-c-format msgid "" -", , , " +"SELECT ST_AsText(ST_Points('POLYGON Z ((30 10 4,10 30 5,40 40 6, 30 " +"10))'));\n" +"\n" +"--result\n" +"MULTIPOINT Z (30 10 4,10 30 5,40 40 6, 30 10 4)" msgstr "" #. Tag: refname -#: reference_accessor.xml:1795 +#: reference_accessor.xml:1794 #, no-c-format msgid "ST_StartPoint" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1797 +#: reference_accessor.xml:1796 #, no-c-format -msgid "" -"Returns the first point of a LINESTRING geometry as a " -"POINT." +msgid "Returns the first point of a LineString." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1803 +#: reference_accessor.xml:1801 #, no-c-format msgid "" "geometry ST_StartPoint " @@ -2904,7 +3140,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1814 +#: reference_accessor.xml:1812 #, no-c-format msgid "" "Returns the first point of a LINESTRING or " @@ -2914,13 +3150,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1818 +#: reference_accessor.xml:1816 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.3" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1833 +#: reference_accessor.xml:1831 #, no-c-format msgid "" "SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));\n" @@ -2951,27 +3187,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1839 +#: reference_accessor.xml:1837 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_accessor.xml:1844 +#: reference_accessor.xml:1842 #, no-c-format msgid "ST_Summary" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1846 +#: reference_accessor.xml:1844 #, no-c-format -msgid "" -"Returns a text summary of the contents of the geometry." +msgid "Returns a text summary of the contents of a geometry." msgstr "" #. Tag: funcsynopsis -#: reference_accessor.xml:1852 +#: reference_accessor.xml:1849 #, no-c-format msgid "" " text ST_Summary " @@ -2982,13 +3216,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1867 +#: reference_accessor.xml:1864 #, no-c-format -msgid "Returns a text summary of the contents of the geometry." +msgid "Returns a text summary of the contents of the geometry." msgstr "" #. Tag: para -#: reference_accessor.xml:1869 +#: reference_accessor.xml:1866 #, no-c-format msgid "" "Flags shown square brackets after the geometry type have the following " @@ -2996,62 +3230,62 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1873 +#: reference_accessor.xml:1870 #, no-c-format -msgid "M: has M ordinate" +msgid "M: has M coordinate" msgstr "" #. Tag: para -#: reference_accessor.xml:1874 +#: reference_accessor.xml:1871 #, no-c-format -msgid "Z: has Z ordinate" +msgid "Z: has Z coordinate" msgstr "" #. Tag: para -#: reference_accessor.xml:1875 +#: reference_accessor.xml:1872 #, no-c-format msgid "B: has a cached bounding box" msgstr "" #. Tag: para -#: reference_accessor.xml:1876 +#: reference_accessor.xml:1873 #, no-c-format msgid "G: is geodetic (geography)" msgstr "" #. Tag: para -#: reference_accessor.xml:1877 +#: reference_accessor.xml:1874 #, no-c-format msgid "S: has spatial reference system" msgstr "" #. Tag: para -#: reference_accessor.xml:1888 +#: reference_accessor.xml:1885 #, no-c-format msgid "Availability: 1.2.2" msgstr "" #. Tag: para -#: reference_accessor.xml:1889 +#: reference_accessor.xml:1886 #, no-c-format msgid "Enhanced: 2.0.0 added support for geography" msgstr "" #. Tag: para -#: reference_accessor.xml:1890 +#: reference_accessor.xml:1887 #, no-c-format msgid "" "Enhanced: 2.1.0 S flag to denote if has a known spatial reference system" msgstr "" #. Tag: para -#: reference_accessor.xml:1891 +#: reference_accessor.xml:1888 #, no-c-format msgid "Enhanced: 2.2.0 Added support for TIN and Curves" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1897 +#: reference_accessor.xml:1894 #, no-c-format msgid "" "=# SELECT ST_Summary(ST_GeomFromText('LINESTRING(0 0, 1 1)')) as geom,\n" @@ -3079,7 +3313,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1903 +#: reference_accessor.xml:1900 #, no-c-format msgid "" ", , , " @@ -3088,7 +3322,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1912 +#: reference_accessor.xml:1909 #, no-c-format msgid "" ", , , " @@ -3096,21 +3330,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_accessor.xml:1923 +#: reference_accessor.xml:1920 #, no-c-format msgid "ST_X" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:1925 +#: reference_accessor.xml:1922 #, no-c-format -msgid "" -"Return the X coordinate of the point, or NULL if not available. " -"Input must be a point." +msgid "Returns the X coordinate of a Point." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:1931 +#: reference_accessor.xml:1927 #, no-c-format msgid "" "float ST_X geometry " @@ -3118,29 +3350,29 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1941 +#: reference_accessor.xml:1937 #, no-c-format msgid "" -"Return the X coordinate of the point, or NULL if not available. Input " -"must be a point." +"Return the X coordinate of the point, or NULL if not available. Input must " +"be a point." msgstr "" #. Tag: para -#: reference_accessor.xml:1944 +#: reference_accessor.xml:1940 #, no-c-format msgid "" -"If you want to get the max min x values of any geometry look at ST_XMin, " -"ST_XMax functions." +"To get the minimum and maximum X value of geometry coordinates use the " +"functions and ." msgstr "" #. Tag: para -#: reference_accessor.xml:1946 +#: reference_accessor.xml:1943 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 6.1.3" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:1954 +#: reference_accessor.xml:1951 #, no-c-format msgid "" "SELECT ST_X(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" @@ -3157,7 +3389,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:1961 +#: reference_accessor.xml:1958 #, no-c-format msgid "" ", , , Returns X maxima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:1974 -#, no-c-format -msgid "" -"float ST_XMax box3d " -" aGeomorBox2DorBox3D" -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1984 -#, no-c-format -msgid "Returns X maxima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: para -#: reference_accessor.xml:1987 reference_accessor.xml:2032 -#: reference_accessor.xml:2120 reference_accessor.xml:2165 -#: reference_accessor.xml:2253 reference_accessor.xml:2340 -#, 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:1999 -#, 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 - doesn't 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:2006 reference_accessor.xml:2051 -#, no-c-format -msgid "" -", , , , " -msgstr "" - -#. Tag: refname -#: reference_accessor.xml:2012 +#: reference_accessor.xml:1964 #, no-c-format -msgid "ST_XMin" +msgid "ST_Y" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:2014 +#: reference_accessor.xml:1966 #, no-c-format -msgid "" -"Returns X minima of a bounding box 2d or 3d or a geometry." +msgid "Returns the Y coordinate of a Point." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:2019 +#: reference_accessor.xml:1971 #, no-c-format msgid "" -"float ST_XMin box3d " -" aGeomorBox2DorBox3D" +"float ST_Y geometry " +" a_point" msgstr "" #. Tag: para -#: reference_accessor.xml:2029 -#, no-c-format -msgid "Returns X minima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:2044 -#, 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 - doesn't 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:2057 -#, no-c-format -msgid "ST_Y" -msgstr "" - -#. Tag: refpurpose -#: reference_accessor.xml:2059 -#, no-c-format -msgid "" -"Return the Y coordinate of the point, or NULL if not available. " -"Input must be a point." -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:2065 +#: reference_accessor.xml:1981 #, no-c-format msgid "" -"float ST_Y geometry " -" a_point" +"Return the Y coordinate of the point, or NULL if not available. Input must " +"be a point." msgstr "" #. Tag: para -#: reference_accessor.xml:2075 +#: reference_accessor.xml:1984 #, no-c-format msgid "" -"Return the Y coordinate of the point, or NULL if not available. Input " -"must be a point." +"To get the minimum and maximum Y value of geometry coordinates use the " +"functions and ." msgstr "" #. Tag: para -#: reference_accessor.xml:2079 +#: reference_accessor.xml:1988 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 6.1.4" msgstr "" #. Tag: programlisting -#: reference_accessor.xml:2087 +#: reference_accessor.xml:1996 #, no-c-format msgid "" "SELECT ST_Y(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" @@ -3357,7 +3457,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:2094 +#: reference_accessor.xml:2003 #, no-c-format msgid "" ", , , Returns Y maxima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:2107 -#, no-c-format -msgid "" -"float ST_YMax box3d " -" aGeomorBox2DorBox3D" -msgstr "" - -#. Tag: para -#: reference_accessor.xml:2117 -#, no-c-format -msgid "Returns Y maxima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:2132 -#, 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 - doesn't 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:2139 -#, no-c-format -msgid "" -", , , , " -msgstr "" - -#. Tag: refname -#: reference_accessor.xml:2145 +#: reference_accessor.xml:2009 #, no-c-format -msgid "ST_YMin" +msgid "ST_Z" msgstr "" #. Tag: refpurpose -#: reference_accessor.xml:2147 +#: reference_accessor.xml:2011 #, no-c-format -msgid "" -"Returns Y minima of a bounding box 2d or 3d or a geometry." +msgid "Returns the Z coordinate of a Point." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:2152 -#, no-c-format -msgid "" -"float ST_YMin box3d " -" aGeomorBox2DorBox3D" -msgstr "" - -#. Tag: para -#: reference_accessor.xml:2162 -#, no-c-format -msgid "Returns Y minima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:2177 +#: reference_accessor.xml:2016 #, 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 - doesn't 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" +"float ST_Z geometry " +" a_point" msgstr "" #. Tag: para -#: reference_accessor.xml:2184 -#, no-c-format -msgid "" -", , , , , " -msgstr "" - -#. Tag: refname -#: reference_accessor.xml:2190 -#, no-c-format -msgid "ST_Z" -msgstr "" - -#. Tag: refpurpose -#: reference_accessor.xml:2192 -#, no-c-format -msgid "" -"Return the Z coordinate of the point, or NULL if not available. " -"Input must be a point." -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:2198 +#: reference_accessor.xml:2026 #, no-c-format msgid "" -"float ST_Z geometry " -" a_point" +"Return the Z coordinate of the point, or NULL if not available. Input must " +"be a point." msgstr "" #. Tag: para -#: reference_accessor.xml:2208 +#: reference_accessor.xml:2029 #, no-c-format msgid "" -"Return the Z coordinate of the point, or NULL if not available. Input " -"must be a point." +"To get the minimum and maximum Z value of geometry coordinates use the " +"functions and ." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:2220 +#: reference_accessor.xml:2040 #, no-c-format msgid "" "SELECT ST_Z(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" @@ -3541,7 +3513,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:2227 +#: reference_accessor.xml:2047 #, no-c-format msgid "" ", , , Returns Z minima of a bounding box 2d or 3d or a geometry." +"Returns a code indicating the ZM coordinate dimension of a " +"geometry." msgstr "" #. Tag: funcprototype -#: reference_accessor.xml:2240 -#, no-c-format -msgid "" -"float ST_ZMax box3d " -" aGeomorBox2DorBox3D" -msgstr "" - -#. Tag: para -#: reference_accessor.xml:2250 -#, no-c-format -msgid "Returns Z maxima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:2265 +#: reference_accessor.xml:2060 #, 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 - doesn't 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" +"smallint ST_Zmflag " +"geometry geomA" msgstr "" #. Tag: para -#: reference_accessor.xml:2272 -#, no-c-format -msgid "" -", , , , , " -msgstr "" - -#. Tag: refname -#: reference_accessor.xml:2278 -#, no-c-format -msgid "ST_Zmflag" -msgstr "" - -#. Tag: refpurpose -#: reference_accessor.xml:2280 -#, no-c-format -msgid "" -"Returns ZM (dimension semantic) flag of the geometries as a " -"small int. Values are: 0=2d, 1=3dm, 2=3dz, 3=4d." -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:2286 +#: reference_accessor.xml:2070 #, no-c-format msgid "" -"smallint ST_Zmflag " -"geometry geomA" +"Returns a code indicating the ZM coordinate dimension of a geometry." msgstr "" #. Tag: para -#: reference_accessor.xml:2296 +#: reference_accessor.xml:2072 #, no-c-format -msgid "" -"Returns ZM (dimension semantic) flag of the geometries as a small int. " -"Values are: 0=2d, 1=3dm, 2=3dz, 3=4d." +msgid "Values are: 0 = 2D, 1 = 3D-M, 2 = 3D-Z, 3 = 4D." msgstr "" #. Tag: programlisting -#: reference_accessor.xml:2307 +#: reference_accessor.xml:2082 #, no-c-format msgid "" "SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRING(1 2, 3 4)'));\n" @@ -3670,67 +3581,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_accessor.xml:2314 +#: reference_accessor.xml:2089 #, no-c-format msgid ", , " msgstr "" - -#. Tag: refname -#: reference_accessor.xml:2320 -#, no-c-format -msgid "ST_ZMin" -msgstr "" - -#. Tag: funcprototype -#: reference_accessor.xml:2327 -#, no-c-format -msgid "" -"float ST_ZMin box3d " -" aGeomorBox2DorBox3D" -msgstr "" - -#. Tag: para -#: reference_accessor.xml:2337 -#, no-c-format -msgid "Returns Z minima of a bounding box 2d or 3d or a geometry." -msgstr "" - -#. Tag: programlisting -#: reference_accessor.xml:2352 -#, 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 - doesn't 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:2359 -#, no-c-format -msgid "" -", , , , , , " -msgstr "" diff --git a/doc/po/templates/reference_bbox.xml.pot b/doc/po/templates/reference_bbox.xml.pot new file mode 100644 index 000000000..ee734d981 --- /dev/null +++ b/doc/po/templates/reference_bbox.xml.pot @@ -0,0 +1,1178 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_bbox.xml:5 +#, no-c-format +msgid "" +"These functions produce or operate on bounding boxes. They can also provide " +"and accept geometry values, by using automatic or explicit casts." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:8 +#, no-c-format +msgid "See also ." +msgstr "" + +#. Tag: title +#: reference_bbox.xml:12 +#, no-c-format +msgid "Bounding Box Functions" +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:16 +#, no-c-format +msgid "Box2D" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:18 +#, no-c-format +msgid "" +"Returns a BOX2D representing the 2D extent of the geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:23 +#, no-c-format +msgid "" +"box2d Box2D geometry " +" geomA" +msgstr "" + +#. Tag: title +#: reference_bbox.xml:31 reference_bbox.xml:72 reference_bbox.xml:131 +#: reference_bbox.xml:231 reference_bbox.xml:292 reference_bbox.xml:346 +#: reference_bbox.xml:395 reference_bbox.xml:433 reference_bbox.xml:479 +#: reference_bbox.xml:524 reference_bbox.xml:569 reference_bbox.xml:614 +#: reference_bbox.xml:659 reference_bbox.xml:704 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:33 +#, no-c-format +msgid "" +"Returns a BOX2D representing the 2D extent of the geometry." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:35 reference_bbox.xml:75 reference_bbox.xml:255 +#: reference_bbox.xml:312 reference_bbox.xml:358 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:36 reference_bbox.xml:76 reference_bbox.xml:161 +#: reference_bbox.xml:361 reference_bbox.xml:489 reference_bbox.xml:534 +#: reference_bbox.xml:579 reference_bbox.xml:624 reference_bbox.xml:669 +#: reference_bbox.xml:714 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:37 reference_bbox.xml:77 reference_bbox.xml:259 +#: reference_bbox.xml:313 reference_bbox.xml:362 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:38 reference_bbox.xml:78 reference_bbox.xml:260 +#: reference_bbox.xml:314 reference_bbox.xml:363 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: title +#: reference_bbox.xml:42 reference_bbox.xml:84 reference_bbox.xml:166 +#: reference_bbox.xml:265 reference_bbox.xml:319 reference_bbox.xml:367 +#: reference_bbox.xml:403 reference_bbox.xml:449 reference_bbox.xml:494 +#: reference_bbox.xml:539 reference_bbox.xml:584 reference_bbox.xml:629 +#: reference_bbox.xml:674 reference_bbox.xml:719 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:44 +#, 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: title +#: reference_bbox.xml:49 reference_bbox.xml:91 reference_bbox.xml:173 +#: reference_bbox.xml:271 reference_bbox.xml:325 reference_bbox.xml:372 +#: reference_bbox.xml:410 reference_bbox.xml:456 reference_bbox.xml:501 +#: reference_bbox.xml:546 reference_bbox.xml:591 reference_bbox.xml:636 +#: reference_bbox.xml:681 reference_bbox.xml:726 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:51 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:57 +#, no-c-format +msgid "Box3D" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:59 +#, no-c-format +msgid "" +"Returns a BOX3D representing the 3D extent of the geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:64 +#, no-c-format +msgid "" +"box3d Box3D geometry " +" geomA" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:74 +#, no-c-format +msgid "" +"Returns a BOX3D representing the 3D extent of the geometry." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:79 reference_bbox.xml:360 reference_bbox.xml:488 +#: reference_bbox.xml:533 reference_bbox.xml:578 reference_bbox.xml:623 +#: reference_bbox.xml:668 reference_bbox.xml:713 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:86 +#, 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_bbox.xml:93 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:99 +#, no-c-format +msgid "ST_EstimatedExtent" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:101 +#, no-c-format +msgid "Return the 'estimated' extent of a spatial table." +msgstr "" + +#. Tag: funcsynopsis +#: reference_bbox.xml:105 +#, no-c-format +msgid "" +" box2d ST_EstimatedExtent text schema_name text table_name text geocolumn_name boolean " +"parent_only " +" box2d ST_EstimatedExtent text schema_name text table_name text geocolumn_name box2d " +"ST_EstimatedExtent text table_name text geocolumn_name " +msgstr "" + +#. Tag: para +#: reference_bbox.xml:133 +#, no-c-format +msgid "" +"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. The default behavior is to also use statistics collected " +"from child tables (tables with INHERITS) if available. If 'parent_only' is " +"set to TRUE, only statistics for the given table are used and child tables " +"are ignored." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:142 +#, 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_bbox.xml:147 +#, 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_bbox.xml:155 +#, 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_bbox.xml:158 +#, no-c-format +msgid "Availability: 1.0.0" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:159 +#, no-c-format +msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent." +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:168 +#, 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_bbox.xml:180 +#, no-c-format +msgid "ST_Expand" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:181 +#, no-c-format +msgid "" +"Returns a bounding box expanded from another bounding box or a geometry." +msgstr "" + +#. Tag: funcsynopsis +#: reference_bbox.xml:185 +#, no-c-format +msgid "" +" geometry ST_Expand " +"geometry geom " +"float units_to_expand geometry " +"ST_Expand geometry " +"geom float " +"dx float " +"dy float dz=0 float dm=0 box2d ST_Expand box2d box float " +"units_to_expand " +" box2d ST_Expand " +"box2d box " +"float dx " +"float dy box3d ST_Expand box3d box float " +"units_to_expand " +" box3d ST_Expand " +"box3d box " +"float dx " +"float dy float dz=0 " +msgstr "" + +#. Tag: para +#: reference_bbox.xml:233 +#, no-c-format +msgid "" +"This function returns a bounding box expanded from the bounding box of the " +"input, either by specifying a single distance with which the box should be " +"expanded in all directions, or by specifying an expansion distance for each " +"direction. Uses double-precision. Can be very useful for distance queries, " +"or to add a bounding box filter to a query to take advantage of a spatial " +"index." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:239 +#, no-c-format +msgid "" +"In addition to the geometry version of ST_Expand, which is the most commonly " +"used, variants are provided that accept and produce internal BOX2D and BOX3D " +"data types." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:242 +#, no-c-format +msgid "" +"ST_Expand is similar in concept to , except " +"while buffer expands the geometry in all directions, ST_Expand expands the " +"bounding box along each axis." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:245 +#, no-c-format +msgid "" +"Units are in the units of the spatial reference system in use denoted by the " +"SRID." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:248 +#, no-c-format +msgid "" +"Pre version 1.3, ST_Expand was used in conjunction with to do indexable distance queries. For example, " +"the_geom && ST_Expand('POINT(10 20)', 10) AND " +"ST_Distance(the_geom, 'POINT(10 20)') < 10. This has been replaced " +"by the easier construct." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:254 +#, no-c-format +msgid "" +"Availability: 1.5.0 behavior changed to output double precision instead of " +"float4 coordinates." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:256 +#, no-c-format +msgid "" +"Enhanced: 2.3.0 support was added to expand a box by different amounts in " +"different dimensions." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:266 +#, no-c-format +msgid "" +"Examples below use US National Atlas Equal Area (SRID=2163) which is a meter " +"projection" +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:267 +#, no-c-format +msgid "" +"\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_bbox.xml:272 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:278 +#, no-c-format +msgid "ST_Extent" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:279 +#, no-c-format +msgid "" +"an aggregate function that returns the bounding box that bounds rows of " +"geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:284 +#, no-c-format +msgid "" +"box2d ST_Extent " +"geometry set geomfield" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:294 +#, 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_bbox.xml:297 reference_bbox.xml:351 +#, 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_bbox.xml:298 +#, no-c-format +msgid "" +"ST_Extent is similar in concept to Oracle Spatial/Locator's SDO_AGGR_MBR" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:300 +#, 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_bbox.xml:305 +#, 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_bbox.xml:309 +#, no-c-format +msgid "Availability: 1.4.0" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:320 +#, no-c-format +msgid "Examples below use Massachusetts State Plane ft (SRID=2249)" +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:321 +#, 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_bbox.xml:326 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:332 +#, no-c-format +msgid "ST_3DExtent" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:333 +#, no-c-format +msgid "" +"an aggregate function that returns the 3D bounding box that bounds rows of " +"geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:338 +#, no-c-format +msgid "" +"box3d ST_3DExtent " +"geometry set geomfield" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:348 +#, 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_bbox.xml:354 +#, 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_bbox.xml:359 +#, no-c-format +msgid "Changed: 2.0.0 In prior versions this used to be called ST_Extent3D" +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:368 +#, 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_bbox.xml:373 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:379 +#, no-c-format +msgid "ST_MakeBox2D" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:381 +#, no-c-format +msgid "Creates a BOX2D defined by two 2D point geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:386 +#, no-c-format +msgid "" +"box2d ST_MakeBox2D " +"geometry pointLowLeft geometry pointUpRight" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:397 +#, no-c-format +msgid "" +"Creates a BOX2D defined by the given two point geometries. This is useful " +"for doing range queries" +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:405 +#, 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_bbox.xml:412 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:418 +#, no-c-format +msgid "ST_3DMakeBox" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:420 +#, no-c-format +msgid "Creates a BOX3D defined by two 3D point geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:424 +#, no-c-format +msgid "" +"box3d ST_3DMakeBox " +"geometry point3DLowLeftBottom geometry " +"point3DUpRightTop" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:435 +#, no-c-format +msgid "Creates a BOX3D defined by the given two 3D point geometries." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:442 +#, no-c-format +msgid "This function supports 3D and will not drop the z-index." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:444 +#, no-c-format +msgid "Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D" +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:451 +#, 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 "" + +#. Tag: para +#: reference_bbox.xml:458 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:464 +#, no-c-format +msgid "ST_XMax" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:466 +#, no-c-format +msgid "" +"Returns the X maxima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:471 +#, no-c-format +msgid "" +"float ST_XMax box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:481 +#, no-c-format +msgid "" +"Returns the X maxima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: para +#: reference_bbox.xml:484 reference_bbox.xml:529 reference_bbox.xml:574 +#: reference_bbox.xml:619 reference_bbox.xml:664 reference_bbox.xml:709 +#, no-c-format +msgid "" +"Although this function is only defined for box3d, it also works for box2d " +"and geometry values due to automatic casting. However it will not accept a " +"geometry or box2d text representation, since those do not auto-cast." +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:496 +#, 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 - doesn't 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_bbox.xml:503 reference_bbox.xml:548 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:509 +#, no-c-format +msgid "ST_XMin" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:511 +#, no-c-format +msgid "" +"Returns the X minima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:516 +#, no-c-format +msgid "" +"float ST_XMin box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:526 +#, no-c-format +msgid "" +"Returns the X minima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:541 +#, 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 - doesn't 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_bbox.xml:554 +#, no-c-format +msgid "ST_YMax" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:556 +#, no-c-format +msgid "" +"Returns the Y maxima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:561 +#, no-c-format +msgid "" +"float ST_YMax box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:571 +#, no-c-format +msgid "" +"Returns the Y maxima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:586 +#, 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 - doesn't 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_bbox.xml:593 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:599 +#, no-c-format +msgid "ST_YMin" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:601 +#, no-c-format +msgid "" +"Returns the Y minima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:606 +#, no-c-format +msgid "" +"float ST_YMin box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:616 +#, no-c-format +msgid "" +"Returns the Y minima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:631 +#, 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 - doesn't 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_bbox.xml:638 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:644 +#, no-c-format +msgid "ST_ZMax" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:646 +#, no-c-format +msgid "" +"Returns the Z maxima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:651 +#, no-c-format +msgid "" +"float ST_ZMax box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:661 +#, no-c-format +msgid "" +"Returns the Z maxima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:676 +#, 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 - doesn't 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_bbox.xml:683 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_bbox.xml:689 +#, no-c-format +msgid "ST_ZMin" +msgstr "" + +#. Tag: refpurpose +#: reference_bbox.xml:691 +#, no-c-format +msgid "" +"Returns the Z minima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_bbox.xml:696 +#, no-c-format +msgid "" +"float ST_ZMin box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_bbox.xml:706 +#, no-c-format +msgid "" +"Returns the Z minima of a 2D or 3D bounding box or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_bbox.xml:721 +#, 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 - doesn't 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_bbox.xml:728 +#, no-c-format +msgid "" +", , , , , , " +msgstr "" diff --git a/doc/po/templates/reference_cluster.xml.pot b/doc/po/templates/reference_cluster.xml.pot new file mode 100644 index 000000000..ee06c2826 --- /dev/null +++ b/doc/po/templates/reference_cluster.xml.pot @@ -0,0 +1,466 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_cluster.xml:5 +#, no-c-format +msgid "These functions implement clustering algorithms for sets of geometries." +msgstr "" + +#. Tag: title +#: reference_cluster.xml:8 +#, no-c-format +msgid "Clustering Functions" +msgstr "" + +#. Tag: refname +#: reference_cluster.xml:12 +#, no-c-format +msgid "ST_ClusterDBSCAN" +msgstr "" + +#. Tag: refpurpose +#: reference_cluster.xml:14 +#, no-c-format +msgid "" +"Window function that returns a cluster id for each input geometry using the " +"DBSCAN algorithm." +msgstr "" + +#. Tag: funcprototype +#: reference_cluster.xml:19 +#, no-c-format +msgid "" +"integer ST_ClusterDBSCAN " +"geometry winset geom float8 eps integer minpoints" +msgstr "" + +#. Tag: title +#: reference_cluster.xml:35 reference_cluster.xml:137 reference_cluster.xml:182 +#: reference_cluster.xml:259 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:37 +#, no-c-format +msgid "" +"Returns cluster number for each input geometry, based on a 2D implementation " +"of the Density-based " +"spatial clustering of applications with noise (DBSCAN) algorithm. " +"Unlike , it does not require the number " +"of clusters to be specified, but instead uses the desired distance (eps) and density " +"(minpoints) parameters to construct each cluster." +msgstr "" + +#. Tag: para +#: reference_cluster.xml:44 +#, no-c-format +msgid "An input geometry will be added to a cluster if it is either:" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:48 +#, no-c-format +msgid "" +"A \"core\" geometry, that is within eps distance of at least minpoints " +"input geometries (including itself) or" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:53 +#, no-c-format +msgid "" +"A \"border\" geometry, that is within eps distance of a core geometry." +msgstr "" + +#. Tag: para +#: reference_cluster.xml:60 +#, no-c-format +msgid "" +"Note that border geometries may be within eps distance of " +"core geometries in more than one cluster; in this case, either assignment " +"would be correct, and the border geometry will be arbitrarily asssigned to " +"one of the available clusters. In these cases, it is possible for a correct " +"cluster to be generated with fewer than minpoints " +"geometries. When assignment of a border geometry is ambiguous, repeated " +"calls to ST_ClusterDBSCAN will produce identical results if an ORDER BY " +"clause is included in the window definition, but cluster assignments may " +"differ from other implementations of the same algorithm." +msgstr "" + +#. Tag: para +#: reference_cluster.xml:68 +#, no-c-format +msgid "" +"Input geometries that do not meet the criteria to join any other cluster " +"will be assigned a cluster number of NULL." +msgstr "" + +#. Tag: para +#: reference_cluster.xml:72 reference_cluster.xml:189 +#, no-c-format +msgid "Availability: 2.3.0" +msgstr "" + +#. Tag: title +#: reference_cluster.xml:76 reference_cluster.xml:145 reference_cluster.xml:193 +#: reference_cluster.xml:267 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:77 +#, no-c-format +msgid "" +"Assigning a cluster number to each polygon within 50 meters of each other. " +"Require at least 2 polygons per cluster" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:89 +#, no-c-format +msgid "within 50 meters at least 2 per cluster. singletons have NULL for cid" +msgstr "" + +#. Tag: programlisting +#: reference_cluster.xml:92 +#, no-c-format +msgid "" +"SELECT name, ST_ClusterDBSCAN(geom, eps := 50, minpoints := 2) over () AS " +"cid\n" +"FROM boston_polys\n" +"WHERE name > '' AND building > ''\n" +" AND ST_DWithin(geom,\n" +" ST_Transform(\n" +" ST_GeomFromText('POINT(-71.04054 42.35141)', 4326), 26986),\n" +" 500);" +msgstr "" + +#. Tag: screen +#: reference_cluster.xml:95 +#, no-c-format +msgid "" +"" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:103 +#, no-c-format +msgid "" +"Combining parcels with the same cluster number into a single geometry. This " +"uses named argument calling" +msgstr "" + +#. Tag: programlisting +#: reference_cluster.xml:106 +#, no-c-format +msgid "" +"SELECT cid, ST_Collect(geom) AS cluster_geom, array_agg(parcel_id) AS " +"ids_in_cluster FROM (\n" +" SELECT parcel_id, ST_ClusterDBSCAN(geom, eps := 0.5, minpoints := 5) " +"over () AS cid, geom\n" +" FROM parcels) sq\n" +"GROUP BY cid;" +msgstr "" + +#. Tag: title +#: reference_cluster.xml:110 reference_cluster.xml:149 +#: reference_cluster.xml:232 reference_cluster.xml:271 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:111 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_cluster.xml:122 +#, no-c-format +msgid "ST_ClusterIntersecting" +msgstr "" + +#. Tag: refpurpose +#: reference_cluster.xml:124 +#, no-c-format +msgid "" +"Aggregate function that clusters the input geometries into connected sets." +msgstr "" + +#. Tag: funcprototype +#: reference_cluster.xml:129 +#, no-c-format +msgid "" +"geometry[] ST_ClusterIntersecting " +"geometry set g" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:139 +#, no-c-format +msgid "" +"ST_ClusterIntersecting is an aggregate function that returns an array of " +"GeometryCollections, where each GeometryCollection represents an " +"interconnected set of geometries." +msgstr "" + +#. Tag: para +#: reference_cluster.xml:141 reference_cluster.xml:263 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: programlisting +#: reference_cluster.xml:146 +#, no-c-format +msgid "" +"WITH testdata AS\n" +" (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,\n" +" 'LINESTRING (5 5, 4 4)'::geometry,\n" +" 'LINESTRING (6 6, 7 7)'::geometry,\n" +" 'LINESTRING (0 0, -1 -1)'::geometry,\n" +" 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS " +"geom)\n" +"\n" +"SELECT ST_AsText(unnest(ST_ClusterIntersecting(geom))) FROM testdata;\n" +"\n" +"--result\n" +"\n" +"st_astext\n" +"---------\n" +"GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 " +"-1),POLYGON((0 0,4 0,4 4,0 4,0 0)))\n" +"GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:150 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_cluster.xml:162 +#, no-c-format +msgid "ST_ClusterKMeans" +msgstr "" + +#. Tag: refpurpose +#: reference_cluster.xml:164 +#, no-c-format +msgid "" +"Window function that returns a cluster id for each input geometry using the " +"K-means algorithm." +msgstr "" + +#. Tag: funcprototype +#: reference_cluster.xml:169 +#, no-c-format +msgid "" +"integer ST_ClusterKMeans " +"geometry winset geom integer number_of_clusters" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:184 +#, no-c-format +msgid "" +"Returns 2D distance based K-means cluster number for each input geometry. " +"The distance used for clustering is the distance between the centroids of " +"the geometries." +msgstr "" + +#. Tag: para +#: reference_cluster.xml:194 +#, no-c-format +msgid "Generate dummy set of parcels for examples" +msgstr "" + +#. Tag: programlisting +#: reference_cluster.xml:195 +#, no-c-format +msgid "" +"CREATE TABLE parcels AS\n" +"SELECT lpad((row_number() over())::text,3,'0') As parcel_id, geom,\n" +"('{residential, commercial}'::text[])[1 + mod(row_number()OVER(),2)] As " +"type\n" +"FROM\n" +" ST_Subdivide(ST_Buffer('LINESTRING(40 100, 98 100, 100 150, 60 90)'::" +"geometry,\n" +" 40, 'endcap=square'),12) As geom;" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:207 +#, no-c-format +msgid "Original Parcels" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:217 +#, no-c-format +msgid "Parcels color-coded by cluster number (cid)" +msgstr "" + +#. Tag: programlisting +#: reference_cluster.xml:220 +#, no-c-format +msgid "" +"SELECT ST_ClusterKMeans(geom, 5) OVER() AS cid, parcel_id, geom\n" +"FROM parcels;\n" +"-- result\n" +" cid | parcel_id | geom\n" +"-----+-----------+---------------\n" +" 0 | 001 | 0103000000...\n" +" 0 | 002 | 0103000000...\n" +" 1 | 003 | 0103000000...\n" +" 0 | 004 | 0103000000...\n" +" 1 | 005 | 0103000000...\n" +" 2 | 006 | 0103000000...\n" +" 2 | 007 | 0103000000...\n" +"(7 rows)" +msgstr "" + +#. Tag: programlisting +#: reference_cluster.xml:227 +#, no-c-format +msgid "" +"-- Partitioning parcel clusters by type\n" +"SELECT ST_ClusterKMeans(geom,3) over (PARTITION BY type) AS cid, parcel_id, " +"type\n" +"FROM parcels;\n" +"-- result\n" +" cid | parcel_id | type\n" +"-----+-----------+-------------\n" +" 1 | 005 | commercial\n" +" 1 | 003 | commercial\n" +" 2 | 007 | commercial\n" +" 0 | 001 | commercial\n" +" 1 | 004 | residential\n" +" 0 | 002 | residential\n" +" 2 | 006 | residential\n" +"(7 rows)" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:233 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_cluster.xml:243 +#, no-c-format +msgid "ST_ClusterWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_cluster.xml:245 +#, no-c-format +msgid "" +"Aggregate function that clusters the input geometries by separation distance." +msgstr "" + +#. Tag: funcprototype +#: reference_cluster.xml:250 +#, no-c-format +msgid "" +"geometry[] ST_ClusterWithin " +"geometry set g " +"float8 distance" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:261 +#, no-c-format +msgid "" +"ST_ClusterWithin is an aggregate function that returns an array of " +"GeometryCollections, where each GeometryCollection represents a set of " +"geometries separated by no more than the specified distance. (Distances are " +"Cartesian distances in the units of the SRID.)" +msgstr "" + +#. Tag: programlisting +#: reference_cluster.xml:268 +#, no-c-format +msgid "" +"WITH testdata AS\n" +" (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,\n" +" 'LINESTRING (5 5, 4 4)'::geometry,\n" +" 'LINESTRING (6 6, 7 7)'::geometry,\n" +" 'LINESTRING (0 0, -1 -1)'::geometry,\n" +" 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS " +"geom)\n" +"\n" +"SELECT ST_AsText(unnest(ST_ClusterWithin(geom, 1.4))) FROM testdata;\n" +"\n" +"--result\n" +"\n" +"st_astext\n" +"---------\n" +"GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 " +"-1),POLYGON((0 0,4 0,4 4,0 4,0 0)))\n" +"GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))" +msgstr "" + +#. Tag: para +#: reference_cluster.xml:272 +#, no-c-format +msgid "" +", , " +msgstr "" diff --git a/doc/po/templates/reference_constructor.xml.pot b/doc/po/templates/reference_constructor.xml.pot index 10f4b9c85..7c0b46782 100644 --- a/doc/po/templates/reference_constructor.xml.pot +++ b/doc/po/templates/reference_constructor.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -21,3313 +21,1337 @@ msgid "Geometry Constructors" msgstr "" #. Tag: refname -#: reference_constructor.xml:6 +#: reference_constructor.xml:7 #, no-c-format -msgid "ST_BdPolyFromText" +msgid "ST_Collect" msgstr "" #. Tag: refpurpose #: reference_constructor.xml:8 #, no-c-format msgid "" -"Construct a Polygon given an arbitrary collection of closed " -"linestrings as a MultiLineString Well-Known text representation." +"Creates a GeometryCollection or Multi* geometry from a set of geometries." msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:14 +#. Tag: funcsynopsis +#: reference_constructor.xml:12 #, no-c-format msgid "" -"geometry ST_BdPolyFromText " -"text WKT " -"integer srid" +" geometry ST_Collect " +"geometry g1 " +"geometry g2 geometry ST_Collect geometry[] g1_array geometry " +"ST_Collect geometry set g1field " msgstr "" #. Tag: title -#: reference_constructor.xml:23 reference_constructor.xml:72 -#: reference_constructor.xml:123 reference_constructor.xml:159 -#: reference_constructor.xml:188 reference_constructor.xml:215 -#: reference_constructor.xml:258 reference_constructor.xml:303 -#: reference_constructor.xml:354 reference_constructor.xml:402 -#: reference_constructor.xml:445 reference_constructor.xml:474 -#: reference_constructor.xml:517 reference_constructor.xml:602 -#: reference_constructor.xml:642 reference_constructor.xml:693 -#: reference_constructor.xml:725 reference_constructor.xml:778 -#: reference_constructor.xml:826 reference_constructor.xml:866 -#: reference_constructor.xml:911 reference_constructor.xml:970 -#: reference_constructor.xml:1038 reference_constructor.xml:1098 -#: reference_constructor.xml:1137 reference_constructor.xml:1194 -#: reference_constructor.xml:1271 reference_constructor.xml:1316 -#: reference_constructor.xml:1398 reference_constructor.xml:1441 -#: reference_constructor.xml:1483 reference_constructor.xml:1544 -#: reference_constructor.xml:1605 reference_constructor.xml:1659 -#: reference_constructor.xml:1710 reference_constructor.xml:1753 -#: reference_constructor.xml:1809 reference_constructor.xml:1858 -#: reference_constructor.xml:1912 reference_constructor.xml:1955 -#: reference_constructor.xml:1978 +#: reference_constructor.xml:30 reference_constructor.xml:109 +#: reference_constructor.xml:154 reference_constructor.xml:203 +#: reference_constructor.xml:307 reference_constructor.xml:353 +#: reference_constructor.xml:407 reference_constructor.xml:489 +#: reference_constructor.xml:547 reference_constructor.xml:605 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_constructor.xml:25 +#: reference_constructor.xml:31 #, no-c-format msgid "" -"Construct a Polygon given an arbitrary collection of closed " -"linestrings as a MultiLineString Well-Known text representation." +"Collects geometries into a geometry collection. The result is either a " +"Multi* or a GeometryCollection, depending on whether the input geometries " +"have the same or different types (homogeneous or heterogeneous). The input " +"geometries are left unchanged within the collection." msgstr "" #. Tag: para -#: reference_constructor.xml:30 +#: reference_constructor.xml:38 reference_constructor.xml:208 #, 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." +"Variant 1: accepts two input geometries" msgstr "" #. Tag: para -#: reference_constructor.xml:36 reference_constructor.xml:88 -#: reference_constructor.xml:317 reference_constructor.xml:927 -#: reference_constructor.xml:995 reference_constructor.xml:1061 -#: reference_constructor.xml:1499 reference_constructor.xml:1621 -#: reference_constructor.xml:1923 +#: reference_constructor.xml:39 reference_constructor.xml:209 #, no-c-format -msgid "&sfs_compliant; s3.2.6.2" +msgid "" +"Variant 2: accepts an array of geometries" msgstr "" #. Tag: para -#: reference_constructor.xml:38 reference_constructor.xml:90 -#, no-c-format -msgid "Availability: 1.1.0 - requires GEOS >= 2.1.0." -msgstr "" - -#. Tag: title -#: reference_constructor.xml:42 reference_constructor.xml:94 -#: reference_constructor.xml:135 reference_constructor.xml:165 -#: reference_constructor.xml:230 reference_constructor.xml:267 -#: reference_constructor.xml:324 reference_constructor.xml:368 -#: reference_constructor.xml:416 reference_constructor.xml:486 -#: reference_constructor.xml:614 reference_constructor.xml:746 -#: reference_constructor.xml:794 reference_constructor.xml:836 -#: reference_constructor.xml:874 reference_constructor.xml:934 -#: reference_constructor.xml:1002 reference_constructor.xml:1066 -#: reference_constructor.xml:1106 reference_constructor.xml:1153 -#: reference_constructor.xml:1413 reference_constructor.xml:1448 -#: reference_constructor.xml:1506 reference_constructor.xml:1567 -#: reference_constructor.xml:1628 reference_constructor.xml:1722 -#: reference_constructor.xml:1777 reference_constructor.xml:1827 -#: reference_constructor.xml:1876 reference_constructor.xml:1928 -#, no-c-format -msgid "Examples" -msgstr "" - -#. 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:139 reference_constructor.xml:169 -#: reference_constructor.xml:193 reference_constructor.xml:235 -#: reference_constructor.xml:272 reference_constructor.xml:331 -#: reference_constructor.xml:381 reference_constructor.xml:422 -#: reference_constructor.xml:450 reference_constructor.xml:490 -#: reference_constructor.xml:570 reference_constructor.xml:621 -#: reference_constructor.xml:669 reference_constructor.xml:700 -#: reference_constructor.xml:750 reference_constructor.xml:801 -#: reference_constructor.xml:843 reference_constructor.xml:881 -#: reference_constructor.xml:941 reference_constructor.xml:1009 -#: reference_constructor.xml:1073 reference_constructor.xml:1113 -#: reference_constructor.xml:1160 reference_constructor.xml:1243 -#: reference_constructor.xml:1286 reference_constructor.xml:1350 -#: reference_constructor.xml:1417 reference_constructor.xml:1454 -#: reference_constructor.xml:1513 reference_constructor.xml:1574 -#: reference_constructor.xml:1635 reference_constructor.xml:1686 -#: reference_constructor.xml:1726 reference_constructor.xml:1781 -#: reference_constructor.xml:1834 reference_constructor.xml:1883 -#: reference_constructor.xml:1935 reference_constructor.xml:1959 -#: reference_constructor.xml:1982 +#: reference_constructor.xml:40 #, no-c-format -msgid "See Also" +msgid "" +"Variant 3: aggregate function accepting a " +"rowset of geometries." msgstr "" #. Tag: para -#: reference_constructor.xml:49 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:55 -#, no-c-format -msgid "ST_BdMPolyFromText" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:56 +#: reference_constructor.xml:42 #, no-c-format msgid "" -"Construct a MultiPolygon given an arbitrary collection of closed linestrings " -"as a MultiLineString text representation Well-Known text representation." +"If any of the input geometries are collections (Multi* or " +"GeometryCollection) ST_Collect returns a GeometryCollection (since that is " +"the only type which can contain nested collections). To prevent this, use " +" in a subquery to expand the input collections to " +"their atomic elements (see example below)." msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:63 +#. Tag: para +#: reference_constructor.xml:50 #, no-c-format msgid "" -"geometry ST_BdMPolyFromText " -"text WKT " -"integer srid" +"ST_Collect and appear similar, but in fact " +"operate quite differently. ST_Collect aggregates geometries into a " +"collection without changing them in any way. ST_Union geometrically merges " +"geometries where they overlap, and splits linestrings at intersections. It " +"may return single geometries when it dissolves boundaries." msgstr "" #. Tag: para -#: reference_constructor.xml:74 +#: reference_constructor.xml:57 #, no-c-format msgid "" -"Construct a Polygon given an arbitrary collection of closed linestrings, " -"polygons, MultiLineStrings as Well-Known text representation." +"Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was " +"enhanced to handle more geometries faster." msgstr "" #. Tag: para -#: reference_constructor.xml:79 +#: reference_constructor.xml:58 reference_constructor.xml:115 +#: reference_constructor.xml:220 reference_constructor.xml:321 +#: reference_constructor.xml:421 reference_constructor.xml:564 #, 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 ST_BdPolyFromText if you're sure a " -"single POLYGON will result from operation, or see ST_BuildArea() for a postgis-specific approach." +msgid "&Z_support;" msgstr "" #. Tag: para -#: reference_constructor.xml:101 +#: reference_constructor.xml:59 #, no-c-format -msgid ", " +msgid "&curve_support;" msgstr "" -#. Tag: refname -#: reference_constructor.xml:107 +#. Tag: title +#: reference_constructor.xml:63 #, no-c-format -msgid "ST_Box2dFromGeoHash" +msgid "Examples - Two-input variant" msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:109 +#. Tag: para +#: reference_constructor.xml:64 #, no-c-format -msgid "Return a BOX2D from a GeoHash string." +msgid "Collect 2D points." msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:114 +#. Tag: programlisting +#: reference_constructor.xml:65 #, no-c-format msgid "" -"box2d ST_Box2dFromGeoHash " -"text geohash " -"integer " -"precision=full_precision_of_geohash" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:125 -#, no-c-format -msgid "Return a BOX2D from a GeoHash string." +"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)" msgstr "" #. Tag: para -#: reference_constructor.xml:127 +#: reference_constructor.xml:67 #, no-c-format -msgid "" -"If no precision is specficified ST_Box2dFromGeoHash " -"returns a BOX2D based on full precision of the input GeoHash string." +msgid "Collect 3D points." msgstr "" -#. Tag: para -#: reference_constructor.xml:129 +#. Tag: programlisting +#: reference_constructor.xml:68 #, no-c-format msgid "" -"If precision is specified ST_Box2dFromGeoHash will use " -"that many characters from the GeoHash to create the BOX2D. Lower precision " -"values results in larger BOX2Ds and larger values increase the precision." +"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)" msgstr "" #. Tag: para -#: reference_constructor.xml:131 reference_constructor.xml:482 -#: reference_constructor.xml:1718 +#: reference_constructor.xml:70 #, no-c-format -msgid "Availability: 2.1.0" +msgid "Collect curves." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:136 +#: reference_constructor.xml:71 #, no-c-format msgid "" -"" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:141 -#, no-c-format -msgid "" -", , " +" st_astext\n" +"------------------------------------------------------------------------------------\n" +"MULTICURVE(CIRCULARSTRING(220268 150415,220227 150505,220227 150406),\n" +" CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))" msgstr "" -#. Tag: refname -#: reference_constructor.xml:147 +#. Tag: title +#: reference_constructor.xml:74 #, no-c-format -msgid "ST_GeogFromText" +msgid "Examples - Array variant" msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:148 reference_constructor.xml:177 +#. Tag: para +#: reference_constructor.xml:75 #, no-c-format -msgid "" -"Return a specified geography value from Well-Known Text representation or " -"extended (WKT)." +msgid "Using an array constructor for a subquery." msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:152 +#. Tag: programlisting +#: reference_constructor.xml:76 #, no-c-format -msgid "" -"geography ST_GeogFromText " -"text EWKT" +msgid "SELECT ST_Collect( ARRAY( SELECT the_geom FROM sometable ) );" msgstr "" #. Tag: para -#: reference_constructor.xml:160 +#: reference_constructor.xml:77 #, no-c-format -msgid "" -"Returns a geography object from the well-known text or extended well-known " -"representation. SRID 4326 is assumed if unspecified. This is an alias for " -"ST_GeographyFromText. Points are always expressed in long lat form." +msgid "Using an array constructor for values." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:166 +#: reference_constructor.xml:78 #, 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 || ')');\n" +"SELECT ST_AsText( ST_Collect(\n" +" ARRAY[ ST_GeomFromText('LINESTRING(1 2, 3 4)'),\n" +" ST_GeomFromText('LINESTRING(3 4, 4 5)') ] )) As " +"wktcollect;\n" "\n" -"--- specify a geography point using EPSG:4267, NAD27\n" -"SELECT ST_AsEWKT(ST_GeogFromText('SRID=4267;POINT(-77.0092 38.889588)'));" +"--wkt collect --\n" +"MULTILINESTRING((1 2,3 4),(3 4,4 5))" msgstr "" -#. Tag: para -#: reference_constructor.xml:170 +#. Tag: title +#: reference_constructor.xml:81 #, no-c-format -msgid ", " +msgid "Examples - Aggregate variant" msgstr "" -#. Tag: refname -#: reference_constructor.xml:176 +#. Tag: para +#: reference_constructor.xml:82 #, no-c-format -msgid "ST_GeographyFromText" +msgid "Creating multiple collections by grouping geometries in a table." msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:181 +#. Tag: programlisting +#: reference_constructor.xml:83 #, no-c-format msgid "" -"geography ST_GeographyFromText " -"text EWKT" +"SELECT stusps, ST_Collect(f.the_geom) as geom\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_constructor.xml:189 +#. Tag: title +#: reference_constructor.xml:87 reference_constructor.xml:127 +#: reference_constructor.xml:170 reference_constructor.xml:266 +#: reference_constructor.xml:329 reference_constructor.xml:378 +#: reference_constructor.xml:459 reference_constructor.xml:523 +#: reference_constructor.xml:579 reference_constructor.xml:618 #, no-c-format -msgid "" -"Returns a geography object from the well-known text representation. SRID " -"4326 is assumed if unspecified." +msgid "See Also" msgstr "" #. Tag: para -#: reference_constructor.xml:194 +#: reference_constructor.xml:88 #, no-c-format -msgid ", " +msgid ", " msgstr "" #. Tag: refname -#: reference_constructor.xml:200 +#: reference_constructor.xml:94 #, no-c-format -msgid "ST_GeogFromWKB" +msgid "ST_LineFromMultiPoint" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:201 +#: reference_constructor.xml:96 #, no-c-format msgid "" -"Creates a geography instance from a Well-Known Binary geometry " -"representation (WKB) or extended Well Known Binary (EWKB)." +"Creates a LineString from a MultiPoint geometry." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:207 +#: reference_constructor.xml:101 #, no-c-format msgid "" -"geography ST_GeogFromWKB " -"bytea wkb" +"geometry ST_LineFromMultiPoint " +"geometry aMultiPoint" msgstr "" #. Tag: para -#: reference_constructor.xml:217 +#: reference_constructor.xml:111 #, no-c-format -msgid "" -"The ST_GeogFromWKB 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." +msgid "Creates a LineString from a MultiPoint geometry." msgstr "" #. Tag: para -#: reference_constructor.xml:222 +#: reference_constructor.xml:113 +#, no-c-format +msgid "" +"Use to create lines from Point or LineString " +"inputs." +msgstr "" + +#. Tag: title +#: reference_constructor.xml:120 reference_constructor.xml:325 +#: reference_constructor.xml:364 reference_constructor.xml:569 #, no-c-format -msgid "If SRID is not specified, it defaults to 4326 (WGS 84 long lat)." +msgid "Examples" msgstr "" #. Tag: para -#: reference_constructor.xml:224 reference_constructor.xml:362 -#: reference_constructor.xml:410 reference_constructor.xml:739 -#: reference_constructor.xml:789 reference_constructor.xml:1823 +#: reference_constructor.xml:121 #, no-c-format -msgid "&curve_support;" +msgid "Create a 3D line string from a 3D MultiPoint" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:232 +#: reference_constructor.xml:122 #, 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)" +"SELECT ST_AsEWKT( ST_LineFromMultiPoint('MULTIPOINT(1 2 3, 4 5 6, 7 8 " +"9)') ));\n" +"\n" +"--result--\n" +"LINESTRING(1 2 3,4 5 6,7 8 9)" msgstr "" #. Tag: para -#: reference_constructor.xml:237 +#: reference_constructor.xml:129 #, no-c-format -msgid ", " +msgid ", " msgstr "" #. Tag: refname -#: reference_constructor.xml:243 +#: reference_constructor.xml:135 #, no-c-format -msgid "ST_GeomFromTWKB" +msgid "ST_MakeEnvelope" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:244 +#: reference_constructor.xml:137 #, no-c-format -msgid "" -"Creates a geometry instance from a TWKB (\"Tiny Well-Known Binary\") " -"geometry representation." +msgid "Creates a rectangular Polygon from minimum and maximum coordinates." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:250 +#: reference_constructor.xml:142 #, no-c-format msgid "" -"geometry ST_GeomFromTWKB " -"bytea twkb" +"geometry ST_MakeEnvelope " +"float xmin " +"float ymin " +"float xmax " +"float ymax " +"integer srid=unknown" msgstr "" #. Tag: para -#: reference_constructor.xml:260 +#: reference_constructor.xml:156 #, no-c-format msgid "" -"The ST_GeomFromTWKB function, takes a a TWKB (\"Tiny Well-" -"Known Binary\") geometry representation (WKB) and creates an " -"instance of the appropriate geometry type." +"Creates a rectangular Polygon from the minimum and maximum values for X and " +"Y. Input values must be in the spatial reference system specified by the " +"SRID. If no SRID is specified the unknown spatial reference system (SRID 0) " +"is used." msgstr "" -#. Tag: programlisting -#: reference_constructor.xml:269 +#. Tag: para +#: reference_constructor.xml:160 #, no-c-format -msgid "" -"SELECT ST_AsText(ST_GeomFromTWKB(ST_AsTWKB('LINESTRING(126 34, 127 35)'::" -"geometry)));\n" -"\n" -" st_astext\n" -"-----------------------------\n" -" LINESTRING(126 34, 127 35)\n" -"(1 row)\n" -"\n" -"\n" -"SELECT ST_AsEWKT(\n" -" ST_GeomFromTWKB(E'\\\\x620002f7f40dbce4040105')\n" -");\n" -" st_asewkt\n" -"------------------------------------------------------\n" -"LINESTRING(-113.98 39.198,-113.981 39.195)\n" -"(1 row)" +msgid "Availability: 1.5" msgstr "" -#. Tag: refname -#: reference_constructor.xml:280 +#. Tag: para +#: reference_constructor.xml:161 #, no-c-format -msgid "ST_GeomCollFromText" +msgid "" +"Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was " +"introduced." msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:282 +#. Tag: title +#: reference_constructor.xml:166 #, no-c-format -msgid "" -"Makes a collection Geometry from collection WKT with the given SRID. If SRID " -"is not given, it defaults to 0." +msgid "Example: Building a bounding box polygon" msgstr "" -#. Tag: funcsynopsis -#: reference_constructor.xml:287 +#. Tag: programlisting +#: reference_constructor.xml:167 #, no-c-format msgid "" -" geometry ST_GeomCollFromText text WKT " -"integer srid geometry " -"ST_GeomCollFromText text WKT " +"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 "" #. Tag: para -#: reference_constructor.xml:305 +#: reference_constructor.xml:171 #, no-c-format msgid "" -"Makes a collection Geometry from the Well-Known-Text (WKT) representation " -"with the given SRID. If SRID is not given, it defaults to 0." +", , , " msgstr "" -#. Tag: para -#: reference_constructor.xml:308 reference_constructor.xml:1488 -#: reference_constructor.xml:1549 reference_constructor.xml:1610 -#: reference_constructor.xml:1918 +#. Tag: refname +#: reference_constructor.xml:177 #, no-c-format -msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite" +msgid "ST_MakeLine" msgstr "" -#. Tag: para -#: reference_constructor.xml:310 +#. Tag: refpurpose +#: reference_constructor.xml:179 #, no-c-format -msgid "Returns null if the WKT is not a GEOMETRYCOLLECTION" +msgid "Creates a Linestring from Point, MultiPoint, or LineString geometries." msgstr "" -#. Tag: para -#: reference_constructor.xml:312 +#. Tag: funcsynopsis +#: reference_constructor.xml:183 #, 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." +" geometry ST_MakeLine " +"geometry geom1 " +"geometry geom2 geometry ST_MakeLine geometry[] " +"geoms_array " +" geometry ST_MakeLine " +"geometry set geoms " +"" msgstr "" #. Tag: para -#: reference_constructor.xml:318 -#, no-c-format -msgid "&sqlmm_compliant;" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:326 +#: reference_constructor.xml:205 #, no-c-format msgid "" -"SELECT ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(1 2, 3 " -"4))');" +"Creates a LineString containing the points of Point, MultiPoint, or " +"LineString geometries. Other geometry types cause an error." msgstr "" #. Tag: para -#: reference_constructor.xml:333 reference_constructor.xml:1637 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:340 +#: reference_constructor.xml:210 #, no-c-format -msgid "ST_GeomFromEWKB" +msgid "" +"Variant 3: aggregate function accepting a " +"rowset of geometries. To ensure the order of the input geometries use " +"ORDER BY in the function call, or a subquery with an " +"ORDER BY clause." msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:341 +#. Tag: para +#: reference_constructor.xml:214 #, no-c-format msgid "" -"Return a specified ST_Geometry value from Extended Well-Known Binary " -"representation (EWKB)." +"Repeated nodes at the beginning of input LineStrings are collapsed to a " +"single point. Repeated points in Point and MultiPoint inputs are not " +"collapsed. can be used to " +"collapse repeated points from the output LineString." msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:346 +#. Tag: para +#: reference_constructor.xml:222 #, no-c-format msgid "" -"geometry ST_GeomFromEWKB " -"bytea EWKB" +"Availability: 2.3.0 - Support for multipoint input elements was introduced" msgstr "" #. Tag: para -#: reference_constructor.xml:355 +#: reference_constructor.xml:223 #, no-c-format msgid "" -"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known " -"binary (EWKT) representation." +"Availability: 2.0.0 - Support for linestring input elements was introduced" msgstr "" #. Tag: para -#: reference_constructor.xml:357 +#: reference_constructor.xml:224 #, 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" +"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:360 reference_constructor.xml:408 -#: reference_constructor.xml:537 reference_constructor.xml:696 +#. Tag: title +#: reference_constructor.xml:229 #, no-c-format -msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced." +msgid "Examples: Two-input variant" msgstr "" #. Tag: para -#: reference_constructor.xml:361 reference_constructor.xml:409 -#: reference_constructor.xml:539 reference_constructor.xml:610 -#: reference_constructor.xml:656 reference_constructor.xml:869 -#: reference_constructor.xml:1208 reference_constructor.xml:1328 -#: reference_constructor.xml:1408 reference_constructor.xml:1822 -#: reference_constructor.xml:1870 +#: reference_constructor.xml:231 #, no-c-format -msgid "&Z_support;" +msgid "Create a line composed of two points." msgstr "" -#. Tag: para -#: reference_constructor.xml:363 reference_constructor.xml:411 -#: reference_constructor.xml:540 +#. Tag: programlisting +#: reference_constructor.xml:232 #, no-c-format -msgid "&P_support;" +msgid "" +"SELECT ST_AsText( ST_MakeLine(ST_MakePoint(1,2), ST_MakePoint(3,4)) );\n" +"\n" +" st_astext\n" +"---------------------\n" +" LINESTRING(1 2,3 4)" msgstr "" #. Tag: para -#: reference_constructor.xml:364 reference_constructor.xml:412 -#: reference_constructor.xml:541 +#: reference_constructor.xml:234 #, no-c-format -msgid "&T_support;" +msgid "Create a 3D line from two 3D points." msgstr "" -#. Tag: para -#: reference_constructor.xml:369 +#. Tag: programlisting +#: reference_constructor.xml:235 #, 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)." +"SELECT ST_AsEWKT( ST_MakeLine(ST_MakePoint(1,2,3), ST_MakePoint(3,4,5) ));\n" +"\n" +" st_asewkt\n" +"-------------------------\n" +" LINESTRING(1 2 3,3 4 5)" msgstr "" #. Tag: para -#: reference_constructor.xml:371 +#: reference_constructor.xml:237 #, 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." +msgid "Create a line from two disjoint LineStrings." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:373 +#: reference_constructor.xml:238 #, 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@');" +"select ST_AsText( ST_MakeLine( 'LINESTRING(0 0, 1 1)', 'LINESTRING(2 2, 3 " +"3)' ) );\n" +"\n" +" st_astext\n" +"-----------------------------\n" +" LINESTRING(0 0,1 1,2 2,3 3)" +msgstr "" + +#. Tag: title +#: reference_constructor.xml:242 +#, no-c-format +msgid "Examples: Array variant" msgstr "" #. Tag: para -#: reference_constructor.xml:375 +#: reference_constructor.xml:244 #, 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 off. 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" +msgid "Create a line from an array formed by a subquery with ordering." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:378 +#: reference_constructor.xml:245 #, 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')" +"SELECT ST_MakeLine( ARRAY( SELECT ST_Centroid(the_geom) FROM visit_locations " +"ORDER BY visit_time) );" msgstr "" #. Tag: para -#: reference_constructor.xml:382 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:388 +#: reference_constructor.xml:247 #, no-c-format -msgid "ST_GeomFromEWKT" +msgid "Create a 3D line from an array of 3D points" msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:389 +#. Tag: programlisting +#: reference_constructor.xml:248 #, no-c-format msgid "" -"Return a specified ST_Geometry value from Extended Well-Known Text " -"representation (EWKT)." +"SELECT ST_AsEWKT( ST_MakeLine(\n" +" ARRAY[ ST_MakePoint(1,2,3), ST_MakePoint(3,4,5), " +"ST_MakePoint(6,6,6) ] ));\n" +"\n" +" st_asewkt\n" +"-------------------------\n" +"LINESTRING(1 2 3,3 4 5,6 6 6)" msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:394 +#. Tag: title +#: reference_constructor.xml:252 #, no-c-format -msgid "" -"geometry ST_GeomFromEWKT " -"text EWKT" +msgid "Examples: Aggregate variant" msgstr "" #. Tag: para -#: reference_constructor.xml:403 +#: reference_constructor.xml:253 #, no-c-format msgid "" -"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known " -"text (EWKT) representation." +"This example queries time-based sequences of GPS points from a set of tracks " +"and creates one record for each track. The result geometries are LineStrings " +"composed of the GPS track points in the order of travel." msgstr "" #. Tag: para -#: reference_constructor.xml:405 +#: reference_constructor.xml:257 #, 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" +"Using aggregate ORDER BY provides a correctly-ordered " +"linestring." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:417 +#: reference_constructor.xml:258 #, 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)))');" +"SELECT gps.track_id, ST_MakeLine(gps.geom ORDER BY gps_time) As geom\n" +" FROM gps_points As gps\n" +" GROUP BY track_id;" msgstr "" -#. Tag: programlisting -#: reference_constructor.xml:418 +#. Tag: para +#: reference_constructor.xml:260 #, no-c-format msgid "" -"--3d circular string\n" -"SELECT ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " -"2,220227 150406 3)');" +"Prior to PostgreSQL 9, ordering in a subquery can be used. However, " +"sometimes the query plan may not respect the order of the subquery." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:419 +#: reference_constructor.xml:262 #, 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" -")');" +"SELECT gps.track_id, ST_MakeLine(gps.geom) As geom\n" +" FROM ( SELECT track_id, gps_time, geom\n" +" FROM gps_points ORDER BY track_id, gps_time ) As " +"gps\n" +" GROUP BY track_id;" msgstr "" #. Tag: para -#: reference_constructor.xml:423 +#: reference_constructor.xml:267 #, no-c-format msgid "" -", , " +", , , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:428 +#: reference_constructor.xml:274 #, no-c-format -msgid "ST_GeometryFromText" +msgid "ST_MakePoint" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:429 reference_constructor.xml:1967 +#: reference_constructor.xml:276 #, no-c-format -msgid "" -"Return a specified ST_Geometry value from Well-Known Text representation " -"(WKT). This is an alias name for ST_GeomFromText" +msgid "Creates a 2D, 3DZ or 4D Point." msgstr "" -#. Tag: funcsynopsis -#: reference_constructor.xml:432 +#. Tag: funcprototype +#: reference_constructor.xml:281 #, no-c-format msgid "" -" geometry ST_GeometryFromText text WKT " -" geometry " -"ST_GeometryFromText text WKT integer " -"srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:446 reference_constructor.xml:1868 -#, no-c-format -msgid "&sfs_compliant;" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:447 reference_constructor.xml:738 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.40" +"geometry ST_MakePoint " +"float x " +"float y" msgstr "" -#. Tag: refname -#: reference_constructor.xml:458 +#. Tag: funcprototype +#: reference_constructor.xml:288 #, no-c-format -msgid "ST_GeomFromGeoHash" +msgid "" +"geometry ST_MakePoint " +"float x " +"float y " +"float z" msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:460 +#. Tag: funcprototype +#: reference_constructor.xml:296 #, no-c-format -msgid "Return a geometry from a GeoHash string." +msgid "" +"geometry ST_MakePoint " +"float x " +"float y " +"float z " +"float m" msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:465 +#. Tag: para +#: reference_constructor.xml:309 #, no-c-format -msgid "" -"geometry ST_GeomFromGeoHash " -"text geohash " -"integer " -"precision=full_precision_of_geohash" +msgid "Creates a 2D, 3D Z or 4D ZM Point geometry." msgstr "" #. Tag: para -#: reference_constructor.xml:476 +#: reference_constructor.xml:311 #, no-c-format msgid "" -"Return a geometry from a GeoHash string. The geometry will be a polygon " -"representing the GeoHash bounds." +"Use to make points with XYM coordinates." msgstr "" #. Tag: para -#: reference_constructor.xml:478 +#: reference_constructor.xml:313 #, no-c-format msgid "" -"If no precision is specified ST_GeomFromGeoHash returns a " -"polygon based on full precision of the input GeoHash string." +"While not OGC-compliant, ST_MakePoint is faster and more " +"precise than and . It is also easier to use for numeric coordinate " +"values." msgstr "" #. Tag: para -#: reference_constructor.xml:480 +#: reference_constructor.xml:319 reference_constructor.xml:359 +#: reference_constructor.xml:493 #, no-c-format msgid "" -"If precision is specified ST_GeomFromGeoHash will use " -"that many characters from the GeoHash to create the polygon." +"For geodetic coordinates, X is longitude and Y is latitude" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:487 +#: reference_constructor.xml:326 #, no-c-format msgid "" -"" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:492 -#, no-c-format -msgid "" -",, " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:498 -#, no-c-format -msgid "ST_GeomFromGML" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:499 -#, no-c-format -msgid "" -"Takes as input GML representation of geometry and outputs a PostGIS geometry " -"object" -msgstr "" - -#. Tag: funcsynopsis -#: reference_constructor.xml:503 -#, no-c-format -msgid "" -" geometry ST_GeomFromGML text geomgml geometry " -"ST_GeomFromGML text " -"geomgml integer " -"srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:518 -#, no-c-format -msgid "" -"Constructs a PostGIS ST_Geometry object from the OGC GML representation." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:519 -#, 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:520 -#, no-c-format -msgid "" -"OGC GML versions supported: GML 3.2.1 " -"Namespace GML 3.1.1 Simple Features " -"profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility) GML 2.1.2 OGC " -"GML standards, cf: http://www.opengeospatial.org/standards/gml:" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:536 reference_constructor.xml:695 -#, no-c-format -msgid "Availability: 1.5, requires libxml2 1.6+" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:538 reference_constructor.xml:697 -#, no-c-format -msgid "Enhanced: 2.0.0 default srid optional parameter added." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:542 -#, 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:544 -#, 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:546 -#, 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:548 -#, no-c-format -msgid "ST_GeomFromGML function not support SQL/MM curves geometries." -msgstr "" - -#. Tag: title -#: reference_constructor.xml:554 reference_constructor.xml:664 -#, no-c-format -msgid "Examples - A single geometry with srsName" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:555 -#, no-c-format -msgid "" -"SELECT ST_GeomFromGML('\n" -" \n" -" -71.16028,42.258729 -71.160837,42.259112 " -"-71.161143,42.25932\n" -" \n" -" ']]>);" -msgstr "" - -#. Tag: title -#: reference_constructor.xml:559 -#, no-c-format -msgid "Examples - XLink usage" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:560 -#, no-c-format -msgid "" -"SELECT \n" -" \n" -" 42.258729 " -"-71.16028\n" -" \n" -" 42.259112 -71.160837\n" -" \n" -" \n" -" \n" -" ');]]>);" -msgstr "" - -#. Tag: title -#: reference_constructor.xml:564 -#, no-c-format -msgid "Examples - Polyhedral Surface" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:565 -#, no-c-format -msgid "" -"SELECT ST_AsEWKT(\n" -"\n" -" \n" -" \n" -" 0 0 0 0 0 1 0 1 1 0 1 " -"0 0 0 0\n" -" \n" -" \n" -" \n" -" \n" -" 0 0 0 0 1 0 1 1 0 1 " -"0 0 0 0 0\n" -" \n" -" \n" -" \n" -" \n" -" 0 0 0 1 0 0 1 0 1 0 " -"0 1 0 0 0\n" -" \n" -" \n" -" \n" -" \n" -" 1 1 0 1 1 1 1 0 1 1 " -"0 0 1 1 0\n" -" \n" -" \n" -" \n" -" \n" -" 0 1 0 0 1 1 1 1 1 1 " -"1 0 0 1 0\n" -" \n" -" \n" -" \n" -" \n" -" 0 0 1 1 0 1 1 1 1 0 " -"1 1 0 0 1\n" -" \n" -" \n" -"\n" -"']]>));\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:571 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:577 -#, no-c-format -msgid "ST_GeomFromGeoJSON" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:578 -#, no-c-format -msgid "" -"Takes as input a geojson representation of a geometry and outputs a PostGIS " -"geometry object" -msgstr "" - -#. Tag: funcsynopsis -#: reference_constructor.xml:582 -#, no-c-format -msgid "" -" geometry ST_GeomFromGeoJSON text geomjson geometry " -"ST_GeomFromGeoJSON json geomjson " -" geometry ST_GeomFromGeoJSON jsonb geomjson " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:603 -#, no-c-format -msgid "Constructs a PostGIS geometry object from the GeoJSON representation." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:604 -#, 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:606 -#, no-c-format -msgid "Enhanced: 2.5.0 can now accept json and jsonb as inputs." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:607 -#, no-c-format -msgid "Availability: 2.0.0 requires - JSON-C >= 0.9" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:608 -#, 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 for " -"details." -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:615 -#, 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 "" - -#. Tag: programlisting -#: reference_constructor.xml:616 -#, 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:622 -#, no-c-format -msgid "" -", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:628 -#, no-c-format -msgid "ST_GeomFromKML" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:629 -#, no-c-format -msgid "" -"Takes as input KML representation of geometry and outputs a PostGIS geometry " -"object" -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:634 -#, no-c-format -msgid "" -"geometry ST_GeomFromKML " -"text geomkml" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:643 -#, no-c-format -msgid "" -"Constructs a PostGIS ST_Geometry object from the OGC KML representation." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:644 -#, 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:645 -#, no-c-format -msgid "" -"OGC KML versions supported: KML 2.2.0 " -"Namespace OGC KML standards, cf: http://www." -"opengeospatial.org/standards/kml:" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:655 -#, no-c-format -msgid "Availability: 1.5,libxml2 2.6+" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:658 -#, no-c-format -msgid "ST_GeomFromKML function not support SQL/MM curves geometries." -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:665 -#, no-c-format -msgid "" -"SELECT ST_GeomFromKML('\n" -" -71.1663,42.2614\n" -" -71.1667,42.2616\n" -" ']]>);" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:670 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:676 -#, no-c-format -msgid "ST_GMLToSQL" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:677 -#, 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:680 -#, no-c-format -msgid "" -" geometry ST_GMLToSQL " -"text geomgml geometry ST_GMLToSQL text geomgml integer srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:694 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support)." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:701 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:707 -#, no-c-format -msgid "ST_GeomFromText" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:708 -#, no-c-format -msgid "" -"Return a specified ST_Geometry value from Well-Known Text representation " -"(WKT)." -msgstr "" - -#. Tag: funcsynopsis -#: reference_constructor.xml:711 -#, no-c-format -msgid "" -" geometry ST_GeomFromText text WKT " -" geometry " -"ST_GeomFromText text " -"WKT integer " -"srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:727 -#, no-c-format -msgid "" -"Constructs a PostGIS ST_Geometry object from the OGC Well-Known text " -"representation." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:731 -#, no-c-format -msgid "" -"There are two variants of ST_GeomFromText function. The first takes no SRID " -"and returns a geometry with no defined spatial reference system (SRID=0). " -"The second takes a SRID as the second argument and returns a geometry that " -"includes this SRID as part of its metadata." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:737 reference_constructor.xml:1772 -#, no-c-format -msgid "&sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:740 -#, 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:747 -#, 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 "" - -#. Tag: para -#: reference_constructor.xml:751 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:757 -#, no-c-format -msgid "ST_GeomFromWKB" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:758 -#, 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:763 reference_constructor.xml:1794 -#, no-c-format -msgid "" -" geometry ST_GeomFromWKB bytea geom geometry " -"ST_GeomFromWKB bytea " -"geom integer " -"srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:780 -#, no-c-format -msgid "" -"The ST_GeomFromWKB function, takes a well-known binary " -"representation of a geometry and a Spatial Reference System ID " -"(SRID) 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:786 -#, no-c-format -msgid "If SRID is not specified, it defaults to 0 (Unknown)." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:787 -#, no-c-format -msgid "" -"&sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:788 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.41" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:796 -#, 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:803 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:810 -#, no-c-format -msgid "ST_LineFromEncodedPolyline" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:812 -#, no-c-format -msgid "Creates a LineString from an Encoded Polyline." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:817 -#, no-c-format -msgid "" -"geometry ST_LineFromEncodedPolyline " -"text polyline " -"integer precision=5" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:828 -#, no-c-format -msgid "Creates a LineString from an Encoded Polyline string." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:829 -#, no-c-format -msgid "" -"Optional precision specifies how many decimal places will " -"be preserved in Encoded Polyline. Value should be the same on encoding and " -"decoding, or coordinates will be incorrect." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:831 -#, no-c-format -msgid "" -"See http://developers.google.com/maps/documentation/utilities/" -"polylinealgorithm" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:832 -#, no-c-format -msgid "Availability: 2.2.0" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:838 -#, no-c-format -msgid "" -"-- Create a line string from a polyline\n" -"SELECT ST_AsEWKT(ST_LineFromEncodedPolyline('_p~iF~ps|" -"U_ulLnnqC_mqNvxq`@'));\n" -"-- result --\n" -"SRID=4326;LINESTRING(-120.2 38.5,-120.95 40.7,-126.453 43.252)\n" -"\n" -"-- Select different precision that was used for polyline encoding\n" -"SELECT ST_AsEWKT(ST_LineFromEncodedPolyline('_p~iF~ps|" -"U_ulLnnqC_mqNvxq`@',6));\n" -"-- result --\n" -"SRID=4326;LINESTRING(-12.02 3.85,-12.095 4.07,-12.6453 4.3252)" -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:851 -#, no-c-format -msgid "ST_LineFromMultiPoint" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:853 -#, no-c-format -msgid "" -"Creates a LineString from a MultiPoint geometry." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:858 -#, no-c-format -msgid "" -"geometry ST_LineFromMultiPoint " -"geometry aMultiPoint" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:868 -#, no-c-format -msgid "Creates a LineString from a MultiPoint geometry." -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:876 -#, 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:883 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:889 -#, no-c-format -msgid "ST_LineFromText" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:891 -#, no-c-format -msgid "" -"Makes a Geometry from WKT representation with the given SRID. If SRID is not " -"given, it defaults to 0." -msgstr "" - -#. Tag: funcsynopsis -#: reference_constructor.xml:896 -#, no-c-format -msgid "" -" geometry ST_LineFromText text WKT " -" geometry " -"ST_LineFromText text " -"WKT integer " -"srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:913 -#, no-c-format -msgid "" -"Makes a Geometry from WKT with the given SRID. If SRID is not given, it " -"defaults to 0. If WKT passed in is not a LINESTRING, then null is returned." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:917 reference_constructor.xml:983 -#, no-c-format -msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:922 -#, 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:928 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 7.2.8" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:936 -#, 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 "" - -#. Tag: refname -#: reference_constructor.xml:949 -#, no-c-format -msgid "ST_LineFromWKB" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:951 -#, no-c-format -msgid "Makes a LINESTRING from WKB with the given SRID" -msgstr "" - -#. Tag: funcsynopsis -#: reference_constructor.xml:955 -#, no-c-format -msgid "" -" geometry ST_LineFromWKB bytea WKB " -" geometry ST_LineFromWKB bytea WKB integer srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:972 -#, no-c-format -msgid "" -"The ST_LineFromWKB function, takes a well-known binary " -"representation of geometry and a Spatial Reference System ID (SRID) and creates an instance of the appropriate geometry type - in this " -"case, a LINESTRING geometry. This function plays the role " -"of the Geometry Factory in SQL." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:978 -#, no-c-format -msgid "" -"If an SRID is not specified, it defaults to 0. NULL is " -"returned if the input bytea does not represent a " -"LINESTRING." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:988 -#, no-c-format -msgid "" -"If you know all your geometries are LINESTRINGs, its more " -"efficient to just use . This function just " -"calls and adds additional validation that " -"it returns a linestring." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:996 reference_constructor.xml:1062 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 7.2.9" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1004 -#, 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 "" - -#. Tag: para -#: reference_constructor.xml:1011 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1017 -#, no-c-format -msgid "ST_LinestringFromWKB" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1019 -#, no-c-format -msgid "Makes a geometry from WKB with the given SRID." -msgstr "" - -#. Tag: funcsynopsis -#: reference_constructor.xml:1023 -#, no-c-format -msgid "" -" geometry ST_LinestringFromWKB bytea WKB " -" geometry " -"ST_LinestringFromWKB bytea WKB integer " -"srid " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1040 -#, no-c-format -msgid "" -"The ST_LinestringFromWKB function, takes a well-known " -"binary representation of geometry and a Spatial Reference System ID " -"(SRID) and creates an instance of the appropriate " -"geometry type - in this case, a LINESTRING geometry. This " -"function plays the role of the Geometry Factory in SQL." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1046 -#, no-c-format -msgid "" -"If an SRID is not specified, it defaults to 0. NULL is " -"returned if the input bytea does not represent a " -"LINESTRING geometry. This an alias for ." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1051 -#, no-c-format -msgid "OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1055 -#, no-c-format -msgid "" -"If you know all your geometries are LINESTRINGs, it's " -"more efficient to just use . This function " -"just calls and adds additional validation " -"that it returns a LINESTRING." -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1068 -#, 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 "" - -#. Tag: para -#: reference_constructor.xml:1075 reference_constructor.xml:1836 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1081 -#, no-c-format -msgid "ST_MakeBox2D" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1083 -#, no-c-format -msgid "Creates a BOX2D defined by the given point geometries." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1089 -#, no-c-format -msgid "" -"box2d ST_MakeBox2D " -"geometry pointLowLeft geometry pointUpRight" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1100 -#, 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:1108 -#, 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:1115 -#, no-c-format -msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1121 -#, no-c-format -msgid "ST_3DMakeBox" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1123 -#, no-c-format -msgid "Creates a BOX3D defined by the given 3d point geometries." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1128 -#, no-c-format -msgid "" -"box3d ST_3DMakeBox " -"geometry point3DLowLeftBottom geometry " -"point3DUpRightTop" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1139 -#, no-c-format -msgid "Creates a BOX3D defined by the given 2 3D point geometries." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1146 -#, no-c-format -msgid "This function supports 3d and will not drop the z-index." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1148 -#, no-c-format -msgid "Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1155 -#, 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 "" - -#. Tag: para -#: reference_constructor.xml:1162 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1168 -#, no-c-format -msgid "ST_MakeLine" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1170 -#, no-c-format -msgid "Creates a Linestring from point, multipoint, or line geometries." -msgstr "" - -#. Tag: funcsynopsis -#: reference_constructor.xml:1174 -#, no-c-format -msgid "" -" geometry ST_MakeLine " -"geometry set geoms " -" geometry ST_MakeLine geometry geom1 geometry geom2 geometry " -"ST_MakeLine geometry[] " -"geoms_array " -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1196 -#, no-c-format -msgid "" -"ST_MakeLine comes in 3 forms: a spatial aggregate that takes rows of point, " -"multipoint, or line geometries and returns a line string, a function that " -"takes an array of point, multipoint, or line, and a regular function that " -"takes two point, multipoint, 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:1203 -#, no-c-format -msgid "Inputs other than point, multipoint, or lines are ignored." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1204 -#, no-c-format -msgid "" -"When adding line components common nodes at the beginning of lines are " -"removed from the output. Common nodes in point and multipoint inputs are not " -"removed." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1210 -#, no-c-format -msgid "" -"Availability: 2.3.0 - Support for multipoint input elements was introduced" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1211 -#, no-c-format -msgid "" -"Availability: 2.0.0 - Support for linestring input elements was introduced" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1212 -#, 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: title -#: reference_constructor.xml:1217 -#, no-c-format -msgid "Examples: Spatial Aggregate version" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1218 -#, 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:1222 -#, 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:1224 -#, 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:1227 -#, no-c-format -msgid "Examples: Non-Spatial Aggregate version" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1229 -#, 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:1231 -#, 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 "" - -#. Tag: title -#: reference_constructor.xml:1235 -#, no-c-format -msgid "Examples: Using Array version" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1237 -#, 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 "" - -#. Tag: para -#: reference_constructor.xml:1244 -#, no-c-format -msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1251 -#, no-c-format -msgid "ST_MakeEnvelope" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1253 -#, 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:1259 -#, no-c-format -msgid "" -"geometry ST_MakeEnvelope " -"double precision xmin double precision ymin double precision " -"xmax double precision ymax integer srid=unknown" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1273 -#, 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:1276 -#, no-c-format -msgid "Availability: 1.5" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1277 -#, no-c-format -msgid "" -"Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was " -"introduced." -msgstr "" - -#. Tag: title -#: reference_constructor.xml:1282 -#, no-c-format -msgid "Example: Building a bounding box polygon" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1283 -#, 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 "" - -#. Tag: para -#: reference_constructor.xml:1287 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1293 -#, no-c-format -msgid "ST_MakePolygon" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1295 -#, no-c-format -msgid "" -"Creates a Polygon formed by the given shell. Input geometries must be closed " -"LINESTRINGS." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1301 -#, no-c-format -msgid "" -"geometry ST_MakePolygon " -"geometry linestring" -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1307 -#, no-c-format -msgid "" -"geometry ST_MakePolygon " -"geometry outerlinestring geometry[] interiorlinestrings" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1318 -#, 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:1320 -#, no-c-format -msgid "Variant 1: Takes one closed linestring." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1321 -#, 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:1325 -#, no-c-format -msgid "" -"This function will not accept a MULTILINESTRING. Use or to generate line strings." -msgstr "" - -#. Tag: title -#: reference_constructor.xml:1332 -#, no-c-format -msgid "Examples: Single closed LINESTRING" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1333 -#, 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:1336 -#, no-c-format -msgid "Examples: Outer shell with inner shells" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1338 -#, no-c-format -msgid "Build a donut with an ant hole" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1339 -#, 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 "" - -#. Tag: para -#: reference_constructor.xml:1340 -#, no-c-format -msgid "" -"Build province boundaries with holes representing lakes in the province from " -"a set of province polygons/multipolygons and water linestrings. This is an " -"example of using PostGIS ST_Accum." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1344 -#, no-c-format -msgid "" -"The CASE construct is used because feeding a null array into ST_MakePolygon " -"results in NULL." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1346 -#, no-c-format -msgid "" -"A left join is used to guarantee we get all provinces back even if they have " -"no lakes." -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1347 -#, 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:1351 -#, no-c-format -msgid "" -", , , , , , " -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1365 -#, no-c-format -msgid "ST_MakePoint" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1367 -#, no-c-format -msgid "Creates a 2D, 3DZ or 4D point geometry." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1372 -#, no-c-format -msgid "" -"geometry ST_MakePoint " -"double precision x " -"double precision y" -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1379 -#, no-c-format -msgid "" -"geometry ST_MakePoint " -"double precision x " -"double precision y " -"double precision z" -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1387 -#, no-c-format -msgid "" -"geometry ST_MakePoint " -"double precision x " -"double precision y " -"double precision z " -"double precision m" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1400 -#, no-c-format -msgid "" -"Creates a 2D, 3DZ or 4D point geometry (geometry with measure). " -"ST_MakePoint while not being OGC compliant is generally " -"faster and more precise than and . It is also easier to use if you have raw " -"coordinates rather than WKT." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1406 -#, no-c-format -msgid "Note x is longitude and y is latitude" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1407 -#, no-c-format -msgid "" -"Use if you need to make a point with x, y " -"and m." -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1414 -#, 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:1418 -#, no-c-format -msgid "" -", , , " -"" -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1424 -#, no-c-format -msgid "ST_MakePointM" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1426 -#, no-c-format -msgid "Creates a point geometry with an x y and m coordinate." -msgstr "" - -#. Tag: funcprototype -#: reference_constructor.xml:1431 -#, no-c-format -msgid "" -"geometry ST_MakePointM " -"float x " -"float y " -"float m" -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1443 -#, no-c-format -msgid "Creates a point with x, y and measure coordinates." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1444 -#, no-c-format -msgid "Note x is longitude and y is latitude." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1449 -#, 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:1451 -#, 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" +"--Return point with unknown SRID\n" +"SELECT ST_MakePoint(-71.1043443253471, 42.3150676015829);\n" "\n" -" st_asewkt\n" -"---------------------------------------------------------\n" -"SRID=4326;POINTM(-71.1043443253471 42.3150676015829 10)\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" +"--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" +"--Get z of point\n" +"SELECT ST_Z(ST_MakePoint(1, 2,1.5));\n" "result\n" "-------\n" -"10" +"1.5" msgstr "" #. Tag: para -#: reference_constructor.xml:1455 +#: reference_constructor.xml:330 #, no-c-format -msgid ", , " +msgid "" +", , , " +"" msgstr "" #. Tag: refname -#: reference_constructor.xml:1461 +#: reference_constructor.xml:336 #, no-c-format -msgid "ST_MLineFromText" +msgid "ST_MakePointM" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1463 +#: reference_constructor.xml:338 #, no-c-format -msgid "Return a specified ST_MultiLineString value from WKT representation." +msgid "Creates a Point from X, Y and M values." msgstr "" -#. Tag: funcsynopsis -#: reference_constructor.xml:1467 +#. Tag: funcprototype +#: reference_constructor.xml:343 #, no-c-format msgid "" -" geometry ST_MLineFromText text WKT " -"integer srid geometry ST_MLineFromText text WKT " +"geometry ST_MakePointM " +"float x " +"float y " +"float m" msgstr "" #. Tag: para -#: reference_constructor.xml:1485 +#: reference_constructor.xml:355 #, no-c-format -msgid "" -"Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is " -"not given, it defaults to 0." +msgid "Creates a point with X, Y and M (measure) coordinates." msgstr "" #. Tag: para -#: reference_constructor.xml:1491 +#: reference_constructor.xml:357 #, no-c-format -msgid "Returns null if the WKT is not a MULTILINESTRING" +msgid "" +"Use to make points with XY, XYZ, or XYZM " +"coordinates." msgstr "" #. Tag: para -#: reference_constructor.xml:1494 reference_constructor.xml:1555 +#: reference_constructor.xml:365 #, 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." +"is used for text output because does not " +"support M values." msgstr "" #. Tag: para -#: reference_constructor.xml:1500 +#: reference_constructor.xml:368 #, no-c-format -msgid "&sqlmm_compliant;SQL-MM 3: 9.4.4" +msgid "Create point with unknown SRID." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1508 -#, no-c-format -msgid "SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');" -msgstr "" - -#. Tag: refname -#: reference_constructor.xml:1521 -#, no-c-format -msgid "ST_MPointFromText" -msgstr "" - -#. Tag: refpurpose -#: reference_constructor.xml:1523 reference_constructor.xml:1893 +#: reference_constructor.xml:369 #, no-c-format msgid "" -"Makes a Geometry from WKT with the given SRID. If SRID is not " -"given, it defaults to 0." +"SELECT ST_AsEWKT( ST_MakePointM(-71.1043443253471, 42.3150676015829, " +"10) );\n" +"\n" +" st_asewkt\n" +"-----------------------------------------------\n" +" POINTM(-71.1043443253471 42.3150676015829 10)" msgstr "" -#. Tag: funcsynopsis -#: reference_constructor.xml:1528 +#. Tag: para +#: reference_constructor.xml:371 #, no-c-format -msgid "" -" geometry ST_MPointFromText text WKT " -"integer srid geometry " -"ST_MPointFromText text WKT " +msgid "Create point with a measure in the WGS 84 geodetic coordinate system." msgstr "" -#. Tag: para -#: reference_constructor.xml:1546 +#. Tag: programlisting +#: reference_constructor.xml:372 #, no-c-format msgid "" -"Makes a Geometry from WKT with the given SRID. If SRID is not given, " -"it defaults to 0." +"SELECT ST_AsEWKT( ST_SetSRID( ST_MakePointM(-71.104, 42.315, 10), 4326));\n" +"\n" +" st_asewkt\n" +"---------------------------------------------------------\n" +"SRID=4326;POINTM(-71.104 42.315 10)" msgstr "" #. Tag: para -#: reference_constructor.xml:1552 +#: reference_constructor.xml:374 #, no-c-format -msgid "Returns null if the WKT is not a MULTIPOINT" +msgid "Get measure of created point." msgstr "" -#. Tag: para -#: reference_constructor.xml:1560 +#. Tag: programlisting +#: reference_constructor.xml:375 #, no-c-format -msgid "&sfs_compliant; 3.2.6.2" +msgid "" +"SELECT ST_M( ST_MakePointM(-71.104, 42.315, 10) );\n" +"\n" +"result\n" +"-------\n" +"10" msgstr "" #. Tag: para -#: reference_constructor.xml:1561 +#: reference_constructor.xml:379 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 9.2.4" +msgid ", , " msgstr "" -#. Tag: programlisting -#: reference_constructor.xml:1569 +#. Tag: refname +#: reference_constructor.xml:385 #, 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);" +msgid "ST_MakePolygon" msgstr "" -#. Tag: refname -#: reference_constructor.xml:1582 +#. Tag: refpurpose +#: reference_constructor.xml:387 #, no-c-format -msgid "ST_MPolyFromText" +msgid "Creates a Polygon from a shell and optional list of holes." msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:1584 +#. Tag: funcprototype +#: reference_constructor.xml:392 #, no-c-format msgid "" -"Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not " -"given, it defaults to 0." +"geometry ST_MakePolygon " +"geometry linestring" msgstr "" -#. Tag: funcsynopsis -#: reference_constructor.xml:1589 +#. Tag: funcprototype +#: reference_constructor.xml:398 #, no-c-format msgid "" -" geometry ST_MPolyFromText text WKT " -"integer srid geometry ST_MPolyFromText text WKT " +"geometry ST_MakePolygon " +"geometry outerlinestring geometry[] interiorlinestrings" msgstr "" #. Tag: para -#: reference_constructor.xml:1607 +#: reference_constructor.xml:409 #, no-c-format msgid "" -"Makes a MultiPolygon from WKT with the given SRID. If SRID is not given, it " -"defaults to 0." +"Creates a Polygon formed by the given shell and optional array of holes. " +"Input geometries must be closed LineStrings (rings)." msgstr "" #. Tag: para -#: reference_constructor.xml:1613 +#: reference_constructor.xml:412 #, no-c-format -msgid "Throws an error if the WKT is not a MULTIPOLYGON" +msgid "" +"Variant 1: Accepts one shell LineString." msgstr "" #. Tag: para -#: reference_constructor.xml:1616 +#: reference_constructor.xml:413 #, 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." +"Variant 2: Accepts a shell LineString and " +"an array of inner (hole) LineStrings. A geometry array can be constructed " +"using the PostgreSQL array_agg(), ARRAY[] or ARRAY() constructs." msgstr "" #. Tag: para -#: reference_constructor.xml:1622 +#: reference_constructor.xml:417 reference_constructor.xml:558 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 9.6.4" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1630 -#, 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);" +msgid "" +"This function does not accept MultiLineStrings. Use to generate a LineString, or " +"to extract LineStrings." msgstr "" -#. Tag: refname -#: reference_constructor.xml:1643 +#. Tag: title +#: reference_constructor.xml:425 #, no-c-format -msgid "ST_Point" +msgid "Examples: Single input variant" msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:1645 +#. Tag: para +#: reference_constructor.xml:426 #, no-c-format -msgid "" -"Returns an ST_Point with the given coordinate values. OGC alias for " -"ST_MakePoint." +msgid "Create a Polygon from a 2D LineString." msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:1650 +#. Tag: programlisting +#: reference_constructor.xml:427 #, no-c-format msgid "" -"geometry ST_Point " -"float x_lon " -"float y_lat" +"SELECT ST_MakePolygon( ST_GeomFromText('LINESTRING(75 29,77 29,77 29, 75 " +"29)'));" msgstr "" #. Tag: para -#: reference_constructor.xml:1661 +#: reference_constructor.xml:429 #, 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:1664 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 6.1.2" -msgstr "" - -#. Tag: title -#: reference_constructor.xml:1670 -#, no-c-format -msgid "Examples: Geometry" +"Create a Polygon from an open LineString, using and to close it." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1672 +#: reference_constructor.xml:431 #, no-c-format -msgid "SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)" +msgid "" +"SELECT ST_MakePolygon( ST_AddPoint(foo.open_line, ST_StartPoint(foo." +"open_line)) )\n" +"FROM (\n" +" SELECT ST_GeomFromText('LINESTRING(75 29,77 29,77 29, 75 29)') As " +"open_line) As foo;" msgstr "" -#. Tag: title -#: reference_constructor.xml:1676 +#. Tag: para +#: reference_constructor.xml:433 #, no-c-format -msgid "Examples: Geography" +msgid "Create a Polygon from a 3D LineString" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1678 +#: reference_constructor.xml:434 #, no-c-format msgid "" -"SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) " -"As geography);" +"SELECT ST_AsEWKT( ST_MakePolygon( '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))" msgstr "" -#. Tag: programlisting -#: reference_constructor.xml:1679 +#. Tag: para +#: reference_constructor.xml:435 #, no-c-format -msgid "" -"-- the :: is PostgreSQL short-hand for casting.\n" -"SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)::" -"geography;" +msgid "Create a Polygon from a LineString with measures" msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1681 +#: reference_constructor.xml:436 #, 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;" +"SELECT ST_AsEWKT( ST_MakePolygon( '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: para -#: reference_constructor.xml:1688 +#. Tag: title +#: reference_constructor.xml:439 #, no-c-format -msgid "" -", , , " +msgid "Examples: Outer shell with inner holes variant" msgstr "" -#. Tag: refname -#: reference_constructor.xml:1694 +#. Tag: para +#: reference_constructor.xml:441 #, no-c-format -msgid "ST_PointFromGeoHash" +msgid "Create a donut Polygon with an extra hole" msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:1696 +#. Tag: programlisting +#: reference_constructor.xml:442 #, no-c-format -msgid "Return a point from a GeoHash string." +msgid "" +"SELECT ST_MakePolygon( ST_ExteriorRing( ST_Buffer(ring.line,10)),\n" +" ARRAY[ ST_Translate(ring.line, 1, 1),\n" +" ST_ExteriorRing(ST_Buffer(ST_MakePoint(20,20),1)) ]\n" +" )\n" +"FROM (SELECT ST_ExteriorRing(\n" +" ST_Buffer(ST_MakePoint(10,10),10,10)) AS line ) AS ring;" msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:1701 +#. Tag: para +#: reference_constructor.xml:443 #, no-c-format msgid "" -"point ST_PointFromGeoHash " -"text geohash " -"integer " -"precision=full_precision_of_geohash" +"Create a set of province boundaries with holes representing lakes. The input " +"is a table of province Polygons/MultiPolygons and a table of water " +"linestrings. Using a LEFT JOIN ensures all provinces are included even if " +"they have no lakes." msgstr "" #. Tag: para -#: reference_constructor.xml:1712 +#: reference_constructor.xml:449 #, no-c-format msgid "" -"Return a point from a GeoHash string. The point represents the center point " -"of the GeoHash." +"The CASE construct is used because passing a null array into ST_MakePolygon " +"results in a NULL return value." msgstr "" -#. Tag: para -#: reference_constructor.xml:1714 +#. Tag: programlisting +#: reference_constructor.xml:452 #, no-c-format msgid "" -"If no precision is specified ST_PointFromGeoHash returns " -"a point based on full precision of the input GeoHash string." +"SELECT p.gid, p.province_name,\n" +" CASE WHEN array_agg(w.the_geom) IS NULL\n" +" THEN p.the_geom\n" +" ELSE ST_MakePolygon( ST_LineMerge(ST_Boundary(p.the_geom)), " +"array_agg(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;" msgstr "" #. Tag: para -#: reference_constructor.xml:1716 +#: reference_constructor.xml:454 #, no-c-format msgid "" -"If precision is specified ST_PointFromGeoHash will use " -"that many characters from the GeoHash to create the point." +"Another technique is to utilize a correlated subquery and the ARRAY() " +"constructor that converts a row set to an array." msgstr "" #. Tag: programlisting -#: reference_constructor.xml:1723 +#: reference_constructor.xml:456 #, no-c-format msgid "" -"" +"SELECT p.gid, p.province_name,\n" +" CASE WHEN 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 ST_MakePolygon(\n" +" 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\n" +" END AS the_geom\n" +" FROM provinces p;" msgstr "" #. Tag: para -#: reference_constructor.xml:1728 +#: reference_constructor.xml:460 #, no-c-format msgid "" -", , " +", , , , , " msgstr "" #. Tag: refname -#: reference_constructor.xml:1734 +#: reference_constructor.xml:473 #, no-c-format -msgid "ST_PointFromText" +msgid "ST_Point" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1735 +#: reference_constructor.xml:475 #, no-c-format msgid "" -"Makes a point Geometry from WKT with the given SRID. If SRID is not given, " -"it defaults to unknown." +"Creates a Point with the given coordinate values. Alias for ST_MakePoint." msgstr "" -#. Tag: funcsynopsis -#: reference_constructor.xml:1739 +#. Tag: funcprototype +#: reference_constructor.xml:480 #, no-c-format msgid "" -" geometry ST_PointFromText text WKT " -" geometry " -"ST_PointFromText text " -"WKT integer " -"srid " +"geometry ST_Point " +"float x " +"float y" msgstr "" #. Tag: para -#: reference_constructor.xml:1755 +#: reference_constructor.xml:491 #, no-c-format msgid "" -"Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text " -"representation. If SRID is not given, it defaults to unknown (currently 0). " -"If geometry is not a WKT point representation, returns null. If completely " -"invalid WKT, then throws an error." +"Returns an Point with the given X and Y coordinate values. This is the SQL-" +"MM alias for that takes just X and Y." msgstr "" #. Tag: para -#: reference_constructor.xml:1761 +#: reference_constructor.xml:495 #, 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." +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.2" msgstr "" -#. Tag: para -#: reference_constructor.xml:1768 +#. Tag: title +#: reference_constructor.xml:501 #, 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 or OGC compliant alias ." +msgid "Examples: Geometry" msgstr "" -#. Tag: para -#: reference_constructor.xml:1773 +#. Tag: programlisting +#: reference_constructor.xml:503 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 6.1.8" +msgid "SELECT ST_SetSRID( ST_Point( -71.104, 42.315), 4326)" msgstr "" -#. Tag: programlisting -#: reference_constructor.xml:1778 +#. Tag: title +#: reference_constructor.xml:507 #, no-c-format -msgid "" -"SELECT ST_PointFromText('POINT(-71.064544 42.28787)');\n" -"SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);" +msgid "Examples: Geography" msgstr "" -#. Tag: para -#: reference_constructor.xml:1782 +#. Tag: programlisting +#: reference_constructor.xml:509 #, no-c-format msgid "" -", , , " +"SELECT CAST(ST_SetSRID( ST_Point( -71.104, 42.315), 4326) AS geography);" msgstr "" -#. Tag: refname -#: reference_constructor.xml:1788 +#. Tag: para +#: reference_constructor.xml:511 #, no-c-format -msgid "ST_PointFromWKB" +msgid "" +"PostgreSQL also provides the :: short-hand for casting" msgstr "" -#. Tag: refpurpose -#: reference_constructor.xml:1790 +#. Tag: programlisting +#: reference_constructor.xml:512 #, no-c-format -msgid "Makes a geometry from WKB with the given SRID" +msgid "SELECT ST_SetSRID( ST_Point( -71.104, 42.315), 4326)::geography;" msgstr "" #. Tag: para -#: reference_constructor.xml:1811 +#: reference_constructor.xml:514 #, no-c-format msgid "" -"The ST_PointFromWKB function, takes a well-known binary " -"representation of geometry and a Spatial Reference System ID (SRID) and creates an instance of the appropriate geometry type - in this " -"case, a POINT geometry. This function plays the role of " -"the Geometry Factory in SQL." +"If the point coordinates are not in a geodetic coordinate system (such as " +"WGS84), then they must be reprojected before casting to a geography. In this " +"example a point in Pennsylvania State Plane feet (SRID 2273) is projected to " +"WGS84 (SRID 4326)." msgstr "" -#. Tag: para -#: reference_constructor.xml:1817 +#. Tag: programlisting +#: reference_constructor.xml:518 #, no-c-format msgid "" -"If an SRID is not specified, it defaults to 0. NULL is " -"returned if the input bytea does not represent a " -"POINT geometry." -msgstr "" - -#. Tag: para -#: reference_constructor.xml:1820 -#, no-c-format -msgid "&sfs_compliant; s3.2.7.2" +"SELECT ST_Transform(ST_SetSRID( ST_Point( 3637510, 3014852 ), 2273), 4326)::" +"geography;" msgstr "" #. Tag: para -#: reference_constructor.xml:1821 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 6.1.9" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1829 +#: reference_constructor.xml:525 #, 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 "" #. Tag: refname -#: reference_constructor.xml:1842 +#: reference_constructor.xml:531 #, no-c-format msgid "ST_Polygon" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1844 +#: reference_constructor.xml:533 #, no-c-format -msgid "" -"Returns a polygon built from the specified linestring and SRID." +msgid "Creates a Polygon from a LineString with a specified SRID." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1849 +#: reference_constructor.xml:538 #, no-c-format msgid "" "geometry ST_Polygon " -"geometry aLineStringgeometry lineString integer srid" msgstr "" #. Tag: para -#: reference_constructor.xml:1860 +#: reference_constructor.xml:549 #, no-c-format msgid "" -"Returns a polygon built from the specified linestring and SRID." +"Returns a polygon built from the given LineString and sets the spatial " +"reference system from the srid." msgstr "" #. Tag: para -#: reference_constructor.xml:1864 +#: reference_constructor.xml:552 #, no-c-format msgid "" -"ST_Polygon is similar to first version of ST_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." +"ST_Polygon is similar to Variant 1 with " +"the addition of setting the SRID." msgstr "" #. Tag: para -#: reference_constructor.xml:1869 +#: reference_constructor.xml:554 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 8.3.2" +msgid "" +"To create polygons with holes use Variant " +"2 and then ." msgstr "" -#. Tag: programlisting -#: reference_constructor.xml:1878 +#. Tag: para +#: reference_constructor.xml:562 #, 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))" +msgid "&sfs_compliant;" msgstr "" #. Tag: para -#: reference_constructor.xml:1885 +#: reference_constructor.xml:563 #, no-c-format -msgid "" -", , , , , " +msgid "&sqlmm_compliant; SQL-MM 3: 8.3.2" msgstr "" -#. Tag: refname -#: reference_constructor.xml:1891 +#. Tag: para +#: reference_constructor.xml:571 #, no-c-format -msgid "ST_PolygonFromText" +msgid "Create a 2D polygon." msgstr "" -#. Tag: funcsynopsis -#: reference_constructor.xml:1898 +#. Tag: programlisting +#: reference_constructor.xml:572 #, no-c-format msgid "" -" geometry ST_PolygonFromText text WKT " -" geometry " -"ST_PolygonFromText text WKT integer " -"srid " +"SELECT ST_AsText( ST_Polygon('LINESTRING(75 29, 77 29, 77 29, 75 29)'::" +"geometry, 4326) );\n" +"\n" +"-- result --\n" +"POLYGON((75 29, 77 29, 77 29, 75 29))" msgstr "" #. Tag: para -#: reference_constructor.xml:1914 +#: reference_constructor.xml:573 #, no-c-format -msgid "" -"Makes a Geometry from WKT with the given SRID. If SRID is not given, it " -"defaults to 0. Returns null if WKT is not a polygon." +msgid "Create a 3D polygon." msgstr "" -#. Tag: para -#: reference_constructor.xml:1921 +#. Tag: programlisting +#: reference_constructor.xml:574 #, 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." +"SELECT ST_AsEWKT( ST_Polygon( ST_GeomFromEWKT('LINESTRING(75 29 1, 77 29 2, " +"77 29 3, 75 29 1)'), 4326) );\n" +"\n" +"-- result --\n" +"SRID=4326;POLYGON((75 29 1, 77 29 2, 77 29 3, 75 29 1))" msgstr "" #. Tag: para -#: reference_constructor.xml:1924 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 8.3.6" -msgstr "" - -#. Tag: programlisting -#: reference_constructor.xml:1930 +#: reference_constructor.xml:581 #, 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 "" #. Tag: refname -#: reference_constructor.xml:1943 +#: reference_constructor.xml:588 #, no-c-format -msgid "ST_WKBToSQL" +msgid "ST_TileEnvelope" msgstr "" #. Tag: refpurpose -#: reference_constructor.xml:1944 +#: reference_constructor.xml:589 #, 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" +"Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system." msgstr "" #. Tag: funcprototype -#: reference_constructor.xml:1948 +#: reference_constructor.xml:594 #, no-c-format msgid "" -"geometry ST_WKBToSQL " -"bytea WKB" +"geometry ST_TileEnvelope " +"integer tileZoom " +"integer tileX " +"integer tileY " +"geometry bounds=SRID=3857;" +"LINESTRING(-20037508.342789 -20037508.342789,20037508.342789 " +"20037508.342789)" msgstr "" #. Tag: para -#: reference_constructor.xml:1956 +#: reference_constructor.xml:607 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.36" +msgid "" +"Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system. " +"By default, the bounds are the in EPSG:3857 using the standard range of the " +"Web Mercator system (-20037508.342789, 20037508.342789). The optional bounds " +"parameter can be used to generate envelopes for any tiling scheme: provide a " +"geometry that has the SRID and extent of the initial \"zoom level zero\" " +"square within which the tile system is to be inscribed." msgstr "" -#. Tag: refname -#: reference_constructor.xml:1966 +#. Tag: para +#: reference_constructor.xml:609 #, no-c-format -msgid "ST_WKTToSQL" +msgid "Availability: 3.0" msgstr "" -#. Tag: funcprototype -#: reference_constructor.xml:1971 +#. Tag: title +#: reference_constructor.xml:614 #, no-c-format -msgid "" -"geometry ST_WKTToSQL " -"text WKT" +msgid "Example: Building a tile envelope" msgstr "" -#. Tag: para -#: reference_constructor.xml:1979 +#. Tag: programlisting +#: reference_constructor.xml:615 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.34" +msgid "" +"SELECT ST_AsText( ST_TileEnvelope(2, 1, 1) );\n" +"\n" +" st_astext\n" +"------------------------------\n" +" POLYGON((-10018754.1713945 0,-10018754.1713945 10018754.1713945,0 " +"10018754.1713945,0 0,-10018754.1713945 0))\n" +"\n" +"SELECT ST_AsText( ST_TileEnvelope(3, 1, 1, ST_MakeEnvelope(-180, -90, 180, " +"90, 4326) ) );\n" +"\n" +" st_astext \n" +"------------------------------------------------------\n" +" POLYGON((-135 45,-135 67.5,-90 67.5,-90 45,-135 45))" msgstr "" diff --git a/doc/po/templates/reference_editor.xml.pot b/doc/po/templates/reference_editor.xml.pot index 5989d6eab..0c7d51006 100644 --- a/doc/po/templates/reference_editor.xml.pot +++ b/doc/po/templates/reference_editor.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 20:04+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -52,20 +52,15 @@ msgid "" msgstr "" #. Tag: title -#: reference_editor.xml:29 reference_editor.xml:88 reference_editor.xml:146 -#: reference_editor.xml:192 reference_editor.xml:235 reference_editor.xml:278 -#: reference_editor.xml:319 reference_editor.xml:369 reference_editor.xml:408 -#: reference_editor.xml:465 reference_editor.xml:509 reference_editor.xml:538 -#: reference_editor.xml:595 reference_editor.xml:640 reference_editor.xml:683 -#: reference_editor.xml:734 reference_editor.xml:776 reference_editor.xml:811 -#: reference_editor.xml:883 reference_editor.xml:987 reference_editor.xml:1020 -#: reference_editor.xml:1068 reference_editor.xml:1117 -#: reference_editor.xml:1164 reference_editor.xml:1213 -#: reference_editor.xml:1289 reference_editor.xml:1357 -#: reference_editor.xml:1400 reference_editor.xml:1444 -#: reference_editor.xml:1521 reference_editor.xml:1599 -#: reference_editor.xml:1758 reference_editor.xml:1864 -#: reference_editor.xml:1916 +#: reference_editor.xml:29 reference_editor.xml:69 reference_editor.xml:120 +#: reference_editor.xml:162 reference_editor.xml:208 reference_editor.xml:251 +#: reference_editor.xml:294 reference_editor.xml:335 reference_editor.xml:385 +#: reference_editor.xml:424 reference_editor.xml:481 reference_editor.xml:525 +#: reference_editor.xml:554 reference_editor.xml:611 reference_editor.xml:656 +#: reference_editor.xml:695 reference_editor.xml:730 reference_editor.xml:802 +#: reference_editor.xml:906 reference_editor.xml:939 reference_editor.xml:978 +#: reference_editor.xml:1021 reference_editor.xml:1088 +#: reference_editor.xml:1166 reference_editor.xml:1304 #, no-c-format msgid "Description" msgstr "" @@ -79,40 +74,32 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:34 reference_editor.xml:647 reference_editor.xml:990 -#: reference_editor.xml:1405 +#: reference_editor.xml:34 reference_editor.xml:663 reference_editor.xml:909 +#: reference_editor.xml:1026 #, no-c-format msgid "Availability: 1.1.0" msgstr "" #. Tag: para -#: reference_editor.xml:35 reference_editor.xml:110 reference_editor.xml:157 -#: reference_editor.xml:200 reference_editor.xml:242 reference_editor.xml:324 -#: reference_editor.xml:377 reference_editor.xml:418 reference_editor.xml:473 -#: reference_editor.xml:514 reference_editor.xml:553 reference_editor.xml:604 -#: reference_editor.xml:991 reference_editor.xml:1025 reference_editor.xml:1077 -#: reference_editor.xml:1127 reference_editor.xml:1175 -#: reference_editor.xml:1226 reference_editor.xml:1312 -#: reference_editor.xml:1408 reference_editor.xml:1552 -#: reference_editor.xml:1872 reference_editor.xml:1929 +#: reference_editor.xml:35 reference_editor.xml:173 reference_editor.xml:216 +#: reference_editor.xml:258 reference_editor.xml:340 reference_editor.xml:393 +#: reference_editor.xml:434 reference_editor.xml:489 reference_editor.xml:530 +#: reference_editor.xml:569 reference_editor.xml:620 reference_editor.xml:910 +#: reference_editor.xml:944 reference_editor.xml:1029 reference_editor.xml:1119 +#: reference_editor.xml:1314 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: title -#: reference_editor.xml:39 reference_editor.xml:116 reference_editor.xml:162 -#: reference_editor.xml:205 reference_editor.xml:248 reference_editor.xml:289 -#: reference_editor.xml:330 reference_editor.xml:424 reference_editor.xml:558 -#: reference_editor.xml:610 reference_editor.xml:653 reference_editor.xml:705 -#: reference_editor.xml:749 reference_editor.xml:784 reference_editor.xml:829 -#: reference_editor.xml:954 reference_editor.xml:995 reference_editor.xml:1030 -#: reference_editor.xml:1086 reference_editor.xml:1133 -#: reference_editor.xml:1182 reference_editor.xml:1234 -#: reference_editor.xml:1320 reference_editor.xml:1373 -#: reference_editor.xml:1412 reference_editor.xml:1460 -#: reference_editor.xml:1557 reference_editor.xml:1635 -#: reference_editor.xml:1798 reference_editor.xml:1877 -#: reference_editor.xml:1935 +#: reference_editor.xml:39 reference_editor.xml:91 reference_editor.xml:135 +#: reference_editor.xml:178 reference_editor.xml:221 reference_editor.xml:264 +#: reference_editor.xml:305 reference_editor.xml:346 reference_editor.xml:440 +#: reference_editor.xml:574 reference_editor.xml:626 reference_editor.xml:668 +#: reference_editor.xml:703 reference_editor.xml:748 reference_editor.xml:873 +#: reference_editor.xml:914 reference_editor.xml:949 reference_editor.xml:994 +#: reference_editor.xml:1033 reference_editor.xml:1124 +#: reference_editor.xml:1202 #, no-c-format msgid "Examples" msgstr "" @@ -142,19 +129,14 @@ msgid "" msgstr "" #. Tag: title -#: reference_editor.xml:43 reference_editor.xml:123 reference_editor.xml:169 -#: reference_editor.xml:212 reference_editor.xml:255 reference_editor.xml:296 -#: reference_editor.xml:337 reference_editor.xml:382 reference_editor.xml:433 -#: reference_editor.xml:478 reference_editor.xml:564 reference_editor.xml:616 -#: reference_editor.xml:658 reference_editor.xml:710 reference_editor.xml:754 -#: reference_editor.xml:789 reference_editor.xml:834 reference_editor.xml:963 -#: reference_editor.xml:999 reference_editor.xml:1093 reference_editor.xml:1140 -#: reference_editor.xml:1189 reference_editor.xml:1241 -#: reference_editor.xml:1327 reference_editor.xml:1378 -#: reference_editor.xml:1416 reference_editor.xml:1468 -#: reference_editor.xml:1564 reference_editor.xml:1710 -#: reference_editor.xml:1832 reference_editor.xml:1890 -#: reference_editor.xml:1942 +#: reference_editor.xml:43 reference_editor.xml:96 reference_editor.xml:140 +#: reference_editor.xml:185 reference_editor.xml:228 reference_editor.xml:271 +#: reference_editor.xml:312 reference_editor.xml:353 reference_editor.xml:398 +#: reference_editor.xml:449 reference_editor.xml:494 reference_editor.xml:580 +#: reference_editor.xml:632 reference_editor.xml:673 reference_editor.xml:708 +#: reference_editor.xml:753 reference_editor.xml:882 reference_editor.xml:918 +#: reference_editor.xml:999 reference_editor.xml:1037 reference_editor.xml:1131 +#: reference_editor.xml:1277 reference_editor.xml:1327 #, no-c-format msgid "See Also" msgstr "" @@ -166,192 +148,172 @@ msgid ", " msgstr "" #. Tag: refname -#: reference_editor.xml:50 +#: reference_editor.xml:51 #, no-c-format -msgid "ST_Affine" +msgid "ST_CollectionExtract" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:52 +#: reference_editor.xml:53 #, no-c-format -msgid "Apply a 3d affine transformation to a geometry." +msgid "" +"Given a (multi)geometry, return a (multi)geometry consisting only of " +"elements of the specified type." msgstr "" -#. Tag: funcsynopsis -#: reference_editor.xml:56 +#. Tag: funcprototype +#: reference_editor.xml:60 #, no-c-format msgid "" -" geometry ST_Affine " -"geometry geomA " -"float a " -"float b " -"float c " -"float d " -"float e " -"float f " -"float g " -"float h " -"float i " -"float xoff " -"float yoff " -"float zoff geometry ST_Affine geometry geomA float a float b float d float e float xoff float yoff " +"geometry ST_CollectionExtract " +"geometry collection integer type" msgstr "" #. Tag: para -#: reference_editor.xml:90 +#: reference_editor.xml:71 #, no-c-format msgid "" -"Applies a 3d affine transformation to the geometry to do things like " -"translate, rotate, scale in one step." +"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:91 +#: reference_editor.xml:77 #, no-c-format -msgid "" -"Version 1: The call ST_Affine(geom, a, b, c, d, e, f, g, h, " -"i, xoff, yoff, zoff) represents the transformation matrix " -"/ a b c xoff \\\n" -"| d e f yoff |\n" -"| g h i zoff |\n" -"\\ 0 0 0 1 / and the vertices are transformed as " -"follows: 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 All of the translate / scale " -"functions below are expressed via such an affine transformation." +msgid "Availability: 1.5.0" msgstr "" #. Tag: para -#: reference_editor.xml:98 +#: reference_editor.xml:79 #, no-c-format msgid "" -"Version 2: Applies a 2d affine transformation to the geometry. The call " -"ST_Affine(geom, a, b, d, e, xoff, yoff) " -"represents the transformation matrix / 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 / and the vertices are transformed as " -"follows: x' = a*x + b*y + xoff\n" -"y' = d*x + e*y + yoff\n" -"z' = z This method is a subcase of the 3D method above." +"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: para -#: reference_editor.xml:104 reference_editor.xml:1074 reference_editor.xml:1124 -#: reference_editor.xml:1172 reference_editor.xml:1221 -#: reference_editor.xml:1309 +#: reference_editor.xml:85 reference_editor.xml:126 #, no-c-format msgid "" -"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " -"introduced." +"When specifying 3 == POLYGON a multipolygon is returned even when the edges " +"are shared. This results in an invalid multipolygon for many cases such as " +"applying this function on an result." msgstr "" -#. Tag: para -#: reference_editor.xml:105 +#. Tag: programlisting +#: reference_editor.xml:93 #, no-c-format -msgid "Availability: 1.1.2. Name changed from Affine to ST_Affine in 1.2.2" +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:106 reference_editor.xml:1224 reference_editor.xml:1305 -#: reference_editor.xml:1787 reference_editor.xml:1869 -#: reference_editor.xml:1925 +#: reference_editor.xml:97 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_editor.xml:103 +#, no-c-format +msgid "ST_CollectionHomogenize" +msgstr "" + +#. Tag: refpurpose +#: reference_editor.xml:105 #, 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+" +"Given a geometry collection, return the \"simplest\" representation of the " +"contents." msgstr "" -#. Tag: para -#: reference_editor.xml:108 reference_editor.xml:156 reference_editor.xml:198 -#: reference_editor.xml:241 reference_editor.xml:417 reference_editor.xml:511 -#: reference_editor.xml:554 reference_editor.xml:1026 reference_editor.xml:1079 -#: reference_editor.xml:1126 reference_editor.xml:1174 -#: reference_editor.xml:1228 reference_editor.xml:1311 -#: reference_editor.xml:1793 +#. Tag: funcprototype +#: reference_editor.xml:112 #, no-c-format -msgid "&P_support;" +msgid "" +"geometry ST_CollectionHomogenize " +"geometry collection" msgstr "" #. Tag: para -#: reference_editor.xml:109 reference_editor.xml:512 reference_editor.xml:1080 -#: reference_editor.xml:1128 reference_editor.xml:1176 -#: reference_editor.xml:1229 reference_editor.xml:1314 +#: reference_editor.xml:122 #, no-c-format -msgid "&T_support;" +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:111 reference_editor.xml:155 reference_editor.xml:199 -#: reference_editor.xml:243 reference_editor.xml:284 reference_editor.xml:325 -#: reference_editor.xml:419 reference_editor.xml:513 reference_editor.xml:606 -#: reference_editor.xml:1078 reference_editor.xml:1227 -#: reference_editor.xml:1313 reference_editor.xml:1456 -#: reference_editor.xml:1792 reference_editor.xml:1873 -#: reference_editor.xml:1930 +#: reference_editor.xml:130 reference_editor.xml:1198 #, no-c-format -msgid "&curve_support;" +msgid "Availability: 2.0.0" msgstr "" #. Tag: programlisting -#: reference_editor.xml:118 +#: reference_editor.xml:137 #, 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" +"SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 " +"0))'));\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)" +" 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:125 +#: reference_editor.xml:141 #, no-c-format -msgid "" -", , , " +msgid ", " msgstr "" #. Tag: refname -#: reference_editor.xml:131 +#: reference_editor.xml:147 #, no-c-format msgid "ST_Force2D" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:133 +#: reference_editor.xml:149 #, no-c-format msgid "Force the geometries into a \"2-dimensional mode\"." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:138 +#: reference_editor.xml:154 #, no-c-format msgid "" "geometry ST_Force2D " @@ -359,7 +321,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:148 +#: reference_editor.xml:164 #, no-c-format msgid "" "Forces the geometries into a \"2-dimensional mode\" so that all output " @@ -368,20 +330,36 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:153 reference_editor.xml:196 reference_editor.xml:239 -#: reference_editor.xml:413 reference_editor.xml:552 reference_editor.xml:1789 +#: reference_editor.xml:169 reference_editor.xml:212 reference_editor.xml:255 +#: reference_editor.xml:429 reference_editor.xml:568 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." msgstr "" #. Tag: para -#: reference_editor.xml:154 +#: reference_editor.xml:170 #, no-c-format msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Force_2D." msgstr "" +#. Tag: para +#: reference_editor.xml:171 reference_editor.xml:215 reference_editor.xml:259 +#: reference_editor.xml:300 reference_editor.xml:341 reference_editor.xml:435 +#: reference_editor.xml:529 reference_editor.xml:622 reference_editor.xml:1313 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_editor.xml:172 reference_editor.xml:214 reference_editor.xml:257 +#: reference_editor.xml:433 reference_editor.xml:527 reference_editor.xml:570 +#: reference_editor.xml:945 reference_editor.xml:1316 +#, no-c-format +msgid "&P_support;" +msgstr "" + #. Tag: programlisting -#: reference_editor.xml:164 +#: reference_editor.xml:180 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_Force2D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 " @@ -399,19 +377,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:177 +#: reference_editor.xml:193 #, no-c-format msgid "ST_Force3D" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:179 +#: reference_editor.xml:195 #, no-c-format msgid "Force the geometries into XYZ mode. This is an alias for ST_Force3DZ." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:184 +#: reference_editor.xml:200 #, no-c-format msgid "" "geometry ST_Force3D " @@ -419,7 +397,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:194 +#: reference_editor.xml:210 #, no-c-format msgid "" "Forces the geometries into XYZ mode. This is an alias for ST_Force_3DZ. If a " @@ -427,13 +405,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:197 +#: reference_editor.xml:213 #, no-c-format msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3D." msgstr "" #. Tag: programlisting -#: reference_editor.xml:207 +#: reference_editor.xml:223 #, no-c-format msgid "" "--Nothing happens to an already 3D geometry\n" @@ -454,7 +432,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:214 +#: reference_editor.xml:230 #, no-c-format msgid "" ", , , geometry ST_Force3DZ " @@ -482,7 +460,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:237 +#: reference_editor.xml:253 #, no-c-format msgid "" "Forces the geometries into XYZ mode. This is a synonym for ST_Force3DZ. If a " @@ -490,13 +468,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:240 +#: reference_editor.xml:256 #, no-c-format msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DZ." msgstr "" #. Tag: programlisting -#: reference_editor.xml:250 +#: reference_editor.xml:266 #, no-c-format msgid "" "--Nothing happens to an already 3D geometry\n" @@ -516,7 +494,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:257 reference_editor.xml:339 +#: reference_editor.xml:273 reference_editor.xml:355 #, no-c-format msgid "" ", , , geometry ST_Force3DM " @@ -544,7 +522,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:280 +#: reference_editor.xml:296 #, no-c-format msgid "" "Forces the geometries into XYM mode. If a geometry has no M component, then " @@ -552,13 +530,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:283 +#: reference_editor.xml:299 #, no-c-format msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DM." msgstr "" #. Tag: programlisting -#: reference_editor.xml:291 +#: reference_editor.xml:307 #, no-c-format msgid "" "--Nothing happens to an already 3D geometry\n" @@ -578,7 +556,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:298 reference_editor.xml:435 +#: reference_editor.xml:314 reference_editor.xml:451 #, no-c-format msgid "" ", , , geometry ST_Force4D " @@ -606,7 +584,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:321 +#: reference_editor.xml:337 #, no-c-format msgid "" "Forces the geometries into XYZM mode. 0 is tacked on for missing Z and M " @@ -614,13 +592,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:323 +#: reference_editor.xml:339 #, no-c-format msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Force_4D." msgstr "" #. Tag: programlisting -#: reference_editor.xml:332 +#: reference_editor.xml:348 #, no-c-format msgid "" "--Nothing happens to an already 3D geometry\n" @@ -642,13 +620,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:345 +#: reference_editor.xml:361 #, no-c-format msgid "ST_ForcePolygonCCW" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:348 +#: reference_editor.xml:364 #, no-c-format msgid "" "Orients all exterior rings counter-clockwise and all interior rings " @@ -656,7 +634,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_editor.xml:355 +#: reference_editor.xml:371 #, no-c-format msgid "" " geometry ST_ForcePolygonCCW " @@ -664,7 +642,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:371 +#: reference_editor.xml:387 #, no-c-format msgid "" "Forces (Multi)Polygons to use a counter-clockwise orientation for their " @@ -673,32 +651,32 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:378 reference_editor.xml:474 reference_editor.xml:1315 +#: reference_editor.xml:394 reference_editor.xml:490 reference_editor.xml:1315 #, no-c-format msgid "&M_support;" msgstr "" #. Tag: para -#: reference_editor.xml:383 reference_editor.xml:479 +#: reference_editor.xml:399 reference_editor.xml:495 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_editor.xml:393 +#: reference_editor.xml:409 #, no-c-format msgid "ST_ForceCollection" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:395 +#: reference_editor.xml:411 #, no-c-format msgid "Convert the geometry into a GEOMETRYCOLLECTION." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:400 +#: reference_editor.xml:416 #, no-c-format msgid "" "geometry ST_ForceCollection " @@ -706,7 +684,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:410 +#: reference_editor.xml:426 #, no-c-format msgid "" "Converts the geometry into a GEOMETRYCOLLECTION. This is useful for " @@ -714,7 +692,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:414 +#: reference_editor.xml:430 #, no-c-format msgid "" "Availability: 1.2.2, prior to 1.3.4 this function will crash with Curves. " @@ -722,13 +700,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:415 +#: reference_editor.xml:431 #, no-c-format msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Force_Collection." msgstr "" #. Tag: programlisting -#: reference_editor.xml:426 +#: reference_editor.xml:442 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_ForceCollection('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 " @@ -750,7 +728,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_editor.xml:428 +#: reference_editor.xml:444 #, no-c-format msgid "" "-- POLYHEDRAL example --\n" @@ -775,13 +753,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:441 +#: reference_editor.xml:457 #, no-c-format msgid "ST_ForcePolygonCW" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:444 +#: reference_editor.xml:460 #, no-c-format msgid "" "Orients all exterior rings clockwise and all interior rings counter-" @@ -789,7 +767,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_editor.xml:451 +#: reference_editor.xml:467 #, no-c-format msgid "" " geometry ST_ForcePolygonCW " @@ -797,7 +775,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:467 +#: reference_editor.xml:483 #, no-c-format msgid "" "Forces (Multi)Polygons to use a clockwise orientation for their exterior " @@ -806,19 +784,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:489 +#: reference_editor.xml:505 #, no-c-format msgid "ST_ForceSFS" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:491 +#: reference_editor.xml:507 #, no-c-format msgid "Force the geometries to use SFS 1.1 geometry types only." msgstr "" #. Tag: funcsynopsis -#: reference_editor.xml:495 +#: reference_editor.xml:511 #, no-c-format msgid "" " geometry ST_ForceSFS " @@ -829,14 +807,20 @@ msgid "" "parameter> " msgstr "" +#. Tag: para +#: reference_editor.xml:528 reference_editor.xml:1317 +#, no-c-format +msgid "&T_support;" +msgstr "" + #. Tag: refname -#: reference_editor.xml:521 +#: reference_editor.xml:537 #, no-c-format msgid "ST_ForceRHR" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:523 +#: reference_editor.xml:539 #, no-c-format msgid "" "Force the orientation of the vertices in a polygon to follow the Right-Hand-" @@ -844,7 +828,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_editor.xml:529 +#: reference_editor.xml:545 #, no-c-format msgid "" "geometry ST_ForceRHR " @@ -852,7 +836,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:540 +#: reference_editor.xml:556 #, no-c-format msgid "" "Forces the orientation of the vertices in a polygon to follow a Right-Hand-" @@ -863,7 +847,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:547 +#: reference_editor.xml:563 #, no-c-format msgid "" "The above definition of the Right-Hand-Rule conflicts with definitions used " @@ -872,7 +856,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_editor.xml:560 +#: reference_editor.xml:576 #, no-c-format msgid "" "SELECT ST_AsEWKT(\n" @@ -888,7 +872,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:566 +#: reference_editor.xml:582 #, no-c-format msgid "" ", , geometry ST_ForceCurve " @@ -917,7 +901,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:597 +#: reference_editor.xml:613 #, no-c-format msgid "" "Turns a geometry into its curved representation, if applicable: lines become " @@ -927,13 +911,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:603 +#: reference_editor.xml:619 reference_editor.xml:1312 #, no-c-format msgid "Availability: 2.2.0" msgstr "" #. Tag: programlisting -#: reference_editor.xml:612 +#: reference_editor.xml:628 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -949,20 +933,20 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:624 +#: reference_editor.xml:640 #, no-c-format msgid "ST_LineMerge" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:626 +#: reference_editor.xml:642 #, no-c-format msgid "" "Return a (set of) LineString(s) formed by sewing together a MULTILINESTRING." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:632 +#: reference_editor.xml:648 #, no-c-format msgid "" "geometry ST_LineMerge " @@ -971,7 +955,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:642 +#: reference_editor.xml:658 #, no-c-format msgid "" "Returns a (set of) LineString(s) formed by sewing together the constituent " @@ -979,7 +963,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:644 +#: reference_editor.xml:660 #, no-c-format msgid "" "Only use with MULTILINESTRING/LINESTRINGs. If you feed a polygon or geometry " @@ -987,19 +971,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:648 +#: reference_editor.xml:662 reference_editor.xml:1197 #, no-c-format -msgid "requires GEOS >= 2.1.0" +msgid "Performed by the GEOS module." msgstr "" #. Tag: para -#: reference_editor.xml:649 +#: reference_editor.xml:664 #, no-c-format msgid "Will strip the M dimension." msgstr "" #. Tag: programlisting -#: reference_editor.xml:655 +#: reference_editor.xml:670 #, no-c-format msgid "" "SELECT ST_AsText(ST_LineMerge(\n" @@ -1036,304 +1020,151 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:659 +#: reference_editor.xml:674 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_editor.xml:665 +#: reference_editor.xml:680 #, no-c-format -msgid "ST_CollectionExtract" +msgid "ST_Multi" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:667 +#: reference_editor.xml:682 #, no-c-format -msgid "" -"Given a (multi)geometry, return a (multi)geometry consisting only of " -"elements of the specified type." +msgid "Return the geometry as a MULTI* geometry." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:674 +#: reference_editor.xml:687 #, no-c-format msgid "" -"geometry ST_CollectionExtract " -"geometry collection integer type" +"geometry ST_Multi " +"geometry g1" msgstr "" #. Tag: para -#: reference_editor.xml:685 +#: reference_editor.xml:697 #, 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." +"Returns the geometry as a MULTI* geometry. If the geometry is already a " +"MULTI*, it is returned unchanged." msgstr "" -#. Tag: para -#: reference_editor.xml:691 +#. Tag: programlisting +#: reference_editor.xml:705 #, no-c-format -msgid "Availability: 1.5.0" +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:715 +#, no-c-format +msgid "ST_Normalize" +msgstr "" + +#. Tag: refpurpose +#: reference_editor.xml:717 +#, no-c-format +msgid "Return the geometry in its canonical form." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:722 +#, no-c-format +msgid "" +"geometry ST_Normalize " +"geometry geom" msgstr "" #. Tag: para -#: reference_editor.xml:693 +#: reference_editor.xml:732 #, 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." +"Returns the geometry in its normalized/canonical form. May reorder vertices " +"in polygon rings, rings in a polygon, elements in a multi-geometry complex." msgstr "" #. Tag: para -#: reference_editor.xml:699 reference_editor.xml:740 +#: reference_editor.xml:738 #, no-c-format msgid "" -"When specifying 3 == POLYGON a multipolygon is returned even when the edges " -"are shared. This results in an invalid multipolygon for many cases such as " -"applying this function on an result." +"Mostly only useful for testing purposes (comparing expected and obtained " +"results)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:743 +#, no-c-format +msgid "Availability: 2.3.0" msgstr "" #. Tag: programlisting -#: reference_editor.xml:707 +#: reference_editor.xml:750 #, 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" +"SELECT ST_AsText(ST_Normalize(ST_GeomFromText(\n" +" 'GEOMETRYCOLLECTION(\n" +" POINT(2 3),\n" +" MULTILINESTRING((0 0, 1 1),(2 2, 3 3)),\n" +" POLYGON(\n" +" (0 10,0 0,10 0,10 10,0 10),\n" +" (4 2,2 2,2 4,4 4,4 2),\n" +" (6 8,8 8,8 6,6 6,6 8)\n" +" )\n" +" )'\n" +")));\n" +" st_astext\n" +"----------------------------------------------------------------------------------------------------------------------------------------------------\n" +" GEOMETRYCOLLECTION(POLYGON((0 0,0 10,10 10,10 0,0 0),(6 6,8 6,8 8,6 8,6 6)," +"(2 2,4 2,4 4,2 4,2 2)),MULTILINESTRING((2 2,3 3),(0 0,1 1)),POINT(2 3))\n" "(1 row)" msgstr "" #. Tag: para -#: reference_editor.xml:711 +#: reference_editor.xml:754 #, no-c-format -msgid "" -", , " +msgid "," msgstr "" #. Tag: refname -#: reference_editor.xml:717 +#: reference_editor.xml:762 #, no-c-format -msgid "ST_CollectionHomogenize" +msgid "ST_QuantizeCoordinates" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:719 +#: reference_editor.xml:765 #, no-c-format -msgid "" -"Given a geometry collection, return the \"simplest\" representation of the " -"contents." +msgid "Sets least significant bits of coordinates to zero" msgstr "" #. Tag: funcprototype -#: reference_editor.xml:726 +#: reference_editor.xml:772 #, no-c-format msgid "" -"geometry ST_CollectionHomogenize " -"geometry collection" +" geometry ST_QuantizeCoordinates " +" geometry g " +" int prec_x " +" int prec_y " +" int prec_z " +" int prec_m " msgstr "" #. Tag: para -#: reference_editor.xml:736 -#, 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:744 -#, no-c-format -msgid "Availability: 2.0.0" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:751 -#, 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:755 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:761 -#, no-c-format -msgid "ST_Multi" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:763 -#, no-c-format -msgid "Return the geometry as a MULTI* geometry." -msgstr "" - -#. Tag: funcprototype -#: reference_editor.xml:768 -#, no-c-format -msgid "" -"geometry ST_Multi " -"geometry g1" -msgstr "" - -#. Tag: para -#: reference_editor.xml:778 -#, no-c-format -msgid "" -"Returns the geometry as a MULTI* geometry. If the geometry is already a " -"MULTI*, it is returned unchanged." -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:786 -#, 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:796 -#, no-c-format -msgid "ST_Normalize" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:798 -#, no-c-format -msgid "Return the geometry in its canonical form." -msgstr "" - -#. Tag: funcprototype -#: reference_editor.xml:803 -#, no-c-format -msgid "" -"geometry ST_Normalize " -"geometry geom" -msgstr "" - -#. Tag: para -#: reference_editor.xml:813 -#, no-c-format -msgid "" -"Returns the geometry in its normalized/canonical form. May reorder vertices " -"in polygon rings, rings in a polygon, elements in a multi-geometry complex." -msgstr "" - -#. Tag: para -#: reference_editor.xml:819 -#, no-c-format -msgid "" -"Mostly only useful for testing purposes (comparing expected and obtained " -"results)." -msgstr "" - -#. Tag: para -#: reference_editor.xml:824 -#, no-c-format -msgid "Availability: 2.3.0" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:831 -#, no-c-format -msgid "" -"SELECT ST_AsText(ST_Normalize(ST_GeomFromText(\n" -" 'GEOMETRYCOLLECTION(\n" -" POINT(2 3),\n" -" MULTILINESTRING((0 0, 1 1),(2 2, 3 3)),\n" -" POLYGON(\n" -" (0 10,0 0,10 0,10 10,0 10),\n" -" (4 2,2 2,2 4,4 4,4 2),\n" -" (6 8,8 8,8 6,6 6,6 8)\n" -" )\n" -" )'\n" -")));\n" -" st_astext\n" -"----------------------------------------------------------------------------------------------------------------------------------------------------\n" -" GEOMETRYCOLLECTION(POLYGON((0 0,0 10,10 10,10 0,0 0),(6 6,8 6,8 8,6 8,6 6)," -"(2 2,4 2,4 4,2 4,2 2)),MULTILINESTRING((2 2,3 3),(0 0,1 1)),POINT(2 3))\n" -"(1 row)" -msgstr "" - -#. Tag: para -#: reference_editor.xml:835 -#, no-c-format -msgid "," -msgstr "" - -#. Tag: refname -#: reference_editor.xml:843 -#, no-c-format -msgid "ST_QuantizeCoordinates" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:846 -#, no-c-format -msgid "Sets least significant bits of coordinates to zero" -msgstr "" - -#. Tag: funcprototype -#: reference_editor.xml:853 -#, no-c-format -msgid "" -" geometry ST_QuantizeCoordinates " -" geometry g " -" int prec_x " -" int prec_y " -" int prec_z " -" int prec_m " -msgstr "" - -#. Tag: para -#: reference_editor.xml:884 +#: reference_editor.xml:803 #, no-c-format msgid "" "ST_QuantizeCoordinates determines the number of bits (NST_QuantizeCoordinates are " @@ -1365,19 +1196,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:911 +#: reference_editor.xml:830 #, no-c-format msgid "Availability: 2.5.0" msgstr "" #. Tag: title -#: reference_editor.xml:914 +#: reference_editor.xml:833 #, no-c-format msgid "Technical Background" msgstr "" #. Tag: para -#: reference_editor.xml:915 +#: reference_editor.xml:834 #, no-c-format msgid "" "PostGIS stores all coordinate values as double-precision floating point " @@ -1390,7 +1221,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:924 +#: reference_editor.xml:843 #, no-c-format msgid "" "When 15 significant digits are available, there are many possible " @@ -1410,7 +1241,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:944 +#: reference_editor.xml:863 #, no-c-format msgid "" "Only the on-disk size of the geometry is potentially affected by " @@ -1420,7 +1251,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_editor.xml:956 +#: reference_editor.xml:875 #, no-c-format msgid "" "SELECT ST_AsText(ST_QuantizeCoordinates('POINT (100.123456 0)'::geometry, " @@ -1431,7 +1262,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_editor.xml:958 +#: reference_editor.xml:877 #, no-c-format msgid "" "WITH test AS (SELECT 'POINT (123.456789123456 123.456789123456)'::geometry " @@ -1496,19 +1327,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:973 +#: reference_editor.xml:892 #, no-c-format msgid "ST_RemovePoint" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:974 +#: reference_editor.xml:893 #, no-c-format msgid "Remove point from a linestring." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:978 +#: reference_editor.xml:897 #, no-c-format msgid "" "geometry ST_RemovePoint " @@ -1517,7 +1348,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:989 +#: reference_editor.xml:908 #, no-c-format msgid "" "Remove a point from a linestring, given its 0-based index. Useful for " @@ -1525,7 +1356,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_editor.xml:996 +#: reference_editor.xml:915 #, no-c-format msgid "" "--guarantee no LINESTRINGS are closed\n" @@ -1538,25 +1369,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1000 +#: reference_editor.xml:919 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_editor.xml:1006 +#: reference_editor.xml:925 #, no-c-format msgid "ST_Reverse" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1007 +#: reference_editor.xml:926 #, no-c-format msgid "Return the geometry with vertex order reversed." msgstr "" #. Tag: funcprototype -#: reference_editor.xml:1012 +#: reference_editor.xml:931 #, no-c-format msgid "" "geometry ST_Reverse " @@ -1564,19 +1395,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1022 +#: reference_editor.xml:941 #, no-c-format msgid "Can be used on any geometry and reverses the order of the vertexes." msgstr "" #. Tag: para -#: reference_editor.xml:1024 +#: reference_editor.xml:943 #, no-c-format msgid "Enhanced: 2.4.0 support for curves was introduced." msgstr "" #. Tag: programlisting -#: reference_editor.xml:1031 +#: reference_editor.xml:950 #, no-c-format msgid "" "SELECT ST_AsText(the_geom) as line, ST_AsText(ST_Reverse(the_geom)) As " @@ -1591,419 +1422,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_editor.xml:1037 -#, no-c-format -msgid "ST_Rotate" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:1039 -#, no-c-format -msgid "Rotate a geometry rotRadians counter-clockwise about an origin." -msgstr "" - -#. Tag: funcsynopsis -#: reference_editor.xml:1043 -#, no-c-format -msgid "" -" geometry ST_Rotate " -"geometry geomA " -"float rotRadians geometry ST_Rotate geometry geomA float rotRadians float x0 float y0 geometry " -"ST_Rotate geometry " -"geomA float " -"rotRadians geometry " -"pointOrigin " -msgstr "" - -#. Tag: para -#: reference_editor.xml:1070 -#, 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:1075 -#, no-c-format -msgid "" -"Enhanced: 2.0.0 additional parameters for specifying the origin of rotation " -"were added." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1076 -#, no-c-format -msgid "Availability: 1.1.2. Name changed from Rotate to ST_Rotate in 1.2.2" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1088 -#, 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:1095 -#, no-c-format -msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1101 -#, no-c-format -msgid "ST_RotateX" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:1103 -#, no-c-format -msgid "Rotate a geometry rotRadians about the X axis." -msgstr "" - -#. Tag: funcprototype -#: reference_editor.xml:1108 -#, no-c-format -msgid "" -"geometry ST_RotateX " -"geometry geomA " -"float rotRadians" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1119 -#, no-c-format -msgid "Rotate a geometry geomA - rotRadians about the X axis." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1121 -#, no-c-format -msgid "" -"ST_RotateX(geomA, rotRadians) is short-hand for " -"ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, " -"sin(rotRadians), cos(rotRadians), 0, 0, 0)." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1125 -#, no-c-format -msgid "Availability: 1.1.2. Name changed from RotateX to ST_RotateX in 1.2.2" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1135 -#, 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:1142 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1148 -#, no-c-format -msgid "ST_RotateY" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:1150 -#, no-c-format -msgid "Rotate a geometry rotRadians about the Y axis." -msgstr "" - -#. Tag: funcprototype -#: reference_editor.xml:1155 -#, no-c-format -msgid "" -"geometry ST_RotateY " -"geometry geomA " -"float rotRadians" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1166 -#, no-c-format -msgid "Rotate a geometry geomA - rotRadians about the y axis." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1168 -#, no-c-format -msgid "" -"ST_RotateY(geomA, rotRadians) is short-hand for " -"ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -" -"sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1171 -#, no-c-format -msgid "Availability: 1.1.2. Name changed from RotateY to ST_RotateY in 1.2.2" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1184 -#, 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:1191 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1197 -#, no-c-format -msgid "ST_RotateZ" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:1199 -#, no-c-format -msgid "Rotate a geometry rotRadians about the Z axis." -msgstr "" - -#. Tag: funcprototype -#: reference_editor.xml:1204 -#, no-c-format -msgid "" -"geometry ST_RotateZ " -"geometry geomA " -"float rotRadians" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1215 -#, no-c-format -msgid "Rotate a geometry geomA - rotRadians about the Z axis." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1217 -#, no-c-format -msgid "This is a synonym for ST_Rotate" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1218 -#, no-c-format -msgid "" -"ST_RotateZ(geomA, rotRadians) is short-hand for SELECT " -"ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), " -"cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1223 -#, no-c-format -msgid "Availability: 1.1.2. Name changed from RotateZ to ST_RotateZ in 1.2.2" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1236 -#, 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:1243 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1249 -#, no-c-format -msgid "ST_Scale" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:1251 -#, no-c-format -msgid "Scale a geometry by given factors." -msgstr "" - -#. Tag: funcsynopsis -#: reference_editor.xml:1255 -#, no-c-format -msgid "" -" geometry ST_Scale " -"geometry geomA " -"float XFactor " -"float YFactor " -"float ZFactor geometry ST_Scale geometry geomA float XFactor float YFactor geometry " -"ST_Scale geometry " -"geom geometry " -"factor " -"geometry ST_Scale " -"geometry geom " -"geometry factor " -"geometry origin " -msgstr "" - -#. Tag: para -#: reference_editor.xml:1291 -#, no-c-format -msgid "" -"Scales the geometry to a new size by multiplying the ordinates with the " -"corresponding factor parameters." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1295 -#, no-c-format -msgid "" -"The version taking a geometry as the factor parameter " -"allows passing a 2d, 3dm, 3dz or 4d point to set scaling factor for all " -"supported dimensions. Missing dimensions in the factor " -"point are equivalent to no scaling the corresponding dimension." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1301 -#, no-c-format -msgid "" -"The three-geometry variant allows a \"false origin\" for the scaling to be " -"passed in. This allows \"scaling in place\", for example using the centroid " -"of the geometry as the false origin. Without a false origin, scaling takes " -"place relative to the actual origin, so all coordinates are just multipled " -"by the scale factor." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1308 reference_editor.xml:1928 -#, no-c-format -msgid "Availability: 1.1.0." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1310 -#, no-c-format -msgid "" -"Enhanced: 2.2.0 support for scaling all dimension (geometry parameter) was " -"introduced." -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1322 -#, 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)\n" -"\n" -"--Version 3: Scale X Y Z M\n" -" SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)'),\n" -" ST_MakePoint(0.5, 0.75, 2, -1)));\n" -" st_asewkt\n" -"----------------------------------------\n" -" LINESTRING(0.5 1.5 6 -4,0.5 0.75 2 -1)\n" -"\n" -"--Version 4: Scale X Y using false origin\n" -"SELECT ST_AsText(ST_Scale('LINESTRING(1 1, 2 2)', 'POINT(2 2)', 'POINT(1 " -"1)'::geometry));\n" -" st_astext\n" -"---------------------\n" -" LINESTRING(1 1,3 3)" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1329 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1335 +#: reference_editor.xml:956 #, no-c-format msgid "ST_Segmentize" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1337 +#: reference_editor.xml:958 #, no-c-format msgid "" "Return a modified geometry/geography having no segment longer than the given " @@ -2011,7 +1436,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_editor.xml:1342 +#: reference_editor.xml:963 #, no-c-format msgid "" " geometry ST_Segmentizegeometry ST_SetPoint " @@ -2127,7 +1552,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1402 +#: reference_editor.xml:1023 #, no-c-format msgid "" "Replace point N of linestring with given point. Index is 0-based.Negative " @@ -2137,13 +1562,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1406 +#: reference_editor.xml:1027 #, no-c-format msgid "Updated 2.3.0 : negative indexing" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1413 +#: reference_editor.xml:1034 #, no-c-format msgid "" "--Change first point in line string from -1 3 to -1 1\n" @@ -2171,7 +1596,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1417 +#: reference_editor.xml:1038 #, no-c-format msgid "" ", , , geometry ST_SetSRID " -"geometry geom " -"integer srid" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1446 -#, 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:1450 -#, 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 if you want to " -"transform the geometry into a new projection." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1455 -#, no-c-format -msgid "&sfs_compliant;" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1461 -#, no-c-format -msgid "-- Mark a point as WGS 84 long lat --" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1462 -#, 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 "" - -#. Tag: para -#: reference_editor.xml:1463 -#, 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:1464 -#, 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:1470 -#, no-c-format -msgid "" -", , , , , " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1477 +#: reference_editor.xml:1044 #, no-c-format msgid "ST_SnapToGrid" msgstr "" #. Tag: refpurpose -#: reference_editor.xml:1479 +#: reference_editor.xml:1046 #, no-c-format msgid "Snap all points of the input geometry to a regular grid." msgstr "" #. Tag: funcsynopsis -#: reference_editor.xml:1485 +#: reference_editor.xml:1052 #, no-c-format msgid "" " geometry ST_SnapToGrid, , geometry ST_Snap " @@ -2429,17 +1767,17 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1601 +#: reference_editor.xml:1168 #, 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. The " -"result geometry is the input geometry with the vertices snapped. If no " -"snapping occurs then the input geometry is returned unchanged." +"Snaps the vertices and segments of a geometry to another Geometry's " +"vertices. A snap distance tolerance is used to control where snapping is " +"performed. The result geometry is the input geometry with the vertices " +"snapped. If no snapping occurs then the input geometry is returned unchanged." msgstr "" #. Tag: para -#: reference_editor.xml:1608 +#: reference_editor.xml:1175 #, no-c-format msgid "" "Snapping one geometry to another can improve robustness for overlay " @@ -2448,7 +1786,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1615 +#: reference_editor.xml:1182 #, no-c-format msgid "" "Too much snapping can result in invalid topology being created, so the " @@ -2458,7 +1796,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_editor.xml:1624 +#: reference_editor.xml:1191 #, no-c-format msgid "" "The returned geometry might lose its simplicity (see geometry ST_Transform geometry g1 integer srid geometry " -"ST_Transform geometry " -"geom text " -"to_proj " -"geometry ST_Transform " -"geometry geom " -"text from_proj " -"text to_proj geometry ST_Transform geometry geom text from_proj integer to_srid " -msgstr "" - -#. Tag: para -#: reference_editor.xml:1760 -#, no-c-format -msgid "" -"Returns a new geometry with its coordinates transformed to a different " -"spatial reference system. The destination spatial reference " -"to_srid may be identified by a valid SRID integer " -"parameter (i.e. it must exist in the spatial_ref_sys " -"table). Alternatively, a spatial reference defined as a PROJ.4 string can be " -"used for to_proj and/or from_proj, " -"however these methods are not optimized. If the destination spatial " -"reference system is expressed with a PROJ.4 string instead of an SRID, the " -"SRID of the output geometry will be set to zero. With the exception of " -"functions with from_proj, input geometries must have a " -"defined SRID." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1774 +#: reference_editor.xml:1288 #, 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:1779 -#, no-c-format -msgid "" -"Requires PostGIS be compiled with Proj support. Use to confirm you have proj support compiled in." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1783 -#, 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:1790 -#, no-c-format -msgid "Enhanced: 2.3.0 support for direct PROJ.4 text was introduced." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1791 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.6" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1799 -#, no-c-format -msgid "Change Massachusetts state plane US feet geometry to WGS 84 long lat" +"Returns a version of the given geometry with given ordinate values swapped." msgstr "" -#. Tag: programlisting -#: reference_editor.xml:1800 +#. Tag: funcprototype +#: reference_editor.xml:1295 #, 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)" +"geometry ST_SwapOrdinates " +"geometry geom " +"cstring ords" msgstr "" #. Tag: para -#: reference_editor.xml:1801 -#, 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:1803 +#: reference_editor.xml:1305 #, 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;" +msgid "Returns a version of the given geometry with given ordinates swapped." msgstr "" #. Tag: para -#: reference_editor.xml:1805 +#: reference_editor.xml:1308 #, no-c-format msgid "" -"Examples of using PROJ.4 text to transform with custom spatial references." -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1806 -#, no-c-format -msgid "" -"-- Find intersection of two polygons near the North pole, using a custom " -"Gnomic projection\n" -"-- See http://boundlessgeo.com/2012/02/flattening-the-peel/\n" -" WITH data AS (\n" -" SELECT\n" -" ST_GeomFromText('POLYGON((170 50,170 72,-130 72,-130 50,170 50))', " -"4326) AS p1,\n" -" ST_GeomFromText('POLYGON((-170 68,-170 90,-141 90,-141 68,-170 68))', " -"4326) AS p2,\n" -" '+proj=gnom +ellps=WGS84 +lat_0=70 +lon_0=-160 +no_defs'::text AS gnom\n" -" )\n" -" SELECT ST_AsText(\n" -" ST_Transform(\n" -" ST_Intersection(ST_Transform(p1, gnom), ST_Transform(p2, gnom)),\n" -" gnom, 4326))\n" -" FROM data;\n" -" st_astext\n" -" --------------------------------------------------------------------------------\n" -" POLYGON((-170 74.053793645338,-141 73.4268621378904,-141 68,-170 68,-170 " -"74.053793645338))" +"The ords parameter is a 2-characters string naming the " +"ordinates to swap. Valid names are: x,y,z and m." msgstr "" #. Tag: title -#: reference_editor.xml:1810 -#, no-c-format -msgid "Configuring transformation behaviour" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1811 -#, 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 either by testing " -"different to_proj values of PROJ.4 text, or altering the " -"proj4text value within the spatial_ref_sys table." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1821 -#, 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:1822 -#, no-c-format -msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1823 -#, 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:1824 -#, 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:1825 -#, no-c-format -msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1826 -#, 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:1827 -#, 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 "" - -#. Tag: para -#: reference_editor.xml:1834 -#, no-c-format -msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1840 -#, no-c-format -msgid "ST_Translate" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:1842 -#, no-c-format -msgid "Translate a geometry by given offsets." -msgstr "" - -#. Tag: funcsynopsis -#: reference_editor.xml:1846 -#, no-c-format -msgid "" -" geometry ST_Translate geometry g1 float deltax float deltay geometry " -"ST_Translate geometry " -"g1 float " -"deltax float " -"deltay float " -"deltaz " -msgstr "" - -#. Tag: para -#: reference_editor.xml:1866 -#, 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:1878 -#, no-c-format -msgid "Move a point 1 degree longitude" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1879 -#, 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 "" - -#. Tag: para -#: reference_editor.xml:1880 -#, no-c-format -msgid "Move a linestring 1 degree longitude and 1/2 degree latitude" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1881 -#, 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 "" - -#. Tag: para -#: reference_editor.xml:1882 -#, no-c-format -msgid "Move a 3d point" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1883 -#, 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 "" - -#. Tag: para -#: reference_editor.xml:1884 -#, no-c-format -msgid "Move a curve and a point" -msgstr "" - -#. Tag: programlisting -#: reference_editor.xml:1885 -#, 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 "" - -#. Tag: para -#: reference_editor.xml:1891 +#: reference_editor.xml:1321 #, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_editor.xml:1897 -#, no-c-format -msgid "ST_TransScale" -msgstr "" - -#. Tag: refpurpose -#: reference_editor.xml:1899 -#, no-c-format -msgid "Translate a geometry by given factors and offsets." -msgstr "" - -#. Tag: funcprototype -#: reference_editor.xml:1904 -#, no-c-format -msgid "" -"geometry ST_TransScale " -"geometry geomA " -"float deltaX " -"float deltaY " -"float XFactor " -"float YFactor" -msgstr "" - -#. Tag: para -#: reference_editor.xml:1918 -#, no-c-format -msgid "" -"Translates the geometry using the deltaX and deltaY args, then scales it " -"using the XFactor, YFactor args, working in 2D only." -msgstr "" - -#. Tag: para -#: reference_editor.xml:1921 -#, no-c-format -msgid "" -"ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor) is short-" -"hand for ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, " -"deltaX*XFactor, deltaY*YFactor, 0)." +msgid "Example" msgstr "" #. Tag: programlisting -#: reference_editor.xml:1937 +#: reference_editor.xml:1322 #, 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:1944 -#, no-c-format -msgid ", " +"" msgstr "" diff --git a/doc/po/templates/reference_exception.xml.pot b/doc/po/templates/reference_exception.xml.pot index e03ebc165..9fa5aa85c 100644 --- a/doc/po/templates/reference_exception.xml.pot +++ b/doc/po/templates/reference_exception.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:02+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/reference_guc.xml.pot b/doc/po/templates/reference_guc.xml.pot index 17682d3cd..f65a42dc0 100644 --- a/doc/po/templates/reference_guc.xml.pot +++ b/doc/po/templates/reference_guc.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:02+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,25 +18,25 @@ msgstr "" #: 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." +"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 +#: reference_guc.xml:9 #, no-c-format -msgid "PostGIS Grand Unified Custom Variables (GUCs)" +msgid "Grand Unified Custom Variables (GUCs)" msgstr "" #. Tag: refname -#: reference_guc.xml:12 +#: reference_guc.xml:13 #, no-c-format msgid "postgis.backend" msgstr "" #. Tag: refpurpose -#: reference_guc.xml:13 +#: reference_guc.xml:14 #, no-c-format msgid "" "The backend to service a function where GEOS and SFCGAL overlap. Options: " @@ -44,14 +44,14 @@ msgid "" msgstr "" #. Tag: title -#: reference_guc.xml:17 reference_guc.xml:45 reference_guc.xml:95 -#: reference_guc.xml:187 +#: reference_guc.xml:18 reference_guc.xml:46 reference_guc.xml:96 +#: reference_guc.xml:188 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_guc.xml:18 +#: reference_guc.xml:19 #, no-c-format msgid "" "This GUC is only relevant if you compiled PostGIS with sfcgal support. By " @@ -61,57 +61,57 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:19 +#: reference_guc.xml:20 #, no-c-format msgid "Availability: 2.1.0" msgstr "" #. Tag: title -#: reference_guc.xml:23 reference_guc.xml:69 reference_guc.xml:146 -#: reference_guc.xml:213 +#: reference_guc.xml:24 reference_guc.xml:70 reference_guc.xml:147 +#: reference_guc.xml:214 #, no-c-format msgid "Examples" msgstr "" #. Tag: para -#: reference_guc.xml:24 +#: reference_guc.xml:25 #, no-c-format msgid "Sets backend just for life of connection" msgstr "" #. Tag: programlisting -#: reference_guc.xml:25 +#: reference_guc.xml:26 #, no-c-format msgid "set postgis.backend = sfcgal;" msgstr "" #. Tag: para -#: reference_guc.xml:27 +#: reference_guc.xml:28 #, no-c-format msgid "Sets backend for new connections to database" msgstr "" #. Tag: programlisting -#: reference_guc.xml:28 +#: reference_guc.xml:29 #, no-c-format msgid "ALTER DATABASE mygisdb SET postgis.backend = sfcgal;" msgstr "" #. Tag: title -#: reference_guc.xml:31 reference_guc.xml:79 reference_guc.xml:166 -#: reference_guc.xml:220 +#: reference_guc.xml:32 reference_guc.xml:80 reference_guc.xml:167 +#: reference_guc.xml:221 #, no-c-format msgid "See Also" msgstr "" #. Tag: refname -#: reference_guc.xml:38 +#: reference_guc.xml:39 #, no-c-format msgid "postgis.gdal_datapath" msgstr "" #. Tag: refpurpose -#: reference_guc.xml:39 +#: reference_guc.xml:40 #, no-c-format msgid "" "A configuration option to assign the value of GDAL's GDAL_DATA option. If " @@ -119,7 +119,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:46 +#: reference_guc.xml:47 #, no-c-format msgid "" "A PostgreSQL GUC variable for setting the value of GDAL's GDAL_DATA option. " @@ -128,7 +128,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:49 +#: reference_guc.xml:50 #, no-c-format msgid "" "This configuration option is of most use for Windows platforms where GDAL's " @@ -137,7 +137,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:54 +#: reference_guc.xml:55 #, no-c-format msgid "" "This option can be set in PostgreSQL's configuration file postgresql.conf. " @@ -145,13 +145,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:58 reference_guc.xml:141 reference_guc.xml:208 +#: reference_guc.xml:59 reference_guc.xml:142 reference_guc.xml:209 #, no-c-format msgid "Availability: 2.2.0" msgstr "" #. Tag: para -#: reference_guc.xml:61 +#: reference_guc.xml:62 #, no-c-format msgid "" "Additional information about GDAL_DATA is available at GDAL's postgis.gdal_datapath" msgstr "" #. Tag: programlisting -#: reference_guc.xml:72 +#: reference_guc.xml:73 #, no-c-format msgid "" "SET postgis.gdal_datapath TO '/usr/local/share/gdal.hidden';\n" @@ -174,13 +174,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:74 +#: reference_guc.xml:75 #, no-c-format msgid "Setting on windows for a particular database" msgstr "" #. Tag: programlisting -#: reference_guc.xml:75 +#: reference_guc.xml:76 #, no-c-format msgid "" "ALTER DATABASE gisdb\n" @@ -188,19 +188,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:80 +#: reference_guc.xml:81 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_guc.xml:88 +#: reference_guc.xml:89 #, no-c-format msgid "postgis.gdal_enabled_drivers" msgstr "" #. Tag: refpurpose -#: reference_guc.xml:89 +#: reference_guc.xml:90 #, no-c-format msgid "" "A configuration option to set the enabled GDAL drivers in the PostGIS " @@ -208,7 +208,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:96 +#: reference_guc.xml:97 #, no-c-format msgid "" "A configuration option to set the enabled GDAL drivers in the PostGIS " @@ -218,7 +218,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:100 +#: reference_guc.xml:101 #, no-c-format msgid "" "The initial value of postgis.gdal_enabled_drivers may " @@ -228,7 +228,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:104 +#: reference_guc.xml:105 #, no-c-format msgid "" "Enabled GDAL specified drivers can be specified by the driver's short-name " @@ -238,7 +238,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:109 +#: reference_guc.xml:110 #, no-c-format msgid "" "There are three special codes available for postgis." @@ -246,7 +246,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:114 +#: reference_guc.xml:115 #, no-c-format msgid "" "DISABLE_ALL disables all GDAL drivers. If present, " @@ -255,13 +255,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:117 +#: reference_guc.xml:118 #, no-c-format msgid "ENABLE_ALL enables all GDAL drivers." msgstr "" #. Tag: para -#: reference_guc.xml:120 +#: reference_guc.xml:121 #, no-c-format msgid "" "VSICURL enables GDAL's /vsicurl/ " @@ -269,7 +269,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:124 +#: reference_guc.xml:125 #, no-c-format msgid "" "When postgis.gdal_enabled_drivers is set to DISABLE_ALL, " @@ -278,7 +278,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:130 +#: reference_guc.xml:131 #, no-c-format msgid "" "In the standard PostGIS installation, postgis.gdal_enabled_driverspostgis.gdal_enabled_drivers" msgstr "" #. Tag: para -#: reference_guc.xml:149 +#: reference_guc.xml:150 #, no-c-format msgid "Sets backend for all new connections to database" msgstr "" #. Tag: programlisting -#: reference_guc.xml:150 +#: reference_guc.xml:151 #, no-c-format msgid "" "ALTER DATABASE mygisdb SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';" msgstr "" #. Tag: para -#: reference_guc.xml:152 +#: reference_guc.xml:153 #, no-c-format msgid "" "Sets default enabled drivers for all new connections to server. Requires " @@ -323,7 +323,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_guc.xml:154 +#: reference_guc.xml:155 #, no-c-format msgid "" "ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';\n" @@ -331,7 +331,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_guc.xml:156 +#: reference_guc.xml:157 #, no-c-format msgid "" "SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';\n" @@ -339,31 +339,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:158 +#: reference_guc.xml:159 #, no-c-format msgid "Enable all GDAL Drivers" msgstr "" #. Tag: programlisting -#: reference_guc.xml:159 +#: reference_guc.xml:160 #, no-c-format msgid "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';" msgstr "" #. Tag: para -#: reference_guc.xml:161 +#: reference_guc.xml:162 #, no-c-format msgid "Disable all GDAL Drivers" msgstr "" #. Tag: programlisting -#: reference_guc.xml:162 +#: reference_guc.xml:163 #, no-c-format msgid "SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';" msgstr "" #. Tag: para -#: reference_guc.xml:167 +#: reference_guc.xml:168 #, no-c-format msgid "" ", , , " @@ -372,19 +372,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_guc.xml:180 +#: reference_guc.xml:181 #, no-c-format msgid "postgis.enable_outdb_rasters" msgstr "" #. Tag: refpurpose -#: reference_guc.xml:181 +#: reference_guc.xml:182 #, no-c-format msgid "A boolean configuration option to enable access to out-db raster bands." msgstr "" #. Tag: para -#: reference_guc.xml:188 +#: reference_guc.xml:189 #, no-c-format msgid "" "A boolean configuration option to enable access to out-db raster bands. This " @@ -393,7 +393,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:192 +#: reference_guc.xml:193 #, no-c-format msgid "" "The initial value of postgis.enable_outdb_rasters may " @@ -403,7 +403,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:197 +#: reference_guc.xml:198 #, no-c-format msgid "" "Even if postgis.enable_outdb_rasters is True, the GUC " @@ -412,7 +412,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_guc.xml:203 +#: reference_guc.xml:204 #, no-c-format msgid "" "In the standard PostGIS installation, postgis.enable_outdb_rasterspostgis.enable_outdb_rasters" msgstr "" #. Tag: programlisting -#: reference_guc.xml:216 +#: reference_guc.xml:217 #, no-c-format msgid "" "SET postgis.enable_outdb_rasters TO True;\n" diff --git a/doc/po/templates/reference_input.xml.pot b/doc/po/templates/reference_input.xml.pot new file mode 100644 index 000000000..967a979d9 --- /dev/null +++ b/doc/po/templates/reference_input.xml.pot @@ -0,0 +1,2373 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_input.xml:6 +#, no-c-format +msgid "" +"These functions create geometry objects from various textual or binary " +"formats." +msgstr "" + +#. Tag: title +#: reference_input.xml:10 +#, no-c-format +msgid "Geometry Input" +msgstr "" + +#. Tag: title +#: reference_input.xml:13 +#, no-c-format +msgid "Well-Known Text (WKT)" +msgstr "" + +#. Tag: refname +#: reference_input.xml:17 +#, no-c-format +msgid "ST_BdPolyFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:19 +#, no-c-format +msgid "" +"Construct a Polygon given an arbitrary collection of closed " +"linestrings as a MultiLineString Well-Known text representation." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:25 +#, no-c-format +msgid "" +"geometry ST_BdPolyFromText " +"text WKT " +"integer srid" +msgstr "" + +#. Tag: title +#: reference_input.xml:34 reference_input.xml:84 reference_input.xml:131 +#: reference_input.xml:160 reference_input.xml:195 reference_input.xml:245 +#: reference_input.xml:289 reference_input.xml:319 reference_input.xml:374 +#: reference_input.xml:434 reference_input.xml:495 reference_input.xml:556 +#: reference_input.xml:613 reference_input.xml:669 reference_input.xml:712 +#: reference_input.xml:744 reference_input.xml:785 reference_input.xml:840 +#: reference_input.xml:892 reference_input.xml:960 reference_input.xml:1024 +#: reference_input.xml:1069 reference_input.xml:1103 reference_input.xml:1144 +#: reference_input.xml:1187 reference_input.xml:1272 reference_input.xml:1312 +#: reference_input.xml:1361 reference_input.xml:1400 reference_input.xml:1431 +#: reference_input.xml:1472 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_input.xml:36 +#, no-c-format +msgid "" +"Construct a Polygon given an arbitrary collection of closed " +"linestrings as a MultiLineString Well-Known text representation." +msgstr "" + +#. Tag: para +#: reference_input.xml:41 +#, 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_input.xml:47 reference_input.xml:100 reference_input.xml:209 +#: reference_input.xml:390 reference_input.xml:450 reference_input.xml:572 +#: reference_input.xml:680 reference_input.xml:917 reference_input.xml:983 +#, no-c-format +msgid "&sfs_compliant; s3.2.6.2" +msgstr "" + +#. Tag: para +#: reference_input.xml:48 reference_input.xml:101 +#, no-c-format +msgid "Performed by the GEOS module." +msgstr "" + +#. Tag: para +#: reference_input.xml:49 reference_input.xml:102 +#, no-c-format +msgid "Availability: 1.1.0" +msgstr "" + +#. Tag: title +#: reference_input.xml:60 reference_input.xml:112 reference_input.xml:141 +#: reference_input.xml:165 reference_input.xml:223 reference_input.xml:265 +#: reference_input.xml:294 reference_input.xml:344 reference_input.xml:404 +#: reference_input.xml:464 reference_input.xml:525 reference_input.xml:586 +#: reference_input.xml:641 reference_input.xml:692 reference_input.xml:716 +#: reference_input.xml:763 reference_input.xml:812 reference_input.xml:863 +#: reference_input.xml:931 reference_input.xml:995 reference_input.xml:1049 +#: reference_input.xml:1073 reference_input.xml:1119 reference_input.xml:1160 +#: reference_input.xml:1240 reference_input.xml:1291 reference_input.xml:1339 +#: reference_input.xml:1375 reference_input.xml:1407 reference_input.xml:1448 +#: reference_input.xml:1488 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_input.xml:61 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:67 +#, no-c-format +msgid "ST_BdMPolyFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:68 +#, 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_input.xml:75 +#, no-c-format +msgid "" +"geometry ST_BdMPolyFromText " +"text WKT " +"integer srid" +msgstr "" + +#. Tag: para +#: reference_input.xml:86 +#, 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_input.xml:91 +#, 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 ST_BdPolyFromText if you're sure a " +"single POLYGON will result from operation, or see ST_BuildArea() for a postgis-specific approach." +msgstr "" + +#. Tag: para +#: reference_input.xml:113 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:119 +#, no-c-format +msgid "ST_GeogFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:120 reference_input.xml:149 +#, no-c-format +msgid "" +"Return a specified geography value from Well-Known Text representation or " +"extended (WKT)." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:124 +#, no-c-format +msgid "" +"geography ST_GeogFromText " +"text EWKT" +msgstr "" + +#. Tag: para +#: reference_input.xml:132 +#, no-c-format +msgid "" +"Returns a geography object from the well-known text or extended well-known " +"representation. SRID 4326 is assumed if unspecified. This is an alias for " +"ST_GeographyFromText. Points are always expressed in long lat form." +msgstr "" + +#. Tag: title +#: reference_input.xml:137 reference_input.xml:216 reference_input.xml:259 +#: reference_input.xml:340 reference_input.xml:397 reference_input.xml:457 +#: reference_input.xml:518 reference_input.xml:579 reference_input.xml:637 +#: reference_input.xml:685 reference_input.xml:758 reference_input.xml:799 +#: reference_input.xml:856 reference_input.xml:924 reference_input.xml:988 +#: reference_input.xml:1042 reference_input.xml:1115 reference_input.xml:1156 +#: reference_input.xml:1284 reference_input.xml:1370 reference_input.xml:1441 +#: reference_input.xml:1484 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:138 +#, 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 || ')');\n" +"\n" +"--- specify a geography point using EPSG:4267, NAD27\n" +"SELECT ST_AsEWKT(ST_GeogFromText('SRID=4267;POINT(-77.0092 38.889588)'));" +msgstr "" + +#. Tag: para +#: reference_input.xml:142 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:148 +#, no-c-format +msgid "ST_GeographyFromText" +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:153 +#, no-c-format +msgid "" +"geography ST_GeographyFromText " +"text EWKT" +msgstr "" + +#. Tag: para +#: reference_input.xml:161 +#, no-c-format +msgid "" +"Returns a geography object from the well-known text representation. SRID " +"4326 is assumed if unspecified." +msgstr "" + +#. Tag: para +#: reference_input.xml:166 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:172 +#, no-c-format +msgid "ST_GeomCollFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:174 +#, no-c-format +msgid "" +"Makes a collection Geometry from collection WKT with the given SRID. If SRID " +"is not given, it defaults to 0." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:179 +#, no-c-format +msgid "" +" geometry ST_GeomCollFromText text WKT " +"integer srid geometry " +"ST_GeomCollFromText text WKT " +msgstr "" + +#. Tag: para +#: reference_input.xml:197 +#, no-c-format +msgid "" +"Makes a collection Geometry from the Well-Known-Text (WKT) representation " +"with the given SRID. If SRID is not given, it defaults to 0." +msgstr "" + +#. Tag: para +#: reference_input.xml:200 reference_input.xml:439 reference_input.xml:500 +#: reference_input.xml:561 reference_input.xml:675 +#, no-c-format +msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite" +msgstr "" + +#. Tag: para +#: reference_input.xml:202 +#, no-c-format +msgid "Returns null if the WKT is not a GEOMETRYCOLLECTION" +msgstr "" + +#. Tag: para +#: reference_input.xml:204 +#, 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_input.xml:210 +#, no-c-format +msgid "&sqlmm_compliant;" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:218 +#, no-c-format +msgid "" +"SELECT ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(1 2, 3 " +"4))');" +msgstr "" + +#. Tag: para +#: reference_input.xml:225 reference_input.xml:588 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:231 +#, no-c-format +msgid "ST_GeomFromEWKT" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:232 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Extended Well-Known Text " +"representation (EWKT)." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:237 +#, no-c-format +msgid "" +"geometry ST_GeomFromEWKT " +"text EWKT" +msgstr "" + +#. Tag: para +#: reference_input.xml:246 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known " +"text (EWKT) representation." +msgstr "" + +#. Tag: para +#: reference_input.xml:248 +#, 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: para +#: reference_input.xml:251 reference_input.xml:791 reference_input.xml:1207 +#: reference_input.xml:1403 +#, no-c-format +msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced." +msgstr "" + +#. Tag: para +#: reference_input.xml:252 reference_input.xml:792 reference_input.xml:1037 +#: reference_input.xml:1209 reference_input.xml:1280 reference_input.xml:1326 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_input.xml:253 reference_input.xml:333 reference_input.xml:753 +#: reference_input.xml:793 reference_input.xml:851 reference_input.xml:1038 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_input.xml:254 reference_input.xml:794 reference_input.xml:1210 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_input.xml:255 reference_input.xml:795 reference_input.xml:1211 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:260 +#, 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 "" + +#. Tag: programlisting +#: reference_input.xml:261 +#, 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_input.xml:262 +#, 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_input.xml:266 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:272 +#, no-c-format +msgid "ST_GeometryFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:273 reference_input.xml:701 +#, 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_input.xml:276 +#, no-c-format +msgid "" +" geometry ST_GeometryFromText text WKT " +" geometry " +"ST_GeometryFromText text WKT integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:290 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_input.xml:291 reference_input.xml:332 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.40" +msgstr "" + +#. Tag: refname +#: reference_input.xml:301 +#, no-c-format +msgid "ST_GeomFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:302 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Well-Known Text representation " +"(WKT)." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:305 +#, no-c-format +msgid "" +" geometry ST_GeomFromText text WKT " +" geometry " +"ST_GeomFromText text " +"WKT integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:321 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC Well-Known text " +"representation." +msgstr "" + +#. Tag: para +#: reference_input.xml:325 +#, no-c-format +msgid "" +"There are two variants of ST_GeomFromText function. The first takes no SRID " +"and returns a geometry with no defined spatial reference system (SRID=0). " +"The second takes a SRID as the second argument and returns a geometry that " +"includes this SRID as part of its metadata." +msgstr "" + +#. Tag: para +#: reference_input.xml:331 reference_input.xml:632 +#, no-c-format +msgid "&sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite." +msgstr "" + +#. Tag: para +#: reference_input.xml:334 +#, 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_input.xml:341 +#, 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 "" + +#. Tag: para +#: reference_input.xml:345 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:352 +#, no-c-format +msgid "ST_LineFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:354 +#, no-c-format +msgid "" +"Makes a Geometry from WKT representation with the given SRID. If SRID is not " +"given, it defaults to 0." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:359 +#, no-c-format +msgid "" +" geometry ST_LineFromText text WKT " +" geometry " +"ST_LineFromText text " +"WKT integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:376 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not given, it " +"defaults to 0. If WKT passed in is not a LINESTRING, then null is returned." +msgstr "" + +#. Tag: para +#: reference_input.xml:380 reference_input.xml:905 +#, no-c-format +msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite." +msgstr "" + +#. Tag: para +#: reference_input.xml:385 +#, 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_input.xml:391 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.2.8" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:399 +#, 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 "" + +#. Tag: refname +#: reference_input.xml:412 +#, no-c-format +msgid "ST_MLineFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:414 +#, no-c-format +msgid "Return a specified ST_MultiLineString value from WKT representation." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:418 +#, no-c-format +msgid "" +" geometry ST_MLineFromText text WKT " +"integer srid geometry ST_MLineFromText text WKT " +msgstr "" + +#. Tag: para +#: reference_input.xml:436 +#, no-c-format +msgid "" +"Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is " +"not given, it defaults to 0." +msgstr "" + +#. Tag: para +#: reference_input.xml:442 +#, no-c-format +msgid "Returns null if the WKT is not a MULTILINESTRING" +msgstr "" + +#. Tag: para +#: reference_input.xml:445 reference_input.xml:506 +#, 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_input.xml:451 +#, no-c-format +msgid "&sqlmm_compliant;SQL-MM 3: 9.4.4" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:459 +#, no-c-format +msgid "SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');" +msgstr "" + +#. Tag: refname +#: reference_input.xml:472 +#, no-c-format +msgid "ST_MPointFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:474 reference_input.xml:650 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not " +"given, it defaults to 0." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:479 +#, no-c-format +msgid "" +" geometry ST_MPointFromText text WKT " +"integer srid geometry " +"ST_MPointFromText text WKT " +msgstr "" + +#. Tag: para +#: reference_input.xml:497 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not given, " +"it defaults to 0." +msgstr "" + +#. Tag: para +#: reference_input.xml:503 +#, no-c-format +msgid "Returns null if the WKT is not a MULTIPOINT" +msgstr "" + +#. Tag: para +#: reference_input.xml:511 +#, no-c-format +msgid "&sfs_compliant; 3.2.6.2" +msgstr "" + +#. Tag: para +#: reference_input.xml:512 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 9.2.4" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:520 +#, 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 "" + +#. Tag: refname +#: reference_input.xml:533 +#, no-c-format +msgid "ST_MPolyFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:535 +#, no-c-format +msgid "" +"Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not " +"given, it defaults to 0." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:540 +#, no-c-format +msgid "" +" geometry ST_MPolyFromText text WKT " +"integer srid geometry ST_MPolyFromText text WKT " +msgstr "" + +#. Tag: para +#: reference_input.xml:558 +#, no-c-format +msgid "" +"Makes a MultiPolygon from WKT with the given SRID. If SRID is not given, it " +"defaults to 0." +msgstr "" + +#. Tag: para +#: reference_input.xml:564 +#, no-c-format +msgid "Throws an error if the WKT is not a MULTIPOLYGON" +msgstr "" + +#. Tag: para +#: reference_input.xml:567 +#, 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_input.xml:573 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 9.6.4" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:581 +#, 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 "" + +#. Tag: refname +#: reference_input.xml:594 +#, no-c-format +msgid "ST_PointFromText" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:595 +#, 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_input.xml:599 +#, no-c-format +msgid "" +" geometry ST_PointFromText text WKT " +" geometry " +"ST_PointFromText text " +"WKT integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:615 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text " +"representation. If SRID is not given, it defaults to unknown (currently 0). " +"If geometry is not a WKT point representation, returns null. If completely " +"invalid WKT, then throws an error." +msgstr "" + +#. Tag: para +#: reference_input.xml:621 +#, 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_input.xml:628 +#, 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 or OGC compliant alias ." +msgstr "" + +#. Tag: para +#: reference_input.xml:633 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.8" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:638 +#, no-c-format +msgid "" +"SELECT ST_PointFromText('POINT(-71.064544 42.28787)');\n" +"SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);" +msgstr "" + +#. Tag: para +#: reference_input.xml:642 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:648 +#, no-c-format +msgid "ST_PolygonFromText" +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:655 +#, no-c-format +msgid "" +" geometry ST_PolygonFromText text WKT " +" geometry " +"ST_PolygonFromText text WKT integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:671 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not given, it " +"defaults to 0. Returns null if WKT is not a polygon." +msgstr "" + +#. Tag: para +#: reference_input.xml:678 +#, 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_input.xml:681 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.3.6" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:687 +#, 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 "" + +#. Tag: refname +#: reference_input.xml:700 +#, no-c-format +msgid "ST_WKTToSQL" +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:705 +#, no-c-format +msgid "" +"geometry ST_WKTToSQL " +"text WKT" +msgstr "" + +#. Tag: para +#: reference_input.xml:713 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.34" +msgstr "" + +#. Tag: title +#: reference_input.xml:725 +#, no-c-format +msgid "Well-Known Binary (WKB)" +msgstr "" + +#. Tag: refname +#: reference_input.xml:729 +#, no-c-format +msgid "ST_GeogFromWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:730 +#, 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_input.xml:736 +#, no-c-format +msgid "" +"geography ST_GeogFromWKB " +"bytea wkb" +msgstr "" + +#. Tag: para +#: reference_input.xml:746 +#, no-c-format +msgid "" +"The ST_GeogFromWKB 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_input.xml:751 +#, no-c-format +msgid "If SRID is not specified, it defaults to 4326 (WGS 84 long lat)." +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:760 +#, 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_input.xml:765 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:771 +#, no-c-format +msgid "ST_GeomFromEWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:772 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Extended Well-Known Binary " +"representation (EWKB)." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:777 +#, no-c-format +msgid "" +"geometry ST_GeomFromEWKB " +"bytea EWKB" +msgstr "" + +#. Tag: para +#: reference_input.xml:786 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known " +"binary (EWKT) representation." +msgstr "" + +#. Tag: para +#: reference_input.xml:788 +#, 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_input.xml:800 +#, 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 "" + +#. Tag: para +#: reference_input.xml:802 +#, 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_input.xml:804 +#, 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 "" + +#. Tag: para +#: reference_input.xml:806 +#, 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 off. 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_input.xml:809 +#, 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 "" + +#. Tag: para +#: reference_input.xml:813 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:819 +#, no-c-format +msgid "ST_GeomFromWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:820 +#, no-c-format +msgid "" +"Creates a geometry instance from a Well-Known Binary geometry representation " +"(WKB) and optional SRID." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:825 reference_input.xml:1009 +#, no-c-format +msgid "" +" geometry ST_GeomFromWKB bytea geom geometry " +"ST_GeomFromWKB bytea " +"geom integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:842 +#, no-c-format +msgid "" +"The ST_GeomFromWKB function, takes a well-known binary " +"representation of a geometry and a Spatial Reference System ID " +"(SRID) 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_input.xml:848 +#, no-c-format +msgid "If SRID is not specified, it defaults to 0 (Unknown)." +msgstr "" + +#. Tag: para +#: reference_input.xml:849 +#, no-c-format +msgid "" +"&sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite" +msgstr "" + +#. Tag: para +#: reference_input.xml:850 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.41" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:858 +#, 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_input.xml:865 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:871 +#, no-c-format +msgid "ST_LineFromWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:873 +#, no-c-format +msgid "Makes a LINESTRING from WKB with the given SRID" +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:877 +#, no-c-format +msgid "" +" geometry ST_LineFromWKB bytea WKB " +" geometry ST_LineFromWKB bytea WKB integer srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:894 +#, no-c-format +msgid "" +"The ST_LineFromWKB function, takes a well-known binary " +"representation of geometry and a Spatial Reference System ID (SRID) and creates an instance of the appropriate geometry type - in this " +"case, a LINESTRING geometry. This function plays the role " +"of the Geometry Factory in SQL." +msgstr "" + +#. Tag: para +#: reference_input.xml:900 +#, no-c-format +msgid "" +"If an SRID is not specified, it defaults to 0. NULL is " +"returned if the input bytea does not represent a " +"LINESTRING." +msgstr "" + +#. Tag: para +#: reference_input.xml:910 +#, no-c-format +msgid "" +"If you know all your geometries are LINESTRINGs, its more " +"efficient to just use . This function just " +"calls and adds additional validation that " +"it returns a linestring." +msgstr "" + +#. Tag: para +#: reference_input.xml:918 reference_input.xml:984 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.2.9" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:926 +#, 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 "" + +#. Tag: para +#: reference_input.xml:933 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:939 +#, no-c-format +msgid "ST_LinestringFromWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:941 +#, no-c-format +msgid "Makes a geometry from WKB with the given SRID." +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:945 +#, no-c-format +msgid "" +" geometry ST_LinestringFromWKB bytea WKB " +" geometry " +"ST_LinestringFromWKB bytea WKB integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:962 +#, no-c-format +msgid "" +"The ST_LinestringFromWKB function, takes a well-known " +"binary representation of geometry and a Spatial Reference System ID " +"(SRID) and creates an instance of the appropriate " +"geometry type - in this case, a LINESTRING geometry. This " +"function plays the role of the Geometry Factory in SQL." +msgstr "" + +#. Tag: para +#: reference_input.xml:968 +#, no-c-format +msgid "" +"If an SRID is not specified, it defaults to 0. NULL is " +"returned if the input bytea does not represent a " +"LINESTRING geometry. This an alias for ." +msgstr "" + +#. Tag: para +#: reference_input.xml:973 +#, no-c-format +msgid "OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite." +msgstr "" + +#. Tag: para +#: reference_input.xml:977 +#, no-c-format +msgid "" +"If you know all your geometries are LINESTRINGs, it's " +"more efficient to just use . This function " +"just calls and adds additional validation " +"that it returns a LINESTRING." +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:990 +#, 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 "" + +#. Tag: para +#: reference_input.xml:997 reference_input.xml:1051 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:1003 +#, no-c-format +msgid "ST_PointFromWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1005 +#, no-c-format +msgid "Makes a geometry from WKB with the given SRID" +msgstr "" + +#. Tag: para +#: reference_input.xml:1026 +#, no-c-format +msgid "" +"The ST_PointFromWKB function, takes a well-known binary " +"representation of geometry and a Spatial Reference System ID (SRID) and creates an instance of the appropriate geometry type - in this " +"case, a POINT geometry. This function plays the role of " +"the Geometry Factory in SQL." +msgstr "" + +#. Tag: para +#: reference_input.xml:1032 +#, no-c-format +msgid "" +"If an SRID is not specified, it defaults to 0. NULL is " +"returned if the input bytea does not represent a " +"POINT geometry." +msgstr "" + +#. Tag: para +#: reference_input.xml:1035 +#, no-c-format +msgid "&sfs_compliant; s3.2.7.2" +msgstr "" + +#. Tag: para +#: reference_input.xml:1036 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.9" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1044 +#, 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 "" + +#. Tag: refname +#: reference_input.xml:1057 +#, no-c-format +msgid "ST_WKBToSQL" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1058 +#, 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_input.xml:1062 +#, no-c-format +msgid "" +"geometry ST_WKBToSQL " +"bytea WKB" +msgstr "" + +#. Tag: para +#: reference_input.xml:1070 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.36" +msgstr "" + +#. Tag: title +#: reference_input.xml:1083 +#, no-c-format +msgid "Other Formats" +msgstr "" + +#. Tag: refname +#: reference_input.xml:1087 +#, no-c-format +msgid "ST_Box2dFromGeoHash" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1089 +#, no-c-format +msgid "Return a BOX2D from a GeoHash string." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:1094 +#, no-c-format +msgid "" +"box2d ST_Box2dFromGeoHash " +"text geohash " +"integer " +"precision=full_precision_of_geohash" +msgstr "" + +#. Tag: para +#: reference_input.xml:1105 +#, no-c-format +msgid "Return a BOX2D from a GeoHash string." +msgstr "" + +#. Tag: para +#: reference_input.xml:1107 +#, no-c-format +msgid "" +"If no precision is specficified ST_Box2dFromGeoHash " +"returns a BOX2D based on full precision of the input GeoHash string." +msgstr "" + +#. Tag: para +#: reference_input.xml:1109 +#, no-c-format +msgid "" +"If precision is specified ST_Box2dFromGeoHash will use " +"that many characters from the GeoHash to create the BOX2D. Lower precision " +"values results in larger BOX2Ds and larger values increase the precision." +msgstr "" + +#. Tag: para +#: reference_input.xml:1111 reference_input.xml:1152 reference_input.xml:1480 +#, no-c-format +msgid "Availability: 2.1.0" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1116 +#, no-c-format +msgid "" +"" +msgstr "" + +#. Tag: para +#: reference_input.xml:1121 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:1128 +#, no-c-format +msgid "ST_GeomFromGeoHash" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1130 +#, no-c-format +msgid "Return a geometry from a GeoHash string." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:1135 +#, no-c-format +msgid "" +"geometry ST_GeomFromGeoHash " +"text geohash " +"integer " +"precision=full_precision_of_geohash" +msgstr "" + +#. Tag: para +#: reference_input.xml:1146 +#, no-c-format +msgid "" +"Return a geometry from a GeoHash string. The geometry will be a polygon " +"representing the GeoHash bounds." +msgstr "" + +#. Tag: para +#: reference_input.xml:1148 +#, no-c-format +msgid "" +"If no precision is specified ST_GeomFromGeoHash returns a " +"polygon based on full precision of the input GeoHash string." +msgstr "" + +#. Tag: para +#: reference_input.xml:1150 +#, no-c-format +msgid "" +"If precision is specified ST_GeomFromGeoHash will use " +"that many characters from the GeoHash to create the polygon." +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1157 +#, no-c-format +msgid "" +"" +msgstr "" + +#. Tag: para +#: reference_input.xml:1162 +#, no-c-format +msgid "" +",, " +msgstr "" + +#. Tag: refname +#: reference_input.xml:1168 +#, no-c-format +msgid "ST_GeomFromGML" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1169 +#, no-c-format +msgid "" +"Takes as input GML representation of geometry and outputs a PostGIS geometry " +"object" +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:1173 +#, no-c-format +msgid "" +" geometry ST_GeomFromGML text geomgml geometry " +"ST_GeomFromGML text " +"geomgml integer " +"srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:1188 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC GML representation." +msgstr "" + +#. Tag: para +#: reference_input.xml:1189 +#, 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_input.xml:1190 +#, no-c-format +msgid "" +"OGC GML versions supported: GML 3.2.1 " +"Namespace GML 3.1.1 Simple Features " +"profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility) GML 2.1.2 OGC " +"GML standards, cf: http://www.opengeospatial.org/standards/gml:" +msgstr "" + +#. Tag: para +#: reference_input.xml:1206 reference_input.xml:1402 +#, no-c-format +msgid "Availability: 1.5, requires libxml2 1.6+" +msgstr "" + +#. Tag: para +#: reference_input.xml:1208 reference_input.xml:1404 +#, no-c-format +msgid "Enhanced: 2.0.0 default srid optional parameter added." +msgstr "" + +#. Tag: para +#: reference_input.xml:1212 +#, 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_input.xml:1214 +#, 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_input.xml:1216 +#, 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_input.xml:1218 +#, no-c-format +msgid "ST_GeomFromGML function not support SQL/MM curves geometries." +msgstr "" + +#. Tag: title +#: reference_input.xml:1224 reference_input.xml:1334 +#, no-c-format +msgid "Examples - A single geometry with srsName" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1225 +#, no-c-format +msgid "" +"SELECT ST_GeomFromGML('\n" +" \n" +" -71.16028,42.258729 -71.160837,42.259112 " +"-71.161143,42.25932\n" +" \n" +" ']]>);" +msgstr "" + +#. Tag: title +#: reference_input.xml:1229 +#, no-c-format +msgid "Examples - XLink usage" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1230 +#, no-c-format +msgid "" +"SELECT \n" +" \n" +" 42.258729 " +"-71.16028\n" +" \n" +" 42.259112 -71.160837\n" +" \n" +" \n" +" \n" +" ');]]>);" +msgstr "" + +#. Tag: title +#: reference_input.xml:1234 +#, no-c-format +msgid "Examples - Polyhedral Surface" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1235 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(\n" +"\n" +" \n" +" \n" +" 0 0 0 0 0 1 0 1 1 0 1 " +"0 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 0 0 0 1 0 1 1 0 1 " +"0 0 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 0 0 1 0 0 1 0 1 0 " +"0 1 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" 1 1 0 1 1 1 1 0 1 1 " +"0 0 1 1 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 1 0 0 1 1 1 1 1 1 " +"1 0 0 1 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 0 1 1 0 1 1 1 1 0 " +"1 1 0 0 1\n" +" \n" +" \n" +"\n" +"']]>));\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_input.xml:1241 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:1247 +#, no-c-format +msgid "ST_GeomFromGeoJSON" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1248 +#, no-c-format +msgid "" +"Takes as input a geojson representation of a geometry and outputs a PostGIS " +"geometry object" +msgstr "" + +#. Tag: funcsynopsis +#: reference_input.xml:1252 +#, no-c-format +msgid "" +" geometry ST_GeomFromGeoJSON text geomjson geometry " +"ST_GeomFromGeoJSON json geomjson " +" geometry ST_GeomFromGeoJSON jsonb geomjson " +msgstr "" + +#. Tag: para +#: reference_input.xml:1273 +#, no-c-format +msgid "Constructs a PostGIS geometry object from the GeoJSON representation." +msgstr "" + +#. Tag: para +#: reference_input.xml:1274 +#, 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_input.xml:1276 +#, no-c-format +msgid "Enhanced: 2.5.0 can now accept json and jsonb as inputs." +msgstr "" + +#. Tag: para +#: reference_input.xml:1277 +#, no-c-format +msgid "Availability: 2.0.0 requires - JSON-C >= 0.9" +msgstr "" + +#. Tag: para +#: reference_input.xml:1278 +#, 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 for " +"details." +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1285 +#, 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 "" + +#. Tag: programlisting +#: reference_input.xml:1286 +#, 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_input.xml:1292 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:1298 +#, no-c-format +msgid "ST_GeomFromKML" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1299 +#, no-c-format +msgid "" +"Takes as input KML representation of geometry and outputs a PostGIS geometry " +"object" +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:1304 +#, no-c-format +msgid "" +"geometry ST_GeomFromKML " +"text geomkml" +msgstr "" + +#. Tag: para +#: reference_input.xml:1313 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC KML representation." +msgstr "" + +#. Tag: para +#: reference_input.xml:1314 +#, 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_input.xml:1315 +#, no-c-format +msgid "" +"OGC KML versions supported: KML 2.2.0 " +"Namespace OGC KML standards, cf: http://www." +"opengeospatial.org/standards/kml:" +msgstr "" + +#. Tag: para +#: reference_input.xml:1325 +#, no-c-format +msgid "Availability: 1.5, requires libxml2 2.6+" +msgstr "" + +#. Tag: para +#: reference_input.xml:1328 +#, no-c-format +msgid "ST_GeomFromKML function not support SQL/MM curves geometries." +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1335 +#, no-c-format +msgid "" +"SELECT ST_GeomFromKML('\n" +" -71.1663,42.2614\n" +" -71.1667,42.2616\n" +" ']]>);" +msgstr "" + +#. Tag: para +#: reference_input.xml:1340 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_input.xml:1346 +#, no-c-format +msgid "ST_GeomFromTWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1347 +#, no-c-format +msgid "" +"Creates a geometry instance from a TWKB (\"Tiny Well-Known Binary\") " +"geometry representation." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:1353 +#, no-c-format +msgid "" +"geometry ST_GeomFromTWKB " +"bytea twkb" +msgstr "" + +#. Tag: para +#: reference_input.xml:1363 +#, no-c-format +msgid "" +"The ST_GeomFromTWKB function, takes a a TWKB (\"Tiny Well-" +"Known Binary\") geometry representation (WKB) and creates an " +"instance of the appropriate geometry type." +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1372 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_GeomFromTWKB(ST_AsTWKB('LINESTRING(126 34, 127 35)'::" +"geometry)));\n" +"\n" +" st_astext\n" +"-----------------------------\n" +" LINESTRING(126 34, 127 35)\n" +"(1 row)\n" +"\n" +"\n" +"SELECT ST_AsEWKT(\n" +" ST_GeomFromTWKB(E'\\\\x620002f7f40dbce4040105')\n" +");\n" +" st_asewkt\n" +"------------------------------------------------------\n" +"LINESTRING(-113.98 39.198,-113.981 39.195)\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_input.xml:1383 +#, no-c-format +msgid "ST_GMLToSQL" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1384 +#, 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_input.xml:1387 +#, no-c-format +msgid "" +" geometry ST_GMLToSQL " +"text geomgml geometry ST_GMLToSQL text geomgml integer srid " +msgstr "" + +#. Tag: para +#: reference_input.xml:1401 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support)." +msgstr "" + +#. Tag: para +#: reference_input.xml:1408 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_input.xml:1415 +#, no-c-format +msgid "ST_LineFromEncodedPolyline" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1417 +#, no-c-format +msgid "Creates a LineString from an Encoded Polyline." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:1422 +#, no-c-format +msgid "" +"geometry ST_LineFromEncodedPolyline " +"text polyline " +"integer precision=5" +msgstr "" + +#. Tag: para +#: reference_input.xml:1433 +#, no-c-format +msgid "Creates a LineString from an Encoded Polyline string." +msgstr "" + +#. Tag: para +#: reference_input.xml:1434 +#, no-c-format +msgid "" +"Optional precision specifies how many decimal places will " +"be preserved in Encoded Polyline. Value should be the same on encoding and " +"decoding, or coordinates will be incorrect." +msgstr "" + +#. Tag: para +#: reference_input.xml:1436 +#, no-c-format +msgid "" +"See http://developers.google.com/maps/documentation/utilities/" +"polylinealgorithm" +msgstr "" + +#. Tag: para +#: reference_input.xml:1437 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1443 +#, no-c-format +msgid "" +"-- Create a line string from a polyline\n" +"SELECT ST_AsEWKT(ST_LineFromEncodedPolyline('_p~iF~ps|" +"U_ulLnnqC_mqNvxq`@'));\n" +"-- result --\n" +"SRID=4326;LINESTRING(-120.2 38.5,-120.95 40.7,-126.453 43.252)\n" +"\n" +"-- Select different precision that was used for polyline encoding\n" +"SELECT ST_AsEWKT(ST_LineFromEncodedPolyline('_p~iF~ps|" +"U_ulLnnqC_mqNvxq`@',6));\n" +"-- result --\n" +"SRID=4326;LINESTRING(-12.02 3.85,-12.095 4.07,-12.6453 4.3252)" +msgstr "" + +#. Tag: refname +#: reference_input.xml:1456 +#, no-c-format +msgid "ST_PointFromGeoHash" +msgstr "" + +#. Tag: refpurpose +#: reference_input.xml:1458 +#, no-c-format +msgid "Return a point from a GeoHash string." +msgstr "" + +#. Tag: funcprototype +#: reference_input.xml:1463 +#, no-c-format +msgid "" +"point ST_PointFromGeoHash " +"text geohash " +"integer " +"precision=full_precision_of_geohash" +msgstr "" + +#. Tag: para +#: reference_input.xml:1474 +#, no-c-format +msgid "" +"Return a point from a GeoHash string. The point represents the center point " +"of the GeoHash." +msgstr "" + +#. Tag: para +#: reference_input.xml:1476 +#, no-c-format +msgid "" +"If no precision is specified ST_PointFromGeoHash returns " +"a point based on full precision of the input GeoHash string." +msgstr "" + +#. Tag: para +#: reference_input.xml:1478 +#, no-c-format +msgid "" +"If precision is specified ST_PointFromGeoHash will use " +"that many characters from the GeoHash to create the point." +msgstr "" + +#. Tag: programlisting +#: reference_input.xml:1485 +#, no-c-format +msgid "" +"" +msgstr "" + +#. Tag: para +#: reference_input.xml:1490 +#, no-c-format +msgid "" +", , " +msgstr "" diff --git a/doc/po/templates/reference_lrs.xml.pot b/doc/po/templates/reference_lrs.xml.pot index e8b39ef94..b9ce7e93e 100644 --- a/doc/po/templates/reference_lrs.xml.pot +++ b/doc/po/templates/reference_lrs.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -36,7 +36,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_lrs.xml:15 +#: reference_lrs.xml:15 reference_lrs.xml:83 #, no-c-format msgid "" "geometry ST_LineInterpolatePoint " @@ -46,15 +46,16 @@ msgid "" msgstr "" #. Tag: title -#: reference_lrs.xml:24 reference_lrs.xml:93 reference_lrs.xml:156 -#: reference_lrs.xml:208 reference_lrs.xml:275 reference_lrs.xml:333 -#: reference_lrs.xml:387 reference_lrs.xml:432 reference_lrs.xml:476 +#: reference_lrs.xml:24 reference_lrs.xml:92 reference_lrs.xml:151 +#: reference_lrs.xml:214 reference_lrs.xml:266 reference_lrs.xml:333 +#: reference_lrs.xml:390 reference_lrs.xml:446 reference_lrs.xml:493 +#: reference_lrs.xml:537 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_lrs.xml:26 +#: reference_lrs.xml:26 reference_lrs.xml:94 #, no-c-format msgid "" "Returns a point interpolated along a line. First argument must be a " @@ -63,7 +64,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:30 reference_lrs.xml:219 +#: reference_lrs.xml:30 reference_lrs.xml:277 #, no-c-format msgid "" "See for computing the line location " @@ -91,16 +92,17 @@ msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Interpolate_Point." msgstr "" #. Tag: para -#: reference_lrs.xml:40 reference_lrs.xml:109 reference_lrs.xml:230 -#: reference_lrs.xml:395 reference_lrs.xml:438 reference_lrs.xml:482 +#: reference_lrs.xml:40 reference_lrs.xml:167 reference_lrs.xml:288 +#: reference_lrs.xml:456 reference_lrs.xml:499 reference_lrs.xml:543 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: title -#: reference_lrs.xml:45 reference_lrs.xml:114 reference_lrs.xml:173 -#: reference_lrs.xml:234 reference_lrs.xml:298 reference_lrs.xml:352 -#: reference_lrs.xml:399 reference_lrs.xml:442 reference_lrs.xml:486 +#: reference_lrs.xml:45 reference_lrs.xml:109 reference_lrs.xml:172 +#: reference_lrs.xml:231 reference_lrs.xml:292 reference_lrs.xml:356 +#: reference_lrs.xml:412 reference_lrs.xml:460 reference_lrs.xml:503 +#: reference_lrs.xml:547 #, no-c-format msgid "Examples" msgstr "" @@ -149,9 +151,9 @@ msgid "" msgstr "" #. Tag: title -#: reference_lrs.xml:60 reference_lrs.xml:127 reference_lrs.xml:180 -#: reference_lrs.xml:248 reference_lrs.xml:304 reference_lrs.xml:359 -#: reference_lrs.xml:406 reference_lrs.xml:448 +#: reference_lrs.xml:60 reference_lrs.xml:117 reference_lrs.xml:185 +#: reference_lrs.xml:238 reference_lrs.xml:306 reference_lrs.xml:362 +#: reference_lrs.xml:419 reference_lrs.xml:467 reference_lrs.xml:509 #, no-c-format msgid "See Also" msgstr "" @@ -161,24 +163,81 @@ msgstr "" #, no-c-format msgid "" ", , , O" +"linkend=\"ST_LineInterpolatePoints\"/> O" msgstr "" #. Tag: refname -#: reference_lrs.xml:74 +#: reference_lrs.xml:75 +#, no-c-format +msgid "ST_3DLineInterpolatePoint" +msgstr "" + +#. Tag: refpurpose +#: reference_lrs.xml:77 +#, no-c-format +msgid "" +"Returns a point interpolated along a line in 3D. Second argument is a float8 " +"between 0 and 1 representing fraction of total length of linestring the " +"point has to be located." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:99 +#, no-c-format +msgid "" +"computes resulting point in 2D and then interpolates value for Z and M, " +"while ST_3DLineInterpolatePoint computes directly point in 3D and only M " +"value is interpolated then." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:104 +#, no-c-format +msgid "Availability: 3.0.0" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:111 +#, no-c-format +msgid "Return point 20% along 3D line" +msgstr "" + +#. Tag: programlisting +#: reference_lrs.xml:112 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DLineInterpolatePoint(the_line, 0.20))\n" +" FROM (SELECT ST_GeomFromEWKT('LINESTRING(25 50 70, 100 125 90, 150 " +"190 200)') as the_line) As foo;\n" +" st_asewkt\n" +"----------------\n" +" POINT(59.0675892910822 84.0675892910822 79.0846904776219)" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:119 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_lrs.xml:132 #, no-c-format msgid "ST_LineInterpolatePoints" msgstr "" #. Tag: refpurpose -#: reference_lrs.xml:76 +#: reference_lrs.xml:134 #, no-c-format msgid "Returns one or more points interpolated along a line." msgstr "" #. Tag: funcprototype -#: reference_lrs.xml:83 +#: reference_lrs.xml:141 #, no-c-format msgid "" "geometry ST_LineInterpolatePoints " @@ -189,7 +248,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:95 +#: reference_lrs.xml:153 #, no-c-format msgid "" "Returns one or more points interpolated along a line. First argument must be " @@ -200,7 +259,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:102 +#: reference_lrs.xml:160 #, no-c-format msgid "" "If the result has zero or one points, it will be returned as a POINT. If it " @@ -208,25 +267,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:108 +#: reference_lrs.xml:166 #, no-c-format msgid "Availability: 2.5.0" msgstr "" #. Tag: para -#: reference_lrs.xml:110 reference_lrs.xml:293 reference_lrs.xml:348 +#: reference_lrs.xml:168 reference_lrs.xml:351 reference_lrs.xml:408 #, no-c-format msgid "&M_support;" msgstr "" #. Tag: para -#: reference_lrs.xml:120 +#: reference_lrs.xml:178 #, no-c-format msgid "A linestring with the interpolated points every 20%" msgstr "" #. Tag: programlisting -#: reference_lrs.xml:123 +#: reference_lrs.xml:181 #, no-c-format msgid "" "--Return points each 20% along a 2D line\n" @@ -240,13 +299,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_lrs.xml:138 +#: reference_lrs.xml:196 #, no-c-format msgid "ST_LineLocatePoint" msgstr "" #. Tag: refpurpose -#: reference_lrs.xml:140 +#: reference_lrs.xml:198 #, no-c-format msgid "" "Returns a float between 0 and 1 representing the location of the closest " @@ -255,7 +314,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_lrs.xml:147 +#: reference_lrs.xml:205 #, no-c-format msgid "" "float8 ST_LineLocatePoint " @@ -265,7 +324,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:158 +#: reference_lrs.xml:216 #, no-c-format msgid "" "Returns a float between 0 and 1 representing the location of the closest " @@ -274,7 +333,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:162 +#: reference_lrs.xml:220 #, no-c-format msgid "" "You can use the returned location to extract a Point (, geometry ST_LineSubstring " @@ -374,7 +433,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:210 +#: reference_lrs.xml:268 #, no-c-format msgid "" "Return a linestring being a substring of the input one starting and ending " @@ -385,7 +444,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:216 +#: reference_lrs.xml:274 #, no-c-format msgid "" "If 'start' and 'end' have the same value this is equivalent to , Return a derived geometry collection value with elements that " @@ -481,7 +540,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_lrs.xml:265 +#: reference_lrs.xml:323 #, no-c-format msgid "" "geometry ST_LocateAlong " @@ -492,7 +551,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:277 +#: reference_lrs.xml:335 #, no-c-format msgid "" "Return a derived geometry collection value with elements that match " @@ -500,7 +559,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:281 reference_lrs.xml:338 +#: reference_lrs.xml:339 reference_lrs.xml:397 #, no-c-format msgid "" "If an offset is provided, the resultant will be offset to the left or right " @@ -509,7 +568,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:286 reference_lrs.xml:342 +#: reference_lrs.xml:344 reference_lrs.xml:401 #, no-c-format msgid "" "Semantic is specified by: ISO/IEC CD 13249-3:200x(E) - Text for Continuation " @@ -517,13 +576,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:289 +#: reference_lrs.xml:347 #, no-c-format msgid "Availability: 1.1.0 by old name ST_Locate_Along_Measure." msgstr "" #. Tag: para -#: reference_lrs.xml:290 +#: reference_lrs.xml:348 #, no-c-format msgid "" "Changed: 2.0.0 in prior versions this used to be called " @@ -532,13 +591,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:291 +#: reference_lrs.xml:349 #, no-c-format msgid "Use this function only for geometries with an M component" msgstr "" #. Tag: programlisting -#: reference_lrs.xml:299 +#: reference_lrs.xml:357 #, no-c-format msgid "" "SELECT ST_AsText(the_geom)\n" @@ -569,7 +628,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:306 +#: reference_lrs.xml:364 #, no-c-format msgid "" ", , geometry ST_LocateBetween " -"geometry geomA " +"geometry geom " "float8 measure_start float8 measure_end float8 offset, Return a derived geometry (collection) value with elements that " +"intersect the specified range of elevations inclusively." msgstr "" #. Tag: funcprototype -#: reference_lrs.xml:376 +#: reference_lrs.xml:435 #, no-c-format msgid "" "geometry ST_LocateBetweenElevations " -"geometry geom_mline float8 elevation_start float8 " -"elevation_end" +"geometry geom " +"float8 elevation_start float8 elevation_end" msgstr "" #. Tag: para -#: reference_lrs.xml:389 +#: reference_lrs.xml:448 #, 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." +"Return a derived geometry (collection) value with elements that " +"intersect the specified range of elevations inclusively." msgstr "" #. Tag: para -#: reference_lrs.xml:393 +#: reference_lrs.xml:453 #, no-c-format msgid "Availability: 1.4.0" msgstr "" #. Tag: programlisting -#: reference_lrs.xml:401 +#: reference_lrs.xml:462 #, no-c-format msgid "" "SELECT ST_AsEWKT(ST_LocateBetweenElevations(\n" -" ST_GeomFromEWKT('LINESTRING(1 2 3, 4 5 6)'),2,4)) As " -"ewelev;\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" +"SELECT ST_AsEWKT(ST_LocateBetweenElevations('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" +"-- 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" +" FROM\n" +" (SELECT ST_LocateBetweenElevations('LINESTRING(1 2 6, 4 5 -1, 7 8 " +"9)', 6, 9) as the_geom) As foo;\n" "\n" " st_asewkt\n" "--------------------------------\n" @@ -738,14 +808,20 @@ msgid "" "LINESTRING(6.1 7.1 6,7 8 9)" msgstr "" +#. Tag: para +#: reference_lrs.xml:469 +#, no-c-format +msgid ", " +msgstr "" + #. Tag: refname -#: reference_lrs.xml:415 +#: reference_lrs.xml:476 #, no-c-format msgid "ST_InterpolatePoint" msgstr "" #. Tag: refpurpose -#: reference_lrs.xml:417 +#: reference_lrs.xml:478 #, no-c-format msgid "" "Return the value of the measure dimension of a geometry at the " @@ -753,7 +829,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_lrs.xml:422 +#: reference_lrs.xml:483 #, no-c-format msgid "" "float8 ST_InterpolatePoint " @@ -762,7 +838,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:434 +#: reference_lrs.xml:495 #, no-c-format msgid "" "Return the value of the measure dimension of a geometry at the point " @@ -770,13 +846,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:436 +#: reference_lrs.xml:497 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: programlisting -#: reference_lrs.xml:444 +#: reference_lrs.xml:505 #, no-c-format msgid "" "SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');\n" @@ -786,20 +862,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:450 +#: reference_lrs.xml:511 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_lrs.xml:458 +#: reference_lrs.xml:519 #, no-c-format msgid "ST_AddMeasure" msgstr "" #. Tag: refpurpose -#: reference_lrs.xml:460 +#: reference_lrs.xml:521 #, no-c-format msgid "" "Return a derived geometry with measure elements linearly interpolated " @@ -807,7 +883,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_lrs.xml:465 +#: reference_lrs.xml:526 #, no-c-format msgid "" "geometry ST_AddMeasure " @@ -818,7 +894,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:478 +#: reference_lrs.xml:539 #, no-c-format msgid "" "Return a derived geometry with measure elements linearly interpolated " @@ -828,13 +904,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_lrs.xml:480 +#: reference_lrs.xml:541 #, no-c-format msgid "Availability: 1.5.0" msgstr "" #. Tag: programlisting -#: reference_lrs.xml:488 +#: reference_lrs.xml:549 #, no-c-format msgid "" "SELECT ST_AsText(ST_AddMeasure(\n" diff --git a/doc/po/templates/reference_management.xml.pot b/doc/po/templates/reference_management.xml.pot index ce3952ab6..84c5ab636 100644 --- a/doc/po/templates/reference_management.xml.pot +++ b/doc/po/templates/reference_management.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -14,29 +14,32 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +#. Tag: para +#: reference_management.xml:5 +#, no-c-format +msgid "These functions assist in defining tables containing geometry columns." +msgstr "" + #. Tag: title -#: reference_management.xml:3 +#: reference_management.xml:10 #, no-c-format -msgid "Management Functions" +msgid "Table Management Functions" msgstr "" #. Tag: refname -#: reference_management.xml:7 +#: reference_management.xml:14 #, no-c-format msgid "AddGeometryColumn" msgstr "" #. Tag: refpurpose -#: reference_management.xml:9 +#: reference_management.xml:16 #, 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" +msgid "Adds a geometry column to an existing table." msgstr "" #. Tag: funcsynopsis -#: reference_management.xml:15 +#: reference_management.xml:20 #, no-c-format msgid "" " text AddGeometryColumn, text DropGeometryColumn, " msgstr "" #. Tag: refname -#: reference_management.xml:216 +#: reference_management.xml:221 #, no-c-format msgid "DropGeometryTable" msgstr "" #. Tag: refpurpose -#: reference_management.xml:218 +#: reference_management.xml:223 #, no-c-format msgid "Drops a table and all its references in geometry_columns." msgstr "" #. Tag: funcsynopsis -#: reference_management.xml:223 +#: reference_management.xml:228 #, no-c-format msgid "" " boolean DropGeometryTable, text PostGIS_Extensions_Upgrade " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:300 -#, no-c-format -msgid "" -"Upgrades installed postgis packaged extensions to latest installed version. " -"Only extensions you have installed in the database will be upgraded and if " -"they are already at last installed version, they will not be upgraded. " -"Reports full postgis version and build configuration infos after. This is " -"short-hand for doing multiple ALTER EXTENSION .. UPDATE for each postgis " -"extension. Currently only tries to upgrade extensions postgis, " -"postgis_raster, postgis_sfcgal, postgis_topology, and postgis_tiger_geocoder." -msgstr "" - -#. Tag: para -#: reference_management.xml:307 -#, no-c-format -msgid "Availability: 2.5.0" -msgstr "" - -#. Tag: para -#: reference_management.xml:309 -#, no-c-format -msgid "Changed: 3.0.0 to support separate postgis_raster extension" -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:316 -#, no-c-format -msgid "SELECT PostGIS_Extensions_Upgrade();" -msgstr "" - -#. Tag: screen -#: reference_management.xml:317 -#, no-c-format -msgid "" -"NOTICE: ALTER EXTENSION postgis_tiger_geocoder UPDATE TO \"2.5.0dev\";\n" -"NOTICE: ALTER EXTENSION postgis_topology UPDATE TO \"2.5.0dev\";\n" -"\n" -" postgis_extensions_upgrade\n" -"----------------------------------------------------------------------------------\n" -"POSTGIS=\"2.5.0dev r15966\" [EXTENSION] PGSQL=\"100\"\n" -"GEOS=\"3.7.0dev-CAPI-1.11.0 8fe2ce6\" SFCGAL=\"1.3.1\"\n" -"PROJ=\"Rel. 4.9.3, 15 August 2016\" GDAL=\"GDAL 2.2.2, released " -"2017/09/15\"\n" -"LIBXML=\"2.7.8\" LIBJSON=\"0.12\" LIBPROTOBUF=\"1.2.1\" TOPOLOGY RASTER\n" -"(1 row)" -msgstr "" - -#. Tag: para -#: reference_management.xml:323 reference_management.xml:371 -#, no-c-format -msgid "" -", , , , , " -msgstr "" - -#. Tag: refname -#: reference_management.xml:338 -#, no-c-format -msgid "PostGIS_Full_Version" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:340 -#, no-c-format -msgid "Reports full postgis version and build configuration infos." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:346 -#, no-c-format -msgid "" -"text PostGIS_Full_Version " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:357 -#, 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:365 -#, no-c-format -msgid "" -"SELECT PostGIS_Full_Version();\n" -" postgis_full_version\n" -"----------------------------------------------------------------------------------\n" -"POSTGIS=\"2.2.0dev r12699\" GEOS=\"3.5.0dev-CAPI-1.9.0 r3989\" SFCGAL=" -"\"1.0.4\" PROJ=\"Rel. 4.8.0, 6 March 2012\"\n" -"GDAL=\"GDAL 1.11.0, released 2014/04/16\" LIBXML=\"2.7.8\" LIBJSON=\"0.12\" " -"RASTER\n" -"(1 row)" -msgstr "" - -#. Tag: refname -#: reference_management.xml:384 +#: reference_management.xml:285 #, no-c-format -msgid "PostGIS_GEOS_Version" +msgid "Find_SRID" msgstr "" #. Tag: refpurpose -#: reference_management.xml:386 +#: reference_management.xml:287 #, no-c-format -msgid "Returns the version number of the GEOS library." +msgid "Returns the SRID defined for a geometry column." msgstr "" #. Tag: funcprototype -#: reference_management.xml:392 -#, no-c-format -msgid "" -"text PostGIS_GEOS_Version " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:403 -#, no-c-format -msgid "" -"Returns the version number of the GEOS library, or NULL " -"if GEOS support is not enabled." -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:410 +#: reference_management.xml:292 #, 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:416 reference_management.xml:457 -#, no-c-format -msgid "" -", , , , " -"" -msgstr "" - -#. Tag: refname -#: reference_management.xml:426 -#, no-c-format -msgid "PostGIS_Liblwgeom_Version" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:428 -#, no-c-format -msgid "" -"Returns the version number of the liblwgeom library. This should match the " -"version of PostGIS." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:434 -#, no-c-format -msgid "" -"text PostGIS_Liblwgeom_Version " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:445 -#, no-c-format -msgid "Returns the version number of the liblwgeom library/" -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:451 -#, no-c-format -msgid "" -"SELECT PostGIS_Liblwgeom_Version();\n" -"postgis_liblwgeom_version\n" -"--------------------------\n" -"2.3.3 r15473\n" -"(1 row)" -msgstr "" - -#. Tag: refname -#: reference_management.xml:467 -#, no-c-format -msgid "PostGIS_LibXML_Version" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:469 -#, no-c-format -msgid "Returns the version number of the libxml2 library." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:475 -#, no-c-format -msgid "" -"text PostGIS_LibXML_Version " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:486 -#, no-c-format -msgid "Returns the version number of the LibXML2 library." -msgstr "" - -#. Tag: para -#: reference_management.xml:487 -#, no-c-format -msgid "Availability: 1.5" -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:493 -#, 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:499 -#, no-c-format -msgid "" -", , , , " -msgstr "" - -#. Tag: refname -#: reference_management.xml:509 -#, no-c-format -msgid "PostGIS_Lib_Build_Date" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:511 -#, no-c-format -msgid "Returns build date of the PostGIS library." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:516 -#, no-c-format -msgid "" -"text PostGIS_Lib_Build_Date " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:527 -#, no-c-format -msgid "Returns build date of the PostGIS library." -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:533 -#, 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:539 -#, no-c-format -msgid "PostGIS_Lib_Version" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:541 -#, no-c-format -msgid "" -"Returns the version number of the PostGIS library." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:547 -#, no-c-format -msgid "" -"text PostGIS_Lib_Version " -msgstr "" - -#. Tag: para -#: reference_management.xml:558 -#, no-c-format -msgid "Returns the version number of the PostGIS library." -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:564 -#, 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:570 -#, no-c-format -msgid "" -", , , , " -"" -msgstr "" - -#. Tag: refname -#: reference_management.xml:580 -#, no-c-format -msgid "PostGIS_PROJ_Version" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:582 -#, no-c-format -msgid "Returns the version number of the PROJ4 library." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:588 -#, no-c-format -msgid "" -"text PostGIS_PROJ_Version " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:599 -#, no-c-format -msgid "" -"Returns the version number of the PROJ4 library, or NULL " -"if PROJ4 support is not enabled." -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:606 -#, 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:612 reference_management.xml:654 -#, no-c-format -msgid "" -", , , , " -msgstr "" - -#. Tag: refname -#: reference_management.xml:622 -#, no-c-format -msgid "PostGIS_Scripts_Build_Date" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:624 -#, no-c-format -msgid "Returns build date of the PostGIS scripts." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:629 -#, no-c-format -msgid "" -"text PostGIS_Scripts_Build_Date " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:640 -#, no-c-format -msgid "Returns build date of the PostGIS scripts." -msgstr "" - -#. Tag: para -#: reference_management.xml:642 -#, no-c-format -msgid "Availability: 1.0.0RC1" -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:648 -#, 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:664 -#, no-c-format -msgid "PostGIS_Scripts_Installed" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:666 -#, no-c-format -msgid "" -"Returns version of the postgis scripts installed in this " -"database." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:672 -#, no-c-format -msgid "" -"text PostGIS_Scripts_Installed " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:683 -#, no-c-format -msgid "" -"Returns version of the postgis scripts installed in this database." -msgstr "" - -#. Tag: para -#: reference_management.xml:687 -#, no-c-format -msgid "" -"If the output of this function doesn't match the output of you probably missed to properly upgrade an " -"existing database. See the Upgrading " -"section for more info." -msgstr "" - -#. Tag: para -#: reference_management.xml:694 reference_management.xml:740 -#, no-c-format -msgid "Availability: 0.9.0" -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:700 -#, 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:706 -#, no-c-format -msgid "" -", , " -msgstr "" - -#. Tag: refname -#: reference_management.xml:712 -#, no-c-format -msgid "PostGIS_Scripts_Released" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:714 -#, no-c-format -msgid "" -"Returns the version number of the postgis.sql script released " -"with the installed postgis lib." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:720 -#, no-c-format -msgid "" -"text PostGIS_Scripts_Released " -"" -msgstr "" - -#. Tag: para -#: reference_management.xml:731 -#, no-c-format -msgid "" -"Returns the version number of the postgis.sql script released with the " -"installed postgis lib." -msgstr "" - -#. Tag: para -#: reference_management.xml:735 -#, no-c-format -msgid "" -"Starting with version 1.1.0 this function returns the same value of . Kept for backward compatibility." -msgstr "" - -#. Tag: programlisting -#: reference_management.xml:746 -#, no-c-format -msgid "" -"SELECT PostGIS_Scripts_Released();\n" -" postgis_scripts_released\n" -"-------------------------\n" -" 1.3.4SVN\n" -"(1 row)" +"integer Find_SRID " +"varchar a_schema_name varchar a_table_name varchar " +"a_geomfield_name" msgstr "" #. Tag: para -#: reference_management.xml:752 +#: reference_management.xml:304 #, no-c-format msgid "" -", , " -msgstr "" - -#. Tag: refname -#: reference_management.xml:758 -#, no-c-format -msgid "PostGIS_Version" -msgstr "" - -#. Tag: refpurpose -#: reference_management.xml:760 -#, no-c-format -msgid "" -"Returns PostGIS version number and compile-time options." -msgstr "" - -#. Tag: funcprototype -#: reference_management.xml:766 -#, no-c-format -msgid "" -"text PostGIS_Version " -msgstr "" - -#. Tag: para -#: reference_management.xml:777 -#, no-c-format -msgid "Returns PostGIS version number and compile-time options." +"Returns the integer SRID of the specified geometry column by searching " +"through the GEOMETRY_COLUMNS table. If the geometry column has not been " +"properly added (e.g. with the " +"function), this function will not work." msgstr "" #. Tag: programlisting -#: reference_management.xml:783 -#, 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:789 +#: reference_management.xml:313 #, 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_management.xml:799 +#: reference_management.xml:327 #, no-c-format msgid "Populate_Geometry_Columns" msgstr "" #. Tag: refpurpose -#: reference_management.xml:801 +#: reference_management.xml:329 #, 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 " -"geometry_columns view. By default will convert all " -"geometry columns with no type modifier to ones with type modifiers. To get " -"old behavior set use_typmod=false" +"spatial constraints." msgstr "" #. Tag: funcsynopsis -#: reference_management.xml:807 +#: reference_management.xml:333 #, no-c-format msgid "" " text Populate_Geometry_Columnsgeometry_columns table." +"constraints to ensure they are registered correctly in the " +"geometry_columns view. By default will convert all " +"geometry columns with no type modifier to ones with type modifiers." msgstr "" #. Tag: para -#: reference_management.xml:828 +#: reference_management.xml:357 #, no-c-format msgid "" "For backwards compatibility and for spatial needs such as table inheritance " @@ -1066,7 +486,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:836 +#: reference_management.xml:365 #, no-c-format msgid "" "enforce_dims_the_geom - ensures every geometry has the " @@ -1074,7 +494,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:842 +#: reference_management.xml:371 #, no-c-format msgid "" "enforce_geotype_the_geom - ensures every geometry is of " @@ -1082,7 +502,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:848 +#: reference_management.xml:377 #, no-c-format msgid "" "enforce_srid_the_geom - ensures every geometry is in the " @@ -1090,7 +510,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:854 +#: reference_management.xml:383 #, no-c-format msgid "" "If a table oid is provided, this function tries to " @@ -1101,7 +521,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:861 +#: reference_management.xml:390 #, no-c-format msgid "" "If the oid of a view is provided, as with a table oid, " @@ -1112,7 +532,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:867 +#: reference_management.xml:396 #, no-c-format msgid "" "The parameterless variant is a simple wrapper for the parameterized variant " @@ -1126,13 +546,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:875 +#: reference_management.xml:404 #, no-c-format msgid "Availability: 1.4.0" msgstr "" #. Tag: para -#: reference_management.xml:876 +#: reference_management.xml:405 #, no-c-format msgid "" "Changed: 2.0.0 By default, now uses type modifiers instead of check " @@ -1142,7 +562,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:878 +#: reference_management.xml:407 #, no-c-format msgid "" "Enhanced: 2.0.0 use_typmod optional argument was " @@ -1151,7 +571,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_management.xml:884 +#: reference_management.xml:413 #, no-c-format msgid "" "CREATE TABLE public.myspatial_table(gid serial, geom geometry);\n" @@ -1178,7 +598,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_management.xml:886 +#: reference_management.xml:415 #, no-c-format msgid "" "-- This will change the geometry columns to use constraints if they are not " @@ -1209,23 +629,21 @@ msgid "" msgstr "" #. Tag: refname -#: reference_management.xml:901 +#: reference_management.xml:430 #, no-c-format msgid "UpdateGeometrySRID" msgstr "" #. Tag: refpurpose -#: reference_management.xml:903 +#: reference_management.xml:432 #, no-c-format msgid "" -"Updates the SRID of all features in a geometry column, geometry_columns " -"metadata and srid. If it was enforced with constraints, the constraints will " -"be updated with new srid constraint. If the old was enforced by type " -"definition, the type definition will be changed." +"Updates the SRID of all features in a geometry column, and the table " +"metadata." msgstr "" #. Tag: funcsynopsis -#: reference_management.xml:909 +#: reference_management.xml:438 #, no-c-format msgid "" " text UpdateGeometrySRIDEWKT format:" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:505 +#, no-c-format +msgid "" +"COPY roads (geom) FROM STDIN;\n" +"SRID=4326;LINESTRING(0 0, 10 10)\n" +"SRID=4326;LINESTRING(10 10, 15 0)\n" +"\\." msgstr "" #. Tag: para -#: reference_management.xml:972 +#: reference_management.xml:507 #, no-c-format msgid "" "This will change the srid of the roads table to 4326 from whatever it was " -"before" +"before:" msgstr "" #. Tag: programlisting -#: reference_management.xml:973 +#: reference_management.xml:508 #, no-c-format msgid "SELECT UpdateGeometrySRID('roads','geom',4326);" msgstr "" #. Tag: para -#: reference_management.xml:975 +#: reference_management.xml:510 #, no-c-format -msgid "The prior example is equivalent to this DDL statement" +msgid "The prior example is equivalent to this DDL statement:" msgstr "" #. Tag: programlisting -#: reference_management.xml:976 +#: reference_management.xml:511 #, no-c-format msgid "" "ALTER TABLE roads\n" @@ -1286,17 +723,17 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:978 +#: reference_management.xml:513 #, no-c-format msgid "" "If you got the projection wrong (or brought it in as unknown) in load and " -"you wanted to transform to web mercator all in one shot You can do this with " +"you wanted to transform to web mercator all in one shot you can do this with " "DDL but there is no equivalent PostGIS management function to do so in one " "go." msgstr "" #. Tag: programlisting -#: reference_management.xml:981 +#: reference_management.xml:515 #, no-c-format msgid "" "ALTER TABLE roads\n" @@ -1305,7 +742,9 @@ msgid "" msgstr "" #. Tag: para -#: reference_management.xml:986 +#: reference_management.xml:520 #, no-c-format -msgid ", , " +msgid "" +", , , " msgstr "" diff --git a/doc/po/templates/reference_measure.xml.pot b/doc/po/templates/reference_measure.xml.pot index be7d70506..8cf1eff46 100644 --- a/doc/po/templates/reference_measure.xml.pot +++ b/doc/po/templates/reference_measure.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -14,5070 +14,2334 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +#. Tag: para +#: reference_measure.xml:5 +#, no-c-format +msgid "" +"These functions compute measurements of distance, area and angles. There are " +"also functions to compute geometry values determined by measurements." +msgstr "" + #. Tag: title -#: reference_measure.xml:3 +#: reference_measure.xml:10 #, no-c-format -msgid "Spatial Relationships and Measurements" +msgid "Measurement Functions" msgstr "" #. Tag: refname -#: reference_measure.xml:6 +#: reference_measure.xml:14 #, no-c-format -msgid "ST_3DClosestPoint" +msgid "ST_Area" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:8 +#: reference_measure.xml:16 #, 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." +msgid "Returns the area of a polygonal geometry." msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:14 +#. Tag: funcsynopsis +#: reference_measure.xml:20 #, no-c-format msgid "" -"geometry ST_3DClosestPoint " -"geometry g1 " -"geometry g2" +" float ST_Area " +"geometry g1 float ST_Area geography geog boolean use_spheroid=true " msgstr "" #. Tag: title -#: reference_measure.xml:27 reference_measure.xml:93 reference_measure.xml:146 -#: reference_measure.xml:198 reference_measure.xml:255 -#: reference_measure.xml:313 reference_measure.xml:383 -#: reference_measure.xml:430 reference_measure.xml:503 -#: reference_measure.xml:563 reference_measure.xml:639 -#: reference_measure.xml:688 reference_measure.xml:810 -#: reference_measure.xml:886 reference_measure.xml:988 -#: reference_measure.xml:1033 reference_measure.xml:1110 -#: reference_measure.xml:1154 reference_measure.xml:1307 -#: reference_measure.xml:1388 reference_measure.xml:1468 -#: reference_measure.xml:1528 reference_measure.xml:1694 -#: reference_measure.xml:1829 reference_measure.xml:1908 -#: reference_measure.xml:1961 reference_measure.xml:2035 -#: reference_measure.xml:2097 reference_measure.xml:2164 -#: reference_measure.xml:2218 reference_measure.xml:2265 -#: reference_measure.xml:2313 reference_measure.xml:2367 -#: reference_measure.xml:2449 reference_measure.xml:2515 -#: reference_measure.xml:2613 reference_measure.xml:2686 -#: reference_measure.xml:2746 reference_measure.xml:2809 -#: reference_measure.xml:2863 reference_measure.xml:2896 -#: reference_measure.xml:2941 reference_measure.xml:2992 -#: reference_measure.xml:3046 reference_measure.xml:3134 -#: reference_measure.xml:3177 reference_measure.xml:3268 -#: reference_measure.xml:3319 reference_measure.xml:3356 -#: reference_measure.xml:3398 reference_measure.xml:3445 -#: reference_measure.xml:3505 reference_measure.xml:3571 -#: reference_measure.xml:3614 reference_measure.xml:3693 -#: reference_measure.xml:3841 +#: reference_measure.xml:34 reference_measure.xml:97 reference_measure.xml:173 +#: reference_measure.xml:217 reference_measure.xml:291 +#: reference_measure.xml:372 reference_measure.xml:448 +#: reference_measure.xml:497 reference_measure.xml:544 +#: reference_measure.xml:600 reference_measure.xml:672 +#: reference_measure.xml:737 reference_measure.xml:794 +#: reference_measure.xml:826 reference_measure.xml:869 +#: reference_measure.xml:923 reference_measure.xml:1017 +#: reference_measure.xml:1084 reference_measure.xml:1131 +#: reference_measure.xml:1173 reference_measure.xml:1247 +#: reference_measure.xml:1294 reference_measure.xml:1345 +#: reference_measure.xml:1380 reference_measure.xml:1426 +#: reference_measure.xml:1482 reference_measure.xml:1559 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_measure.xml:29 +#: reference_measure.xml:36 #, 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." +"Returns the area of a polygonal geometry. For geometry types a 2D Cartesian " +"(planar) area is computed, with units specified by the SRID. For geography " +"types by default area is determined on a spheroid with units in square " +"meters. To compute the area using the faster but less accurate spherical " +"model use ST_Area(geog,false)." msgstr "" #. Tag: para -#: reference_measure.xml:32 reference_measure.xml:98 reference_measure.xml:151 -#: reference_measure.xml:213 reference_measure.xml:270 -#: reference_measure.xml:323 reference_measure.xml:388 -#: reference_measure.xml:444 reference_measure.xml:2637 -#: reference_measure.xml:2691 reference_measure.xml:2900 -#: reference_measure.xml:2955 reference_measure.xml:3360 -#: reference_measure.xml:3406 +#: reference_measure.xml:41 #, no-c-format -msgid "&Z_support;" +msgid "Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced." msgstr "" #. Tag: para -#: reference_measure.xml:34 reference_measure.xml:100 reference_measure.xml:153 -#: reference_measure.xml:215 reference_measure.xml:272 -#: reference_measure.xml:325 reference_measure.xml:390 -#: reference_measure.xml:446 reference_measure.xml:514 +#: reference_measure.xml:42 reference_measure.xml:389 #, no-c-format -msgid "&P_support;" +msgid "" +"Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for " +"improved accuracy and robustness. Requires Proj >= 4.9.0 to take " +"advantage of the new feature." msgstr "" #. Tag: para -#: reference_measure.xml:35 reference_measure.xml:104 reference_measure.xml:156 -#: reference_measure.xml:212 reference_measure.xml:262 -#: reference_measure.xml:321 reference_measure.xml:392 -#: reference_measure.xml:442 reference_measure.xml:3451 +#: reference_measure.xml:43 reference_measure.xml:390 #, no-c-format -msgid "Availability: 2.0.0" +msgid "Changed: 3.0.0 - does not depend on SFCGAL anymore." msgstr "" #. Tag: para -#: reference_measure.xml:36 reference_measure.xml:322 reference_measure.xml:443 -#, no-c-format -msgid "" -"Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned " -"(instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z " -"is no longer assumed to be 0 for missing Z." -msgstr "" - -#. Tag: title -#: reference_measure.xml:40 reference_measure.xml:109 reference_measure.xml:160 -#: reference_measure.xml:220 reference_measure.xml:329 -#: reference_measure.xml:397 reference_measure.xml:450 -#: reference_measure.xml:521 reference_measure.xml:579 -#: reference_measure.xml:654 reference_measure.xml:718 -#: reference_measure.xml:820 reference_measure.xml:927 -#: reference_measure.xml:996 reference_measure.xml:1044 -#: reference_measure.xml:1118 reference_measure.xml:1193 -#: reference_measure.xml:1346 reference_measure.xml:1422 -#: reference_measure.xml:1497 reference_measure.xml:1594 -#: reference_measure.xml:1729 reference_measure.xml:1852 -#: reference_measure.xml:2002 reference_measure.xml:2047 -#: reference_measure.xml:2122 reference_measure.xml:2187 -#: reference_measure.xml:2230 reference_measure.xml:2279 -#: reference_measure.xml:2328 reference_measure.xml:2385 -#: reference_measure.xml:2485 reference_measure.xml:2539 -#: reference_measure.xml:2641 reference_measure.xml:2697 -#: reference_measure.xml:2906 reference_measure.xml:2959 -#: reference_measure.xml:3008 reference_measure.xml:3056 -#: reference_measure.xml:3149 reference_measure.xml:3199 -#: reference_measure.xml:3366 reference_measure.xml:3410 -#: reference_measure.xml:3541 reference_measure.xml:3581 -#: reference_measure.xml:3630 reference_measure.xml:3743 -#: reference_measure.xml:3875 +#: reference_measure.xml:44 reference_measure.xml:382 #, no-c-format -msgid "Examples" +msgid "&sfs_compliant;" msgstr "" #. Tag: para #: reference_measure.xml:45 #, no-c-format -msgid "linestring and point -- both 3d and 2d closest point" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:46 -#, 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)" +msgid "&sqlmm_compliant; SQL-MM 3: 8.1.2, 9.5.3" msgstr "" #. Tag: para -#: reference_measure.xml:50 +#: reference_measure.xml:46 reference_measure.xml:298 reference_measure.xml:455 +#: reference_measure.xml:1029 reference_measure.xml:1138 +#: reference_measure.xml:1575 #, no-c-format -msgid "linestring and multipoint -- both 3d and 2d closest point" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:51 -#, 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)" +msgid "&P_support;" msgstr "" #. Tag: para -#: reference_measure.xml:55 -#, no-c-format -msgid "Multilinestring and polygon both 3d and 2d closest point" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:56 +#: reference_measure.xml:47 #, 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)" +"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: title -#: reference_measure.xml:66 reference_measure.xml:116 reference_measure.xml:166 -#: reference_measure.xml:225 reference_measure.xml:286 -#: reference_measure.xml:355 reference_measure.xml:403 -#: reference_measure.xml:476 reference_measure.xml:537 -#: reference_measure.xml:610 reference_measure.xml:781 -#: reference_measure.xml:855 reference_measure.xml:961 -#: reference_measure.xml:1000 reference_measure.xml:1083 -#: reference_measure.xml:1122 reference_measure.xml:1280 -#: reference_measure.xml:1351 reference_measure.xml:1430 -#: reference_measure.xml:1502 reference_measure.xml:1799 -#: reference_measure.xml:1858 reference_measure.xml:1938 -#: reference_measure.xml:2008 reference_measure.xml:2052 -#: reference_measure.xml:2132 reference_measure.xml:2193 -#: reference_measure.xml:2238 reference_measure.xml:2286 -#: reference_measure.xml:2335 reference_measure.xml:2390 -#: reference_measure.xml:2490 reference_measure.xml:2545 -#: reference_measure.xml:2662 reference_measure.xml:2704 -#: reference_measure.xml:2785 reference_measure.xml:2840 -#: reference_measure.xml:2872 reference_measure.xml:2915 -#: reference_measure.xml:2966 reference_measure.xml:3015 -#: reference_measure.xml:3109 reference_measure.xml:3154 -#: reference_measure.xml:3241 reference_measure.xml:3296 -#: reference_measure.xml:3332 reference_measure.xml:3373 -#: reference_measure.xml:3416 reference_measure.xml:3463 -#: reference_measure.xml:3547 reference_measure.xml:3587 -#: reference_measure.xml:3664 reference_measure.xml:3886 +#: reference_measure.xml:52 reference_measure.xml:113 reference_measure.xml:188 +#: reference_measure.xml:227 reference_measure.xml:304 +#: reference_measure.xml:464 reference_measure.xml:511 +#: reference_measure.xml:561 reference_measure.xml:626 +#: reference_measure.xml:701 reference_measure.xml:836 +#: reference_measure.xml:886 reference_measure.xml:936 +#: reference_measure.xml:1033 reference_measure.xml:1096 +#: reference_measure.xml:1145 reference_measure.xml:1214 +#: reference_measure.xml:1259 reference_measure.xml:1390 +#: reference_measure.xml:1498 reference_measure.xml:1579 #, no-c-format -msgid "See Also" +msgid "Examples" msgstr "" #. Tag: para -#: reference_measure.xml:68 +#: reference_measure.xml:53 #, no-c-format msgid "" -", , , " -"" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:73 -#, no-c-format -msgid "ST_3DDistance" +"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 " +"EPSG:2249 is Massachusetts State Plane Feet" msgstr "" -#. Tag: refpurpose -#: reference_measure.xml:75 +#. Tag: programlisting +#: reference_measure.xml:56 #, no-c-format msgid "" -"For geometry type Returns the 3-dimensional cartesian minimum distance " -"(based on spatial ref) between two geometries in projected units." +"select ST_Area(geom) sqft,\n" +" ST_Area(geom) * 0.3048 ^ 2 sqm\n" +"from (\n" +" select 'SRID=2249;POLYGON((743238 2967416,743238 2967450,\n" +" 743265 2967450,743265.625 2967416,743238 " +"2967416))' :: geometry geom\n" +" ) subquery;\n" +"┌─────────┬─────────────┐\n" +"│ sqft │ sqm │\n" +"├─────────┼─────────────┤\n" +"│ 928.625 │ 86.27208552 │\n" +"└─────────┴─────────────┘" msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:80 +#. Tag: para +#: reference_measure.xml:57 #, no-c-format msgid "" -"float ST_3DDistance " -"geometry g1 " -"geometry g2" +"Return area square feet and transform to Massachusetts state plane meters " +"(EPSG:26986) to get square meters. Note this is in square feet because 2249 " +"is Massachusetts State Plane Feet and transformed area is in square meters " +"since EPSG:26986 is state plane Massachusetts meters" msgstr "" -#. Tag: para -#: reference_measure.xml:95 +#. Tag: programlisting +#: reference_measure.xml:60 #, no-c-format msgid "" -"For geometry type returns the 3-dimensional minimum cartesian distance " -"between two geometries in projected units (spatial ref units)." +"select ST_Area(geom) sqft,\n" +" ST_Area(ST_Transform(geom, 26986)) As sqm\n" +"from (\n" +" select\n" +" 'SRID=2249;POLYGON((743238 2967416,743238 2967450,\n" +" 743265 2967450,743265.625 2967416,743238 2967416))' :: geometry " +"geom\n" +" ) subquery;\n" +"┌─────────┬─────────────────┐\n" +"│ sqft │ sqm │\n" +"├─────────┼─────────────────┤\n" +"│ 928.625 │ 86.272430607008 │\n" +"└─────────┴─────────────────┘" msgstr "" #. Tag: para -#: reference_measure.xml:101 reference_measure.xml:154 +#: reference_measure.xml:62 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM ?" +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: para -#: reference_measure.xml:102 reference_measure.xml:274 -#: reference_measure.xml:517 reference_measure.xml:1917 -#: reference_measure.xml:2774 reference_measure.xml:2825 +#. Tag: programlisting +#: reference_measure.xml:65 #, no-c-format -msgid "&sfcgal_enhanced;" +msgid "" +"select ST_Area(geog) / 0.3048 ^ 2 sqft_spheroid,\n" +" ST_Area(geog, false) / 0.3048 ^ 2 sqft_sphere,\n" +" ST_Area(geog) sqm_spheroid\n" +"from (\n" +" select ST_Transform(\n" +" 'SRID=2249;POLYGON((743238 2967416,743238 2967450,743265 " +"2967450,743265.625 2967416,743238 2967416))'::geometry,\n" +" 4326\n" +" ) :: geography geog\n" +" ) as subquery;\n" +"┌──────────────────┬──────────────────┬──────────────────┐\n" +"│ sqft_spheroid │ sqft_sphere │ sqm_spheroid │\n" +"├──────────────────┼──────────────────┼──────────────────┤\n" +"│ 928.684405784452 │ 927.049336105925 │ 86.2776044979692 │\n" +"└──────────────────┴──────────────────┴──────────────────┘" msgstr "" #. Tag: para -#: reference_measure.xml:105 reference_measure.xml:393 +#: reference_measure.xml:67 #, no-c-format -msgid "" -"Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for " -"missing Z." +msgid "If your data is in geography already:" msgstr "" #. Tag: programlisting -#: reference_measure.xml:111 +#: reference_measure.xml:68 #, 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" +"select ST_Area(geog) / 0.3048 ^ 2 sqft,\n" +" ST_Area(the_geog) sqm\n" +"from somegeogtable;" msgstr "" -#. Tag: programlisting -#: reference_measure.xml:112 +#. Tag: title +#: reference_measure.xml:71 reference_measure.xml:144 reference_measure.xml:262 +#: reference_measure.xml:330 reference_measure.xml:419 +#: reference_measure.xml:471 reference_measure.xml:518 +#: reference_measure.xml:568 reference_measure.xml:632 +#: reference_measure.xml:711 reference_measure.xml:772 +#: reference_measure.xml:803 reference_measure.xml:845 +#: reference_measure.xml:893 reference_measure.xml:989 +#: reference_measure.xml:1059 reference_measure.xml:1104 +#: reference_measure.xml:1151 reference_measure.xml:1220 +#: reference_measure.xml:1264 reference_measure.xml:1322 +#: reference_measure.xml:1357 reference_measure.xml:1397 +#: reference_measure.xml:1453 reference_measure.xml:1532 +#: reference_measure.xml:1605 #, 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" +msgid "See Also" msgstr "" #. Tag: para -#: reference_measure.xml:118 +#: reference_measure.xml:72 #, no-c-format msgid "" -", , , " -", , " -"" +", , , , " msgstr "" #. Tag: refname -#: reference_measure.xml:124 +#: reference_measure.xml:78 #, no-c-format -msgid "ST_3DDWithin" +msgid "ST_Azimuth" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:126 +#: reference_measure.xml:80 #, no-c-format msgid "" -"For 3d (z) geometry type Returns true if two geometries 3d distance is " -"within number of units." +"Returns the north-based azimuth as the angle in radians measured clockwise " +"from the vertical on pointA to pointB." msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:130 +#. Tag: funcsynopsis +#: reference_measure.xml:83 #, no-c-format msgid "" -"boolean ST_3DDWithin " -"geometry g1 " -"geometry g2 " -"double precision distance_of_srid" +" float ST_Azimuth " +"geometry pointA " +"geometry pointB float ST_Azimuth geography pointA geography pointB " msgstr "" #. Tag: para -#: reference_measure.xml:148 +#: reference_measure.xml:99 #, 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)." +"Returns the azimuth in radians of the segment defined by the given point " +"geometries, or NULL if the two points are coincident. The azimuth is angle " +"is referenced from north, and is positive clockwise: North = 0; East = " +"π/2; South = π; West = 3π/2." msgstr "" -#. Tag: programlisting -#: reference_measure.xml:162 +#. Tag: para +#: reference_measure.xml:101 #, 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" +"For the geography type, the forward azimuth is solved as part of the inverse " +"geodesic problem." msgstr "" #. Tag: para -#: reference_measure.xml:168 +#: reference_measure.xml:102 #, no-c-format msgid "" -", , , , " +"The azimuth is mathematical concept defined as the angle between a reference " +"plane and a point, with angular units in radians. Units can be converted to " +"degrees using a built-in PostgreSQL function degrees(), as shown in the " +"example." msgstr "" -#. Tag: refname -#: reference_measure.xml:174 +#. Tag: para +#: reference_measure.xml:105 #, no-c-format -msgid "ST_3DDFullyWithin" +msgid "Availability: 1.1.0" msgstr "" -#. Tag: refpurpose -#: reference_measure.xml:176 +#. Tag: para +#: reference_measure.xml:106 #, no-c-format -msgid "" -"Returns true if all of the 3D geometries are within the specified distance " -"of one another." +msgid "Enhanced: 2.0.0 support for geography was introduced." msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:182 +#. Tag: para +#: reference_measure.xml:107 #, no-c-format msgid "" -"boolean ST_3DDFullyWithin " -"geometry g1 " -"geometry g2 " -"double precision distance" +"Enhanced: 2.2.0 measurement on spheroid performed with GeographicLib for " +"improved accuracy and robustness. Requires Proj >= 4.9.0 to take " +"advantage of the new feature." msgstr "" #. Tag: para -#: reference_measure.xml:200 +#: reference_measure.xml:108 #, 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." +"Azimuth is especially useful in conjunction with ST_Translate for shifting " +"an object along its perpendicular axis. See upgis_lineshift Plpgsqlfunctions PostGIS wiki section for example of this." msgstr "" #. Tag: para -#: reference_measure.xml:207 reference_measure.xml:264 -#: reference_measure.xml:1584 reference_measure.xml:2376 -#: reference_measure.xml:2464 reference_measure.xml:2758 +#: reference_measure.xml:114 reference_measure.xml:189 #, 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." +msgid "Geometry Azimuth in degrees" msgstr "" #. Tag: programlisting -#: reference_measure.xml:221 +#: reference_measure.xml:115 #, 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" +"SELECT degrees(ST_Azimuth(ST_Point(25, 45), ST_Point(75, 100))) AS degA_B,\n" +" degrees(ST_Azimuth(ST_Point(75, 100), ST_Point(25, 45))) AS " +"degB_A;\n" +"\n" +" dega_b | degb_a\n" +"------------------+------------------\n" +" 42.2736890060937 | 222.273689006094" msgstr "" #. Tag: para -#: reference_measure.xml:227 +#: reference_measure.xml:125 #, no-c-format msgid "" -", , , " +"Green: the start Point(25,45) with its vertical. Yellow: degA_B as the path " +"to travel (azimuth)." msgstr "" -#. Tag: refname -#: reference_measure.xml:233 +#. Tag: para +#: reference_measure.xml:134 #, no-c-format -msgid "ST_3DIntersects" +msgid "" +"Green: the start Point(75,100) with its vertical. Yellow: degB_A as the path " +"to travel (azimuth)." msgstr "" -#. Tag: refpurpose -#: reference_measure.xml:235 +#. Tag: para +#: reference_measure.xml:145 #, no-c-format msgid "" -"Returns TRUE if the Geometries \"spatially intersect\" in 3d - only for " -"points, linestrings, polygons, polyhedral surface (area). With SFCGAL " -"backend enabled also supports TINS" +", , , PostgreSQL Math Functions" msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:241 +#. Tag: refname +#: reference_measure.xml:152 #, no-c-format -msgid "" -"boolean ST_3DIntersects " -"geometry geomA " -"geometry geomB " +msgid "ST_Angle" msgstr "" -#. Tag: para -#: reference_measure.xml:256 reference_measure.xml:2749 +#. Tag: refpurpose +#: reference_measure.xml:154 #, 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." +"Returns the angle between 3 points, or between 2 vectors (4 points or 2 " +"lines)." msgstr "" -#. Tag: para -#: reference_measure.xml:269 +#. Tag: funcsynopsis +#: reference_measure.xml:157 #, no-c-format msgid "" -"In order to take advantage of support for TINS, you need to enable the " -"SFCGAL backend. This can be done at session time with: set postgis." -"backend = sfcgal; or at the database or system level. Database level " -"can be done with ALTER DATABASE gisdb SET postgis.backend = sfcgal;." +" float ST_Angle " +"geometry point1 " +"geometry point2 " +"geometry point3 " +"geometry point4 float " +"ST_Angle geometry line1 geometry line2 " msgstr "" #. Tag: para -#: reference_measure.xml:273 +#: reference_measure.xml:175 #, no-c-format -msgid "&T_support;" +msgid "" +"For 3 points, computes the angle measured clockwise of P1P2P3. If input are " +"2 lines, get first and last point of the lines as 4 points. For 4 points," +"compute the angle measured clockwise of P1P2,P3P4. Results are always " +"positive, between 0 and 2*Pi radians. Uses azimuth of pairs or points." msgstr "" #. Tag: para -#: reference_measure.xml:275 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: ?" -msgstr "" - -#. Tag: title -#: reference_measure.xml:278 reference_measure.xml:2777 -#: reference_measure.xml:2829 +#: reference_measure.xml:182 #, no-c-format -msgid "Geometry Examples" +msgid "ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)" msgstr "" -#. Tag: programlisting -#: reference_measure.xml:279 +#. Tag: para +#: reference_measure.xml:183 #, 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)" +"Result is in radian and can be converted to degrees using a built-in " +"PostgreSQL function degrees(), as shown in the example." msgstr "" -#. Tag: title -#: reference_measure.xml:282 +#. Tag: para +#: reference_measure.xml:184 #, no-c-format -msgid "TIN Examples" +msgid "Availability: 2.5.0" msgstr "" #. Tag: programlisting -#: reference_measure.xml:283 +#: reference_measure.xml:190 #, no-c-format msgid "" -"set postgis.backend = sfcgal;\n" -"SELECT ST_3DIntersects('TIN(((0 0,1 0,0 1,0 0)))'::geometry, 'POINT(.1 .1)'::" -"geometry);\n" -" st_3dintersects\n" -"-----------------\n" -" t" +"WITH rand AS (\n" +" SELECT s, random() * 2 * PI() AS rad1\n" +" , random() * 2 * PI() AS rad2\n" +" FROM generate_series(1,2,2) AS s\n" +" )\n" +" , points AS (\n" +" SELECT s, rad1,rad2, ST_MakePoint(cos1+s,sin1+s) as p1, " +"ST_MakePoint(s,s) AS p2, ST_MakePoint(cos2+s,sin2+s) as p3\n" +" FROM rand\n" +" ,cos(rad1) cos1, sin(rad1) sin1\n" +" ,cos(rad2) cos2, sin(rad2) sin2\n" +" )\n" +" SELECT s, ST_AsText(ST_SnapToGrid(ST_MakeLine(ARRAY[p1,p2," +"p3]),0.001)) AS line\n" +" , degrees(ST_Angle(p1,p2,p3)) as computed_angle\n" +" , round(degrees(2*PI()-rad2 -2*PI()+rad1+2*PI()))::int%360 " +"AS reference\n" +" , round(degrees(2*PI()-rad2 -2*PI()+rad1+2*PI()))::int%360 " +"AS reference\n" +" FROM points ;\n" +"\n" +"1 | line | computed_angle | reference\n" +"------------------+------------------\n" +"1 | LINESTRING(1.511 1.86,1 1,0.896 0.005) | 155.27033848688 | 155" msgstr "" #. Tag: refname -#: reference_measure.xml:293 +#: reference_measure.xml:196 #, no-c-format -msgid "ST_3DLongestLine" +msgid "ST_ClosestPoint" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:295 +#: reference_measure.xml:198 #, no-c-format -msgid "Returns the 3-dimensional longest line between two geometries" +msgid "" +"Returns the 2D point on g1 that is closest to g2. This is the first point of " +"the shortest line." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:300 +#: reference_measure.xml:204 #, no-c-format msgid "" -"geometry ST_3DLongestLine " +"geometry ST_ClosestPoint " "geometry g1 " "geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:315 +#: reference_measure.xml:219 #, 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 returns for g1 and g2." +"Returns the 2-dimensional point on g1 that is closest to g2. This is the " +"first point of the shortest line." msgstr "" #. Tag: para -#: reference_measure.xml:334 +#: reference_measure.xml:222 #, no-c-format -msgid "linestring and point -- both 3d and 2d longest line" +msgid "" +"If you have a 3D Geometry, you may prefer to use ." msgstr "" -#. Tag: programlisting -#: reference_measure.xml:335 +#. Tag: para +#: reference_measure.xml:223 reference_measure.xml:696 +#: reference_measure.xml:931 reference_measure.xml:1093 +#: reference_measure.xml:1494 #, 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)" +msgid "Availability: 1.5.0" msgstr "" #. Tag: para -#: reference_measure.xml:339 +#: reference_measure.xml:237 #, no-c-format -msgid "linestring and multipoint -- both 3d and 2d longest line" +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:340 +#: reference_measure.xml:241 #, 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" +"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" -" lol3d_line_pt | lol2d_line_pt\n" -"---------------------------------+--------------------------\n" -" LINESTRING(98 190 1,50 74 1000) | LINESTRING(98 190,50 74)" +" cp_pt_line | cp_line_pt\n" +"----------------+------------------------------------------\n" +" POINT(100 100) | POINT(73.0769230769231 115.384615384615)" msgstr "" #. Tag: para -#: reference_measure.xml:344 +#: reference_measure.xml:249 #, no-c-format -msgid "Multilinestring and polygon both 3d and 2d longest line" +msgid "closest point on polygon A to polygon B" msgstr "" #. Tag: programlisting -#: reference_measure.xml:345 +#: reference_measure.xml:252 #, 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)" +"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:357 +#: reference_measure.xml:264 #, no-c-format msgid "" -", , , " -", " +",, , , " msgstr "" #. Tag: refname -#: reference_measure.xml:363 +#: reference_measure.xml:270 #, no-c-format -msgid "ST_3DMaxDistance" +msgid "ST_3DClosestPoint" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:365 +#: reference_measure.xml:272 #, no-c-format msgid "" -"For geometry type Returns the 3-dimensional cartesian maximum distance " -"(based on spatial ref) between two geometries in projected units." +"Returns the 3D point on g1 that is closest to g2. This is the first point of " +"the 3D shortest line." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:370 +#: reference_measure.xml:278 #, no-c-format msgid "" -"float ST_3DMaxDistance " +"geometry ST_3DClosestPoint " "geometry g1 " "geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:385 -#, 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:399 +#: reference_measure.xml:293 #, 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" +"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:405 -#, no-c-format -msgid "" -", , , " -"" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:410 -#, no-c-format -msgid "ST_3DShortestLine" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:412 +#: reference_measure.xml:296 reference_measure.xml:453 +#: reference_measure.xml:830 reference_measure.xml:882 +#: reference_measure.xml:1027 reference_measure.xml:1136 +#: reference_measure.xml:1384 reference_measure.xml:1573 #, no-c-format -msgid "Returns the 3-dimensional shortest line between two geometries" +msgid "&Z_support;" msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:417 +#. Tag: para +#: reference_measure.xml:299 reference_measure.xml:458 +#: reference_measure.xml:1025 reference_measure.xml:1140 +#: reference_measure.xml:1441 reference_measure.xml:1571 #, no-c-format -msgid "" -"geometry ST_3DShortestLine " -"geometry g1 " -"geometry g2" +msgid "Availability: 2.0.0" msgstr "" #. Tag: para -#: reference_measure.xml:432 +#: reference_measure.xml:300 reference_measure.xml:1026 +#: reference_measure.xml:1572 #, 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 returns for g1 and g2." +"Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned " +"(instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z " +"is no longer assumed to be 0 for missing Z." msgstr "" #. Tag: para -#: reference_measure.xml:455 +#: reference_measure.xml:309 #, no-c-format -msgid "linestring and point -- both 3d and 2d shortest line" +msgid "linestring and point -- both 3d and 2d closest point" msgstr "" #. Tag: programlisting -#: reference_measure.xml:456 +#: reference_measure.xml:310 #, 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" +"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" -" 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)" +" 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:460 +#: reference_measure.xml:314 #, no-c-format -msgid "linestring and multipoint -- both 3d and 2d shortest line" +msgid "linestring and multipoint -- both 3d and 2d closest point" msgstr "" #. Tag: programlisting -#: reference_measure.xml:461 +#: reference_measure.xml:315 #, 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" +"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" -" shl3d_line_pt | " -"shl2d_line_pt\n" -"---------------------------------------------------------------------------" -"+------------------------\n" -" LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) | " -"LINESTRING(50 75,50 74)" +" cp3d_line_pt | cp2d_line_pt\n" +"-----------------------------------------------------------+--------------\n" +" POINT(54.6993798867619 128.935022917228 11.5475869506606) | POINT(50 75)" msgstr "" #. Tag: para -#: reference_measure.xml:465 +#: reference_measure.xml:319 #, no-c-format -msgid "Multilinestring and polygon both 3d and 2d shortest line" +msgid "Multilinestring and polygon both 3d and 2d closest point" msgstr "" #. Tag: programlisting -#: reference_measure.xml:466 +#: reference_measure.xml:320 #, 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, " +"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" -" shl3d " -"| shl2d\n" -"---------------------------------------------------------------------------------------------------" -"+------------------------\n" -" LINESTRING(39.993580415989 54.1889925532825 5,40.4078575708294 " -"53.6052383805529 5.03423778139177) | LINESTRING(20 40,20 40)" +" cp3d | cp2d\n" +"-------------------------------------------+--------------\n" +" POINT(39.993580415989 54.1889925532825 5) | POINT(20 40)" msgstr "" #. Tag: para -#: reference_measure.xml:478 +#: reference_measure.xml:332 #, no-c-format msgid "" -", , , " -", " +", , , " +"" msgstr "" #. Tag: refname -#: reference_measure.xml:483 +#: reference_measure.xml:338 #, no-c-format -msgid "ST_Area" +msgid "ST_Distance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:485 +#: reference_measure.xml:340 #, no-c-format -msgid "" -"Returns the area of the surface if it is a Polygon or MultiPolygon. For " -"geometry, a 2D Cartesian area is determined with units specified by the " -"SRID. For geography, area is determined on a curved surface with units in " -"square meters." +msgid "Returns the distance between two geometry or geography values." msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:489 +#: reference_measure.xml:343 #, no-c-format msgid "" -" float ST_Area " -"geometry g1 float ST_Area geography geog boolean use_spheroid=true " +" float ST_Distance " +"geometry g1 " +"geometry g2 float ST_Distance geography geog1 geography geog2 >boolean " +"use_spheroid=true " msgstr "" #. Tag: para -#: reference_measure.xml:505 +#: reference_measure.xml:374 #, no-c-format msgid "" -"Returns the area of the geometry if it is a Polygon or MultiPolygon. Return " -"the area measurement of an ST_Surface or ST_MultiSurface value. For " -"geometry, a 2D Cartesian area is determined with units specified by the " -"SRID. For geography, by default area is determined on a spheroid with units " -"in square meters. To measure around the faster but less accurate sphere, use " -"ST_Area(geog,false)." +"For types returns the minimum 2D Cartesian " +"(planar) distance between two geometries, in projected units (spatial ref " +"units)." msgstr "" #. Tag: para -#: reference_measure.xml:510 +#: reference_measure.xml:377 #, no-c-format -msgid "Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced." +msgid "" +"For types defaults to return the minimum " +"geodesic distance between two geographies in meters, compute on the spheroid " +"determined by the SRID. If use_spheroid is false, a " +"faster spherical calculation is used." msgstr "" #. Tag: para -#: reference_measure.xml:511 reference_measure.xml:1922 +#: reference_measure.xml:383 #, no-c-format -msgid "" -"Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for " -"improved accuracy and robustness. Requires Proj >= 4.9.0 to take " -"advantage of the new feature." +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.23" msgstr "" #. Tag: para -#: reference_measure.xml:512 reference_measure.xml:713 -#: reference_measure.xml:1914 reference_measure.xml:2478 +#: reference_measure.xml:384 #, no-c-format -msgid "&sfs_compliant;" +msgid "&curve_support;" msgstr "" #. Tag: para -#: reference_measure.xml:513 +#: reference_measure.xml:386 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 8.1.2, 9.5.3" +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:515 +#: reference_measure.xml:387 #, 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." +"Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." +msgstr "" + +#. Tag: para +#: reference_measure.xml:388 +#, no-c-format +msgid "Enhanced: 2.1.0 - support for curved geometries was introduced." +msgstr "" + +#. Tag: title +#: reference_measure.xml:394 +#, no-c-format +msgid "Basic Geometry Examples" msgstr "" #. Tag: para -#: reference_measure.xml:522 +#: reference_measure.xml:396 #, 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 " -"EPSG:2249 is Massachusetts State Plane Feet" +"Geometry example - units in planar degrees 4326 is WGS 84 long lat, units " +"are degrees." msgstr "" #. Tag: programlisting -#: reference_measure.xml:525 +#: reference_measure.xml:397 #, 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" +"SELECT ST_Distance(\n" +" 'SRID=4326;POINT(-72.1235 42.3521)'::geometry,\n" +" 'SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::" +"geometry\n" +" );\n" +"st_distance\n" +"-----------------\n" +"0.00150567726382282" msgstr "" #. Tag: para -#: reference_measure.xml:526 +#: reference_measure.xml:399 #, no-c-format msgid "" -"Return area square feet and transform to Massachusetts state plane meters " -"(EPSG:26986) to get square meters. Note this is in square feet because 2249 " -"is Massachusetts State Plane Feet and transformed area is in square meters " -"since EPSG:26986 is state plane Massachusetts meters" +"Geometry example - units in meters (SRID: 3857, proportional to pixels on " +"popular web maps). Although the value is off, nearby ones can be compared " +"correctly, which makes it a good choice for algorithms like KNN or KMeans." msgstr "" #. Tag: programlisting -#: reference_measure.xml:529 +#: reference_measure.xml:402 #, 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" +"SELECT ST_Distance(\n" +" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" +"geometry, 3857),\n" +" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " +"-72.123 42.1546)'::geometry, 3857)\n" +" );\n" +"st_distance\n" +"-----------------\n" +"167.441410065196" msgstr "" #. Tag: para -#: reference_measure.xml:531 +#: reference_measure.xml:404 #, 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." +"Geometry example - units in meters (SRID: 3857 as above, but corrected by " +"cos(lat) to account for distortion)" msgstr "" #. Tag: programlisting -#: reference_measure.xml:534 +#: reference_measure.xml:405 #, 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.684403538925 | 927.049336105925 | 86.2776042893529\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;" +"SELECT ST_Distance(\n" +" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" +"geometry, 3857),\n" +" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " +"-72.123 42.1546)'::geometry, 3857)\n" +" ) * cosd(42.3521);\n" +"st_distance\n" +"-----------------\n" +"123.742351254151" msgstr "" #. Tag: para -#: reference_measure.xml:538 +#: reference_measure.xml:407 #, no-c-format msgid "" -", , , " -"" +"Geometry example - units in meters (SRID: 26986 Massachusetts state plane " +"meters) (most accurate for Massachusetts)" msgstr "" -#. Tag: refname -#: reference_measure.xml:544 +#. Tag: programlisting +#: reference_measure.xml:408 #, no-c-format -msgid "ST_Azimuth" +msgid "" +"SELECT ST_Distance(\n" +" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" +"geometry, 26986),\n" +" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " +"-72.123 42.1546)'::geometry, 26986)\n" +" );\n" +"st_distance\n" +"-----------------\n" +"123.797937878454" msgstr "" -#. Tag: refpurpose -#: reference_measure.xml:546 +#. Tag: para +#: reference_measure.xml:410 #, no-c-format msgid "" -"Returns the north-based azimuth as the angle in radians measured clockwise " -"from the vertical on pointA to pointB." +"Geometry example - units in meters (SRID: 2163 US National Atlas Equal area) " +"(least accurate)" msgstr "" -#. Tag: funcsynopsis -#: reference_measure.xml:549 +#. Tag: programlisting +#: reference_measure.xml:411 #, no-c-format msgid "" -" float ST_Azimuth " -"geometry pointA " -"geometry pointB float ST_Azimuth geography pointA geography pointB " +"SELECT ST_Distance(\n" +" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" +"geometry, 2163),\n" +" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " +"-72.123 42.1546)'::geometry, 2163)\n" +" );\n" +"\n" +"st_distance\n" +"------------------\n" +"126.664256056812" +msgstr "" + +#. Tag: title +#: reference_measure.xml:414 reference_measure.xml:767 +#, no-c-format +msgid "Geography Examples" msgstr "" #. Tag: para -#: reference_measure.xml:565 +#: reference_measure.xml:415 #, no-c-format msgid "" -"Returns the azimuth in radians of the segment defined by the given point " -"geometries, or NULL if the two points are coincident. The azimuth is angle " -"is referenced from north, and is positive clockwise: North = 0; East = " -"π/2; South = π; West = 3π/2." +"Same as geometry example but note units in meters - use sphere for slightly " +"faster and less accurate computation." msgstr "" -#. Tag: para -#: reference_measure.xml:567 +#. Tag: programlisting +#: reference_measure.xml:416 #, no-c-format msgid "" -"For the geography type, the forward azimuth is solved as part of the inverse " -"geodesic problem." +"SELECT ST_Distance(gg1, gg2) As spheroid_dist, ST_Distance(gg1, gg2, false) " +"As sphere_dist\n" +"FROM (SELECT\n" +" 'SRID=4326;POINT(-72.1235 42.3521)'::geography as gg1,\n" +" 'SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geography " +"as gg2\n" +" ) As foo ;\n" +"\n" +" spheroid_dist | sphere_dist\n" +"------------------+------------------\n" +" 123.802076746848 | 123.475736916397" msgstr "" #. Tag: para -#: reference_measure.xml:568 +#: reference_measure.xml:421 #, no-c-format msgid "" -"The azimuth is mathematical concept defined as the angle between a reference " -"plane and a point, with angular units in radians. Units can be converted to " -"degrees using a built-in PostgreSQL function degrees(), as shown in the " -"example." +", , , " +", , , , " msgstr "" -#. Tag: para -#: reference_measure.xml:571 +#. Tag: refname +#: reference_measure.xml:428 #, no-c-format -msgid "Availability: 1.1.0" +msgid "ST_3DDistance" msgstr "" -#. Tag: para -#: reference_measure.xml:572 +#. Tag: refpurpose +#: reference_measure.xml:430 #, no-c-format -msgid "Enhanced: 2.0.0 support for geography was introduced." +msgid "" +"Returns the 3D cartesian minimum distance (based on spatial ref) between two " +"geometries in projected units." msgstr "" -#. Tag: para -#: reference_measure.xml:573 +#. Tag: funcprototype +#: reference_measure.xml:435 #, no-c-format msgid "" -"Enhanced: 2.2.0 measurement on spheroid performed with GeographicLib for " -"improved accuracy and robustness. Requires Proj >= 4.9.0 to take " -"advantage of the new feature." +"float ST_3DDistance " +"geometry g1 " +"geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:574 +#: reference_measure.xml:450 #, no-c-format msgid "" -"Azimuth is especially useful in conjunction with ST_Translate for shifting " -"an object along its perpendicular axis. See upgis_lineshift Plpgsqlfunctions PostGIS wiki section for example of this." +"Returns the 3-dimensional minimum cartesian distance between two geometries " +"in projected units (spatial ref units)." msgstr "" #. Tag: para -#: reference_measure.xml:580 reference_measure.xml:655 +#: reference_measure.xml:456 #, no-c-format -msgid "Geometry Azimuth in degrees" +msgid "&sqlmm_compliant; SQL-MM ?" msgstr "" -#. Tag: programlisting -#: reference_measure.xml:581 +#. Tag: para +#: reference_measure.xml:459 reference_measure.xml:1141 #, no-c-format msgid "" -"SELECT degrees(ST_Azimuth(ST_Point(25, 45), ST_Point(75, 100))) AS degA_B,\n" -" degrees(ST_Azimuth(ST_Point(75, 100), ST_Point(25, 45))) AS " -"degB_A;\n" -"\n" -" dega_b | degb_a\n" -"------------------+------------------\n" -" 42.2736890060937 | 222.273689006094" +"Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for " +"missing Z." msgstr "" #. Tag: para -#: reference_measure.xml:591 +#: reference_measure.xml:460 +#, no-c-format +msgid "Changed: 3.0.0 - SFCGAL version removed" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:466 #, no-c-format msgid "" -"Green: the start Point(25,45) with its vertical. Yellow: degA_B as the path " -"to travel (azimuth)." +"-- 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('SRID=4326;POINT(-72.1235 42.3521 4)'::" +"geometry,2163),\n" +" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45 " +"15, -72.123 42.1546 20)'::geometry,2163)\n" +" ) As dist_3d,\n" +" ST_Distance(\n" +" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" +"geometry,2163),\n" +" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " +"-72.123 42.1546)'::geometry,2163)\n" +" ) As dist_2d;\n" +"\n" +" dist_3d | dist_2d\n" +"------------------+-----------------\n" +" 127.295059324629 | 126.66425605671" msgstr "" -#. Tag: para -#: reference_measure.xml:600 +#. Tag: programlisting +#: reference_measure.xml:467 #, no-c-format msgid "" -"Green: the start Point(75,100) with its vertical. Yellow: degB_A as the path " -"to travel (azimuth)." +"-- 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 'POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 " +"100 5, 175 150 5))'::geometry as poly,\n" +" 'MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, " +"175 155 1), (1 10 2, 5 20 1))'::geometry as mline) as foo;\n" +" dist3d | dist2d\n" +"-------------------+--------\n" +" 0.716635696066337 | 0" msgstr "" #. Tag: para -#: reference_measure.xml:611 +#: reference_measure.xml:473 #, no-c-format msgid "" -", , , PostgreSQL Math Functions" +", , , " +", , " +"" msgstr "" #. Tag: refname -#: reference_measure.xml:618 +#: reference_measure.xml:479 #, no-c-format -msgid "ST_Angle" +msgid "ST_DistanceSphere" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:620 +#: reference_measure.xml:481 #, no-c-format msgid "" -"Returns the angle between 3 points, or between 2 vectors (4 points or 2 " -"lines)." +"Returns minimum distance in meters between two lon/lat geometries using a " +"spherical earth model." msgstr "" -#. Tag: funcsynopsis -#: reference_measure.xml:623 +#. Tag: funcprototype +#: reference_measure.xml:488 #, no-c-format msgid "" -" float ST_Angle " -"geometry point1 " -"geometry point2 " -"geometry point3 " -"geometry point4 float " -"ST_Angle geometry line1 geometry line2 " +"float ST_DistanceSphere " +"geometry geomlonlatA geometry geomlonlatB" msgstr "" #. Tag: para -#: reference_measure.xml:641 +#: reference_measure.xml:499 #, no-c-format msgid "" -"For 3 points, computes the angle measured clockwise of P1P2P3. If input are " -"2 lines, get first and last point of the lines as 4 points. For 4 points," -"compute the angle measured clockwise of P1P2,P3P4. Results are always " -"positive, between 0 and 2*Pi radians. Uses azimuth of pairs or points." -msgstr "" - -#. Tag: para -#: reference_measure.xml:648 -#, no-c-format -msgid "ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)" +"Returns minimum distance in meters between two lon/lat points. Uses a " +"spherical earth and radius derived from the spheroid defined by the SRID. " +"Faster than , but less accurate. " +"PostGIS Versions prior to 1.5 only implemented for points." msgstr "" #. Tag: para -#: reference_measure.xml:649 +#: reference_measure.xml:505 reference_measure.xml:555 #, no-c-format msgid "" -"Result is in radian and can be converted to degrees using a built-in " -"PostgreSQL function degrees(), as shown in the example." +"Availability: 1.5 - support for other geometry types besides points was " +"introduced. Prior versions only work with points." msgstr "" #. Tag: para -#: reference_measure.xml:650 +#: reference_measure.xml:506 #, no-c-format -msgid "Availability: 2.5.0" +msgid "" +"Changed: 2.2.0 In prior versions this used to be called ST_Distance_Sphere" msgstr "" #. Tag: programlisting -#: reference_measure.xml:656 +#: reference_measure.xml:513 #, no-c-format msgid "" -"WITH rand AS (\n" -" SELECT s, random() * 2 * PI() AS rad1\n" -" , random() * 2 * PI() AS rad2\n" -" FROM generate_series(1,2,2) AS s\n" -" )\n" -" , points AS (\n" -" SELECT s, rad1,rad2, ST_MakePoint(cos1+s,sin1+s) as p1, " -"ST_MakePoint(s,s) AS p2, ST_MakePoint(cos2+s,sin2+s) as p3\n" -" FROM rand\n" -" ,cos(rad1) cos1, sin(rad1) sin1\n" -" ,cos(rad2) cos2, sin(rad2) sin2\n" -" )\n" -" SELECT s, ST_AsText(ST_SnapToGrid(ST_MakeLine(ARRAY[p1,p2," -"p3]),0.001)) AS line\n" -" , degrees(ST_Angle(p1,p2,p3)) as computed_angle\n" -" , round(degrees(2*PI()-rad2 -2*PI()+rad1+2*PI()))::int%360 " -"AS reference\n" -" , round(degrees(2*PI()-rad2 -2*PI()+rad1+2*PI()))::int%360 " -"AS reference\n" -" FROM points ;\n" -"\n" -"1 | line | computed_angle | reference\n" -"------------------+------------------\n" -"1 | LINESTRING(1.511 1.86,1 1,0.896 0.005) | 155.27033848688 | 155" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:662 -#, no-c-format -msgid "ST_Centroid" +"SELECT round(CAST(ST_DistanceSphere(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: refpurpose -#: reference_measure.xml:664 +#. Tag: para +#: reference_measure.xml:520 #, no-c-format -msgid "Returns the geometric center of a geometry." +msgid ", " msgstr "" -#. Tag: funcsynopsis -#: reference_measure.xml:668 +#. Tag: refname +#: reference_measure.xml:526 #, no-c-format -msgid "" -" geometry ST_Centroid " -"geometry g1 geography ST_Centroid geography g1 boolean " -"use_spheroid=true " +msgid "ST_DistanceSpheroid" msgstr "" -#. Tag: para -#: reference_measure.xml:690 +#. Tag: refpurpose +#: reference_measure.xml:528 #, no-c-format msgid "" -"Computes the geometric center of a geometry, or equivalently, the center of " -"mass of the geometry as a POINT. For [MULTI]POINTs, this is computed as the arithmetic mean " -"of the input coordinates. For [MULTI]LINESTRINGs, this is computed as the weighted length of each line segment. For " -"[MULTI]POLYGONs, \"weight\" is thought " -"in terms of area. If an empty geometry is supplied, an empty " -"GEOMETRYCOLLECTION is returned. If NULL is supplied, NULL is returned. If " -"CIRCULARSTRING or COMPOUNDCURVE are " -"supplied, they are converted to linestring wtih CurveToLine first, then same " -"than for LINESTRING" +"Returns the minimum distance between two lon/lat geometries using a " +"spheroidal earth model." msgstr "" -#. Tag: para -#: reference_measure.xml:705 +#. Tag: funcprototype +#: reference_measure.xml:534 #, no-c-format msgid "" -"New in 2.3.0 : support CIRCULARSTRING and " -"COMPOUNDCURVE (using CurveToLine)" -msgstr "" - -#. Tag: para -#: reference_measure.xml:707 -#, no-c-format -msgid "Availability: 2.4.0 support for geography was introduced." +"float ST_DistanceSpheroid " +"geometry geomlonlatA geometry geomlonlatB spheroid " +"measurement_spheroid" msgstr "" #. Tag: para -#: reference_measure.xml:709 +#: reference_measure.xml:546 #, 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:714 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 8.1.4, 9.5.5" +"Returns minimum distance in meters between two lon/lat geometries given a " +"particular spheroid. See the explanation of spheroids given for ." msgstr "" #. Tag: para -#: reference_measure.xml:720 +#: reference_measure.xml:550 #, no-c-format msgid "" -"In each of the following illustrations, the green dot represents the " -"centroid of the source geometry." -msgstr "" - -#. Tag: para -#: reference_measure.xml:733 -#, no-c-format -msgid "Centroid of a MULTIPOINT" +"This function does not look at the SRID of the geometry. It assumes the " +"geometry coordinates are based on the provided spheroid." msgstr "" #. Tag: para -#: reference_measure.xml:744 +#: reference_measure.xml:556 #, no-c-format -msgid "Centroid of a LINESTRING" -msgstr "" - -#. Tag: para -#: reference_measure.xml:757 -#, no-c-format -msgid "Centroid of a POLYGON" -msgstr "" - -#. Tag: para -#: reference_measure.xml:768 -#, no-c-format -msgid "Centroid of a GEOMETRYCOLLECTION" +msgid "Changed: 2.2.0 In prior versions this was called ST_Distance_Spheroid" msgstr "" #. Tag: programlisting -#: reference_measure.xml:777 +#: reference_measure.xml:563 #, 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)\n" -"\n" -"SELECT ST_AsText(ST_centroid(g))\n" -"FROM ST_GeomFromText('CIRCULARSTRING(0 2, -1 1,0 0, 0.5 0, 1 0, 2 1, 1 2, " -"0.5 2, 0 2)') AS g ;\n" -"------------------------------------------\n" -"POINT(0.5 1)\n" -"\n" -"\n" -"SELECT ST_AsText(ST_centroid(g))\n" -"FROM ST_GeomFromText('COMPOUNDCURVE(CIRCULARSTRING(0 2, -1 1,0 0),(0 0, 0.5 " -"0, 1 0),CIRCULARSTRING( 1 0, 2 1, 1 2),(1 2, 0.5 2, 0 2))' ) AS g;\n" -"------------------------------------------\n" -"POINT(0.5 1)" +"SELECT round(CAST(\n" +" ST_DistanceSpheroid(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_DistanceSphere(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:783 +#: reference_measure.xml:570 #, no-c-format -msgid ", " +msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:789 +#: reference_measure.xml:577 #, no-c-format -msgid "ST_ClosestPoint" +msgid "ST_FrechetDistance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:791 +#: reference_measure.xml:579 #, no-c-format -msgid "" -"Returns the 2-dimensional point on g1 that is closest to g2. " -"This is the first point of the shortest line." +msgid "Returns the Fréchet distance between two geometries." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:797 +#: reference_measure.xml:584 #, no-c-format msgid "" -"geometry ST_ClosestPoint " +"float ST_FrechetDistance " "geometry g1 " -"geometry g2" +"geometry g2 " +"float densifyFrac = -1" msgstr "" #. Tag: para -#: reference_measure.xml:812 +#: reference_measure.xml:602 #, no-c-format msgid "" -"Returns the 2-dimensional point on g1 that is closest to g2. This is " -"the first point of the shortest line." +"Implements algorithm for computing the Fréchet distance restricted to " +"discrete points for both geometries, based on Computing Discrete " +"Fréchet Distance. The Fréchet distance is a measure of similarity " +"between curves that takes into account the location and ordering of the " +"points along the curves. Therefore it is often better than the Hausdorff " +"distance." msgstr "" #. Tag: para -#: reference_measure.xml:815 +#: reference_measure.xml:604 #, no-c-format msgid "" -"If you have a 3D Geometry, you may prefer to use ." +"When the optional densifyFrac is specified, this function performs a segment " +"densification before computing the discrete Fréchet 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:816 reference_measure.xml:2227 -#: reference_measure.xml:2381 reference_measure.xml:3051 -#: reference_measure.xml:3626 +#: reference_measure.xml:607 reference_measure.xml:682 #, no-c-format -msgid "Availability: 1.5.0" +msgid "" +"Units are in the units of the spatial reference system of the geometries." msgstr "" #. Tag: para -#: reference_measure.xml:830 +#: reference_measure.xml:611 reference_measure.xml:686 #, 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." +"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: programlisting -#: reference_measure.xml:834 +#. Tag: para +#: reference_measure.xml:616 #, 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)" +"The smaller densifyFrac we specify, the more acurate Fréchet distance we " +"get. But, the computation time and the memory usage increase with the square " +"of the number of subsegments." msgstr "" #. Tag: para -#: reference_measure.xml:842 +#: reference_measure.xml:620 reference_measure.xml:1253 #, no-c-format -msgid "closest point on polygon A to polygon B" +msgid "Performed by the GEOS module." +msgstr "" + +#. Tag: para +#: reference_measure.xml:621 +#, no-c-format +msgid "Availability: 2.4.0 - requires GEOS >= 3.7.0" msgstr "" #. Tag: programlisting -#: reference_measure.xml:845 +#: reference_measure.xml:627 #, 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)" +"postgres=# SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, " +"'LINESTRING (0 0, 50 50, 100 0)'::geometry);\n" +" st_frechetdistance\n" +"--------------------\n" +" 70.7106781186548\n" +"(1 row)" msgstr "" -#. Tag: para -#: reference_measure.xml:857 +#. Tag: programlisting +#: reference_measure.xml:628 #, no-c-format msgid "" -",, , , " +"SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, 'LINESTRING " +"(0 0, 50 50, 100 0)'::geometry, 0.5);\n" +" st_frechetdistance\n" +"--------------------\n" +" 50\n" +"(1 row)" msgstr "" #. Tag: refname -#: reference_measure.xml:863 +#: reference_measure.xml:640 #, no-c-format -msgid "ST_ClusterDBSCAN" +msgid "ST_HausdorffDistance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:865 +#: reference_measure.xml:642 #, no-c-format -msgid "" -"Windowing function that returns integer id for the cluster each input " -"geometry is in based on 2D implementation of Density-based spatial " -"clustering of applications with noise (DBSCAN) algorithm." +msgid "Returns the Hausdorff distance between two geometries." msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:870 +#. Tag: funcsynopsis +#: reference_measure.xml:646 #, no-c-format msgid "" -"integer ST_ClusterDBSCAN " -"geometry winset geom float8 eps integer minpoints" +" float ST_HausdorffDistance geometry g1 geometry g2 float " +"ST_HausdorffDistance geometry " +" g1 geometry g2 float " +"densifyFrac " msgstr "" #. Tag: para -#: reference_measure.xml:888 +#: reference_measure.xml:674 #, no-c-format msgid "" -"Returns cluster number for each input geometry, based on a 2D implementation " -"of the Density-based " -"spatial clustering of applications with noise (DBSCAN) algorithm. " -"Unlike , it does not require the number " -"of clusters to be specified, but instead uses the desired distance (eps) and density " -"(minpoints) parameters to construct each cluster." +"Returns the Hausdorff distance between two geometries, a measure of how " +"similar or dissimilar 2 geometries are." msgstr "" #. Tag: para -#: reference_measure.xml:895 +#: reference_measure.xml:676 #, no-c-format -msgid "An input geometry will be added to a cluster if it is either:" +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. Wikipedia article on Hausdorff " +"distance Martin Davis note on how Hausdorff " +"Distance calculation was used to prove correctness of the " +"CascadePolygonUnion approach." msgstr "" #. Tag: para -#: reference_measure.xml:899 +#: reference_measure.xml:679 #, no-c-format msgid "" -"A \"core\" geometry, that is within eps distance of at least minpoints " -"input geometries (including itself) or" +"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:904 +#: reference_measure.xml:691 #, no-c-format msgid "" -"A \"border\" geometry, that is within eps distance of a core geometry." -msgstr "" - -#. Tag: para -#: reference_measure.xml:911 -#, no-c-format -msgid "" -"Note that border geometries may be within eps distance of " -"core geometries in more than one cluster; in this case, either assignment " -"would be correct, and the border geometry will be arbitrarily asssigned to " -"one of the available clusters. In these cases, it is possible for a correct " -"cluster to be generated with fewer than minpoints " -"geometries. When assignment of a border geometry is ambiguous, repeated " -"calls to ST_ClusterDBSCAN will produce identical results if an ORDER BY " -"clause is included in the window definition, but cluster assignments may " -"differ from other implementations of the same algorithm." +"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:919 +#: reference_measure.xml:702 #, no-c-format msgid "" -"Input geometries that do not meet the criteria to join any other cluster " -"will be assigned a cluster number of NULL." -msgstr "" - -#. Tag: para -#: reference_measure.xml:923 reference_measure.xml:1040 -#, no-c-format -msgid "Availability: 2.3.0 - requires GEOS" +"For each building, find the parcel that best represents it. First we require " +"the parcel intersect with the geometry. DISTINCT ON guarantees we get each " +"building listed only once, the ORDER BY .. ST_HausdorffDistance gives us a " +"preference of parcel that is most similar to the building." msgstr "" -#. Tag: para -#: reference_measure.xml:928 +#. Tag: programlisting +#: reference_measure.xml:704 #, no-c-format msgid "" -"Assigning a cluster number to each polygon within 50 meters of each other. " -"Require at least 2 polygons per cluster" +"SELECT DISTINCT ON(buildings.gid) buildings.gid, parcels.parcel_id\n" +" FROM buildings INNER JOIN parcels ON ST_Intersects(buildings.geom,parcels." +"geom)\n" +" ORDER BY buildings.gid, ST_HausdorffDistance(buildings.geom, parcels." +"geom);" msgstr "" -#. Tag: para -#: reference_measure.xml:940 +#. Tag: programlisting +#: reference_measure.xml:706 #, no-c-format -msgid "within 50 meters at least 2 per cluster. singletons have NULL for cid" +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:943 +#: reference_measure.xml:707 #, no-c-format msgid "" -"SELECT name, ST_ClusterDBSCAN(geom, eps := 50, minpoints := 2) over () AS " -"cid\n" -"FROM boston_polys\n" -"WHERE name > '' AND building > ''\n" -" AND ST_DWithin(geom,\n" -" ST_Transform(\n" -" ST_GeomFromText('POINT(-71.04054 42.35141)', 4326), 26986),\n" -" 500);" +"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: screen -#: reference_measure.xml:946 +#. Tag: refname +#: reference_measure.xml:719 #, no-c-format -msgid "" -"" +msgid "ST_Length" msgstr "" -#. Tag: para -#: reference_measure.xml:954 +#. Tag: refpurpose +#: reference_measure.xml:721 #, no-c-format -msgid "" -"Combining parcels with the same cluster number into a single geometry. This " -"uses named argument calling" +msgid "Returns the 2D length of a linear geometry." msgstr "" -#. Tag: programlisting -#: reference_measure.xml:957 +#. Tag: funcsynopsis +#: reference_measure.xml:724 #, no-c-format msgid "" -"SELECT cid, ST_Collect(geom) AS cluster_geom, array_agg(parcel_id) AS " -"ids_in_cluster FROM (\n" -" SELECT parcel_id, ST_ClusterDBSCAN(geom, eps := 0.5, minpoints := 5) " -"over () AS cid, geom\n" -" FROM parcels) sq\n" -"GROUP BY cid;" +" float ST_Length " +"geometry a_2dlinestring float " +"ST_Length geography geog boolean use_spheroid=true " +"" msgstr "" #. Tag: para -#: reference_measure.xml:962 +#: reference_measure.xml:739 #, no-c-format msgid "" -", , , " +"For geometry types: returns the 2D Cartesian length of the geometry if it is " +"a LineString, MultiLineString, ST_Curve, ST_MultiCurve. For areal geometries " +"0 is returned; use instead. The units of " +"length is determined by the spatial reference system of the geometry." msgstr "" -#. Tag: refname -#: reference_measure.xml:973 +#. Tag: para +#: reference_measure.xml:743 #, no-c-format -msgid "ST_ClusterIntersecting" +msgid "" +"For geography types: computation is performed using the inverse geodesic " +"calculation. Units of length are in meters. If PostGIS is compiled with PROJ " +"version 4.8.0 or later, the spheroid is specified by the SRID, otherwise it " +"is exclusive to WGS84. If use_spheroid=false, then the " +"calculation is based on a sphere instead of a spheroid." msgstr "" -#. Tag: refpurpose -#: reference_measure.xml:975 +#. Tag: para +#: reference_measure.xml:748 #, no-c-format msgid "" -"Aggregate. Returns an array with the connected components of a set of " -"geometries" +"Currently for geometry this is an alias for ST_Length2D, but this may change " +"to support higher dimensions." msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:980 +#. Tag: para +#: reference_measure.xml:750 #, no-c-format msgid "" -"geometry[] ST_ClusterIntersecting " -"geometry set g" +"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:990 +#: reference_measure.xml:753 #, no-c-format msgid "" -"ST_ClusterIntersecting is an aggregate function that returns an array of " -"GeometryCollections, where each GeometryCollection represents an " -"interconnected set of geometries." +"For geography the calculation defaults to using a spheroidal model. To use " +"the faster but less accurate spherical calculation use ST_Length(gg,false);" msgstr "" #. Tag: para -#: reference_measure.xml:992 reference_measure.xml:1114 +#: reference_measure.xml:754 reference_measure.xml:1305 #, no-c-format -msgid "Availability: 2.2.0 - requires GEOS" +msgid "&sfs_compliant; s2.1.5.1" msgstr "" -#. Tag: programlisting -#: reference_measure.xml:997 +#. Tag: para +#: reference_measure.xml:755 #, no-c-format -msgid "" -"WITH testdata AS\n" -" (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,\n" -" 'LINESTRING (5 5, 4 4)'::geometry,\n" -" 'LINESTRING (6 6, 7 7)'::geometry,\n" -" 'LINESTRING (0 0, -1 -1)'::geometry,\n" -" 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS " -"geom)\n" -"\n" -"SELECT ST_AsText(unnest(ST_ClusterIntersecting(geom))) FROM testdata;\n" -"\n" -"--result\n" -"\n" -"st_astext\n" -"---------\n" -"GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 " -"-1),POLYGON((0 0,4 0,4 4,0 4,0 0)))\n" -"GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))" +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.2, 9.3.4" msgstr "" #. Tag: para -#: reference_measure.xml:1001 +#: reference_measure.xml:756 #, no-c-format -msgid "" -", , " +msgid "Availability: 1.5.0 geography support was introduced in 1.5." msgstr "" -#. Tag: refname -#: reference_measure.xml:1013 +#. Tag: para +#: reference_measure.xml:757 #, no-c-format -msgid "ST_ClusterKMeans" +msgid "&sfcgal_enhanced;" msgstr "" -#. Tag: refpurpose -#: reference_measure.xml:1015 +#. Tag: title +#: reference_measure.xml:761 #, no-c-format -msgid "" -"Windowing function that returns integer id for the cluster each input " -"geometry is in." +msgid "Geometry Examples" msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:1020 +#. Tag: para +#: reference_measure.xml:762 #, no-c-format msgid "" -"integer ST_ClusterKMeans " -"geometry winset geom integer number_of_clusters" +"Return length in feet for line string. Note this is in feet because " +"EPSG:2249 is Massachusetts State Plane Feet" msgstr "" -#. Tag: para -#: reference_measure.xml:1035 +#. Tag: programlisting +#: reference_measure.xml:764 #, no-c-format msgid "" -"Returns 2D distance based k-means cluster number for each input geometry. " -"The distance used for clustering is the distance between the centroids of " -"the geometries." +"SELECT ST_Length(ST_GeomFromText('LINESTRING(743238 2967416,743238 " +"2967450,743265 2967450,\n" +"743265.625 2967416,743238 2967416)',2249));\n" +"\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" +"\n" +"st_length\n" +"---------\n" +"34309.4563576191" msgstr "" #. Tag: para -#: reference_measure.xml:1045 +#: reference_measure.xml:768 #, no-c-format -msgid "Generate dummy set of parcels for examples" +msgid "Return length of WGS 84 geography line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1046 +#: reference_measure.xml:769 #, no-c-format msgid "" -"CREATE TABLE parcels AS\n" -"SELECT lpad((row_number() over())::text,3,'0') As parcel_id, geom,\n" -"('{residential, commercial}'::text[])[1 + mod(row_number()OVER(),2)] As " -"type\n" -"FROM\n" -" ST_Subdivide(ST_Buffer('LINESTRING(40 100, 98 100, 100 150, 60 90)'::" -"geometry,\n" -" 40, 'endcap=square'),12) As geom;" +"-- the default calculation uses a 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" +"\n" +" length_spheroid | length_sphere\n" +"------------------+------------------\n" +" 34310.5703627288 | 34346.2060960742" msgstr "" #. Tag: para -#: reference_measure.xml:1058 +#: reference_measure.xml:773 #, no-c-format -msgid "Original Parcels" +msgid "" +", , , , " msgstr "" -#. Tag: para -#: reference_measure.xml:1068 +#. Tag: refname +#: reference_measure.xml:779 #, no-c-format -msgid "Parcels color-coded by cluster number (cid)" +msgid "ST_Length2D" msgstr "" -#. Tag: programlisting -#: reference_measure.xml:1071 +#. Tag: refpurpose +#: reference_measure.xml:781 #, no-c-format msgid "" -"SELECT ST_ClusterKMeans(geom, 5) OVER() AS cid, parcel_id, geom\n" -"FROM parcels;\n" -"-- result\n" -" cid | parcel_id | geom\n" -"-----+-----------+---------------\n" -" 0 | 001 | 0103000000...\n" -" 0 | 002 | 0103000000...\n" -" 1 | 003 | 0103000000...\n" -" 0 | 004 | 0103000000...\n" -" 1 | 005 | 0103000000...\n" -" 2 | 006 | 0103000000...\n" -" 2 | 007 | 0103000000...\n" -"(7 rows)" +"Returns the 2D length of a linear geometry. Alias for ST_Length" msgstr "" -#. Tag: programlisting -#: reference_measure.xml:1078 +#. Tag: funcprototype +#: reference_measure.xml:786 #, no-c-format msgid "" -"-- Partitioning parcel clusters by type\n" -"SELECT ST_ClusterKMeans(geom,3) over (PARTITION BY type) AS cid, parcel_id, " -"type\n" -"FROM parcels;\n" -"-- result\n" -" cid | parcel_id | type\n" -"-----+-----------+-------------\n" -" 1 | 005 | commercial\n" -" 1 | 003 | commercial\n" -" 2 | 007 | commercial\n" -" 0 | 001 | commercial\n" -" 1 | 004 | residential\n" -" 0 | 002 | residential\n" -" 2 | 006 | residential\n" -"(7 rows)" +"float ST_Length2D " +"geometry a_2dlinestring" msgstr "" #. Tag: para -#: reference_measure.xml:1084 +#: reference_measure.xml:796 #, no-c-format msgid "" -", , , " +"Returns the 2D length of the geometry if it is a linestring or multi-" +"linestring. This is an alias for ST_Length" +msgstr "" + +#. Tag: para +#: reference_measure.xml:805 +#, no-c-format +msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:1094 +#: reference_measure.xml:811 #, no-c-format -msgid "ST_ClusterWithin" +msgid "ST_3DLength" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1096 +#: reference_measure.xml:813 #, no-c-format -msgid "" -"Aggregate. Returns an array of GeometryCollections, where each " -"GeometryCollection represents a set of geometries separated by no more than " -"the specified distance." +msgid "Returns the 3D length of a linear geometry." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:1101 +#: reference_measure.xml:818 +#, no-c-format +msgid "" +"float ST_3DLength " +"geometry a_3dlinestring" +msgstr "" + +#. Tag: para +#: reference_measure.xml:828 #, no-c-format msgid "" -"geometry[] ST_ClusterWithin " -"geometry set g " -"float8 distance" +"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:1112 +#: reference_measure.xml:831 +#, no-c-format +msgid "Changed: 2.0.0 In prior versions this used to be called ST_Length3D" +msgstr "" + +#. Tag: para +#: reference_measure.xml:838 #, no-c-format msgid "" -"ST_ClusterWithin is an aggregate function that returns an array of " -"GeometryCollections, where each GeometryCollection represents a set of " -"geometries separated by no more than the specified distance. (Distances are " -"Cartesian distances in the units of the SRID.)" +"Return length in feet for a 3D cable. Note this is in feet because EPSG:2249 " +"is Massachusetts State Plane Feet" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1119 +#: reference_measure.xml:840 #, no-c-format msgid "" -"WITH testdata AS\n" -" (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,\n" -" 'LINESTRING (5 5, 4 4)'::geometry,\n" -" 'LINESTRING (6 6, 7 7)'::geometry,\n" -" 'LINESTRING (0 0, -1 -1)'::geometry,\n" -" 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS " -"geom)\n" -"\n" -"SELECT ST_AsText(unnest(ST_ClusterWithin(geom, 1.4))) FROM testdata;\n" -"\n" -"--result\n" -"\n" -"st_astext\n" -"---------\n" -"GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 " -"-1),POLYGON((0 0,4 0,4 4,0 4,0 0)))\n" -"GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))" +"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:1123 +#: reference_measure.xml:847 #, no-c-format -msgid "" -", , " +msgid ", " msgstr "" #. Tag: refname -#: reference_measure.xml:1134 +#: reference_measure.xml:853 #, no-c-format -msgid "ST_Contains" +msgid "ST_LengthSpheroid" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1136 +#: reference_measure.xml:855 #, 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." +"Returns the 2D or 3D length/perimeter of a lon/lat geometry on a spheroid." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:1141 +#: reference_measure.xml:860 #, no-c-format msgid "" -"boolean ST_Contains " -"geometry geomA " -"geometry geomB" +"float ST_LengthSpheroid " +"geometry a_geometry spheroid a_spheroid" msgstr "" #. Tag: para -#: reference_measure.xml:1156 +#: reference_measure.xml:871 #, 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 where geometry A does not Contain Properly " -"itself." +"Calculates the length or perimeter 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 spheroid is specified by a text " +"value as follows:" msgstr "" -#. Tag: para -#: reference_measure.xml:1160 +#. Tag: literallayout +#: reference_measure.xml:876 #, 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." +"SPHEROID[<NAME>,<SEMI-MAJOR AXIS>,<INVERSE FLATTENING>]" msgstr "" #. Tag: para -#: reference_measure.xml:1165 reference_measure.xml:1393 -#: reference_measure.xml:1473 reference_measure.xml:1838 -#: reference_measure.xml:3182 reference_measure.xml:3531 -#: reference_measure.xml:3848 +#: reference_measure.xml:877 #, no-c-format -msgid "Performed by the GEOS module" +msgid "For example:" msgstr "" -#. Tag: para -#: reference_measure.xml:1166 reference_measure.xml:2754 +#. Tag: literallayout +#: reference_measure.xml:878 #, no-c-format -msgid "" -"Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support " -"MultiPoints with few points. Prior versions only supported point in polygon." +msgid "SPHEROID[\"GRS_1980\",6378137,298.257222101]" msgstr "" #. Tag: para -#: reference_measure.xml:1169 reference_measure.xml:1331 -#: reference_measure.xml:1396 reference_measure.xml:1476 -#: reference_measure.xml:1580 reference_measure.xml:1835 -#: reference_measure.xml:3729 reference_measure.xml:3853 +#: reference_measure.xml:880 #, no-c-format -msgid "Do not call with a GEOMETRYCOLLECTION as an argument" +msgid "Availability: 1.2.2" msgstr "" #. Tag: para -#: reference_measure.xml:1173 reference_measure.xml:1335 -#: reference_measure.xml:1400 reference_measure.xml:1480 -#: reference_measure.xml:3857 +#: reference_measure.xml:881 #, no-c-format msgid "" -"Do not use this function with invalid geometries. You will get unexpected " -"results." +"Changed: 2.2.0 In prior versions this was called ST_Length_Spheroid and had " +"the alias ST_3DLength_Spheroid" msgstr "" -#. Tag: para -#: reference_measure.xml:1176 +#. Tag: programlisting +#: reference_measure.xml:888 #, 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." +"SELECT ST_LengthSpheroid( geometry_column,\n" +" 'SPHEROID[\"GRS_1980\",6378137,298.257222101]' )\n" +" FROM geometry_table;\n" +"\n" +"SELECT ST_LengthSpheroid( the_geom, sph_m ) As tot_len,\n" +"ST_LengthSpheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" +"ST_LengthSpheroid(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_LengthSpheroid( the_geom, sph_m ) As tot_len,\n" +"ST_LengthSpheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" +"ST_LengthSpheroid(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:1181 reference_measure.xml:1413 -#: reference_measure.xml:1488 reference_measure.xml:1844 -#: reference_measure.xml:2767 reference_measure.xml:3191 -#: reference_measure.xml:3865 +#: reference_measure.xml:895 #, no-c-format -msgid "" -"NOTE: this is the \"allowable\" version that returns a boolean, not an " -"integer." +msgid ", " msgstr "" -#. Tag: para -#: reference_measure.xml:1184 +#. Tag: refname +#: reference_measure.xml:902 #, no-c-format -msgid "" -"&sfs_compliant; s2.1.1.2 // s2.1.13.3 - same as within(geometry B, geometry " -"A)" +msgid "ST_LongestLine" msgstr "" -#. Tag: para -#: reference_measure.xml:1186 +#. Tag: refpurpose +#: reference_measure.xml:904 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.31" +msgid "Returns the 2D longest line between two geometries." msgstr "" -#. Tag: para -#: reference_measure.xml:1188 reference_measure.xml:1417 -#: reference_measure.xml:1492 +#. Tag: funcprototype +#: reference_measure.xml:910 #, no-c-format msgid "" -"There are certain subtleties to ST_Contains and ST_Within that are not " -"intuitively obvious. For details check out Subtleties of OGC Covers, Contains, Within" +"geometry ST_LongestLine " +"geometry g1 " +"geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:1195 +#: reference_measure.xml:925 #, no-c-format -msgid "" -"The ST_Contains predicate returns TRUE in all the following illustrations." +msgid "Returns the 2-D longest line between the points of two geometries." msgstr "" #. Tag: para -#: reference_measure.xml:1207 +#: reference_measure.xml:927 #, no-c-format -msgid "LINESTRING / MULTIPOINT" +msgid "" +"The function returns the first longest line if more than one is found. The " +"line returned starts on g1 and ends on g2. The length of the line is equal " +"to the distance returned by ." msgstr "" #. Tag: para -#: reference_measure.xml:1217 reference_measure.xml:3807 +#: reference_measure.xml:946 #, no-c-format -msgid "POLYGON / POINT" +msgid "Longest line between point and line" msgstr "" -#. Tag: para -#: reference_measure.xml:1228 reference_measure.xml:1268 -#: reference_measure.xml:3776 +#. Tag: programlisting +#: reference_measure.xml:949 #, no-c-format -msgid "POLYGON / LINESTRING" +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:1238 reference_measure.xml:3228 -#: reference_measure.xml:3756 reference_measure.xml:3766 +#: reference_measure.xml:957 #, no-c-format -msgid "POLYGON / POLYGON" +msgid "longest line between polygon and polygon" msgstr "" -#. Tag: para -#: reference_measure.xml:1246 +#. Tag: programlisting +#: reference_measure.xml:960 #, no-c-format msgid "" -"The ST_Contains predicate returns FALSE in all the following illustrations." +"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:1258 +#: reference_measure.xml:976 #, no-c-format -msgid "POLYGON / MULTIPOINT" +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:1276 -#, 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" +#: reference_measure.xml:980 +#, 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" -" 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" +" llinewkt | max_dist | lenll\n" +"---------------------------+------------------+------------------\n" +" LINESTRING(23 22,129 178) | 188.605408193933 | 188.605408193933" msgstr "" #. Tag: para -#: reference_measure.xml:1281 +#: reference_measure.xml:991 #, no-c-format msgid "" -", , , " -", , " +", , " msgstr "" #. Tag: refname -#: reference_measure.xml:1287 +#: reference_measure.xml:997 #, no-c-format -msgid "ST_ContainsProperly" +msgid "ST_3DLongestLine" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1289 +#: reference_measure.xml:999 #, 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." +msgid "Returns the 3D longest line between two geometries" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:1294 +#: reference_measure.xml:1004 #, no-c-format msgid "" -"boolean ST_ContainsProperly " -"geometry geomA " -"geometry geomB" +"geometry ST_3DLongestLine " +"geometry g1 " +"geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:1309 +#: reference_measure.xml:1019 #, no-c-format msgid "" -"Returns true if B intersects the interior of A but not the boundary (or " -"exterior)." +"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 returns for g1 and g2." msgstr "" #. Tag: para -#: reference_measure.xml:1311 +#: reference_measure.xml:1038 #, no-c-format -msgid "A does not contain properly itself, but does contain itself." +msgid "linestring and point -- both 3d and 2d longest line" msgstr "" -#. Tag: para -#: reference_measure.xml:1312 +#. Tag: programlisting +#: reference_measure.xml:1039 #, 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 " +"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:1316 +#: reference_measure.xml:1043 #, no-c-format -msgid "" -"From JTS docs slightly reworded: The advantage to using this predicate over " -" and is " -"that it can be computed efficiently, with no need to compute topology at " -"individual points." +msgid "linestring and multipoint -- both 3d and 2d longest line" msgstr "" -#. Tag: para -#: reference_measure.xml:1318 +#. Tag: programlisting +#: reference_measure.xml:1044 #, 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:1328 -#, no-c-format -msgid "Availability: 1.4.0 - requires GEOS >= 3.1.0." +"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:1338 +#: reference_measure.xml:1048 #, 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." +msgid "Multilinestring and polygon both 3d and 2d longest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:1347 +#: reference_measure.xml:1049 #, 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" +"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:1352 +#: reference_measure.xml:1061 #, no-c-format msgid "" -", , , , , , , " +", , , " +", " msgstr "" #. Tag: refname -#: reference_measure.xml:1358 +#: reference_measure.xml:1067 #, no-c-format -msgid "ST_Covers" +msgid "ST_MaxDistance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1360 -#, no-c-format -msgid "Returns 1 (TRUE) if no point in Geometry B is outside Geometry A" -msgstr "" - -#. Tag: funcsynopsis -#: reference_measure.xml:1365 +#: reference_measure.xml:1069 #, no-c-format msgid "" -" boolean ST_Covers " -"geometry geomA " -"geometry geomB boolean ST_Covers geography geogpolyA geography " -"geogpointB " +"Returns the 2D largest distance between two geometries in projected units." msgstr "" -#. Tag: para -#: reference_measure.xml:1390 +#. Tag: funcprototype +#: reference_measure.xml:1075 #, no-c-format msgid "" -"Returns 1 (TRUE) if no point in Geometry/Geography B is outside Geometry/" -"Geography A" +"float ST_MaxDistance " +"geometry g1 " +"geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:1403 +#: reference_measure.xml:1088 #, 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." +"Returns the 2-dimensional maximum distance between two geometries 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: para -#: reference_measure.xml:1408 +#: reference_measure.xml:1098 #, no-c-format -msgid "" -"Enhanced: 2.4.0 Support for polygon in polygon and line in polygon added for " -"geography type" +msgid "Basic furthest distance the point is to any part of the line" msgstr "" -#. Tag: para -#: reference_measure.xml:1409 reference_measure.xml:3850 +#. Tag: programlisting +#: reference_measure.xml:1099 #, no-c-format msgid "" -"Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to " -"support MultiPoints with few points. Prior versions only supported point in " -"polygon." +"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:1410 +#: reference_measure.xml:1105 #, no-c-format -msgid "Availability: 1.5 - support for geography was introduced." +msgid "" +", , " msgstr "" -#. Tag: para -#: reference_measure.xml:1411 reference_measure.xml:1482 +#. Tag: refname +#: reference_measure.xml:1111 #, no-c-format -msgid "Availability: 1.2.2 - requires GEOS >= 3.0" +msgid "ST_3DMaxDistance" msgstr "" -#. Tag: para -#: reference_measure.xml:1416 reference_measure.xml:1491 +#. Tag: refpurpose +#: reference_measure.xml:1113 #, no-c-format -msgid "Not an OGC standard, but Oracle has it too." +msgid "" +"Returns the 3D cartesian maximum distance (based on spatial ref) between two " +"geometries in projected units." msgstr "" -#. Tag: para -#: reference_measure.xml:1423 +#. Tag: funcprototype +#: reference_measure.xml:1118 #, no-c-format -msgid "Geometry example" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:1424 -#, 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)" +msgid "" +"float ST_3DMaxDistance " +"geometry g1 " +"geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:1425 +#: reference_measure.xml:1133 #, no-c-format -msgid "Geeography Example" +msgid "" +"Returns the 3-dimensional maximum cartesian distance between two geometries " +"in projected units (spatial ref units)." msgstr "" #. Tag: programlisting -#: reference_measure.xml:1426 +#: reference_measure.xml:1147 #, 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" +"-- 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" -" poly_covers_pt | buff_10m_covers_cent\n" -"----------------+------------------\n" -" f | t" +" dist_3d | dist_2d\n" +"------------------+------------------\n" +" 24383.7467488441 | 22247.8472107251" msgstr "" #. Tag: para -#: reference_measure.xml:1431 +#: reference_measure.xml:1153 #, no-c-format -msgid ", , " +msgid "" +", , , " +"" msgstr "" #. Tag: refname -#: reference_measure.xml:1437 +#: reference_measure.xml:1159 #, no-c-format -msgid "ST_CoveredBy" +msgid "ST_MinimumClearance" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:1439 +#: reference_measure.xml:1160 #, no-c-format msgid "" -"Returns 1 (TRUE) if no point in Geometry/Geography A is outside " -"Geometry/Geography B" +"Returns the minimum clearance of a geometry, a measure of a geometry's " +"robustness." msgstr "" -#. Tag: funcsynopsis -#: reference_measure.xml:1444 +#. Tag: funcprototype +#: reference_measure.xml:1165 #, no-c-format msgid "" -" boolean ST_CoveredBy " -"geometry geomA " -"geometry geomB boolean ST_CoveredBy geography geogA geography geogB " +"float ST_MinimumClearance " +"geometry g" msgstr "" #. Tag: para -#: reference_measure.xml:1470 +#: reference_measure.xml:1175 #, no-c-format msgid "" -"Returns 1 (TRUE) if no point in Geometry/Geography A is outside " -"Geometry/Geography B" +"It is not uncommon to have a geometry that, while meeting the criteria for " +"validity according to ST_IsValid (polygons) or ST_IsSimple (lines), would " +"become invalid if one of the vertices moved by a slight distance, as can " +"happen during conversion to text-based formats (such as WKT, KML, GML " +"GeoJSON), or binary formats that do not use double-precision floating point " +"coordinates (MapInfo TAB)." msgstr "" #. Tag: para -#: reference_measure.xml:1483 +#: reference_measure.xml:1182 #, 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:1498 -#, 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)" +"A geometry's \"minimum clearance\" is the smallest distance by which a " +"vertex of the geometry could be moved to produce an invalid geometry. It can " +"be thought of as a quantitative measure of a geometry's robustness, where " +"increasing values of minimum clearance indicate increasing robustness." msgstr "" #. Tag: para -#: reference_measure.xml:1503 +#: reference_measure.xml:1188 #, no-c-format msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:1509 -#, no-c-format -msgid "ST_Crosses" +"If a geometry has a minimum clearance of e, it can be " +"said that:" msgstr "" -#. Tag: refpurpose -#: reference_measure.xml:1511 +#. Tag: para +#: reference_measure.xml:1192 #, no-c-format msgid "" -"Returns TRUE if the supplied geometries have some, but " -"not all, interior points in common." +"No two distinct vertices in the geometry are separated by less than " +"e." msgstr "" -#. Tag: funcprototype -#: reference_measure.xml:1517 +#. Tag: para +#: reference_measure.xml:1197 #, no-c-format msgid "" -"boolean ST_Crosses " -"geometry g1 " -"geometry g2" +"No vertex is closer than e to a line segement of which it " +"is not an endpoint." msgstr "" #. Tag: para -#: reference_measure.xml:1530 +#: reference_measure.xml:1204 #, no-c-format msgid "" -"ST_Crosses takes two geometry objects and returns " -"TRUE 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 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 " -"FALSE." +"If no minimum clearance exists for a geometry (for example, a single point, " +"or a multipoint whose points are identical), then ST_MinimumClearance will " +"return Infinity." msgstr "" #. Tag: para -#: reference_measure.xml:1539 +#: reference_measure.xml:1209 #, no-c-format -msgid "In mathematical terms, this is expressed as:" +msgid "Availability: 2.3.0" msgstr "" -#. Tag: remark -#: reference_measure.xml:1541 +#. Tag: programlisting +#: reference_measure.xml:1215 #, 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." +"SELECT ST_MinimumClearance('POLYGON ((0 0, 1 0, 1 1, 0.5 3.2e-4, 0 0))');\n" +" st_minimumclearance\n" +"---------------------\n" +" 0.00032" msgstr "" -#. Tag: para -#: reference_measure.xml:1552 +#. Tag: refname +#: reference_measure.xml:1230 #, no-c-format -msgid "The DE-9IM Intersection Matrix for the two geometries is:" +msgid "ST_MinimumClearanceLine" msgstr "" -#. Tag: para -#: reference_measure.xml:1556 +#. Tag: refpurpose +#: reference_measure.xml:1231 #, no-c-format msgid "" -"T*T****** (for Point/Line, Point/Area, and Line/Area " -"situations)" +"Returns the two-point LineString spanning a geometry's minimum clearance." msgstr "" -#. Tag: para -#: reference_measure.xml:1561 +#. Tag: funcprototype +#: reference_measure.xml:1236 #, no-c-format msgid "" -"T*****T** (for Line/Point, Area/Point, and Area/Line " -"situations)" +"Geometry ST_MinimumClearanceLine " +"geometry g" msgstr "" #. Tag: para -#: reference_measure.xml:1566 +#: reference_measure.xml:1249 #, no-c-format -msgid "0******** (for Line/Line situations)" +msgid "" +"Returns the two-point LineString spanning a geometry's minimum clearance. If " +"the geometry does not have a minimum clearance, LINESTRING EMPTY will be returned." msgstr "" #. Tag: para -#: reference_measure.xml:1570 +#: reference_measure.xml:1254 #, no-c-format -msgid "For any other combination of dimensions this predicate returns false." +msgid "Availability: 2.3.0 - requires GEOS >= 3.6.0" msgstr "" -#. Tag: para -#: reference_measure.xml:1573 +#. Tag: programlisting +#: reference_measure.xml:1260 #, 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:1589 -#, no-c-format -msgid "&sfs_compliant; s2.1.13.3" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1590 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.29" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1596 reference_measure.xml:3200 -#, no-c-format -msgid "The following illustrations all return TRUE." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1608 -#, no-c-format -msgid "MULTIPOINT / LINESTRING" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1618 -#, no-c-format -msgid "MULTIPOINT / POLYGON" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1630 -#, no-c-format -msgid "LINESTRING / POLYGON" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1640 reference_measure.xml:3220 -#: reference_measure.xml:3787 reference_measure.xml:3797 -#, no-c-format -msgid "LINESTRING / LINESTRING" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1648 -#, 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:1656 -#, 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:1660 -#, 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:1667 -#, 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:1671 -#, 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:1678 -#, no-c-format -msgid "ST_LineCrossingDirection" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:1680 -#, 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:1685 -#, no-c-format -msgid "" -"integer ST_LineCrossingDirection " -"geometry linestringA geometry linestringB" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1696 -#, 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 " -"LINESTRING" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1697 -#, no-c-format -msgid "Definition of integer constants is as follows:" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1700 -#, no-c-format -msgid "0: LINE NO CROSS" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1703 -#, no-c-format -msgid "-1: LINE CROSS LEFT" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1706 -#, no-c-format -msgid "1: LINE CROSS RIGHT" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1709 -#, no-c-format -msgid "-2: LINE MULTICROSS END LEFT" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1712 -#, no-c-format -msgid "2: LINE MULTICROSS END RIGHT" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1715 -#, no-c-format -msgid "-3: LINE MULTICROSS END SAME FIRST LEFT" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1718 -#, no-c-format -msgid "3: LINE MULTICROSS END SAME FIRST RIGHT" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1722 -#, no-c-format -msgid "Availability: 1.4" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1740 -#, 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:1744 -#, 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:1754 reference_measure.xml:1768 -#: reference_measure.xml:1782 -#, 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:1758 -#, 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:1772 -#, 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:1786 -#, 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:1794 -#, 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:1807 -#, no-c-format -msgid "ST_Disjoint" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:1809 -#, 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:1815 -#, no-c-format -msgid "" -"boolean ST_Disjoint " -"geometry A " -"geometry B " -msgstr "" - -#. Tag: para -#: reference_measure.xml:1830 -#, 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:1840 -#, no-c-format -msgid "This function call does not use indexes" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1847 -#, 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:1849 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.26" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:1854 -#, 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: refname -#: reference_measure.xml:1865 -#, no-c-format -msgid "ST_Distance" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:1867 -#, no-c-format -msgid "" -"For geometry type returns the 2D Cartesian distance between two geometries " -"in projected units (based on spatial reference system). For geography type " -"defaults to return minimum geodesic distance between two geographies in " -"meters." -msgstr "" - -#. Tag: funcsynopsis -#: reference_measure.xml:1872 -#, no-c-format -msgid "" -" float ST_Distance " -"geometry g1 " -"geometry g2 float ST_Distance geography gg1 geography gg2 float " -"ST_Distance geography " -"gg1 geography " -"gg2 boolean " -"use_spheroid " -msgstr "" - -#. Tag: para -#: reference_measure.xml:1910 -#, no-c-format -msgid "" -"For type returns the minimum 2D Cartesian " -"distance between two geometries in projected units (spatial ref units). For " -" type defaults to return the minimum geodesic " -"distance between two geographies in meters. If use_spheroid is false, a " -"faster sphere calculation is used instead of a spheroid." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1915 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.23" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1916 reference_measure.xml:2692 -#, no-c-format -msgid "&curve_support;" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1919 -#, 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:1920 -#, no-c-format -msgid "" -"Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1921 -#, no-c-format -msgid "Enhanced: 2.1.0 - support for curved geometries was introduced." -msgstr "" - -#. Tag: title -#: reference_measure.xml:1926 -#, no-c-format -msgid "Basic Geometry Examples" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:1928 -#, no-c-format -msgid "" -"--Geometry example - units in planar degrees 4326 is WGS 84 long lat " -"unit=degrees\n" -"SELECT ST_Distance(\n" -" 'SRID=4326;POINT(-72.1235 42.3521)'::geometry,\n" -" 'SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::" -"geometry\n" -" );\n" -"st_distance\n" -"-----------------\n" -"0.00150567726382282\n" -"\n" -"-- Geometry example - units in meters (SRID: 3857, proportional to pixels on " -"popular web maps)\n" -"-- although the value is off, nearby ones can be compared correctly,\n" -"-- which makes it a good choice for algorithms like KNN or KMeans.\n" -"SELECT ST_Distance(\n" -" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" -"geometry, 3857),\n" -" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " -"-72.123 42.1546)'::geometry, 3857)\n" -" );\n" -"st_distance\n" -"-----------------\n" -"167.441410065196\n" -"\n" -"-- Geometry example - units in meters (SRID: 3857 as above, but corrected by " -"cos(lat) to account for distortion)\n" -"SELECT ST_Distance(\n" -" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" -"geometry, 3857),\n" -" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " -"-72.123 42.1546)'::geometry, 3857)\n" -" ) * cosd(42.3521);\n" -"st_distance\n" -"-----------------\n" -"123.742351254151\n" -"\n" -"-- Geometry example - units in meters (SRID: 26986 Massachusetts state plane " -"meters) (most accurate for Massachusetts)\n" -"SELECT ST_Distance(\n" -" ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::" -"geometry, 26986),\n" -" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " -"-72.123 42.1546)'::geometry, 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('SRID=4326;POINT(-72.1235 42.3521)'::" -"geometry, 2163),\n" -" ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, " -"-72.123 42.1546)'::geometry, 2163)\n" -" );\n" -"\n" -"st_distance\n" -"------------------\n" -"126.664256056812" -msgstr "" - -#. Tag: title -#: reference_measure.xml:1931 reference_measure.xml:2781 -#: reference_measure.xml:2835 -#, no-c-format -msgid "Geography Examples" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:1932 -#, no-c-format -msgid "" -"-- same as geometry example 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" -" 'SRID=4326;POINT(-72.1235 42.3521)'::geography as gg1,\n" -" 'SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geography " -"as gg2\n" -" ) As foo ;\n" -"\n" -" spheroid_dist | sphere_dist\n" -"------------------+------------------\n" -" 123.802076746848 | 123.475736916397" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1940 -#, no-c-format -msgid "" -", , , " -", , , , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:1947 -#, no-c-format -msgid "ST_MinimumClearance" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:1948 -#, no-c-format -msgid "" -"Returns the minimum clearance of a geometry, a measure of a geometry's " -"robustness." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:1953 -#, no-c-format -msgid "" -"float ST_MinimumClearance " -"geometry g" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1963 -#, no-c-format -msgid "" -"It is not uncommon to have a geometry that, while meeting the criteria for " -"validity according to ST_IsValid (polygons) or ST_IsSimple (lines), would " -"become invalid if one of the vertices moved by a slight distance, as can " -"happen during conversion to text-based formats (such as WKT, KML, GML " -"GeoJSON), or binary formats that do not use double-precision floating point " -"coordinates (MapInfo TAB)." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1970 -#, no-c-format -msgid "" -"A geometry's \"minimum clearance\" is the smallest distance by which a " -"vertex of the geometry could be moved to produce an invalid geometry. It can " -"be thought of as a quantitative measure of a geometry's robustness, where " -"increasing values of minimum clearance indicate increasing robustness." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1976 -#, no-c-format -msgid "" -"If a geometry has a minimum clearance of e, it can be " -"said that:" -msgstr "" - -#. Tag: para -#: reference_measure.xml:1980 -#, no-c-format -msgid "" -"No two distinct vertices in the geometry are separated by less than " -"e." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1985 -#, no-c-format -msgid "" -"No vertex is closer than e to a line segement of which it " -"is not an endpoint." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1992 -#, no-c-format -msgid "" -"If no minimum clearance exists for a geometry (for example, a single point, " -"or a multipoint whose points are identical), then ST_MinimumClearance will " -"return Infinity." -msgstr "" - -#. Tag: para -#: reference_measure.xml:1997 reference_measure.xml:2042 -#, no-c-format -msgid "Availability: 2.3.0 - requires GEOS >= 3.6.0" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2003 -#, no-c-format -msgid "" -"SELECT ST_MinimumClearance('POLYGON ((0 0, 1 0, 1 1, 0.5 3.2e-4, 0 0))');\n" -" st_minimumclearance\n" -"---------------------\n" -" 0.00032" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2018 -#, no-c-format -msgid "ST_MinimumClearanceLine" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2019 -#, no-c-format -msgid "" -"Returns the two-point LineString spanning a geometry's minimum clearance." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2024 -#, no-c-format -msgid "" -"Geometry ST_MinimumClearanceLine " -"geometry g" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2037 -#, no-c-format -msgid "" -"Returns the two-point LineString spanning a geometry's minimum clearance. If " -"the geometry does not have a minimum clearance, LINESTRING EMPTY will be returned." -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2048 -#, no-c-format -msgid "" -"SELECT ST_AsText(ST_MinimumClearanceLine('POLYGON ((0 0, 1 0, 1 1, 0.5 " -"3.2e-4, 0 0))'));\n" -"st_astext\n" -"-------------------------------\n" -"LINESTRING(0.5 0.00032,0.5 0)" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2064 -#, no-c-format -msgid "ST_HausdorffDistance" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2066 -#, 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:2071 -#, no-c-format -msgid "" -" float ST_HausdorffDistance geometry g1 geometry g2 float " -"ST_HausdorffDistance geometry " -" g1 geometry g2 float " -"densifyFrac " -msgstr "" - -#. Tag: para -#: reference_measure.xml:2099 -#, 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. Wikipedia article on Hausdorff " -"distance Martin Davis note on how Hausdorff " -"Distance calculation was used to prove correctness of the " -"CascadePolygonUnion approach." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2102 -#, 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:2107 reference_measure.xml:2173 -#, 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:2112 -#, 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:2117 -#, no-c-format -msgid "Availability: 1.5.0 - requires GEOS >= 3.2.0" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2123 -#, no-c-format -msgid "" -"For each building, find the parcel that best represents it. First we require " -"the parcel intersect with the geometry. DISTINCT ON guarantees we get each " -"building listed only once, the ORDER BY .. ST_HausdorffDistance gives us a " -"preference of parcel that is most similar to the building." -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2125 -#, no-c-format -msgid "" -"SELECT DISTINCT ON(buildings.gid) buildings.gid, parcels.parcel_id\n" -" FROM buildings INNER JOIN parcels ON ST_Intersects(buildings.geom,parcels." -"geom)\n" -" ORDER BY buildings.gid, ST_HausdorffDistance(buildings.geom, parcels." -"geom);" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2127 -#, 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:2128 -#, 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:2140 -#, no-c-format -msgid "ST_FrechetDistance" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2142 -#, no-c-format -msgid "" -"Returns the Fréchet distance between two geometries. This is a measure of " -"similarity between curves that takes into account the location and ordering " -"of the points along the curves. Units are in the units of the spatial " -"reference system of the geometries." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2148 -#, no-c-format -msgid "" -"float ST_FrechetDistance " -"geometry g1 " -"geometry g2 " -"float densifyFrac = -1" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2166 -#, no-c-format -msgid "" -"Implements algorithm for computing the Fréchet distance restricted to " -"discrete points for both geometries, based on Computing Discrete " -"Fréchet Distance. The Fréchet distance is a measure of similarity " -"between curves that takes into account the location and ordering of the " -"points along the curves. Therefore it is often better than the Hausdorff " -"distance." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2168 -#, no-c-format -msgid "" -"When the optional densifyFrac is specified, this function performs a segment " -"densification before computing the discrete Fréchet 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:2178 -#, no-c-format -msgid "" -"The smaller densifyFrac we specify, the more acurate Fréchet distance we " -"get. But, the computation time and the memory usage increase with the square " -"of the number of subsegments." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2182 -#, no-c-format -msgid "Availability: 2.4.0 - requires GEOS >= 3.7.0" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2188 -#, no-c-format -msgid "" -"postgres=# SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, " -"'LINESTRING (0 0, 50 50, 100 0)'::geometry);\n" -" st_frechetdistance\n" -"--------------------\n" -" 70.7106781186548\n" -"(1 row)" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2189 -#, no-c-format -msgid "" -"SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, 'LINESTRING " -"(0 0, 50 50, 100 0)'::geometry, 0.5);\n" -" st_frechetdistance\n" -"--------------------\n" -" 50\n" -"(1 row)" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2201 -#, no-c-format -msgid "ST_MaxDistance" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2203 -#, no-c-format -msgid "" -"Returns the 2-dimensional largest distance between two geometries in " -"projected units." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2209 -#, no-c-format -msgid "" -"float ST_MaxDistance " -"geometry g1 " -"geometry g2" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2222 -#, no-c-format -msgid "" -"Returns the 2-dimensional maximum distance between two geometries 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: para -#: reference_measure.xml:2232 -#, no-c-format -msgid "Basic furthest distance the point is to any part of the line" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2233 -#, 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:2239 -#, no-c-format -msgid "" -", , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2245 -#, no-c-format -msgid "ST_DistanceSphere" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2247 -#, no-c-format -msgid "" -"Returns minimum distance in meters between two lon/lat geometries. Uses a " -"spherical earth and radius derived from the spheroid defined by the SRID. " -"Faster than ST_DistanceSpheroid , " -"but less accurate. PostGIS versions prior to 1.5 only implemented for points." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2256 -#, no-c-format -msgid "" -"float ST_DistanceSphere " -"geometry geomlonlatA geometry geomlonlatB" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2267 -#, no-c-format -msgid "" -"Returns minimum distance in meters between two lon/lat points. Uses a " -"spherical earth and radius derived from the spheroid defined by the SRID. " -"Faster than , but less accurate. " -"PostGIS Versions prior to 1.5 only implemented for points." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2273 reference_measure.xml:2322 -#, no-c-format -msgid "" -"Availability: 1.5 - support for other geometry types besides points was " -"introduced. Prior versions only work with points." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2274 -#, no-c-format -msgid "" -"Changed: 2.2.0 In prior versions this used to be called ST_Distance_Sphere" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2281 -#, no-c-format -msgid "" -"SELECT round(CAST(ST_DistanceSphere(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:2288 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2294 -#, no-c-format -msgid "ST_DistanceSpheroid" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2296 -#, 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:2303 -#, no-c-format -msgid "" -"float ST_DistanceSpheroid " -"geometry geomlonlatA geometry geomlonlatB spheroid " -"measurement_spheroid" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2315 -#, 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 . PostGIS version prior to 1.5 only support " -"points." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2319 -#, 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: para -#: reference_measure.xml:2323 -#, no-c-format -msgid "" -"Changed: 2.2.0 In prior versions this used to be called ST_Distance_Spheroid" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2330 -#, no-c-format -msgid "" -"SELECT round(CAST(\n" -" ST_DistanceSpheroid(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_DistanceSphere(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:2337 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2343 -#, no-c-format -msgid "ST_DFullyWithin" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2345 -#, 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:2351 -#, no-c-format -msgid "" -"boolean ST_DFullyWithin " -"geometry g1 " -"geometry g2 " -"double precision distance" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2369 -#, 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:2386 -#, 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:2392 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2398 -#, no-c-format -msgid "ST_DWithin" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2400 -#, 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:2406 -#, no-c-format -msgid "" -" boolean ST_DWithin " -"geometry g1 " -"geometry g2 " -"double precision distance_of_srid boolean " -"ST_DWithin geography " -"gg1 geography " -"gg2 double precision distance_meters " -" boolean ST_DWithin " -"geography gg1 " -"geography gg2 " -"double precision distance_meters boolean " -"use_spheroid " -msgstr "" - -#. Tag: para -#: reference_measure.xml:2451 -#, no-c-format -msgid "" -"Returns true if the geometries are within the specified distance of one " -"another." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2454 -#, no-c-format -msgid "" -"For geometry: 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:2459 -#, no-c-format -msgid "" -"For geography units are in meters and measurement is defaulted " -"to use_spheroid=true, for faster check, " -"use_spheroid=false to measure along sphere." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2470 -#, 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:2476 -#, no-c-format -msgid "Use ST_3DDWithin if you have 3D geometries." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2479 -#, no-c-format -msgid "Availability: 1.5.0 support for geography was introduced" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2480 -#, no-c-format -msgid "" -"Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2481 -#, no-c-format -msgid "Enhanced: 2.1.0 support for curved geometries was introduced." -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2486 -#, 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.geom, h.hospital_name\n" -" FROM schools s\n" -" LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.geom, " -"3000)\n" -" ORDER BY s.gid, ST_Distance(s.geom, h.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.geom, h.geom, 3000)\n" -" WHERE h.gid IS NULL;\n" -"\n" -"-- Find broadcasting towers that receiver with limited range can receive.\n" -"-- Data is geometry in Spherical Mercator (SRID=3857), ranges are " -"approximate.\n" -"\n" -"-- Create geometry index that will check proximity limit of user to tower\n" -"CREATE INDEX ON broadcasting_towers using gist (geom);\n" -"\n" -"-- Create geometry index that will check proximity limit of tower to user\n" -"CREATE INDEX ON broadcasting_towers using gist (ST_Expand(geom, " -"sending_range));\n" -"\n" -"-- Query towers that 4-kilometer receiver in Minsk Hackerspace can get\n" -"-- Note: two conditions, because shorter LEAST(b.sending_range, 4000) will " -"not use index.\n" -"SELECT b.tower_id, b.geom\n" -" FROM broadcasting_towers b\n" -" WHERE ST_DWithin(b.geom, 'SRID=3857;POINT(3072163.4 7159374.1)', 4000)\n" -" AND ST_DWithin(b.geom, 'SRID=3857;POINT(3072163.4 7159374.1)', b." -"sending_range);" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2492 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2498 -#, no-c-format -msgid "ST_Equals" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2500 -#, no-c-format -msgid "" -"Returns true if the given geometries represent the same geometry. " -"Directionality is ignored." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2506 -#, no-c-format -msgid "" -"boolean ST_Equals " -"geometry A " -"geometry B" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2517 -#, 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:2526 -#, no-c-format -msgid "" -"This function will return false if either geometry is invalid except in the " -"case where they are binary equal." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2530 -#, no-c-format -msgid "Do not call with a GEOMETRYCOLLECTION as an argument." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2533 -#, no-c-format -msgid "&sfs_compliant; s2.1.1.2" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2534 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.24" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2535 -#, no-c-format -msgid "" -"Changed: 2.2.0 Returns true even for invalid geometries if they are binary " -"equal" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2541 -#, 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:2547 -#, no-c-format -msgid "" -", , , " -"" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2554 -#, no-c-format -msgid "ST_GeometricMedian" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2558 -#, no-c-format -msgid "Returns the geometric median of a MultiPoint." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2565 -#, no-c-format -msgid "" -"geometry ST_GeometricMedian " -" geometry g " -" float8 tolerance int max_iter boolean " -"fail_if_not_converged " -msgstr "" - -#. Tag: para -#: reference_measure.xml:2615 -#, no-c-format -msgid "" -"Computes the approximate geometric median of a MultiPoint geometry using the " -"Weiszfeld algorithm. The geometric median provides a centrality measure that " -"is less sensitive to outlier points than the centroid." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2621 -#, no-c-format -msgid "" -"The algorithm will iterate until the distance change between successive " -"iterations is less than the supplied tolerance parameter. " -"If this condition has not been met after max_iterations " -"iterations, the function will produce an error and exit, unless " -"fail_if_not_converged is set to false." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2628 -#, no-c-format -msgid "" -"If a tolerance value is not provided, a default tolerance " -"value will be calculated based on the extent of the input geometry." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2632 -#, no-c-format -msgid "M value of points, if present, is interpreted as their relative weight." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2635 -#, no-c-format -msgid "Availability: 2.3.0" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2636 -#, no-c-format -msgid "Enhanced: 2.5.0 Added support for M as weight of points." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2638 -#, no-c-format -msgid "&M_support;" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2650 -#, no-c-format -msgid "" -"Comparison of the centroid (turquoise point) and geometric median (red " -"point) of a four-point MultiPoint (yellow points)." -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2658 -#, no-c-format -msgid "" -"WITH test AS (\n" -"SELECT 'MULTIPOINT((0 0), (1 1), (2 2), (200 200))'::geometry geom)\n" -"SELECT\n" -" ST_AsText(ST_Centroid(geom)) centroid,\n" -" ST_AsText(ST_GeometricMedian(geom)) median\n" -"FROM test;\n" -" centroid | median\n" -"--------------------+----------------------------------------\n" -" POINT(50.75 50.75) | POINT(1.9761550281255 1.9761550281255)\n" -"(1 row)" -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2671 -#, no-c-format -msgid "ST_HasArc" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2673 -#, no-c-format -msgid "" -"Returns true if a geometry or geometry collection contains a " -"circular string" -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2678 -#, no-c-format -msgid "" -"boolean ST_HasArc " -"geometry geomA" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2688 -#, no-c-format -msgid "" -"Returns true if a geometry or geometry collection contains a circular " -"string" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2690 -#, no-c-format -msgid "Availability: 1.2.3?" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2699 -#, 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:2706 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2712 -#, no-c-format -msgid "ST_Intersects" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2714 -#, 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:2720 -#, no-c-format -msgid "" -" boolean ST_Intersects geometry geomA geometry geomB boolean " -"ST_Intersects geography geogA geography geogB " -msgstr "" - -#. Tag: para -#: reference_measure.xml:2747 -#, no-c-format -msgid "" -"If a geometry or geography shares any portion of space then they intersect. " -"For geography -- tolerance is 0.00001 meters (so any points that are close " -"are considered to intersect)" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2753 -#, no-c-format -msgid "Enhanced: 2.5.0 Supports GEOMETRYCOLLECTION." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2755 -#, no-c-format -msgid "Performed by the GEOS module (for geometry), geography is native" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2756 -#, no-c-format -msgid "Availability: 1.5 support for geography was introduced." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2763 -#, 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:2770 -#, 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:2773 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.27" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2778 -#, 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: programlisting -#: reference_measure.xml:2782 -#, 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:2786 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2791 -#, no-c-format -msgid "ST_Length" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2793 -#, 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:2796 -#, no-c-format -msgid "" -" float ST_Length " -"geometry a_2dlinestring float " -"ST_Length geography geog boolean use_spheroid=true " -"" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2811 -#, no-c-format -msgid "" -"For geometry: Returns the 2D Cartesian length of the geometry if it is a " -"LineString, MultiLineString, ST_Curve, ST_MultiCurve. 0 is returned for " -"areal geometries. For areal geometries use . " -"For geometry types, units for length measures are specified by the spatial " -"reference system of the geometry." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2814 -#, no-c-format -msgid "" -"For geography types, the calculations are performed using the inverse " -"geodesic problem, where length units are in meters. If PostGIS is compiled " -"with PROJ version 4.8.0 or later, the spheroid is specified by the SRID, " -"otherwise it is exclusive to WGS84. If use_spheroid=false, then calculations will approximate a sphere instead of a spheroid." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2818 -#, 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:2819 -#, 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:2821 -#, 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:2822 reference_measure.xml:3279 -#, no-c-format -msgid "&sfs_compliant; s2.1.5.1" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2823 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 7.1.2, 9.3.4" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2824 -#, no-c-format -msgid "Availability: 1.5.0 geography support was introduced in 1.5." -msgstr "" - -#. Tag: para -#: reference_measure.xml:2830 -#, no-c-format -msgid "" -"Return length in feet for line string. Note this is in feet because " -"EPSG:2249 is Massachusetts State Plane Feet" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2832 -#, 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:2836 -#, no-c-format -msgid "Return length of WGS 84 geography line" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2837 -#, 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.5703627288 | 34346.2060960742" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2841 -#, no-c-format -msgid "" -", , , , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2847 -#, no-c-format -msgid "ST_Length2D" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2849 -#, no-c-format -msgid "" -"Returns the 2-dimensional length of the geometry if it is a " -"linestring or multi-linestring. This is an alias for ST_Length" -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2855 -#, no-c-format -msgid "" -"float ST_Length2D " -"geometry a_2dlinestring" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2865 -#, no-c-format -msgid "" -"Returns the 2-dimensional length of the geometry if it is a linestring " -"or multi-linestring. This is an alias for ST_Length" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2874 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2880 -#, no-c-format -msgid "ST_3DLength" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2882 -#, 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:2888 -#, no-c-format -msgid "" -"float ST_3DLength " -"geometry a_3dlinestring" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2898 -#, 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:2901 -#, no-c-format -msgid "Changed: 2.0.0 In prior versions this used to be called ST_Length3D" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2908 -#, no-c-format -msgid "" -"Return length in feet for a 3D cable. Note this is in feet because EPSG:2249 " -"is Massachusetts State Plane Feet" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2910 -#, 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:2917 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2923 -#, no-c-format -msgid "ST_LengthSpheroid" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2925 -#, no-c-format -msgid "" -"Calculates the 2D or 3D length/perimeter 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." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2932 -#, no-c-format -msgid "" -"float ST_LengthSpheroid " -"geometry a_geometry spheroid a_spheroid" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2943 -#, no-c-format -msgid "" -"Calculates the length/perimeter 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:2949 reference_measure.xml:3000 -#, no-c-format -msgid "" -"SPHEROID[<NAME>,<SEMI-MAJOR AXIS>,<INVERSE FLATTENING>]" -msgstr "" - -#. Tag: literallayout -#: reference_measure.xml:2951 reference_measure.xml:3002 -#, no-c-format -msgid "SPHEROID[\"GRS_1980\",6378137,298.257222101]" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2953 -#, no-c-format -msgid "Availability: 1.2.2" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2954 -#, no-c-format -msgid "" -"Changed: 2.2.0 In prior versions this used to be called ST_Length_Spheroid " -"and used to have a ST_3DLength_Spheroid alias" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:2961 -#, no-c-format -msgid "" -"SELECT ST_LengthSpheroid( geometry_column,\n" -" 'SPHEROID[\"GRS_1980\",6378137,298.257222101]' )\n" -" FROM geometry_table;\n" -"\n" -"SELECT ST_LengthSpheroid( the_geom, sph_m ) As tot_len,\n" -"ST_LengthSpheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" -"ST_LengthSpheroid(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_LengthSpheroid( the_geom, sph_m ) As tot_len,\n" -"ST_LengthSpheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" -"ST_LengthSpheroid(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:2968 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:2974 -#, no-c-format -msgid "ST_Length2D_Spheroid" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:2976 -#, no-c-format -msgid "" -"Calculates the 2D length/perimeter 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." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:2983 -#, no-c-format -msgid "" -"float ST_Length2D_Spheroid " -"geometry a_geometry spheroid a_spheroid" -msgstr "" - -#. Tag: para -#: reference_measure.xml:2994 -#, no-c-format -msgid "" -"Calculates the 2D length/perimeter 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:3003 -#, no-c-format -msgid "" -"This is much like except it will " -"ignore the Z ordinate in calculations." -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:3010 -#, 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:3017 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:3023 -#, no-c-format -msgid "ST_LongestLine" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3025 -#, 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:3033 -#, no-c-format -msgid "" -"geometry ST_LongestLine " -"geometry g1 " -"geometry g2" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3048 -#, no-c-format -msgid "" -"Returns the 2-dimensional longest line between the points of two geometries." -msgstr "" - -#. Tag: para -#: reference_measure.xml:3066 -#, no-c-format -msgid "Longest line between point and line" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:3069 -#, 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:3077 -#, no-c-format -msgid "longest line between polygon and polygon" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:3080 -#, 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:3096 -#, 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:3100 -#, 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:3111 -#, no-c-format -msgid "" -", , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:3117 -#, no-c-format -msgid "ST_OrderingEquals" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3119 -#, 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:3125 -#, no-c-format -msgid "" -"boolean ST_OrderingEquals " -"geometry A " -"geometry B" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3136 -#, 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:3141 -#, 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:3145 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.43" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:3151 -#, 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:3155 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:3161 -#, no-c-format -msgid "ST_Overlaps" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3163 -#, 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:3168 -#, no-c-format -msgid "" -"boolean ST_Overlaps " -"geometry A " -"geometry B" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3179 -#, 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:3184 reference_measure.xml:3513 -#: reference_measure.xml:3527 -#, no-c-format -msgid "Do not call with a GeometryCollection as an argument" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3186 -#, 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:3194 reference_measure.xml:3533 -#: reference_measure.xml:3738 -#, no-c-format -msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3195 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.32" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3211 -#, no-c-format -msgid "MULTIPOINT / MULTIPOINT" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:3235 -#, 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:3243 -#, no-c-format -msgid "" -", , , " +"SELECT ST_AsText(ST_MinimumClearanceLine('POLYGON ((0 0, 1 0, 1 1, 0.5 " +"3.2e-4, 0 0))'));\n" +"st_astext\n" +"-------------------------------\n" +"LINESTRING(0.5 0.00032,0.5 0)" msgstr "" #. Tag: refname -#: reference_measure.xml:3248 +#: reference_measure.xml:1275 #, no-c-format msgid "ST_Perimeter" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:3250 +#: reference_measure.xml:1277 #, 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." +"Returns the length of the boundary of a polygonal geometry or geography." msgstr "" #. Tag: funcsynopsis -#: reference_measure.xml:3254 +#: reference_measure.xml:1280 #, no-c-format msgid "" " float ST_Perimeter " @@ -5089,7 +2353,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3270 +#: reference_measure.xml:1296 #, no-c-format msgid "" "Returns the 2D perimeter of the geometry/geography if it is a ST_Surface, " @@ -5100,7 +2364,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3273 +#: reference_measure.xml:1299 #, no-c-format msgid "" "For geography types, the calculations are performed using the inverse " @@ -5111,7 +2375,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3277 +#: reference_measure.xml:1303 #, no-c-format msgid "" "Currently this is an alias for ST_Perimeter2D, but this may change to " @@ -5119,25 +2383,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3280 +#: reference_measure.xml:1306 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 8.1.3, 9.5.4" msgstr "" #. Tag: para -#: reference_measure.xml:3281 +#: reference_measure.xml:1307 #, no-c-format msgid "Availability 2.0.0: Support for geography was introduced" msgstr "" #. Tag: title -#: reference_measure.xml:3285 +#: reference_measure.xml:1311 #, no-c-format msgid "Examples: Geometry" msgstr "" #. Tag: para -#: reference_measure.xml:3286 +#: reference_measure.xml:1312 #, no-c-format msgid "" "Return perimeter in feet for Polygon and MultiPolygon. Note this is in feet " @@ -5145,7 +2409,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3288 +#: reference_measure.xml:1314 #, no-c-format msgid "" "SELECT ST_Perimeter(ST_GeomFromText('POLYGON((743238 2967416,743238 " @@ -5162,582 +2426,274 @@ msgid "" "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:3291 -#, no-c-format -msgid "Examples: Geography" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3292 -#, 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:3293 -#, 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:3297 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:3303 -#, no-c-format -msgid "ST_Perimeter2D" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3305 -#, 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:3311 -#, no-c-format -msgid "" -"float ST_Perimeter2D " -"geometry geomA" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3321 -#, 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:3326 -#, 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:3340 -#, no-c-format -msgid "ST_3DPerimeter" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3342 -#, 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:3348 -#, no-c-format -msgid "" -"float ST_3DPerimeter " -"geometry geomA" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3358 -#, 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:3361 -#, no-c-format -msgid "Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3367 -#, no-c-format -msgid "" -"Perimeter of a slightly elevated polygon in the air in Massachusetts state " -"plane feet" -msgstr "" - -#. Tag: programlisting -#: reference_measure.xml:3368 -#, 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:3375 -#, no-c-format -msgid ", , " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:3381 -#, no-c-format -msgid "ST_PointOnSurface" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3383 -#, no-c-format -msgid "Returns a POINT guaranteed to lie on the surface." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:3388 -#, no-c-format -msgid "" -"geometry ST_PointOnSurface " -"geometry g1" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3400 -#, no-c-format -msgid "Returns a POINT guaranteed to intersect a surface." -msgstr "" - -#. Tag: para -#: reference_measure.xml:3402 -#, no-c-format -msgid "&sfs_compliant; s3.2.14.2 // s3.2.18.2" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3403 -#, 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:3412 -#, 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:3418 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_measure.xml:3424 -#, no-c-format -msgid "ST_Project" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3426 -#, no-c-format -msgid "" -"Returns a POINT projected from a start point using a " -"distance in meters and bearing (azimuth) in radians." -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:3431 -#, no-c-format -msgid "" -"geography ST_Project " -"geography g1 " -"float distance " -"float azimuth" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3447 -#, no-c-format -msgid "" -"Returns a POINT projected along a geodesic from a start " -"point using an azimuth (bearing) measured in radians and distance measured " -"in meters. This is also called a direct geodesic problem." -msgstr "" - -#. Tag: para -#: reference_measure.xml:3448 -#, 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 " -"(π/2), south is azimuth 180 (π), west is azimuth 270 " -"(3π/2)." +"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: para -#: reference_measure.xml:3449 +#. Tag: title +#: reference_measure.xml:1317 #, no-c-format -msgid "The distance is given in meters." +msgid "Examples: Geography" msgstr "" #. Tag: para -#: reference_measure.xml:3452 -#, no-c-format -msgid "Enhanced: 2.4.0 Allow negative distance and non-normalized azimuth." -msgstr "" - -#. Tag: title -#: reference_measure.xml:3457 +#: reference_measure.xml:1318 #, no-c-format msgid "" -"Example: Using degrees - projected point 100,000 meters and bearing 45 " -"degrees" +"Return perimeter in meters and feet for Polygon and MultiPolygon. Note this " +"is geography (WGS 84 long lat)" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3459 +#: reference_measure.xml:1319 #, no-c-format msgid "" -"SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, " -"radians(45.0)));\n" +"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" -" st_astext\n" -"--------------------------------------------\n" -" POINT(0.635231029125537 0.639472334729198)\n" -"(1 row)" +" 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:3465 +#: reference_measure.xml:1323 #, no-c-format -msgid "" -", , PostgreSQL Math Functions" +msgid ", , " msgstr "" #. Tag: refname -#: reference_measure.xml:3471 +#: reference_measure.xml:1329 #, no-c-format -msgid "ST_Relate" +msgid "ST_Perimeter2D" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:3473 +#: reference_measure.xml:1331 #, 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." +"Returns the 2D perimeter of a polygonal geometry. Alias for " +"ST_Perimeter." msgstr "" -#. Tag: funcsynopsis -#: reference_measure.xml:3481 +#. Tag: funcprototype +#: reference_measure.xml:1337 #, no-c-format msgid "" -" boolean ST_Relate " -"geometry geomA " -"geometry geomB " -"text intersectionMatrixPattern text " -"ST_Relate geometry " -"geomA geometry " -"geomB " -"text ST_Relate " -"geometry geomA " -"geometry geomB " -"integer BoundaryNodeRule " +"float ST_Perimeter2D " +"geometry geomA" msgstr "" #. Tag: para -#: reference_measure.xml:3507 +#: reference_measure.xml:1347 #, 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 DE-9IM matrix pattern." +msgid "Returns the 2-dimensional perimeter of a polygonal geometry." msgstr "" #. Tag: para -#: reference_measure.xml:3512 +#: reference_measure.xml:1351 #, no-c-format msgid "" -"This is especially useful for testing compound checks of intersection, " -"crosses, etc in one step." +"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: para -#: reference_measure.xml:3515 +#. Tag: refname +#: reference_measure.xml:1365 #, no-c-format -msgid "" -"This is the \"allowable\" version that returns a boolean, not an integer. " -"This is defined in OGC spec" +msgid "ST_3DPerimeter" msgstr "" -#. Tag: para -#: reference_measure.xml:3518 +#. Tag: refpurpose +#: reference_measure.xml:1367 #, 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." +msgid "Returns the 3D perimeter of a polygonal geometry." msgstr "" -#. Tag: para -#: reference_measure.xml:3523 +#. Tag: funcprototype +#: reference_measure.xml:1372 #, no-c-format msgid "" -"Version 2: Takes geomA and geomB and returns the " +"float ST_3DPerimeter " +"geometry geomA" msgstr "" #. Tag: para -#: reference_measure.xml:3525 +#: reference_measure.xml:1382 #, no-c-format msgid "" -"Version 3: same as version 2, but allows to specify a boundary node rule (1:" -"OGC/MOD2, 2:Endpoint, 3:MultivalentEndpoint, 4:MonovalentEndpoint)" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3529 -#, no-c-format -msgid "not in OGC spec, but implied. see s2.1.13.2" +"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:3534 +#: reference_measure.xml:1385 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" +msgid "Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D" msgstr "" #. Tag: para -#: reference_measure.xml:3535 +#: reference_measure.xml:1391 #, no-c-format msgid "" -"Enhanced: 2.0.0 - added support for specifying boundary node rule (requires " -"GEOS >= 3.0)." +"Perimeter of a slightly elevated polygon in the air in Massachusetts state " +"plane feet" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3542 +#: reference_measure.xml:1392 #, 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" +"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" -"SELECT ST_Relate(ST_GeometryFromText('POINT(1 2)'), " -"ST_Buffer(ST_GeometryFromText('POINT(1 2)'),2), '*FF*FF212');\n" -"st_relate\n" -"-----------\n" -"t" +" ST_3DPerimeter | st_perimeter2d | st_perimeter\n" +"------------------+------------------+------------------\n" +" 105.465793597674 | 105.432997272188 | 105.432997272188" msgstr "" #. Tag: para -#: reference_measure.xml:3549 +#: reference_measure.xml:1399 #, no-c-format -msgid "" -", , , , " +msgid ", , " msgstr "" #. Tag: refname -#: reference_measure.xml:3555 +#: reference_measure.xml:1405 #, no-c-format -msgid "ST_RelateMatch" +msgid "ST_Project" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:3557 +#: reference_measure.xml:1407 #, no-c-format msgid "" -"Returns true if intersectionMattrixPattern1 implies " -"intersectionMatrixPattern2" +"Returns a point projected from a start point by a distance and bearing " +"(azimuth)." msgstr "" #. Tag: funcprototype -#: reference_measure.xml:3562 +#: reference_measure.xml:1412 #, no-c-format msgid "" -"boolean ST_RelateMatch " -"text intersectionMatrix text intersectionMatrixPattern" +"geography ST_Project " +"geography g1 " +"float distance " +"float azimuth" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1428 +#, no-c-format +msgid "" +"Returns a point projected from a start point along a geodesic using a given " +"distance and azimuth (bearing). This is known as the direct geodesic problem." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1431 +#, no-c-format +msgid "The distance is given in meters. Negative values are supported." msgstr "" #. Tag: para -#: reference_measure.xml:3573 +#: reference_measure.xml:1432 #, no-c-format msgid "" -"Takes intersectionMatrix and intersectionMatrixPattern and Returns true if " -"the intersectionMatrix satisfies the intersectionMatrixPattern. For more " -"information refer to ." +"The azimuth (also known as heading or bearing) is given in radians. It is " +"measured clockwise from true north (azimuth zero). East is azimuth " +"π/2 (90 degrees); south is azimuth π (180 degrees); west is " +"azimuth 3π/2 (270 degrees). Negative azimuth values and values " +"greater than 2π (360 degrees) are supported." msgstr "" #. Tag: para -#: reference_measure.xml:3576 +#: reference_measure.xml:1442 +#, no-c-format +msgid "Enhanced: 2.4.0 Allow negative distance and non-normalized azimuth." +msgstr "" + +#. Tag: title +#: reference_measure.xml:1447 #, no-c-format -msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." +msgid "Example: Projected point at 100,000 meters and bearing 45 degrees" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3582 +#: reference_measure.xml:1449 #, 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);" +"SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, " +"radians(45.0)));\n" +"\n" +" st_astext\n" +"--------------------------------------------\n" +" POINT(0.635231029125537 0.639472334729198)\n" +"(1 row)" msgstr "" #. Tag: para -#: reference_measure.xml:3588 +#: reference_measure.xml:1455 #, no-c-format -msgid ", " +msgid "" +", , PostgreSQL function " +"radians()" msgstr "" #. Tag: refname -#: reference_measure.xml:3594 +#: reference_measure.xml:1462 #, no-c-format msgid "ST_ShortestLine" msgstr "" #. Tag: refpurpose -#: reference_measure.xml:3596 +#: reference_measure.xml:1464 #, no-c-format -msgid "Returns the 2-dimensional shortest line between two geometries" +msgid "Returns the 2D shortest line between two geometries" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:3601 +#: reference_measure.xml:1469 #, no-c-format msgid "" "geometry ST_ShortestLine " @@ -5746,7 +2702,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3616 +#: reference_measure.xml:1484 #, no-c-format msgid "" "Returns the 2-dimensional shortest line between two geometries. The function " @@ -5761,13 +2717,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3640 +#: reference_measure.xml:1508 #, no-c-format msgid "Shortest line between point and linestring" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3643 +#: reference_measure.xml:1511 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -5782,13 +2738,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3651 +#: reference_measure.xml:1519 #, no-c-format msgid "shortest line between polygon and polygon" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3654 +#: reference_measure.xml:1522 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -5804,7 +2760,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_measure.xml:3666 +#: reference_measure.xml:1534 #, no-c-format msgid "" ", , , TRUE if the geometries have at least one point in " -"common, but their interiors do not intersect." +msgid "Returns the 3D shortest line between two geometries" msgstr "" #. Tag: funcprototype -#: reference_measure.xml:3680 +#: reference_measure.xml:1546 #, no-c-format msgid "" -"boolean ST_Touches " +"geometry ST_3DShortestLine " "geometry g1 " "geometry g2" msgstr "" #. Tag: para -#: reference_measure.xml:3695 -#, no-c-format -msgid "" -"Returns TRUE if the only points in common between " -"g1 and g2 lie in the union of " -"the boundaries of g1 and g2. " -"The ST_Touches relation applies to all Area/Area, Line/" -"Line, Line/Area, Point/Area and Point/Line pairs of relationships, but " -"not to the Point/Point pair." -msgstr "" - -#. Tag: para -#: reference_measure.xml:3702 -#, no-c-format -msgid "In mathematical terms, this predicate is expressed as:" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3712 -#, no-c-format -msgid "The allowable DE-9IM Intersection Matrices for the two geometries are:" -msgstr "" - -#. Tag: markup -#: reference_measure.xml:3716 -#, no-c-format -msgid "FT*******" -msgstr "" - -#. Tag: markup -#: reference_measure.xml:3720 -#, no-c-format -msgid "F**T*****" -msgstr "" - -#. Tag: markup -#: reference_measure.xml:3724 -#, no-c-format -msgid "F***T****" -msgstr "" - -#. Tag: para -#: reference_measure.xml:3733 +#: reference_measure.xml:1561 #, 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 _ST_Touches instead." -msgstr "" - -#. Tag: para -#: reference_measure.xml:3739 -#, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.28" +"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 returns for g1 and g2." msgstr "" #. Tag: para -#: reference_measure.xml:3745 +#: reference_measure.xml:1584 #, no-c-format -msgid "" -"The ST_Touches predicate returns TRUE in all the following illustrations." +msgid "linestring and point -- both 3d and 2d shortest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3815 +#: reference_measure.xml:1585 #, 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" +"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" -"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:3821 -#, no-c-format -msgid "ST_Within" -msgstr "" - -#. Tag: refpurpose -#: reference_measure.xml:3823 -#, no-c-format -msgid "Returns true if the geometry A is completely inside geometry B" -msgstr "" - -#. Tag: funcprototype -#: reference_measure.xml:3828 -#, no-c-format -msgid "" -"boolean ST_Within " -"geometry A " -"geometry B" +"\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:3843 +#: reference_measure.xml:1589 #, 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." +msgid "linestring and multipoint -- both 3d and 2d shortest line" msgstr "" -#. Tag: para -#: reference_measure.xml:3860 +#. Tag: programlisting +#: reference_measure.xml:1590 #, 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:3868 -#, no-c-format -msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3 - a.Relate(b, 'T*F**F***')" +"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:3871 +#: reference_measure.xml:1594 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.30" +msgid "Multilinestring and polygon both 3d and 2d shortest line" msgstr "" #. Tag: programlisting -#: reference_measure.xml:3876 +#: reference_measure.xml:1595 #, 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)" +"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:3887 +#: reference_measure.xml:1607 #, no-c-format -msgid ", , " +msgid "" +", , , " +", " msgstr "" diff --git a/doc/po/templates/reference_misc.xml.pot b/doc/po/templates/reference_misc.xml.pot index 9e61403cf..7aeb75748 100644 --- a/doc/po/templates/reference_misc.xml.pot +++ b/doc/po/templates/reference_misc.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -19,896 +19,3 @@ msgstr "" #, 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 "Aggregate. Constructs an array of geometries." -msgstr "" - -#. Tag: funcprototype -#: reference_misc.xml:14 -#, no-c-format -msgid "" -"geometry[] ST_Accum " -"geometry set geomfield" -msgstr "" - -#. Tag: title -#: reference_misc.xml:22 reference_misc.xml:64 reference_misc.xml:106 -#: reference_misc.xml:167 reference_misc.xml:267 reference_misc.xml:327 -#: reference_misc.xml:381 reference_misc.xml:434 reference_misc.xml:476 -#: reference_misc.xml:528 -#, no-c-format -msgid "Description" -msgstr "" - -#. Tag: para -#: reference_misc.xml:24 -#, no-c-format -msgid "Aggregate. Constructs an array of geometries." -msgstr "" - -#. Tag: para -#: reference_misc.xml:25 reference_misc.xml:68 reference_misc.xml:109 -#: reference_misc.xml:290 reference_misc.xml:347 reference_misc.xml:393 -#, 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:395 -#: reference_misc.xml:486 -#, no-c-format -msgid "&Z_support;" -msgstr "" - -#. Tag: para -#: reference_misc.xml:27 reference_misc.xml:69 reference_misc.xml:110 -#: reference_misc.xml:197 reference_misc.xml:396 reference_misc.xml:487 -#, no-c-format -msgid "&curve_support;" -msgstr "" - -#. Tag: para -#: reference_misc.xml:28 reference_misc.xml:70 reference_misc.xml:111 -#: reference_misc.xml:294 reference_misc.xml:348 reference_misc.xml:397 -#: reference_misc.xml:488 -#, no-c-format -msgid "&P_support;" -msgstr "" - -#. Tag: para -#: reference_misc.xml:29 reference_misc.xml:71 reference_misc.xml:112 -#: reference_misc.xml:295 reference_misc.xml:349 reference_misc.xml:398 -#: reference_misc.xml:489 -#, no-c-format -msgid "&T_support;" -msgstr "" - -#. Tag: title -#: reference_misc.xml:34 reference_misc.xml:76 reference_misc.xml:118 -#: reference_misc.xml:202 reference_misc.xml:300 reference_misc.xml:354 -#: reference_misc.xml:402 reference_misc.xml:446 reference_misc.xml:495 -#: reference_misc.xml:542 -#, 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:209 reference_misc.xml:306 reference_misc.xml:360 -#: reference_misc.xml:407 reference_misc.xml:453 reference_misc.xml:502 -#: reference_misc.xml:549 -#, 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 "" -"Returns a BOX2D representing the maximum extents of the geometry." -"" -msgstr "" - -#. Tag: funcprototype -#: reference_misc.xml:56 -#, no-c-format -msgid "" -"box2d Box2D geometry " -" geomA" -msgstr "" - -#. Tag: para -#: reference_misc.xml:66 -#, no-c-format -msgid "" -"Returns a BOX2D representing the maximum extents of the geometry." -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 ", " -msgstr "" - -#. Tag: refname -#: reference_misc.xml:91 -#, no-c-format -msgid "Box3D" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:93 -#, no-c-format -msgid "" -"Returns a BOX3D representing the maximum extents of the geometry." -"" -msgstr "" - -#. Tag: funcprototype -#: reference_misc.xml:98 -#, no-c-format -msgid "" -"box3d Box3D geometry " -" geomA" -msgstr "" - -#. Tag: para -#: reference_misc.xml:108 -#, no-c-format -msgid "" -"Returns a BOX3D representing the maximum extents of the geometry." -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 ", " -msgstr "" - -#. Tag: refname -#: reference_misc.xml:133 -#, no-c-format -msgid "ST_EstimatedExtent" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:135 -#, no-c-format -msgid "" -"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." -msgstr "" - -#. Tag: funcsynopsis -#: reference_misc.xml:141 -#, no-c-format -msgid "" -" box2d ST_EstimatedExtent text schema_name text table_name text geocolumn_name boolean parent_ony box2d " -"ST_EstimatedExtent text schema_name text table_name text geocolumn_name " -" box2d ST_EstimatedExtent text table_name text geocolumn_name " -msgstr "" - -#. Tag: para -#: reference_misc.xml:169 -#, no-c-format -msgid "" -"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. The default behavior is to also use statistics collected " -"from children tables (tables with INHERITS) if available. If 'parent_ony' is " -"set to TRUE, only statistics for the given table are used and children " -"tables are ignored." -msgstr "" - -#. Tag: para -#: reference_misc.xml:178 -#, 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:183 -#, 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:191 -#, 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:194 -#, no-c-format -msgid "Availability: 1.0.0" -msgstr "" - -#. Tag: para -#: reference_misc.xml:195 -#, 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:204 -#, 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:216 -#, no-c-format -msgid "ST_Expand" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:217 -#, 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:221 -#, no-c-format -msgid "" -" geometry ST_Expand " -"geometry geom " -"float units_to_expand geometry " -"ST_Expand geometry " -"geom float " -"dx float " -"dy float dz=0 float dm=0 box2d ST_Expand box2d box float " -"units_to_expand " -" box2d ST_Expand " -"box2d box " -"float dx " -"float dy box3d ST_Expand box3d box float " -"units_to_expand " -" box3d ST_Expand " -"box3d box " -"float dx " -"float dy float dz=0 " -msgstr "" - -#. Tag: para -#: reference_misc.xml:269 -#, no-c-format -msgid "" -"This function returns a bounding box expanded from the bounding box of the " -"input, either by specifying a single distance with which the box should be " -"expanded in all directions, or by specifying an expansion distance for each " -"direction. Uses double-precision. Can be very useful for distance queries, " -"or to add a bounding box filter to a query to take advantage of a spatial " -"index." -msgstr "" - -#. Tag: para -#: reference_misc.xml:275 -#, no-c-format -msgid "" -"In addition to the geometry version of ST_Expand, which is the most commonly " -"used, variants are provided that accept and produce internal BOX2D and BOX3D " -"data types." -msgstr "" - -#. Tag: para -#: reference_misc.xml:278 -#, 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:280 -#, 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:283 -#, no-c-format -msgid "" -"Pre 1.3, ST_Expand was used in conjunction with distance to do indexable " -"queries. Something of the form the_geom && ST_Expand('POINT(10 " -"20)', 10) AND ST_Distance(the_geom, 'POINT(10 20)') < 10 Post 1.2, " -"this was replaced with the easier ST_DWithin construct." -msgstr "" - -#. Tag: para -#: reference_misc.xml:289 -#, no-c-format -msgid "" -"Availability: 1.5.0 behavior changed to output double precision instead of " -"float4 coordinates." -msgstr "" - -#. Tag: para -#: reference_misc.xml:291 -#, no-c-format -msgid "" -"Enhanced: 2.3.0 support was added to expand a box by different amounts in " -"different dimensions." -msgstr "" - -#. Tag: para -#: reference_misc.xml:301 -#, 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:302 -#, no-c-format -msgid "" -"\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:307 -#, no-c-format -msgid "" -", , , , , " -msgstr "" - -#. Tag: refname -#: reference_misc.xml:313 -#, no-c-format -msgid "ST_Extent" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:314 -#, no-c-format -msgid "" -"an aggregate function that returns the bounding box that bounds rows of " -"geometries." -msgstr "" - -#. Tag: funcprototype -#: reference_misc.xml:319 -#, no-c-format -msgid "" -"box2d ST_Extent " -"geometry set geomfield" -msgstr "" - -#. Tag: para -#: reference_misc.xml:329 -#, 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:332 reference_misc.xml:386 -#, 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:333 -#, no-c-format -msgid "" -"ST_Extent is similar in concept to Oracle Spatial/Locator's SDO_AGGR_MBR" -msgstr "" - -#. Tag: para -#: reference_misc.xml:335 -#, 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:340 -#, 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:344 -#, no-c-format -msgid "Availability: 1.4.0" -msgstr "" - -#. Tag: para -#: reference_misc.xml:355 -#, no-c-format -msgid "Examples below use Massachusetts State Plane ft (SRID=2249)" -msgstr "" - -#. Tag: programlisting -#: reference_misc.xml:356 -#, 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:361 -#, no-c-format -msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_misc.xml:367 -#, no-c-format -msgid "ST_3DExtent" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:368 -#, no-c-format -msgid "" -"an aggregate function that returns the box3D bounding box that bounds rows " -"of geometries." -msgstr "" - -#. Tag: funcprototype -#: reference_misc.xml:373 -#, no-c-format -msgid "" -"box3d ST_3DExtent " -"geometry set geomfield" -msgstr "" - -#. Tag: para -#: reference_misc.xml:383 -#, 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:389 -#, 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:394 -#, no-c-format -msgid "Changed: 2.0.0 In prior versions this used to be called ST_Extent3D" -msgstr "" - -#. Tag: programlisting -#: reference_misc.xml:403 -#, 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:408 -#, no-c-format -msgid ", " -msgstr "" - -#. Tag: refname -#: reference_misc.xml:415 -#, no-c-format -msgid "Find_SRID" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:417 -#, no-c-format -msgid "" -"The syntax is find_srid(a_db_schema, a_table, a_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:424 -#, no-c-format -msgid "" -"integer Find_SRID " -"varchar a_schema_name varchar a_table_name varchar " -"a_geomfield_name" -msgstr "" - -#. Tag: para -#: reference_misc.xml:436 -#, 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:448 -#, 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:461 -#, no-c-format -msgid "ST_MemSize" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:463 -#, no-c-format -msgid "" -"Returns the amount of space (in bytes) the geometry takes." -msgstr "" - -#. Tag: funcprototype -#: reference_misc.xml:468 -#, no-c-format -msgid "" -"integer ST_MemSize " -"geometry geomA" -msgstr "" - -#. Tag: para -#: reference_misc.xml:478 -#, no-c-format -msgid "Returns the amount of space (in bytes) the geometry takes." -msgstr "" - -#. Tag: para -#: reference_misc.xml:479 -#, no-c-format -msgid "" -"This is a nice compliment to PostgreSQL built in functions pg_column_size, " -"pg_size_pretty, pg_relation_size, pg_total_relation_size." -msgstr "" - -#. Tag: para -#: reference_misc.xml:480 -#, no-c-format -msgid "" -"pg_relation_size which gives the byte size of a table may return byte size " -"lower than ST_MemSize. 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:482 -#, no-c-format -msgid "" -"pg_total_relation_size - includes, the table, the toasted tables, and the " -"indexes." -msgstr "" - -#. Tag: para -#: reference_misc.xml:483 -#, no-c-format -msgid "" -"pg_column_size returns how much space a geometry would take in a column " -"considering compression, so may be lower than ST_MemSize" -msgstr "" - -#. Tag: para -#: reference_misc.xml:490 -#, no-c-format -msgid "" -"Changed: 2.2.0 name changed to ST_MemSize to follow naming convention. In " -"prior versions this function was called ST_Mem_Size, old name deprecated " -"though still available." -msgstr "" - -#. Tag: programlisting -#: reference_misc.xml:497 -#, no-c-format -msgid "" -"--Return how much byte space Boston takes up in our Mass data set\n" -"SELECT pg_size_pretty(SUM(ST_MemSize(the_geom))) as totgeomsum,\n" -"pg_size_pretty(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(the_geom) ELSE " -"0 END)) As bossum,\n" -"CAST(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(the_geom) ELSE 0 " -"END)*1.00 /\n" -" SUM(ST_MemSize(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_MemSize(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_MemSize(the_geom)) As geomsize,\n" -"sum(ST_MemSize(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:510 -#, no-c-format -msgid "ST_PointInsideCircle" -msgstr "" - -#. Tag: refpurpose -#: reference_misc.xml:512 -#, no-c-format -msgid "" -"Is the point geometry inside the circle defined by center_x, center_y, radius" -msgstr "" - -#. Tag: funcprototype -#: reference_misc.xml:517 -#, no-c-format -msgid "" -"boolean ST_PointInsideCircle " -"geometry a_point " -"float center_x " -"float center_y " -"float radius" -msgstr "" - -#. Tag: para -#: reference_misc.xml:530 -#, no-c-format -msgid "" -"The syntax for this functions is ST_PointInsideCircle(<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:534 -#, no-c-format -msgid "This only works for points as the name suggests" -msgstr "" - -#. Tag: para -#: reference_misc.xml:536 -#, no-c-format -msgid "Availability: 1.2" -msgstr "" - -#. Tag: para -#: reference_misc.xml:537 -#, no-c-format -msgid "" -"Changed: 2.2.0 In prior versions this used to be called " -"ST_Point_Inside_Circle" -msgstr "" - -#. Tag: programlisting -#: reference_misc.xml:544 -#, no-c-format -msgid "" -"SELECT ST_PointInsideCircle(ST_Point(1,2), 0.5, 2, 3);\n" -" st_pointinsidecircle\n" -"------------------------\n" -" t" -msgstr "" diff --git a/doc/po/templates/reference_operator.xml.pot b/doc/po/templates/reference_operator.xml.pot index aeac6f1c2..63cf2e653 100644 --- a/doc/po/templates/reference_operator.xml.pot +++ b/doc/po/templates/reference_operator.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-09-14 18:44+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -20,14 +20,20 @@ msgstr "" msgid "Operators" msgstr "" -#. Tag: refname +#. Tag: title #: reference_operator.xml:6 #, no-c-format +msgid "Bounding Box Operators" +msgstr "" + +#. Tag: refname +#: reference_operator.xml:10 +#, no-c-format msgid "&&" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:8 +#: reference_operator.xml:12 #, no-c-format msgid "" "Returns TRUE if A's 2D bounding box intersects B's 2D " @@ -35,7 +41,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_operator.xml:12 +#: reference_operator.xml:16 #, no-c-format msgid "" " boolean && " @@ -48,28 +54,28 @@ msgid "" msgstr "" #. Tag: title -#: reference_operator.xml:50 reference_operator.xml:111 -#: reference_operator.xml:172 reference_operator.xml:233 -#: reference_operator.xml:294 reference_operator.xml:356 -#: reference_operator.xml:413 reference_operator.xml:470 -#: reference_operator.xml:530 reference_operator.xml:588 -#: reference_operator.xml:649 reference_operator.xml:707 -#: reference_operator.xml:760 reference_operator.xml:830 -#: reference_operator.xml:902 reference_operator.xml:955 -#: reference_operator.xml:1007 reference_operator.xml:1068 -#: reference_operator.xml:1129 reference_operator.xml:1193 -#: reference_operator.xml:1251 reference_operator.xml:1304 -#: reference_operator.xml:1354 reference_operator.xml:1415 -#: reference_operator.xml:1476 reference_operator.xml:1540 -#: reference_operator.xml:1619 reference_operator.xml:1694 -#: reference_operator.xml:1755 reference_operator.xml:1809 -#: reference_operator.xml:1874 +#: reference_operator.xml:54 reference_operator.xml:115 +#: reference_operator.xml:176 reference_operator.xml:237 +#: reference_operator.xml:298 reference_operator.xml:360 +#: reference_operator.xml:417 reference_operator.xml:474 +#: reference_operator.xml:534 reference_operator.xml:592 +#: reference_operator.xml:653 reference_operator.xml:711 +#: reference_operator.xml:764 reference_operator.xml:834 +#: reference_operator.xml:906 reference_operator.xml:959 +#: reference_operator.xml:1011 reference_operator.xml:1072 +#: reference_operator.xml:1133 reference_operator.xml:1197 +#: reference_operator.xml:1255 reference_operator.xml:1308 +#: reference_operator.xml:1358 reference_operator.xml:1419 +#: reference_operator.xml:1480 reference_operator.xml:1544 +#: reference_operator.xml:1630 reference_operator.xml:1705 +#: reference_operator.xml:1766 reference_operator.xml:1820 +#: reference_operator.xml:1885 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_operator.xml:52 +#: reference_operator.xml:56 #, no-c-format msgid "" "The && operator returns TRUE " @@ -78,13 +84,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:54 reference_operator.xml:298 -#: reference_operator.xml:536 reference_operator.xml:597 -#: reference_operator.xml:655 reference_operator.xml:712 -#: reference_operator.xml:765 reference_operator.xml:907 -#: reference_operator.xml:961 reference_operator.xml:1199 -#: reference_operator.xml:1256 reference_operator.xml:1309 -#: reference_operator.xml:1545 +#: reference_operator.xml:58 reference_operator.xml:302 +#: reference_operator.xml:540 reference_operator.xml:601 +#: reference_operator.xml:659 reference_operator.xml:716 +#: reference_operator.xml:769 reference_operator.xml:911 +#: reference_operator.xml:965 reference_operator.xml:1203 +#: reference_operator.xml:1260 reference_operator.xml:1313 +#: reference_operator.xml:1549 #, no-c-format msgid "" "This operand will make use of any indexes that may be available on the " @@ -92,65 +98,65 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:57 +#: reference_operator.xml:61 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." msgstr "" #. Tag: para -#: reference_operator.xml:58 +#: reference_operator.xml:62 #, 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:180 reference_operator.xml:241 -#: reference_operator.xml:302 reference_operator.xml:364 -#: reference_operator.xml:421 reference_operator.xml:478 -#: reference_operator.xml:594 reference_operator.xml:852 -#: reference_operator.xml:1015 reference_operator.xml:1076 -#: reference_operator.xml:1137 reference_operator.xml:1362 -#: reference_operator.xml:1423 reference_operator.xml:1484 +#: reference_operator.xml:63 reference_operator.xml:123 +#: reference_operator.xml:184 reference_operator.xml:245 +#: reference_operator.xml:306 reference_operator.xml:368 +#: reference_operator.xml:425 reference_operator.xml:482 +#: reference_operator.xml:598 reference_operator.xml:856 +#: reference_operator.xml:1019 reference_operator.xml:1080 +#: reference_operator.xml:1141 reference_operator.xml:1366 +#: reference_operator.xml:1427 reference_operator.xml:1488 #, no-c-format msgid "&curve_support;" msgstr "" #. Tag: para -#: reference_operator.xml:60 reference_operator.xml:120 -#: reference_operator.xml:181 reference_operator.xml:242 -#: reference_operator.xml:303 reference_operator.xml:365 -#: reference_operator.xml:422 reference_operator.xml:479 -#: reference_operator.xml:595 reference_operator.xml:853 -#: reference_operator.xml:1016 reference_operator.xml:1077 -#: reference_operator.xml:1138 reference_operator.xml:1363 -#: reference_operator.xml:1424 reference_operator.xml:1485 -#: reference_operator.xml:1549 +#: reference_operator.xml:64 reference_operator.xml:124 +#: reference_operator.xml:185 reference_operator.xml:246 +#: reference_operator.xml:307 reference_operator.xml:369 +#: reference_operator.xml:426 reference_operator.xml:483 +#: reference_operator.xml:599 reference_operator.xml:857 +#: reference_operator.xml:1020 reference_operator.xml:1081 +#: reference_operator.xml:1142 reference_operator.xml:1367 +#: reference_operator.xml:1428 reference_operator.xml:1489 +#: reference_operator.xml:1553 #, no-c-format msgid "&P_support;" msgstr "" #. Tag: title -#: reference_operator.xml:64 reference_operator.xml:124 -#: reference_operator.xml:185 reference_operator.xml:246 -#: reference_operator.xml:371 reference_operator.xml:428 -#: reference_operator.xml:485 reference_operator.xml:541 -#: reference_operator.xml:602 reference_operator.xml:660 -#: reference_operator.xml:717 reference_operator.xml:770 -#: reference_operator.xml:858 reference_operator.xml:912 -#: reference_operator.xml:967 reference_operator.xml:1020 -#: reference_operator.xml:1081 reference_operator.xml:1142 -#: reference_operator.xml:1204 reference_operator.xml:1261 -#: reference_operator.xml:1314 reference_operator.xml:1367 -#: reference_operator.xml:1428 reference_operator.xml:1489 -#: reference_operator.xml:1564 reference_operator.xml:1642 -#: reference_operator.xml:1712 reference_operator.xml:1769 +#: reference_operator.xml:68 reference_operator.xml:128 +#: reference_operator.xml:189 reference_operator.xml:250 +#: reference_operator.xml:375 reference_operator.xml:432 +#: reference_operator.xml:489 reference_operator.xml:545 +#: reference_operator.xml:606 reference_operator.xml:664 +#: reference_operator.xml:721 reference_operator.xml:774 +#: reference_operator.xml:862 reference_operator.xml:916 +#: reference_operator.xml:971 reference_operator.xml:1024 +#: reference_operator.xml:1085 reference_operator.xml:1146 +#: reference_operator.xml:1208 reference_operator.xml:1265 +#: reference_operator.xml:1318 reference_operator.xml:1371 +#: reference_operator.xml:1432 reference_operator.xml:1493 +#: reference_operator.xml:1568 reference_operator.xml:1653 +#: reference_operator.xml:1723 reference_operator.xml:1780 #, no-c-format msgid "Examples" msgstr "" #. Tag: programlisting -#: reference_operator.xml:66 +#: reference_operator.xml:70 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 && tbl2.column2 AS " @@ -169,28 +175,28 @@ msgid "" msgstr "" #. Tag: title -#: reference_operator.xml:71 reference_operator.xml:130 -#: reference_operator.xml:191 reference_operator.xml:252 -#: reference_operator.xml:322 reference_operator.xml:377 -#: reference_operator.xml:434 reference_operator.xml:491 -#: reference_operator.xml:547 reference_operator.xml:608 -#: reference_operator.xml:666 reference_operator.xml:723 -#: reference_operator.xml:776 reference_operator.xml:864 -#: reference_operator.xml:918 reference_operator.xml:973 -#: reference_operator.xml:1026 reference_operator.xml:1087 -#: reference_operator.xml:1148 reference_operator.xml:1210 -#: reference_operator.xml:1267 reference_operator.xml:1320 -#: reference_operator.xml:1373 reference_operator.xml:1434 -#: reference_operator.xml:1495 reference_operator.xml:1568 -#: reference_operator.xml:1658 reference_operator.xml:1716 -#: reference_operator.xml:1773 reference_operator.xml:1836 -#: reference_operator.xml:1892 +#: reference_operator.xml:75 reference_operator.xml:134 +#: reference_operator.xml:195 reference_operator.xml:256 +#: reference_operator.xml:326 reference_operator.xml:381 +#: reference_operator.xml:438 reference_operator.xml:495 +#: reference_operator.xml:551 reference_operator.xml:612 +#: reference_operator.xml:670 reference_operator.xml:727 +#: reference_operator.xml:780 reference_operator.xml:868 +#: reference_operator.xml:922 reference_operator.xml:977 +#: reference_operator.xml:1030 reference_operator.xml:1091 +#: reference_operator.xml:1152 reference_operator.xml:1214 +#: reference_operator.xml:1271 reference_operator.xml:1324 +#: reference_operator.xml:1377 reference_operator.xml:1438 +#: reference_operator.xml:1499 reference_operator.xml:1572 +#: reference_operator.xml:1669 reference_operator.xml:1727 +#: reference_operator.xml:1784 reference_operator.xml:1847 +#: reference_operator.xml:1903 #, no-c-format msgid "See Also" msgstr "" #. Tag: para -#: reference_operator.xml:73 +#: reference_operator.xml:77 #, no-c-format msgid "" ", , TRUE if a geometry's (cached) 2D bounding box " @@ -213,7 +219,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:92 +#: reference_operator.xml:96 #, no-c-format msgid "" "boolean && " @@ -222,7 +228,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:113 +#: reference_operator.xml:117 #, no-c-format msgid "" "The && operator returns TRUE " @@ -233,10 +239,10 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:115 reference_operator.xml:176 -#: reference_operator.xml:1011 reference_operator.xml:1072 -#: reference_operator.xml:1133 reference_operator.xml:1358 -#: reference_operator.xml:1419 reference_operator.xml:1480 +#: reference_operator.xml:119 reference_operator.xml:180 +#: reference_operator.xml:1015 reference_operator.xml:1076 +#: reference_operator.xml:1137 reference_operator.xml:1362 +#: reference_operator.xml:1423 reference_operator.xml:1484 #, no-c-format msgid "" "This operand is intended to be used internally by BRIN indexes, more than by " @@ -244,12 +250,12 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:118 reference_operator.xml:179 -#: reference_operator.xml:240 reference_operator.xml:363 -#: reference_operator.xml:420 reference_operator.xml:477 -#: reference_operator.xml:1014 reference_operator.xml:1075 -#: reference_operator.xml:1136 reference_operator.xml:1361 -#: reference_operator.xml:1422 reference_operator.xml:1483 +#: reference_operator.xml:122 reference_operator.xml:183 +#: reference_operator.xml:244 reference_operator.xml:367 +#: reference_operator.xml:424 reference_operator.xml:481 +#: reference_operator.xml:1018 reference_operator.xml:1079 +#: reference_operator.xml:1140 reference_operator.xml:1365 +#: reference_operator.xml:1426 reference_operator.xml:1487 #, no-c-format msgid "" "Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. " @@ -257,7 +263,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:126 +#: reference_operator.xml:130 #, no-c-format msgid "" "SELECT ST_MakePoint(1,1) && ST_MakeBox2D(ST_MakePoint(0,0), " @@ -270,7 +276,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:132 reference_operator.xml:193 +#: reference_operator.xml:136 reference_operator.xml:197 #, no-c-format msgid "" ", , TRUE if a 2D float precision bounding box " @@ -296,7 +302,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:153 +#: reference_operator.xml:157 #, no-c-format msgid "" "boolean && " @@ -305,7 +311,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:174 +#: reference_operator.xml:178 #, no-c-format msgid "" "The && operator returns TRUE " @@ -316,7 +322,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:187 +#: reference_operator.xml:191 #, no-c-format msgid "" "SELECT ST_MakeBox2D(ST_MakePoint(0,0), ST_MakePoint(2,2)) && " @@ -329,13 +335,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_operator.xml:207 +#: reference_operator.xml:211 #, no-c-format msgid "&&(box2df,box2df)" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:209 +#: reference_operator.xml:213 #, no-c-format msgid "" "Returns TRUE if two 2D float precision bounding boxes " @@ -343,7 +349,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:214 +#: reference_operator.xml:218 #, no-c-format msgid "" "boolean && " @@ -352,7 +358,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:235 +#: reference_operator.xml:239 #, no-c-format msgid "" "The && operator returns TRUE " @@ -362,8 +368,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:237 reference_operator.xml:360 -#: reference_operator.xml:417 reference_operator.xml:474 +#: reference_operator.xml:241 reference_operator.xml:364 +#: reference_operator.xml:421 reference_operator.xml:478 #, no-c-format msgid "" "This operator is intended to be used internally by BRIN indexes, more than " @@ -371,7 +377,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:248 +#: reference_operator.xml:252 #, no-c-format msgid "" "SELECT ST_MakeBox2D(ST_MakePoint(0,0), ST_MakePoint(2,2)) && " @@ -384,7 +390,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:254 +#: reference_operator.xml:258 #, no-c-format msgid "" ", , TRUE if A's n-D bounding box intersects B's n-D " @@ -410,7 +416,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:275 +#: reference_operator.xml:279 #, no-c-format msgid "" "boolean &&& " @@ -419,7 +425,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:296 +#: reference_operator.xml:300 #, no-c-format msgid "" "The &&& operator returns TRUETRUE if a geometry's (cached) n-D bounding box " @@ -514,7 +520,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:337 +#: reference_operator.xml:341 #, no-c-format msgid "" "boolean &&& " @@ -523,7 +529,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:358 +#: reference_operator.xml:362 #, no-c-format msgid "" "The &&& operator returns TRUE" msgstr "" #. Tag: refname -#: reference_operator.xml:387 +#: reference_operator.xml:391 #, no-c-format msgid "&&&(gidx,geometry)" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:389 +#: reference_operator.xml:393 #, no-c-format msgid "" "Returns TRUE if a n-D float precision bounding box (GIDX) " @@ -567,7 +573,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:394 +#: reference_operator.xml:398 #, no-c-format msgid "" "boolean &&& " @@ -576,7 +582,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:415 +#: reference_operator.xml:419 #, no-c-format msgid "" "The &&& operator returns TRUETRUE if two n-D float precision bounding boxes " @@ -614,7 +620,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:451 +#: reference_operator.xml:455 #, no-c-format msgid "" "boolean &&& " @@ -623,7 +629,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:472 +#: reference_operator.xml:476 #, no-c-format msgid "" "The &&& operator returns TRUE" msgstr "" #. Tag: refname -#: reference_operator.xml:501 +#: reference_operator.xml:505 #, no-c-format msgid "&<" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:503 +#: reference_operator.xml:507 #, no-c-format msgid "" "Returns TRUE if A's bounding box overlaps or is to the " @@ -666,7 +672,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:508 +#: reference_operator.xml:512 #, no-c-format msgid "" "boolean &< " @@ -675,7 +681,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:532 +#: reference_operator.xml:536 #, no-c-format msgid "" "The &< operator returns TRUE if " @@ -685,7 +691,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:543 +#: reference_operator.xml:547 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 &< tbl2.column2 AS " @@ -707,7 +713,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:549 +#: reference_operator.xml:553 #, no-c-format msgid "" ", , TRUE if A's bounding box overlaps or is below B's." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:566 +#: reference_operator.xml:570 #, no-c-format msgid "" "boolean &<| " @@ -737,7 +743,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:590 +#: reference_operator.xml:594 #, no-c-format msgid "" "The &<| operator returns TRUE " @@ -747,7 +753,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:604 +#: reference_operator.xml:608 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 &<| tbl2.column2 AS " @@ -769,7 +775,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:610 +#: reference_operator.xml:614 #, no-c-format msgid "" ", , TRUE if A' bounding box overlaps or is to the " @@ -791,7 +797,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:627 +#: reference_operator.xml:631 #, no-c-format msgid "" "boolean &> " @@ -800,7 +806,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:651 +#: reference_operator.xml:655 #, no-c-format msgid "" "The &> operator returns TRUE if " @@ -810,7 +816,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:662 +#: reference_operator.xml:666 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 &> tbl2.column2 AS " @@ -832,7 +838,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:668 +#: reference_operator.xml:672 #, no-c-format msgid "" ", , TRUE if A's bounding box is strictly to the left " @@ -854,7 +860,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:685 +#: reference_operator.xml:689 #, no-c-format msgid "" "boolean << " @@ -863,7 +869,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:709 +#: reference_operator.xml:713 #, no-c-format msgid "" "The << operator returns TRUE if " @@ -872,7 +878,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:719 +#: reference_operator.xml:723 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 << tbl2.column2 AS " @@ -894,7 +900,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:725 reference_operator.xml:920 +#: reference_operator.xml:729 reference_operator.xml:924 #, no-c-format msgid "" ", , TRUE if A's bounding box is strictly below B's." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:738 +#: reference_operator.xml:742 #, no-c-format msgid "" "boolean <<| " @@ -924,7 +930,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:762 +#: reference_operator.xml:766 #, no-c-format msgid "" "The <<| operator returns TRUE if " @@ -933,7 +939,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:772 +#: reference_operator.xml:776 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 <<| tbl2.column2 AS " @@ -955,7 +961,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:778 +#: reference_operator.xml:782 #, no-c-format msgid "" ", , TRUE if the coordinates and coordinate order " @@ -978,7 +984,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_operator.xml:791 +#: reference_operator.xml:795 #, no-c-format msgid "" " boolean = " @@ -991,7 +997,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:832 +#: reference_operator.xml:836 #, no-c-format msgid "" "The = operator returns TRUE if the " @@ -1003,7 +1009,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:837 +#: reference_operator.xml:841 #, no-c-format msgid "" "Only geometry/geography that are exactly equal in all respects, with the " @@ -1015,7 +1021,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:846 +#: reference_operator.xml:850 #, no-c-format msgid "" "This operand will NOT make use of any indexes that may be available on the " @@ -1024,7 +1030,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:850 +#: reference_operator.xml:854 #, no-c-format msgid "" "Changed: 2.4.0, in prior versions this was bounding box equality not a " @@ -1033,7 +1039,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:860 +#: reference_operator.xml:864 #, no-c-format msgid "" "SELECT 'LINESTRING(0 0, 0 1, 1 0)'::geometry = 'LINESTRING(1 1, 0 0)'::" @@ -1074,20 +1080,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:866 +#: reference_operator.xml:870 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_operator.xml:873 +#: reference_operator.xml:877 #, no-c-format msgid ">>" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:875 +#: reference_operator.xml:879 #, no-c-format msgid "" "Returns TRUE if A's bounding box is strictly to the right " @@ -1095,7 +1101,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:880 +#: reference_operator.xml:884 #, no-c-format msgid "" "boolean >> " @@ -1104,7 +1110,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:904 +#: reference_operator.xml:908 #, no-c-format msgid "" "The >> operator returns TRUE if " @@ -1113,7 +1119,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:914 +#: reference_operator.xml:918 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 >> tbl2.column2 AS " @@ -1135,20 +1141,20 @@ msgid "" msgstr "" #. Tag: refname -#: reference_operator.xml:926 +#: reference_operator.xml:930 #, no-c-format msgid "@" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:928 +#: reference_operator.xml:932 #, no-c-format msgid "" "Returns TRUE if A's bounding box is contained by B's." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:933 +#: reference_operator.xml:937 #, no-c-format msgid "" "boolean @ geometry " @@ -1157,7 +1163,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:957 +#: reference_operator.xml:961 #, no-c-format msgid "" "The @ operator returns TRUE if the " @@ -1166,7 +1172,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:969 +#: reference_operator.xml:973 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 @ tbl2.column2 AS contained\n" @@ -1187,19 +1193,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:975 reference_operator.xml:1322 +#: reference_operator.xml:979 reference_operator.xml:1326 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_operator.xml:981 +#: reference_operator.xml:985 #, no-c-format msgid "@(geometry,box2df)" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:983 +#: reference_operator.xml:987 #, no-c-format msgid "" "Returns TRUE if a geometry's 2D bounding box is contained " @@ -1207,7 +1213,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:988 +#: reference_operator.xml:992 #, no-c-format msgid "" "boolean @ geometry " @@ -1216,7 +1222,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1009 +#: reference_operator.xml:1013 #, no-c-format msgid "" "The @ operator returns TRUE if the A " @@ -1226,7 +1232,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1022 +#: reference_operator.xml:1026 #, no-c-format msgid "" "SELECT ST_Buffer(ST_GeomFromText('POINT(2 2)'), 1) @ " @@ -1239,7 +1245,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1028 +#: reference_operator.xml:1032 #, no-c-format msgid "" ", , TRUE if a 2D float precision bounding box " @@ -1264,7 +1270,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1049 +#: reference_operator.xml:1053 #, no-c-format msgid "" "boolean @ box2df @ operator returns TRUE if the 2D " @@ -1283,7 +1289,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1083 +#: reference_operator.xml:1087 #, no-c-format msgid "" "SELECT ST_MakeBox2D(ST_MakePoint(2,2), ST_MakePoint(3,3)) @ " @@ -1296,7 +1302,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1089 +#: reference_operator.xml:1093 #, no-c-format msgid "" ", , TRUE if a 2D float precision bounding box " @@ -1321,7 +1327,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1110 +#: reference_operator.xml:1114 #, no-c-format msgid "" "boolean @ box2df @ operator returns TRUE if the 2D " @@ -1340,7 +1346,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1144 +#: reference_operator.xml:1148 #, no-c-format msgid "" "SELECT ST_MakeBox2D(ST_MakePoint(2,2), ST_MakePoint(3,3)) @ " @@ -1353,7 +1359,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1150 +#: reference_operator.xml:1154 #, no-c-format msgid "" ", , TRUE if A's bounding box overlaps or is above B's." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1171 +#: reference_operator.xml:1175 #, no-c-format msgid "" "boolean |&> " @@ -1386,7 +1392,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1195 +#: reference_operator.xml:1199 #, no-c-format msgid "" "The |&> operator returns TRUE " @@ -1396,7 +1402,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1206 +#: reference_operator.xml:1210 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 |&> tbl2.column2 AS " @@ -1418,7 +1424,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1212 +#: reference_operator.xml:1216 #, no-c-format msgid "" ", , TRUE if A's bounding box is strictly above B's." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1229 +#: reference_operator.xml:1233 #, no-c-format msgid "" "boolean |>> " @@ -1448,7 +1454,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1253 +#: reference_operator.xml:1257 #, no-c-format msgid "" "The |>> operator returns TRUE if " @@ -1457,7 +1463,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1263 +#: reference_operator.xml:1267 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 |>> tbl2.column2 AS " @@ -1479,7 +1485,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1269 +#: reference_operator.xml:1273 #, no-c-format msgid "" ", , ~" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:1277 +#: reference_operator.xml:1281 #, no-c-format msgid "Returns TRUE if A's bounding box contains B's." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1282 +#: reference_operator.xml:1286 #, no-c-format msgid "" "boolean ~ geometry " @@ -1508,7 +1514,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1306 +#: reference_operator.xml:1310 #, no-c-format msgid "" "The ~ operator returns TRUE if the " @@ -1517,7 +1523,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1316 +#: reference_operator.xml:1320 #, no-c-format msgid "" "SELECT tbl1.column1, tbl2.column1, tbl1.column2 ~ tbl2.column2 AS contains\n" @@ -1538,13 +1544,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_operator.xml:1328 +#: reference_operator.xml:1332 #, no-c-format msgid "~(geometry,box2df)" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:1330 +#: reference_operator.xml:1334 #, no-c-format msgid "" "Returns TRUE if a geometry's 2D bonding box contains a 2D " @@ -1552,7 +1558,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1335 +#: reference_operator.xml:1339 #, no-c-format msgid "" "boolean ~ geometry " @@ -1561,7 +1567,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1356 +#: reference_operator.xml:1360 #, no-c-format msgid "" "The ~ operator returns TRUE if the 2D " @@ -1571,7 +1577,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1369 +#: reference_operator.xml:1373 #, no-c-format msgid "" "SELECT ST_Buffer(ST_GeomFromText('POINT(1 1)'), 10) ~ " @@ -1584,7 +1590,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1375 +#: reference_operator.xml:1379 #, no-c-format msgid "" ", , TRUE if a 2D float precision bounding box " @@ -1610,7 +1616,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1396 +#: reference_operator.xml:1400 #, no-c-format msgid "" "boolean ~ box2df ~ operator returns TRUE if the 2D " @@ -1629,7 +1635,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1430 +#: reference_operator.xml:1434 #, no-c-format msgid "" "SELECT ST_MakeBox2D(ST_MakePoint(0,0), ST_MakePoint(5,5)) ~ " @@ -1642,7 +1648,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1436 +#: reference_operator.xml:1440 #, no-c-format msgid "" ", , TRUE if a 2D float precision bounding box " @@ -1668,7 +1674,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1457 +#: reference_operator.xml:1461 #, no-c-format msgid "" "boolean ~ box2df ~ operator returns TRUE if the 2D " @@ -1687,7 +1693,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1491 +#: reference_operator.xml:1495 #, no-c-format msgid "" "SELECT ST_MakeBox2D(ST_MakePoint(0,0), ST_MakePoint(5,5)) ~ " @@ -1700,7 +1706,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1497 +#: reference_operator.xml:1501 #, no-c-format msgid "" ", , ~=" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:1513 +#: reference_operator.xml:1517 #, no-c-format msgid "Returns TRUE if A's bounding box is the same as B's." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1518 +#: reference_operator.xml:1522 #, no-c-format msgid "" "boolean ~= geometry " @@ -1733,7 +1739,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1542 +#: reference_operator.xml:1546 #, no-c-format msgid "" "The ~= operator returns TRUE if the " @@ -1742,13 +1748,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1548 +#: reference_operator.xml:1552 #, no-c-format msgid "Availability: 1.5.0 changed behavior" msgstr "" #. Tag: para -#: reference_operator.xml:1552 +#: reference_operator.xml:1556 #, no-c-format msgid "" "This operator has changed behavior in PostGIS 1.5 from testing for actual " @@ -1760,7 +1766,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1565 +#: reference_operator.xml:1569 #, no-c-format msgid "" "select 'LINESTRING(0 0, 1 1)'::geometry ~= 'LINESTRING(0 1, 1 0)'::geometry " @@ -1771,26 +1777,32 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1569 +#: reference_operator.xml:1573 #, no-c-format msgid "" ", , " msgstr "" +#. Tag: title +#: reference_operator.xml:1581 +#, no-c-format +msgid "Distance Operators" +msgstr "" + #. Tag: refname -#: reference_operator.xml:1575 +#: reference_operator.xml:1586 #, no-c-format msgid "<->" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:1577 +#: reference_operator.xml:1588 #, no-c-format msgid "Returns the 2D distance between A and B." msgstr "" #. Tag: funcsynopsis -#: reference_operator.xml:1583 +#: reference_operator.xml:1594 #, no-c-format msgid "" " double precision <-><-> operator returns the 2D distance between " @@ -1815,7 +1827,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1630 +#: reference_operator.xml:1641 #, no-c-format msgid "" "This operand will make use of 2D GiST indexes that may be available on the " @@ -1825,7 +1837,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1631 reference_operator.xml:1824 +#: reference_operator.xml:1642 reference_operator.xml:1835 #, no-c-format msgid "" "Index only kicks in if one of the geometries is a constant (not in a " @@ -1834,7 +1846,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1632 +#: reference_operator.xml:1643 #, no-c-format msgid "" "Refer to , " msgstr "" #. Tag: refname -#: reference_operator.xml:1665 +#: reference_operator.xml:1676 #, no-c-format msgid "|=|" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:1667 +#: reference_operator.xml:1678 #, no-c-format msgid "" "Returns the distance between A and B trajectories at their closest point of " @@ -1991,7 +2003,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1674 +#: reference_operator.xml:1685 #, no-c-format msgid "" "double precision |=| " @@ -2000,7 +2012,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1696 +#: reference_operator.xml:1707 #, no-c-format msgid "" "The |=| operator returns the 3D distance between two " @@ -2011,7 +2023,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1704 +#: reference_operator.xml:1715 #, no-c-format msgid "" "This operand will make use of ND GiST indexes that may be available on the " @@ -2021,7 +2033,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1705 +#: reference_operator.xml:1716 #, no-c-format msgid "" "Index only kicks in if one of the geometries is a constant (not in a " @@ -2030,13 +2042,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1707 +#: reference_operator.xml:1718 #, no-c-format msgid "Availability: 2.2.0. Index-supported only available for PostgreSQL 9.5+" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1713 +#: reference_operator.xml:1724 #, no-c-format msgid "" "-- Save a literal query trajectory in a psql variable...\n" @@ -2060,7 +2072,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1717 +#: reference_operator.xml:1728 #, no-c-format msgid "" ", , double precision <#> " @@ -2089,7 +2101,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1757 +#: reference_operator.xml:1768 #, no-c-format msgid "" "The <#> operator returns distance between two " @@ -2099,7 +2111,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1759 reference_operator.xml:1878 +#: reference_operator.xml:1770 reference_operator.xml:1889 #, no-c-format msgid "" "This operand will make use of any indexes that may be available on the " @@ -2109,7 +2121,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1762 +#: reference_operator.xml:1773 #, no-c-format msgid "" "Index only kicks in if one of the geometries is a constant e.g. ORDER BY " @@ -2117,13 +2129,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1764 +#: reference_operator.xml:1775 #, no-c-format msgid "Availability: 2.0.0 -- KNN only available for PostgreSQL 9.1+" msgstr "" #. Tag: programlisting -#: reference_operator.xml:1770 +#: reference_operator.xml:1781 #, no-c-format msgid "" ", " msgstr "" #. Tag: refname -#: reference_operator.xml:1780 +#: reference_operator.xml:1791 #, no-c-format msgid "<<->>" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:1782 +#: reference_operator.xml:1793 #, no-c-format msgid "" "Returns the n-D distance between the centroids of A and B bounding boxes." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1790 +#: reference_operator.xml:1801 #, no-c-format msgid "" "double precision <<->> " @@ -2187,7 +2199,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1811 +#: reference_operator.xml:1822 #, no-c-format msgid "" "The <<->> operator returns the n-D " @@ -2197,7 +2209,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1818 +#: reference_operator.xml:1829 #, no-c-format msgid "" "This operand will make use of n-D GiST indexes that may be available on the " @@ -2207,31 +2219,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1830 reference_operator.xml:1887 +#: reference_operator.xml:1841 reference_operator.xml:1898 #, no-c-format msgid "Availability: 2.2.0 -- KNN only available for PostgreSQL 9.1+" msgstr "" #. Tag: para -#: reference_operator.xml:1837 +#: reference_operator.xml:1848 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_operator.xml:1846 +#: reference_operator.xml:1857 #, no-c-format msgid "<<#>>" msgstr "" #. Tag: refpurpose -#: reference_operator.xml:1848 +#: reference_operator.xml:1859 #, no-c-format msgid "Returns the n-D distance between A and B bounding boxes." msgstr "" #. Tag: funcprototype -#: reference_operator.xml:1855 +#: reference_operator.xml:1866 #, no-c-format msgid "" "double precision <<#>> " @@ -2240,7 +2252,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1876 +#: reference_operator.xml:1887 #, no-c-format msgid "" "The <<#>> operator returns distance between " @@ -2250,7 +2262,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1881 +#: reference_operator.xml:1892 #, no-c-format msgid "" "Index only kicks in if one of the geometries is a constant e.g. ORDER BY " @@ -2259,7 +2271,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_operator.xml:1893 +#: reference_operator.xml:1904 #, no-c-format msgid ", " msgstr "" diff --git a/doc/po/templates/reference_output.xml.pot b/doc/po/templates/reference_output.xml.pot index fdc875411..aeb3eb8e2 100644 --- a/doc/po/templates/reference_output.xml.pot +++ b/doc/po/templates/reference_output.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -14,20 +14,330 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +#. Tag: para +#: reference_output.xml:6 +#, no-c-format +msgid "" +"These functions convert geometry objects into various textual or binary " +"formats." +msgstr "" + +#. Tag: title +#: reference_output.xml:10 +#, no-c-format +msgid "Geometry Output" +msgstr "" + +#. Tag: title +#: reference_output.xml:13 +#, no-c-format +msgid "Well-Known Text (WKT)" +msgstr "" + +#. Tag: refname +#: reference_output.xml:17 +#, no-c-format +msgid "ST_AsEWKT" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:18 +#, no-c-format +msgid "" +"Return the Well-Known Text (WKT) representation of the geometry with SRID " +"meta data." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:22 +#, no-c-format +msgid "" +" text ST_AsEWKT " +"geometry g1 text ST_AsEWKT geography g1 " +msgstr "" + +#. Tag: title +#: reference_output.xml:35 reference_output.xml:103 reference_output.xml:182 +#: reference_output.xml:257 reference_output.xml:315 reference_output.xml:358 +#: reference_output.xml:406 reference_output.xml:459 reference_output.xml:577 +#: reference_output.xml:682 reference_output.xml:740 reference_output.xml:808 +#: reference_output.xml:884 reference_output.xml:962 reference_output.xml:1015 +#: reference_output.xml:1063 reference_output.xml:1185 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_output.xml:37 +#, no-c-format +msgid "" +"Returns the Well-Known Text representation of the geometry prefixed with the " +"SRID." +msgstr "" + +#. Tag: para +#: reference_output.xml:40 +#, 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:43 reference_output.xml:113 +#, 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:46 +#, no-c-format +msgid "" +"ST_AsEWKT is the reverse of . Use to convert to a postgis geometry from " +"ST_AsEWKT representation." +msgstr "" + +#. Tag: para +#: reference_output.xml:48 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and " +"TIN was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:49 reference_output.xml:213 reference_output.xml:270 +#: reference_output.xml:323 reference_output.xml:490 reference_output.xml:627 +#: reference_output.xml:709 reference_output.xml:1140 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_output.xml:50 reference_output.xml:123 reference_output.xml:210 +#: reference_output.xml:271 reference_output.xml:324 reference_output.xml:1199 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_output.xml:51 reference_output.xml:211 reference_output.xml:272 +#: reference_output.xml:628 reference_output.xml:1142 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_output.xml:52 reference_output.xml:212 reference_output.xml:273 +#: reference_output.xml:629 reference_output.xml:1145 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: title +#: reference_output.xml:57 reference_output.xml:127 reference_output.xml:218 +#: reference_output.xml:278 reference_output.xml:328 reference_output.xml:367 +#: reference_output.xml:421 reference_output.xml:494 reference_output.xml:713 +#: reference_output.xml:769 reference_output.xml:828 reference_output.xml:924 +#: reference_output.xml:981 reference_output.xml:1030 reference_output.xml:1203 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:59 +#, 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: title +#: reference_output.xml:64 reference_output.xml:140 reference_output.xml:226 +#: reference_output.xml:286 reference_output.xml:380 reference_output.xml:521 +#: reference_output.xml:647 reference_output.xml:717 reference_output.xml:833 +#: reference_output.xml:930 reference_output.xml:1039 reference_output.xml:1207 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_output.xml:65 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_output.xml:75 +#, no-c-format +msgid "ST_AsText" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:76 +#, no-c-format +msgid "" +"Return the Well-Known Text (WKT) representation of the geometry/geography " +"without SRID metadata." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:80 +#, no-c-format +msgid "" +" text ST_AsText " +"geometry g1 text ST_AsText geometry g1 integer " +"maxdecimaldigits=15 " +" text ST_AsText " +"geography g1 text ST_AsText geography g1 integer " +"maxdecimaldigits=15 " +msgstr "" + +#. Tag: para +#: reference_output.xml:105 +#, no-c-format +msgid "" +"Returns the Well-Known Text representation of the geometry/geography. " +"Optional argument may be used to reduce the maximum number of decimal digits " +"after floating point used in output (defaults to 15)." +msgstr "" + +#. Tag: para +#: reference_output.xml:109 +#, 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 " +msgstr "" + +#. Tag: para +#: reference_output.xml:116 +#, no-c-format +msgid "" +"ST_AsText is the reverse of . Use to convert to a postgis geometry from " +"ST_AsText representation." +msgstr "" + +#. Tag: para +#: reference_output.xml:119 +#, no-c-format +msgid "Availability: 1.5 - support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:120 +#, no-c-format +msgid "Enhanced: 2.5 - optional parameter precision introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:121 reference_output.xml:208 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.1" +msgstr "" + +#. Tag: para +#: reference_output.xml:122 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:129 +#, 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:131 +#, no-c-format +msgid "Providing the precision is optional." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:133 +#, no-c-format +msgid "" +"SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'))\n" +" st_astext\n" +"------------------------------\n" +" POINT(111.1111111 1.1111111)\n" +"(1 row)" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:135 +#, no-c-format +msgid "" +"SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'),2)\n" +"st_astext\n" +"--------------------\n" +"POINT(111.11 1.11)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_output.xml:142 +#, no-c-format +msgid "" +", , , " +msgstr "" + #. Tag: title -#: reference_output.xml:4 +#: reference_output.xml:150 #, no-c-format -msgid "Geometry Outputs" +msgid "Well-Known Binary (WKB)" msgstr "" #. Tag: refname -#: reference_output.xml:7 +#: reference_output.xml:154 #, no-c-format msgid "ST_AsBinary" msgstr "" #. Tag: refpurpose -#: reference_output.xml:8 +#: reference_output.xml:155 #, no-c-format msgid "" "Return the Well-Known Binary (WKB) representation of the geometry/geography " @@ -35,7 +345,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_output.xml:12 +#: reference_output.xml:159 #, no-c-format msgid "" " bytea ST_AsBinary " @@ -52,19 +362,8 @@ msgid "" "funcprototype>" msgstr "" -#. Tag: title -#: reference_output.xml:35 reference_output.xml:106 reference_output.xml:154 -#: reference_output.xml:207 reference_output.xml:283 reference_output.xml:384 -#: reference_output.xml:485 reference_output.xml:541 reference_output.xml:599 -#: reference_output.xml:671 reference_output.xml:724 reference_output.xml:797 -#: reference_output.xml:845 reference_output.xml:967 reference_output.xml:1016 -#: reference_output.xml:1056 reference_output.xml:1119 -#, no-c-format -msgid "Description" -msgstr "" - #. Tag: para -#: reference_output.xml:37 +#: reference_output.xml:184 #, no-c-format msgid "" "Returns the Well-Known Binary representation of the geometry. There are 2 " @@ -75,7 +374,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:40 reference_output.xml:158 +#: reference_output.xml:187 reference_output.xml:261 #, no-c-format msgid "" "This is useful in binary cursors to pull data out of the database without " @@ -83,7 +382,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:44 +#: reference_output.xml:191 #, no-c-format msgid "" "The WKB spec does not include the SRID. To get the WKB with SRID format use " @@ -91,7 +390,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:47 +#: reference_output.xml:194 #, no-c-format msgid "" "ST_AsBinary is the reverse of for " @@ -100,7 +399,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:51 +#: reference_output.xml:198 #, no-c-format msgid "" "The default behavior in PostgreSQL 9.0 has been changed to output bytea in " @@ -109,167 +408,278 @@ msgid "" "bytea_output='escape' in your database." msgstr "" -#. Tag: para -#: reference_output.xml:55 reference_output.xml:166 +#. Tag: para +#: reference_output.xml:202 reference_output.xml:269 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:203 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for higher coordinate dimensions was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:204 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for specifying endian with geography was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:205 reference_output.xml:487 reference_output.xml:621 +#, no-c-format +msgid "Availability: 1.5.0 geography support was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:206 +#, no-c-format +msgid "" +"Changed: 2.0.0 Inputs to this function can not be unknown -- must be " +"geometry. Constructs such as ST_AsBinary('POINT(1 2)') are no " +"longer valid and you will get an n st_asbinary(unknown) is not unique " +"error. Code like that needs to be changed to " +"ST_AsBinary('POINT(1 2)'::geometry);. If that is not possible, " +"then install legacy.sql." +msgstr "" + +#. Tag: para +#: reference_output.xml:209 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.37" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:220 +#, 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:221 +#, 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: para +#: reference_output.xml:227 +#, no-c-format +msgid "" +", , , ," +msgstr "" + +#. Tag: refname +#: reference_output.xml:238 +#, no-c-format +msgid "ST_AsEWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:239 +#, no-c-format +msgid "" +"Return the Well-Known Binary (WKB) representation of the geometry with SRID " +"meta data." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:243 #, no-c-format msgid "" -"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " -"introduced." +" bytea ST_AsEWKB " +"geometry g1 bytea ST_AsEWKB geometry g1 text NDR_or_XDR " msgstr "" #. Tag: para -#: reference_output.xml:56 +#: reference_output.xml:258 #, no-c-format msgid "" -"Enhanced: 2.0.0 support for higher coordinate dimensions was introduced." +"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:57 +#: reference_output.xml:264 #, no-c-format msgid "" -"Enhanced: 2.0.0 support for specifying endian with geography was introduced." +"The WKB spec does not include the SRID. To get the OGC WKB format use " +"ST_AsBinary" msgstr "" #. Tag: para -#: reference_output.xml:58 reference_output.xml:324 reference_output.xml:428 +#: reference_output.xml:267 #, no-c-format -msgid "Availability: 1.5.0 geography support was introduced." +msgid "" +"ST_AsEWKB is the reverse of ST_GeomFromEWKB. Use ST_GeomFromEWKB to convert " +"to a postgis geometry from ST_AsEWKB representation." msgstr "" -#. Tag: para -#: reference_output.xml:59 +#. Tag: programlisting +#: reference_output.xml:280 #, no-c-format msgid "" -"Changed: 2.0.0 Inputs to this function can not be unknown -- must be " -"geometry. Constructs such as ST_AsBinary('POINT(1 2)') are no " -"longer valid and you will get an n st_asbinary(unknown) is not unique " -"error. Code like that needs to be changed to " -"ST_AsBinary('POINT(1 2)'::geometry);. If that is not possible, " -"then install legacy.sql." +"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: para -#: reference_output.xml:61 reference_output.xml:742 +#. Tag: programlisting +#: reference_output.xml:281 #, no-c-format -msgid "&sfs_compliant; s2.1.1.1" +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:62 +#: reference_output.xml:287 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.37" +msgid "" +", , , , " msgstr "" -#. Tag: para -#: reference_output.xml:63 reference_output.xml:168 reference_output.xml:222 -#: reference_output.xml:494 reference_output.xml:744 reference_output.xml:981 +#. Tag: refname +#: reference_output.xml:293 #, no-c-format -msgid "&curve_support;" +msgid "ST_AsHEXEWKB" msgstr "" -#. Tag: para -#: reference_output.xml:64 reference_output.xml:169 reference_output.xml:223 -#: reference_output.xml:435 reference_output.xml:924 +#. Tag: refpurpose +#: reference_output.xml:295 #, no-c-format -msgid "&P_support;" +msgid "" +"Returns a Geometry in HEXEWKB format (as text) using either little-endian " +"(NDR) or big-endian (XDR) encoding." msgstr "" -#. Tag: para -#: reference_output.xml:65 reference_output.xml:170 reference_output.xml:224 -#: reference_output.xml:436 reference_output.xml:927 +#. Tag: funcsynopsis +#: reference_output.xml:300 #, no-c-format -msgid "&T_support;" +msgid "" +" text ST_AsHEXEWKB " +"geometry g1 " +"text NDRorXDR text ST_AsHEXEWKB geometry g1 " msgstr "" #. Tag: para -#: reference_output.xml:66 reference_output.xml:167 reference_output.xml:221 -#: reference_output.xml:326 reference_output.xml:434 reference_output.xml:493 -#: reference_output.xml:568 reference_output.xml:922 +#: reference_output.xml:317 #, no-c-format -msgid "&Z_support;" +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: title -#: reference_output.xml:71 reference_output.xml:115 reference_output.xml:175 -#: reference_output.xml:229 reference_output.xml:330 reference_output.xml:498 -#: reference_output.xml:572 reference_output.xml:628 reference_output.xml:690 -#: reference_output.xml:748 reference_output.xml:812 reference_output.xml:985 -#: reference_output.xml:1031 reference_output.xml:1072 -#: reference_output.xml:1150 +#. Tag: para +#: reference_output.xml:321 #, no-c-format -msgid "Examples" +msgid "Availability: 1.2.2" msgstr "" #. Tag: programlisting -#: reference_output.xml:73 +#: reference_output.xml:329 #, no-c-format msgid "" -"SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n" +"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" -" 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)" +" 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: title -#: reference_output.xml:79 reference_output.xml:128 reference_output.xml:183 -#: reference_output.xml:236 reference_output.xml:454 reference_output.xml:576 -#: reference_output.xml:761 reference_output.xml:821 reference_output.xml:989 -#: reference_output.xml:1155 -#, no-c-format -msgid "See Also" -msgstr "" - -#. Tag: para -#: reference_output.xml:80 +#: reference_output.xml:339 #, no-c-format -msgid "" -", , , ," +msgid "Other Formats" msgstr "" #. Tag: refname -#: reference_output.xml:91 +#: reference_output.xml:343 #, no-c-format msgid "ST_AsEncodedPolyline" msgstr "" #. Tag: refpurpose -#: reference_output.xml:92 +#: reference_output.xml:344 #, no-c-format msgid "Returns an Encoded Polyline from a LineString geometry." msgstr "" #. Tag: funcprototype -#: reference_output.xml:97 +#: reference_output.xml:349 #, no-c-format msgid "" "text ST_AsEncodedPolyline " @@ -279,7 +689,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:108 +#: reference_output.xml:360 #, no-c-format msgid "" "Returns the geometry as an Encoded Polyline. This format is used by Google " @@ -288,7 +698,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:109 +#: reference_output.xml:361 #, no-c-format msgid "" "Optional precision specifies how many decimal places will " @@ -297,19 +707,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:111 reference_output.xml:807 +#: reference_output.xml:363 reference_output.xml:1025 #, no-c-format msgid "Availability: 2.2.0" msgstr "" #. Tag: para -#: reference_output.xml:116 +#: reference_output.xml:368 #, no-c-format msgid "Basic" msgstr "" #. Tag: programlisting -#: reference_output.xml:117 +#: reference_output.xml:369 #, no-c-format msgid "" "SELECT ST_AsEncodedPolyline(GeomFromEWKT('SRID=4326;LINESTRING(-120.2 " @@ -319,7 +729,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:119 +#: reference_output.xml:371 #, no-c-format msgid "" "Use in conjunction with geography linestring and geography segmentize, and " @@ -327,7 +737,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_output.xml:120 +#: reference_output.xml:372 #, no-c-format msgid "" "-- the SQL for Boston to San Francisco, segments every 100 KM\n" @@ -339,7 +749,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:123 +#: reference_output.xml:375 #, no-c-format msgid "" "javascript will look something like this where $ variable you replace with " @@ -347,7 +757,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_output.xml:124 +#: reference_output.xml:376 #, no-c-format msgid "" "" msgstr "" #. Tag: refname -#: reference_output.xml:135 -#, no-c-format -msgid "ST_AsEWKB" -msgstr "" - -#. Tag: refpurpose -#: reference_output.xml:136 -#, no-c-format -msgid "" -"Return the Well-Known Binary (WKB) representation of the geometry with SRID " -"meta data." -msgstr "" - -#. Tag: funcsynopsis -#: reference_output.xml:140 -#, no-c-format -msgid "" -" bytea ST_AsEWKB " -"geometry g1 bytea ST_AsEWKB geometry g1 text NDR_or_XDR " -msgstr "" - -#. Tag: para -#: reference_output.xml:155 -#, 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:161 -#, 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:164 -#, 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:177 -#, 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:178 -#, 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:184 -#, no-c-format -msgid "" -", , , , " -msgstr "" - -#. Tag: refname -#: reference_output.xml:189 +#: reference_output.xml:387 #, no-c-format -msgid "ST_AsEWKT" +msgid "ST_AsGeobuf" msgstr "" #. Tag: refpurpose -#: reference_output.xml:190 +#: reference_output.xml:389 #, no-c-format -msgid "" -"Return the Well-Known Text (WKT) representation of the geometry with SRID " -"meta data." +msgid "Return a Geobuf representation of a set of rows." msgstr "" #. Tag: funcsynopsis -#: reference_output.xml:194 -#, no-c-format -msgid "" -" text ST_AsEWKT " -"geometry g1 text ST_AsEWKT geography g1 " -msgstr "" - -#. Tag: para -#: reference_output.xml:209 +#: reference_output.xml:392 #, no-c-format msgid "" -"Returns the Well-Known Text representation of the geometry prefixed with the " -"SRID." +" bytea ST_AsGeobuf " +"anyelement set row " +" bytea ST_AsGeobuf anyelement row text geom_name " msgstr "" #. Tag: para -#: reference_output.xml:212 +#: reference_output.xml:408 #, no-c-format msgid "" -"The WKT spec does not include the SRID. To get the OGC WKT format use " -"ST_AsText." +"Return a Geobuf representation (https://github.com/mapbox/geobuf) of a set of rows corresponding " +"to a FeatureCollection. Every input geometry is analyzed to determine " +"maximum precision for optimal storage. Note that Geobuf in its current form " +"cannot be streamed so the full output will be assembled in memory." msgstr "" #. Tag: para -#: reference_output.xml:214 reference_output.xml:733 +#: reference_output.xml:414 reference_output.xml:911 #, no-c-format -msgid "" -"WKT format does not maintain precision so to prevent floating truncation, " -"use ST_AsBinary or ST_AsEWKB format for transport." +msgid "row row data with at least a geometry column." msgstr "" #. Tag: para -#: reference_output.xml:218 +#: reference_output.xml:415 #, no-c-format msgid "" -"ST_AsEWKT is the reverse of . Use to convert to a postgis geometry from " -"ST_AsEWKT representation." +"geom_name is the name of the geometry column in the row " +"data. If NULL it will default to the first found geometry column." msgstr "" #. Tag: para -#: reference_output.xml:220 +#: reference_output.xml:417 reference_output.xml:820 reference_output.xml:920 #, no-c-format -msgid "" -"Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and " -"TIN was introduced." +msgid "Availability: 2.4.0" msgstr "" #. Tag: programlisting -#: reference_output.xml:231 +#: reference_output.xml:422 #, 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" +", , " +" ]]>" msgstr "" #. Tag: refname -#: reference_output.xml:246 +#: reference_output.xml:429 #, no-c-format msgid "ST_AsGeoJSON" msgstr "" #. Tag: refpurpose -#: reference_output.xml:248 +#: reference_output.xml:431 #, no-c-format msgid "Return the geometry as a GeoJSON element." msgstr "" #. Tag: funcsynopsis -#: reference_output.xml:252 +#: reference_output.xml:435 #, no-c-format msgid "" " text ST_AsGeoJSON " -"geometry geom " -"integer " -"maxdecimaldigits=15 integer options=0 text ST_AsGeoJSON geography geogrecord feature " +"text geomcolumnname integer " "maxdecimaldigits=15 integer options=0 text ST_AsGeoJSON integer gj_version geometry geomboolean pretty_bool=false " +" text ST_AsGeoJSON geometry geom integer " "maxdecimaldigits=15 integer options=0 text ST_AsGeoJSON integer gj_version geography geog geography geog integer " "maxdecimaldigits=15 integer options=0 GeoJSON " -"specifications 1.0). 2D and 3D Geometries are both supported. " -"GeoJSON only support SFS 1.1 geometry type (no curve support for example)." +"Return the geometry as a GeoJSON \"geometry\" object, or the row as a " +"GeoJSON \"feature\" object. (Cf GeoJSON specifications RFC 7946). 2D and 3D Geometries are " +"both supported. GeoJSON only support SFS 1.1 geometry types (no curve " +"support for example)." msgstr "" #. Tag: para -#: reference_output.xml:291 +#: reference_output.xml:464 #, 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." +"The maxdecimaldigits argument may be used to reduce the " +"maximum number of decimal places used in output (defaults to 15). If you are " +"using EPSG:4326 and are outputting the geometry only for display, " +"maxdecimaldigits=6 can be a good choice for many maps." msgstr "" #. Tag: para -#: reference_output.xml:293 +#: reference_output.xml:466 #, no-c-format msgid "" -"The third argument may be used to reduce the maximum number of decimal " -"places used in output (defaults to 15)." +"The options argument could be used to add BBOX or CRS in " +"GeoJSON output:" msgstr "" #. Tag: para -#: reference_output.xml:296 +#: reference_output.xml:469 #, no-c-format -msgid "" -"The last 'options' argument could be used to add Bbox or Crs in GeoJSON " -"output:" +msgid "0: means no option (default value)" msgstr "" #. Tag: para -#: reference_output.xml:300 +#: reference_output.xml:473 #, no-c-format -msgid "0: means no option (default value)" +msgid "1: GeoJSON BBOX" msgstr "" #. Tag: para -#: reference_output.xml:304 +#: reference_output.xml:477 #, no-c-format -msgid "1: GeoJSON Bbox" +msgid "2: GeoJSON Short CRS (e.g EPSG:4326)" msgstr "" #. Tag: para -#: reference_output.xml:308 +#: reference_output.xml:481 #, no-c-format -msgid "2: GeoJSON Short CRS (e.g EPSG:4326)" +msgid "4: GeoJSON Long CRS (e.g urn:ogc:def:crs:EPSG::4326)" msgstr "" #. Tag: para -#: reference_output.xml:312 +#: reference_output.xml:486 #, no-c-format -msgid "4: GeoJSON Long CRS (e.g urn:ogc:def:crs:EPSG::4326)" +msgid "Availability: 1.3.4" msgstr "" #. Tag: para -#: reference_output.xml:316 +#: reference_output.xml:488 #, no-c-format -msgid "Version 1: ST_AsGeoJSON(geom) / maxdecimaldigits=15 version=1 options=0" +msgid "Changed: 2.0.0 support default args and named args." msgstr "" #. Tag: para -#: reference_output.xml:317 +#: reference_output.xml:489 #, no-c-format -msgid "Version 2: ST_AsGeoJSON(geom, maxdecimaldigits) / version=1 options=0" +msgid "Changed: 3.0.0 support records as input" msgstr "" #. Tag: para -#: reference_output.xml:318 +#: reference_output.xml:496 +#, no-c-format +msgid "GeoJSON format is popular among web mapping frameworks." +msgstr "" + +#. Tag: ulink +#: reference_output.xml:498 #, no-c-format -msgid "Version 3: ST_AsGeoJSON(geom, maxdecimaldigits, options) / version=1" +msgid "OpenLayers GeoJSON Example" +msgstr "" + +#. Tag: ulink +#: reference_output.xml:499 +#, no-c-format +msgid "Leaflet GeoJSON Example" +msgstr "" + +#. Tag: ulink +#: reference_output.xml:500 +#, no-c-format +msgid "Mapbox GL GeoJSON Example" msgstr "" #. Tag: para -#: reference_output.xml:319 +#: reference_output.xml:503 #, no-c-format msgid "" -"Version 4: ST_AsGeoJSON(gj_version, geom) / maxdecimaldigits=15 options=0" +"You can test and view your GeoJSON data online on geojson.io." msgstr "" #. Tag: para -#: reference_output.xml:320 +#: reference_output.xml:505 #, no-c-format -msgid "Version 5: ST_AsGeoJSON(gj_version, geom, maxdecimaldigits) / options=0" +msgid "To build FeatureCollection:" msgstr "" -#. Tag: para -#: reference_output.xml:321 +#. Tag: programlisting +#: reference_output.xml:506 #, no-c-format -msgid "Version 6: ST_AsGeoJSON(gj_version, geom, maxdecimaldigits, options)" +msgid "" +"select json_build_object(\n" +" 'type', 'FeatureCollection',\n" +" 'features', json_agg(ST_AsGeoJSON(t.*)::json)\n" +" )\n" +"from ( values (1, 'one', 'POINT(1 1)'::geometry),\n" +" (2, 'two', 'POINT(2 2)'),\n" +" (3, 'three', 'POINT(3 3)')\n" +" ) as t(id, name, geom);" msgstr "" -#. Tag: para -#: reference_output.xml:323 +#. Tag: screen +#: reference_output.xml:507 #, no-c-format -msgid "Availability: 1.3.4" +msgid "" +"{\"type\" : \"FeatureCollection\", \"features\" : [{\"type\": \"Feature\", " +"\"geometry\": {\"type\":\"Point\",\"coordinates\":[1,1]}, \"properties\": " +"{\"id\": 1, \"name\": \"one\"}}, {\"type\": \"Feature\", \"geometry\": " +"{\"type\":\"Point\",\"coordinates\":[2,2]}, \"properties\": {\"id\": 2, " +"\"name\": \"two\"}}, {\"type\": \"Feature\", \"geometry\": {\"type\":\"Point" +"\",\"coordinates\":[3,3]}, \"properties\": {\"id\": 3, \"name\": \"three" +"\"}}]}" msgstr "" #. Tag: para -#: reference_output.xml:325 +#: reference_output.xml:509 #, no-c-format -msgid "Changed: 2.0.0 support default args and named args." +msgid "To get Features as records:" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:510 +#, no-c-format +msgid "" +"SELECT ST_AsGeoJSON(t.*)\n" +"FROM (VALUES\n" +" (1, 'one', 'POINT(1 1)'::geometry),\n" +" (2, 'two', 'POINT(2 2)'),\n" +" (3, 'three', 'POINT(3 3)'))\n" +"AS t(id, name, geom);" +msgstr "" + +#. Tag: screen +#: reference_output.xml:511 +#, no-c-format +msgid "" +"st_asgeojson\n" +"-----------------------------------------------------------------------------------------------------------------\n" +" {\"type\": \"Feature\", \"geometry\": {\"type\":\"Point\",\"coordinates\":" +"[1,1]}, \"properties\": {\"id\": 1, \"name\": \"one\"}}\n" +" {\"type\": \"Feature\", \"geometry\": {\"type\":\"Point\",\"coordinates\":" +"[2,2]}, \"properties\": {\"id\": 2, \"name\": \"two\"}}\n" +" {\"type\": \"Feature\", \"geometry\": {\"type\":\"Point\",\"coordinates\":" +"[3,3]}, \"properties\": {\"id\": 3, \"name\": \"three\"}}" msgstr "" #. Tag: para -#: reference_output.xml:331 +#: reference_output.xml:513 #, 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 OpenLayers GeoJSON Example" +"Don't forget to transform your data to WGS84 longitude, latitude to conform " +"with RFC7946:" msgstr "" #. Tag: programlisting -#: reference_output.xml:336 +#: reference_output.xml:514 +#, no-c-format +msgid "SELECT ST_AsGeoJSON(ST_Transform(geom,4326)) from fe_edges limit 1;" +msgstr "" + +#. Tag: screen +#: reference_output.xml:515 #, no-c-format msgid "" -"SELECT ST_AsGeoJSON(the_geom) from fe_edges limit 1;\n" -" st_asgeojson\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]]}" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_output.xml:516 +#, no-c-format +msgid "You can also use it with 3D geometries:" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:517 +#, no-c-format +msgid "SELECT ST_AsGeoJSON('LINESTRING(1 2 3, 4 5 6)');" +msgstr "" + +#. Tag: screen +#: reference_output.xml:518 +#, no-c-format +msgid "{\"type\":\"LineString\",\"coordinates\":[[1,2,3],[4,5,6]]}" +msgstr "" + +#. Tag: para +#: reference_output.xml:523 +#, no-c-format +msgid ", , " msgstr "" #. Tag: refname -#: reference_output.xml:341 +#: reference_output.xml:532 #, no-c-format msgid "ST_AsGML" msgstr "" #. Tag: refpurpose -#: reference_output.xml:342 +#: reference_output.xml:533 #, no-c-format msgid "Return the geometry as a GML version 2 or 3 element." msgstr "" #. Tag: funcsynopsis -#: reference_output.xml:346 +#: reference_output.xml:537 #, no-c-format msgid "" " text ST_AsGML " @@ -771,11 +1129,14 @@ msgid "" "funcdef> geography geog integer " "maxdecimaldigits=15 integer options=0 text ST_AsGML integer version geometry geom integer " +"\">integer options=0 " +"text nprefix=null text " +"id=null " +"text ST_AsGML " +"integer version " +"geometry geom " +"integer " "maxdecimaldigits=15 integer options=0 " "text nprefix=null text ST_AsHEXEWKB " -"geometry g1 " -"text NDRorXDR text ST_AsHEXEWKB geometry g1 " -msgstr "" - -#. Tag: para -#: reference_output.xml:487 -#, 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:491 -#, no-c-format -msgid "Availability: 1.2.2" -msgstr "" - -#. Tag: programlisting -#: reference_output.xml:499 -#, 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:505 +#: reference_output.xml:656 #, no-c-format msgid "ST_AsKML" msgstr "" #. Tag: refpurpose -#: reference_output.xml:507 +#: reference_output.xml:658 #, no-c-format msgid "" "Return the geometry as a KML element. Several variants. Default version=2, " @@ -1114,26 +1414,16 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_output.xml:511 +#: reference_output.xml:662 #, no-c-format msgid "" " text ST_AsKML " "geometry geom " "integer " -"maxdecimaldigits=15 " -" text ST_AsKML " -"geography geog " -"integer " -"maxdecimaldigits=15 " -" text ST_AsKML " -"integer version " -"geometry geom " -"integer " "maxdecimaldigits=15 text nprefix=NULL text ST_AsKML integer version geography geog geography geog integer " "maxdecimaldigits=15 text nprefix=NULL " msgstr "" #. Tag: refname -#: reference_output.xml:584 +#: reference_output.xml:725 #, no-c-format msgid "ST_AsLatLonText" msgstr "" #. Tag: refpurpose -#: reference_output.xml:585 +#: reference_output.xml:726 #, no-c-format msgid "Return the Degrees, Minutes, Seconds representation of the given point." msgstr "" #. Tag: funcprototype -#: reference_output.xml:590 +#: reference_output.xml:731 #, no-c-format msgid "" "text ST_AsLatLonText " @@ -1246,13 +1536,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:601 +#: reference_output.xml:742 #, no-c-format msgid "Returns the Degrees, Minutes, Seconds representation of the point." msgstr "" #. Tag: para -#: reference_output.xml:604 +#: reference_output.xml:745 #, no-c-format msgid "" "It is assumed the point is in a lat/lon projection. The X (lon) and Y (lat) " @@ -1261,7 +1551,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:607 +#: reference_output.xml:748 #, no-c-format msgid "" "The text parameter is a format string containing the format for the " @@ -1272,7 +1562,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:612 +#: reference_output.xml:753 #, no-c-format msgid "" "\"M\", \"S\", and \"C\" are optional. If \"C\" is omitted, degrees are shown " @@ -1283,7 +1573,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:617 +#: reference_output.xml:758 #, no-c-format msgid "" "If the format string is omitted (or zero-length) a default format will be " @@ -1291,19 +1581,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:623 +#: reference_output.xml:764 #, no-c-format msgid "Availability: 2.0" msgstr "" #. Tag: para -#: reference_output.xml:629 +#: reference_output.xml:770 #, no-c-format msgid "Default format." msgstr "" #. Tag: programlisting -#: reference_output.xml:630 +#: reference_output.xml:771 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)'));\n" @@ -1313,13 +1603,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:631 +#: reference_output.xml:772 #, no-c-format msgid "Providing a format (same as the default)." msgstr "" #. Tag: programlisting -#: reference_output.xml:632 +#: reference_output.xml:773 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"C'));\n" @@ -1329,13 +1619,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:633 +#: reference_output.xml:774 #, no-c-format msgid "Characters other than D, M, S, C and . are just passed through." msgstr "" #. Tag: programlisting -#: reference_output.xml:634 +#: reference_output.xml:775 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D degrees, M " @@ -1347,13 +1637,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:635 +#: reference_output.xml:776 #, no-c-format msgid "Signed degrees instead of cardinal directions." msgstr "" #. Tag: programlisting -#: reference_output.xml:636 +#: reference_output.xml:777 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"'));\n" @@ -1363,13 +1653,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:637 +#: reference_output.xml:778 #, no-c-format msgid "Decimal degrees." msgstr "" #. Tag: programlisting -#: reference_output.xml:638 +#: reference_output.xml:779 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D.DDDD degrees " @@ -1380,13 +1670,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:639 +#: reference_output.xml:780 #, no-c-format msgid "Excessively large values are normalized." msgstr "" #. Tag: programlisting -#: reference_output.xml:640 +#: reference_output.xml:781 #, no-c-format msgid "" "SELECT (ST_AsLatLonText('POINT (-302.2342342 -792.32498)'));\n" @@ -1396,215 +1686,349 @@ msgid "" msgstr "" #. Tag: refname -#: reference_output.xml:648 +#: reference_output.xml:790 #, no-c-format -msgid "ST_AsSVG" +msgid "ST_AsMVTGeom" msgstr "" #. Tag: refpurpose -#: reference_output.xml:650 +#: reference_output.xml:792 #, no-c-format msgid "" -"Returns a Geometry in SVG path data given a geometry or geography object." +"Transform a geometry into the coordinate space of a Mapbox Vector Tile." msgstr "" -#. Tag: funcsynopsis -#: reference_output.xml:654 +#. Tag: funcprototype +#: reference_output.xml:796 #, no-c-format msgid "" -" text ST_AsSVG " +"geometry ST_AsMVTGeom " "geometry geom " -"integer rel=0 integer " -"maxdecimaldigits=15 " -" text ST_AsSVG " -"geography geog " -"integer rel=0 integer " -"maxdecimaldigits=15 " +"box2d bounds " +"integer extent=4096 integer " +"buffer=256 boolean clip_geom=true" msgstr "" #. Tag: para -#: reference_output.xml:673 +#: reference_output.xml:810 #, 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 (\";\")." +"Transform a geometry into the coordinate space of a Mapbox Vector Tile of a set of rows " +"corresponding to a Layer. Makes best effort to keep and even correct " +"validity and might collapse geometry into a lower dimension in the process." +msgstr "" + +#. Tag: para +#: reference_output.xml:814 +#, no-c-format +msgid "geom is the geometry to transform." msgstr "" #. Tag: para -#: reference_output.xml:683 +#: reference_output.xml:815 #, 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 http://www.w3.org/TR/SVG/paths." -"html#PathDataBNF" +"bounds is the geometric bounds of the tile contents " +"without buffer." msgstr "" #. Tag: para -#: reference_output.xml:686 +#: reference_output.xml:816 #, no-c-format -msgid "Changed: 2.0.0 to use default args and support named args" +msgid "" +"extent is the tile extent in tile coordinate space as " +"defined by the specification. If NULL it will default to 4096." +msgstr "" + +#. Tag: para +#: reference_output.xml:817 +#, no-c-format +msgid "" +"buffer is the buffer distance in tile coordinate space to " +"optionally clip geometries. If NULL it will default to 256." +msgstr "" + +#. Tag: para +#: reference_output.xml:818 +#, no-c-format +msgid "" +"clip_geom is a boolean to control if geometries should be " +"clipped or encoded as is. If NULL it will default to true." +msgstr "" + +#. Tag: para +#: reference_output.xml:823 +#, no-c-format +msgid "" +"From 3.0, Wagyu can be chosen at configure time to clip and validate MVT " +"polygons. This library is faster and produces more correct results than the " +"GEOS default, but it might drop small polygons." msgstr "" #. Tag: programlisting -#: reference_output.xml:691 +#: reference_output.xml:829 #, no-c-format msgid "" -"SELECT ST_AsSVG(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n" +"" +msgstr "" + +#. Tag: para +#: reference_output.xml:834 +#, no-c-format +msgid "" +", , " msgstr "" #. Tag: refname -#: reference_output.xml:696 +#: reference_output.xml:844 #, no-c-format -msgid "ST_AsText" +msgid "ST_AsMVT" msgstr "" #. Tag: refpurpose -#: reference_output.xml:697 +#: reference_output.xml:846 #, no-c-format msgid "" -"Return the Well-Known Text (WKT) representation of the geometry/geography " -"without SRID metadata." +"Aggregate function returning a Mapbox Vector Tile representation of a set of " +"rows." msgstr "" #. Tag: funcsynopsis -#: reference_output.xml:701 +#: reference_output.xml:849 #, no-c-format msgid "" -" text ST_AsText " -"geometry g1 text ST_AsText geometry g1 integer " -"maxdecimaldigits=15 " -" text ST_AsText " -"geography g1 text ST_AsText geography g1 integer " -"maxdecimaldigits=15 " +" bytea ST_AsMVT " +"anyelement set row " +" bytea ST_AsMVT anyelement row text name bytea " +"ST_AsMVT anyelement " +"row text " +"name integer " +"extent " +"bytea ST_AsMVT " +"anyelement row " +"text name " +"integer extent " +"text geom_name bytea ST_AsMVT anyelement row text name integer extent text geom_name text feature_id_name " msgstr "" #. Tag: para -#: reference_output.xml:726 +#: reference_output.xml:886 #, no-c-format msgid "" -"Returns the Well-Known Text representation of the geometry/geography. " -"Optional argument may be used to reduce the maximum number of decimal digits " -"after floating point used in output (defaults to 15)." +"An aggregate function which returns a binary Mapbox Vector Tile representation of a set of " +"rows corresponding to a tile layer. The rows should contain a geometry " +"column which will be encoded as a feature geometry. The geometry should be " +"in tile coordinate space and valid as per the MVT specification. can be used to transform geometry into tile " +"coordinate space. Other row columns are encoded as feature attributes." msgstr "" #. Tag: para -#: reference_output.xml:730 +#: reference_output.xml:895 #, 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 " +"The Mapbox Vector Tile format can store features with varying sets of attributes. To use " +"this capability supply a JSONB column in the row data containing Json " +"objects one level deep. The keys and values in the JSONB values will be " +"encoded as feature attributes." msgstr "" #. Tag: para -#: reference_output.xml:737 +#: reference_output.xml:901 #, no-c-format msgid "" -"ST_AsText is the reverse of . Use to convert to a postgis geometry from " -"ST_AsText representation." +"Tiles with multiple layers can be created by concatenating multiple calls to " +"this function using ||." msgstr "" #. Tag: para -#: reference_output.xml:740 +#: reference_output.xml:907 #, no-c-format -msgid "Availability: 1.5 - support for geography was introduced." +msgid "" +"Do not call with a GEOMETRYCOLLECTION as an element in " +"the row. However you can use to prepare a " +"geometry collection for inclusion." msgstr "" #. Tag: para -#: reference_output.xml:741 +#: reference_output.xml:912 #, no-c-format -msgid "Enhanced: 2.5 - optional parameter precision introduced." +msgid "" +"name is the name of the layer. Default is the string " +"\"default\"." msgstr "" #. Tag: para -#: reference_output.xml:743 +#: reference_output.xml:913 #, no-c-format -msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" +msgid "" +"extent is the tile extent in screen space as defined by " +"the specification. Default is 4096." msgstr "" -#. Tag: programlisting -#: reference_output.xml:750 +#. Tag: para +#: reference_output.xml:914 #, 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)" +"geom_name is the name of the geometry column in the row " +"data. Default is the first geometry column." msgstr "" #. Tag: para -#: reference_output.xml:752 +#: reference_output.xml:915 #, no-c-format -msgid "Providing the precision is optional." +msgid "" +"feature_id_name is the name of the Feature ID column in " +"the row data. If NULL or negative the Feature ID is not set. The first " +"column matching name and valid type (smallint, integer, bigint) will be used " +"as Feature ID, and any subsequent column will be added as a property. JSON " +"properties are not supported." +msgstr "" + +#. Tag: para +#: reference_output.xml:918 +#, no-c-format +msgid "Enhanced: 3.0 - added support for Feature ID." +msgstr "" + +#. Tag: para +#: reference_output.xml:919 +#, no-c-format +msgid "Enhanced: 2.5.0 - added support parallel query." msgstr "" #. Tag: programlisting -#: reference_output.xml:754 +#: reference_output.xml:925 #, no-c-format msgid "" -"SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'))\n" -" st_astext\n" -"------------------------------\n" -" POINT(111.1111111 1.1111111)\n" -"(1 row)" +"" msgstr "" -#. Tag: programlisting -#: reference_output.xml:756 +#. Tag: para +#: reference_output.xml:931 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_output.xml:939 +#, no-c-format +msgid "ST_AsSVG" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:941 +#, no-c-format +msgid "Returns SVG path data for a geometry." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:945 #, no-c-format msgid "" -"SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'),2)\n" -"st_astext\n" -"--------------------\n" -"POINT(111.11 1.11)\n" -"(1 row)" +" text ST_AsSVG " +"geometry geom " +"integer rel=0 integer " +"maxdecimaldigits=15 " +" text ST_AsSVG " +"geography geog " +"integer rel=0 integer " +"maxdecimaldigits=15 " msgstr "" #. Tag: para -#: reference_output.xml:763 +#: reference_output.xml:964 #, 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:974 +#, 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 http://www.w3.org/TR/SVG/paths." +"html#PathDataBNF" +msgstr "" + +#. Tag: para +#: reference_output.xml:977 +#, no-c-format +msgid "Changed: 2.0.0 to use default args and support named args" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:982 +#, no-c-format +msgid "" +"SELECT ST_AsSVG('POLYGON((0 0,0 1,1 1,1 0,0 0))');\n" +"\n" +" st_assvg\n" +" --------\n" +" M 0 0 L 0 -1 1 -1 1 0 Z" msgstr "" #. Tag: refname -#: reference_output.xml:769 +#: reference_output.xml:987 #, no-c-format msgid "ST_AsTWKB" msgstr "" #. Tag: refpurpose -#: reference_output.xml:770 +#: reference_output.xml:988 #, no-c-format msgid "Returns the geometry as TWKB, aka \"Tiny Well-Known Binary\"" msgstr "" #. Tag: funcsynopsis -#: reference_output.xml:774 +#: reference_output.xml:992 #, no-c-format msgid "" " bytea ST_AsTWKB " @@ -1629,7 +2053,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:798 +#: reference_output.xml:1016 #, no-c-format msgid "" "Returns the geometry in TWKB (Tiny Well-Known Binary) format. TWKB is a " @@ -1639,7 +2063,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:799 +#: reference_output.xml:1017 #, no-c-format msgid "" "The decimal digits parameters control how much precision is stored in the " @@ -1650,7 +2074,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:800 +#: reference_output.xml:1018 #, no-c-format msgid "" "The sizes and bounding boxes parameters control whether optional information " @@ -1661,7 +2085,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:801 +#: reference_output.xml:1019 #, no-c-format msgid "" "The array-input form of the function is used to convert a collection of " @@ -1674,7 +2098,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:803 +#: reference_output.xml:1021 #, no-c-format msgid "" "The format specification is available online at , , text ST_AsX3D " @@ -1752,7 +2176,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:847 +#: reference_output.xml:1065 #, no-c-format msgid "" "Returns a geometry as an X3D xml formatted node element TIN" msgstr "" #. Tag: entry -#: reference_output.xml:909 +#: reference_output.xml:1127 #, no-c-format msgid "TriangleSet2D (Not Yet Implemented)" msgstr "" #. Tag: entry -#: reference_output.xml:910 +#: reference_output.xml:1128 #, no-c-format msgid "IndexedTriangleSet" msgstr "" #. Tag: para -#: reference_output.xml:915 +#: reference_output.xml:1133 #, no-c-format msgid "" "2D geometry support not yet complete. Inner rings currently just drawn as " @@ -1945,7 +2369,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:916 +#: reference_output.xml:1134 #, no-c-format msgid "" "Lots of advancements happening in 3D space particularly with \n" @@ -2046,13 +2470,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_output.xml:936 +#: reference_output.xml:1154 #, no-c-format msgid "Example: An Octagon elevated 3 Units and decimal precision of 6" msgstr "" #. Tag: programlisting -#: reference_output.xml:937 +#: reference_output.xml:1155 #, no-c-format msgid "" "SELECT ST_AsX3D(\n" @@ -2071,13 +2495,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_output.xml:940 +#: reference_output.xml:1158 #, no-c-format msgid "Example: TIN" msgstr "" #. Tag: programlisting -#: reference_output.xml:941 +#: reference_output.xml:1159 #, no-c-format msgid "" "text ST_GeoHash " @@ -2149,7 +2573,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:969 +#: reference_output.xml:1187 #, no-c-format msgid "" "Return a GeoHash representation (maxchars is specified ST_GeoHash returns a GeoHash " @@ -2174,7 +2598,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:973 +#: reference_output.xml:1191 #, no-c-format msgid "" "If maxchars is specified ST_GeoHash returns a GeoHash " @@ -2184,13 +2608,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_output.xml:975 +#: reference_output.xml:1193 #, no-c-format msgid "Availability: 1.4.0" msgstr "" #. Tag: para -#: reference_output.xml:978 +#: reference_output.xml:1196 #, no-c-format msgid "" "ST_GeoHash will not work with geometries that are not in geographic (lon/" @@ -2198,7 +2622,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_output.xml:986 +#: reference_output.xml:1204 #, no-c-format msgid "" "" msgstr "" - -#. Tag: refname -#: reference_output.xml:997 -#, no-c-format -msgid "ST_AsGeobuf" -msgstr "" - -#. Tag: refpurpose -#: reference_output.xml:999 -#, no-c-format -msgid "Return a Geobuf representation of a set of rows." -msgstr "" - -#. Tag: funcsynopsis -#: reference_output.xml:1002 -#, no-c-format -msgid "" -" bytea ST_AsGeobuf " -"anyelement set row " -" bytea ST_AsGeobuf anyelement row text geom_name " -msgstr "" - -#. Tag: para -#: reference_output.xml:1018 -#, no-c-format -msgid "" -"Return a Geobuf representation (https://github.com/mapbox/geobuf) of a set of rows corresponding " -"to a FeatureCollection. Every input geometry is analyzed to determine " -"maximum precision for optimal storage. Note that Geobuf in its current form " -"cannot be streamed so the full output will be assembled in memory." -msgstr "" - -#. Tag: para -#: reference_output.xml:1024 reference_output.xml:1137 -#, no-c-format -msgid "row row data with at least a geometry column." -msgstr "" - -#. Tag: para -#: reference_output.xml:1025 reference_output.xml:1140 -#, no-c-format -msgid "" -"geom_name is the name of the geometry column in the row " -"data. If NULL it will default to the first found geometry column." -msgstr "" - -#. Tag: para -#: reference_output.xml:1027 reference_output.xml:1068 -#: reference_output.xml:1146 -#, no-c-format -msgid "Availability: 2.4.0" -msgstr "" - -#. Tag: programlisting -#: reference_output.xml:1032 -#, no-c-format -msgid "" -"" -msgstr "" - -#. Tag: refname -#: reference_output.xml:1038 -#, no-c-format -msgid "ST_AsMVTGeom" -msgstr "" - -#. Tag: refpurpose -#: reference_output.xml:1040 -#, no-c-format -msgid "" -"Transform a geometry into the coordinate space of a Mapbox Vector Tile." -msgstr "" - -#. Tag: funcprototype -#: reference_output.xml:1044 -#, no-c-format -msgid "" -"geometry ST_AsMVTGeom " -"geometry geom " -"box2d bounds " -"integer extent=4096 integer " -"buffer=256 boolean clip_geom=true" -msgstr "" - -#. Tag: para -#: reference_output.xml:1058 -#, no-c-format -msgid "" -"Transform a geometry into the coordinate space of a Mapbox Vector Tile of a set of rows " -"corresponding to a Layer. Makes best effort to keep and even correct " -"validity and might collapse geometry into a lower dimension in the process." -msgstr "" - -#. Tag: para -#: reference_output.xml:1062 -#, no-c-format -msgid "geom is the geometry to transform." -msgstr "" - -#. Tag: para -#: reference_output.xml:1063 -#, no-c-format -msgid "" -"bounds is the geometric bounds of the tile contents " -"without buffer." -msgstr "" - -#. Tag: para -#: reference_output.xml:1064 -#, no-c-format -msgid "" -"extent is the tile extent in tile coordinate space as " -"defined by the specification. If NULL it will default to 4096." -msgstr "" - -#. Tag: para -#: reference_output.xml:1065 -#, no-c-format -msgid "" -"buffer is the buffer distance in tile coordinate space to " -"optionally clip geometries. If NULL it will default to 256." -msgstr "" - -#. Tag: para -#: reference_output.xml:1066 -#, no-c-format -msgid "" -"clip_geom is a boolean to control if geometries should be " -"clipped or encoded as is. If NULL it will default to true." -msgstr "" - -#. Tag: programlisting -#: reference_output.xml:1073 -#, no-c-format -msgid "" -"" -msgstr "" - -#. Tag: refname -#: reference_output.xml:1079 -#, no-c-format -msgid "ST_AsMVT" -msgstr "" - -#. Tag: refpurpose -#: reference_output.xml:1081 -#, no-c-format -msgid "" -"Return a Mapbox Vector " -"Tile representation of a set of rows." -msgstr "" - -#. Tag: funcsynopsis -#: reference_output.xml:1084 -#, no-c-format -msgid "" -" bytea ST_AsMVT " -"anyelement set row " -" bytea ST_AsMVT anyelement row text name bytea " -"ST_AsMVT anyelement " -"row text " -"name integer " -"extent " -"bytea ST_AsMVT " -"anyelement row " -"text name " -"integer extent " -"text geom_name bytea ST_AsMVT anyelement row text name integer extent text geom_name text feature_id_name " -msgstr "" - -#. Tag: para -#: reference_output.xml:1121 -#, no-c-format -msgid "" -"Return a Mapbox Vector " -"Tile representation of a set of rows corresponding to a Layer. " -"Multiple calls can be concatenated to a tile with multiple Layers. Geometry " -"is assumed to be in tile coordinate space and valid as per specification. Typically can be used to transform " -"geometry into tile coordinate space. Other row data will be encoded as " -"attributes." -msgstr "" - -#. Tag: para -#: reference_output.xml:1128 -#, no-c-format -msgid "" -"The Mapbox Vector Tile format can store features with a different set of attributes per " -"feature. To make use of this feature supply a JSONB column in the row data " -"containing Json objects one level deep. The keys and values in the object " -"will be parsed into feature attributes." -msgstr "" - -#. Tag: para -#: reference_output.xml:1134 -#, no-c-format -msgid "" -"Do not call with a GEOMETRYCOLLECTION as an element in " -"the row. However you can use to prep a " -"geometry collection for inclusion." -msgstr "" - -#. Tag: para -#: reference_output.xml:1138 -#, no-c-format -msgid "" -"name is the name of the Layer. If NULL it will use the " -"string \"default\"." -msgstr "" - -#. Tag: para -#: reference_output.xml:1139 -#, no-c-format -msgid "" -"extent is the tile extent in screen space as defined by " -"the specification. If NULL it will default to 4096." -msgstr "" - -#. Tag: para -#: reference_output.xml:1141 -#, no-c-format -msgid "" -"feature_id_name is the name of the Feature ID column in " -"the row data. If NULL Feature ID is not set." -msgstr "" - -#. Tag: para -#: reference_output.xml:1144 -#, no-c-format -msgid "Enhanced: 3.0 - added support for Feature ID." -msgstr "" - -#. Tag: para -#: reference_output.xml:1145 -#, no-c-format -msgid "Enhanced: 2.5.0 - added support parallel query." -msgstr "" - -#. Tag: programlisting -#: reference_output.xml:1151 -#, no-c-format -msgid "" -"" -msgstr "" diff --git a/doc/po/templates/reference_processing.xml.pot b/doc/po/templates/reference_processing.xml.pot index 6716f15d1..a5deaf48f 100644 --- a/doc/po/templates/reference_processing.xml.pot +++ b/doc/po/templates/reference_processing.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -41,61 +41,53 @@ msgid "" " geometry ST_Buffer " "geometry g1 " "float radius_of_buffer geometry " -"ST_Buffer geometry " -"g1 float " -"radius_of_buffer integer num_seg_quarter_circle text " +"buffer_style_parameters='' geometry ST_Buffer geometry g1 float " -"radius_of_buffer text buffer_style_parameters geography ST_Buffer geography g1 float " -"radius_of_buffer_in_meters geography ST_Buffer geography g1 float " "radius_of_buffer integer num_seg_quarter_circle geography ST_Buffer geography g1 float " -"radius_of_buffer text buffer_style_parameters radius_of_buffer text buffer_style_parameters geography " +"ST_Buffer geography " +"g1 float " +"radius_of_buffer integer num_seg_quarter_circle " msgstr "" #. Tag: title -#: reference_processing.xml:61 reference_processing.xml:296 -#: reference_processing.xml:375 reference_processing.xml:429 -#: reference_processing.xml:494 reference_processing.xml:643 -#: reference_processing.xml:709 reference_processing.xml:792 -#: reference_processing.xml:891 reference_processing.xml:971 -#: reference_processing.xml:1029 reference_processing.xml:1098 -#: reference_processing.xml:1145 reference_processing.xml:1193 -#: reference_processing.xml:1276 reference_processing.xml:1343 -#: reference_processing.xml:1385 reference_processing.xml:1444 -#: reference_processing.xml:1491 reference_processing.xml:1545 -#: reference_processing.xml:1582 reference_processing.xml:1642 -#: reference_processing.xml:1694 reference_processing.xml:1752 -#: reference_processing.xml:1909 reference_processing.xml:1947 -#: reference_processing.xml:2021 reference_processing.xml:2075 -#: reference_processing.xml:2131 reference_processing.xml:2182 -#: reference_processing.xml:2224 reference_processing.xml:2265 -#: reference_processing.xml:2312 reference_processing.xml:2360 -#: reference_processing.xml:2416 reference_processing.xml:2543 -#: reference_processing.xml:2627 reference_processing.xml:2710 -#: reference_processing.xml:2765 reference_processing.xml:2834 -#: reference_processing.xml:2902 reference_processing.xml:2990 +#: reference_processing.xml:50 reference_processing.xml:285 +#: reference_processing.xml:375 reference_processing.xml:491 +#: reference_processing.xml:539 reference_processing.xml:687 +#: reference_processing.xml:760 reference_processing.xml:844 +#: reference_processing.xml:943 reference_processing.xml:1025 +#: reference_processing.xml:1088 reference_processing.xml:1197 +#: reference_processing.xml:1289 reference_processing.xml:1358 +#: reference_processing.xml:1400 reference_processing.xml:1460 +#: reference_processing.xml:1507 reference_processing.xml:1561 +#: reference_processing.xml:1598 reference_processing.xml:1658 +#: reference_processing.xml:1711 reference_processing.xml:1765 +#: reference_processing.xml:1918 reference_processing.xml:1960 +#: reference_processing.xml:1998 reference_processing.xml:2072 +#: reference_processing.xml:2126 reference_processing.xml:2182 +#: reference_processing.xml:2233 reference_processing.xml:2274 +#: reference_processing.xml:2315 reference_processing.xml:2361 +#: reference_processing.xml:2409 reference_processing.xml:2465 +#: reference_processing.xml:2592 reference_processing.xml:2673 +#: reference_processing.xml:2763 reference_processing.xml:2840 +#: reference_processing.xml:2908 reference_processing.xml:2996 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_processing.xml:63 +#: reference_processing.xml:52 #, no-c-format msgid "" "Returns a geometry/geography that represents all points whose distance from " @@ -103,7 +95,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:65 +#: reference_processing.xml:54 #, no-c-format msgid "" "Geometry: Calculations are in the Spatial Reference System of the geometry. " @@ -112,7 +104,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:68 +#: reference_processing.xml:57 #, no-c-format msgid "" "Negative radii: For polygons, a negative radius can be used, which will " @@ -120,7 +112,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:69 +#: reference_processing.xml:58 #, no-c-format msgid "" "Geography: For geography this is really a thin wrapper around the geometry " @@ -132,7 +124,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:71 +#: reference_processing.xml:60 #, no-c-format msgid "" "For geography this may not behave as expected if object is sufficiently " @@ -140,7 +132,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:73 +#: reference_processing.xml:62 #, no-c-format msgid "" "Enhanced: 2.5.0 - ST_Buffer geometry support was enhanced to allow for side " @@ -148,18 +140,17 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:74 +#: reference_processing.xml:63 #, 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." +"wrapper for geography was added." msgstr "" #. Tag: para -#: reference_processing.xml:77 +#: reference_processing.xml:66 #, no-c-format msgid "" "The optional third parameter (currently only applies to geometry) can either " @@ -169,7 +160,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:81 reference_processing.xml:1780 +#: reference_processing.xml:70 reference_processing.xml:1788 #, no-c-format msgid "" "'quad_segs=#' : number of segments used to approximate a quarter circle " @@ -177,25 +168,23 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:84 +#: reference_processing.xml:73 #, 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'." +"'endcap=round|flat|square' : endcap style (defaults to \"round\"). 'butt' is " +"also accepted as a synonym for 'flat'." msgstr "" #. Tag: para -#: reference_processing.xml:87 +#: reference_processing.xml:76 reference_processing.xml:1791 #, 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'." +"'join=round|mitre|bevel' : join style (defaults to \"round\"). 'miter' is " +"also accepted as a synonym for 'mitre'." msgstr "" #. Tag: para -#: reference_processing.xml:90 +#: reference_processing.xml:79 #, no-c-format msgid "" "'mitre_limit=#.#' : mitre ratio limit (only affects mitered join style). " @@ -203,7 +192,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:93 +#: reference_processing.xml:82 #, no-c-format msgid "" "'side=both|left|right' : 'left' or 'right' performs a single-sided buffer on " @@ -213,13 +202,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:99 +#: reference_processing.xml:88 #, no-c-format msgid "Units of radius are measured in units of the spatial reference system." msgstr "" #. Tag: para -#: reference_processing.xml:100 +#: reference_processing.xml:89 #, no-c-format msgid "" "The inputs can be POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, " @@ -227,7 +216,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:101 +#: reference_processing.xml:90 #, no-c-format msgid "" "This function ignores the third dimension (z) and will always give a 2-d " @@ -235,29 +224,34 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:103 reference_processing.xml:383 -#: reference_processing.xml:1795 reference_processing.xml:2191 -#: reference_processing.xml:2785 +#: reference_processing.xml:92 reference_processing.xml:499 +#: reference_processing.xml:854 reference_processing.xml:1422 +#: reference_processing.xml:1517 reference_processing.xml:1672 +#: reference_processing.xml:1719 reference_processing.xml:1779 +#: reference_processing.xml:1803 reference_processing.xml:2003 +#: reference_processing.xml:2242 reference_processing.xml:2683 +#: reference_processing.xml:2786 reference_processing.xml:2926 +#: reference_processing.xml:3017 #, no-c-format msgid "Performed by the GEOS module." msgstr "" #. Tag: para -#: reference_processing.xml:104 reference_processing.xml:662 -#: reference_processing.xml:902 reference_processing.xml:1303 -#: reference_processing.xml:2554 reference_processing.xml:2794 +#: reference_processing.xml:93 reference_processing.xml:709 +#: reference_processing.xml:952 reference_processing.xml:1313 +#: reference_processing.xml:2600 reference_processing.xml:2793 #, no-c-format msgid "&sfs_compliant; s2.1.1.3" msgstr "" #. Tag: para -#: reference_processing.xml:105 +#: reference_processing.xml:94 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.17" msgstr "" #. Tag: para -#: reference_processing.xml:107 +#: reference_processing.xml:96 #, no-c-format msgid "" "People often make the mistake of using this function to try to do radius " @@ -266,34 +260,35 @@ msgid "" msgstr "" #. Tag: title -#: reference_processing.xml:112 reference_processing.xml:313 -#: reference_processing.xml:391 reference_processing.xml:462 -#: reference_processing.xml:532 reference_processing.xml:668 -#: reference_processing.xml:758 reference_processing.xml:909 -#: reference_processing.xml:1113 reference_processing.xml:1204 -#: reference_processing.xml:1307 reference_processing.xml:1354 -#: reference_processing.xml:1460 reference_processing.xml:1511 -#: reference_processing.xml:1557 reference_processing.xml:1602 -#: reference_processing.xml:1715 reference_processing.xml:1804 -#: reference_processing.xml:2042 reference_processing.xml:2100 -#: reference_processing.xml:2153 reference_processing.xml:2197 -#: reference_processing.xml:2237 reference_processing.xml:2283 -#: reference_processing.xml:2330 reference_processing.xml:2387 -#: reference_processing.xml:2440 reference_processing.xml:2562 -#: reference_processing.xml:2643 reference_processing.xml:2801 -#: reference_processing.xml:2926 reference_processing.xml:3017 +#: reference_processing.xml:101 reference_processing.xml:302 +#: reference_processing.xml:405 reference_processing.xml:506 +#: reference_processing.xml:577 reference_processing.xml:715 +#: reference_processing.xml:810 reference_processing.xml:959 +#: reference_processing.xml:1101 reference_processing.xml:1225 +#: reference_processing.xml:1317 reference_processing.xml:1369 +#: reference_processing.xml:1476 reference_processing.xml:1527 +#: reference_processing.xml:1573 reference_processing.xml:1618 +#: reference_processing.xml:1728 reference_processing.xml:1812 +#: reference_processing.xml:1930 reference_processing.xml:2093 +#: reference_processing.xml:2151 reference_processing.xml:2204 +#: reference_processing.xml:2247 reference_processing.xml:2287 +#: reference_processing.xml:2332 reference_processing.xml:2379 +#: reference_processing.xml:2436 reference_processing.xml:2489 +#: reference_processing.xml:2608 reference_processing.xml:2689 +#: reference_processing.xml:2800 reference_processing.xml:2932 +#: reference_processing.xml:3023 #, no-c-format msgid "Examples" msgstr "" #. Tag: para -#: reference_processing.xml:123 +#: reference_processing.xml:112 #, no-c-format msgid "quad_segs=8 (default)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:126 +#: reference_processing.xml:115 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -302,13 +297,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:134 +#: reference_processing.xml:123 #, no-c-format msgid "quad_segs=2 (lame)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:137 +#: reference_processing.xml:126 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -317,13 +312,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:146 +#: reference_processing.xml:135 #, no-c-format msgid "endcap=round join=round (default)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:149 +#: reference_processing.xml:138 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -333,13 +328,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:157 +#: reference_processing.xml:146 #, no-c-format msgid "endcap=square" msgstr "" #. Tag: programlisting -#: reference_processing.xml:160 +#: reference_processing.xml:149 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -349,13 +344,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:168 +#: reference_processing.xml:157 #, no-c-format msgid "endcap=flat" msgstr "" #. Tag: programlisting -#: reference_processing.xml:171 +#: reference_processing.xml:160 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -365,13 +360,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:180 +#: reference_processing.xml:169 #, no-c-format msgid "join=bevel" msgstr "" #. Tag: programlisting -#: reference_processing.xml:183 +#: reference_processing.xml:172 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -381,13 +376,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:191 +#: reference_processing.xml:180 #, no-c-format msgid "join=mitre mitre_limit=5.0 (default mitre limit)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:194 +#: reference_processing.xml:183 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -397,13 +392,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:202 +#: reference_processing.xml:191 #, no-c-format msgid "join=mitre mitre_limit=1" msgstr "" #. Tag: programlisting -#: reference_processing.xml:205 +#: reference_processing.xml:194 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -413,13 +408,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:214 +#: reference_processing.xml:203 #, no-c-format msgid "side=left" msgstr "" #. Tag: programlisting -#: reference_processing.xml:217 +#: reference_processing.xml:206 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -429,13 +424,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:225 +#: reference_processing.xml:214 #, no-c-format msgid "side=right" msgstr "" #. Tag: programlisting -#: reference_processing.xml:228 +#: reference_processing.xml:217 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -445,13 +440,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:236 +#: reference_processing.xml:225 #, no-c-format msgid "side=left join=mitre" msgstr "" #. Tag: programlisting -#: reference_processing.xml:239 +#: reference_processing.xml:228 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -461,13 +456,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:248 +#: reference_processing.xml:237 #, no-c-format msgid "right-hand-winding, polygon boundary side=left" msgstr "" #. Tag: programlisting -#: reference_processing.xml:251 +#: reference_processing.xml:240 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -479,13 +474,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:258 +#: reference_processing.xml:247 #, no-c-format msgid "right-hand-winding, polygon boundary side=right" msgstr "" #. Tag: programlisting -#: reference_processing.xml:261 +#: reference_processing.xml:250 #, no-c-format msgid "" "SELECT ST_Buffer(\n" @@ -497,7 +492,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:268 +#: reference_processing.xml:257 #, no-c-format msgid "" "--A buffered point approximates a circle\n" @@ -532,33 +527,32 @@ msgid "" msgstr "" #. Tag: title -#: reference_processing.xml:272 reference_processing.xml:347 -#: reference_processing.xml:395 reference_processing.xml:469 -#: reference_processing.xml:621 reference_processing.xml:684 -#: reference_processing.xml:765 reference_processing.xml:866 -#: reference_processing.xml:949 reference_processing.xml:1008 -#: reference_processing.xml:1076 reference_processing.xml:1120 -#: reference_processing.xml:1162 reference_processing.xml:1321 -#: reference_processing.xml:1363 reference_processing.xml:1417 -#: reference_processing.xml:1467 reference_processing.xml:1506 -#: reference_processing.xml:1524 reference_processing.xml:1552 -#: reference_processing.xml:1594 reference_processing.xml:1666 -#: reference_processing.xml:1721 reference_processing.xml:1886 -#: reference_processing.xml:1925 reference_processing.xml:1995 -#: reference_processing.xml:2049 reference_processing.xml:2107 -#: reference_processing.xml:2158 reference_processing.xml:2202 -#: reference_processing.xml:2242 reference_processing.xml:2288 -#: reference_processing.xml:2335 reference_processing.xml:2394 -#: reference_processing.xml:2511 reference_processing.xml:2603 -#: reference_processing.xml:2680 reference_processing.xml:2733 -#: reference_processing.xml:2808 reference_processing.xml:2862 -#: reference_processing.xml:2951 reference_processing.xml:3070 +#: reference_processing.xml:261 reference_processing.xml:336 +#: reference_processing.xml:468 reference_processing.xml:510 +#: reference_processing.xml:666 reference_processing.xml:735 +#: reference_processing.xml:817 reference_processing.xml:918 +#: reference_processing.xml:1000 reference_processing.xml:1042 +#: reference_processing.xml:1246 reference_processing.xml:1336 +#: reference_processing.xml:1378 reference_processing.xml:1433 +#: reference_processing.xml:1483 reference_processing.xml:1522 +#: reference_processing.xml:1540 reference_processing.xml:1568 +#: reference_processing.xml:1610 reference_processing.xml:1683 +#: reference_processing.xml:1734 reference_processing.xml:1894 +#: reference_processing.xml:1936 reference_processing.xml:1976 +#: reference_processing.xml:2046 reference_processing.xml:2100 +#: reference_processing.xml:2158 reference_processing.xml:2209 +#: reference_processing.xml:2252 reference_processing.xml:2292 +#: reference_processing.xml:2337 reference_processing.xml:2384 +#: reference_processing.xml:2443 reference_processing.xml:2560 +#: reference_processing.xml:2649 reference_processing.xml:2726 +#: reference_processing.xml:2811 reference_processing.xml:2868 +#: reference_processing.xml:2957 reference_processing.xml:3076 #, no-c-format msgid "See Also" msgstr "" #. Tag: para -#: reference_processing.xml:274 +#: reference_processing.xml:263 #, no-c-format msgid "" ", , , geometry ST_BuildArea " @@ -588,7 +582,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:298 +#: reference_processing.xml:287 #, no-c-format msgid "" "Creates an areal geometry formed by the constituent linework of given " @@ -599,32 +593,32 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:303 +#: reference_processing.xml:292 #, no-c-format msgid "This function will assume all inner geometries represent holes" msgstr "" #. Tag: para -#: reference_processing.xml:306 reference_processing.xml:1654 +#: reference_processing.xml:295 reference_processing.xml:1670 #, no-c-format msgid "" "Input linework must be correctly noded for this function to work properly" msgstr "" #. Tag: para -#: reference_processing.xml:309 +#: reference_processing.xml:298 #, no-c-format -msgid "Availability: 1.1.0 - requires GEOS >= 2.1.0." +msgid "Availability: 1.1.0" msgstr "" #. Tag: para -#: reference_processing.xml:323 +#: reference_processing.xml:312 #, no-c-format msgid "This will create a donut" msgstr "" #. Tag: programlisting -#: reference_processing.xml:326 +#: reference_processing.xml:315 #, no-c-format msgid "" "SELECT ST_BuildArea(ST_Collect(smallc,bigc))\n" @@ -635,14 +629,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:335 +#: reference_processing.xml:324 #, no-c-format msgid "" "This will create a gaping hole inside the circle with prongs sticking out" msgstr "" #. Tag: programlisting -#: reference_processing.xml:338 +#: reference_processing.xml:327 #, no-c-format msgid "" "SELECT ST_BuildArea(ST_Collect(line,circle))\n" @@ -664,7 +658,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:349 +#: reference_processing.xml:338 #, no-c-format msgid "" ", , , " @@ -673,250 +667,206 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:360 +#: reference_processing.xml:349 #, no-c-format -msgid "ST_ClipByBox2D" +msgid "ST_Centroid" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:361 +#: reference_processing.xml:351 #, no-c-format -msgid "Returns the portion of a geometry falling within a rectangle." +msgid "Returns the geometric center of a geometry." msgstr "" -#. Tag: funcprototype -#: reference_processing.xml:366 +#. Tag: funcsynopsis +#: reference_processing.xml:355 #, no-c-format msgid "" -"geometry ST_ClipByBox2D " -"geometry geom " -"box2d box" +" geometry ST_Centroid " +"geometry g1 geography ST_Centroid geography g1 boolean " +"use_spheroid=true " msgstr "" #. Tag: para #: reference_processing.xml:377 #, no-c-format msgid "" -"Clips a geometry by a 2D box in a fast but possibly dirty way. The output " -"geometry is not guaranteed to be valid (self-intersections for a polygon may " -"be introduced). Topologically invalid input geometries do not result in " -"exceptions being thrown." +"Computes the geometric center of a geometry, or equivalently, the center of " +"mass of the geometry as a POINT. For [MULTI]POINTs, this is computed as the arithmetic mean " +"of the input coordinates. For [MULTI]LINESTRINGs, this is computed as the weighted length of each line segment. For " +"[MULTI]POLYGONs, \"weight\" is thought " +"in terms of area. If an empty geometry is supplied, an empty " +"GEOMETRYCOLLECTION is returned. If NULL is supplied, NULL is returned. If " +"CIRCULARSTRING or COMPOUNDCURVE are " +"supplied, they are converted to linestring wtih CurveToLine first, then same " +"than for LINESTRING" msgstr "" #. Tag: para -#: reference_processing.xml:384 +#: reference_processing.xml:392 #, no-c-format -msgid "Requires GEOS 3.5.0+" +msgid "" +"New in 2.3.0 : support CIRCULARSTRING and " +"COMPOUNDCURVE (using CurveToLine)" msgstr "" #. Tag: para -#: reference_processing.xml:386 +#: reference_processing.xml:394 #, no-c-format -msgid "Availability: 2.2.0 - requires GEOS >= 3.5.0." +msgid "Availability: 2.4.0 support for geography was introduced." msgstr "" -#. Tag: programlisting -#: reference_processing.xml:392 +#. Tag: para +#: reference_processing.xml:396 #, no-c-format msgid "" -"-- Rely on implicit cast from geometry to box2d for the second parameter\n" -"SELECT ST_ClipByBox2D(the_geom, ST_MakeEnvelope(0,0,10,10)) FROM mytab;" +"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_processing.xml:396 +#: reference_processing.xml:400 reference_processing.xml:802 #, no-c-format -msgid ", , " +msgid "&sfs_compliant;" msgstr "" -#. Tag: refname -#: reference_processing.xml:406 +#. Tag: para +#: reference_processing.xml:401 #, no-c-format -msgid "ST_Collect" +msgid "&sqlmm_compliant; SQL-MM 3: 8.1.4, 9.5.5" msgstr "" -#. Tag: refpurpose +#. Tag: para #: reference_processing.xml:407 #, no-c-format msgid "" -"Return a specified ST_Geometry value from a collection of other geometries." +"In each of the following illustrations, the green dot represents the " +"centroid of the source geometry." msgstr "" -#. Tag: funcsynopsis -#: reference_processing.xml:411 +#. Tag: para +#: reference_processing.xml:420 #, no-c-format -msgid "" -" geometry ST_Collect " -"geometry set g1field geometry " -"ST_Collect geometry " -"g1 geometry " -"g2 " -"geometry ST_Collect " -"geometry[] g1_array " -"" +msgid "Centroid of a MULTIPOINT" msgstr "" #. Tag: para -#: reference_processing.xml:430 +#: reference_processing.xml:431 #, 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." +msgid "Centroid of a LINESTRING" msgstr "" #. Tag: para -#: reference_processing.xml:434 +#: reference_processing.xml:444 #, 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." +msgid "Centroid of a POLYGON" msgstr "" #. Tag: para -#: reference_processing.xml:442 +#: reference_processing.xml:455 #, 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." +msgid "Centroid of a GEOMETRYCOLLECTION" msgstr "" -#. Tag: para -#: reference_processing.xml:446 +#. Tag: programlisting +#: reference_processing.xml:464 #, no-c-format msgid "" -"ST_Collect and ST_Union are often interchangeable except that ST_Collect " -"will always return a GeometryCollection or MULTI geometry and ST_Union may " -"return single geometries when it dissolves boundaries. ST_Union will also " -"split linestrings at node intersections, whereas ST_Collect will never split " -"linestrings and in turn just return as MULTILINESTRING. To prevent " -"ST_Collect from returning a Geometry Collection when collecting MULTI " -"geometries, one can use the below trick that utilizes to expand the MULTIs out to singles and then regroup them." +"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)\n" +"\n" +"SELECT ST_AsText(ST_centroid(g))\n" +"FROM ST_GeomFromText('CIRCULARSTRING(0 2, -1 1,0 0, 0.5 0, 1 0, 2 1, 1 2, " +"0.5 2, 0 2)') AS g ;\n" +"------------------------------------------\n" +"POINT(0.5 1)\n" +"\n" +"\n" +"SELECT ST_AsText(ST_centroid(g))\n" +"FROM ST_GeomFromText('COMPOUNDCURVE(CIRCULARSTRING(0 2, -1 1,0 0),(0 0, 0.5 " +"0, 1 0),CIRCULARSTRING( 1 0, 2 1, 1 2),(1 2, 0.5 2, 0 2))' ) AS g;\n" +"------------------------------------------\n" +"POINT(0.5 1)" msgstr "" #. Tag: para -#: reference_processing.xml:454 +#: reference_processing.xml:470 #, no-c-format -msgid "" -"Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was " -"enhanced to handle more geometries faster." +msgid ", " msgstr "" -#. Tag: para -#: reference_processing.xml:455 reference_processing.xml:664 -#: reference_processing.xml:752 reference_processing.xml:804 -#: reference_processing.xml:995 reference_processing.xml:1050 -#: reference_processing.xml:1108 reference_processing.xml:1149 -#: reference_processing.xml:1348 reference_processing.xml:1412 -#: reference_processing.xml:1455 reference_processing.xml:1701 -#: reference_processing.xml:1921 reference_processing.xml:2033 -#: reference_processing.xml:2091 reference_processing.xml:2720 -#: reference_processing.xml:2854 +#. Tag: refname +#: reference_processing.xml:476 #, no-c-format -msgid "&Z_support;" +msgid "ST_ClipByBox2D" msgstr "" -#. Tag: para -#: reference_processing.xml:456 +#. Tag: refpurpose +#: reference_processing.xml:477 #, 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." +msgid "Returns the portion of a geometry falling within a rectangle." msgstr "" -#. Tag: para -#: reference_processing.xml:463 reference_processing.xml:2802 +#. Tag: funcprototype +#: reference_processing.xml:482 #, no-c-format -msgid "Aggregate example" +msgid "" +"geometry ST_ClipByBox2D " +"geometry geom " +"box2d box" msgstr "" -#. Tag: programlisting -#: reference_processing.xml:464 +#. Tag: para +#: reference_processing.xml:493 #, no-c-format msgid "" -"SELECT stusps, 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" +"Clips a geometry by a 2D box in a fast but possibly dirty way. The output " +"geometry is not guaranteed to be valid (self-intersections for a polygon may " +"be introduced). Topologically invalid input geometries do not result in " +"exceptions being thrown." msgstr "" #. Tag: para -#: reference_processing.xml:465 reference_processing.xml:2804 +#: reference_processing.xml:501 reference_processing.xml:1970 +#: reference_processing.xml:2283 reference_processing.xml:2432 +#: reference_processing.xml:2684 #, no-c-format -msgid "Non-Aggregate example" +msgid "Availability: 2.2.0" msgstr "" #. Tag: programlisting -#: reference_processing.xml:466 +#: reference_processing.xml:507 #, 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))" +"-- Rely on implicit cast from geometry to box2d for the second parameter\n" +"SELECT ST_ClipByBox2D(the_geom, ST_MakeEnvelope(0,0,10,10)) FROM mytab;" msgstr "" #. Tag: para -#: reference_processing.xml:470 +#: reference_processing.xml:511 #, no-c-format -msgid ", " +msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:477 +#: reference_processing.xml:522 #, no-c-format msgid "ST_ConcaveHull" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:478 +#: reference_processing.xml:523 #, no-c-format msgid "" "The concave hull of a geometry represents a possibly concave geometry that " @@ -925,7 +875,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:484 +#: reference_processing.xml:529 #, no-c-format msgid "" "geometry ST_ConcaveHull " @@ -936,7 +886,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:495 +#: reference_processing.xml:540 #, no-c-format msgid "" "The concave hull of a geometry represents a possibly concave geometry that " @@ -945,7 +895,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:499 +#: reference_processing.xml:544 #, no-c-format msgid "" "The target_percent is the target percent of area of convex hull the PostGIS " @@ -959,7 +909,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:504 +#: reference_processing.xml:549 #, no-c-format msgid "" "It is usually used with MULTI and Geometry Collections. Although it is not " @@ -969,7 +919,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:509 +#: reference_processing.xml:554 #, no-c-format msgid "" "It is much slower to compute than convex hull but encloses the geometry " @@ -977,15 +927,15 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:512 reference_processing.xml:660 -#: reference_processing.xml:898 reference_processing.xml:1298 -#: reference_processing.xml:2550 +#: reference_processing.xml:557 reference_processing.xml:707 +#: reference_processing.xml:950 reference_processing.xml:1308 +#: reference_processing.xml:2599 #, no-c-format msgid "Performed by the GEOS module" msgstr "" #. Tag: para -#: reference_processing.xml:513 +#: reference_processing.xml:558 #, no-c-format msgid "" "Note - If you are using with points, linestrings, or geometry collections " @@ -994,7 +944,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:516 +#: reference_processing.xml:561 #, no-c-format msgid "" "Note - The smaller you make the target percent, the longer it takes to " @@ -1011,7 +961,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:521 +#: reference_processing.xml:566 #, no-c-format msgid "" "More real world examples and brief explanation of the technique are shown " @@ -1020,7 +970,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:524 +#: reference_processing.xml:569 #, no-c-format msgid "" "Also check out Simon Greener's article on demonstrating ConcaveHull " @@ -1033,14 +983,16 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:528 reference_processing.xml:1147 -#: reference_processing.xml:2427 +#: reference_processing.xml:573 reference_processing.xml:1027 +#: reference_processing.xml:1424 reference_processing.xml:1720 +#: reference_processing.xml:2004 reference_processing.xml:2476 +#: reference_processing.xml:2862 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: programlisting -#: reference_processing.xml:533 +#: reference_processing.xml:578 #, no-c-format msgid "" "--Get estimate of infected area based on point observations\n" @@ -1051,13 +1003,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:543 +#: reference_processing.xml:588 #, no-c-format msgid "ST_ConcaveHull of 2 polygons encased in target 100% shrink concave hull" msgstr "" #. Tag: programlisting -#: reference_processing.xml:546 +#: reference_processing.xml:591 #, no-c-format msgid "" "-- geometries overlaid with concavehull\n" @@ -1073,14 +1025,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:553 +#: reference_processing.xml:598 #, no-c-format msgid "" "-- geometries overlaid with concavehull at target 90% of convex hull area" msgstr "" #. Tag: programlisting -#: reference_processing.xml:557 +#: reference_processing.xml:602 #, no-c-format msgid "" "-- geometries overlaid with concavehull at target 90% shrink\n" @@ -1094,13 +1046,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:566 +#: reference_processing.xml:611 #, no-c-format msgid "L Shape points overlaid with convex hull" msgstr "" #. Tag: programlisting -#: reference_processing.xml:569 +#: reference_processing.xml:614 #, no-c-format msgid "" "-- this produces a table of 42 points that form an L shape\n" @@ -1117,13 +1069,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:576 +#: reference_processing.xml:621 #, no-c-format msgid "ST_ConcaveHull of L points at target 99% of convex hull" msgstr "" #. Tag: programlisting -#: reference_processing.xml:579 +#: reference_processing.xml:624 #, no-c-format msgid "" "SELECT ST_ConcaveHull(ST_Collect(geom), 0.99)\n" @@ -1131,13 +1083,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:588 +#: reference_processing.xml:633 #, no-c-format msgid "Concave Hull of L points at target 80% convex hull area" msgstr "" #. Tag: programlisting -#: reference_processing.xml:591 +#: reference_processing.xml:636 #, no-c-format msgid "" "-- Concave Hull L shape points\n" @@ -1147,13 +1099,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:600 +#: reference_processing.xml:645 #, no-c-format msgid "multilinestring overlaid with Convex hull" msgstr "" #. Tag: para -#: reference_processing.xml:608 +#: reference_processing.xml:653 #, no-c-format msgid "" "multilinestring with overlaid with Concave hull of linestrings at 99% target " @@ -1161,7 +1113,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:612 +#: reference_processing.xml:657 #, no-c-format msgid "" "SELECT ST_ConcaveHull(ST_GeomFromText('MULTILINESTRING((106 164,30 112,74 " @@ -1176,7 +1128,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:622 +#: reference_processing.xml:667 #, no-c-format msgid "" ", , The convex hull of a geometry represents the minimum convex " -"geometry that encloses all geometries within the set." +msgid "Computes the convex hull of a geometry." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:635 +#: reference_processing.xml:679 #, no-c-format msgid "" "geometry ST_ConvexHull " @@ -1206,66 +1156,68 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:644 +#: reference_processing.xml:688 #, no-c-format msgid "" -"The convex hull of a geometry represents the minimum convex geometry " -"that encloses all geometries within the set." +"Computes the convex hull of a geometry. The convex hull is the smallest " +"convex geometry that encloses all geometries in the input." msgstr "" #. Tag: para -#: reference_processing.xml:647 +#: reference_processing.xml:692 #, 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." +"In the general case the convex hull is a Polygon. The convext hull of two or " +"more collinear points is a two-point LineString. The convex hull of one or " +"more identical points is a Point." msgstr "" #. Tag: para -#: reference_processing.xml:651 +#: reference_processing.xml:696 #, 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))." +"It is usually used with Multi* and GeometryCollections. It is not an " +"aggregate function. To compute the convex hull of a set of geometries, use " +" to aggregate them." msgstr "" #. Tag: para -#: reference_processing.xml:656 +#: reference_processing.xml:701 #, no-c-format msgid "" -"It is often used to determine an affected area based on a set of point " +"One can think of the convex hull as the geometry obtained by wrapping an " +"elastic band around a set of geometries. This is different from a concave " +"hull which is analogous to \"shrink-wrapping\" the geometries. A convex hull " +"is often used to determine an affected area based on a set of point " "observations." msgstr "" #. Tag: para -#: reference_processing.xml:663 +#: reference_processing.xml:710 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.16" msgstr "" -#. Tag: programlisting -#: reference_processing.xml:669 +#. Tag: para +#: reference_processing.xml:711 reference_processing.xml:804 +#: reference_processing.xml:856 reference_processing.xml:1029 +#: reference_processing.xml:1221 reference_processing.xml:1363 +#: reference_processing.xml:1428 reference_processing.xml:1471 +#: reference_processing.xml:1718 reference_processing.xml:1926 +#: reference_processing.xml:1972 reference_processing.xml:2084 +#: reference_processing.xml:2142 reference_processing.xml:2860 #, 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;" +msgid "&Z_support;" msgstr "" #. Tag: para -#: reference_processing.xml:677 +#: reference_processing.xml:723 #, no-c-format -msgid "" -"Convex Hull of a MultiLinestring and a MultiPoint seen together with the " -"MultiLinestring and MultiPoint" +msgid "Convex Hull of a MultiLinestring and a MultiPoint" msgstr "" #. Tag: programlisting -#: reference_processing.xml:680 +#: reference_processing.xml:726 #, no-c-format msgid "" "SELECT ST_AsText(ST_ConvexHull(\n" @@ -1280,7 +1232,24 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:685 +#: reference_processing.xml:729 +#, no-c-format +msgid "Using with ST_Collect to compute the convex hulls of geometry sets." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:731 +#, 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:736 #, no-c-format msgid "" ", , geometry ST_CurveToLine " @@ -1312,16 +1283,16 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:711 +#: reference_processing.xml:762 #, no-c-format msgid "" -"Converts a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON. " -"Useful for outputting to devices that can't support CIRCULARSTRING geometry " -"types" +"Converts a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON " +"or MULTISURFACE to MULTIPOLYGON. Useful for outputting to devices that can't " +"support CIRCULARSTRING geometry types" msgstr "" #. Tag: para -#: reference_processing.xml:713 +#: reference_processing.xml:764 #, no-c-format msgid "" "Converts a given geometry to a linear geometry. Each curved geometry or " @@ -1330,7 +1301,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:718 +#: reference_processing.xml:769 #, no-c-format msgid "" "The 'tolerance_type' argument determines interpretation of the `tolerance` " @@ -1338,37 +1309,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:723 +#: reference_processing.xml:774 #, no-c-format msgid "0 (default): Tolerance is max segments per quadrant." msgstr "" #. Tag: para -#: reference_processing.xml:726 +#: reference_processing.xml:777 #, no-c-format msgid "1: Tolerance is max-deviation of line from curve, in source units." msgstr "" #. Tag: para -#: reference_processing.xml:729 +#: reference_processing.xml:780 #, no-c-format msgid "2: Tolerance is max-angle, in radians, between generating radii." msgstr "" #. Tag: para -#: reference_processing.xml:734 +#: reference_processing.xml:785 #, no-c-format msgid "The 'flags' argument is a bitfield. 0 by default. Supported bits are:" msgstr "" #. Tag: para -#: reference_processing.xml:739 +#: reference_processing.xml:790 #, no-c-format msgid "1: Symmetric (orientation idependent) output." msgstr "" #. Tag: para -#: reference_processing.xml:742 +#: reference_processing.xml:793 #, no-c-format msgid "" "2: Retain angle, avoids reducing angles (segment lengths) when producing " @@ -1376,13 +1347,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:747 reference_processing.xml:1347 +#: reference_processing.xml:798 reference_processing.xml:1362 #, no-c-format msgid "Availability: 1.3.0" msgstr "" #. Tag: para -#: reference_processing.xml:748 +#: reference_processing.xml:799 #, no-c-format msgid "" "Enhanced: 2.4.0 added support for max-deviation and max-angle tolerance, and " @@ -1390,27 +1361,28 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:750 +#: reference_processing.xml:800 #, no-c-format -msgid "&sfs_compliant;" +msgid "" +"Enhanced: 3.0.0 implemented a minimum number of segments per linearized arc " +"to prevent topological collapse." msgstr "" #. Tag: para -#: reference_processing.xml:751 +#: reference_processing.xml:803 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 7.1.7" msgstr "" #. Tag: para -#: reference_processing.xml:753 reference_processing.xml:992 -#: reference_processing.xml:1047 reference_processing.xml:1148 -#: reference_processing.xml:1349 reference_processing.xml:2719 +#: reference_processing.xml:805 reference_processing.xml:1028 +#: reference_processing.xml:1364 #, no-c-format msgid "&curve_support;" msgstr "" #. Tag: programlisting -#: reference_processing.xml:760 +#: reference_processing.xml:812 #, no-c-format msgid "" "SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 " @@ -1530,19 +1502,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:773 +#: reference_processing.xml:825 #, no-c-format msgid "ST_DelaunayTriangles" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:775 +#: reference_processing.xml:827 #, no-c-format msgid "Return a Delaunay triangulation around the given input points." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:782 +#: reference_processing.xml:834 #, no-c-format msgid "" "geometry ST_DelaunayTriangles " @@ -1552,7 +1524,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:794 +#: reference_processing.xml:846 #, no-c-format msgid "" "Return a " +msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:874 +#: reference_processing.xml:926 #, no-c-format msgid "ST_Difference" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:876 +#: reference_processing.xml:928 #, no-c-format msgid "" "Returns a geometry that represents that part of geometry A that does not " @@ -1715,7 +1686,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:882 +#: reference_processing.xml:934 #, no-c-format msgid "" "geometry ST_Difference " @@ -1724,7 +1695,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:893 +#: reference_processing.xml:945 #, no-c-format msgid "" "Returns a geometry that represents that part of geometry A that does not " @@ -1734,25 +1705,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:896 -#, no-c-format -msgid "Note - order matters. B - A will always return a portion of B" -msgstr "" - -#. Tag: para -#: reference_processing.xml:900 reference_processing.xml:2552 +#: reference_processing.xml:948 #, no-c-format -msgid "Do not call with a GeometryCollection as an argument" +msgid "Order matters. B - A will always return a portion of B" msgstr "" #. Tag: para -#: reference_processing.xml:903 +#: reference_processing.xml:953 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.20" msgstr "" #. Tag: para -#: reference_processing.xml:904 reference_processing.xml:2556 +#: reference_processing.xml:954 reference_processing.xml:2602 #, no-c-format msgid "" "&Z_support; However it seems to only consider x y when doing the difference " @@ -1760,27 +1725,32 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:921 +#: reference_processing.xml:971 #, no-c-format msgid "The original linestrings shown together." msgstr "" #. Tag: para -#: reference_processing.xml:933 +#: reference_processing.xml:983 #, no-c-format msgid "The difference of the two linestrings" msgstr "" +#. Tag: para +#: reference_processing.xml:992 +#, no-c-format +msgid "" +"Safe for 2D. This is same geometries as what is shown for st_symdifference" +msgstr "" + #. Tag: programlisting -#: reference_processing.xml:942 +#: reference_processing.xml:993 #, 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" +" 'LINESTRING(50 100, 50 200)'::geometry,\n" +" 'LINESTRING(50 50, 50 150)'::geometry\n" " )\n" " );\n" "\n" @@ -1789,685 +1759,274 @@ msgid "" "LINESTRING(50 150,50 200)" msgstr "" -#. Tag: programlisting -#: reference_processing.xml:944 -#, 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:957 -#, no-c-format -msgid "ST_Dump" -msgstr "" - -#. Tag: refpurpose -#: reference_processing.xml:958 -#, 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:963 -#, no-c-format -msgid "" -"geometry_dump[] ST_Dump " -"geometry g1" -msgstr "" - #. Tag: para -#: reference_processing.xml:972 +#: reference_processing.xml:995 #, 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:981 -#, 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:985 reference_processing.xml:1045 -#, no-c-format -msgid "" -"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " -"introduced." -msgstr "" - -#. Tag: para -#: reference_processing.xml:986 -#, no-c-format -msgid "Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher." -msgstr "" - -#. Tag: para -#: reference_processing.xml:988 -#, 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:993 reference_processing.xml:1048 -#: reference_processing.xml:1151 reference_processing.xml:1920 -#: reference_processing.xml:2036 reference_processing.xml:2722 -#, no-c-format -msgid "&P_support;" -msgstr "" - -#. Tag: title -#: reference_processing.xml:999 -#, no-c-format -msgid "Standard Examples" +msgid "When used in 3d doesn't quite do the right thing." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1000 +#: reference_processing.xml:996 #, 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:1002 reference_processing.xml:1070 -#, no-c-format -msgid "Polyhedral Surfaces, TIN and Triangle Examples" -msgstr "" - -#. Tag: programlisting -#: reference_processing.xml:1003 -#, 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:1005 -#, 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))" +"select ST_AsEWKT(\n" +" ST_Difference(\n" +" 'MULTIPOINT(-118.58 38.38 5,-118.60 38.329 6,-118.614 38.281 " +"7)' :: geometry,\n" +" 'POINT(-118.614 38.281 5)' :: geometry\n" +" )\n" +" );\n" +"st_asewkt\n" +"---------\n" +"MULTIPOINT(-118.6 38.329 6,-118.58 38.38 5)" msgstr "" #. Tag: para -#: reference_processing.xml:1009 +#: reference_processing.xml:1002 reference_processing.xml:2651 #, no-c-format -msgid "" -", , , , " +msgid ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:1015 +#: reference_processing.xml:1008 #, no-c-format -msgid "ST_DumpPoints" +msgid "ST_FlipCoordinates" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1016 +#: reference_processing.xml:1009 #, no-c-format msgid "" -"Returns a set of geometry_dump (geom,path) rows of all points that make up a " -"geometry." +"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:1021 -#, no-c-format -msgid "" -"geometry_dump[]ST_DumpPoints " -"geometry geom" -msgstr "" - -#. Tag: para -#: reference_processing.xml:1030 -#, no-c-format -msgid "" -"This set-returning function (SRF) returns a set of geometry_dump rows formed by a geometry (geom) and an array of " -"integers (path)." -msgstr "" - -#. Tag: para -#: reference_processing.xml:1033 +#: reference_processing.xml:1017 #, no-c-format msgid "" -"The geom component of geometry_dump are all the POINTs that make up the supplied " -"geometry" +"geometry ST_FlipCoordinates " +"geometry geom" msgstr "" #. Tag: para -#: reference_processing.xml:1036 +#: reference_processing.xml:1026 #, no-c-format -msgid "" -"The path component of geometry_dump (an integer[]) is an index reference enumerating " -"the POINTs of the supplied geometry. For example, if a " -"LINESTRING is supplied, a path of {i} " -"is returned where i is the nth " -"coordinate in the LINESTRING. If a POLYGON is supplied, a path of {i,j} is returned where " -"i is the ring number (1 is outer; inner rings follow) and " -"j enumerates the POINTs (again 1-based " -"index)." +msgid "Returns a version of the given geometry with X and Y axis flipped." msgstr "" #. Tag: para -#: reference_processing.xml:1044 +#: reference_processing.xml:1030 reference_processing.xml:1222 #, no-c-format -msgid "Enhanced: 2.1.0 Faster speed. Reimplemented as native-C." +msgid "&M_support;" msgstr "" #. Tag: para -#: reference_processing.xml:1046 -#, no-c-format -msgid "Availability: 1.5.0" -msgstr "" - -#. Tag: title -#: reference_processing.xml:1053 +#: reference_processing.xml:1031 reference_processing.xml:1971 +#: reference_processing.xml:2087 #, no-c-format -msgid "Classic Explode a Table of LineStrings into nodes" -msgstr "" - -#. Tag: programlisting -#: reference_processing.xml:1054 -#, 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)" +msgid "&P_support;" msgstr "" #. Tag: title -#: reference_processing.xml:1057 +#: reference_processing.xml:1036 #, no-c-format -msgid "Standard Geometry Examples" +msgid "Example" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1067 +#: reference_processing.xml:1037 #, 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:1071 +#. Tag: refname +#: reference_processing.xml:1050 #, 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)" +msgid "ST_GeneratePoints" msgstr "" -#. Tag: programlisting -#: reference_processing.xml:1072 +#. Tag: refpurpose +#: reference_processing.xml:1052 #, 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)" +"Converts a polygon or multi-polygon into a multi-point composed of randomly " +"location points within the original areas." msgstr "" -#. Tag: programlisting -#: reference_processing.xml:1073 +#. Tag: funcsynopsis +#: reference_processing.xml:1056 #, 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)" +" geometry ST_GeneratePoints g geometry npoints integer geometry " +"ST_GeneratePoints g geometry npoints integer seed integer " msgstr "" #. Tag: para -#: reference_processing.xml:1077 -#, no-c-format -msgid "" -", , , " -msgstr "" - -#. Tag: refname -#: reference_processing.xml:1082 -#, no-c-format -msgid "ST_DumpRings" -msgstr "" - -#. Tag: refpurpose -#: reference_processing.xml:1084 +#: reference_processing.xml:1090 #, no-c-format msgid "" -"Returns a set of geometry_dump rows, representing the " -"exterior and interior rings of a polygon." +"ST_GeneratePoints generates pseudo-random points until the requested number " +"are found within the input area. The optional seed must be greater than " +"zero, and is used to regenerate a deterministic sequence of points." msgstr "" -#. Tag: funcprototype -#: reference_processing.xml:1090 +#. Tag: para +#: reference_processing.xml:1096 reference_processing.xml:1219 +#: reference_processing.xml:2140 reference_processing.xml:2927 +#: reference_processing.xml:3018 #, no-c-format -msgid "" -"geometry_dump[] ST_DumpRings " -"geometry a_polygon" +msgid "Availability: 2.3.0" msgstr "" #. Tag: para -#: reference_processing.xml:1100 +#: reference_processing.xml:1097 #, no-c-format -msgid "" -"This is a set-returning function (SRF). It returns a set of " -"geometry_dump rows, defined as an integer[] and a geometry, 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." +msgid "Enhanced: 3.0.0, added seed parameter" msgstr "" #. Tag: para -#: reference_processing.xml:1106 +#: reference_processing.xml:1113 #, no-c-format -msgid "Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher." +msgid "Original Polygon" msgstr "" #. Tag: para -#: reference_processing.xml:1107 +#: reference_processing.xml:1124 #, no-c-format msgid "" -"This only works for POLYGON geometries. It will not work for MULTIPOLYGONS" +"Generated 12 Points overlaid on top of original polygon using a random seed " +"value 1996" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1115 +#: reference_processing.xml:1127 #, 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:1122 -#, no-c-format -msgid "" -", , , , " +"SELECT ST_GeneratePoints(geom, 12, 1996)\n" +"FROM (\n" +" SELECT ST_Buffer(\n" +" ST_GeomFromText(\n" +" 'LINESTRING(50 50,150 150,150 50)'),\n" +" 10, 'endcap=round join=round') AS geom\n" +") AS s;" msgstr "" #. Tag: refname -#: reference_processing.xml:1128 +#: reference_processing.xml:1138 #, no-c-format -msgid "ST_FlipCoordinates" +msgid "ST_GeometricMedian" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1129 +#: reference_processing.xml:1142 #, 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." +msgid "Returns the geometric median of a MultiPoint." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1137 +#: reference_processing.xml:1149 #, no-c-format msgid "" -"geometry ST_FlipCoordinates " -"geometry geom" -msgstr "" - -#. Tag: para -#: reference_processing.xml:1146 -#, no-c-format -msgid "Returns a version of the given geometry with X and Y axis flipped." +"geometry ST_GeometricMedian " +" geometry g " +" float8 tolerance int max_iter boolean " +"fail_if_not_converged " msgstr "" #. Tag: para -#: reference_processing.xml:1150 reference_processing.xml:2721 -#, no-c-format -msgid "&M_support;" -msgstr "" - -#. Tag: title -#: reference_processing.xml:1156 reference_processing.xml:2727 -#, no-c-format -msgid "Example" -msgstr "" - -#. Tag: programlisting -#: reference_processing.xml:1157 +#: reference_processing.xml:1199 #, no-c-format msgid "" -"" +"Computes the approximate geometric median of a MultiPoint geometry using the " +"Weiszfeld algorithm. The geometric median provides a centrality measure that " +"is less sensitive to outlier points than the centroid." msgstr "" -#. Tag: refname -#: reference_processing.xml:1170 -#, no-c-format -msgid "ST_GeneratePoints" -msgstr "" - -#. Tag: refpurpose -#: reference_processing.xml:1172 -#, no-c-format -msgid "" -"Converts a polygon or multi-polygon into a multi-point composed of randomly " -"location points within the original areas." -msgstr "" - -#. Tag: funcprototype -#: reference_processing.xml:1177 +#. Tag: para +#: reference_processing.xml:1205 #, no-c-format msgid "" -"geometry ST_GeneratePoints " -" g geometry " -" npoints numeric " +"The algorithm will iterate until the distance change between successive " +"iterations is less than the supplied tolerance parameter. " +"If this condition has not been met after max_iterations " +"iterations, the function will produce an error and exit, unless " +"fail_if_not_converged is set to false." msgstr "" #. Tag: para -#: reference_processing.xml:1195 +#: reference_processing.xml:1212 #, no-c-format msgid "" -"ST_GeneratePoints generates pseudo-random points until the requested number " -"are found within the input area." +"If a tolerance value is not provided, a default tolerance " +"value will be calculated based on the extent of the input geometry." msgstr "" #. Tag: para -#: reference_processing.xml:1200 reference_processing.xml:2089 +#: reference_processing.xml:1216 #, no-c-format -msgid "Availability: 2.3.0" +msgid "M value of points, if present, is interpreted as their relative weight." msgstr "" #. Tag: para -#: reference_processing.xml:1216 +#: reference_processing.xml:1220 #, no-c-format -msgid "Original Polygon" +msgid "Enhanced: 2.5.0 Added support for M as weight of points." msgstr "" #. Tag: para -#: reference_processing.xml:1227 +#: reference_processing.xml:1234 #, no-c-format -msgid "Generated 12 Points overlaid on top of original polygon" +msgid "" +"Comparison of the centroid (turquoise point) and geometric median (red " +"point) of a four-point MultiPoint (yellow points)." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1230 +#: reference_processing.xml:1242 #, no-c-format msgid "" -"SELECT ST_GeneratePoints(\n" -" ST_Buffer(\n" -" ST_GeomFromText(\n" -" 'LINESTRING(50 50,150 150,150 50)'\n" -" ), 10, 'endcap=round join=round'), 12);" +"WITH test AS (\n" +"SELECT 'MULTIPOINT((0 0), (1 1), (2 2), (200 200))'::geometry geom)\n" +"SELECT\n" +" ST_AsText(ST_Centroid(geom)) centroid,\n" +" ST_AsText(ST_GeometricMedian(geom)) median\n" +"FROM test;\n" +" centroid | median\n" +"--------------------+----------------------------------------\n" +" POINT(50.75 50.75) | POINT(1.9761550281255 1.9761550281255)\n" +"(1 row)" msgstr "" #. Tag: refname -#: reference_processing.xml:1242 +#: reference_processing.xml:1255 #, no-c-format msgid "ST_Intersection" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1244 +#: reference_processing.xml:1257 #, no-c-format msgid "" "(T) Returns a geometry that represents the shared portion of geomA and geomB." msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:1250 +#: reference_processing.xml:1263 #, no-c-format msgid "" " geometry ST_IntersectionGEOMETRYCOLLECTION as an argument" -msgstr "" - -#. Tag: para -#: reference_processing.xml:1294 +#: reference_processing.xml:1304 #, no-c-format msgid "This function will drop the M coordinate values if present." msgstr "" #. Tag: para -#: reference_processing.xml:1296 +#: reference_processing.xml:1306 #, no-c-format msgid "" "If working with 3D geometries, you may want to use SFGCAL based which does a proper 3D intersection for 3D " "geometries. Although this function works with Z-coordinate, it does an " -"averaging of Z-Coordinate values when postgis.backend=geos. " -"postgis.backend=sfcgal, it will return a 2D geometry regardless " -"ignoring the Z-Coordinate. Refer to for " -"details." +"averaging of Z-Coordinate." msgstr "" #. Tag: para -#: reference_processing.xml:1299 +#: reference_processing.xml:1310 #, no-c-format -msgid "&sfcgal_enhanced;" +msgid "Availability: 1.5 support for geography data type was introduced." msgstr "" #. Tag: para -#: reference_processing.xml:1301 +#: reference_processing.xml:1311 reference_processing.xml:2791 #, no-c-format -msgid "Availability: 1.5 support for geography data type was introduced." +msgid "Changed: 3.0.0 does not depend on SFCGAL." msgstr "" #. Tag: para -#: reference_processing.xml:1304 +#: reference_processing.xml:1314 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.18" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1308 +#: reference_processing.xml:1318 #, no-c-format msgid "" "SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, " @@ -2578,130 +2128,122 @@ msgid "" " st_astext\n" "---------------\n" "GEOMETRYCOLLECTION EMPTY\n" -"(1 row)\n" +"\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));" +"POINT(0 0)" msgstr "" -#. Tag: title -#: reference_processing.xml:1312 +#. Tag: para +#: reference_processing.xml:1319 #, no-c-format -msgid "Examples: 2.5Dish" +msgid "" +"Clip all lines (trails) by country. Hhere we assume country geom are POLYGON " +"or MULTIPOLYGONS. NOTE: we are only keeping intersections that result in a " +"LINESTRING or MULTILINESTRING because we don't care about trails that just " +"share a point. The dump is needed to expand a geometry collection into " +"individual single MULT* parts. The below is fairly generic and will work for " +"polys, etc. by just changing the where clause." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1324 +#, no-c-format +msgid "" +"select clipped.gid, clipped.f_name, clipped_geom\n" +"from (\n" +" select trails.gid, trails.f_name,\n" +" (ST_Dump(ST_Intersection(country.geom, trails.geom))).geom " +"clipped_geom\n" +" from country\n" +" inner join trails on ST_Intersects(country.geom, trails.geom)\n" +" ) as clipped\n" +"where ST_Dimension(clipped.clipped_geom) = 1;" msgstr "" #. Tag: para -#: reference_processing.xml:1313 +#: reference_processing.xml:1325 #, no-c-format msgid "" -"Geos is the default backend if not set. Note this is not a true " -"intersection, compare to the same example using ." +"For polys e.g. polygon landmarks, you can also use the sometimes faster hack " +"that buffering anything by 0.0 except a polygon results in an empty geometry " +"collection. (So a geometry collection containing polys, lines and points " +"buffered by 0.0 would only leave the polygons and dissolve the collection " +"shell.)" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1314 +#: reference_processing.xml:1327 #, no-c-format msgid "" -"set postgis.backend=geos;\n" -"select ST_AsText(ST_Intersection(linestring, polygon)) As wkt\n" -"from ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 " -"10)') AS linestring\n" -" CROSS JOIN ST_GeomFromText('POLYGON((0 0 8, 0 1 8, 1 1 8, 1 0 8, 0 0 8))') " -"AS polygon;\n" -"\n" -" st_astext\n" -"---------------------------------------\n" -" LINESTRING Z (1 1 8,0.5 0.5 8,0 0 10)" +"select poly.gid,\n" +" ST_Multi(\n" +" ST_Buffer(\n" +" ST_Intersection(country.geom, poly.geom),\n" +" 0.0\n" +" )\n" +" ) clipped_geom\n" +"from country\n" +" inner join poly on ST_Intersects(country.geom, poly.geom)\n" +"where not ST_IsEmpty(ST_Buffer(ST_Intersection(country.geom, poly.geom), " +"0.0));" +msgstr "" + +#. Tag: title +#: reference_processing.xml:1331 +#, no-c-format +msgid "Examples: 2.5Dish" msgstr "" #. Tag: para -#: reference_processing.xml:1316 +#: reference_processing.xml:1332 #, no-c-format msgid "" -"If your PostGIS is compiled with sfcgal support, have option of using " -"sfcgal, but note if basically cases down both geometries to 2D before doing " -"intersection and returns the ST_Force2D equivalent result which is a 2D " -"geometry" +"Note this is not a true intersection, compare to the same example using " +"." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1318 +#: reference_processing.xml:1333 #, no-c-format msgid "" -"set postgis.backend=sfcgal;\n" "select ST_AsText(ST_Intersection(linestring, polygon)) As wkt\n" "from ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 " "10)') AS linestring\n" " CROSS JOIN ST_GeomFromText('POLYGON((0 0 8, 0 1 8, 1 1 8, 1 0 8, 0 0 8))') " "AS polygon;\n" "\n" -" wkt\n" -"----------------------------------------------\n" -" MULTILINESTRING((0.5 0.5,0 0),(1 1,0.5 0.5))" +" st_astext\n" +"---------------------------------------\n" +" LINESTRING Z (1 1 8,0.5 0.5 8,0 0 10)" msgstr "" #. Tag: para -#: reference_processing.xml:1322 +#: reference_processing.xml:1337 #, no-c-format msgid "" -", , , , , , , " +", , , , , , , , " msgstr "" #. Tag: refname -#: reference_processing.xml:1328 +#: reference_processing.xml:1343 #, no-c-format msgid "ST_LineToCurve" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1330 +#: reference_processing.xml:1345 #, no-c-format msgid "Converts a LINESTRING/POLYGON to a CIRCULARSTRING, CURVEPOLYGON" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1335 +#: reference_processing.xml:1350 #, no-c-format msgid "" "geometry ST_LineToCurve " @@ -2710,7 +2252,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1345 +#: reference_processing.xml:1360 #, no-c-format msgid "" "Converts plain LINESTRING/POLYGON to CIRCULAR STRINGs and Curved Polygons. " @@ -2718,7 +2260,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1346 +#: reference_processing.xml:1361 #, no-c-format msgid "" "If the input LINESTRING/POLYGON is not curved enough to clearly represent a " @@ -2726,7 +2268,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1356 +#: reference_processing.xml:1371 #, no-c-format msgid "" "-- 2D Example\n" @@ -2778,19 +2320,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1371 +#: reference_processing.xml:1386 #, no-c-format msgid "ST_MakeValid" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1372 +#: reference_processing.xml:1387 #, no-c-format msgid "Attempts to make an invalid geometry valid without losing vertices." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1377 +#: reference_processing.xml:1392 #, no-c-format msgid "" "geometry ST_MakeValid " @@ -2798,7 +2340,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1386 +#: reference_processing.xml:1401 #, no-c-format msgid "" "The function attempts to create a valid representation of a given invalid " @@ -2807,7 +2349,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1392 +#: reference_processing.xml:1407 #, no-c-format msgid "" "Supported inputs are: POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, " @@ -2815,7 +2357,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1398 +#: reference_processing.xml:1413 #, no-c-format msgid "" "In case of full or partial dimensional collapses, the output geometry may be " @@ -2824,38 +2366,32 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1404 +#: reference_processing.xml:1419 #, no-c-format msgid "" "Single polygons may become multi-geometries in case of self-intersections." msgstr "" #. Tag: para -#: reference_processing.xml:1408 +#: reference_processing.xml:1425 #, no-c-format -msgid "Availability: 2.0.0, requires GEOS-3.3.0" +msgid "Enhanced: 2.0.1, speed improvements" msgstr "" #. Tag: para -#: reference_processing.xml:1409 +#: reference_processing.xml:1426 #, no-c-format -msgid "Enhanced: 2.0.1, speed improvements requires GEOS-3.3.4" -msgstr "" - -#. Tag: para -#: reference_processing.xml:1410 -#, no-c-format -msgid "Enhanced: 2.1.0 added support for GEOMETRYCOLLECTION and MULTIPOINT." +msgid "Enhanced: 2.1.0, added support for GEOMETRYCOLLECTION and MULTIPOINT." msgstr "" #. Tag: refname -#: reference_processing.xml:1427 +#: reference_processing.xml:1443 #, no-c-format msgid "ST_MemUnion" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1429 +#: reference_processing.xml:1445 #, no-c-format msgid "" "Same as ST_Union, only memory-friendly (uses less memory and more processor " @@ -2863,7 +2399,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1435 +#: reference_processing.xml:1451 #, no-c-format msgid "" "geometry ST_MemUnion " @@ -2872,13 +2408,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1446 +#: reference_processing.xml:1462 #, no-c-format msgid "Some useful description here." msgstr "" #. Tag: para -#: reference_processing.xml:1450 +#: reference_processing.xml:1466 #, no-c-format msgid "" "Same as ST_Union, only memory-friendly (uses less memory and more processor " @@ -2888,19 +2424,19 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1462 +#: reference_processing.xml:1478 #, no-c-format msgid "See ST_Union" msgstr "" #. Tag: refname -#: reference_processing.xml:1475 +#: reference_processing.xml:1491 #, no-c-format msgid "ST_MinimumBoundingCircle" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1476 +#: reference_processing.xml:1492 #, no-c-format msgid "" "Returns the smallest circle polygon that can fully contain a geometry. " @@ -2908,7 +2444,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1482 +#: reference_processing.xml:1498 #, no-c-format msgid "" "geometry ST_MinimumBoundingCircle " @@ -2918,13 +2454,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1492 +#: reference_processing.xml:1508 #, no-c-format msgid "Returns the smallest circle polygon that can fully contain a geometry." msgstr "" #. Tag: para -#: reference_processing.xml:1493 +#: reference_processing.xml:1509 #, no-c-format msgid "" "The circle is approximated by a polygon with a default of 48 segments per " @@ -2937,7 +2473,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1495 +#: reference_processing.xml:1511 #, no-c-format msgid "" "It is often used with MULTI and Geometry Collections. Although it is not an " @@ -2947,7 +2483,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1500 +#: reference_processing.xml:1516 #, no-c-format msgid "" "The ratio of the area of a polygon divided by the area of its Minimum " @@ -2955,19 +2491,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1502 +#: reference_processing.xml:1518 #, no-c-format -msgid "Availability: 1.4.0 - requires GEOS" +msgid "Availability: 1.4.0" msgstr "" #. Tag: para -#: reference_processing.xml:1507 reference_processing.xml:1525 +#: reference_processing.xml:1523 reference_processing.xml:1541 #, no-c-format msgid ", " msgstr "" #. Tag: programlisting -#: reference_processing.xml:1512 +#: reference_processing.xml:1528 #, no-c-format msgid "" "SELECT d.disease_type,\n" @@ -2977,7 +2513,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1518 +#: reference_processing.xml:1534 #, no-c-format msgid "" "Minimum bounding circle of a point and linestring. Using 8 segs to " @@ -2985,7 +2521,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1521 +#: reference_processing.xml:1537 #, no-c-format msgid "" "SELECT ST_AsText(ST_MinimumBoundingCircle(\n" @@ -3017,13 +2553,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1531 +#: reference_processing.xml:1547 #, no-c-format msgid "ST_MinimumBoundingRadius" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1532 +#: reference_processing.xml:1548 #, no-c-format msgid "" "Returns the center point and radius of the smallest circle that can fully " @@ -3031,7 +2567,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1537 +#: reference_processing.xml:1553 #, no-c-format msgid "" "(geometry, double precision) ST_MinimumBoundingRadius to get the " @@ -3056,19 +2592,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1548 +#: reference_processing.xml:1564 #, no-c-format msgid "Availability - 2.3.0" msgstr "" #. Tag: para -#: reference_processing.xml:1553 +#: reference_processing.xml:1569 #, no-c-format msgid ", " msgstr "" #. Tag: programlisting -#: reference_processing.xml:1558 +#: reference_processing.xml:1574 #, no-c-format msgid "" "SELECT ST_AsText(center), radius FROM " @@ -3081,19 +2617,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1565 +#: reference_processing.xml:1581 #, no-c-format msgid "ST_OrientedEnvelope" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1566 +#: reference_processing.xml:1582 #, no-c-format msgid "Returns a minimum rotated rectangle enclosing a geometry." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1571 +#: reference_processing.xml:1587 #, no-c-format msgid "" "geometry ST_OrientedEnvelope " @@ -3101,7 +2637,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1583 +#: reference_processing.xml:1599 #, no-c-format msgid "" "Returns a mimimum rotated rectangle enclosing a geometry. Note that more " @@ -3110,14 +2646,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1588 reference_processing.xml:2279 -#: reference_processing.xml:2326 +#: reference_processing.xml:1604 reference_processing.xml:2328 +#: reference_processing.xml:2375 #, no-c-format msgid "Availability: 2.5.0" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1603 +#: reference_processing.xml:1619 #, no-c-format msgid "" "SELECT ST_AsText(ST_OrientedEnvelope('MULTIPOINT ((0 0), (-1 -1), (3 " @@ -3130,13 +2666,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1610 +#: reference_processing.xml:1626 #, no-c-format msgid "Oriented envelope of a point and linestring." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1613 +#: reference_processing.xml:1629 #, no-c-format msgid "" "SELECT ST_AsText(ST_OrientedEnvelope(\n" @@ -3152,13 +2688,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1620 +#: reference_processing.xml:1636 #, no-c-format msgid "ST_Polygonize" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1622 +#: reference_processing.xml:1638 #, no-c-format msgid "" "Aggregate. Creates a GeometryCollection containing possible polygons formed " @@ -3166,7 +2702,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:1628 +#: reference_processing.xml:1644 #, no-c-format msgid "" " geometry ST_Polygonize" +msgstr "" + #. Tag: refname -#: reference_processing.xml:1676 +#: reference_processing.xml:1693 #, no-c-format msgid "ST_Node" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1678 +#: reference_processing.xml:1695 #, no-c-format msgid "Node a set of linestrings." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1685 +#: reference_processing.xml:1702 #, no-c-format msgid "" "geometry ST_Node " @@ -3261,7 +2803,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1696 +#: reference_processing.xml:1713 #, no-c-format msgid "" "Fully node a set of linestrings using the least possible number of nodes " @@ -3269,21 +2811,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1703 reference_processing.xml:2856 -#, no-c-format -msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." -msgstr "" - -#. Tag: para -#: reference_processing.xml:1705 -#, 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: para -#: reference_processing.xml:1709 +#: reference_processing.xml:1722 #, no-c-format msgid "" "Changed: 2.4.0 this function uses GEOSNode internally instead of " @@ -3292,7 +2820,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1716 +#: reference_processing.xml:1729 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -3306,13 +2834,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1731 +#: reference_processing.xml:1744 #, no-c-format msgid "ST_OffsetCurve" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1733 +#: reference_processing.xml:1746 #, no-c-format msgid "" "Return an offset line at a given distance and side from an input line. " @@ -3320,7 +2848,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1741 +#: reference_processing.xml:1754 #, no-c-format msgid "" "geometry ST_OffsetCurve " @@ -3331,7 +2859,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1754 +#: reference_processing.xml:1767 #, no-c-format msgid "" "Return an offset line at a given distance and side from an input line. All " @@ -3340,7 +2868,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1760 +#: reference_processing.xml:1773 #, no-c-format msgid "" "For positive distance the offset will be at the left side of the input line " @@ -3349,21 +2877,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1766 +#: reference_processing.xml:1780 #, no-c-format -msgid "" -"Availability: 2.0 - requires GEOS >= 3.2, improved with GEOS >= 3.3" +msgid "Availability: 2.0" msgstr "" #. Tag: para -#: reference_processing.xml:1770 +#: reference_processing.xml:1781 #, no-c-format msgid "" "Enhanced: 2.5 - added support for GEOMETRYCOLLECTION and MULTILINESTRING" msgstr "" #. Tag: para -#: reference_processing.xml:1775 +#: reference_processing.xml:1783 #, no-c-format msgid "" "The optional third parameter allows specifying a list of blank-separated " @@ -3371,15 +2898,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1783 -#, 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:1786 +#: reference_processing.xml:1794 #, no-c-format msgid "" "'mitre_limit=#.#' : mitre ratio limit (only affects mitred join style). " @@ -3387,14 +2906,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1791 +#: reference_processing.xml:1799 #, no-c-format msgid "" "Units of distance are measured in units of the spatial reference system." msgstr "" #. Tag: para -#: reference_processing.xml:1797 +#: reference_processing.xml:1805 #, no-c-format msgid "" "This function ignores the third dimension (z) and will always give a 2-d " @@ -3402,13 +2921,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1805 +#: reference_processing.xml:1813 #, no-c-format msgid "Compute an open buffer around roads" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1806 +#: reference_processing.xml:1814 #, no-c-format msgid "" "SELECT ST_Union(\n" @@ -3419,13 +2938,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1816 +#: reference_processing.xml:1824 #, no-c-format msgid "15, 'quad_segs=4 join=round' original line and its offset 15 units." msgstr "" #. Tag: programlisting -#: reference_processing.xml:1820 +#: reference_processing.xml:1828 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n" @@ -3442,13 +2961,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1827 +#: reference_processing.xml:1835 #, no-c-format msgid "-15, 'quad_segs=4 join=round' original line and its offset -15 units" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1831 +#: reference_processing.xml:1839 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(geom,\n" @@ -3463,7 +2982,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1840 +#: reference_processing.xml:1848 #, no-c-format msgid "" "double-offset to get more curvy, note the first reverses direction, so -30 + " @@ -3471,7 +2990,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1843 +#: reference_processing.xml:1851 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(ST_OffsetCurve(geom,\n" @@ -3489,7 +3008,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1850 +#: reference_processing.xml:1858 #, no-c-format msgid "" "double-offset to get more curvy,combined with regular offset 15 to get " @@ -3497,7 +3016,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1853 +#: reference_processing.xml:1861 #, no-c-format msgid "" "SELECT ST_AsText(ST_Collect(\n" @@ -3521,13 +3040,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1862 +#: reference_processing.xml:1870 #, no-c-format msgid "15, 'quad_segs=4 join=bevel' shown with original line" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1865 +#: reference_processing.xml:1873 #, no-c-format msgid "" "SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n" @@ -3542,13 +3061,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1873 +#: reference_processing.xml:1881 #, no-c-format msgid "15,-15 collected, join=mitre mitre_limit=2.1" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1876 +#: reference_processing.xml:1884 #, no-c-format msgid "" "SELECT ST_AsText(ST_Collect(\n" @@ -3566,19 +3085,100 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:1893 +#: reference_processing.xml:1901 +#, no-c-format +msgid "ST_PointOnSurface" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1903 +#, no-c-format +msgid "Returns a POINT guaranteed to lie on the surface." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1908 +#, no-c-format +msgid "" +"geometry ST_PointOnSurface " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1920 +#, no-c-format +msgid "Returns a POINT guaranteed to intersect a surface." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1922 +#, no-c-format +msgid "&sfs_compliant; s3.2.14.2 // s3.2.18.2" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1923 +#, 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_processing.xml:1932 +#, 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_processing.xml:1938 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1944 #, no-c-format msgid "ST_RemoveRepeatedPoints" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1894 +#: reference_processing.xml:1945 #, no-c-format msgid "Returns a version of the given geometry with duplicated points removed." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1900 +#: reference_processing.xml:1951 #, no-c-format msgid "" "geometry ST_RemoveRepeatedPoints " @@ -3588,7 +3188,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1910 +#: reference_processing.xml:1961 #, no-c-format msgid "" "Returns a version of the given geometry with duplicated points removed. Will " @@ -3599,28 +3199,21 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1916 +#: reference_processing.xml:1967 #, no-c-format msgid "" "If the tolerance parameter is provided, vertices within the tolerance of one " "another will be considered the \"same\" for the purposes of removal." msgstr "" -#. Tag: para -#: reference_processing.xml:1919 reference_processing.xml:2233 -#: reference_processing.xml:2383 reference_processing.xml:2718 -#, no-c-format -msgid "Availability: 2.2.0" -msgstr "" - #. Tag: refname -#: reference_processing.xml:1932 +#: reference_processing.xml:1983 #, no-c-format msgid "ST_SharedPaths" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:1933 +#: reference_processing.xml:1984 #, no-c-format msgid "" "Returns a collection containing paths shared by the two input linestrings/" @@ -3628,7 +3221,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:1938 +#: reference_processing.xml:1989 #, no-c-format msgid "" "geometry ST_SharedPaths " @@ -3637,7 +3230,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1948 +#: reference_processing.xml:1999 #, no-c-format msgid "" "Returns a collection containing paths shared by the two input geometries. " @@ -3646,26 +3239,20 @@ msgid "" "The paths themselves are given in the direction of the first geometry." msgstr "" -#. Tag: para -#: reference_processing.xml:1953 -#, no-c-format -msgid "Availability: 2.0.0 requires GEOS >= 3.3.0." -msgstr "" - #. Tag: title -#: reference_processing.xml:1956 +#: reference_processing.xml:2007 #, no-c-format msgid "Examples: Finding shared paths" msgstr "" #. Tag: para -#: reference_processing.xml:1966 +#: reference_processing.xml:2017 #, no-c-format msgid "A multilinestring and a linestring" msgstr "" #. Tag: para -#: reference_processing.xml:1977 +#: reference_processing.xml:2028 #, no-c-format msgid "" "The shared path of multilinestring and linestring overlaid with original " @@ -3673,7 +3260,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1980 +#: reference_processing.xml:2031 #, no-c-format msgid "" "SELECT ST_AsText(\n" @@ -3693,7 +3280,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:1986 +#: reference_processing.xml:2037 #, no-c-format msgid "" "-- same example but linestring orientation flipped\n" @@ -3712,26 +3299,26 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:1996 +#: reference_processing.xml:2047 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_processing.xml:2006 +#: reference_processing.xml:2057 #, no-c-format msgid "ST_ShiftLongitude" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2008 +#: reference_processing.xml:2059 #, no-c-format msgid "Toggle geometry coordinates between -180..180 and 0..360 ranges." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2013 +#: reference_processing.xml:2064 #, no-c-format msgid "" "geometry ST_ShiftLongitude " @@ -3739,7 +3326,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2023 +#: reference_processing.xml:2074 #, no-c-format msgid "" "Reads every point/vertex in every component of every feature in a geometry, " @@ -3748,13 +3335,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2027 +#: reference_processing.xml:2078 #, 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:2029 +#: reference_processing.xml:2081 #, no-c-format msgid "" "Pre-1.3.4 bug prevented this from working for MULTIPOINT. 1.3.4+ works with " @@ -3762,19 +3349,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2034 +#: reference_processing.xml:2085 #, no-c-format msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced." msgstr "" #. Tag: para -#: reference_processing.xml:2035 +#: reference_processing.xml:2086 #, no-c-format msgid "NOTE: this function was renamed from \"ST_Shift_Longitude\" in 2.2.0" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2044 +#: reference_processing.xml:2095 #, no-c-format msgid "" "--3d points\n" @@ -3796,19 +3383,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:2058 +#: reference_processing.xml:2109 #, no-c-format msgid "ST_WrapX" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2060 +#: reference_processing.xml:2111 #, no-c-format msgid "Wrap a geometry around an X value." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2065 +#: reference_processing.xml:2116 #, no-c-format msgid "" "geometry ST_WrapX " @@ -3818,7 +3405,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2077 +#: reference_processing.xml:2128 #, no-c-format msgid "" "This function splits the input geometries and then moves every resulting " @@ -3828,7 +3415,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2084 +#: reference_processing.xml:2135 #, no-c-format msgid "" "This is useful to \"recenter\" long-lat input to have features of interest " @@ -3836,7 +3423,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2102 +#: reference_processing.xml:2153 #, no-c-format msgid "" "-- Move all components of the given geometries whose bounding box\n" @@ -3849,13 +3436,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:2114 +#: reference_processing.xml:2165 #, no-c-format msgid "ST_Simplify" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2115 +#: reference_processing.xml:2166 #, no-c-format msgid "" "Returns a \"simplified\" version of the given geometry using the Douglas-" @@ -3863,7 +3450,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2121 +#: reference_processing.xml:2172 #, no-c-format msgid "" "geometry ST_Simplify " @@ -3874,7 +3461,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2132 +#: reference_processing.xml:2183 #, no-c-format msgid "" "Returns a \"simplified\" version of the given geometry using the Douglas-" @@ -3885,7 +3472,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2139 +#: reference_processing.xml:2190 #, no-c-format msgid "" "The \"preserve collapsed\" flag will retain objects that would otherwise be " @@ -3896,8 +3483,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2145 reference_processing.xml:2229 -#: reference_processing.xml:2378 +#: reference_processing.xml:2196 reference_processing.xml:2279 +#: reference_processing.xml:2427 #, no-c-format msgid "" "Note that returned geometry might lose its simplicity (see , Topology geometry ST_SimplifyPreserveTopology " @@ -3978,7 +3566,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2183 +#: reference_processing.xml:2234 #, no-c-format msgid "" "Returns a \"simplified\" version of the given geometry using the Douglas-" @@ -3990,19 +3578,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2192 -#, no-c-format -msgid "Requires GEOS 3.0.0+" -msgstr "" - -#. Tag: para -#: reference_processing.xml:2193 +#: reference_processing.xml:2243 #, no-c-format msgid "Availability: 1.3.3" msgstr "" #. Tag: para -#: reference_processing.xml:2198 +#: reference_processing.xml:2248 #, no-c-format msgid "" "Same example as Simplify, but we see Preserve Topology prevents " @@ -4010,7 +3592,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2199 +#: reference_processing.xml:2249 #, no-c-format msgid "" "SELECT ST_Npoints(the_geom) As np_before, " @@ -4032,13 +3614,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:2209 +#: reference_processing.xml:2259 #, no-c-format msgid "ST_SimplifyVW" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2210 +#: reference_processing.xml:2260 #, no-c-format msgid "" "Returns a \"simplified\" version of the given geometry using the Visvalingam-" @@ -4046,7 +3628,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2215 +#: reference_processing.xml:2265 #, no-c-format msgid "" "geometry ST_SimplifyVW " @@ -4055,7 +3637,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2225 +#: reference_processing.xml:2275 #, no-c-format msgid "" "Returns a \"simplified\" version of the given geometry using the Visvalingam-" @@ -4066,20 +3648,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2232 reference_processing.xml:2278 +#: reference_processing.xml:2282 reference_processing.xml:2324 #, no-c-format msgid "" "This function handles 3D and the third dimension will affect the result." msgstr "" #. Tag: para -#: reference_processing.xml:2238 +#: reference_processing.xml:2288 #, no-c-format msgid "A LineString is simplified with a minimum area threshold of 30." msgstr "" #. Tag: programlisting -#: reference_processing.xml:2239 +#: reference_processing.xml:2289 #, no-c-format msgid "" "select ST_AsText(ST_SimplifyVW(geom,30)) simplified\n" @@ -4092,7 +3674,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2243 +#: reference_processing.xml:2293 #, no-c-format msgid "" ", , geometry ST_ChaikinSmoothing " -"geometry geomA " -"integer nIterations " -"boolean preserveEndPoints" +"geometry geom " +"integer nIterations = 1 boolean preserveEndPoints = " +"false" msgstr "" #. Tag: para -#: reference_processing.xml:2266 +#: reference_processing.xml:2316 #, no-c-format msgid "" "Returns a \"smoothed\" version of the given geometry using the Chaikin " @@ -4141,67 +3723,68 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2273 +#: reference_processing.xml:2322 #, no-c-format -msgid "" -"Note that returned geometry will get more points than the original. To " -"reduce the number of points again use one of the simplification functions on " -"the result. (see and )" +msgid "Second argument, number of iterations is limited to max 5 iterations" msgstr "" #. Tag: para -#: reference_processing.xml:2276 +#: reference_processing.xml:2323 #, no-c-format -msgid "Second argument, number of iterations is limited to max 5 iterations" +msgid "" +"Note third argument is only valid for polygons, and will be ignored for " +"linestrings" msgstr "" #. Tag: para -#: reference_processing.xml:2277 +#: reference_processing.xml:2325 #, no-c-format msgid "" -"Note third argument is only valid for polygons, and will be ignored for " -"linestrings" +"Note that returned geometry will get more points than the original. To " +"reduce the number of points again use one of the simplification functions on " +"the result. (see and )" msgstr "" #. Tag: para -#: reference_processing.xml:2284 +#: reference_processing.xml:2333 #, no-c-format msgid "A triangle is smoothed" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2285 +#: reference_processing.xml:2334 #, no-c-format msgid "" "select ST_AsText(ST_ChaikinSmoothing(geom)) smoothed\n" -"FROM (SELECT 'LINESTRING(0 0, 8 8, 0 16)'::geometry geom) As foo;\n" -"-result\n" -" smoothed\n" -"------------------------------\n" -"LINESTRING(0 0,6 6,6 10,0 16)" +"FROM (SELECT 'POLYGON((0 0, 8 8, 0 16, 0 0))'::geometry geom) As foo;\n" +"┌───────────────────────────────────────────┐\n" +"│ smoothed │\n" +"├───────────────────────────────────────────┤\n" +"│ POLYGON((2 2,6 6,6 10,2 14,0 12,0 4,2 2)) │\n" +"└───────────────────────────────────────────┘" msgstr "" #. Tag: para -#: reference_processing.xml:2289 reference_processing.xml:2336 +#: reference_processing.xml:2338 reference_processing.xml:2385 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_processing.xml:2295 +#: reference_processing.xml:2344 #, no-c-format msgid "ST_FilterByM" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2296 +#: reference_processing.xml:2345 #, no-c-format msgid "Filters vertex points based on their m-value" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2301 +#: reference_processing.xml:2350 #, no-c-format msgid "" "geometry ST_FilterByM " @@ -4213,31 +3796,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2313 +#: reference_processing.xml:2362 #, no-c-format msgid "" "Filters away vertex points based on their m-value. Returns a geometry with " "only vertex points that have a m-value larger or equal to the min value and " "smaller or equal to the max value. If max-value argument is left out only " "min value is considered. If fourth argument is left out the m-value will not " -"be in the resulting geoemtry. If resulting geometry have too few vertex " -"points left for its geometry type an empty geoemtry will be returned. In a " +"be in the resulting geometry. If resulting geometry have too few vertex " +"points left for its geometry type an empty geometry will be returned. In a " "geometry collection geometries without enough points will just be left out " "silently. If" msgstr "" #. Tag: para -#: reference_processing.xml:2319 +#: reference_processing.xml:2368 #, no-c-format msgid "" "This function is mainly intended to be used in conjunction with " "ST_SetEffectiveArea. ST_EffectiveArea sets the effective area of a vertex in " "it's m-value. With ST_FilterByM it then is possible to get a simplified " -"version of the geoemtry without any calculations, just by filtering" +"version of the geometry without any calculations, just by filtering" msgstr "" #. Tag: para -#: reference_processing.xml:2322 +#: reference_processing.xml:2371 #, no-c-format msgid "" "There is a difference in what ST_SimplifyVW returns when not enough points " @@ -4246,25 +3829,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2324 +#: reference_processing.xml:2373 #, no-c-format msgid "Note that the retuned geometry might be invalid" msgstr "" #. Tag: para -#: reference_processing.xml:2325 +#: reference_processing.xml:2374 #, no-c-format msgid "This function returns all dimensions, also the z and m-value" msgstr "" #. Tag: para -#: reference_processing.xml:2331 +#: reference_processing.xml:2380 #, no-c-format msgid "A linestring is filtered" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2332 +#: reference_processing.xml:2381 #, no-c-format msgid "" "SELECT ST_AsText(ST_FilterByM(geom,30)) simplified\n" @@ -4277,13 +3860,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:2342 +#: reference_processing.xml:2391 #, no-c-format msgid "ST_SetEffectiveArea" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2343 +#: reference_processing.xml:2392 #, no-c-format msgid "" "Sets the effective area for each vertex, storing the value in the M " @@ -4292,7 +3875,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2350 +#: reference_processing.xml:2399 #, no-c-format msgid "" "geometry ST_SetEffectiveArea " @@ -4302,7 +3885,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2361 +#: reference_processing.xml:2410 #, no-c-format msgid "" "Sets the effective area for each vertex, using the Visvalingam-Whyatt " @@ -4313,7 +3896,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2366 +#: reference_processing.xml:2415 #, no-c-format msgid "" "This function can be used for server-side simplification when a threshold is " @@ -4323,7 +3906,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2369 +#: reference_processing.xml:2418 #, no-c-format msgid "" "Will actually do something only with (multi)lines and (multi)polygons but " @@ -4333,13 +3916,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2381 +#: reference_processing.xml:2430 #, no-c-format msgid "The output geometry will lose all previous information in the M-values" msgstr "" #. Tag: para -#: reference_processing.xml:2382 +#: reference_processing.xml:2431 #, no-c-format msgid "" "This function handles 3D and the third dimension will affect the effective " @@ -4347,7 +3930,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2388 +#: reference_processing.xml:2437 #, no-c-format msgid "" "Calculating the effective area of a LineString. Because we use a threshold " @@ -4355,7 +3938,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2391 +#: reference_processing.xml:2440 #, no-c-format msgid "" "select ST_AsText(ST_SetEffectiveArea(geom)) all_pts, " @@ -4371,19 +3954,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:2401 +#: reference_processing.xml:2450 #, no-c-format msgid "ST_Split" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2402 +#: reference_processing.xml:2451 #, no-c-format msgid "Returns a collection of geometries resulting by splitting a geometry." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2407 +#: reference_processing.xml:2456 #, no-c-format msgid "" "geometry ST_Split " @@ -4392,7 +3975,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2417 +#: reference_processing.xml:2466 #, no-c-format msgid "" "The function supports splitting a line by (multi)point, (multi)line or " @@ -4401,7 +3984,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2421 +#: reference_processing.xml:2470 #, no-c-format msgid "" "Think of this function as the opposite of ST_Union. Theoretically applying " @@ -4410,7 +3993,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2428 +#: reference_processing.xml:2477 #, no-c-format msgid "" "Enhanced: 2.2.0 support for splitting a line by a multiline, a multipoint or " @@ -4418,7 +4001,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2429 +#: reference_processing.xml:2478 #, no-c-format msgid "" "Enhanced: 2.5.0 support for splitting a polygon by a multiline was " @@ -4426,7 +4009,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2431 +#: reference_processing.xml:2480 #, no-c-format msgid "" "To improve the robustness of ST_Split it may be convenient to , , geometry ST_SymDifference " @@ -4553,7 +4136,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2545 +#: reference_processing.xml:2594 #, no-c-format msgid "" "Returns a geometry that represents the portions of A and B that do not " @@ -4563,25 +4146,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2555 +#: reference_processing.xml:2601 #, no-c-format msgid "&sqlmm_compliant; SQL-MM 3: 5.1.21" msgstr "" #. Tag: para -#: reference_processing.xml:2575 +#: reference_processing.xml:2621 #, no-c-format msgid "The original linestrings shown together" msgstr "" #. Tag: para -#: reference_processing.xml:2587 +#: reference_processing.xml:2633 #, no-c-format msgid "The symmetric difference of the two linestrings" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2596 +#: reference_processing.xml:2642 #, no-c-format msgid "" "--Safe for 2d - symmetric difference of 2 linestrings\n" @@ -4598,7 +4181,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2598 +#: reference_processing.xml:2644 #, no-c-format msgid "" "--When used in 3d doesn't quite do the right thing\n" @@ -4611,20 +4194,14 @@ msgid "" "MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))" msgstr "" -#. Tag: para -#: reference_processing.xml:2605 -#, no-c-format -msgid ", , " -msgstr "" - #. Tag: refname -#: reference_processing.xml:2612 +#: reference_processing.xml:2658 #, no-c-format msgid "ST_Subdivide" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2613 +#: reference_processing.xml:2659 #, no-c-format msgid "" "Returns a set of geometry where no geometry in the set has more than the " @@ -4632,7 +4209,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2618 +#: reference_processing.xml:2664 #, no-c-format msgid "" "setof geometry ST_Subdivide " @@ -4642,7 +4219,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2629 +#: reference_processing.xml:2675 #, no-c-format msgid "" "Divides geometry into parts until a part can be represented using no more " @@ -4656,13 +4233,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2638 -#, no-c-format -msgid "Availability: 2.2.0 requires GEOS >= 3.5.0." -msgstr "" - -#. Tag: para -#: reference_processing.xml:2639 +#: reference_processing.xml:2685 #, no-c-format msgid "" "Enhanced: 2.5.0 reuses existing points on polygon split, vertex count is " @@ -4670,7 +4241,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2644 +#: reference_processing.xml:2690 #, no-c-format msgid "" "-- Subdivide complex geometries in table, in place\n" @@ -4687,7 +4258,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2646 +#: reference_processing.xml:2692 #, no-c-format msgid "" "-- Create a new subdivided table suitable for joining to the original\n" @@ -4697,13 +4268,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2657 +#: reference_processing.xml:2703 #, no-c-format msgid "Subdivide max 10 vertices" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2660 +#: reference_processing.xml:2706 #, no-c-format msgid "" "SELECT row_number() OVER() As rn, ST_AsText(geom) As wkt\n" @@ -4716,7 +4287,7 @@ msgid "" msgstr "" #. Tag: screen -#: reference_processing.xml:2661 +#: reference_processing.xml:2707 #, no-c-format msgid "" "rn │ wkt\n" @@ -4733,7 +4304,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2670 +#: reference_processing.xml:2716 #, no-c-format msgid "" "Useful in conjunction with ST_Segmentize(geography) to create additional " @@ -4741,7 +4312,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_processing.xml:2673 +#: reference_processing.xml:2719 #, no-c-format msgid "" "SELECT ST_AsText(ST_Subdivide(ST_Segmentize('LINESTRING(0 0, 85 85)'::" @@ -4749,7 +4320,7 @@ msgid "" msgstr "" #. Tag: screen -#: reference_processing.xml:2674 +#: reference_processing.xml:2720 #, no-c-format msgid "" "LINESTRING(0 0,0.487578359029357 5.57659056746196,0.984542144675897 " @@ -4770,7 +4341,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2681 +#: reference_processing.xml:2727 #, no-c-format msgid "" ", , , " @@ -4778,76 +4349,20 @@ msgid "" msgstr "" #. Tag: refname -#: reference_processing.xml:2693 -#, no-c-format -msgid "ST_SwapOrdinates" -msgstr "" - -#. Tag: refpurpose -#: reference_processing.xml:2694 -#, no-c-format -msgid "" -"Returns a version of the given geometry with given ordinate values swapped." -msgstr "" - -#. Tag: funcprototype -#: reference_processing.xml:2701 -#, no-c-format -msgid "" -"geometry ST_SwapOrdinates " -"geometry geom " -"cstring ords" -msgstr "" - -#. Tag: para -#: reference_processing.xml:2711 -#, no-c-format -msgid "Returns a version of the given geometry with given ordinates swapped." -msgstr "" - -#. Tag: para -#: reference_processing.xml:2714 -#, no-c-format -msgid "" -"The ords parameter is a 2-characters string naming the " -"ordinates to swap. Valid names are: x,y,z and m." -msgstr "" - -#. Tag: programlisting -#: reference_processing.xml:2728 -#, no-c-format -msgid "" -"" -msgstr "" - -#. Tag: refname -#: reference_processing.xml:2741 +#: reference_processing.xml:2739 #, no-c-format msgid "ST_Union" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2742 +#: reference_processing.xml:2740 #, no-c-format msgid "" "Returns a geometry that represents the point set union of the Geometries." msgstr "" #. Tag: funcsynopsis -#: reference_processing.xml:2747 +#: reference_processing.xml:2745 #, no-c-format msgid "" " geometry ST_Union " @@ -4862,7 +4377,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2766 +#: reference_processing.xml:2764 #, no-c-format msgid "" "Output type can be a MULTI*, single geometry, or Geometry Collection. Comes " @@ -4873,7 +4388,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2770 +#: reference_processing.xml:2768 #, no-c-format msgid "" "Aggregate version: This function returns a MULTI geometry or NON-MULTI " @@ -4884,7 +4399,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2776 +#: reference_processing.xml:2774 #, no-c-format msgid "" "Non-Aggregate version: This function returns a geometry being a union of two " @@ -4893,7 +4408,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2780 +#: reference_processing.xml:2778 #, no-c-format msgid "" "ST_Collect and ST_Union are often interchangeable. ST_Union is in general " @@ -4903,7 +4418,17 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2786 +#: reference_processing.xml:2783 +#, no-c-format +msgid "" +"ST_Union will use the faster Cascaded Union algorithm described in http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-" +"postgis-14.html" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2787 #, no-c-format msgid "" "NOTE: this function was formerly called GeomUnion(), which was renamed from " @@ -4911,87 +4436,117 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2789 +#: reference_processing.xml:2790 #, 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 http://blog.cleverelephant.ca/2009/01/must-" -"faster-unions-in-postgis-14.html" +"introduced and also faster aggregate collection in PostgreSQL." msgstr "" #. Tag: para -#: reference_processing.xml:2795 +#: reference_processing.xml:2794 #, no-c-format msgid "Aggregate version is not explicitly defined in OGC SPEC." msgstr "" #. Tag: para -#: reference_processing.xml:2796 +#: reference_processing.xml:2795 #, 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:2801 +#, no-c-format +msgid "Aggregate example" +msgstr "" + #. Tag: programlisting -#: reference_processing.xml:2803 +#: reference_processing.xml:2802 #, no-c-format msgid "" "SELECT stusps,\n" -" ST_Multi(ST_Union(f.the_geom)) as singlegeom\n" -" FROM sometable As f\n" +" ST_Union(f.geom) as singlegeom\n" +"FROM sometable f\n" "GROUP BY stusps" msgstr "" +#. Tag: para +#: reference_processing.xml:2803 +#, no-c-format +msgid "Non-Aggregate example" +msgstr "" + #. Tag: programlisting -#: reference_processing.xml:2805 +#: reference_processing.xml:2804 #, no-c-format msgid "" -"SELECT ST_AsText(ST_Union(ST_GeomFromText('POINT(1 2)'),\n" -" ST_GeomFromText('POINT(-2 3)') ) )\n" +"select ST_AsText(ST_Union('POINT(1 2)' :: geometry, 'POINT(-2 3)' :: " +"geometry))\n" "\n" "st_astext\n" "----------\n" "MULTIPOINT(-2 3,1 2)\n" "\n" +"select ST_AsText(ST_Union('POINT(1 2)' :: geometry, 'POINT(1 2)' :: " +"geometry))\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" +"POINT(1 2)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2805 +#, no-c-format +msgid "3D example - sort of supports 3D (and with mixed dimensions!)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2806 +#, no-c-format +msgid "" +"select ST_AsEWKT(ST_Union(geom))\n" +"from (\n" +" select 'POLYGON((-7 4.2,-7.1 4.2,-7.1 4.3, -7 4.2))'::geometry " +"geom\n" +" union all\n" +" select 'POINT(5 5 5)'::geometry geom\n" +" union all\n" +" select 'POINT(-2 3 1)'::geometry geom\n" +" union all\n" +" select 'LINESTRING(5 5 5, 10 10 10)'::geometry geom\n" +" ) 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" +"5,-7.1 4.2 5,-7.1 4.3 5,-7 4.2 5)));" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2807 +#, no-c-format +msgid "3d example not mixing dimensions" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2808 +#, no-c-format +msgid "" +"select ST_AsEWKT(ST_Union(geom))\n" +"from (\n" +" select 'POLYGON((-7 4.2 2,-7.1 4.2 3,-7.1 4.3 2, -7 4.2 2))'::" +"geometry geom\n" +" union all\n" +" select 'POINT(5 5 5)'::geometry geom\n" +" union all\n" +" select 'POINT(-2 3 1)'::geometry geom\n" +" union all\n" +" select 'LINESTRING(5 5 5, 10 10 10)'::geometry geom\n" +" ) as foo;\n" "\n" "st_asewkt\n" "---------\n" @@ -5009,20 +4564,28 @@ msgid "" "MULTILINESTRING((3 4,4 5),(1 2,3 4))" msgstr "" +#. Tag: para +#: reference_processing.xml:2812 +#, no-c-format +msgid "" +", , , " +" " +msgstr "" + #. Tag: refname -#: reference_processing.xml:2818 +#: reference_processing.xml:2824 #, no-c-format msgid "ST_UnaryUnion" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2820 +#: reference_processing.xml:2826 #, no-c-format msgid "Like ST_Union, but working at the geometry component level." msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2825 +#: reference_processing.xml:2831 #, no-c-format msgid "" "geometry ST_UnaryUnion " @@ -5030,7 +4593,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2836 +#: reference_processing.xml:2842 #, no-c-format msgid "" "Unlike ST_Union, ST_UnaryUnion does dissolve boundaries between components " @@ -5041,7 +4604,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2846 +#: reference_processing.xml:2852 #, no-c-format msgid "" "You may use this function to node a set of linestrings. You may mix " @@ -5051,7 +4614,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2864 +#: reference_processing.xml:2870 #, no-c-format msgid "" ", , , geometry ST_VoronoiLines " @@ -5084,7 +4647,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2903 +#: reference_processing.xml:2909 #, no-c-format msgid "" "ST_VoronoiLines computes a two-dimensional , " msgstr "" #. Tag: refname -#: reference_processing.xml:2963 +#: reference_processing.xml:2969 #, no-c-format msgid "ST_VoronoiPolygons" msgstr "" #. Tag: refpurpose -#: reference_processing.xml:2965 +#: reference_processing.xml:2971 #, no-c-format msgid "" "Returns the cells of the Voronoi diagram constructed from the vertices of a " @@ -5174,7 +4731,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_processing.xml:2970 +#: reference_processing.xml:2976 #, no-c-format msgid "" "geometry ST_VoronoiPolygons " @@ -5185,7 +4742,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_processing.xml:2992 +#: reference_processing.xml:2998 #, no-c-format msgid "" "ST_VoronoiPolygons computes a two-dimensional , " msgstr "" diff --git a/doc/po/templates/reference_raster.xml.pot b/doc/po/templates/reference_raster.xml.pot index 758b15474..da0aea2a5 100644 --- a/doc/po/templates/reference_raster.xml.pot +++ b/doc/po/templates/reference_raster.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -125,79 +125,79 @@ 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:354 reference_raster.xml:536 reference_raster.xml:710 -#: reference_raster.xml:777 reference_raster.xml:846 reference_raster.xml:889 -#: reference_raster.xml:924 reference_raster.xml:961 reference_raster.xml:1004 -#: reference_raster.xml:1065 reference_raster.xml:1110 -#: reference_raster.xml:1225 reference_raster.xml:1434 -#: reference_raster.xml:1521 reference_raster.xml:1607 -#: reference_raster.xml:1664 reference_raster.xml:1731 -#: reference_raster.xml:1796 reference_raster.xml:1838 -#: reference_raster.xml:1888 reference_raster.xml:1927 -#: reference_raster.xml:1961 reference_raster.xml:1998 -#: reference_raster.xml:2041 reference_raster.xml:2076 -#: reference_raster.xml:2110 reference_raster.xml:2160 -#: reference_raster.xml:2214 reference_raster.xml:2251 -#: reference_raster.xml:2291 reference_raster.xml:2346 -#: reference_raster.xml:2401 reference_raster.xml:2447 -#: reference_raster.xml:2482 reference_raster.xml:2518 -#: reference_raster.xml:2554 reference_raster.xml:2589 -#: reference_raster.xml:2628 reference_raster.xml:2662 -#: reference_raster.xml:2696 reference_raster.xml:2740 -#: reference_raster.xml:2802 reference_raster.xml:2857 -#: reference_raster.xml:2903 reference_raster.xml:2965 -#: reference_raster.xml:3007 reference_raster.xml:3058 -#: reference_raster.xml:3093 reference_raster.xml:3129 -#: reference_raster.xml:3163 reference_raster.xml:3238 -#: reference_raster.xml:3281 reference_raster.xml:3327 -#: reference_raster.xml:3389 reference_raster.xml:3432 -#: reference_raster.xml:3487 reference_raster.xml:3530 -#: reference_raster.xml:3606 reference_raster.xml:3693 -#: reference_raster.xml:3780 reference_raster.xml:3868 -#: reference_raster.xml:3953 reference_raster.xml:4079 -#: reference_raster.xml:4176 reference_raster.xml:4228 -#: reference_raster.xml:4276 reference_raster.xml:4319 -#: reference_raster.xml:4366 reference_raster.xml:4410 -#: reference_raster.xml:4448 reference_raster.xml:4523 -#: reference_raster.xml:4592 reference_raster.xml:4660 -#: reference_raster.xml:4737 reference_raster.xml:4809 -#: reference_raster.xml:4888 reference_raster.xml:4996 -#: reference_raster.xml:5031 reference_raster.xml:5078 -#: reference_raster.xml:5131 reference_raster.xml:5206 -#: reference_raster.xml:5271 reference_raster.xml:5384 -#: reference_raster.xml:5505 reference_raster.xml:5571 -#: reference_raster.xml:5650 reference_raster.xml:5796 -#: reference_raster.xml:5838 reference_raster.xml:5881 -#: reference_raster.xml:5935 reference_raster.xml:5988 -#: reference_raster.xml:6040 reference_raster.xml:6135 -#: reference_raster.xml:6226 reference_raster.xml:6314 -#: reference_raster.xml:6425 reference_raster.xml:6618 -#: reference_raster.xml:6857 reference_raster.xml:7000 -#: reference_raster.xml:7149 reference_raster.xml:7479 -#: reference_raster.xml:7685 reference_raster.xml:7809 -#: reference_raster.xml:8135 reference_raster.xml:8253 -#: reference_raster.xml:8366 reference_raster.xml:8508 -#: reference_raster.xml:8594 reference_raster.xml:8666 -#: reference_raster.xml:8730 reference_raster.xml:8801 -#: reference_raster.xml:8876 reference_raster.xml:8959 -#: reference_raster.xml:9030 reference_raster.xml:9086 -#: reference_raster.xml:9161 reference_raster.xml:9232 -#: reference_raster.xml:9316 reference_raster.xml:9408 -#: reference_raster.xml:9490 reference_raster.xml:9544 -#: reference_raster.xml:9618 reference_raster.xml:9666 -#: reference_raster.xml:9718 reference_raster.xml:9760 -#: reference_raster.xml:9808 reference_raster.xml:9859 -#: reference_raster.xml:9907 reference_raster.xml:9949 -#: reference_raster.xml:10023 reference_raster.xml:10068 -#: reference_raster.xml:10112 reference_raster.xml:10157 -#: reference_raster.xml:10226 reference_raster.xml:10273 -#: reference_raster.xml:10346 reference_raster.xml:10414 -#: reference_raster.xml:10503 reference_raster.xml:10588 -#: reference_raster.xml:10669 reference_raster.xml:10750 -#: reference_raster.xml:10879 reference_raster.xml:10963 -#: reference_raster.xml:11043 reference_raster.xml:11162 -#: reference_raster.xml:11209 reference_raster.xml:11281 -#: reference_raster.xml:11378 reference_raster.xml:11471 +#: reference_raster.xml:354 reference_raster.xml:535 reference_raster.xml:709 +#: reference_raster.xml:776 reference_raster.xml:845 reference_raster.xml:888 +#: reference_raster.xml:923 reference_raster.xml:960 reference_raster.xml:1003 +#: reference_raster.xml:1064 reference_raster.xml:1109 +#: reference_raster.xml:1224 reference_raster.xml:1433 +#: reference_raster.xml:1520 reference_raster.xml:1606 +#: reference_raster.xml:1663 reference_raster.xml:1730 +#: reference_raster.xml:1795 reference_raster.xml:1837 +#: reference_raster.xml:1887 reference_raster.xml:1926 +#: reference_raster.xml:1960 reference_raster.xml:1997 +#: reference_raster.xml:2040 reference_raster.xml:2075 +#: reference_raster.xml:2109 reference_raster.xml:2159 +#: reference_raster.xml:2213 reference_raster.xml:2250 +#: reference_raster.xml:2290 reference_raster.xml:2345 +#: reference_raster.xml:2400 reference_raster.xml:2446 +#: reference_raster.xml:2481 reference_raster.xml:2517 +#: reference_raster.xml:2553 reference_raster.xml:2588 +#: reference_raster.xml:2627 reference_raster.xml:2661 +#: reference_raster.xml:2695 reference_raster.xml:2739 +#: reference_raster.xml:2801 reference_raster.xml:2856 +#: reference_raster.xml:2902 reference_raster.xml:2964 +#: reference_raster.xml:3006 reference_raster.xml:3057 +#: reference_raster.xml:3092 reference_raster.xml:3128 +#: reference_raster.xml:3162 reference_raster.xml:3237 +#: reference_raster.xml:3280 reference_raster.xml:3326 +#: reference_raster.xml:3388 reference_raster.xml:3431 +#: reference_raster.xml:3486 reference_raster.xml:3529 +#: reference_raster.xml:3605 reference_raster.xml:3692 +#: reference_raster.xml:3779 reference_raster.xml:3867 +#: reference_raster.xml:3952 reference_raster.xml:4078 +#: reference_raster.xml:4175 reference_raster.xml:4227 +#: reference_raster.xml:4275 reference_raster.xml:4318 +#: reference_raster.xml:4365 reference_raster.xml:4409 +#: reference_raster.xml:4447 reference_raster.xml:4522 +#: reference_raster.xml:4591 reference_raster.xml:4659 +#: reference_raster.xml:4736 reference_raster.xml:4808 +#: reference_raster.xml:4887 reference_raster.xml:4995 +#: reference_raster.xml:5030 reference_raster.xml:5077 +#: reference_raster.xml:5130 reference_raster.xml:5205 +#: reference_raster.xml:5270 reference_raster.xml:5383 +#: reference_raster.xml:5504 reference_raster.xml:5570 +#: reference_raster.xml:5649 reference_raster.xml:5795 +#: reference_raster.xml:5837 reference_raster.xml:5880 +#: reference_raster.xml:5934 reference_raster.xml:5987 +#: reference_raster.xml:6039 reference_raster.xml:6134 +#: reference_raster.xml:6225 reference_raster.xml:6313 +#: reference_raster.xml:6424 reference_raster.xml:6617 +#: reference_raster.xml:6856 reference_raster.xml:6999 +#: reference_raster.xml:7148 reference_raster.xml:7478 +#: reference_raster.xml:7684 reference_raster.xml:7808 +#: reference_raster.xml:8134 reference_raster.xml:8252 +#: reference_raster.xml:8365 reference_raster.xml:8507 +#: reference_raster.xml:8593 reference_raster.xml:8665 +#: reference_raster.xml:8729 reference_raster.xml:8800 +#: reference_raster.xml:8875 reference_raster.xml:8958 +#: reference_raster.xml:9029 reference_raster.xml:9085 +#: reference_raster.xml:9160 reference_raster.xml:9231 +#: reference_raster.xml:9315 reference_raster.xml:9407 +#: reference_raster.xml:9489 reference_raster.xml:9543 +#: reference_raster.xml:9617 reference_raster.xml:9665 +#: reference_raster.xml:9717 reference_raster.xml:9759 +#: reference_raster.xml:9807 reference_raster.xml:9858 +#: reference_raster.xml:9906 reference_raster.xml:9948 +#: reference_raster.xml:10022 reference_raster.xml:10067 +#: reference_raster.xml:10111 reference_raster.xml:10156 +#: reference_raster.xml:10225 reference_raster.xml:10272 +#: reference_raster.xml:10345 reference_raster.xml:10413 +#: reference_raster.xml:10502 reference_raster.xml:10587 +#: reference_raster.xml:10668 reference_raster.xml:10749 +#: reference_raster.xml:10878 reference_raster.xml:10962 +#: reference_raster.xml:11042 reference_raster.xml:11161 +#: reference_raster.xml:11208 reference_raster.xml:11280 +#: reference_raster.xml:11377 reference_raster.xml:11470 #, no-c-format msgid "Description" msgstr "" @@ -216,76 +216,76 @@ 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:340 -#: reference_raster.xml:389 reference_raster.xml:584 reference_raster.xml:725 -#: reference_raster.xml:803 reference_raster.xml:863 reference_raster.xml:899 -#: reference_raster.xml:936 reference_raster.xml:974 reference_raster.xml:1029 -#: reference_raster.xml:1080 reference_raster.xml:1139 -#: reference_raster.xml:1269 reference_raster.xml:1486 -#: reference_raster.xml:1576 reference_raster.xml:1621 -#: reference_raster.xml:1684 reference_raster.xml:1760 -#: reference_raster.xml:1811 reference_raster.xml:1859 -#: reference_raster.xml:1906 reference_raster.xml:1940 -#: reference_raster.xml:1976 reference_raster.xml:2019 -#: reference_raster.xml:2055 reference_raster.xml:2089 -#: reference_raster.xml:2133 reference_raster.xml:2193 -#: reference_raster.xml:2230 reference_raster.xml:2268 -#: reference_raster.xml:2313 reference_raster.xml:2372 -#: reference_raster.xml:2426 reference_raster.xml:2461 -#: reference_raster.xml:2497 reference_raster.xml:2533 -#: reference_raster.xml:2568 reference_raster.xml:2602 -#: reference_raster.xml:2641 reference_raster.xml:2675 -#: reference_raster.xml:2710 reference_raster.xml:2760 -#: reference_raster.xml:2817 reference_raster.xml:2872 -#: reference_raster.xml:2943 reference_raster.xml:2978 -#: reference_raster.xml:3033 reference_raster.xml:3071 -#: reference_raster.xml:3216 reference_raster.xml:3253 -#: reference_raster.xml:3295 reference_raster.xml:3357 -#: reference_raster.xml:3400 reference_raster.xml:3455 -#: reference_raster.xml:3498 reference_raster.xml:3553 -#: reference_raster.xml:3628 reference_raster.xml:3718 -#: reference_raster.xml:3812 reference_raster.xml:3883 -#: reference_raster.xml:4032 reference_raster.xml:4098 -#: reference_raster.xml:4254 reference_raster.xml:4289 -#: reference_raster.xml:4338 reference_raster.xml:4383 -#: reference_raster.xml:4423 reference_raster.xml:4461 -#: reference_raster.xml:4553 reference_raster.xml:4618 -#: reference_raster.xml:4687 reference_raster.xml:4765 -#: reference_raster.xml:4839 reference_raster.xml:4961 -#: reference_raster.xml:5009 reference_raster.xml:5050 -#: reference_raster.xml:5103 reference_raster.xml:5156 -#: reference_raster.xml:5227 reference_raster.xml:5288 -#: reference_raster.xml:5419 reference_raster.xml:5520 -#: reference_raster.xml:5607 reference_raster.xml:5667 -#: reference_raster.xml:5814 reference_raster.xml:5855 -#: reference_raster.xml:5898 reference_raster.xml:5963 -#: reference_raster.xml:6011 reference_raster.xml:6089 -#: reference_raster.xml:6180 reference_raster.xml:6271 -#: reference_raster.xml:6351 reference_raster.xml:6581 -#: reference_raster.xml:6815 reference_raster.xml:6924 -#: reference_raster.xml:7059 reference_raster.xml:7410 -#: reference_raster.xml:7646 reference_raster.xml:7759 -#: reference_raster.xml:8051 reference_raster.xml:8210 -#: reference_raster.xml:8333 reference_raster.xml:8466 -#: reference_raster.xml:8537 reference_raster.xml:8625 -#: reference_raster.xml:8698 reference_raster.xml:8768 -#: reference_raster.xml:8837 reference_raster.xml:8919 -#: reference_raster.xml:8998 reference_raster.xml:9053 -#: reference_raster.xml:9122 reference_raster.xml:9193 -#: reference_raster.xml:9268 reference_raster.xml:9361 -#: reference_raster.xml:9458 reference_raster.xml:9501 -#: reference_raster.xml:9586 reference_raster.xml:9634 -#: reference_raster.xml:9685 reference_raster.xml:9735 -#: reference_raster.xml:9780 reference_raster.xml:9833 -#: reference_raster.xml:9879 reference_raster.xml:9922 -#: reference_raster.xml:9961 reference_raster.xml:10171 -#: reference_raster.xml:10239 reference_raster.xml:10292 -#: reference_raster.xml:10358 reference_raster.xml:10449 -#: reference_raster.xml:10534 reference_raster.xml:10615 -#: reference_raster.xml:10696 reference_raster.xml:10780 -#: reference_raster.xml:10909 reference_raster.xml:10990 -#: reference_raster.xml:11070 reference_raster.xml:11183 -#: reference_raster.xml:11227 reference_raster.xml:11314 -#: reference_raster.xml:11409 reference_raster.xml:11502 +#: reference_raster.xml:389 reference_raster.xml:583 reference_raster.xml:724 +#: reference_raster.xml:802 reference_raster.xml:862 reference_raster.xml:898 +#: reference_raster.xml:935 reference_raster.xml:973 reference_raster.xml:1028 +#: reference_raster.xml:1079 reference_raster.xml:1138 +#: reference_raster.xml:1268 reference_raster.xml:1485 +#: reference_raster.xml:1575 reference_raster.xml:1620 +#: reference_raster.xml:1683 reference_raster.xml:1759 +#: reference_raster.xml:1810 reference_raster.xml:1858 +#: reference_raster.xml:1905 reference_raster.xml:1939 +#: reference_raster.xml:1975 reference_raster.xml:2018 +#: reference_raster.xml:2054 reference_raster.xml:2088 +#: reference_raster.xml:2132 reference_raster.xml:2192 +#: reference_raster.xml:2229 reference_raster.xml:2267 +#: reference_raster.xml:2312 reference_raster.xml:2371 +#: reference_raster.xml:2425 reference_raster.xml:2460 +#: reference_raster.xml:2496 reference_raster.xml:2532 +#: reference_raster.xml:2567 reference_raster.xml:2601 +#: reference_raster.xml:2640 reference_raster.xml:2674 +#: reference_raster.xml:2709 reference_raster.xml:2759 +#: reference_raster.xml:2816 reference_raster.xml:2871 +#: reference_raster.xml:2942 reference_raster.xml:2977 +#: reference_raster.xml:3032 reference_raster.xml:3070 +#: reference_raster.xml:3215 reference_raster.xml:3252 +#: reference_raster.xml:3294 reference_raster.xml:3356 +#: reference_raster.xml:3399 reference_raster.xml:3454 +#: reference_raster.xml:3497 reference_raster.xml:3552 +#: reference_raster.xml:3627 reference_raster.xml:3717 +#: reference_raster.xml:3811 reference_raster.xml:3882 +#: reference_raster.xml:4031 reference_raster.xml:4097 +#: reference_raster.xml:4253 reference_raster.xml:4288 +#: reference_raster.xml:4337 reference_raster.xml:4382 +#: reference_raster.xml:4422 reference_raster.xml:4460 +#: reference_raster.xml:4552 reference_raster.xml:4617 +#: reference_raster.xml:4686 reference_raster.xml:4764 +#: reference_raster.xml:4838 reference_raster.xml:4960 +#: reference_raster.xml:5008 reference_raster.xml:5049 +#: reference_raster.xml:5102 reference_raster.xml:5155 +#: reference_raster.xml:5226 reference_raster.xml:5287 +#: reference_raster.xml:5418 reference_raster.xml:5519 +#: reference_raster.xml:5606 reference_raster.xml:5666 +#: reference_raster.xml:5813 reference_raster.xml:5854 +#: reference_raster.xml:5897 reference_raster.xml:5962 +#: reference_raster.xml:6010 reference_raster.xml:6088 +#: reference_raster.xml:6179 reference_raster.xml:6270 +#: reference_raster.xml:6350 reference_raster.xml:6580 +#: reference_raster.xml:6814 reference_raster.xml:6923 +#: reference_raster.xml:7058 reference_raster.xml:7409 +#: reference_raster.xml:7645 reference_raster.xml:7758 +#: reference_raster.xml:8050 reference_raster.xml:8209 +#: reference_raster.xml:8332 reference_raster.xml:8465 +#: reference_raster.xml:8536 reference_raster.xml:8624 +#: reference_raster.xml:8697 reference_raster.xml:8767 +#: reference_raster.xml:8836 reference_raster.xml:8918 +#: reference_raster.xml:8997 reference_raster.xml:9052 +#: reference_raster.xml:9121 reference_raster.xml:9192 +#: reference_raster.xml:9267 reference_raster.xml:9360 +#: reference_raster.xml:9457 reference_raster.xml:9500 +#: reference_raster.xml:9585 reference_raster.xml:9633 +#: reference_raster.xml:9684 reference_raster.xml:9734 +#: reference_raster.xml:9779 reference_raster.xml:9832 +#: reference_raster.xml:9878 reference_raster.xml:9921 +#: reference_raster.xml:9960 reference_raster.xml:10170 +#: reference_raster.xml:10238 reference_raster.xml:10291 +#: reference_raster.xml:10357 reference_raster.xml:10448 +#: reference_raster.xml:10533 reference_raster.xml:10614 +#: reference_raster.xml:10695 reference_raster.xml:10779 +#: reference_raster.xml:10908 reference_raster.xml:10989 +#: reference_raster.xml:11069 reference_raster.xml:11182 +#: reference_raster.xml:11226 reference_raster.xml:11313 +#: reference_raster.xml:11408 reference_raster.xml:11501 #, no-c-format msgid "See Also" msgstr "" @@ -779,14 +779,16 @@ msgid "" " boolean AddRasterConstraints name rasttable name rastcolumn boolean srid boolean scale_x boolean scale_y boolean blocksize_x boolean " -"blocksize_y boolean same_alignment " -"boolean regular_blocking boolean " +"srid=true boolean scale_x=true " +"boolean scale_y=true boolean " +"blocksize_x=true boolean blocksize_y=true " +"boolean " +"same_alignment=true boolean regular_blocking=false boolean " "num_bands=true boolean pixel_types=true " @@ -830,7 +832,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:538 +#: reference_raster.xml:537 #, no-c-format msgid "" "Generates constraints on a raster column that are used to display " @@ -841,7 +843,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:543 +#: reference_raster.xml:542 #, no-c-format msgid "" "raster2pgsql loader uses this function to register raster " @@ -849,7 +851,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:544 +#: reference_raster.xml:543 #, no-c-format msgid "" "Valid constraint names to pass in: refer to blocksize sets both X and Y blocksize" msgstr "" #. Tag: para -#: reference_raster.xml:547 +#: reference_raster.xml:546 #, no-c-format msgid "" "blocksize_x sets X tile (width in pixels of each tile)" msgstr "" #. Tag: para -#: reference_raster.xml:548 +#: reference_raster.xml:547 #, no-c-format msgid "" "blocksize_y sets Y tile (height in pixels of each tile)" msgstr "" #. Tag: para -#: reference_raster.xml:549 +#: reference_raster.xml:548 #, no-c-format msgid "" "extent computes extent of whole table and applys " @@ -885,13 +887,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:551 +#: reference_raster.xml:550 #, no-c-format msgid "num_bands number of bands" msgstr "" #. Tag: para -#: reference_raster.xml:552 +#: reference_raster.xml:551 #, no-c-format msgid "" "pixel_types reads array of pixel types for each band " @@ -899,7 +901,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:553 +#: reference_raster.xml:552 #, no-c-format msgid "" "regular_blocking sets spatially unique (no two rasters " @@ -908,7 +910,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:554 +#: reference_raster.xml:553 #, no-c-format msgid "" "same_alignment ensures they all have same alignment " @@ -917,19 +919,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:555 +#: reference_raster.xml:554 #, no-c-format msgid "srid ensures all have same srid" msgstr "" #. Tag: para -#: reference_raster.xml:556 +#: reference_raster.xml:555 #, no-c-format msgid "More -- any listed as inputs into the above functions" msgstr "" #. Tag: para -#: reference_raster.xml:559 +#: reference_raster.xml:558 #, no-c-format msgid "" "This function infers the constraints from the data already present in the " @@ -938,7 +940,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:564 +#: reference_raster.xml:563 #, no-c-format msgid "" "If you need to load more data in your tables after you have already applied " @@ -947,36 +949,36 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:568 reference_raster.xml:717 reference_raster.xml:793 -#: reference_raster.xml:859 reference_raster.xml:1527 reference_raster.xml:1965 -#: reference_raster.xml:3015 reference_raster.xml:3242 -#: reference_raster.xml:3285 reference_raster.xml:3346 -#: reference_raster.xml:5039 reference_raster.xml:5210 -#: reference_raster.xml:5405 reference_raster.xml:5509 -#: reference_raster.xml:5579 reference_raster.xml:5801 -#: reference_raster.xml:6439 reference_raster.xml:7705 -#: reference_raster.xml:7904 reference_raster.xml:8168 -#: reference_raster.xml:8287 reference_raster.xml:8416 -#: reference_raster.xml:8514 reference_raster.xml:8602 -#: reference_raster.xml:8686 reference_raster.xml:8825 -#: reference_raster.xml:8900 reference_raster.xml:8987 -#: reference_raster.xml:9110 reference_raster.xml:9181 -#: reference_raster.xml:9256 reference_raster.xml:9342 -#: reference_raster.xml:9438 reference_raster.xml:9566 -#: reference_raster.xml:10030 reference_raster.xml:10281 -#: reference_raster.xml:10353 reference_raster.xml:11172 +#: reference_raster.xml:567 reference_raster.xml:716 reference_raster.xml:792 +#: reference_raster.xml:858 reference_raster.xml:1526 reference_raster.xml:1964 +#: reference_raster.xml:3014 reference_raster.xml:3241 +#: reference_raster.xml:3284 reference_raster.xml:3345 +#: reference_raster.xml:5038 reference_raster.xml:5209 +#: reference_raster.xml:5404 reference_raster.xml:5508 +#: reference_raster.xml:5578 reference_raster.xml:5800 +#: reference_raster.xml:6438 reference_raster.xml:7704 +#: reference_raster.xml:7903 reference_raster.xml:8167 +#: reference_raster.xml:8286 reference_raster.xml:8415 +#: reference_raster.xml:8513 reference_raster.xml:8601 +#: reference_raster.xml:8685 reference_raster.xml:8824 +#: reference_raster.xml:8899 reference_raster.xml:8986 +#: reference_raster.xml:9109 reference_raster.xml:9180 +#: reference_raster.xml:9255 reference_raster.xml:9341 +#: reference_raster.xml:9437 reference_raster.xml:9565 +#: reference_raster.xml:10029 reference_raster.xml:10280 +#: reference_raster.xml:10352 reference_raster.xml:11171 #, no-c-format msgid "Availability: 2.0.0" msgstr "" #. Tag: title -#: reference_raster.xml:572 +#: reference_raster.xml:571 #, no-c-format msgid "Examples: Apply all possible constraints on column based on data" msgstr "" #. Tag: programlisting -#: reference_raster.xml:574 +#: reference_raster.xml:573 #, no-c-format msgid "" "CREATE TABLE myrasters(rid SERIAL primary key, rast raster);\n" @@ -1002,13 +1004,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:578 +#: reference_raster.xml:577 #, no-c-format msgid "Examples: Apply single constraint" msgstr "" #. Tag: programlisting -#: reference_raster.xml:580 +#: reference_raster.xml:579 #, no-c-format msgid "" "CREATE TABLE public.myrasters2(rid SERIAL primary key, rast raster);\n" @@ -1025,7 +1027,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:586 +#: reference_raster.xml:585 #, no-c-format msgid "" ", , boolean DropRasterConstraintsraster_columns catalog " @@ -1146,67 +1148,67 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:720 reference_raster.xml:797 reference_raster.xml:894 -#: reference_raster.xml:930 reference_raster.xml:968 reference_raster.xml:1531 -#: reference_raster.xml:1677 reference_raster.xml:1751 -#: reference_raster.xml:1852 reference_raster.xml:1900 -#: reference_raster.xml:1933 reference_raster.xml:1969 -#: reference_raster.xml:2012 reference_raster.xml:2048 -#: reference_raster.xml:2082 reference_raster.xml:2222 -#: reference_raster.xml:2260 reference_raster.xml:2303 -#: reference_raster.xml:2362 reference_raster.xml:2416 -#: reference_raster.xml:2454 reference_raster.xml:2489 -#: reference_raster.xml:2525 reference_raster.xml:2561 -#: reference_raster.xml:2597 reference_raster.xml:2634 -#: reference_raster.xml:2668 reference_raster.xml:2702 -#: reference_raster.xml:2753 reference_raster.xml:2810 -#: reference_raster.xml:2865 reference_raster.xml:2971 -#: reference_raster.xml:3026 reference_raster.xml:3064 -#: reference_raster.xml:3104 reference_raster.xml:3139 -#: reference_raster.xml:3209 reference_raster.xml:3246 -#: reference_raster.xml:3290 reference_raster.xml:3352 -#: reference_raster.xml:3395 reference_raster.xml:3450 -#: reference_raster.xml:3493 reference_raster.xml:3548 -#: reference_raster.xml:3615 reference_raster.xml:3709 -#: reference_raster.xml:3801 reference_raster.xml:3876 -#: reference_raster.xml:4089 reference_raster.xml:4185 -#: reference_raster.xml:4248 reference_raster.xml:4282 -#: reference_raster.xml:4330 reference_raster.xml:4373 -#: reference_raster.xml:4454 reference_raster.xml:4547 -#: reference_raster.xml:4611 reference_raster.xml:4679 -#: reference_raster.xml:4757 reference_raster.xml:4834 -#: reference_raster.xml:4913 reference_raster.xml:5002 -#: reference_raster.xml:5043 reference_raster.xml:5098 -#: reference_raster.xml:5151 reference_raster.xml:5221 -#: reference_raster.xml:5283 reference_raster.xml:5513 -#: reference_raster.xml:5662 reference_raster.xml:5805 -#: reference_raster.xml:5848 reference_raster.xml:5891 -#: reference_raster.xml:5956 reference_raster.xml:6004 -#: reference_raster.xml:6263 reference_raster.xml:6704 -#: reference_raster.xml:7709 reference_raster.xml:8172 -#: reference_raster.xml:8420 reference_raster.xml:8691 -#: reference_raster.xml:8763 reference_raster.xml:8830 -#: reference_raster.xml:8992 reference_raster.xml:9048 -#: reference_raster.xml:9115 reference_raster.xml:9186 -#: reference_raster.xml:9261 reference_raster.xml:9496 -#: reference_raster.xml:9629 reference_raster.xml:9680 -#: reference_raster.xml:9729 reference_raster.xml:9772 -#: reference_raster.xml:9828 reference_raster.xml:9873 -#: reference_raster.xml:9917 reference_raster.xml:9956 -#: reference_raster.xml:10034 reference_raster.xml:10078 -#: reference_raster.xml:10123 reference_raster.xml:10286 -#: reference_raster.xml:10442 reference_raster.xml:10529 -#: reference_raster.xml:10610 reference_raster.xml:10691 -#: reference_raster.xml:10772 reference_raster.xml:10904 -#: reference_raster.xml:10985 reference_raster.xml:11065 -#: reference_raster.xml:11222 reference_raster.xml:11309 -#: reference_raster.xml:11404 reference_raster.xml:11497 +#: reference_raster.xml:719 reference_raster.xml:796 reference_raster.xml:893 +#: reference_raster.xml:929 reference_raster.xml:967 reference_raster.xml:1530 +#: reference_raster.xml:1676 reference_raster.xml:1750 +#: reference_raster.xml:1851 reference_raster.xml:1899 +#: reference_raster.xml:1932 reference_raster.xml:1968 +#: reference_raster.xml:2011 reference_raster.xml:2047 +#: reference_raster.xml:2081 reference_raster.xml:2221 +#: reference_raster.xml:2259 reference_raster.xml:2302 +#: reference_raster.xml:2361 reference_raster.xml:2415 +#: reference_raster.xml:2453 reference_raster.xml:2488 +#: reference_raster.xml:2524 reference_raster.xml:2560 +#: reference_raster.xml:2596 reference_raster.xml:2633 +#: reference_raster.xml:2667 reference_raster.xml:2701 +#: reference_raster.xml:2752 reference_raster.xml:2809 +#: reference_raster.xml:2864 reference_raster.xml:2970 +#: reference_raster.xml:3025 reference_raster.xml:3063 +#: reference_raster.xml:3103 reference_raster.xml:3138 +#: reference_raster.xml:3208 reference_raster.xml:3245 +#: reference_raster.xml:3289 reference_raster.xml:3351 +#: reference_raster.xml:3394 reference_raster.xml:3449 +#: reference_raster.xml:3492 reference_raster.xml:3547 +#: reference_raster.xml:3614 reference_raster.xml:3708 +#: reference_raster.xml:3800 reference_raster.xml:3875 +#: reference_raster.xml:4088 reference_raster.xml:4184 +#: reference_raster.xml:4247 reference_raster.xml:4281 +#: reference_raster.xml:4329 reference_raster.xml:4372 +#: reference_raster.xml:4453 reference_raster.xml:4546 +#: reference_raster.xml:4610 reference_raster.xml:4678 +#: reference_raster.xml:4756 reference_raster.xml:4833 +#: reference_raster.xml:4912 reference_raster.xml:5001 +#: reference_raster.xml:5042 reference_raster.xml:5097 +#: reference_raster.xml:5150 reference_raster.xml:5220 +#: reference_raster.xml:5282 reference_raster.xml:5512 +#: reference_raster.xml:5661 reference_raster.xml:5804 +#: reference_raster.xml:5847 reference_raster.xml:5890 +#: reference_raster.xml:5955 reference_raster.xml:6003 +#: reference_raster.xml:6262 reference_raster.xml:6703 +#: reference_raster.xml:7708 reference_raster.xml:8171 +#: reference_raster.xml:8419 reference_raster.xml:8690 +#: reference_raster.xml:8762 reference_raster.xml:8829 +#: reference_raster.xml:8991 reference_raster.xml:9047 +#: reference_raster.xml:9114 reference_raster.xml:9185 +#: reference_raster.xml:9260 reference_raster.xml:9495 +#: reference_raster.xml:9628 reference_raster.xml:9679 +#: reference_raster.xml:9728 reference_raster.xml:9771 +#: reference_raster.xml:9827 reference_raster.xml:9872 +#: reference_raster.xml:9916 reference_raster.xml:9955 +#: reference_raster.xml:10033 reference_raster.xml:10077 +#: reference_raster.xml:10122 reference_raster.xml:10285 +#: reference_raster.xml:10441 reference_raster.xml:10528 +#: reference_raster.xml:10609 reference_raster.xml:10690 +#: reference_raster.xml:10771 reference_raster.xml:10903 +#: reference_raster.xml:10984 reference_raster.xml:11064 +#: reference_raster.xml:11221 reference_raster.xml:11308 +#: reference_raster.xml:11403 reference_raster.xml:11496 #, no-c-format msgid "Examples" msgstr "" #. Tag: programlisting -#: reference_raster.xml:722 +#: reference_raster.xml:721 #, no-c-format msgid "" "SELECT DropRasterConstraints ('myrasters','rast');\n" @@ -1228,19 +1230,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:733 +#: reference_raster.xml:732 #, no-c-format msgid "AddOverviewConstraints" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:735 +#: reference_raster.xml:734 #, no-c-format msgid "Tag a raster column as being an overview of another." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:739 +#: reference_raster.xml:738 #, no-c-format msgid "" " boolean AddOverviewConstraintsovfactor parameter represents the scale multiplier in " @@ -1277,7 +1279,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:787 +#: reference_raster.xml:786 #, no-c-format msgid "" "When the ovschema and refschema " @@ -1286,7 +1288,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:799 +#: reference_raster.xml:798 #, no-c-format msgid "" "CREATE TABLE res1 AS SELECT\n" @@ -1315,7 +1317,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:805 +#: reference_raster.xml:804 #, no-c-format msgid "" ", , boolean DropOverviewConstraintsovschema parameter is omitted, the first table " @@ -1366,7 +1368,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:865 +#: reference_raster.xml:864 #, no-c-format msgid "" ", , text PostGIS_GDAL_Version " @@ -1394,7 +1396,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:890 +#: reference_raster.xml:889 #, no-c-format msgid "" "Reports the version of the GDAL library in use by PostGIS. Will also check " @@ -1402,7 +1404,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:895 +#: reference_raster.xml:894 #, no-c-format msgid "" "SELECT PostGIS_GDAL_Version();\n" @@ -1412,19 +1414,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:908 +#: reference_raster.xml:907 #, no-c-format msgid "PostGIS_Raster_Lib_Build_Date" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:910 +#: reference_raster.xml:909 #, no-c-format msgid "Reports full raster library build date." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:915 +#: reference_raster.xml:914 #, no-c-format msgid "" "text PostGIS_Raster_Lib_Build_Date " @@ -1432,13 +1434,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:926 +#: reference_raster.xml:925 #, no-c-format msgid "Reports raster build date" msgstr "" #. Tag: programlisting -#: reference_raster.xml:932 +#: reference_raster.xml:931 #, no-c-format msgid "" "SELECT PostGIS_Raster_Lib_Build_Date();\n" @@ -1448,13 +1450,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:944 +#: reference_raster.xml:943 #, no-c-format msgid "PostGIS_Raster_Lib_Version" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:946 +#: reference_raster.xml:945 #, no-c-format msgid "" "Reports full raster version and build configuration infos.text PostGIS_Raster_Lib_Version " @@ -1470,13 +1472,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:963 +#: reference_raster.xml:962 #, no-c-format msgid "Reports full raster version and build configuration infos." msgstr "" #. Tag: programlisting -#: reference_raster.xml:970 +#: reference_raster.xml:969 #, no-c-format msgid "" "SELECT PostGIS_Raster_Lib_Version();\n" @@ -1486,13 +1488,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:984 +#: reference_raster.xml:983 #, no-c-format msgid "ST_GDALDrivers" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:986 +#: reference_raster.xml:985 #, no-c-format msgid "" "Returns a list of raster formats supported by PostGIS through GDAL. Only " @@ -1500,7 +1502,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:991 +#: reference_raster.xml:990 #, no-c-format msgid "" "setof record ST_GDALDrivers " @@ -1514,7 +1516,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1006 +#: reference_raster.xml:1005 #, no-c-format msgid "" "Returns a list of raster formats short_name,long_name and creator options of " @@ -1528,13 +1530,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1011 +#: reference_raster.xml:1010 #, no-c-format msgid "Changed: 2.5.0 - add can_read and can_write columns." msgstr "" #. Tag: para -#: reference_raster.xml:1012 +#: reference_raster.xml:1011 #, no-c-format msgid "" "Changed: 2.0.6, 2.1.3 - by default no drivers are enabled, unless GUC or " @@ -1542,21 +1544,21 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1013 reference_raster.xml:1454 -#: reference_raster.xml:6060 reference_raster.xml:6168 -#: reference_raster.xml:6259 reference_raster.xml:6339 +#: reference_raster.xml:1012 reference_raster.xml:1453 +#: reference_raster.xml:6059 reference_raster.xml:6167 +#: reference_raster.xml:6258 reference_raster.xml:6338 #, no-c-format msgid "Availability: 2.0.0 - requires GDAL >= 1.6.0." msgstr "" #. Tag: title -#: reference_raster.xml:1018 +#: reference_raster.xml:1017 #, no-c-format msgid "Examples: List of Drivers" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1020 +#: reference_raster.xml:1019 #, no-c-format msgid "" "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';\n" @@ -1677,13 +1679,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1022 +#: reference_raster.xml:1021 #, no-c-format msgid "Example: List of options for each driver" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1023 +#: reference_raster.xml:1022 #, no-c-format msgid "" "-- Output the create options XML column of JPEG as a table --\n" @@ -1715,7 +1717,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1025 +#: reference_raster.xml:1024 #, no-c-format msgid "" "-- raw xml output for creator options for GeoTiff --\n" @@ -1861,7 +1863,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1031 +#: reference_raster.xml:1030 #, no-c-format msgid "" ", , raster UpdateRasterSRIDregclass ST_CreateOverview " @@ -1961,7 +1963,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1112 +#: reference_raster.xml:1111 #, no-c-format msgid "" "Create an overview table with resampled tiles from the source table. Output " @@ -1971,7 +1973,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1119 +#: reference_raster.xml:1118 #, no-c-format msgid "" "The overview table will be made available in the raster_overviews, (1) raster ST_AddBand " @@ -2133,7 +2135,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1235 +#: reference_raster.xml:1234 #, no-c-format msgid "" "For the variant that takes an array of rasters (Variant 5), if " @@ -2142,7 +2144,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1239 +#: reference_raster.xml:1238 #, no-c-format msgid "" "For the variants that take outdbfile (Variants 6 and 7), " @@ -2151,25 +2153,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1243 +#: reference_raster.xml:1242 #, no-c-format msgid "Enhanced: 2.1.0 support for addbandarg added." msgstr "" #. Tag: para -#: reference_raster.xml:1244 +#: reference_raster.xml:1243 #, no-c-format msgid "Enhanced: 2.1.0 support for new out-db bands added." msgstr "" #. Tag: title -#: reference_raster.xml:1248 +#: reference_raster.xml:1247 #, no-c-format msgid "Examples: Single New Band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1250 +#: reference_raster.xml:1249 #, no-c-format msgid "" "-- Add another band of type 8 bit unsigned integer with pixels initialized " @@ -2180,7 +2182,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1252 +#: reference_raster.xml:1251 #, no-c-format msgid "" "-- Create an empty raster 100x100 units, with upper left right at 0, add 2 " @@ -2221,13 +2223,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1256 +#: reference_raster.xml:1255 #, no-c-format msgid "Examples: Multiple New Bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1258 +#: reference_raster.xml:1257 #, no-c-format msgid "" "SELECT\n" @@ -2254,7 +2256,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1260 +#: reference_raster.xml:1259 #, no-c-format msgid "" "-- Aggregate the 1st band of a table of like rasters into a single raster\n" @@ -2274,13 +2276,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1264 +#: reference_raster.xml:1263 #, no-c-format msgid "Examples: New Out-db band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1265 +#: reference_raster.xml:1264 #, no-c-format msgid "" "SELECT\n" @@ -2303,7 +2305,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1270 +#: reference_raster.xml:1269 #, no-c-format msgid "" ", , raster ST_AsRaster " @@ -2470,7 +2472,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1436 +#: reference_raster.xml:1435 #, no-c-format msgid "" "Converts a PostGIS geometry to a PostGIS raster. The many variants offers " @@ -2479,7 +2481,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1438 +#: reference_raster.xml:1437 #, no-c-format msgid "" "The first group, composed of the two first variants, produce a raster having " @@ -2491,7 +2493,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1440 +#: reference_raster.xml:1439 #, no-c-format msgid "" "The second group, composed of four variants, let you set the dimensions of " @@ -2505,7 +2507,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1442 +#: reference_raster.xml:1441 #, no-c-format msgid "" "The third group, composed of four variants, let you fix the dimensions of " @@ -2517,7 +2519,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1444 +#: reference_raster.xml:1443 #, no-c-format msgid "" "The two first variants of each of those two last groups let you specify the " @@ -2528,7 +2530,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1446 +#: reference_raster.xml:1445 #, no-c-format msgid "" "Each group of variant allows producing a one band raster or a multiple bands " @@ -2540,7 +2542,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1448 +#: reference_raster.xml:1447 #, no-c-format msgid "" "The output raster will be in the same spatial reference as the source " @@ -2550,7 +2552,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1450 +#: reference_raster.xml:1449 #, no-c-format msgid "" "The optional touched parameter defaults to false and maps " @@ -2560,7 +2562,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1452 +#: reference_raster.xml:1451 #, no-c-format msgid "" "This is particularly useful for rendering jpegs and pngs of geometries " @@ -2570,7 +2572,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1456 +#: reference_raster.xml:1455 #, no-c-format msgid "" "Not yet capable of rendering complex geometry types such as curves, TINS, " @@ -2578,19 +2580,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1461 +#: reference_raster.xml:1460 #, no-c-format msgid "Examples: Output geometries as PNG files" msgstr "" #. Tag: para -#: reference_raster.xml:1467 +#: reference_raster.xml:1466 #, no-c-format msgid "black circle" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1470 +#: reference_raster.xml:1469 #, no-c-format msgid "" "-- this will output a black circle taking up 150 x 150 pixels --\n" @@ -2598,13 +2600,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1477 +#: reference_raster.xml:1476 #, no-c-format msgid "example from buffer rendered with just PostGIS" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1481 +#: reference_raster.xml:1480 #, no-c-format msgid "" "-- the bands map to RGB bands - the value (118,154,118) - teal --\n" @@ -2618,7 +2620,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1487 +#: reference_raster.xml:1486 #, no-c-format msgid "" ", , , " @@ -2627,13 +2629,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1493 +#: reference_raster.xml:1492 #, no-c-format msgid "ST_Band" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1494 +#: reference_raster.xml:1493 #, no-c-format msgid "" "Returns one or more bands of an existing raster as a new raster. Useful for " @@ -2641,7 +2643,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1498 +#: reference_raster.xml:1497 #, no-c-format msgid "" " raster ST_Band " @@ -2659,7 +2661,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1523 +#: reference_raster.xml:1522 #, no-c-format msgid "" "Returns one or more bands of an existing raster as a new raster. Useful for " @@ -2671,7 +2673,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1525 +#: reference_raster.xml:1524 #, no-c-format msgid "" "For the nbands as text variant of function, the default " @@ -2684,7 +2686,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1533 +#: reference_raster.xml:1532 #, no-c-format msgid "" "-- Make 2 new rasters: 1 containing band 1 of dummy, second containing band " @@ -2703,7 +2705,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1535 +#: reference_raster.xml:1534 #, no-c-format msgid "" "-- Return bands 2 and 3. Using array cast syntax\n" @@ -2721,25 +2723,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1545 +#: reference_raster.xml:1544 #, no-c-format msgid "original (column rast)" msgstr "" #. Tag: para -#: reference_raster.xml:1554 +#: reference_raster.xml:1553 #, no-c-format msgid "dupe_band" msgstr "" #. Tag: para -#: reference_raster.xml:1563 +#: reference_raster.xml:1562 #, no-c-format msgid "sing_band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1571 +#: reference_raster.xml:1570 #, no-c-format msgid "" "--Make a new raster with 2nd band of original and 1st band repeated twice,\n" @@ -2751,7 +2753,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1577 +#: reference_raster.xml:1576 #, no-c-format msgid "" ", , , " @@ -2759,19 +2761,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1583 +#: reference_raster.xml:1582 #, no-c-format msgid "ST_MakeEmptyCoverage" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1584 +#: reference_raster.xml:1583 #, no-c-format msgid "Cover georeferenced area with a grid of empty raster tiles." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1589 +#: reference_raster.xml:1588 #, no-c-format msgid "" "raster ST_MakeEmptyCoverage " @@ -2791,7 +2793,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1609 +#: reference_raster.xml:1608 #, no-c-format msgid "" "Create a set of raster tiles with . " @@ -2805,7 +2807,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1610 +#: reference_raster.xml:1609 #, no-c-format msgid "" "Note that scaley is generally negative for rasters and scalex is generally " @@ -2814,19 +2816,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1611 +#: reference_raster.xml:1610 #, no-c-format msgid "Availability: 2.4.0" msgstr "" #. Tag: title -#: reference_raster.xml:1615 reference_raster.xml:8518 +#: reference_raster.xml:1614 reference_raster.xml:8517 #, no-c-format msgid "Examples Basic" msgstr "" #. Tag: para -#: reference_raster.xml:1616 +#: reference_raster.xml:1615 #, no-c-format msgid "" "Create 16 tiles in a 4x4 grid to cover the WGS84 area from upper left corner " @@ -2834,7 +2836,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1617 +#: reference_raster.xml:1616 #, no-c-format msgid "" " raster ST_MakeEmptyRaster, , " @@ -2997,13 +2999,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1692 +#: reference_raster.xml:1691 #, no-c-format msgid "ST_Tile" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1693 +#: reference_raster.xml:1692 #, no-c-format msgid "" "Returns a set of rasters resulting from the split of the input " @@ -3011,7 +3013,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:1697 +#: reference_raster.xml:1696 #, no-c-format msgid "" " setof raster ST_Tile " @@ -3042,7 +3044,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1733 +#: reference_raster.xml:1732 #, no-c-format msgid "" "Returns a set of rasters resulting from the split of the input raster " @@ -3050,7 +3052,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1737 +#: reference_raster.xml:1736 #, no-c-format msgid "" "If padwithnodata = FALSE, edge tiles on the right and " @@ -3062,7 +3064,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1742 +#: reference_raster.xml:1741 #, no-c-format msgid "" "If a specified band of the input raster is out-of-db, the corresponding band " @@ -3070,7 +3072,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1753 +#: reference_raster.xml:1752 #, no-c-format msgid "" "WITH foo AS (\n" @@ -3127,7 +3129,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1755 +#: reference_raster.xml:1754 #, no-c-format msgid "" "WITH foo AS (\n" @@ -3175,26 +3177,26 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1761 +#: reference_raster.xml:1760 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:1771 +#: reference_raster.xml:1770 #, no-c-format msgid "ST_Retile" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1772 +#: reference_raster.xml:1771 #, no-c-format msgid "" "Return a set of configured tiles from an arbitrarily tiled raster coverage." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1780 +#: reference_raster.xml:1779 #, no-c-format msgid "" "SETOF raster ST_Retile " @@ -3210,7 +3212,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1798 +#: reference_raster.xml:1797 #, no-c-format msgid "" "Return a set of tiles having the specified scale (sfx, " @@ -3221,19 +3223,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1822 +#: reference_raster.xml:1821 #, no-c-format msgid "ST_FromGDALRaster" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1823 +#: reference_raster.xml:1822 #, no-c-format msgid "Returns a raster from a supported GDAL raster file." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1828 +#: reference_raster.xml:1827 #, no-c-format msgid "" "raster ST_FromGDALRaster " @@ -3243,7 +3245,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1840 +#: reference_raster.xml:1839 #, no-c-format msgid "" "Returns a raster from a supported GDAL raster file. gdaldatasrid is NULL, the function will try to automatically " @@ -3260,7 +3262,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1854 +#: reference_raster.xml:1853 #, no-c-format msgid "" "WITH foo AS (\n" @@ -3295,19 +3297,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:1869 +#: reference_raster.xml:1868 #, no-c-format msgid "Raster Accessors" msgstr "" #. Tag: refname -#: reference_raster.xml:1873 +#: reference_raster.xml:1872 #, no-c-format msgid "ST_GeoReference" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1874 +#: reference_raster.xml:1873 #, no-c-format msgid "" "Returns the georeference meta data in GDAL or ESRI format as commonly seen " @@ -3315,7 +3317,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1879 +#: reference_raster.xml:1878 #, no-c-format msgid "" "text ST_GeoReference " @@ -3325,7 +3327,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1890 +#: reference_raster.xml:1889 #, no-c-format msgid "" "Returns the georeference meta data including carriage return in GDAL or ESRI " @@ -3335,19 +3337,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1892 reference_raster.xml:4231 +#: reference_raster.xml:1891 reference_raster.xml:4230 #, no-c-format msgid "Difference between format representations is as follows:" msgstr "" #. Tag: para -#: reference_raster.xml:1893 reference_raster.xml:4232 +#: reference_raster.xml:1892 reference_raster.xml:4231 #, no-c-format msgid "GDAL:" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1894 +#: reference_raster.xml:1893 #, no-c-format msgid "" "scalex\n" @@ -3359,13 +3361,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1895 reference_raster.xml:4234 +#: reference_raster.xml:1894 reference_raster.xml:4233 #, no-c-format msgid "ESRI:" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1896 +#: reference_raster.xml:1895 #, no-c-format msgid "" "scalex\n" @@ -3377,7 +3379,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1902 +#: reference_raster.xml:1901 #, no-c-format msgid "" "SELECT ST_GeoReference(rast, 'ESRI') As esri_ref, ST_GeoReference(rast, " @@ -3395,25 +3397,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1907 +#: reference_raster.xml:1906 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:1913 +#: reference_raster.xml:1912 #, no-c-format msgid "ST_Height" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1914 +#: reference_raster.xml:1913 #, no-c-format msgid "Returns the height of the raster in pixels." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1919 +#: reference_raster.xml:1918 #, no-c-format msgid "" "integer ST_Height " @@ -3421,13 +3423,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1929 +#: reference_raster.xml:1928 #, no-c-format msgid "Returns the height of the raster." msgstr "" #. Tag: programlisting -#: reference_raster.xml:1935 +#: reference_raster.xml:1934 #, no-c-format msgid "" "SELECT rid, ST_Height(rast) As rastheight\n" @@ -3440,13 +3442,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1947 +#: reference_raster.xml:1946 #, no-c-format msgid "ST_IsEmpty" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1948 +#: reference_raster.xml:1947 #, no-c-format msgid "" "Returns true if the raster is empty (width = 0 and height = 0). " @@ -3454,7 +3456,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:1953 +#: reference_raster.xml:1952 #, no-c-format msgid "" "boolean ST_IsEmpty " @@ -3462,7 +3464,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:1963 +#: reference_raster.xml:1962 #, no-c-format msgid "" "Returns true if the raster is empty (width = 0 and height = 0). " @@ -3470,7 +3472,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:1971 +#: reference_raster.xml:1970 #, no-c-format msgid "" "SELECT ST_IsEmpty(ST_MakeEmptyRaster(100, 100, 0, 0, 0, 0, 0, 0))\n" @@ -3486,13 +3488,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:1983 +#: reference_raster.xml:1982 #, no-c-format msgid "ST_MemSize" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:1985 +#: reference_raster.xml:1984 #, no-c-format msgid "" "Returns the amount of space (in bytes) the raster takes.integer ST_MemSize " @@ -3508,13 +3510,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2000 +#: reference_raster.xml:1999 #, no-c-format msgid "Returns the amount of space (in bytes) the raster takes." msgstr "" #. Tag: para -#: reference_raster.xml:2001 +#: reference_raster.xml:2000 #, no-c-format msgid "" "This is a nice compliment to PostgreSQL built in functions pg_column_size, " @@ -3522,7 +3524,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2002 +#: reference_raster.xml:2001 #, no-c-format msgid "" "pg_relation_size which gives the byte size of a table may return byte size " @@ -3532,7 +3534,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2004 +#: reference_raster.xml:2003 #, no-c-format msgid "" "pg_total_relation_size - includes, the table, the toasted tables, and the " @@ -3540,7 +3542,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2014 +#: reference_raster.xml:2013 #, no-c-format msgid "" "SELECT ST_MemSize(ST_AsRaster(ST_Buffer(ST_Point(1,5),10,1000),150, 150, " @@ -3552,13 +3554,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2027 +#: reference_raster.xml:2026 #, no-c-format msgid "ST_MetaData" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2028 +#: reference_raster.xml:2027 #, no-c-format msgid "" "Returns basic meta data about a raster object such as pixel size, rotation " @@ -3566,7 +3568,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2033 +#: reference_raster.xml:2032 #, no-c-format msgid "" "record ST_MetaData " @@ -3574,7 +3576,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2043 +#: reference_raster.xml:2042 #, no-c-format msgid "" "Returns basic meta data about a raster object such as pixel size, rotation " @@ -3583,7 +3585,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2050 +#: reference_raster.xml:2049 #, no-c-format msgid "" "SELECT rid, (foo.md).*\n" @@ -3601,26 +3603,26 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2056 reference_raster.xml:5010 +#: reference_raster.xml:2055 reference_raster.xml:5009 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:2062 +#: reference_raster.xml:2061 #, no-c-format msgid "ST_NumBands" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2063 +#: reference_raster.xml:2062 #, no-c-format msgid "" "Returns the number of bands in the raster object." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2068 +#: reference_raster.xml:2067 #, no-c-format msgid "" "integer ST_NumBands " @@ -3628,13 +3630,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2078 +#: reference_raster.xml:2077 #, no-c-format msgid "Returns the number of bands in the raster object." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2084 +#: reference_raster.xml:2083 #, no-c-format msgid "" "SELECT rid, ST_NumBands(rast) As numbands\n" @@ -3647,20 +3649,20 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2096 +#: reference_raster.xml:2095 #, no-c-format msgid "ST_PixelHeight" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2097 +#: reference_raster.xml:2096 #, no-c-format msgid "" "Returns the pixel height in geometric units of the spatial reference system." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2102 +#: reference_raster.xml:2101 #, no-c-format msgid "" "double precision ST_PixelHeight " @@ -3668,7 +3670,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2112 +#: reference_raster.xml:2111 #, no-c-format msgid "" "Returns the height of a pixel in geometric units of the spatial reference " @@ -3677,7 +3679,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2114 +#: reference_raster.xml:2113 #, no-c-format msgid "" "Refer to for a diagrammatic " @@ -3685,13 +3687,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:2118 reference_raster.xml:2178 +#: reference_raster.xml:2117 reference_raster.xml:2177 #, no-c-format msgid "Examples: Rasters with no skew" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2120 +#: reference_raster.xml:2119 #, no-c-format msgid "" "SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,\n" @@ -3707,13 +3709,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:2125 reference_raster.xml:2185 +#: reference_raster.xml:2124 reference_raster.xml:2184 #, no-c-format msgid "Examples: Rasters with skew different than 0" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2127 +#: reference_raster.xml:2126 #, no-c-format msgid "" "SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,\n" @@ -3730,8 +3732,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2134 reference_raster.xml:2194 -#: reference_raster.xml:4290 +#: reference_raster.xml:2133 reference_raster.xml:2193 +#: reference_raster.xml:4289 #, no-c-format msgid "" ", , , double precision ST_PixelWidth " @@ -3760,7 +3762,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2162 +#: reference_raster.xml:2161 #, no-c-format msgid "" "Returns the width of a pixel in geometric units of the spatial reference " @@ -3769,25 +3771,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2164 +#: reference_raster.xml:2163 #, no-c-format msgid "The following diagram demonstrates the relationship:" msgstr "" #. Tag: para -#: reference_raster.xml:2171 +#: reference_raster.xml:2170 #, no-c-format msgid "Pixel Width: Pixel size in the i direction" msgstr "" #. Tag: para -#: reference_raster.xml:2171 +#: reference_raster.xml:2170 #, no-c-format msgid "Pixel Height: Pixel size in the j direction" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2180 +#: reference_raster.xml:2179 #, no-c-format msgid "" "SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,\n" @@ -3803,7 +3805,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2187 +#: reference_raster.xml:2186 #, no-c-format msgid "" "SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,\n" @@ -3821,13 +3823,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2200 +#: reference_raster.xml:2199 #, no-c-format msgid "ST_ScaleX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2201 +#: reference_raster.xml:2200 #, no-c-format msgid "" "Returns the X component of the pixel width in units of coordinate reference " @@ -3835,7 +3837,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2206 +#: reference_raster.xml:2205 #, no-c-format msgid "" "float8 ST_ScaleX " @@ -3843,7 +3845,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2216 +#: reference_raster.xml:2215 #, no-c-format msgid "" "Returns the X component of the pixel width in units of coordinate reference " @@ -3852,13 +3854,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2218 +#: reference_raster.xml:2217 #, no-c-format msgid "Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeX." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2224 +#: reference_raster.xml:2223 #, no-c-format msgid "" "SELECT rid, ST_ScaleX(rast) As rastpixwidth\n" @@ -3871,13 +3873,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2237 +#: reference_raster.xml:2236 #, no-c-format msgid "ST_ScaleY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2238 +#: reference_raster.xml:2237 #, no-c-format msgid "" "Returns the Y component of the pixel height in units of coordinate reference " @@ -3885,7 +3887,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2243 +#: reference_raster.xml:2242 #, no-c-format msgid "" "float8 ST_ScaleY " @@ -3893,7 +3895,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2253 +#: reference_raster.xml:2252 #, no-c-format msgid "" "Returns the Y component of the pixel height in units of coordinate reference " @@ -3902,13 +3904,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2256 +#: reference_raster.xml:2255 #, no-c-format msgid "Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeY." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2262 +#: reference_raster.xml:2261 #, no-c-format msgid "" "SELECT rid, ST_ScaleY(rast) As rastpixheight\n" @@ -3921,13 +3923,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2275 +#: reference_raster.xml:2274 #, no-c-format msgid "ST_RasterToWorldCoord" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2276 +#: reference_raster.xml:2275 #, no-c-format msgid "" "Returns the raster's upper left corner as geometric X and Y (longitude and " @@ -3935,7 +3937,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2281 +#: reference_raster.xml:2280 #, no-c-format msgid "" "record ST_RasterToWorldCoord " @@ -3945,7 +3947,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2293 +#: reference_raster.xml:2292 #, no-c-format msgid "" "Returns the upper left corner as geometric X and Y (longitude and latitude) " @@ -3958,7 +3960,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2305 +#: reference_raster.xml:2304 #, no-c-format msgid "" "-- non-skewed raster\n" @@ -3975,7 +3977,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2307 +#: reference_raster.xml:2306 #, no-c-format msgid "" "-- skewed raster\n" @@ -3997,7 +3999,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2314 +#: reference_raster.xml:2313 #, no-c-format msgid "" ", , float8 ST_RasterToWorldCoordX, float8 ST_RasterToWorldCoordY, float8 ST_Rotation " @@ -4218,7 +4220,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2449 +#: reference_raster.xml:2448 #, no-c-format msgid "" "Returns the uniform rotation of the raster in radian. If a raster does not " @@ -4227,7 +4229,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2456 +#: reference_raster.xml:2455 #, no-c-format msgid "" "SELECT rid, ST_Rotation(ST_SetScale(ST_SetSkew(rast, sqrt(2)), sqrt(2))) as " @@ -4240,25 +4242,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2462 +#: reference_raster.xml:2461 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2468 +#: reference_raster.xml:2467 #, no-c-format msgid "ST_SkewX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2469 +#: reference_raster.xml:2468 #, no-c-format msgid "Returns the georeference X skew (or rotation parameter)." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2474 +#: reference_raster.xml:2473 #, no-c-format msgid "" "float8 ST_SkewX " @@ -4266,7 +4268,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2484 +#: reference_raster.xml:2483 #, no-c-format msgid "" "Returns the georeference X skew (or rotation parameter). Refer to , " msgstr "" #. Tag: refname -#: reference_raster.xml:2504 +#: reference_raster.xml:2503 #, no-c-format msgid "ST_SkewY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2505 +#: reference_raster.xml:2504 #, no-c-format msgid "Returns the georeference Y skew (or rotation parameter)." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2510 +#: reference_raster.xml:2509 #, no-c-format msgid "" "float8 ST_SkewY " @@ -4326,7 +4328,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2520 +#: reference_raster.xml:2519 #, no-c-format msgid "" "Returns the georeference Y skew (or rotation parameter). Refer to , " msgstr "" #. Tag: refname -#: reference_raster.xml:2540 +#: reference_raster.xml:2539 #, no-c-format msgid "ST_SRID" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2541 +#: reference_raster.xml:2540 #, no-c-format msgid "" "Returns the spatial reference identifier of the raster as defined in " @@ -4355,7 +4357,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2546 +#: reference_raster.xml:2545 #, no-c-format msgid "" "integer ST_SRID " @@ -4363,7 +4365,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2556 +#: reference_raster.xml:2555 #, no-c-format msgid "" "Returns the spatial reference identifier of the raster object as defined in " @@ -4371,7 +4373,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2557 +#: reference_raster.xml:2556 #, no-c-format msgid "" "From PostGIS 2.0+ the srid of a non-georeferenced raster/geometry is 0 " @@ -4379,7 +4381,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2563 +#: reference_raster.xml:2562 #, no-c-format msgid "" "SELECT ST_SRID(rast) As srid\n" @@ -4391,19 +4393,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2569 +#: reference_raster.xml:2568 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:2575 +#: reference_raster.xml:2574 #, no-c-format msgid "ST_Summary" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2576 +#: reference_raster.xml:2575 #, no-c-format msgid "" "Returns a text summary of the contents of the raster.text ST_Summary " @@ -4419,13 +4421,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2591 +#: reference_raster.xml:2590 #, no-c-format msgid "Returns a text summary of the contents of the raster." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2598 +#: reference_raster.xml:2597 #, no-c-format msgid "" "SELECT ST_Summary(\n" @@ -4452,7 +4454,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2603 +#: reference_raster.xml:2602 #, no-c-format msgid "" ", , " @@ -4460,13 +4462,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2614 +#: reference_raster.xml:2613 #, no-c-format msgid "ST_UpperLeftX" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2615 +#: reference_raster.xml:2614 #, no-c-format msgid "" "Returns the upper left X coordinate of raster in projected " @@ -4474,7 +4476,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2620 +#: reference_raster.xml:2619 #, no-c-format msgid "" "float8 ST_UpperLeftX " @@ -4482,7 +4484,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2630 +#: reference_raster.xml:2629 #, no-c-format msgid "" "Returns the upper left X coordinate of raster in projected spatial ref." @@ -4490,7 +4492,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2636 +#: reference_raster.xml:2635 #, no-c-format msgid "" "SELECt rid, ST_UpperLeftX(rast) As ulx\n" @@ -4503,19 +4505,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2642 reference_raster.xml:2676 +#: reference_raster.xml:2641 reference_raster.xml:2675 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:2648 +#: reference_raster.xml:2647 #, no-c-format msgid "ST_UpperLeftY" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2649 +#: reference_raster.xml:2648 #, no-c-format msgid "" "Returns the upper left Y coordinate of raster in projected " @@ -4523,7 +4525,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2654 +#: reference_raster.xml:2653 #, no-c-format msgid "" "float8 ST_UpperLeftY " @@ -4531,7 +4533,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2664 +#: reference_raster.xml:2663 #, no-c-format msgid "" "Returns the upper left Y coordinate of raster in projected spatial ref." @@ -4539,7 +4541,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2670 +#: reference_raster.xml:2669 #, no-c-format msgid "" "SELECT rid, ST_UpperLeftY(rast) As uly\n" @@ -4552,19 +4554,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2682 +#: reference_raster.xml:2681 #, no-c-format msgid "ST_Width" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2683 +#: reference_raster.xml:2682 #, no-c-format msgid "Returns the width of the raster in pixels." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2688 +#: reference_raster.xml:2687 #, no-c-format msgid "" "integer ST_Width " @@ -4572,13 +4574,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2698 +#: reference_raster.xml:2697 #, no-c-format msgid "Returns the width of the raster in pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:2704 +#: reference_raster.xml:2703 #, no-c-format msgid "" "SELECT ST_Width(rast) As rastwidth\n" @@ -4590,13 +4592,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2718 +#: reference_raster.xml:2717 #, no-c-format msgid "ST_WorldToRasterCoord" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2719 +#: reference_raster.xml:2718 #, no-c-format msgid "" "Returns the upper left corner as column and row given geometric X and Y " @@ -4605,7 +4607,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2723 +#: reference_raster.xml:2722 #, no-c-format msgid "" " record ST_WorldToRasterCoord, integer ST_WorldToRasterCoordX, integer ST_WorldToRasterCoordY (1) record ST_BandMetaDataoutdbbandnum, " @@ -4868,16 +4870,16 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:2928 reference_raster.xml:3987 -#: reference_raster.xml:6874 reference_raster.xml:7299 -#: reference_raster.xml:8905 reference_raster.xml:9348 -#: reference_raster.xml:9445 reference_raster.xml:9573 +#: reference_raster.xml:2927 reference_raster.xml:3986 +#: reference_raster.xml:6873 reference_raster.xml:7298 +#: reference_raster.xml:8904 reference_raster.xml:9347 +#: reference_raster.xml:9444 reference_raster.xml:9572 #, no-c-format msgid "Examples: Variant 1" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2930 +#: reference_raster.xml:2929 #, no-c-format msgid "" "SELECT\n" @@ -4897,16 +4899,16 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:2935 reference_raster.xml:4000 -#: reference_raster.xml:6918 reference_raster.xml:8912 -#: reference_raster.xml:9353 reference_raster.xml:9450 -#: reference_raster.xml:9578 +#: reference_raster.xml:2934 reference_raster.xml:3999 +#: reference_raster.xml:6917 reference_raster.xml:8911 +#: reference_raster.xml:9352 reference_raster.xml:9449 +#: reference_raster.xml:9577 #, no-c-format msgid "Examples: Variant 2" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2937 +#: reference_raster.xml:2936 #, no-c-format msgid "" "WITH foo AS (\n" @@ -4940,19 +4942,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2944 +#: reference_raster.xml:2943 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:2950 +#: reference_raster.xml:2949 #, no-c-format msgid "ST_BandNoDataValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2951 +#: reference_raster.xml:2950 #, no-c-format msgid "" "Returns the value in a given band that represents no data. If no band num 1 " @@ -4960,7 +4962,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:2956 +#: reference_raster.xml:2955 #, no-c-format msgid "" "double precision ST_BandNoDataValue " @@ -4970,13 +4972,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:2967 reference_raster.xml:3165 +#: reference_raster.xml:2966 #, no-c-format msgid "Returns the value that represents no data for the band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:2973 +#: reference_raster.xml:2972 #, no-c-format msgid "" "SELECT ST_BandNoDataValue(rast,1) As bnval1,\n" @@ -4991,19 +4993,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:2986 +#: reference_raster.xml:2985 #, no-c-format msgid "ST_BandIsNoData" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:2987 +#: reference_raster.xml:2986 #, no-c-format msgid "Returns true if the band is filled with only nodata values." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:2991 +#: reference_raster.xml:2990 #, no-c-format msgid "" " boolean ST_BandIsNoData, text ST_BandPath " @@ -5131,7 +5133,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3060 +#: reference_raster.xml:3059 #, no-c-format msgid "" "Returns system file path to a band. Throws an error if called with an in db " @@ -5139,19 +5141,19 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3066 +#: reference_raster.xml:3065 #, no-c-format msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:3078 +#: reference_raster.xml:3077 #, no-c-format msgid "ST_BandFileSize" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3079 +#: reference_raster.xml:3078 #, no-c-format msgid "" "Returns the file size of a band stored in file system. If no bandnum " @@ -5159,7 +5161,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3084 +#: reference_raster.xml:3083 #, no-c-format msgid "" "bigint ST_BandFileSize " @@ -5169,7 +5171,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3095 +#: reference_raster.xml:3094 #, no-c-format msgid "" "Returns the file size of a band stored in file system. Throws an error if " @@ -5177,7 +5179,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3097 +#: reference_raster.xml:3096 #, no-c-format msgid "" "This function is typically used in conjunction with ST_BandPath() and " @@ -5186,16 +5188,16 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3099 reference_raster.xml:3135 -#: reference_raster.xml:5094 reference_raster.xml:5147 -#: reference_raster.xml:5844 reference_raster.xml:5887 -#: reference_raster.xml:6000 reference_raster.xml:6869 +#: reference_raster.xml:3098 reference_raster.xml:3134 +#: reference_raster.xml:5093 reference_raster.xml:5146 +#: reference_raster.xml:5843 reference_raster.xml:5886 +#: reference_raster.xml:5999 reference_raster.xml:6868 #, no-c-format msgid "Availability: 2.5.0" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3106 +#: reference_raster.xml:3105 #, no-c-format msgid "" "SELECT ST_BandFileSize(rast,1) FROM dummy_rast WHERE rid = 1;\n" @@ -5206,13 +5208,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:3114 +#: reference_raster.xml:3113 #, no-c-format msgid "ST_BandFileTimestamp" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3115 +#: reference_raster.xml:3114 #, no-c-format msgid "" "Returns the file timestamp of a band stored in file system. If no bandnum " @@ -5220,7 +5222,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3120 +#: reference_raster.xml:3119 #, no-c-format msgid "" "bigint ST_BandFileTimestamp " @@ -5230,7 +5232,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3131 +#: reference_raster.xml:3130 #, no-c-format msgid "" "Returns the file timestamp (number of seconds since Jan 1st 1970 00:00:00 " @@ -5239,7 +5241,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3133 +#: reference_raster.xml:3132 #, no-c-format msgid "" "This function is typically used in conjunction with ST_BandPath() and " @@ -5248,7 +5250,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3141 +#: reference_raster.xml:3140 #, no-c-format msgid "" "SELECT ST_BandFileTimestamp(rast,1) FROM dummy_rast WHERE rid = 1;\n" @@ -5259,13 +5261,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:3148 +#: reference_raster.xml:3147 #, no-c-format msgid "ST_BandPixelType" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3149 +#: reference_raster.xml:3148 #, no-c-format msgid "" "Returns the type of pixel for given band. If no bandnum specified, 1 is " @@ -5273,7 +5275,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3154 +#: reference_raster.xml:3153 #, no-c-format msgid "" "text ST_BandPixelType " @@ -5283,79 +5285,87 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3166 +#: reference_raster.xml:3164 +#, no-c-format +msgid "" +"Returns name describing data type and size of values stored in each cell of " +"given band." +msgstr "" + +#. Tag: para +#: reference_raster.xml:3165 #, no-c-format msgid "There are 11 pixel types. Pixel Types supported are as follows:" msgstr "" #. Tag: para -#: reference_raster.xml:3169 +#: reference_raster.xml:3168 #, no-c-format msgid "1BB - 1-bit boolean" msgstr "" #. Tag: para -#: reference_raster.xml:3173 +#: reference_raster.xml:3172 #, no-c-format msgid "2BUI - 2-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3177 +#: reference_raster.xml:3176 #, no-c-format msgid "4BUI - 4-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3181 +#: reference_raster.xml:3180 #, no-c-format msgid "8BSI - 8-bit signed integer" msgstr "" #. Tag: para -#: reference_raster.xml:3184 +#: reference_raster.xml:3183 #, no-c-format msgid "8BUI - 8-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3187 +#: reference_raster.xml:3186 #, no-c-format msgid "16BSI - 16-bit signed integer" msgstr "" #. Tag: para -#: reference_raster.xml:3190 +#: reference_raster.xml:3189 #, no-c-format msgid "16BUI - 16-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3193 +#: reference_raster.xml:3192 #, no-c-format msgid "32BSI - 32-bit signed integer" msgstr "" #. Tag: para -#: reference_raster.xml:3196 +#: reference_raster.xml:3195 #, no-c-format msgid "32BUI - 32-bit unsigned integer" msgstr "" #. Tag: para -#: reference_raster.xml:3199 +#: reference_raster.xml:3198 #, no-c-format msgid "32BF - 32-bit float" msgstr "" #. Tag: para -#: reference_raster.xml:3202 +#: reference_raster.xml:3201 #, no-c-format msgid "64BF - 64-bit float" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3211 +#: reference_raster.xml:3210 #, no-c-format msgid "" "SELECT ST_BandPixelType(rast,1) As btype1,\n" @@ -5369,13 +5379,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:3223 +#: reference_raster.xml:3222 #, no-c-format msgid "ST_HasNoBand" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3224 +#: reference_raster.xml:3223 #, no-c-format msgid "" "Returns true if there is no band with given band number. If no " @@ -5383,7 +5393,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3229 +#: reference_raster.xml:3228 #, no-c-format msgid "" "boolean ST_HasNoBand " @@ -5392,7 +5402,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3240 +#: reference_raster.xml:3239 #, no-c-format msgid "" "Returns true if there is no band with given band number. If no band " @@ -5400,7 +5410,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3248 +#: reference_raster.xml:3247 #, no-c-format msgid "" "SELECT rid, ST_HasNoBand(rast) As hb1, ST_HasNoBand(rast,2) as hb2,\n" @@ -5414,19 +5424,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:3261 +#: reference_raster.xml:3260 #, no-c-format msgid "Raster Pixel Accessors and Setters" msgstr "" #. Tag: refname -#: reference_raster.xml:3265 +#: reference_raster.xml:3264 #, no-c-format msgid "ST_PixelAsPolygon" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3266 +#: reference_raster.xml:3265 #, no-c-format msgid "" "Returns the polygon geometry that bounds the pixel for a " @@ -5434,7 +5444,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3271 +#: reference_raster.xml:3270 #, no-c-format msgid "" "geometry ST_PixelAsPolygon " @@ -5444,7 +5454,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3283 +#: reference_raster.xml:3282 #, no-c-format msgid "" "Returns the polygon geometry that bounds the pixel for a particular " @@ -5452,7 +5462,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3291 +#: reference_raster.xml:3290 #, no-c-format msgid "" "-- get raster pixel polygon\n" @@ -5472,7 +5482,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3296 +#: reference_raster.xml:3295 #, no-c-format msgid "" ", , setof record ST_PixelAsPolygons " @@ -5507,7 +5517,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3329 +#: reference_raster.xml:3328 #, no-c-format msgid "" "Returns the polygon geometry that bounds every pixel of a raster band along " @@ -5516,8 +5526,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3331 reference_raster.xml:3437 -#: reference_raster.xml:3534 +#: reference_raster.xml:3330 reference_raster.xml:3436 +#: reference_raster.xml:3533 #, no-c-format msgid "" "Return record format: geom exclude_nodata_value = TRUE, only those pixels " @@ -5535,7 +5545,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3341 +#: reference_raster.xml:3340 #, no-c-format msgid "" "ST_PixelAsPolygons returns one polygon geometry for every pixel. This is " @@ -5544,20 +5554,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3347 +#: reference_raster.xml:3346 #, no-c-format msgid "Enhanced: 2.1.0 exclude_nodata_value optional argument was added." msgstr "" #. Tag: para -#: reference_raster.xml:3348 reference_raster.xml:3446 -#: reference_raster.xml:3544 +#: reference_raster.xml:3347 reference_raster.xml:3445 +#: reference_raster.xml:3543 #, no-c-format msgid "Changed: 2.1.1 Changed behavior of exclude_nodata_value." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3353 +#: reference_raster.xml:3352 #, no-c-format msgid "" "-- get raster pixel polygon\n" @@ -5583,7 +5593,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3358 +#: reference_raster.xml:3357 #, no-c-format msgid "" ", , Returns a point geometry of the pixel's upper-left corner.geometry ST_PixelAsPoint " @@ -5617,13 +5627,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3390 +#: reference_raster.xml:3389 #, no-c-format msgid "Returns a point geometry of the pixel's upper-left corner." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3396 +#: reference_raster.xml:3395 #, no-c-format msgid "" "SELECT ST_AsText(ST_PixelAsPoint(rast, 1, 1)) FROM dummy_rast WHERE rid = " @@ -5635,7 +5645,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3401 +#: reference_raster.xml:3400 #, no-c-format msgid "" ", , Returns a point geometry for each pixel of a raster band along " @@ -5661,7 +5671,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3422 +#: reference_raster.xml:3421 #, no-c-format msgid "" "setof record ST_PixelAsPoints " @@ -5672,7 +5682,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3433 +#: reference_raster.xml:3432 #, no-c-format msgid "" "Returns a point geometry for each pixel of a raster band along with " @@ -5681,7 +5691,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3451 +#: reference_raster.xml:3450 #, no-c-format msgid "" "SELECT x, y, val, ST_AsText(geom) FROM (SELECT (ST_PixelAsPoints(rast, 1)).* " @@ -5717,7 +5727,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3456 +#: reference_raster.xml:3455 #, no-c-format msgid "" ", , Returns the centroid (point geometry) of the area represented by " @@ -5741,7 +5751,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3477 +#: reference_raster.xml:3476 #, no-c-format msgid "" "geometry ST_PixelAsCentroid " @@ -5751,7 +5761,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3488 +#: reference_raster.xml:3487 #, no-c-format msgid "" "Returns the centroid (point geometry) of the area represented by a " @@ -5759,7 +5769,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3494 +#: reference_raster.xml:3493 #, no-c-format msgid "" "SELECT ST_AsText(ST_PixelAsCentroid(rast, 1, 1)) FROM dummy_rast WHERE rid = " @@ -5771,7 +5781,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3499 +#: reference_raster.xml:3498 #, no-c-format msgid "" ", , Returns the centroid (point geometry) for each pixel of a raster " @@ -5796,7 +5806,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:3520 +#: reference_raster.xml:3519 #, no-c-format msgid "" "setof record ST_PixelAsCentroids " @@ -5807,7 +5817,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3531 +#: reference_raster.xml:3530 #, no-c-format msgid "" "Returns the centroid (point geometry) for each pixel of a raster band " @@ -5816,7 +5826,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3549 +#: reference_raster.xml:3548 #, no-c-format msgid "" "--LATERAL syntax requires PostgreSQL 9.3+\n" @@ -5853,7 +5863,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3554 +#: reference_raster.xml:3553 #, no-c-format msgid "" ", , double precision ST_Value, NODATA value of a given band's " @@ -6133,7 +6143,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3657 +#: reference_raster.xml:3656 #, no-c-format msgid "" " double precision ST_NearestValueNODATA value of a given band in a " @@ -6174,7 +6184,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3697 reference_raster.xml:3784 +#: reference_raster.xml:3696 reference_raster.xml:3783 #, no-c-format msgid "" "Band numbers start at 1 and bandnum is assumed to be 1 if " @@ -6185,13 +6195,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3702 +#: reference_raster.xml:3701 #, no-c-format msgid "ST_NearestValue is a drop-in replacement for ST_Value." msgstr "" #. Tag: programlisting -#: reference_raster.xml:3711 +#: reference_raster.xml:3710 #, no-c-format msgid "" "-- pixel 2x2 has value\n" @@ -6229,7 +6239,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3713 +#: reference_raster.xml:3712 #, no-c-format msgid "" "-- pixel 2x3 is NODATA\n" @@ -6267,19 +6277,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3719 +#: reference_raster.xml:3718 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:3729 +#: reference_raster.xml:3728 #, no-c-format msgid "ST_Neighborhood" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3730 +#: reference_raster.xml:3729 #, no-c-format msgid "" "Returns a 2-D double precision array of the non-NODATA " @@ -6289,7 +6299,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3736 +#: reference_raster.xml:3735 #, no-c-format msgid "" " double precision[][] ST_NeighborhoodNODATA " @@ -6342,7 +6352,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3788 +#: reference_raster.xml:3787 #, no-c-format msgid "" "The number of elements along each axis of the returning 2-D array is 2 * " @@ -6352,7 +6362,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3793 +#: reference_raster.xml:3792 #, no-c-format msgid "" "The 2-D array output can be passed to any of the raster processing builtin " @@ -6360,7 +6370,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3803 +#: reference_raster.xml:3802 #, no-c-format msgid "" "-- pixel 2x2 has value\n" @@ -6391,7 +6401,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3805 +#: reference_raster.xml:3804 #, no-c-format msgid "" "-- pixel 2x3 is NODATA\n" @@ -6422,7 +6432,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3807 +#: reference_raster.xml:3806 #, no-c-format msgid "" "-- pixel 3x3 has value\n" @@ -6453,7 +6463,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3813 +#: reference_raster.xml:3812 #, no-c-format msgid "" ", , , raster ST_SetValue " @@ -6506,7 +6516,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3869 +#: reference_raster.xml:3868 #, no-c-format msgid "" "Returns modified raster resulting from setting the specified pixels' values " @@ -6515,7 +6525,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3872 +#: reference_raster.xml:3871 #, no-c-format msgid "" "Enhanced: 2.1.0 Geometry variant of ST_SetValue() now supports any geometry " @@ -6524,7 +6534,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3878 +#: reference_raster.xml:3877 #, no-c-format msgid "" "-- Geometry example\n" @@ -6547,7 +6557,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3880 +#: reference_raster.xml:3879 #, no-c-format msgid "" "-- Store the changed raster --\n" @@ -6557,26 +6567,26 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3884 reference_raster.xml:9962 +#: reference_raster.xml:3883 reference_raster.xml:9961 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:3890 +#: reference_raster.xml:3889 #, no-c-format msgid "ST_SetValues" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:3891 +#: reference_raster.xml:3890 #, no-c-format msgid "" "Returns modified raster resulting from setting the values of a given band." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:3895 +#: reference_raster.xml:3894 #, no-c-format msgid "" " raster ST_SetValues " @@ -6624,15 +6634,16 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3954 +#: reference_raster.xml:3953 #, no-c-format msgid "" "Returns modified raster resulting from setting specified pixels to new " -"value(s) for the designated band." +"value(s) for the designated band. columnx and " +"rowy are 1-indexed." msgstr "" #. Tag: para -#: reference_raster.xml:3958 +#: reference_raster.xml:3957 #, no-c-format msgid "" "If keepnodata is TRUE, those pixels whose values are " @@ -6641,7 +6652,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3962 +#: reference_raster.xml:3961 #, no-c-format msgid "" "For Variant 1, the specific pixels to be set are determined by the " @@ -6653,7 +6664,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3966 +#: reference_raster.xml:3965 #, no-c-format msgid "" "Variant 2 is like Variant 1 but with a simple double precision " @@ -6663,7 +6674,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3970 +#: reference_raster.xml:3969 #, no-c-format msgid "" "For Variant 3, the specific pixels to be set are determined by the " @@ -6673,7 +6684,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3974 +#: reference_raster.xml:3973 #, no-c-format msgid "" "Variant 4 is the same as Variant 3 with the exception that it assumes that " @@ -6681,7 +6692,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:3978 +#: reference_raster.xml:3977 #, no-c-format msgid "" "For Variant 5, an array of is used to determine " @@ -6693,7 +6704,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3989 +#: reference_raster.xml:3988 #, no-c-format msgid "" "/*\n" @@ -6741,7 +6752,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3991 +#: reference_raster.xml:3990 #, no-c-format msgid "" "/*\n" @@ -6789,7 +6800,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3993 +#: reference_raster.xml:3992 #, no-c-format msgid "" "/*\n" @@ -6839,7 +6850,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:3995 +#: reference_raster.xml:3994 #, no-c-format msgid "" "/*\n" @@ -6893,7 +6904,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4002 +#: reference_raster.xml:4001 #, no-c-format msgid "" "/*\n" @@ -6941,7 +6952,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4004 +#: reference_raster.xml:4003 #, no-c-format msgid "" "/*\n" @@ -6992,13 +7003,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:4009 reference_raster.xml:4954 +#: reference_raster.xml:4008 reference_raster.xml:4953 #, no-c-format msgid "Examples: Variant 3" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4011 +#: reference_raster.xml:4010 #, no-c-format msgid "" "/*\n" @@ -7045,7 +7056,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4013 +#: reference_raster.xml:4012 #, no-c-format msgid "" "/*\n" @@ -7095,13 +7106,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:4018 +#: reference_raster.xml:4017 #, no-c-format msgid "Examples: Variant 5" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4020 +#: reference_raster.xml:4019 #, no-c-format msgid "" "WITH foo AS (\n" @@ -7138,7 +7149,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4022 +#: reference_raster.xml:4021 #, no-c-format msgid "" "The following shows that geomvals later in the array can overwrite prior " @@ -7146,7 +7157,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4023 +#: reference_raster.xml:4022 #, no-c-format msgid "" "WITH foo AS (\n" @@ -7180,13 +7191,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4025 +#: reference_raster.xml:4024 #, no-c-format msgid "This example is the opposite of the prior example" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4026 +#: reference_raster.xml:4025 #, no-c-format msgid "" "WITH foo AS (\n" @@ -7220,7 +7231,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4033 +#: reference_raster.xml:4032 #, no-c-format msgid "" ", , setof record ST_DumpValues, " msgstr "" #. Tag: refname -#: reference_raster.xml:4110 +#: reference_raster.xml:4109 #, no-c-format msgid "ST_PixelOfValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4111 +#: reference_raster.xml:4110 #, no-c-format msgid "" "Get the columnx, rowy coordinates of the pixel whose value equals the search " @@ -7345,7 +7356,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4117 +#: reference_raster.xml:4116 #, no-c-format msgid "" " setof record ST_PixelOfValue raster ST_SetGeoReference, , float8 ST_SetRotation " @@ -7589,7 +7600,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4278 +#: reference_raster.xml:4277 #, no-c-format msgid "" "Uniformly rotate the raster. Rotation is in radian. Refer to raster ST_SetScale " @@ -7646,7 +7657,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4321 +#: reference_raster.xml:4320 #, no-c-format msgid "" "Sets the X and Y size of pixels in units of coordinate reference system. " @@ -7655,7 +7666,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4324 +#: reference_raster.xml:4323 #, no-c-format msgid "" "ST_SetScale is different from in that " @@ -7668,7 +7679,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4326 +#: reference_raster.xml:4325 #, no-c-format msgid "" "Changed: 2.0.0 In WKTRaster versions this was called ST_SetPixelSize. This " @@ -7676,7 +7687,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4332 +#: reference_raster.xml:4331 #, no-c-format msgid "" "UPDATE dummy_rast\n" @@ -7694,7 +7705,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4333 +#: reference_raster.xml:4332 #, no-c-format msgid "" "UPDATE dummy_rast\n" @@ -7712,19 +7723,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4339 +#: reference_raster.xml:4338 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:4345 +#: reference_raster.xml:4344 #, no-c-format msgid "ST_SetSkew" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4346 +#: reference_raster.xml:4345 #, no-c-format msgid "" "Sets the georeference X and Y skew (or rotation parameter). If only one is " @@ -7732,7 +7743,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4350 +#: reference_raster.xml:4349 #, no-c-format msgid "" " raster ST_SetSkew " @@ -7746,7 +7757,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4368 +#: reference_raster.xml:4367 #, no-c-format msgid "" "Sets the georeference X and Y skew (or rotation parameter). If only one is " @@ -7755,7 +7766,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4375 +#: reference_raster.xml:4374 #, no-c-format msgid "" "-- Example 1\n" @@ -7775,7 +7786,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4377 +#: reference_raster.xml:4376 #, no-c-format msgid "" "-- Example 2 set both to same number:\n" @@ -7795,7 +7806,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4384 +#: reference_raster.xml:4383 #, no-c-format msgid "" ", , raster ST_SetSRID " @@ -7826,13 +7837,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4412 +#: reference_raster.xml:4411 #, no-c-format msgid "Sets the SRID on a raster to a particular integer value." msgstr "" #. Tag: para -#: reference_raster.xml:4415 +#: reference_raster.xml:4414 #, no-c-format msgid "" "This function does not transform the raster in any way - it simply sets meta " @@ -7841,19 +7852,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4425 +#: reference_raster.xml:4424 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:4432 +#: reference_raster.xml:4431 #, no-c-format msgid "ST_SetUpperLeft" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4433 +#: reference_raster.xml:4432 #, no-c-format msgid "" "Sets the value of the upper left corner of the pixel of the raster to " @@ -7861,7 +7872,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:4438 +#: reference_raster.xml:4437 #, no-c-format msgid "" "raster ST_SetUpperLeft " @@ -7871,7 +7882,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4450 +#: reference_raster.xml:4449 #, no-c-format msgid "" "Set the value of the upper left corner of raster to the projected X and Y " @@ -7879,7 +7890,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4456 +#: reference_raster.xml:4455 #, no-c-format msgid "" "SELECT ST_SetUpperLeft(rast,-71.01,42.37)\n" @@ -7888,19 +7899,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4462 +#: reference_raster.xml:4461 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:4468 +#: reference_raster.xml:4467 #, no-c-format msgid "ST_Resample" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4469 +#: reference_raster.xml:4468 #, no-c-format msgid "" "Resample a raster using a specified resampling algorithm, new dimensions, an " @@ -7909,7 +7920,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4475 +#: reference_raster.xml:4474 #, no-c-format msgid "" " raster ST_Resample " @@ -7958,7 +7969,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4525 +#: reference_raster.xml:4524 #, no-c-format msgid "" "Resample a raster using a specified resampling algorithm, new dimensions " @@ -7969,7 +7980,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4529 +#: reference_raster.xml:4528 #, no-c-format msgid "" "New pixel values are computed using the NearestNeighbor (English or American " @@ -7979,7 +7990,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4533 reference_raster.xml:4600 +#: reference_raster.xml:4532 #, no-c-format msgid "" "A maxerror percent of 0.125 is used if no maxerr is " @@ -7987,8 +7998,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4538 reference_raster.xml:4602 -#: reference_raster.xml:4670 reference_raster.xml:4748 +#: reference_raster.xml:4537 reference_raster.xml:4601 +#: reference_raster.xml:4669 reference_raster.xml:4747 #, no-c-format msgid "" "Refer to: GDAL Warp " @@ -7996,15 +8007,15 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4542 reference_raster.xml:4606 -#: reference_raster.xml:4674 reference_raster.xml:4752 -#: reference_raster.xml:4908 +#: reference_raster.xml:4541 reference_raster.xml:4605 +#: reference_raster.xml:4673 reference_raster.xml:4751 +#: reference_raster.xml:4907 #, no-c-format msgid "Availability: 2.0.0 Requires GDAL 1.6.1+" msgstr "" #. Tag: para -#: reference_raster.xml:4543 +#: reference_raster.xml:4542 #, no-c-format msgid "" "Changed: 2.1.0 Parameter srid removed. Variants with a reference raster no " @@ -8013,7 +8024,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4549 +#: reference_raster.xml:4548 #, no-c-format msgid "" "SELECT\n" @@ -8038,19 +8049,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4554 +#: reference_raster.xml:4553 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:4564 +#: reference_raster.xml:4563 #, no-c-format msgid "ST_Rescale" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4565 +#: reference_raster.xml:4564 #, no-c-format msgid "" "Resample a raster by adjusting only its scale (or pixel size). New pixel " @@ -8060,7 +8071,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4570 +#: reference_raster.xml:4569 #, no-c-format msgid "" " raster ST_Rescale " @@ -8080,7 +8091,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4594 +#: reference_raster.xml:4593 #, no-c-format msgid "" "Resample a raster by adjusting only its scale (or pixel size). New pixel " @@ -8091,7 +8102,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4596 +#: reference_raster.xml:4595 #, no-c-format msgid "" "scalex and scaley define the new pixel " @@ -8099,7 +8110,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4598 +#: reference_raster.xml:4597 #, no-c-format msgid "" "When the new scalex or scaley is not a divisor of the raster width or " @@ -8109,7 +8120,17 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4604 +#: reference_raster.xml:4599 +#, no-c-format +msgid "" +"maxerr is the threshold for transformation approximation " +"by the resampling algorithm (in pixel units). A default of 0.125 is used if " +"no maxerr is specified, which is the same value used in " +"GDAL gdalwarp utility. If set to zero, no approximation takes place." +msgstr "" + +#. Tag: para +#: reference_raster.xml:4603 #, no-c-format msgid "" "ST_Rescale is different from in that " @@ -8122,14 +8143,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4607 reference_raster.xml:4675 -#: reference_raster.xml:4753 +#: reference_raster.xml:4606 reference_raster.xml:4674 +#: reference_raster.xml:4752 #, no-c-format msgid "Changed: 2.1.0 Works on rasters with no SRID" msgstr "" #. Tag: para -#: reference_raster.xml:4612 +#: reference_raster.xml:4611 #, no-c-format msgid "" "A simple example rescaling a raster from a pixel size of 0.001 degree to a " @@ -8137,7 +8158,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4614 +#: reference_raster.xml:4613 #, no-c-format msgid "" "-- the original raster pixel size\n" @@ -8158,7 +8179,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4619 +#: reference_raster.xml:4618 #, no-c-format msgid "" ", , , " @@ -8167,13 +8188,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:4632 +#: reference_raster.xml:4631 #, no-c-format msgid "ST_Reskew" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4633 +#: reference_raster.xml:4632 #, no-c-format msgid "" "Resample a raster by adjusting only its skew (or rotation parameters). New " @@ -8183,7 +8204,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4638 +#: reference_raster.xml:4637 #, no-c-format msgid "" " raster ST_Reskew " @@ -8203,7 +8224,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4662 +#: reference_raster.xml:4661 #, no-c-format msgid "" "Resample a raster by adjusting only its skew (or rotation parameters). New " @@ -8214,14 +8235,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4664 +#: reference_raster.xml:4663 #, no-c-format msgid "" "skewx and skewy define the new skew." msgstr "" #. Tag: para -#: reference_raster.xml:4666 reference_raster.xml:4744 +#: reference_raster.xml:4665 reference_raster.xml:4743 #, no-c-format msgid "" "The extent of the new raster will encompass the extent of the provided " @@ -8229,14 +8250,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4668 reference_raster.xml:4746 +#: reference_raster.xml:4667 reference_raster.xml:4745 #, no-c-format msgid "" "A maxerror percent of 0.125 if no maxerr is specified." msgstr "" #. Tag: para -#: reference_raster.xml:4672 +#: reference_raster.xml:4671 #, no-c-format msgid "" "ST_Reskew is different from in that " @@ -8249,14 +8270,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4680 +#: reference_raster.xml:4679 #, 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:4682 +#: reference_raster.xml:4681 #, no-c-format msgid "" "-- the original raster non-rotated\n" @@ -8275,7 +8296,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4688 +#: reference_raster.xml:4687 #, no-c-format msgid "" ", , , " @@ -8284,13 +8305,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:4694 +#: reference_raster.xml:4693 #, no-c-format msgid "ST_SnapToGrid" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4695 +#: reference_raster.xml:4694 #, no-c-format msgid "" "Resample a raster by snapping it to a grid. New pixel values are computed " @@ -8299,7 +8320,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4700 +#: reference_raster.xml:4699 #, no-c-format msgid "" " raster ST_SnapToGrid " @@ -8335,7 +8356,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4739 +#: reference_raster.xml:4738 #, no-c-format msgid "" "Resample a raster by snapping it to a grid defined by an arbitrary pixel " @@ -8347,7 +8368,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4741 +#: reference_raster.xml:4740 #, no-c-format msgid "" "gridx and gridy define any arbitrary " @@ -8357,7 +8378,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4743 +#: reference_raster.xml:4742 #, no-c-format msgid "" "You can optionally define the pixel size of the new grid with " @@ -8365,7 +8386,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4750 +#: reference_raster.xml:4749 #, no-c-format msgid "" "Use if you need more control over the " @@ -8373,13 +8394,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4758 +#: reference_raster.xml:4757 #, no-c-format msgid "A simple example snapping a raster to a slightly different grid." msgstr "" #. Tag: programlisting -#: reference_raster.xml:4760 +#: reference_raster.xml:4759 #, no-c-format msgid "" "-- the original raster upper left X\n" @@ -8397,7 +8418,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4766 +#: reference_raster.xml:4765 #, no-c-format msgid "" ", , , " @@ -8405,19 +8426,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:4772 +#: reference_raster.xml:4771 #, no-c-format msgid "ST_Resize" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4773 +#: reference_raster.xml:4772 #, no-c-format msgid "Resize a raster to a new width/height" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4777 +#: reference_raster.xml:4776 #, no-c-format msgid "" " raster ST_Resize " @@ -8446,7 +8467,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4811 +#: reference_raster.xml:4810 #, no-c-format msgid "" "Resize a raster to a new width/height. The new width/height can be specified " @@ -8456,7 +8477,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4815 +#: reference_raster.xml:4814 #, no-c-format msgid "" "New pixel values are computed using the NearestNeighbor (english or american " @@ -8466,13 +8487,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4819 +#: reference_raster.xml:4818 #, no-c-format msgid "Variant 1 expects the actual width/height of the output raster." msgstr "" #. Tag: para -#: reference_raster.xml:4823 +#: reference_raster.xml:4822 #, no-c-format msgid "" "Variant 2 expects decimal values between zero (0) and one (1) indicating the " @@ -8480,7 +8501,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4827 +#: reference_raster.xml:4826 #, no-c-format msgid "" "Variant 3 takes either the actual width/height of the output raster or a " @@ -8489,13 +8510,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4831 +#: reference_raster.xml:4830 #, no-c-format msgid "Availability: 2.1.0 Requires GDAL 1.6.1+" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4835 +#: reference_raster.xml:4834 #, no-c-format msgid "" "WITH foo AS(\n" @@ -8547,7 +8568,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4840 +#: reference_raster.xml:4839 #, no-c-format msgid "" ", , , raster ST_Transform " @@ -8602,7 +8623,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4890 +#: reference_raster.xml:4889 #, no-c-format msgid "" "Reprojects a raster in a known spatial reference system to another known " @@ -8612,7 +8633,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4894 +#: reference_raster.xml:4893 #, no-c-format msgid "" "ST_Transform is often confused with ST_SetSRID(). ST_Transform actually " @@ -8622,7 +8643,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4898 +#: reference_raster.xml:4897 #, no-c-format msgid "" "Unlike the other variants, Variant 3 requires a reference raster as " @@ -8632,7 +8653,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4903 +#: reference_raster.xml:4902 #, no-c-format msgid "" "If you find your transformation support is not working right, you may need " @@ -8645,13 +8666,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4909 +#: reference_raster.xml:4908 #, no-c-format msgid "Enhanced: 2.1.0 Addition of ST_Transform(rast, alignto) variant" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4915 +#: reference_raster.xml:4914 #, no-c-format msgid "" "SELECT ST_Width(mass_stm) As w_before, ST_Width(wgs_84) As w_after,\n" @@ -8671,19 +8692,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4925 +#: reference_raster.xml:4924 #, no-c-format msgid "original mass state plane meters (mass_stm)" msgstr "" #. Tag: para -#: reference_raster.xml:4934 +#: reference_raster.xml:4933 #, no-c-format msgid "After transform to wgs 84 long lat (wgs_84)" msgstr "" #. Tag: para -#: reference_raster.xml:4943 +#: reference_raster.xml:4942 #, no-c-format msgid "" "After transform to wgs 84 long lat with bilinear algorithm instead of NN " @@ -8691,7 +8712,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4956 +#: reference_raster.xml:4955 #, no-c-format msgid "" "The following shows the difference between using ST_Transform(raster, srid) " @@ -8699,7 +8720,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:4957 +#: reference_raster.xml:4956 #, no-c-format msgid "" "WITH foo AS (\n" @@ -8749,25 +8770,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:4962 +#: reference_raster.xml:4961 #, no-c-format msgid ", " msgstr "" #. Tag: title -#: reference_raster.xml:4968 +#: reference_raster.xml:4967 #, no-c-format msgid "Raster Band Editors" msgstr "" #. Tag: refname -#: reference_raster.xml:4972 +#: reference_raster.xml:4971 #, no-c-format msgid "ST_SetBandNoDataValue" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:4973 +#: reference_raster.xml:4972 #, no-c-format msgid "" "Sets the value for the given band that represents no data. Band 1 is assumed " @@ -8776,7 +8797,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:4977 +#: reference_raster.xml:4976 #, no-c-format msgid "" " raster ST_SetBandNoDataValueraster ST_SetBandIsNoData " @@ -8851,7 +8872,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5033 +#: reference_raster.xml:5032 #, no-c-format msgid "" "Sets the isnodata flag for the band to true. Band 1 is assumed if not " @@ -8861,7 +8882,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5045 +#: reference_raster.xml:5044 #, no-c-format msgid "" "-- Create dummy table with one raster column\n" @@ -8929,7 +8950,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5051 +#: reference_raster.xml:5050 #, no-c-format msgid "" ", , raster ST_SetBandPath " @@ -8962,14 +8983,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5080 +#: reference_raster.xml:5079 #, no-c-format msgid "" "Updates an out-db band's external raster file path and external band number." msgstr "" #. Tag: para -#: reference_raster.xml:5083 +#: reference_raster.xml:5082 #, no-c-format msgid "" "If force is set to true, no tests are done to ensure " @@ -8979,7 +9000,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5089 reference_raster.xml:5142 +#: reference_raster.xml:5088 reference_raster.xml:5141 #, no-c-format msgid "" "Internally, this method replaces the PostGIS raster's band at index " @@ -8988,7 +9009,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5099 +#: reference_raster.xml:5098 #, no-c-format msgid "" "WITH foo AS (\n" @@ -9045,25 +9066,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5104 +#: reference_raster.xml:5103 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:5114 +#: reference_raster.xml:5113 #, no-c-format msgid "ST_SetBandIndex" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5115 +#: reference_raster.xml:5114 #, no-c-format msgid "Update the external band number of an out-db band" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:5120 +#: reference_raster.xml:5119 #, no-c-format msgid "" "raster ST_SetBandIndex " @@ -9075,7 +9096,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5133 +#: reference_raster.xml:5132 #, no-c-format msgid "" "Updates an out-db band's external band number. This does not touch the " @@ -9083,7 +9104,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5136 +#: reference_raster.xml:5135 #, no-c-format msgid "" "If force is set to true, no tests are done to ensure " @@ -9093,7 +9114,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5152 +#: reference_raster.xml:5151 #, no-c-format msgid "" "WITH foo AS (\n" @@ -9148,25 +9169,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5157 +#: reference_raster.xml:5156 #, no-c-format msgid ", " msgstr "" #. Tag: title -#: reference_raster.xml:5168 +#: reference_raster.xml:5167 #, no-c-format msgid "Raster Band Statistics and Analytics" msgstr "" #. Tag: refname -#: reference_raster.xml:5172 +#: reference_raster.xml:5171 #, no-c-format msgid "ST_Count" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5173 +#: reference_raster.xml:5172 #, no-c-format msgid "" "Returns the number of pixels in a given band of a raster or raster coverage. " @@ -9175,7 +9196,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5177 +#: reference_raster.xml:5176 #, no-c-format msgid "" " bigint ST_Count " @@ -9200,7 +9221,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5208 +#: reference_raster.xml:5207 #, no-c-format msgid "" "Returns the number of pixels in a given band of a raster or raster coverage. " @@ -9208,7 +9229,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5209 +#: reference_raster.xml:5208 #, no-c-format msgid "" "If exclude_nodata_value is set to true, will only count " @@ -9218,7 +9239,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5213 +#: reference_raster.xml:5212 #, no-c-format msgid "" "The ST_Count(rastertable, rastercolumn, ...) variants are deprecated as of " @@ -9226,7 +9247,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5223 +#: reference_raster.xml:5222 #, no-c-format msgid "" "--example will count all pixels not 249 and one will count all pixels. --\n" @@ -9240,7 +9261,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5228 reference_raster.xml:5289 +#: reference_raster.xml:5227 reference_raster.xml:5288 #, no-c-format msgid "" ", , bigint ST_CountAgg " @@ -9283,7 +9304,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5273 +#: reference_raster.xml:5272 #, no-c-format msgid "" "Returns the number of pixels in a given band of a set of rasters. If no band " @@ -9291,7 +9312,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5274 +#: reference_raster.xml:5273 #, no-c-format msgid "" "If exclude_nodata_value is set to true, will only count " @@ -9301,7 +9322,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5277 +#: reference_raster.xml:5276 #, no-c-format msgid "" "By default will sample all pixels. To get faster response, set " @@ -9309,7 +9330,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5284 +#: reference_raster.xml:5283 #, no-c-format msgid "" "WITH foo AS (\n" @@ -9347,13 +9368,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:5299 +#: reference_raster.xml:5298 #, no-c-format msgid "ST_Histogram" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5300 +#: reference_raster.xml:5299 #, no-c-format msgid "" "Returns a set of record summarizing a raster or raster coverage data " @@ -9362,7 +9383,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5304 +#: reference_raster.xml:5303 #, no-c-format msgid "" " SETOF record ST_Histogramnodatawidth double precision[]" msgstr "" #. Tag: para -#: reference_raster.xml:5392 +#: reference_raster.xml:5391 #, no-c-format msgid "" "width: an array indicating the width of each category/bin. If the number of " @@ -9462,7 +9483,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5393 +#: reference_raster.xml:5392 #, no-c-format msgid "" "Example: 9 bins, widths are [a, b, c] will have the output be [a, b, c, a, " @@ -9470,13 +9491,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:5396 +#: reference_raster.xml:5395 #, no-c-format msgid "bins integer" msgstr "" #. Tag: para -#: reference_raster.xml:5397 +#: reference_raster.xml:5396 #, no-c-format msgid "" "Number of breakouts -- this is the number of records you'll get back from " @@ -9485,13 +9506,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:5401 +#: reference_raster.xml:5400 #, no-c-format msgid "right boolean" msgstr "" #. Tag: para -#: reference_raster.xml:5402 +#: reference_raster.xml:5401 #, no-c-format msgid "" "compute the histogram from the right rather than from the left (default). " @@ -9499,7 +9520,7 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:5409 +#: reference_raster.xml:5408 #, no-c-format msgid "" "Example: Single raster tile - compute histograms for bands 1, 2, 3 and " @@ -9507,7 +9528,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5410 +#: reference_raster.xml:5409 #, no-c-format msgid "" "SELECT band, (stats).*\n" @@ -9535,13 +9556,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:5414 +#: reference_raster.xml:5413 #, no-c-format msgid "Example: Just band 2 but for 6 bins" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5415 +#: reference_raster.xml:5414 #, no-c-format msgid "" "SELECT (stats).*\n" @@ -9578,7 +9599,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5420 +#: reference_raster.xml:5419 #, no-c-format msgid "" ", , Compute quantiles for a raster or raster table coverage in the " @@ -9601,7 +9622,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5435 +#: reference_raster.xml:5434 #, no-c-format msgid "" " SETOF record ST_QuantileCompute quantiles for a raster or raster table coverage in the context " @@ -9668,7 +9689,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5508 reference_raster.xml:5800 +#: reference_raster.xml:5507 reference_raster.xml:5799 #, no-c-format msgid "" "If exclude_nodata_value is set to false, will also count " @@ -9676,7 +9697,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5515 +#: reference_raster.xml:5514 #, no-c-format msgid "" "UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;\n" @@ -9702,7 +9723,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5516 +#: reference_raster.xml:5515 #, no-c-format msgid "" "--real live example. Quantile of all pixels in band 2 intersecting a " @@ -9742,7 +9763,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5521 +#: reference_raster.xml:5520 #, no-c-format msgid "" ", , summarystats ST_SummaryStats consisting of count, sum, mean, " @@ -9799,7 +9820,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5575 +#: reference_raster.xml:5574 #, no-c-format msgid "" "By default only considers pixel values not equal to the nodata, summarystats ST_SummaryStatsAggNODATA, , " @@ -10049,13 +10070,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:5679 +#: reference_raster.xml:5678 #, no-c-format msgid "ST_ValueCount" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5680 +#: reference_raster.xml:5679 #, no-c-format msgid "" "Returns a set of records containing a pixel band value and count of the " @@ -10066,7 +10087,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5685 +#: reference_raster.xml:5684 #, no-c-format msgid "" " SETOF record ST_ValueCountvalue " @@ -10176,7 +10197,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5799 +#: reference_raster.xml:5798 #, no-c-format msgid "" "If no band is specified nband defaults to 1. If no " @@ -10187,7 +10208,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5807 +#: reference_raster.xml:5806 #, no-c-format msgid "" "UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;\n" @@ -10241,7 +10262,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5808 +#: reference_raster.xml:5807 #, no-c-format msgid "" "--real live example. Count all the pixels in an aerial raster tile band 2 " @@ -10266,7 +10287,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5810 +#: reference_raster.xml:5809 #, no-c-format msgid "" "-- Just return count of pixels in each raster tile that have value of 100 of " @@ -10287,31 +10308,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5815 +#: reference_raster.xml:5814 #, no-c-format msgid ", " msgstr "" #. Tag: title -#: reference_raster.xml:5821 +#: reference_raster.xml:5820 #, no-c-format msgid "Raster Inputs" msgstr "" #. Tag: refname -#: reference_raster.xml:5824 +#: reference_raster.xml:5823 #, no-c-format msgid "ST_RastFromWKB" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5825 +#: reference_raster.xml:5824 #, no-c-format msgid "Return a raster value from a Well-Known Binary (WKB) raster." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:5830 +#: reference_raster.xml:5829 #, no-c-format msgid "" "raster ST_RastFromWKB " @@ -10319,13 +10340,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5840 +#: reference_raster.xml:5839 #, no-c-format msgid "Given a Well-Known Binary (WKB) raster, return a raster." msgstr "" #. Tag: programlisting -#: reference_raster.xml:5850 +#: reference_raster.xml:5849 #, no-c-format msgid "" "SELECT (ST_Metadata(\n" @@ -10347,7 +10368,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5856 +#: reference_raster.xml:5855 #, no-c-format msgid "" ", , raster ST_RastFromHexWKB " @@ -10377,7 +10398,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5883 +#: reference_raster.xml:5882 #, no-c-format msgid "" "Given a Well-Known Binary (WKB) raster in Hex representation, return a " @@ -10385,7 +10406,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5893 +#: reference_raster.xml:5892 #, no-c-format msgid "" "SELECT (ST_Metadata(\n" @@ -10403,7 +10424,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5899 +#: reference_raster.xml:5898 #, no-c-format msgid "" ", , , " @@ -10411,25 +10432,25 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:5911 +#: reference_raster.xml:5910 #, no-c-format msgid "Raster Outputs" msgstr "" #. Tag: refname -#: reference_raster.xml:5915 +#: reference_raster.xml:5914 #, no-c-format msgid "ST_AsBinary/ST_AsWKB" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5916 +#: reference_raster.xml:5915 #, no-c-format msgid "Return the Well-Known Binary (WKB) representation of the raster." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:5920 +#: reference_raster.xml:5919 #, no-c-format msgid "" " bytea ST_AsBinary " @@ -10443,7 +10464,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5937 +#: reference_raster.xml:5936 #, no-c-format msgid "" "Returns the Binary representation of the raster. If outasinoutasin" msgstr "" #. Tag: para -#: reference_raster.xml:5952 +#: reference_raster.xml:5951 #, no-c-format msgid "Enhanced: 2.5.0 Addition of ST_AsWKB" msgstr "" #. Tag: programlisting -#: reference_raster.xml:5958 +#: reference_raster.xml:5957 #, no-c-format msgid "" "SELECT ST_AsBinary(rast) As rastbin FROM dummy_rast WHERE rid=1;\n" @@ -10496,25 +10517,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5964 +#: reference_raster.xml:5963 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:5973 +#: reference_raster.xml:5972 #, no-c-format msgid "ST_AsHexWKB" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:5974 +#: reference_raster.xml:5973 #, no-c-format msgid "Return the Well-Known Binary (WKB) in Hex representation of the raster." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:5979 +#: reference_raster.xml:5978 #, no-c-format msgid "" "bytea ST_AsHexWKB " @@ -10524,7 +10545,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5990 +#: reference_raster.xml:5989 #, no-c-format msgid "" "Returns the Binary representation in Hex representation of the raster. If " @@ -10534,7 +10555,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:5996 +#: reference_raster.xml:5995 #, no-c-format msgid "" "By default, Hex WKB output contains the external file path for out-db bands. " @@ -10543,7 +10564,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6006 +#: reference_raster.xml:6005 #, no-c-format msgid "" "SELECT ST_AsHexWKB(rast) As rastbin FROM dummy_rast WHERE rid=1;\n" @@ -10554,19 +10575,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6012 +#: reference_raster.xml:6011 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:6022 +#: reference_raster.xml:6021 #, no-c-format msgid "ST_AsGDALRaster" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6023 +#: reference_raster.xml:6022 #, no-c-format msgid "" "Return the raster tile in the designated GDAL Raster format. Raster formats " @@ -10575,7 +10596,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:6028 +#: reference_raster.xml:6027 #, no-c-format msgid "" "bytea ST_AsGDALRaster " @@ -10587,7 +10608,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6042 +#: reference_raster.xml:6041 #, no-c-format msgid "" "Returns the raster tile in the designated format. Arguments are itemized " @@ -10595,7 +10616,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6045 +#: reference_raster.xml:6044 #, no-c-format msgid "" "format format to output. This is dependent on the drivers " @@ -10605,7 +10626,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6050 +#: reference_raster.xml:6049 #, no-c-format msgid "" "options text array of GDAL options. Valid options are " @@ -10614,7 +10635,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6055 +#: reference_raster.xml:6054 #, no-c-format msgid "" "srs The proj4text or srtext (from spatial_ref_sys) to " @@ -10622,13 +10643,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6065 +#: reference_raster.xml:6064 #, no-c-format msgid "JPEG Output Example, multiple tiles as single raster" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6067 +#: reference_raster.xml:6066 #, no-c-format msgid "" ", " msgstr "" #. Tag: refname -#: reference_raster.xml:6096 +#: reference_raster.xml:6095 #, no-c-format msgid "ST_AsJPEG" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6097 +#: reference_raster.xml:6096 #, no-c-format msgid "" "Return the raster tile selected bands as a single Joint Photographic Exports " @@ -10719,7 +10740,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:6101 +#: reference_raster.xml:6100 #, no-c-format msgid "" " bytea ST_AsJPEG " @@ -10747,7 +10768,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6137 +#: reference_raster.xml:6136 #, no-c-format msgid "" "Returns the selected bands of the raster as a single Joint Photographic " @@ -10759,13 +10780,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6140 reference_raster.xml:6231 +#: reference_raster.xml:6139 reference_raster.xml:6230 #, no-c-format msgid "nband is for single band exports." msgstr "" #. Tag: para -#: reference_raster.xml:6145 +#: reference_raster.xml:6144 #, no-c-format msgid "" "nbands is an array of bands to export (note that max is 3 " @@ -10774,7 +10795,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6150 +#: reference_raster.xml:6149 #, no-c-format msgid "" "quality number from 0 to 100. The higher the number the " @@ -10782,7 +10803,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6155 +#: reference_raster.xml:6154 #, no-c-format msgid "" "options text Array of GDAL options as defined for JPEG " @@ -10794,13 +10815,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6172 +#: reference_raster.xml:6171 #, no-c-format msgid "Examples: Output" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6174 +#: reference_raster.xml:6173 #, no-c-format msgid "" "-- output first 3 bands 75% quality\n" @@ -10819,7 +10840,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6181 +#: reference_raster.xml:6180 #, no-c-format msgid "" ", , bytea ST_AsPNG " @@ -10872,7 +10893,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6228 +#: reference_raster.xml:6227 #, no-c-format msgid "" "Returns the selected bands of the raster as a single Portable Network " @@ -10884,7 +10905,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6236 +#: reference_raster.xml:6235 #, no-c-format msgid "" "nbands is an array of bands to export (note that max is 4 " @@ -10893,7 +10914,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6241 +#: reference_raster.xml:6240 #, no-c-format msgid "" "compression number from 1 to 9. The higher the number the " @@ -10901,7 +10922,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6246 +#: reference_raster.xml:6245 #, no-c-format msgid "" "options text Array of GDAL options as defined for PNG " @@ -10914,7 +10935,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6265 +#: reference_raster.xml:6264 #, no-c-format msgid "" "SELECT ST_AsPNG(rast) As rastpng\n" @@ -10927,7 +10948,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6272 +#: reference_raster.xml:6271 #, no-c-format msgid "" ", , , " @@ -10935,13 +10956,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:6278 +#: reference_raster.xml:6277 #, no-c-format msgid "ST_AsTIFF" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6279 +#: reference_raster.xml:6278 #, no-c-format msgid "" "Return the raster selected bands as a single TIFF image (byte array). If no " @@ -10950,7 +10971,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:6283 +#: reference_raster.xml:6282 #, no-c-format msgid "" " bytea ST_AsTIFF " @@ -10978,7 +10999,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6316 +#: reference_raster.xml:6315 #, no-c-format msgid "" "Returns the selected bands of the raster as a single Tagged Image File " @@ -10991,7 +11012,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6319 +#: reference_raster.xml:6318 #, no-c-format msgid "" "nbands is an array of bands to export (note that max is 3 " @@ -11000,7 +11021,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6324 +#: reference_raster.xml:6323 #, no-c-format msgid "" "compression Compression expression -- JPEG90 (or some " @@ -11008,7 +11029,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6329 +#: reference_raster.xml:6328 #, no-c-format msgid "" "options text Array of GDAL create options as defined for " @@ -11018,7 +11039,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6334 +#: reference_raster.xml:6333 #, no-c-format msgid "" "srid srid of spatial_ref_sys of the raster. This is used " @@ -11026,13 +11047,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:6343 +#: reference_raster.xml:6342 #, no-c-format msgid "Examples: Use jpeg compression 90%" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6345 +#: reference_raster.xml:6344 #, no-c-format msgid "" "SELECT ST_AsTIFF(rast, 'JPEG90') As rasttiff\n" @@ -11040,32 +11061,32 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6352 +#: reference_raster.xml:6351 #, no-c-format msgid "" ", , " msgstr "" #. Tag: title -#: reference_raster.xml:6358 +#: reference_raster.xml:6357 #, no-c-format msgid "Raster Processing" msgstr "" #. Tag: title -#: reference_raster.xml:6361 +#: reference_raster.xml:6360 #, no-c-format msgid "Map Algebra" msgstr "" #. Tag: refname -#: reference_raster.xml:6365 +#: reference_raster.xml:6364 #, no-c-format msgid "ST_Clip" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6366 +#: reference_raster.xml:6365 #, no-c-format msgid "" "Returns the raster clipped by the input geometry. If band number not is " @@ -11074,7 +11095,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:6370 +#: reference_raster.xml:6369 #, no-c-format msgid "" " raster ST_Clip " @@ -11116,7 +11137,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6427 +#: reference_raster.xml:6426 #, no-c-format msgid "" "Returns a raster that is clipped by the input geometry geomcrop is not specified, true is assumed meaning the " @@ -11149,13 +11170,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6441 +#: reference_raster.xml:6440 #, no-c-format msgid "Enhanced: 2.1.0 Rewritten in C" msgstr "" #. Tag: para -#: reference_raster.xml:6443 +#: reference_raster.xml:6442 #, no-c-format msgid "" "Examples here use Massachusetts aerial data available on MassGIS site , raster ST_ColorMap " @@ -11296,7 +11317,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:6608 +#: reference_raster.xml:6607 #, no-c-format msgid "" "raster ST_ColorMap " @@ -11307,7 +11328,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6620 +#: reference_raster.xml:6619 #, no-c-format msgid "" "Apply a colormap to the band at nband " @@ -11317,13 +11338,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6624 +#: reference_raster.xml:6623 #, no-c-format msgid "If nband is not specified, then band 1 is assumed." msgstr "" #. Tag: para -#: reference_raster.xml:6626 +#: reference_raster.xml:6625 #, no-c-format msgid "" "colormap can be a keyword of a pre-defined colormap or a " @@ -11331,13 +11352,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6630 +#: reference_raster.xml:6629 #, no-c-format msgid "Valid pre-defined colormap keyword:" msgstr "" #. Tag: para -#: reference_raster.xml:6636 +#: reference_raster.xml:6635 #, no-c-format msgid "" "grayscale or greyscale for a one 8BUI " @@ -11345,7 +11366,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6641 +#: reference_raster.xml:6640 #, no-c-format msgid "" "pseudocolor for a four 8BUI (RGBA) band raster with " @@ -11353,7 +11374,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6646 +#: reference_raster.xml:6645 #, no-c-format msgid "" "fire for a four 8BUI (RGBA) band raster with colors going " @@ -11361,7 +11382,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6651 +#: reference_raster.xml:6650 #, no-c-format msgid "" "bluered for a four 8BUI (RGBA) band raster with colors " @@ -11369,7 +11390,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6657 +#: reference_raster.xml:6656 #, no-c-format msgid "" "Users can pass a set of entries (one per line) to colormapcolormap is similar to that of the color-" @@ -11404,13 +11425,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6667 +#: reference_raster.xml:6666 #, no-c-format msgid "Valid keywords for method:" msgstr "" #. Tag: para -#: reference_raster.xml:6673 +#: reference_raster.xml:6672 #, no-c-format msgid "" "INTERPOLATE to use linear interpolation to smoothly blend " @@ -11418,7 +11439,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6678 +#: reference_raster.xml:6677 #, no-c-format msgid "" "EXACT to strictly match only those pixels values found in " @@ -11427,7 +11448,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6683 +#: reference_raster.xml:6682 #, no-c-format msgid "" "NEAREST to use the colormap entry whose value is closest " @@ -11435,7 +11456,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6690 +#: reference_raster.xml:6689 #, no-c-format msgid "" "A great reference for colormaps is , " @@ -11595,13 +11616,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:6831 +#: reference_raster.xml:6830 #, no-c-format msgid "ST_Grayscale" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6832 +#: reference_raster.xml:6831 #, no-c-format msgid "" "Creates a new one-8BUI band raster from the source raster and specified " @@ -11609,7 +11630,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:6837 +#: reference_raster.xml:6836 #, no-c-format msgid "" "(1) raster ST_Grayscale " @@ -11623,7 +11644,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:6848 +#: reference_raster.xml:6847 #, no-c-format msgid "" "(2) raster ST_Grayscale " @@ -11633,7 +11654,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6859 +#: reference_raster.xml:6858 #, no-c-format msgid "" "Create a raster with one 8BUI band given three input bands (from one or more " @@ -11642,7 +11663,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6864 +#: reference_raster.xml:6863 #, no-c-format msgid "" "This function is not like with the " @@ -11653,7 +11674,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6876 +#: reference_raster.xml:6875 #, no-c-format msgid "" "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';\n" @@ -11673,19 +11694,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6890 +#: reference_raster.xml:6889 #, no-c-format msgid "original_png" msgstr "" #. Tag: para -#: reference_raster.xml:6904 +#: reference_raster.xml:6903 #, no-c-format msgid "grayscale_png" msgstr "" #. Tag: programlisting -#: reference_raster.xml:6920 +#: reference_raster.xml:6919 #, no-c-format msgid "" "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';\n" @@ -11711,19 +11732,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:6925 +#: reference_raster.xml:6924 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:6936 +#: reference_raster.xml:6935 #, no-c-format msgid "ST_Intersection" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:6937 +#: reference_raster.xml:6936 #, no-c-format msgid "" "Returns a raster or a set of geometry-pixelvalue pairs " @@ -11732,7 +11753,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:6941 +#: reference_raster.xml:6940 #, no-c-format msgid "" " setof geomval ST_IntersectionReturns a raster or a set of geometry-pixelvalue pairs representing " @@ -11785,20 +11806,21 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7005 +#: reference_raster.xml:7004 #, 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." +"The raster is first vectorized (using ) into a set of geomval rows and those rows are then intersected with the " +"geometry using the (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 in the " +"WHERE clause." msgstr "" #. Tag: para -#: reference_raster.xml:7009 +#: reference_raster.xml:7008 #, no-c-format msgid "" "You can access the geometry and the value parts of the resulting set of " @@ -11807,7 +11829,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7013 +#: reference_raster.xml:7012 #, no-c-format msgid "" "The other variants, returning a raster, works in raster space. They are " @@ -11816,7 +11838,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7017 +#: reference_raster.xml:7016 #, no-c-format msgid "" "The extent of the resulting raster corresponds to the geometrical " @@ -11829,7 +11851,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7021 +#: reference_raster.xml:7020 #, no-c-format msgid "" "Rasters resulting from ST_Intersection must have a nodata value assigned for " @@ -11845,7 +11867,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7025 +#: reference_raster.xml:7024 #, no-c-format msgid "" "In all variants, if no band number is specified band 1 is assumed. If you " @@ -11854,7 +11876,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7030 +#: reference_raster.xml:7029 #, no-c-format msgid "" "To get more control on the resulting extent or on what to return when " @@ -11863,7 +11885,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7036 +#: reference_raster.xml:7035 #, no-c-format msgid "" "To compute the intersection of a raster band with a geometry in raster " @@ -11872,15 +11894,16 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7042 +#: reference_raster.xml:7041 #, 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." +"ST_Intersection should be used in conjunction with and an index on the raster column and/or the geometry " +"column." msgstr "" #. Tag: para -#: reference_raster.xml:7047 +#: reference_raster.xml:7046 #, no-c-format msgid "" "Enhanced: 2.0.0 - Intersection in the raster space was introduced. In " @@ -11889,13 +11912,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7053 +#: reference_raster.xml:7052 #, no-c-format msgid "Examples: Geometry, Raster -- resulting in geometry vals" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7055 +#: reference_raster.xml:7054 #, no-c-format msgid "" "SELECT\n" @@ -11947,7 +11970,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7060 +#: reference_raster.xml:7059 #, no-c-format msgid "" ", , raster ST_MapAlgebra " @@ -12041,7 +12064,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7151 +#: reference_raster.xml:7150 #, no-c-format msgid "" "Returns a one-band raster given one or more input rasters, band indexes and " @@ -12049,19 +12072,19 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7157 +#: reference_raster.xml:7156 #, no-c-format msgid "rast,rast1,rast2, rastbandargset" msgstr "" #. Tag: para -#: reference_raster.xml:7159 +#: reference_raster.xml:7158 #, no-c-format msgid "Rasters on which the map algebra process is evaluated." msgstr "" #. Tag: para -#: reference_raster.xml:7160 +#: reference_raster.xml:7159 #, no-c-format msgid "" "rastbandargset allows the use of a map algebra operation " @@ -12069,13 +12092,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7165 +#: reference_raster.xml:7164 #, no-c-format msgid "nband, nband1, nband2" msgstr "" #. Tag: para -#: reference_raster.xml:7167 +#: reference_raster.xml:7166 #, no-c-format msgid "" "Band numbers of the raster to be evaluated. nband can be an integer or " @@ -12084,13 +12107,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7173 +#: reference_raster.xml:7172 #, no-c-format msgid "callbackfunc" msgstr "" #. Tag: para -#: reference_raster.xml:7175 +#: reference_raster.xml:7174 #, no-c-format msgid "" "The callbackfunc parameter must be the name and signature " @@ -12120,7 +12143,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7182 +#: reference_raster.xml:7181 #, no-c-format msgid "" "Passing a regprocedure argument to a SQL function requires the " @@ -12135,13 +12158,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7194 +#: reference_raster.xml:7193 #, no-c-format msgid "mask" msgstr "" #. Tag: para -#: reference_raster.xml:7196 +#: reference_raster.xml:7195 #, no-c-format msgid "" "An n-dimensional array (matrix) of numbers used to filter what cells get " @@ -12152,13 +12175,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7203 +#: reference_raster.xml:7202 #, no-c-format msgid "weighted" msgstr "" #. Tag: para -#: reference_raster.xml:7205 +#: reference_raster.xml:7204 #, no-c-format msgid "" "boolean (true/false) to denote if a mask value should be weighted " @@ -12167,14 +12190,14 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7212 reference_raster.xml:7537 -#: reference_raster.xml:7832 reference_raster.xml:8386 +#: reference_raster.xml:7211 reference_raster.xml:7536 +#: reference_raster.xml:7831 reference_raster.xml:8385 #, no-c-format msgid "pixeltype" msgstr "" #. Tag: para -#: reference_raster.xml:7214 +#: reference_raster.xml:7213 #, no-c-format msgid "" "If pixeltype is passed in, the one band of the new raster " @@ -12186,7 +12209,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7217 +#: reference_raster.xml:7216 #, no-c-format msgid "" "The resulting pixel type of the output raster must be one listed in extentype is CUSTOM, a raster must be provided for " @@ -12223,13 +12246,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7242 +#: reference_raster.xml:7241 #, no-c-format msgid "distancex" msgstr "" #. Tag: para -#: reference_raster.xml:7244 +#: reference_raster.xml:7243 #, no-c-format msgid "" "The distance in pixels from the reference cell in x direction. So width of " @@ -12238,13 +12261,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7251 +#: reference_raster.xml:7250 #, no-c-format msgid "distancey" msgstr "" #. Tag: para -#: reference_raster.xml:7253 +#: reference_raster.xml:7252 #, no-c-format msgid "" "The distance in pixels from reference cell in y direction. Height of " @@ -12253,13 +12276,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7260 +#: reference_raster.xml:7259 #, no-c-format msgid "userargs" msgstr "" #. Tag: para -#: reference_raster.xml:7262 +#: reference_raster.xml:7261 #, no-c-format msgid "" "The third argument to the callbackfunc is a " @@ -12269,8 +12292,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7270 reference_raster.xml:8161 -#: reference_raster.xml:8280 +#: reference_raster.xml:7269 reference_raster.xml:8160 +#: reference_raster.xml:8279 #, no-c-format msgid "" "For more information about the VARIADIC keyword, please refer to the " @@ -12280,7 +12303,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7276 +#: reference_raster.xml:7275 #, no-c-format msgid "" "The text[] argument to the callbackfunc is " @@ -12289,7 +12312,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7281 +#: reference_raster.xml:7280 #, no-c-format msgid "" "Variant 1 accepts an array of rastbandarg allowing the " @@ -12298,7 +12321,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7285 +#: reference_raster.xml:7284 #, no-c-format msgid "" "Variants 2 and 3 operate upon one or more bands of one raster. See example " @@ -12306,7 +12329,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7289 +#: reference_raster.xml:7288 #, no-c-format msgid "" "Variant 4 operate upon two rasters with one band per raster. See example " @@ -12314,19 +12337,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7293 +#: reference_raster.xml:7292 #, no-c-format msgid "Availability: 2.2.0: Ability to add a mask" msgstr "" #. Tag: para -#: reference_raster.xml:7301 reference_raster.xml:7323 +#: reference_raster.xml:7300 reference_raster.xml:7322 #, no-c-format msgid "One raster, one band" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7302 +#: reference_raster.xml:7301 #, no-c-format msgid "" "WITH foo AS (\n" @@ -12343,13 +12366,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7304 reference_raster.xml:7320 +#: reference_raster.xml:7303 reference_raster.xml:7319 #, no-c-format msgid "One raster, several bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7305 +#: reference_raster.xml:7304 #, no-c-format msgid "" "WITH foo AS (\n" @@ -12368,13 +12391,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7307 +#: reference_raster.xml:7306 #, no-c-format msgid "Several rasters, several bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7308 +#: reference_raster.xml:7307 #, no-c-format msgid "" "WITH foo AS (\n" @@ -12400,7 +12423,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7310 +#: reference_raster.xml:7309 #, no-c-format msgid "" "Complete example of tiles of a coverage with neighborhood. This query only " @@ -12408,7 +12431,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7311 +#: reference_raster.xml:7310 #, no-c-format msgid "" "WITH foo AS (\n" @@ -12452,7 +12475,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7313 +#: reference_raster.xml:7312 #, no-c-format msgid "" "Example like the prior one for tiles of a coverage with neighborhood but " @@ -12460,7 +12483,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7314 +#: reference_raster.xml:7313 #, no-c-format msgid "" "WITH src AS (\n" @@ -12519,13 +12542,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7318 +#: reference_raster.xml:7317 #, no-c-format msgid "Examples: Variants 2 and 3" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7321 +#: reference_raster.xml:7320 #, no-c-format msgid "" "WITH foo AS (\n" @@ -12543,7 +12566,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7324 +#: reference_raster.xml:7323 #, no-c-format msgid "" "WITH foo AS (\n" @@ -12561,19 +12584,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7328 +#: reference_raster.xml:7327 #, no-c-format msgid "Examples: Variant 4" msgstr "" #. Tag: para -#: reference_raster.xml:7330 +#: reference_raster.xml:7329 #, no-c-format msgid "Two rasters, two bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7331 +#: reference_raster.xml:7330 #, no-c-format msgid "" "WITH foo AS (\n" @@ -12599,13 +12622,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7336 +#: reference_raster.xml:7335 #, no-c-format msgid "Examples: Using Masks" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7337 +#: reference_raster.xml:7336 #, no-c-format msgid "" "WITH foo AS (SELECT\n" @@ -12640,25 +12663,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7351 +#: reference_raster.xml:7350 #, no-c-format msgid "original" msgstr "" #. Tag: para -#: reference_raster.xml:7365 +#: reference_raster.xml:7364 #, no-c-format msgid "no mask mean value (same as having all 1s in mask matrix)" msgstr "" #. Tag: para -#: reference_raster.xml:7381 +#: reference_raster.xml:7380 #, no-c-format msgid "mask only consider neighbors, exclude center" msgstr "" #. Tag: para -#: reference_raster.xml:7395 +#: reference_raster.xml:7394 #, no-c-format msgid "" "mask weighted only consider neighbors, exclude center multi other pixel " @@ -12666,20 +12689,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7412 +#: reference_raster.xml:7411 #, no-c-format msgid "" ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:7423 +#: reference_raster.xml:7422 #, no-c-format msgid "ST_MapAlgebra (expression version)" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7424 +#: reference_raster.xml:7423 #, no-c-format msgid "" "Expression version - Returns a one-band raster given one or two " @@ -12688,7 +12711,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:7430 +#: reference_raster.xml:7429 #, no-c-format msgid "" " raster ST_MapAlgebra " @@ -12733,7 +12756,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7481 +#: reference_raster.xml:7480 #, no-c-format msgid "" "Expression version - Returns a one-band raster given one or two input " @@ -12741,13 +12764,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7489 +#: reference_raster.xml:7488 #, no-c-format msgid "Description: Variants 1 and 2 (one raster)" msgstr "" #. Tag: para -#: reference_raster.xml:7491 +#: reference_raster.xml:7490 #, no-c-format msgid "" "Creates a new one band raster formed by applying a valid PostgreSQL " @@ -12758,8 +12781,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7495 reference_raster.xml:7697 -#: reference_raster.xml:8145 +#: reference_raster.xml:7494 reference_raster.xml:7696 +#: reference_raster.xml:8144 #, no-c-format msgid "" "If pixeltype is passed in, then the new raster will have " @@ -12768,45 +12791,45 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7500 +#: reference_raster.xml:7499 #, no-c-format msgid "Keywords permitted for expression" msgstr "" #. Tag: para -#: reference_raster.xml:7503 +#: reference_raster.xml:7502 #, no-c-format msgid "[rast] - Pixel value of the pixel of interest" msgstr "" #. Tag: para -#: reference_raster.xml:7506 +#: reference_raster.xml:7505 #, no-c-format msgid "[rast.val] - Pixel value of the pixel of interest" msgstr "" #. Tag: para -#: reference_raster.xml:7509 +#: reference_raster.xml:7508 #, no-c-format msgid "" "[rast.x] - 1-based pixel column of the pixel of interest" msgstr "" #. Tag: para -#: reference_raster.xml:7512 +#: reference_raster.xml:7511 #, no-c-format msgid "" "[rast.y] - 1-based pixel row of the pixel of interest" msgstr "" #. Tag: title -#: reference_raster.xml:7521 +#: reference_raster.xml:7520 #, no-c-format msgid "Description: Variants 3 and 4 (two raster)" msgstr "" #. Tag: para -#: reference_raster.xml:7523 reference_raster.xml:7817 +#: reference_raster.xml:7522 reference_raster.xml:7816 #, no-c-format msgid "" "Creates a new one band raster formed by applying a valid PostgreSQL " @@ -12820,13 +12843,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7529 reference_raster.xml:7823 +#: reference_raster.xml:7528 reference_raster.xml:7822 #, no-c-format msgid "expression" msgstr "" #. Tag: para -#: reference_raster.xml:7531 reference_raster.xml:7825 +#: reference_raster.xml:7530 reference_raster.xml:7824 #, no-c-format msgid "" "A PostgreSQL algebraic expression involving the two rasters and PostgreSQL " @@ -12835,7 +12858,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7539 reference_raster.xml:7834 +#: reference_raster.xml:7538 reference_raster.xml:7833 #, no-c-format msgid "" "The resulting pixel type of the output raster. Must be one listed in INTERSECTION - The extent of the new raster is the " @@ -12858,7 +12881,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7558 reference_raster.xml:7851 +#: reference_raster.xml:7557 reference_raster.xml:7850 #, no-c-format msgid "" "UNION - The extent of the new raster is the union of the " @@ -12866,7 +12889,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7563 reference_raster.xml:7856 +#: reference_raster.xml:7562 reference_raster.xml:7855 #, no-c-format msgid "" "FIRST - The extent of the new raster is the same as the " @@ -12874,7 +12897,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7568 reference_raster.xml:7861 +#: reference_raster.xml:7567 reference_raster.xml:7860 #, no-c-format msgid "" "SECOND - The extent of the new raster is the same as the " @@ -12882,13 +12905,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7576 reference_raster.xml:7870 +#: reference_raster.xml:7575 reference_raster.xml:7869 #, no-c-format msgid "nodata1expr" msgstr "" #. Tag: para -#: reference_raster.xml:7578 reference_raster.xml:7872 +#: reference_raster.xml:7577 reference_raster.xml:7871 #, no-c-format msgid "" "An algebraic expression involving only rast2 or a " @@ -12897,13 +12920,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7584 reference_raster.xml:7879 +#: reference_raster.xml:7583 reference_raster.xml:7878 #, no-c-format msgid "nodata2expr" msgstr "" #. Tag: para -#: reference_raster.xml:7586 reference_raster.xml:7881 +#: reference_raster.xml:7585 reference_raster.xml:7880 #, no-c-format msgid "" "An algebraic expression involving only rast1 or a " @@ -12912,13 +12935,13 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:7592 reference_raster.xml:7888 +#: reference_raster.xml:7591 reference_raster.xml:7887 #, no-c-format msgid "nodatanodataval" msgstr "" #. Tag: para -#: reference_raster.xml:7594 reference_raster.xml:7890 +#: reference_raster.xml:7593 reference_raster.xml:7889 #, no-c-format msgid "" "A numeric constant to return when spatially corresponding rast1 and rast2 " @@ -12926,7 +12949,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7602 +#: reference_raster.xml:7601 #, no-c-format msgid "" "Keywords permitted in expression, nodata1expr[rast1] - Pixel value of the pixel of interest from " @@ -12942,7 +12965,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7608 +#: reference_raster.xml:7607 #, no-c-format msgid "" "[rast1.val] - Pixel value of the pixel of interest from " @@ -12950,7 +12973,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7611 +#: reference_raster.xml:7610 #, no-c-format msgid "" "[rast1.x] - 1-based pixel column of the pixel of interest " @@ -12958,7 +12981,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7614 +#: reference_raster.xml:7613 #, no-c-format msgid "" "[rast1.y] - 1-based pixel row of the pixel of interest " @@ -12966,7 +12989,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7617 +#: reference_raster.xml:7616 #, no-c-format msgid "" "[rast2] - Pixel value of the pixel of interest from " @@ -12974,7 +12997,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7620 +#: reference_raster.xml:7619 #, no-c-format msgid "" "[rast2.val] - Pixel value of the pixel of interest from " @@ -12982,7 +13005,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7623 +#: reference_raster.xml:7622 #, no-c-format msgid "" "[rast2.x] - 1-based pixel column of the pixel of interest " @@ -12990,7 +13013,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7626 +#: reference_raster.xml:7625 #, no-c-format msgid "" "[rast2.y] - 1-based pixel row of the pixel of interest " @@ -12998,13 +13021,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7634 +#: reference_raster.xml:7633 #, no-c-format msgid "Examples: Variants 1 and 2" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7636 +#: reference_raster.xml:7635 #, no-c-format msgid "" "WITH foo AS (\n" @@ -13018,13 +13041,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7640 +#: reference_raster.xml:7639 #, no-c-format msgid "Examples: Variant 3 and 4" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7642 +#: reference_raster.xml:7641 #, no-c-format msgid "" "WITH foo AS (\n" @@ -13049,19 +13072,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7648 +#: reference_raster.xml:7647 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:7658 reference_raster.xml:7772 +#: reference_raster.xml:7657 reference_raster.xml:7771 #, no-c-format msgid "ST_MapAlgebraExpr" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:7659 +#: reference_raster.xml:7658 #, no-c-format msgid "" "1 raster band version: Creates a new one band raster formed by applying a " @@ -13070,7 +13093,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:7663 +#: reference_raster.xml:7662 #, no-c-format msgid "" " raster ST_MapAlgebraExpr " @@ -13097,7 +13120,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7693 +#: reference_raster.xml:7692 #, no-c-format msgid "" "Creates a new one band raster formed by applying a valid PostgreSQL " @@ -13108,7 +13131,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7701 +#: reference_raster.xml:7700 #, no-c-format msgid "" "In the expression you can use the term [rast] to refer to " @@ -13118,8 +13141,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7711 reference_raster.xml:7910 -#: reference_raster.xml:8174 +#: reference_raster.xml:7710 reference_raster.xml:7909 +#: reference_raster.xml:8173 #, no-c-format msgid "" "Create a new 1 band raster from our original that is a function of modulo 2 " @@ -13127,7 +13150,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7712 +#: reference_raster.xml:7711 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast raster;\n" @@ -13156,7 +13179,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7714 +#: reference_raster.xml:7713 #, no-c-format msgid "" "Create a new 1 band raster of pixel-type 2BUI from our original that is " @@ -13164,7 +13187,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7715 +#: reference_raster.xml:7714 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;\n" @@ -13202,19 +13225,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7729 +#: reference_raster.xml:7728 #, no-c-format msgid "original (column rast_view)" msgstr "" #. Tag: para -#: reference_raster.xml:7743 reference_raster.xml:8197 +#: reference_raster.xml:7742 reference_raster.xml:8196 #, no-c-format msgid "rast_view_ma" msgstr "" #. Tag: para -#: reference_raster.xml:7754 reference_raster.xml:8205 +#: reference_raster.xml:7753 reference_raster.xml:8204 #, no-c-format msgid "" "Create a new 3 band raster same pixel type from our original 3 band raster " @@ -13222,7 +13245,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7755 +#: reference_raster.xml:7754 #, no-c-format msgid "" "SELECT\n" @@ -13242,7 +13265,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7760 +#: reference_raster.xml:7759 #, no-c-format msgid "" ", , raster ST_MapAlgebraExprpixeltype is passed in, then the new raster will have " @@ -13306,7 +13329,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7900 +#: reference_raster.xml:7899 #, no-c-format msgid "" "Use the term [rast1.val] [rast2.val] " @@ -13316,13 +13339,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:7908 +#: reference_raster.xml:7907 #, no-c-format msgid "Example: 2 Band Intersection and Union" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7911 +#: reference_raster.xml:7910 #, no-c-format msgid "" "--Create a cool set of rasters --\n" @@ -13369,25 +13392,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7925 +#: reference_raster.xml:7924 #, no-c-format msgid "mapalgebra intersection" msgstr "" #. Tag: para -#: reference_raster.xml:7939 +#: reference_raster.xml:7938 #, no-c-format msgid "map algebra union" msgstr "" #. Tag: title -#: reference_raster.xml:7952 reference_raster.xml:8291 +#: reference_raster.xml:7951 reference_raster.xml:8290 #, no-c-format msgid "Example: Overlaying rasters on a canvas as separate bands" msgstr "" #. Tag: programlisting -#: reference_raster.xml:7953 +#: reference_raster.xml:7952 #, no-c-format msgid "" "-- we use ST_AsPNG to render the image so all single band ones look grey --\n" @@ -13427,38 +13450,38 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:7966 +#: reference_raster.xml:7965 #, no-c-format msgid "rast1" msgstr "" #. Tag: para -#: reference_raster.xml:7979 +#: reference_raster.xml:7978 #, no-c-format msgid "rast2" msgstr "" #. Tag: para -#: reference_raster.xml:7995 +#: reference_raster.xml:7994 #, no-c-format msgid "rast3" msgstr "" #. Tag: para -#: reference_raster.xml:8009 +#: reference_raster.xml:8008 #, no-c-format msgid "final_rast" msgstr "" #. Tag: title -#: reference_raster.xml:8022 +#: reference_raster.xml:8021 #, no-c-format msgid "" "Example: Overlay 2 meter boundary of select parcels over an aerial imagery" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8024 +#: reference_raster.xml:8023 #, no-c-format msgid "" "-- Create new 3 band raster composed of first 2 clipped bands, and overlay " @@ -13497,13 +13520,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8038 +#: reference_raster.xml:8037 #, no-c-format msgid "The blue lines are the boundaries of select parcels" msgstr "" #. Tag: para -#: reference_raster.xml:8052 +#: reference_raster.xml:8051 #, no-c-format msgid "" ", , , raster ST_MapAlgebraFct instead." msgstr "" #. Tag: para -#: reference_raster.xml:8143 +#: reference_raster.xml:8142 #, no-c-format msgid "" "Creates a new one band raster formed by applying a valid PostgreSQL function " @@ -13595,7 +13618,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8147 +#: reference_raster.xml:8146 #, no-c-format msgid "" "The onerasteruserfunc parameter must be the name and " @@ -13618,7 +13641,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8152 +#: reference_raster.xml:8151 #, no-c-format msgid "" "Passing a regprodedure argument to a SQL function requires the " @@ -13631,7 +13654,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8156 +#: reference_raster.xml:8155 #, no-c-format msgid "" "The third argument to the userfunction is a " @@ -13642,7 +13665,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8165 +#: reference_raster.xml:8164 #, no-c-format msgid "" "The text[] argument to the userfunction is " @@ -13651,7 +13674,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8175 +#: reference_raster.xml:8174 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast raster;\n" @@ -13687,7 +13710,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8177 +#: reference_raster.xml:8176 #, no-c-format msgid "" "Create a new 1 band raster of pixel-type 2BUI from our original that is " @@ -13696,7 +13719,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8178 +#: reference_raster.xml:8177 #, no-c-format msgid "" "ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;\n" @@ -13751,13 +13774,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8189 +#: reference_raster.xml:8188 #, no-c-format msgid "original (column rast-view)" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8206 +#: reference_raster.xml:8205 #, no-c-format msgid "" "CREATE FUNCTION rast_plus_tan(pixel float, pos integer[], variadic args " @@ -13787,7 +13810,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8211 reference_raster.xml:8334 +#: reference_raster.xml:8210 reference_raster.xml:8333 #, no-c-format msgid "" ", , raster ST_MapAlgebraFctpixeltype is passed in, then the new raster will have " @@ -13853,7 +13876,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8267 +#: reference_raster.xml:8266 #, no-c-format msgid "" "The tworastuserfunc parameter must be the name and " @@ -13878,7 +13901,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8273 +#: reference_raster.xml:8272 #, no-c-format msgid "" "Passing a regprodedure argument to a SQL function requires the " @@ -13892,7 +13915,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8276 +#: reference_raster.xml:8275 #, no-c-format msgid "" "The fourth argument to the tworastuserfunc is a " @@ -13903,7 +13926,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8284 +#: reference_raster.xml:8283 #, no-c-format msgid "" "The text[] argument to the tworastuserfunc " @@ -13912,7 +13935,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8292 +#: reference_raster.xml:8291 #, no-c-format msgid "" "-- define our user defined function --\n" @@ -13989,19 +14012,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8305 +#: reference_raster.xml:8304 #, no-c-format msgid "map bands overlay (canvas) (R: small road, G: circle, B: big road)" msgstr "" #. Tag: title -#: reference_raster.xml:8317 +#: reference_raster.xml:8316 #, no-c-format msgid "User Defined function that takes extra args" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8318 +#: reference_raster.xml:8317 #, no-c-format msgid "" "CREATE OR REPLACE FUNCTION raster_mapalgebra_userargs(\n" @@ -14041,19 +14064,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8326 +#: reference_raster.xml:8325 #, no-c-format msgid "user defined with extra args and different bands from same raster" msgstr "" #. Tag: refname -#: reference_raster.xml:8345 +#: reference_raster.xml:8344 #, no-c-format msgid "ST_MapAlgebraFctNgb" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8346 +#: reference_raster.xml:8345 #, no-c-format msgid "" "1-band version: Map Algebra Nearest Neighbor using user-defined PostgreSQL " @@ -14062,7 +14085,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8351 +#: reference_raster.xml:8350 #, no-c-format msgid "" "raster ST_MapAlgebraFctNgb " @@ -14078,7 +14101,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8374 +#: reference_raster.xml:8373 #, no-c-format msgid "" "(one raster version) Return a raster which values are the result of a " @@ -14089,31 +14112,31 @@ msgid "" msgstr "" #. Tag: term -#: reference_raster.xml:8378 +#: reference_raster.xml:8377 #, no-c-format msgid "rast" msgstr "" #. Tag: para -#: reference_raster.xml:8379 +#: reference_raster.xml:8378 #, no-c-format msgid "Raster on which the user function is evaluated." msgstr "" #. Tag: term -#: reference_raster.xml:8382 +#: reference_raster.xml:8381 #, no-c-format msgid "band" msgstr "" #. Tag: para -#: reference_raster.xml:8383 +#: reference_raster.xml:8382 #, no-c-format msgid "Band number of the raster to be evaluated. Default to 1." msgstr "" #. Tag: para -#: reference_raster.xml:8387 +#: reference_raster.xml:8386 #, no-c-format msgid "" "The resulting pixel type of the output raster. Must be one listed in , " msgstr "" #. Tag: refname -#: reference_raster.xml:8477 +#: reference_raster.xml:8476 #, no-c-format msgid "ST_Reclass" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8478 +#: reference_raster.xml:8477 #, no-c-format msgid "" "Creates a new raster composed of band types reclassified from original. The " @@ -14304,7 +14327,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8482 +#: reference_raster.xml:8481 #, no-c-format msgid "" " raster ST_Reclass " @@ -14325,7 +14348,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8510 +#: reference_raster.xml:8509 #, no-c-format msgid "" "Creates a new raster formed by applying a valid PostgreSQL algebraic " @@ -14338,7 +14361,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8512 +#: reference_raster.xml:8511 #, no-c-format msgid "" "The bands of the new raster will have pixel type of pixeltype, , " @@ -14474,13 +14497,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:8551 +#: reference_raster.xml:8550 #, no-c-format msgid "ST_Union" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8552 +#: reference_raster.xml:8551 #, no-c-format msgid "" "Returns the union of a set of raster tiles into a single raster composed of " @@ -14488,7 +14511,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8557 +#: reference_raster.xml:8556 #, no-c-format msgid "" "raster ST_Union " @@ -14496,7 +14519,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8563 +#: reference_raster.xml:8562 #, no-c-format msgid "" "raster ST_Union " @@ -14506,7 +14529,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8570 +#: reference_raster.xml:8569 #, no-c-format msgid "" "raster ST_Union " @@ -14515,7 +14538,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8577 +#: reference_raster.xml:8576 #, no-c-format msgid "" "raster ST_Union " @@ -14524,7 +14547,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8584 +#: reference_raster.xml:8583 #, no-c-format msgid "" "raster ST_Union " @@ -14534,7 +14557,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8596 +#: reference_raster.xml:8595 #, no-c-format msgid "" "Returns the union of a set of raster tiles into a single raster composed of " @@ -14545,7 +14568,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8599 +#: reference_raster.xml:8598 #, no-c-format msgid "" "In order for rasters to be unioned, they must all have the same alignment. " @@ -14556,19 +14579,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8603 +#: reference_raster.xml:8602 #, no-c-format msgid "Enhanced: 2.1.0 Improved Speed (fully C-Based)." msgstr "" #. Tag: para -#: reference_raster.xml:8604 +#: reference_raster.xml:8603 #, no-c-format msgid "Availability: 2.1.0 ST_Union(rast, unionarg) variant was introduced." msgstr "" #. Tag: para -#: reference_raster.xml:8605 +#: reference_raster.xml:8604 #, no-c-format msgid "" "Enhanced: 2.1.0 ST_Union(rast) (variant 1) unions all bands of all input " @@ -14576,7 +14599,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8606 +#: reference_raster.xml:8605 #, no-c-format msgid "" "Enhanced: 2.1.0 ST_Union(rast, uniontype) (variant 4) unions all bands of " @@ -14584,13 +14607,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:8609 +#: reference_raster.xml:8608 #, no-c-format msgid "Examples: Reconstitute a single band chunked raster tile" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8610 +#: reference_raster.xml:8609 #, no-c-format msgid "" "-- this creates a single band from first band of raster tiles\n" @@ -14600,7 +14623,7 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:8614 reference_raster.xml:8618 +#: reference_raster.xml:8613 reference_raster.xml:8617 #, no-c-format msgid "" "Examples: Return a multi-band raster that is the union of tiles intersecting " @@ -14608,7 +14631,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8615 +#: reference_raster.xml:8614 #, no-c-format msgid "" "-- this creates a multi band raster collecting all the tiles that intersect " @@ -14624,7 +14647,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8619 +#: reference_raster.xml:8618 #, no-c-format msgid "" "Here we use the longer syntax if we only wanted a subset of bands or we want " @@ -14632,7 +14655,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8620 +#: reference_raster.xml:8619 #, no-c-format msgid "" "-- this creates a multi band raster collecting all the tiles that intersect " @@ -14645,7 +14668,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8626 +#: reference_raster.xml:8625 #, no-c-format msgid "" ", , , " @@ -14653,19 +14676,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:8639 +#: reference_raster.xml:8638 #, no-c-format msgid "Built-in Map Algebra Callback Functions" msgstr "" #. Tag: refname -#: reference_raster.xml:8643 +#: reference_raster.xml:8642 #, no-c-format msgid "ST_Distinct4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8644 +#: reference_raster.xml:8643 #, no-c-format msgid "" "Raster processing function that calculates the number of unique pixel values " @@ -14673,7 +14696,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8648 +#: reference_raster.xml:8647 #, no-c-format msgid "" " float8 ST_Distinct4ma, , " @@ -14767,13 +14790,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:8714 +#: reference_raster.xml:8713 #, no-c-format msgid "ST_InvDistWeight4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8715 +#: reference_raster.xml:8714 #, no-c-format msgid "" "Raster processing function that interpolates a pixel's value from the " @@ -14781,7 +14804,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:8720 +#: reference_raster.xml:8719 #, no-c-format msgid "" "double precision ST_InvDistWeight4ma " @@ -14792,7 +14815,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8732 +#: reference_raster.xml:8731 #, no-c-format msgid "" "Calculate an interpolated value for a pixel using the Inverse Distance " @@ -14800,7 +14823,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8734 +#: reference_raster.xml:8733 #, no-c-format msgid "" "There are two optional parameters that can be passed through " @@ -14814,19 +14837,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8738 +#: reference_raster.xml:8737 #, no-c-format msgid "The basic inverse distance weight equation is:" msgstr "" #. Tag: para -#: reference_raster.xml:8747 +#: reference_raster.xml:8746 #, no-c-format msgid "k = power factor, a real number between 0 and 1" msgstr "" #. Tag: para -#: reference_raster.xml:8756 reference_raster.xml:9041 +#: reference_raster.xml:8755 reference_raster.xml:9040 #, no-c-format msgid "" "This function is a specialized callback function for use as a callback " @@ -14834,25 +14857,25 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8764 reference_raster.xml:9049 +#: reference_raster.xml:8763 reference_raster.xml:9048 #, no-c-format msgid "-- NEEDS EXAMPLE" msgstr "" #. Tag: para -#: reference_raster.xml:8769 +#: reference_raster.xml:8768 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:8778 +#: reference_raster.xml:8777 #, no-c-format msgid "ST_Max4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8779 +#: reference_raster.xml:8778 #, no-c-format msgid "" "Raster processing function that calculates the maximum pixel value in a " @@ -14860,7 +14883,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8783 +#: reference_raster.xml:8782 #, no-c-format msgid "" " float8 ST_Max4ma " @@ -14875,15 +14898,15 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8803 +#: reference_raster.xml:8802 #, no-c-format msgid "Calculate the maximum pixel value in a neighborhood of pixels." msgstr "" #. Tag: para -#: reference_raster.xml:8805 reference_raster.xml:8880 -#: reference_raster.xml:8965 reference_raster.xml:9090 -#: reference_raster.xml:9236 +#: reference_raster.xml:8804 reference_raster.xml:8879 +#: reference_raster.xml:8964 reference_raster.xml:9089 +#: reference_raster.xml:9235 #, no-c-format msgid "" "For Variant 2, a substitution value for NODATA pixels can be specified by " @@ -14891,7 +14914,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8832 +#: reference_raster.xml:8831 #, no-c-format msgid "" "SELECT\n" @@ -14909,7 +14932,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8838 +#: reference_raster.xml:8837 #, no-c-format msgid "" ", , , " @@ -14919,13 +14942,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:8853 +#: reference_raster.xml:8852 #, no-c-format msgid "ST_Mean4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8854 +#: reference_raster.xml:8853 #, no-c-format msgid "" "Raster processing function that calculates the mean pixel value in a " @@ -14933,7 +14956,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8858 +#: reference_raster.xml:8857 #, no-c-format msgid "" " float8 ST_Mean4ma " @@ -14948,13 +14971,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8878 +#: reference_raster.xml:8877 #, no-c-format msgid "Calculate the mean pixel value in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8907 +#: reference_raster.xml:8906 #, no-c-format msgid "" "SELECT\n" @@ -14972,7 +14995,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:8914 +#: reference_raster.xml:8913 #, no-c-format msgid "" "SELECT\n" @@ -14990,7 +15013,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8920 +#: reference_raster.xml:8919 #, no-c-format msgid "" ", , , " @@ -14999,13 +15022,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:8934 +#: reference_raster.xml:8933 #, no-c-format msgid "ST_Min4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:8935 +#: reference_raster.xml:8934 #, no-c-format msgid "" "Raster processing function that calculates the minimum pixel value in a " @@ -15013,7 +15036,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:8941 +#: reference_raster.xml:8940 #, no-c-format msgid "" " float8 ST_Min4ma " @@ -15028,13 +15051,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8961 +#: reference_raster.xml:8960 #, no-c-format msgid "Calculate the minimum pixel value in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:8994 +#: reference_raster.xml:8993 #, no-c-format msgid "" "SELECT\n" @@ -15052,7 +15075,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:8999 +#: reference_raster.xml:8998 #, no-c-format msgid "" ", , , " @@ -15062,13 +15085,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9014 +#: reference_raster.xml:9013 #, no-c-format msgid "ST_MinDist4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9015 +#: reference_raster.xml:9014 #, no-c-format msgid "" "Raster processing function that returns the minimum distance (in number of " @@ -15076,7 +15099,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9020 +#: reference_raster.xml:9019 #, no-c-format msgid "" "double precision ST_MinDist4ma " @@ -15087,7 +15110,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9032 +#: reference_raster.xml:9031 #, no-c-format msgid "" "Return the shortest distance (in number of pixels) between the pixel of " @@ -15095,7 +15118,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9035 +#: reference_raster.xml:9034 #, no-c-format msgid "" "The intent of this function is to provide an informative data point that " @@ -15105,19 +15128,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9054 +#: reference_raster.xml:9053 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:9063 +#: reference_raster.xml:9062 #, no-c-format msgid "ST_Range4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9064 +#: reference_raster.xml:9063 #, no-c-format msgid "" "Raster processing function that calculates the range of pixel values in a " @@ -15125,7 +15148,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9068 +#: reference_raster.xml:9067 #, no-c-format msgid "" " float8 ST_Range4ma " @@ -15140,13 +15163,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9088 +#: reference_raster.xml:9087 #, no-c-format msgid "Calculate the range of pixel values in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9117 +#: reference_raster.xml:9116 #, no-c-format msgid "" "SELECT\n" @@ -15164,13 +15187,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9138 +#: reference_raster.xml:9137 #, no-c-format msgid "ST_StdDev4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9139 +#: reference_raster.xml:9138 #, no-c-format msgid "" "Raster processing function that calculates the standard deviation of pixel " @@ -15178,7 +15201,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9143 +#: reference_raster.xml:9142 #, no-c-format msgid "" " float8 ST_StdDev4ma " @@ -15194,14 +15217,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9163 +#: reference_raster.xml:9162 #, no-c-format msgid "" "Calculate the standard deviation of pixel values in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9188 +#: reference_raster.xml:9187 #, no-c-format msgid "" "SELECT\n" @@ -15219,13 +15242,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9209 +#: reference_raster.xml:9208 #, no-c-format msgid "ST_Sum4ma" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9210 +#: reference_raster.xml:9209 #, no-c-format msgid "" "Raster processing function that calculates the sum of all pixel values in a " @@ -15233,7 +15256,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9214 +#: reference_raster.xml:9213 #, no-c-format msgid "" " float8 ST_Sum4ma " @@ -15248,13 +15271,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9234 +#: reference_raster.xml:9233 #, no-c-format msgid "Calculate the sum of all pixel values in a neighborhood of pixels." msgstr "" #. Tag: programlisting -#: reference_raster.xml:9263 +#: reference_raster.xml:9262 #, no-c-format msgid "" "SELECT\n" @@ -15272,7 +15295,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9269 +#: reference_raster.xml:9268 #, no-c-format msgid "" ", , , " @@ -15282,19 +15305,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:9285 +#: reference_raster.xml:9284 #, no-c-format msgid "DEM (Elevation)" msgstr "" #. Tag: refname -#: reference_raster.xml:9289 +#: reference_raster.xml:9288 #, no-c-format msgid "ST_Aspect" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9290 +#: reference_raster.xml:9289 #, no-c-format msgid "" "Returns the aspect (in degrees by default) of an elevation raster band. " @@ -15302,7 +15325,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9293 +#: reference_raster.xml:9292 #, no-c-format msgid "" " raster ST_Aspect " @@ -15325,7 +15348,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9318 +#: reference_raster.xml:9317 #, no-c-format msgid "" "Returns the aspect (in degrees by default) of an elevation raster band. " @@ -15333,7 +15356,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9320 +#: reference_raster.xml:9319 #, no-c-format msgid "" "units indicates the units of the aspect. Possible values " @@ -15341,7 +15364,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9324 +#: reference_raster.xml:9323 #, no-c-format msgid "" "When units = RADIANS, values are between 0 and 2 * pi " @@ -15349,7 +15372,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9328 +#: reference_raster.xml:9327 #, no-c-format msgid "" "When units = DEGREES, values are between 0 and 360 " @@ -15357,13 +15380,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9332 +#: reference_raster.xml:9331 #, no-c-format msgid "If slope of pixel is zero, aspect of pixel is -1." msgstr "" #. Tag: para -#: reference_raster.xml:9337 +#: reference_raster.xml:9336 #, no-c-format msgid "" "For more information about Slope, Aspect and Hillshade, please refer to " @@ -15375,7 +15398,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9343 reference_raster.xml:9439 +#: reference_raster.xml:9342 reference_raster.xml:9438 #, no-c-format msgid "" "Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional " @@ -15383,7 +15406,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9344 reference_raster.xml:9568 +#: reference_raster.xml:9343 reference_raster.xml:9567 #, no-c-format msgid "" "Changed: 2.1.0 In prior versions, return values were in radians. Now, return " @@ -15391,7 +15414,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9349 +#: reference_raster.xml:9348 #, no-c-format msgid "" "WITH foo AS (\n" @@ -15423,8 +15446,8 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9355 reference_raster.xml:9452 -#: reference_raster.xml:9580 +#: reference_raster.xml:9354 reference_raster.xml:9451 +#: reference_raster.xml:9579 #, no-c-format msgid "" "Complete example of tiles of a coverage. This query only works with " @@ -15432,7 +15455,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9357 +#: reference_raster.xml:9356 #, no-c-format msgid "" "WITH foo AS (\n" @@ -15465,7 +15488,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9362 +#: reference_raster.xml:9361 #, no-c-format msgid "" ", , , raster ST_HillShade " @@ -15520,7 +15543,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9410 +#: reference_raster.xml:9409 #, no-c-format msgid "" "Returns the hypothetical illumination of an elevation raster band using the " @@ -15530,7 +15553,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9412 +#: reference_raster.xml:9411 #, no-c-format msgid "" "azimuth is a value between 0 and 360 degrees measured " @@ -15538,7 +15561,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9416 +#: reference_raster.xml:9415 #, no-c-format msgid "" "altitude is a value between 0 and 90 degrees where 0 " @@ -15546,7 +15569,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9420 +#: reference_raster.xml:9419 #, no-c-format msgid "" "max_bright is a value between 0 and 255 with 0 as no " @@ -15554,7 +15577,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9424 reference_raster.xml:9552 +#: reference_raster.xml:9423 reference_raster.xml:9551 #, no-c-format msgid "" "scale is the ratio of vertical units to horizontal. For " @@ -15562,7 +15585,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9428 +#: reference_raster.xml:9427 #, no-c-format msgid "" "If interpolate_nodata is TRUE, values for NODATA pixels " @@ -15571,7 +15594,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9433 +#: reference_raster.xml:9432 #, no-c-format msgid "" "For more information about Hillshade, please refer to , , raster ST_Roughness " @@ -15688,7 +15711,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9491 +#: reference_raster.xml:9490 #, no-c-format msgid "" "Calculates the \"roughness\" of a DEM, by subtracting the maximum from the " @@ -15696,14 +15719,14 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9497 reference_raster.xml:9630 -#: reference_raster.xml:9681 +#: reference_raster.xml:9496 reference_raster.xml:9629 +#: reference_raster.xml:9680 #, no-c-format msgid "-- needs examples" msgstr "" #. Tag: para -#: reference_raster.xml:9502 +#: reference_raster.xml:9501 #, no-c-format msgid "" ", , , raster ST_Slope " @@ -15752,7 +15775,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9546 +#: reference_raster.xml:9545 #, no-c-format msgid "" "Returns the slope (in degrees by default) of an elevation raster band. " @@ -15760,7 +15783,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9548 +#: reference_raster.xml:9547 #, no-c-format msgid "" "units indicates the units of the slope. Possible values " @@ -15768,7 +15791,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9556 +#: reference_raster.xml:9555 #, no-c-format msgid "" "If interpolate_nodata is TRUE, values for NODATA pixels " @@ -15777,7 +15800,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9561 +#: reference_raster.xml:9560 #, no-c-format msgid "" "For more information about Slope, Aspect and Hillshade, please refer to " @@ -15789,7 +15812,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9567 +#: reference_raster.xml:9566 #, no-c-format msgid "" "Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional units, , raster ST_TPI raster " @@ -15901,7 +15924,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9620 +#: reference_raster.xml:9619 #, no-c-format msgid "" "Calculates the Topographic Position Index, which is defined as the focal " @@ -15909,13 +15932,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9623 reference_raster.xml:9673 +#: reference_raster.xml:9622 reference_raster.xml:9672 #, no-c-format msgid "This function only supports a focalmean radius of one." msgstr "" #. Tag: para -#: reference_raster.xml:9635 +#: reference_raster.xml:9634 #, no-c-format msgid "" ", , , raster ST_TRI raster " @@ -15949,7 +15972,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9668 +#: reference_raster.xml:9667 #, no-c-format msgid "" "Terrain Ruggedness Index is calculated by comparing a central pixel with its " @@ -15958,7 +15981,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9686 +#: reference_raster.xml:9685 #, no-c-format msgid "" ", , , box3d Box3D raster geometry ST_ConvexHull " @@ -16055,7 +16078,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9762 +#: reference_raster.xml:9761 #, no-c-format msgid "" "Return the convex hull geometry of the raster including the NoDataBandValue " @@ -16065,7 +16088,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9766 +#: reference_raster.xml:9765 #, no-c-format msgid "" "ST_Envelope floors the coordinates and hence add a little buffer around the " @@ -16074,7 +16097,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9773 +#: reference_raster.xml:9772 #, no-c-format msgid "" "Refer to , setof geomval ST_DumpAsPolygons " @@ -16152,7 +16175,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9809 +#: reference_raster.xml:9808 #, no-c-format msgid "" "This is a set-returning function (SRF). It returns a set of geomval rows, " @@ -16162,7 +16185,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9813 +#: reference_raster.xml:9812 #, no-c-format msgid "" "ST_DumpAsPolygon is useful for polygonizing rasters. It is the reverse of a " @@ -16171,13 +16194,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9817 +#: reference_raster.xml:9816 #, no-c-format msgid "Availability: Requires GDAL 1.7 or higher." msgstr "" #. Tag: para -#: reference_raster.xml:9818 +#: reference_raster.xml:9817 #, no-c-format msgid "" "If there is a no data value set for a band, pixels with that value will not " @@ -16185,7 +16208,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9819 +#: reference_raster.xml:9818 #, no-c-format msgid "" "If you only care about count of pixels with a given value in a raster, it is " @@ -16193,7 +16216,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9821 +#: reference_raster.xml:9820 #, no-c-format msgid "" "This is different than ST_PixelAsPolygons where one geometry is returned for " @@ -16201,7 +16224,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9829 +#: reference_raster.xml:9828 #, no-c-format msgid "" "-- this syntax requires PostgreSQL 9.3+\n" @@ -16232,7 +16255,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9834 +#: reference_raster.xml:9833 #, no-c-format msgid "" ", , , geometry ST_Envelope " @@ -16260,7 +16283,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9861 +#: reference_raster.xml:9860 #, no-c-format msgid "" "Returns the polygon representation of the extent of the raster in spatial " @@ -16269,7 +16292,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9863 +#: reference_raster.xml:9862 #, no-c-format msgid "" "The polygon is defined by the corner points of the bounding box " @@ -16280,7 +16303,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9875 +#: reference_raster.xml:9874 #, no-c-format msgid "" "SELECT rid, ST_AsText(ST_Envelope(rast)) As envgeomwkt\n" @@ -16294,25 +16317,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9880 +#: reference_raster.xml:9879 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_raster.xml:9890 +#: reference_raster.xml:9889 #, no-c-format msgid "ST_MinConvexHull" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9891 +#: reference_raster.xml:9890 #, no-c-format msgid "Return the convex hull geometry of the raster excluding NODATA pixels." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9898 +#: reference_raster.xml:9897 #, no-c-format msgid "" "geometry ST_MinConvexHull " @@ -16322,7 +16345,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9909 +#: reference_raster.xml:9908 #, no-c-format msgid "" "Return the convex hull geometry of the raster excluding NODATA pixels. If " @@ -16330,7 +16353,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9918 +#: reference_raster.xml:9917 #, no-c-format msgid "" "WITH foo AS (\n" @@ -16383,7 +16406,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9923 +#: reference_raster.xml:9922 #, no-c-format msgid "" ", , , " @@ -16391,13 +16414,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:9934 +#: reference_raster.xml:9933 #, no-c-format msgid "ST_Polygon" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9935 +#: reference_raster.xml:9934 #, no-c-format msgid "" "Returns a multipolygon geometry formed by the union of pixels that have a " @@ -16406,7 +16429,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:9940 +#: reference_raster.xml:9939 #, no-c-format msgid "" "geometry ST_Polygon " @@ -16416,13 +16439,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9950 +#: reference_raster.xml:9949 #, no-c-format msgid "Availability: 0.1.6 Requires GDAL 1.7 or higher." msgstr "" #. Tag: para -#: reference_raster.xml:9951 +#: reference_raster.xml:9950 #, no-c-format msgid "" "Enhanced: 2.1.0 Improved Speed (fully C-Based) and the returning " @@ -16430,7 +16453,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:9952 +#: reference_raster.xml:9951 #, no-c-format msgid "" "Changed: 2.1.0 In prior versions would sometimes return a polygon, changed " @@ -16438,7 +16461,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:9957 +#: reference_raster.xml:9956 #, no-c-format msgid "" "-- by default no data band value is 0 or not set, so polygon will return a " @@ -16499,19 +16522,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:9974 +#: reference_raster.xml:9973 #, no-c-format msgid "Raster Operators" msgstr "" #. Tag: refname -#: reference_raster.xml:9977 +#: reference_raster.xml:9976 #, no-c-format msgid "&&" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:9979 +#: reference_raster.xml:9978 #, no-c-format msgid "" "Returns TRUE if A's bounding box intersects B's bounding " @@ -16519,7 +16542,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:9983 +#: reference_raster.xml:9982 #, no-c-format msgid "" " boolean && " @@ -16535,7 +16558,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10025 +#: reference_raster.xml:10024 #, no-c-format msgid "" "The && operator returns TRUE " @@ -16544,9 +16567,9 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10027 reference_raster.xml:10074 -#: reference_raster.xml:10278 reference_raster.xml:11288 -#: reference_raster.xml:11389 reference_raster.xml:11482 +#: reference_raster.xml:10026 reference_raster.xml:10073 +#: reference_raster.xml:10277 reference_raster.xml:11287 +#: reference_raster.xml:11388 reference_raster.xml:11481 #, no-c-format msgid "" "This operand will make use of any indexes that may be available on the " @@ -16554,7 +16577,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10036 +#: reference_raster.xml:10035 #, no-c-format msgid "" "SELECT A.rid As a_rid, B.rid As b_rid, A.rast && B.rast As " @@ -16569,20 +16592,20 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10042 +#: reference_raster.xml:10041 #, no-c-format msgid "&<" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10044 +#: reference_raster.xml:10043 #, no-c-format msgid "" "Returns TRUE if A's bounding box is to the left of B's." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:10049 +#: reference_raster.xml:10048 #, no-c-format msgid "" "boolean &< " @@ -16591,7 +16614,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10070 +#: reference_raster.xml:10069 #, no-c-format msgid "" "The &< operator returns TRUE if " @@ -16601,7 +16624,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10080 +#: reference_raster.xml:10079 #, no-c-format msgid "" "SELECT A.rid As a_rid, B.rid As b_rid, A.rast &< B.rast As overleft\n" @@ -16621,20 +16644,20 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10086 +#: reference_raster.xml:10085 #, no-c-format msgid "&>" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10088 +#: reference_raster.xml:10087 #, no-c-format msgid "" "Returns TRUE if A's bounding box is to the right of B's." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:10093 +#: reference_raster.xml:10092 #, no-c-format msgid "" "boolean &> " @@ -16643,7 +16666,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10114 +#: reference_raster.xml:10113 #, no-c-format msgid "" "The &> operator returns TRUE if " @@ -16653,7 +16676,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10118 +#: reference_raster.xml:10117 #, no-c-format msgid "" "This operand will make use of any indexes that may be available on the " @@ -16661,7 +16684,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10125 +#: reference_raster.xml:10124 #, no-c-format msgid "" "SELECT A.rid As a_rid, B.rid As b_rid, A.rast &> B.rast As overright\n" @@ -16681,13 +16704,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10131 +#: reference_raster.xml:10130 #, no-c-format msgid "=" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10133 +#: reference_raster.xml:10132 #, no-c-format msgid "" "Returns TRUE if A's bounding box is the same as B's. Uses " @@ -16695,7 +16718,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:10138 +#: reference_raster.xml:10137 #, no-c-format msgid "" "boolean = " @@ -16704,7 +16727,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10159 +#: reference_raster.xml:10158 #, no-c-format msgid "" "The = operator returns TRUE if the " @@ -16715,7 +16738,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10163 +#: reference_raster.xml:10162 #, no-c-format msgid "" "This operand will NOT make use of any indexes that may be available on the " @@ -16724,13 +16747,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10179 +#: reference_raster.xml:10178 #, no-c-format msgid "@" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10181 +#: reference_raster.xml:10180 #, no-c-format msgid "" "Returns TRUE if A's bounding box is contained by B's. " @@ -16738,7 +16761,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10185 +#: reference_raster.xml:10184 #, no-c-format msgid "" " boolean @ " @@ -16753,7 +16776,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10228 +#: reference_raster.xml:10227 #, no-c-format msgid "" "The @ operator returns TRUE if the " @@ -16762,37 +16785,37 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10231 reference_raster.xml:10351 +#: reference_raster.xml:10230 reference_raster.xml:10350 #, no-c-format msgid "This operand will use spatial indexes on the rasters." msgstr "" #. Tag: para -#: reference_raster.xml:10233 +#: reference_raster.xml:10232 #, no-c-format msgid "Availability: 2.0.0 raster @ raster, raster @ geometry introduced" msgstr "" #. Tag: para -#: reference_raster.xml:10234 +#: reference_raster.xml:10233 #, no-c-format msgid "Availability: 2.0.5 geometry @ raster introduced" msgstr "" #. Tag: refname -#: reference_raster.xml:10247 +#: reference_raster.xml:10246 #, no-c-format msgid "~=" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10249 +#: reference_raster.xml:10248 #, no-c-format msgid "Returns TRUE if A's bounding box is the same as B's." msgstr "" #. Tag: funcprototype -#: reference_raster.xml:10254 +#: reference_raster.xml:10253 #, no-c-format msgid "" "boolean ~= raster ~= operator returns TRUE if the " @@ -16809,7 +16832,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10287 +#: reference_raster.xml:10286 #, no-c-format msgid "" "Very useful usecase is for taking two sets of single band rasters that are " @@ -16818,7 +16841,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10288 +#: reference_raster.xml:10287 #, no-c-format msgid "" "SELECT ST_AddBand(prec.rast, alt.rast) As new_rast\n" @@ -16826,19 +16849,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10293 +#: reference_raster.xml:10292 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10299 +#: reference_raster.xml:10298 #, no-c-format msgid "~" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10301 +#: reference_raster.xml:10300 #, no-c-format msgid "" "Returns TRUE if A's bounding box is contains B's. Uses " @@ -16846,7 +16869,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10305 +#: reference_raster.xml:10304 #, no-c-format msgid "" " boolean ~ " @@ -16861,7 +16884,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10348 +#: reference_raster.xml:10347 #, no-c-format msgid "" "The ~ operator returns TRUE if the " @@ -16870,19 +16893,19 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:10366 +#: reference_raster.xml:10365 #, no-c-format msgid "Raster and Raster Band Spatial Relationships" msgstr "" #. Tag: refname -#: reference_raster.xml:10370 +#: reference_raster.xml:10369 #, no-c-format msgid "ST_Contains" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10371 +#: reference_raster.xml:10370 #, no-c-format msgid "" "Return true if no points of raster rastB lie in the exterior of raster rastA " @@ -16891,7 +16914,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10377 +#: reference_raster.xml:10376 #, no-c-format msgid "" " boolean ST_Contains " @@ -16906,7 +16929,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10416 +#: reference_raster.xml:10415 #, no-c-format msgid "" "Raster rastA contains rastB if and only if no points of rastB lie in the " @@ -16918,10 +16941,10 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10421 reference_raster.xml:10514 -#: reference_raster.xml:10595 reference_raster.xml:10676 -#: reference_raster.xml:10886 reference_raster.xml:10970 -#: reference_raster.xml:11050 +#: reference_raster.xml:10420 reference_raster.xml:10513 +#: reference_raster.xml:10594 reference_raster.xml:10675 +#: reference_raster.xml:10885 reference_raster.xml:10969 +#: reference_raster.xml:11049 #, no-c-format msgid "" "This function will make use of any indexes that may be available on the " @@ -16929,7 +16952,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10427 +#: reference_raster.xml:10426 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -16938,7 +16961,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10433 +#: reference_raster.xml:10432 #, no-c-format msgid "" "ST_Contains() is the inverse of ST_Within(). So, ST_Contains(rastA, rastB) " @@ -16946,7 +16969,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10444 +#: reference_raster.xml:10443 #, no-c-format msgid "" "-- specified band numbers\n" @@ -16961,7 +16984,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10446 +#: reference_raster.xml:10445 #, no-c-format msgid "" "-- no band numbers specified\n" @@ -16974,19 +16997,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10450 +#: reference_raster.xml:10449 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10459 +#: reference_raster.xml:10458 #, no-c-format msgid "ST_ContainsProperly" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10460 +#: reference_raster.xml:10459 #, no-c-format msgid "" "Return true if rastB intersects the interior of rastA but not the boundary " @@ -16994,7 +17017,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10466 +#: reference_raster.xml:10465 #, no-c-format msgid "" " boolean ST_ContainsProperly" msgstr "" #. Tag: refname -#: reference_raster.xml:10544 +#: reference_raster.xml:10543 #, no-c-format msgid "ST_Covers" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10545 +#: reference_raster.xml:10544 #, no-c-format msgid "Return true if no points of raster rastB lie outside raster rastA." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10551 +#: reference_raster.xml:10550 #, no-c-format msgid "" " boolean ST_Covers " @@ -17081,7 +17104,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10590 +#: reference_raster.xml:10589 #, no-c-format msgid "" "Raster rastA covers rastB if and only if no points of rastB lie in the " @@ -17092,7 +17115,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10601 +#: reference_raster.xml:10600 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -17101,7 +17124,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10612 +#: reference_raster.xml:10611 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_Covers(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 " @@ -17114,25 +17137,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10616 +#: reference_raster.xml:10615 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10625 +#: reference_raster.xml:10624 #, no-c-format msgid "ST_CoveredBy" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10626 +#: reference_raster.xml:10625 #, no-c-format msgid "Return true if no points of raster rastA lie outside raster rastB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10632 +#: reference_raster.xml:10631 #, no-c-format msgid "" " boolean ST_CoveredBy " @@ -17147,7 +17170,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10671 +#: reference_raster.xml:10670 #, no-c-format msgid "" "Raster rastA is covered by rastB if and only if no points of rastA lie in " @@ -17158,7 +17181,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10682 +#: reference_raster.xml:10681 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -17167,7 +17190,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10693 +#: reference_raster.xml:10692 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_CoveredBy(r1.rast, 1, r2.rast, 1) FROM dummy_rast " @@ -17180,25 +17203,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10697 +#: reference_raster.xml:10696 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:10706 +#: reference_raster.xml:10705 #, no-c-format msgid "ST_Disjoint" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10707 +#: reference_raster.xml:10706 #, no-c-format msgid "Return true if raster rastA does not spatially intersect rastB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10713 +#: reference_raster.xml:10712 #, no-c-format msgid "" " boolean ST_Disjoint " @@ -17213,7 +17236,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10752 +#: reference_raster.xml:10751 #, no-c-format msgid "" "Raster rastA and rastB are disjointed if they do not share any space " @@ -17224,13 +17247,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10757 +#: reference_raster.xml:10756 #, no-c-format msgid "This function does NOT use any indexes." msgstr "" #. Tag: para -#: reference_raster.xml:10763 +#: reference_raster.xml:10762 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -17238,7 +17261,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10774 +#: reference_raster.xml:10773 #, no-c-format msgid "" "-- rid = 1 has no bands, hence the NOTICE and the NULL value for " @@ -17254,7 +17277,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10776 +#: reference_raster.xml:10775 #, no-c-format msgid "" "-- this time, without specifying band numbers\n" @@ -17268,19 +17291,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10789 +#: reference_raster.xml:10788 #, no-c-format msgid "ST_Intersects" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10790 +#: reference_raster.xml:10789 #, no-c-format msgid "Return true if raster rastA spatially intersects raster rastB." msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10794 +#: reference_raster.xml:10793 #, no-c-format msgid "" " boolean ST_Intersects" msgstr "" #. Tag: refname -#: reference_raster.xml:10919 +#: reference_raster.xml:10918 #, no-c-format msgid "ST_Overlaps" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:10920 +#: reference_raster.xml:10919 #, no-c-format msgid "" "Return true if raster rastA and rastB intersect but one does not completely " @@ -17365,7 +17388,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:10926 +#: reference_raster.xml:10925 #, no-c-format msgid "" " boolean ST_Overlaps " @@ -17380,7 +17403,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10965 +#: reference_raster.xml:10964 #, no-c-format msgid "" "Return true if raster rastA spatially overlaps raster rastB. This means that " @@ -17391,7 +17414,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:10976 +#: reference_raster.xml:10975 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -17399,7 +17422,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:10987 +#: reference_raster.xml:10986 #, no-c-format msgid "" "-- comparing different bands of same raster\n" @@ -17411,13 +17434,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:10999 +#: reference_raster.xml:10998 #, no-c-format msgid "ST_Touches" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:11000 +#: reference_raster.xml:10999 #, no-c-format msgid "" "Return true if raster rastA and rastB have at least one point in common but " @@ -17425,7 +17448,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:11006 +#: reference_raster.xml:11005 #, no-c-format msgid "" " boolean ST_Touches " @@ -17440,7 +17463,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11045 +#: reference_raster.xml:11044 #, no-c-format msgid "" "Return true if raster rastA spatially touches raster rastB. This means that " @@ -17452,7 +17475,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11056 +#: reference_raster.xml:11055 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -17460,7 +17483,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11067 +#: reference_raster.xml:11066 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_Touches(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 " @@ -17473,13 +17496,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:11079 +#: reference_raster.xml:11078 #, no-c-format msgid "ST_SameAlignment" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:11081 +#: reference_raster.xml:11080 #, no-c-format msgid "" "Returns true if rasters have same skew, scale, spatial ref, and offset " @@ -17488,7 +17511,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:11085 +#: reference_raster.xml:11084 #, no-c-format msgid "" " boolean ST_SameAlignment, Returns text stating if rasters are aligned and if not aligned, " @@ -17603,7 +17626,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_raster.xml:11200 +#: reference_raster.xml:11199 #, no-c-format msgid "" "text ST_NotSameAlignmentReason " @@ -17612,7 +17635,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11210 +#: reference_raster.xml:11209 #, no-c-format msgid "" "Returns text stating if rasters are aligned and if not aligned, a " @@ -17620,7 +17643,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11213 +#: reference_raster.xml:11212 #, no-c-format msgid "" "If there are several reasons why the rasters are not aligned, only one " @@ -17628,7 +17651,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11223 +#: reference_raster.xml:11222 #, no-c-format msgid "" "SELECT\n" @@ -17649,19 +17672,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11228 +#: reference_raster.xml:11227 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:11237 +#: reference_raster.xml:11236 #, no-c-format msgid "ST_Within" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:11238 +#: reference_raster.xml:11237 #, no-c-format msgid "" "Return true if no points of raster rastA lie in the exterior of raster rastB " @@ -17670,7 +17693,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:11244 +#: reference_raster.xml:11243 #, no-c-format msgid "" " boolean ST_Within " @@ -17685,7 +17708,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11283 +#: reference_raster.xml:11282 #, no-c-format msgid "" "Raster rastA is within rastB if and only if no points of rastA lie in the " @@ -17697,7 +17720,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11294 +#: reference_raster.xml:11293 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -17706,7 +17729,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11300 +#: reference_raster.xml:11299 #, no-c-format msgid "" "ST_Within() is the inverse of ST_Contains(). So, ST_Within(rastA, rastB) " @@ -17714,7 +17737,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11311 +#: reference_raster.xml:11310 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_Within(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 " @@ -17727,7 +17750,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11315 +#: reference_raster.xml:11314 #, no-c-format msgid "" ", , , " @@ -17735,13 +17758,13 @@ msgid "" msgstr "" #. Tag: refname -#: reference_raster.xml:11326 +#: reference_raster.xml:11325 #, no-c-format msgid "ST_DWithin" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:11327 +#: reference_raster.xml:11326 #, no-c-format msgid "" "Return true if rasters rastA and rastB are within the specified distance of " @@ -17749,7 +17772,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:11333 +#: reference_raster.xml:11332 #, no-c-format msgid "" " boolean ST_DWithin " @@ -17766,7 +17789,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11380 +#: reference_raster.xml:11379 #, no-c-format msgid "" "Return true if rasters rastA and rastB are within the specified distance of " @@ -17777,7 +17800,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11384 reference_raster.xml:11477 +#: reference_raster.xml:11383 reference_raster.xml:11476 #, no-c-format msgid "" "The distance is specified in units defined by the spatial reference system " @@ -17786,7 +17809,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11395 +#: reference_raster.xml:11394 #, no-c-format msgid "" "To test the spatial relationship of a raster and a geometry, use ST_Polygon " @@ -17794,7 +17817,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11406 +#: reference_raster.xml:11405 #, no-c-format msgid "" "SELECT r1.rid, r2.rid, ST_DWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM " @@ -17807,19 +17830,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11410 +#: reference_raster.xml:11409 #, no-c-format msgid ", " msgstr "" #. Tag: refname -#: reference_raster.xml:11419 +#: reference_raster.xml:11418 #, no-c-format msgid "ST_DFullyWithin" msgstr "" #. Tag: refpurpose -#: reference_raster.xml:11420 +#: reference_raster.xml:11419 #, no-c-format msgid "" "Return true if rasters rastA and rastB are fully within the specified " @@ -17827,7 +17850,7 @@ msgid "" msgstr "" #. Tag: funcsynopsis -#: reference_raster.xml:11426 +#: reference_raster.xml:11425 #, no-c-format msgid "" " boolean ST_DFullyWithin" msgstr "" #. Tag: para -#: reference_raster.xml:11515 +#: reference_raster.xml:11514 #, no-c-format msgid "" "This section documents various gotchas and tips related to PostGIS Raster." msgstr "" #. Tag: title -#: reference_raster.xml:11518 +#: reference_raster.xml:11517 #, no-c-format msgid "Raster Tips" msgstr "" #. Tag: title -#: reference_raster.xml:11521 +#: reference_raster.xml:11520 #, no-c-format msgid "Out-DB Rasters" msgstr "" #. Tag: title -#: reference_raster.xml:11524 +#: reference_raster.xml:11523 #, no-c-format msgid "Directory containing many files" msgstr "" #. Tag: para -#: reference_raster.xml:11525 +#: reference_raster.xml:11524 #, no-c-format msgid "" "When GDAL opens a file, GDAL eagerly scans the directory of that file to " @@ -17918,7 +17941,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11528 +#: reference_raster.xml:11527 #, no-c-format msgid "" "To control this behavior, GDAL provides the following environment variable: " @@ -17929,7 +17952,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11532 +#: reference_raster.xml:11531 #, no-c-format msgid "" "In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), " @@ -17941,7 +17964,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11535 +#: reference_raster.xml:11534 #, no-c-format msgid "" "# environment variables for postmaster process\n" @@ -17960,13 +17983,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:11541 +#: reference_raster.xml:11540 #, no-c-format msgid "Maximum Number of Open Files" msgstr "" #. Tag: para -#: reference_raster.xml:11543 +#: reference_raster.xml:11542 #, no-c-format msgid "" "The maximum number of open files permitted by Linux and PostgreSQL are " @@ -17979,7 +18002,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11547 +#: reference_raster.xml:11546 #, no-c-format msgid "" "The easiest change to make is the following PostgreSQL setting: Maximum number of open files for the entire system" msgstr "" #. Tag: para -#: reference_raster.xml:11560 +#: reference_raster.xml:11559 #, no-c-format msgid "Maximum number of open files per process" msgstr "" #. Tag: title -#: reference_raster.xml:11566 +#: reference_raster.xml:11565 #, no-c-format msgid "Maximum number of open files for the entire system" msgstr "" #. Tag: para -#: reference_raster.xml:11568 +#: reference_raster.xml:11567 #, no-c-format msgid "" "You can inspect the current maximum number of open files for the entire " @@ -18041,7 +18064,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11572 +#: reference_raster.xml:11571 #, no-c-format msgid "" "$ sysctl -a | grep fs.file-max\n" @@ -18049,7 +18072,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11574 +#: reference_raster.xml:11573 #, no-c-format msgid "" "If the value returned is not large enough, add a file to /etc/" @@ -18057,7 +18080,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11578 +#: reference_raster.xml:11577 #, no-c-format msgid "" "$ echo \"fs.file-max = 6145324\" >> /etc/sysctl.d/fs.conf\n" @@ -18075,13 +18098,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_raster.xml:11582 +#: reference_raster.xml:11581 #, no-c-format msgid "Maximum number of open files per process" msgstr "" #. Tag: para -#: reference_raster.xml:11584 +#: reference_raster.xml:11583 #, no-c-format msgid "" "We need to increase the maximum number of open files per process for the " @@ -18089,7 +18112,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11588 +#: reference_raster.xml:11587 #, no-c-format msgid "" "To see what the current PostgreSQL service processes are using for maximum " @@ -18098,7 +18121,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_raster.xml:11592 +#: reference_raster.xml:11591 #, no-c-format msgid "" "$ ps aux | grep postgres\n" @@ -18141,7 +18164,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11594 +#: reference_raster.xml:11593 #, no-c-format msgid "" "In the example above, we inspected the open files limit for Process 31718. " @@ -18150,7 +18173,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11598 +#: reference_raster.xml:11597 #, no-c-format msgid "" "We want to increase Soft Limit and Hard " @@ -18161,7 +18184,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11602 +#: reference_raster.xml:11601 #, no-c-format msgid "" "In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), the " @@ -18172,7 +18195,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_raster.xml:11606 +#: reference_raster.xml:11605 #, no-c-format msgid "" "Let's first address the SysV Ubuntu case where we add , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_relationship.xml:5 +#, no-c-format +msgid "These functions determine spatial relationships between geometries." +msgstr "" + +#. Tag: title +#: reference_relationship.xml:8 +#, no-c-format +msgid "Spatial Relationships" +msgstr "" + +#. Tag: title +#: reference_relationship.xml:11 +#, no-c-format +msgid "Topological Relationships" +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:15 +#, no-c-format +msgid "ST_3DIntersects" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:17 +#, no-c-format +msgid "" +"Returns TRUE if the Geometries \"spatially intersect\" in 3D - only for " +"points, linestrings, polygons, polyhedral surface (area)." +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:23 +#, no-c-format +msgid "" +"boolean ST_3DIntersects " +"geometry geomA " +"geometry geomB " +msgstr "" + +#. Tag: title +#: reference_relationship.xml:37 reference_relationship.xml:93 +#: reference_relationship.xml:246 reference_relationship.xml:323 +#: reference_relationship.xml:402 reference_relationship.xml:461 +#: reference_relationship.xml:627 reference_relationship.xml:762 +#: reference_relationship.xml:815 reference_relationship.xml:889 +#: reference_relationship.xml:954 reference_relationship.xml:997 +#: reference_relationship.xml:1089 reference_relationship.xml:1152 +#: reference_relationship.xml:1216 reference_relationship.xml:1260 +#: reference_relationship.xml:1408 reference_relationship.xml:1488 +#: reference_relationship.xml:1540 reference_relationship.xml:1599 +#: reference_relationship.xml:1669 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:38 +#, 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_relationship.xml:42 +#, no-c-format +msgid "Changed: 3.0.0 SFCGAL backend removed, GEOS backend supports TINs." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:43 reference_relationship.xml:1221 +#: reference_relationship.xml:1498 reference_relationship.xml:1554 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:45 reference_relationship.xml:517 +#: reference_relationship.xml:903 reference_relationship.xml:1549 +#: reference_relationship.xml:1608 reference_relationship.xml:1684 +#, 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: para +#: reference_relationship.xml:50 reference_relationship.xml:1493 +#: reference_relationship.xml:1555 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:52 reference_relationship.xml:1495 +#: reference_relationship.xml:1557 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:53 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:54 reference_relationship.xml:919 +#, no-c-format +msgid "&sfcgal_enhanced;" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:55 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: ?" +msgstr "" + +#. Tag: title +#: reference_relationship.xml:58 reference_relationship.xml:922 +#, no-c-format +msgid "Geometry Examples" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:59 +#, no-c-format +msgid "" +"SELECT ST_3DIntersects(pt, line), ST_Intersects(pt, line)\n" +" FROM (SELECT 'POINT(0 0 2)'::geometry As pt, '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: title +#: reference_relationship.xml:62 +#, no-c-format +msgid "TIN Examples" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:63 +#, no-c-format +msgid "" +"SELECT ST_3DIntersects('TIN(((0 0 0,1 0 0,0 1 0,0 0 0)))'::geometry, " +"'POINT(.1 .1 0)'::geometry);\n" +" st_3dintersects\n" +"-----------------\n" +" t" +msgstr "" + +#. Tag: title +#: reference_relationship.xml:66 reference_relationship.xml:219 +#: reference_relationship.xml:286 reference_relationship.xml:364 +#: reference_relationship.xml:435 reference_relationship.xml:732 +#: reference_relationship.xml:791 reference_relationship.xml:845 +#: reference_relationship.xml:930 reference_relationship.xml:974 +#: reference_relationship.xml:1063 reference_relationship.xml:1110 +#: reference_relationship.xml:1192 reference_relationship.xml:1232 +#: reference_relationship.xml:1453 reference_relationship.xml:1508 +#: reference_relationship.xml:1567 reference_relationship.xml:1622 +#: reference_relationship.xml:1710 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:73 +#, no-c-format +msgid "ST_Contains" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:75 +#, 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_relationship.xml:80 +#, no-c-format +msgid "" +"boolean ST_Contains " +"geometry geomA " +"geometry geomB" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:95 +#, 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 where geometry A does not Contain Properly " +"itself." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:99 +#, 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_relationship.xml:104 reference_relationship.xml:341 +#: reference_relationship.xml:414 reference_relationship.xml:771 +#: reference_relationship.xml:1002 reference_relationship.xml:1180 +#: reference_relationship.xml:1220 reference_relationship.xml:1415 +#, no-c-format +msgid "Performed by the GEOS module" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:105 reference_relationship.xml:899 +#, no-c-format +msgid "" +"Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support " +"MultiPoints with few points. Prior versions only supported point in polygon." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:108 reference_relationship.xml:266 +#: reference_relationship.xml:329 reference_relationship.xml:408 +#: reference_relationship.xml:513 reference_relationship.xml:768 +#: reference_relationship.xml:830 reference_relationship.xml:1005 +#: reference_relationship.xml:1174 reference_relationship.xml:1296 +#: reference_relationship.xml:1420 +#, no-c-format +msgid "" +"Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:112 reference_relationship.xml:270 +#: reference_relationship.xml:333 reference_relationship.xml:412 +#: reference_relationship.xml:1424 +#, no-c-format +msgid "" +"Do not use this function with invalid geometries. You will get unexpected " +"results." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:115 +#, 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_relationship.xml:120 reference_relationship.xml:347 +#: reference_relationship.xml:421 reference_relationship.xml:777 +#: reference_relationship.xml:912 reference_relationship.xml:1013 +#: reference_relationship.xml:1432 +#, no-c-format +msgid "" +"NOTE: this is the \"allowable\" version that returns a boolean, not an " +"integer." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:123 +#, 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_relationship.xml:125 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.31" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:127 reference_relationship.xml:351 +#: reference_relationship.xml:425 +#, no-c-format +msgid "" +"There are certain subtleties to ST_Contains and ST_Within that are not " +"intuitively obvious. For details check out Subtleties of OGC Covers, Contains, Within" +msgstr "" + +#. Tag: title +#: reference_relationship.xml:132 reference_relationship.xml:281 +#: reference_relationship.xml:356 reference_relationship.xml:430 +#: reference_relationship.xml:527 reference_relationship.xml:662 +#: reference_relationship.xml:785 reference_relationship.xml:839 +#: reference_relationship.xml:969 reference_relationship.xml:1021 +#: reference_relationship.xml:1103 reference_relationship.xml:1186 +#: reference_relationship.xml:1226 reference_relationship.xml:1310 +#: reference_relationship.xml:1442 reference_relationship.xml:1502 +#: reference_relationship.xml:1562 reference_relationship.xml:1617 +#: reference_relationship.xml:1705 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:134 +#, no-c-format +msgid "" +"The ST_Contains predicate returns TRUE in all the following illustrations." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:146 +#, no-c-format +msgid "LINESTRING / MULTIPOINT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:156 reference_relationship.xml:1374 +#, no-c-format +msgid "POLYGON / POINT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:167 reference_relationship.xml:207 +#: reference_relationship.xml:1343 +#, no-c-format +msgid "POLYGON / LINESTRING" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:177 reference_relationship.xml:1050 +#: reference_relationship.xml:1323 reference_relationship.xml:1333 +#, no-c-format +msgid "POLYGON / POLYGON" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:185 +#, no-c-format +msgid "" +"The ST_Contains predicate returns FALSE in all the following illustrations." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:197 +#, no-c-format +msgid "POLYGON / MULTIPOINT" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:215 +#, 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_relationship.xml:220 +#, no-c-format +msgid "" +", , , " +", , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:226 +#, no-c-format +msgid "ST_ContainsProperly" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:228 +#, 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_relationship.xml:233 +#, no-c-format +msgid "" +"boolean ST_ContainsProperly " +"geometry geomA " +"geometry geomB" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:248 +#, no-c-format +msgid "" +"Returns true if B intersects the interior of A but not the boundary (or " +"exterior)." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:250 +#, no-c-format +msgid "A does not contain properly itself, but does contain itself." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:251 +#, 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 " +msgstr "" + +#. Tag: para +#: reference_relationship.xml:255 +#, no-c-format +msgid "" +"From JTS docs slightly reworded: The advantage to using this predicate over " +" and is " +"that it can be computed efficiently, with no need to compute topology at " +"individual points." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:257 +#, 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_relationship.xml:262 +#, no-c-format +msgid "Performed by the GEOS module." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:263 +#, no-c-format +msgid "Availability: 1.4.0" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:273 +#, 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_relationship.xml:282 +#, 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_relationship.xml:287 +#, no-c-format +msgid "" +", , , , , , , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:293 +#, no-c-format +msgid "ST_Covers" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:295 +#, no-c-format +msgid "Returns 1 (TRUE) if no point in Geometry B is outside Geometry A" +msgstr "" + +#. Tag: funcsynopsis +#: reference_relationship.xml:300 +#, no-c-format +msgid "" +" boolean ST_Covers " +"geometry geomA " +"geometry geomB boolean ST_Covers geography geogpolyA geography " +"geogpointB " +msgstr "" + +#. Tag: para +#: reference_relationship.xml:325 +#, no-c-format +msgid "" +"Returns 1 (TRUE) if no point in Geometry/Geography B is outside Geometry/" +"Geography A" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:336 +#, 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_relationship.xml:342 +#, no-c-format +msgid "" +"Enhanced: 2.4.0 Support for polygon in polygon and line in polygon added for " +"geography type" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:343 reference_relationship.xml:1417 +#, no-c-format +msgid "" +"Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to " +"support MultiPoints with few points. Prior versions only supported point in " +"polygon." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:344 +#, no-c-format +msgid "Availability: 1.5 - support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:345 reference_relationship.xml:415 +#, no-c-format +msgid "Availability: 1.2.2" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:350 reference_relationship.xml:424 +#, no-c-format +msgid "Not an OGC standard, but Oracle has it too." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:357 +#, no-c-format +msgid "Geometry example" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:358 +#, 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_relationship.xml:359 +#, no-c-format +msgid "Geeography Example" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:360 +#, 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_relationship.xml:365 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:371 +#, no-c-format +msgid "ST_CoveredBy" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:373 +#, no-c-format +msgid "" +"Returns 1 (TRUE) if no point in Geometry/Geography A is outside " +"Geometry/Geography B" +msgstr "" + +#. Tag: funcsynopsis +#: reference_relationship.xml:378 +#, no-c-format +msgid "" +" boolean ST_CoveredBy " +"geometry geomA " +"geometry geomB boolean ST_CoveredBy geography geogA geography geogB " +msgstr "" + +#. Tag: para +#: reference_relationship.xml:404 +#, no-c-format +msgid "" +"Returns 1 (TRUE) if no point in Geometry/Geography A is outside " +"Geometry/Geography B" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:416 +#, 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_relationship.xml:431 +#, 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_relationship.xml:436 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:442 +#, no-c-format +msgid "ST_Crosses" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:444 +#, no-c-format +msgid "" +"Returns TRUE if the supplied geometries have some, but " +"not all, interior points in common." +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:450 +#, no-c-format +msgid "" +"boolean ST_Crosses " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:463 +#, no-c-format +msgid "" +"ST_Crosses takes two geometry objects and returns " +"TRUE 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 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 " +"FALSE." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:472 +#, no-c-format +msgid "In mathematical terms, this is expressed as:" +msgstr "" + +#. Tag: remark +#: reference_relationship.xml:474 +#, 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_relationship.xml:485 +#, no-c-format +msgid "The DE-9IM Intersection Matrix for the two geometries is:" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:489 +#, no-c-format +msgid "" +"T*T****** (for Point/Line, Point/Area, and Line/Area " +"situations)" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:494 +#, no-c-format +msgid "" +"T*****T** (for Line/Point, Area/Point, and Area/Line " +"situations)" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:499 +#, no-c-format +msgid "0******** (for Line/Line situations)" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:503 +#, no-c-format +msgid "For any other combination of dimensions this predicate returns false." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:506 +#, 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_relationship.xml:522 +#, no-c-format +msgid "&sfs_compliant; s2.1.13.3" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:523 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.29" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:529 reference_relationship.xml:1022 +#, no-c-format +msgid "The following illustrations all return TRUE." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:541 +#, no-c-format +msgid "MULTIPOINT / LINESTRING" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:551 +#, no-c-format +msgid "MULTIPOINT / POLYGON" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:563 +#, no-c-format +msgid "LINESTRING / POLYGON" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:573 reference_relationship.xml:1042 +#: reference_relationship.xml:1354 reference_relationship.xml:1364 +#, no-c-format +msgid "LINESTRING / LINESTRING" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:581 +#, 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_relationship.xml:589 +#, 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_relationship.xml:593 +#, 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_relationship.xml:600 +#, no-c-format +msgid "" +"To determine a list of roads that cross a highway, use a query similiar to:" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:604 +#, 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_relationship.xml:611 +#, no-c-format +msgid "ST_LineCrossingDirection" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:613 +#, 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_relationship.xml:618 +#, no-c-format +msgid "" +"integer ST_LineCrossingDirection " +"geometry linestringA geometry linestringB" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:629 +#, 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 " +"LINESTRING" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:630 +#, no-c-format +msgid "Definition of integer constants is as follows:" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:633 +#, no-c-format +msgid "0: LINE NO CROSS" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:636 +#, no-c-format +msgid "-1: LINE CROSS LEFT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:639 +#, no-c-format +msgid "1: LINE CROSS RIGHT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:642 +#, no-c-format +msgid "-2: LINE MULTICROSS END LEFT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:645 +#, no-c-format +msgid "2: LINE MULTICROSS END RIGHT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:648 +#, no-c-format +msgid "-3: LINE MULTICROSS END SAME FIRST LEFT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:651 +#, no-c-format +msgid "3: LINE MULTICROSS END SAME FIRST RIGHT" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:655 +#, no-c-format +msgid "Availability: 1.4" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:673 +#, no-c-format +msgid "" +"Line 1 (green), Line 2 ball is start point, triangle are end points. Query " +"below." +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:677 +#, 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_relationship.xml:687 reference_relationship.xml:701 +#: reference_relationship.xml:715 +#, no-c-format +msgid "" +"Line 1 (green), Line 2 (blue) ball is start point, triangle are end points. " +"Query below." +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:691 +#, 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_relationship.xml:705 +#, 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_relationship.xml:719 +#, 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_relationship.xml:727 +#, 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_relationship.xml:740 +#, no-c-format +msgid "ST_Disjoint" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:742 +#, 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_relationship.xml:748 +#, no-c-format +msgid "" +"boolean ST_Disjoint " +"geometry A " +"geometry B " +msgstr "" + +#. Tag: para +#: reference_relationship.xml:763 +#, 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_relationship.xml:773 +#, no-c-format +msgid "This function call does not use indexes" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:780 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2 //s2.1.13.3 - a.Relate(b, 'FF*FF****')" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:782 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.26" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:787 +#, 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: refname +#: reference_relationship.xml:798 +#, no-c-format +msgid "ST_Equals" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:800 +#, no-c-format +msgid "" +"Returns true if the given geometries represent the same geometry. " +"Directionality is ignored." +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:806 +#, no-c-format +msgid "" +"boolean ST_Equals " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:817 +#, 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_relationship.xml:826 +#, no-c-format +msgid "" +"This function will return false if either geometry is invalid except in the " +"case where they are binary equal." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:833 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:834 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.24" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:835 +#, no-c-format +msgid "" +"Changed: 2.2.0 Returns true even for invalid geometries if they are binary " +"equal" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:841 +#, 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_relationship.xml:847 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:855 +#, no-c-format +msgid "ST_Intersects" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:857 +#, 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_relationship.xml:863 +#, no-c-format +msgid "" +" boolean ST_Intersects geometry geomA geometry geomB boolean " +"ST_Intersects geography geogA geography geogB " +msgstr "" + +#. Tag: para +#: reference_relationship.xml:890 +#, no-c-format +msgid "" +"If a geometry or geography shares any portion of space then they intersect. " +"For geography -- tolerance is 0.00001 meters (so any points that are close " +"are considered to intersect)" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:892 +#, no-c-format +msgid "" +"ST_Overlaps, ST_Touches, ST_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_relationship.xml:897 +#, no-c-format +msgid "Changed: 3.0.0 SFCGAL version removed." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:898 +#, no-c-format +msgid "Enhanced: 2.5.0 Supports GEOMETRYCOLLECTION." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:900 +#, no-c-format +msgid "Performed by the GEOS module (for geometry), geography is native" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:901 +#, no-c-format +msgid "Availability: 1.5 support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:908 +#, 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_relationship.xml:915 +#, 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_relationship.xml:918 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.27" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:923 +#, 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_relationship.xml:926 +#, no-c-format +msgid "Geography Examples" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:927 +#, no-c-format +msgid "" +"SELECT ST_Intersects(\n" +" 'SRID=4326;LINESTRING(-43.23456 72.4567,-43.23456 72.4568)'::" +"geography,\n" +" 'SRID=4326;POINT(-43.23456 72.4567772)'::geography\n" +" );\n" +"\n" +" st_intersects\n" +"---------------\n" +"t" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:931 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:937 +#, no-c-format +msgid "ST_OrderingEquals" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:939 +#, 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_relationship.xml:945 +#, no-c-format +msgid "" +"boolean ST_OrderingEquals " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:956 +#, 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_relationship.xml:961 +#, 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_relationship.xml:965 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.43" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:971 +#, 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_relationship.xml:975 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:981 +#, no-c-format +msgid "ST_Overlaps" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:983 +#, 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_relationship.xml:988 +#, no-c-format +msgid "" +"boolean ST_Overlaps " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:999 +#, 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_relationship.xml:1008 +#, 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_relationship.xml:1016 reference_relationship.xml:1178 +#: reference_relationship.xml:1305 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1017 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.32" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1033 +#, no-c-format +msgid "MULTIPOINT / MULTIPOINT" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1057 +#, 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_relationship.xml:1065 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1071 +#, no-c-format +msgid "ST_PointInsideCircle" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1073 +#, no-c-format +msgid "" +"Is the point geometry inside the circle defined by center_x, center_y, radius" +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:1078 +#, no-c-format +msgid "" +"boolean ST_PointInsideCircle " +"geometry a_point " +"float center_x " +"float center_y " +"float radius" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1091 +#, no-c-format +msgid "" +"The syntax for this functions is ST_PointInsideCircle(<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_relationship.xml:1095 +#, no-c-format +msgid "This only works for points as the name suggests" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1097 +#, no-c-format +msgid "Availability: 1.2" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1098 +#, no-c-format +msgid "" +"Changed: 2.2.0 In prior versions this used to be called " +"ST_Point_Inside_Circle" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1105 +#, no-c-format +msgid "" +"SELECT ST_PointInsideCircle(ST_Point(1,2), 0.5, 2, 3);\n" +" st_pointinsidecircle\n" +"------------------------\n" +" t" +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1118 +#, no-c-format +msgid "ST_Relate" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1120 +#, 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_relationship.xml:1128 +#, no-c-format +msgid "" +" boolean ST_Relate " +"geometry geomA " +"geometry geomB " +"text intersectionMatrixPattern text " +"ST_Relate geometry " +"geomA geometry " +"geomB " +"text ST_Relate " +"geometry geomA " +"geometry geomB " +"integer BoundaryNodeRule " +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1154 +#, 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 DE-9IM matrix pattern." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1159 +#, no-c-format +msgid "" +"This is especially useful for testing compound checks of intersection, " +"crosses, etc in one step." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1161 +#, 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_relationship.xml:1164 +#, 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_relationship.xml:1169 +#, no-c-format +msgid "" +"Version 2: Takes geomA and geomB and returns the " +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1171 +#, no-c-format +msgid "" +"Version 3: same as version 2, but allows to specify a boundary node rule (1:" +"OGC/MOD2, 2:Endpoint, 3:MultivalentEndpoint, 4:MonovalentEndpoint)" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1177 +#, no-c-format +msgid "not in OGC spec, but implied. see s2.1.13.2" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1179 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1181 +#, no-c-format +msgid "Enhanced: 2.0.0 - added support for specifying boundary node rule." +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1187 +#, 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_relationship.xml:1194 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1200 +#, no-c-format +msgid "ST_RelateMatch" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1202 +#, no-c-format +msgid "" +"Returns true if intersectionMattrixPattern1 implies " +"intersectionMatrixPattern2" +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:1207 +#, no-c-format +msgid "" +"boolean ST_RelateMatch " +"text intersectionMatrix text intersectionMatrixPattern" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1218 +#, no-c-format +msgid "" +"Takes intersectionMatrix and intersectionMatrixPattern and Returns true if " +"the intersectionMatrix satisfies the intersectionMatrixPattern. For more " +"information refer to ." +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1227 +#, 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_relationship.xml:1233 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1239 +#, no-c-format +msgid "ST_Touches" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1241 +#, no-c-format +msgid "" +"Returns TRUE if the geometries have at least one point in " +"common, but their interiors do not intersect." +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:1247 +#, no-c-format +msgid "" +"boolean ST_Touches " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1262 +#, no-c-format +msgid "" +"Returns TRUE if the only points in common between " +"g1 and g2 lie in the union of " +"the boundaries of g1 and g2. " +"The ST_Touches relation applies to all Area/Area, Line/" +"Line, Line/Area, Point/Area and Point/Line pairs of relationships, but " +"not to the Point/Point pair." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1269 +#, no-c-format +msgid "In mathematical terms, this predicate is expressed as:" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1279 +#, no-c-format +msgid "The allowable DE-9IM Intersection Matrices for the two geometries are:" +msgstr "" + +#. Tag: markup +#: reference_relationship.xml:1283 +#, no-c-format +msgid "FT*******" +msgstr "" + +#. Tag: markup +#: reference_relationship.xml:1287 +#, no-c-format +msgid "F**T*****" +msgstr "" + +#. Tag: markup +#: reference_relationship.xml:1291 +#, no-c-format +msgid "F***T****" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1300 +#, 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 _ST_Touches instead." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1306 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.28" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1312 +#, no-c-format +msgid "" +"The ST_Touches predicate returns TRUE in all the following illustrations." +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1382 +#, 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_relationship.xml:1388 +#, no-c-format +msgid "ST_Within" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1390 +#, no-c-format +msgid "Returns true if the geometry A is completely inside geometry B" +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:1395 +#, no-c-format +msgid "" +"boolean ST_Within " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1410 +#, 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_relationship.xml:1427 +#, 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_relationship.xml:1435 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3 - a.Relate(b, 'T*F**F***')" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1438 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.30" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1443 +#, 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_relationship.xml:1454 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: title +#: reference_relationship.xml:1462 +#, no-c-format +msgid "Distance Relationships" +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1466 +#, no-c-format +msgid "ST_3DDWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1468 +#, 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_relationship.xml:1472 +#, no-c-format +msgid "" +"boolean ST_3DDWithin " +"geometry g1 " +"geometry g2 " +"double precision distance_of_srid" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1490 +#, 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: para +#: reference_relationship.xml:1496 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM ?" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1504 +#, 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_relationship.xml:1510 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1516 +#, no-c-format +msgid "ST_3DDFullyWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1518 +#, no-c-format +msgid "" +"Returns true if all of the 3D geometries are within the specified distance " +"of one another." +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:1524 +#, no-c-format +msgid "" +"boolean ST_3DDFullyWithin " +"geometry g1 " +"geometry g2 " +"double precision distance" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1542 +#, 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: programlisting +#: reference_relationship.xml:1563 +#, 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_relationship.xml:1569 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1575 +#, no-c-format +msgid "ST_DFullyWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1577 +#, no-c-format +msgid "" +"Returns true if all of the geometries are within the specified distance of " +"one another" +msgstr "" + +#. Tag: funcprototype +#: reference_relationship.xml:1583 +#, no-c-format +msgid "" +"boolean ST_DFullyWithin " +"geometry g1 " +"geometry g2 " +"double precision distance" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1601 +#, 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: para +#: reference_relationship.xml:1613 +#, no-c-format +msgid "Availability: 1.5.0" +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1618 +#, 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_relationship.xml:1624 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_relationship.xml:1630 +#, no-c-format +msgid "ST_DWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_relationship.xml:1632 +#, 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_relationship.xml:1638 +#, no-c-format +msgid "" +" boolean ST_DWithin " +"geometry g1 " +"geometry g2 " +"double precision distance_of_srid boolean " +"ST_DWithin geography " +"gg1 geography " +"gg2 double precision distance_meters boolean use_spheroid " +"" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1671 +#, no-c-format +msgid "" +"Returns true if the geometries are within the specified distance of one " +"another." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1674 +#, no-c-format +msgid "" +"For geometry: 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_relationship.xml:1679 +#, no-c-format +msgid "" +"For geography units are in meters and measurement is defaulted " +"to use_spheroid=true, for faster check, " +"use_spheroid=false to measure along sphere." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1690 +#, 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_relationship.xml:1696 +#, no-c-format +msgid "Use ST_3DDWithin if you have 3D geometries." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1698 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1699 +#, no-c-format +msgid "Availability: 1.5.0 support for geography was introduced" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1700 +#, no-c-format +msgid "" +"Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1701 +#, no-c-format +msgid "Enhanced: 2.1.0 support for curved geometries was introduced." +msgstr "" + +#. Tag: programlisting +#: reference_relationship.xml:1706 +#, 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.geom, h.hospital_name\n" +" FROM schools s\n" +" LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.geom, " +"3000)\n" +" ORDER BY s.gid, ST_Distance(s.geom, h.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.geom, h.geom, 3000)\n" +" WHERE h.gid IS NULL;\n" +"\n" +"-- Find broadcasting towers that receiver with limited range can receive.\n" +"-- Data is geometry in Spherical Mercator (SRID=3857), ranges are " +"approximate.\n" +"\n" +"-- Create geometry index that will check proximity limit of user to tower\n" +"CREATE INDEX ON broadcasting_towers using gist (geom);\n" +"\n" +"-- Create geometry index that will check proximity limit of tower to user\n" +"CREATE INDEX ON broadcasting_towers using gist (ST_Expand(geom, " +"sending_range));\n" +"\n" +"-- Query towers that 4-kilometer receiver in Minsk Hackerspace can get\n" +"-- Note: two conditions, because shorter LEAST(b.sending_range, 4000) will " +"not use index.\n" +"SELECT b.tower_id, b.geom\n" +" FROM broadcasting_towers b\n" +" WHERE ST_DWithin(b.geom, 'SRID=3857;POINT(3072163.4 7159374.1)', 4000)\n" +" AND ST_DWithin(b.geom, 'SRID=3857;POINT(3072163.4 7159374.1)', b." +"sending_range);" +msgstr "" + +#. Tag: para +#: reference_relationship.xml:1712 +#, no-c-format +msgid ", , " +msgstr "" diff --git a/doc/po/templates/reference_sfcgal.xml.pot b/doc/po/templates/reference_sfcgal.xml.pot index f2c19aee5..a77f0cd68 100644 --- a/doc/po/templates/reference_sfcgal.xml.pot +++ b/doc/po/templates/reference_sfcgal.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:02+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:00+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -19,133 +19,118 @@ msgstr "" #, no-c-format msgid "" "SFCGAL is a C++ wrapper library around CGAL that provides advanced 2D and 3D " -"functions. For robustness, geometry coordinates have an exact rational " -"number representation." +"spatial functions. For robustness, geometry coordinates have an exact " +"rational number representation." msgstr "" #. Tag: para #: reference_sfcgal.xml:9 #, no-c-format msgid "" -"Installation instructions of the library can be found on SFCGAL home page " -"http://www.sfcgal.org. To load " -"the functions create extension postgis_sfcgal." -msgstr "" - -#. Tag: para -#: reference_sfcgal.xml:13 -#, no-c-format -msgid "" -"Some SFCGAL functions replace standard ones (ST_Intersects, ST_Intersection, " -"ST_Difference, ST_Union, ST_Area and ST_Distance), to switch between " -"standard functions and SFCGAL function use: SET postgis." -"backend = sfcgal; and" -msgstr "" - -#. Tag: programlisting -#: reference_sfcgal.xml:17 -#, no-c-format -msgid "SET postgis.backend = geos;" +"Installation instructions for the library can be found on the SFCGAL home " +"page (http://www.sfcgal.org). " +"To enable the functions use create extension postgis_sfcgal." msgstr "" #. Tag: title -#: reference_sfcgal.xml:22 +#: reference_sfcgal.xml:16 #, no-c-format msgid "SFCGAL Functions" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:25 +#: reference_sfcgal.xml:19 #, no-c-format msgid "postgis_sfcgal_version" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:27 +#: reference_sfcgal.xml:21 #, no-c-format msgid "Returns the version of SFCGAL in use" msgstr "" #. Tag: funcdef -#: reference_sfcgal.xml:33 +#: reference_sfcgal.xml:27 #, no-c-format msgid "text postgis_sfcgal_version" msgstr "" #. Tag: title -#: reference_sfcgal.xml:40 reference_sfcgal.xml:72 reference_sfcgal.xml:165 -#: reference_sfcgal.xml:224 reference_sfcgal.xml:288 reference_sfcgal.xml:317 -#: reference_sfcgal.xml:346 reference_sfcgal.xml:375 reference_sfcgal.xml:480 -#: reference_sfcgal.xml:556 reference_sfcgal.xml:630 reference_sfcgal.xml:705 -#: reference_sfcgal.xml:743 reference_sfcgal.xml:834 reference_sfcgal.xml:875 -#: reference_sfcgal.xml:903 +#: reference_sfcgal.xml:34 reference_sfcgal.xml:66 reference_sfcgal.xml:159 +#: reference_sfcgal.xml:218 reference_sfcgal.xml:282 reference_sfcgal.xml:311 +#: reference_sfcgal.xml:340 reference_sfcgal.xml:369 reference_sfcgal.xml:474 +#: reference_sfcgal.xml:541 reference_sfcgal.xml:617 reference_sfcgal.xml:691 +#: reference_sfcgal.xml:766 reference_sfcgal.xml:804 reference_sfcgal.xml:895 +#: reference_sfcgal.xml:936 reference_sfcgal.xml:964 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_sfcgal.xml:42 reference_sfcgal.xml:74 reference_sfcgal.xml:167 -#: reference_sfcgal.xml:321 reference_sfcgal.xml:348 reference_sfcgal.xml:384 -#: reference_sfcgal.xml:482 reference_sfcgal.xml:707 reference_sfcgal.xml:745 +#: reference_sfcgal.xml:36 reference_sfcgal.xml:68 reference_sfcgal.xml:161 +#: reference_sfcgal.xml:315 reference_sfcgal.xml:342 reference_sfcgal.xml:378 +#: reference_sfcgal.xml:543 reference_sfcgal.xml:768 reference_sfcgal.xml:806 #, no-c-format msgid "Availability: 2.1.0" msgstr "" #. Tag: para -#: reference_sfcgal.xml:43 reference_sfcgal.xml:75 reference_sfcgal.xml:168 -#: reference_sfcgal.xml:234 reference_sfcgal.xml:291 reference_sfcgal.xml:322 -#: reference_sfcgal.xml:349 reference_sfcgal.xml:385 reference_sfcgal.xml:483 -#: reference_sfcgal.xml:559 reference_sfcgal.xml:634 reference_sfcgal.xml:708 -#: reference_sfcgal.xml:746 reference_sfcgal.xml:837 reference_sfcgal.xml:878 -#: reference_sfcgal.xml:906 +#: reference_sfcgal.xml:37 reference_sfcgal.xml:69 reference_sfcgal.xml:162 +#: reference_sfcgal.xml:228 reference_sfcgal.xml:285 reference_sfcgal.xml:316 +#: reference_sfcgal.xml:343 reference_sfcgal.xml:379 reference_sfcgal.xml:482 +#: reference_sfcgal.xml:544 reference_sfcgal.xml:620 reference_sfcgal.xml:695 +#: reference_sfcgal.xml:769 reference_sfcgal.xml:807 reference_sfcgal.xml:898 +#: reference_sfcgal.xml:939 reference_sfcgal.xml:967 #, no-c-format msgid "&sfcgal_required;" msgstr "" #. Tag: para -#: reference_sfcgal.xml:44 reference_sfcgal.xml:76 reference_sfcgal.xml:169 -#: reference_sfcgal.xml:235 reference_sfcgal.xml:292 reference_sfcgal.xml:323 -#: reference_sfcgal.xml:350 reference_sfcgal.xml:484 reference_sfcgal.xml:560 -#: reference_sfcgal.xml:635 reference_sfcgal.xml:709 reference_sfcgal.xml:747 -#: reference_sfcgal.xml:838 reference_sfcgal.xml:879 reference_sfcgal.xml:907 +#: reference_sfcgal.xml:38 reference_sfcgal.xml:70 reference_sfcgal.xml:163 +#: reference_sfcgal.xml:229 reference_sfcgal.xml:286 reference_sfcgal.xml:317 +#: reference_sfcgal.xml:344 reference_sfcgal.xml:484 reference_sfcgal.xml:545 +#: reference_sfcgal.xml:621 reference_sfcgal.xml:696 reference_sfcgal.xml:770 +#: reference_sfcgal.xml:808 reference_sfcgal.xml:899 reference_sfcgal.xml:940 +#: reference_sfcgal.xml:968 #, no-c-format msgid "&Z_support;" msgstr "" #. Tag: para -#: reference_sfcgal.xml:45 reference_sfcgal.xml:77 reference_sfcgal.xml:170 -#: reference_sfcgal.xml:236 reference_sfcgal.xml:293 reference_sfcgal.xml:351 -#: reference_sfcgal.xml:485 reference_sfcgal.xml:561 reference_sfcgal.xml:636 -#: reference_sfcgal.xml:710 reference_sfcgal.xml:748 reference_sfcgal.xml:839 -#: reference_sfcgal.xml:880 reference_sfcgal.xml:908 +#: reference_sfcgal.xml:39 reference_sfcgal.xml:71 reference_sfcgal.xml:164 +#: reference_sfcgal.xml:230 reference_sfcgal.xml:287 reference_sfcgal.xml:345 +#: reference_sfcgal.xml:546 reference_sfcgal.xml:622 reference_sfcgal.xml:697 +#: reference_sfcgal.xml:771 reference_sfcgal.xml:809 reference_sfcgal.xml:900 +#: reference_sfcgal.xml:941 reference_sfcgal.xml:969 #, no-c-format msgid "&P_support;" msgstr "" #. Tag: para -#: reference_sfcgal.xml:46 reference_sfcgal.xml:78 reference_sfcgal.xml:171 -#: reference_sfcgal.xml:237 reference_sfcgal.xml:294 reference_sfcgal.xml:352 -#: reference_sfcgal.xml:486 reference_sfcgal.xml:562 reference_sfcgal.xml:637 -#: reference_sfcgal.xml:711 reference_sfcgal.xml:749 reference_sfcgal.xml:840 -#: reference_sfcgal.xml:881 reference_sfcgal.xml:909 +#: reference_sfcgal.xml:40 reference_sfcgal.xml:72 reference_sfcgal.xml:165 +#: reference_sfcgal.xml:231 reference_sfcgal.xml:288 reference_sfcgal.xml:346 +#: reference_sfcgal.xml:547 reference_sfcgal.xml:623 reference_sfcgal.xml:698 +#: reference_sfcgal.xml:772 reference_sfcgal.xml:810 reference_sfcgal.xml:901 +#: reference_sfcgal.xml:942 reference_sfcgal.xml:970 #, no-c-format msgid "&T_support;" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:54 +#: reference_sfcgal.xml:48 #, no-c-format msgid "ST_Extrude" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:56 +#: reference_sfcgal.xml:50 #, no-c-format msgid "Extrude a surface to a related volume" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:61 +#: reference_sfcgal.xml:55 #, no-c-format msgid "" "geometry ST_Extrude " @@ -156,16 +141,17 @@ msgid "" msgstr "" #. Tag: title -#: reference_sfcgal.xml:81 reference_sfcgal.xml:174 reference_sfcgal.xml:240 -#: reference_sfcgal.xml:388 reference_sfcgal.xml:490 reference_sfcgal.xml:566 -#: reference_sfcgal.xml:641 reference_sfcgal.xml:714 reference_sfcgal.xml:752 +#: reference_sfcgal.xml:75 reference_sfcgal.xml:168 reference_sfcgal.xml:234 +#: reference_sfcgal.xml:382 reference_sfcgal.xml:487 reference_sfcgal.xml:551 +#: reference_sfcgal.xml:627 reference_sfcgal.xml:702 reference_sfcgal.xml:775 +#: reference_sfcgal.xml:813 #, no-c-format msgid "Examples" msgstr "" #. Tag: para -#: reference_sfcgal.xml:82 reference_sfcgal.xml:491 reference_sfcgal.xml:567 -#: reference_sfcgal.xml:642 +#: reference_sfcgal.xml:76 reference_sfcgal.xml:552 reference_sfcgal.xml:628 +#: reference_sfcgal.xml:703 #, no-c-format msgid "" "3D images were generated using PostGIS and " @@ -174,7 +160,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:89 +#: reference_sfcgal.xml:83 #, no-c-format msgid "" "SELECT ST_Buffer(ST_GeomFromText('POINT(100 90)'),\n" @@ -182,13 +168,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:95 +#: reference_sfcgal.xml:89 #, no-c-format msgid "Original octagon formed from buffering point" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:100 +#: reference_sfcgal.xml:94 #, no-c-format msgid "" "ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),\n" @@ -196,25 +182,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:106 +#: reference_sfcgal.xml:100 #, no-c-format msgid "Hexagon extruded 30 units along Z produces a PolyhedralSurfaceZ" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:114 +#: reference_sfcgal.xml:108 #, no-c-format msgid "SELECT ST_GeomFromText('LINESTRING(50 50, 100 90, 95 150)')" msgstr "" #. Tag: para -#: reference_sfcgal.xml:120 +#: reference_sfcgal.xml:114 #, no-c-format msgid "Original linestring" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:125 +#: reference_sfcgal.xml:119 #, no-c-format msgid "" "SELECT ST_Extrude(\n" @@ -222,32 +208,33 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:131 +#: reference_sfcgal.xml:125 #, no-c-format msgid "LineString Extruded along Z produces a PolyhedralSurfaceZ" msgstr "" #. Tag: title -#: reference_sfcgal.xml:141 reference_sfcgal.xml:263 reference_sfcgal.xml:602 -#: reference_sfcgal.xml:677 reference_sfcgal.xml:720 reference_sfcgal.xml:851 +#: reference_sfcgal.xml:135 reference_sfcgal.xml:257 reference_sfcgal.xml:518 +#: reference_sfcgal.xml:663 reference_sfcgal.xml:738 reference_sfcgal.xml:781 +#: reference_sfcgal.xml:912 #, no-c-format msgid "See Also" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:150 +#: reference_sfcgal.xml:144 #, no-c-format msgid "ST_StraightSkeleton" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:152 +#: reference_sfcgal.xml:146 #, no-c-format msgid "Compute a straight skeleton from a geometry" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:157 +#: reference_sfcgal.xml:151 #, no-c-format msgid "" "geometry ST_StraightSkeleton " @@ -255,7 +242,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:175 +#: reference_sfcgal.xml:169 #, no-c-format msgid "" "SELECT ST_StraightSkeleton(ST_GeomFromText('POLYGON (( 190 190, 10 190, 10 " @@ -263,31 +250,31 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:186 reference_sfcgal.xml:791 +#: reference_sfcgal.xml:180 reference_sfcgal.xml:852 #, no-c-format msgid "Original polygon" msgstr "" #. Tag: para -#: reference_sfcgal.xml:195 +#: reference_sfcgal.xml:189 #, no-c-format msgid "Straight Skeleton of polygon" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:209 +#: reference_sfcgal.xml:203 #, no-c-format msgid "ST_ApproximateMedialAxis" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:211 +#: reference_sfcgal.xml:205 #, no-c-format msgid "Compute the approximate medial axis of an areal geometry." msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:216 +#: reference_sfcgal.xml:210 #, no-c-format msgid "" "geometry ST_ApproximateMedialAxis " @@ -295,7 +282,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:226 +#: reference_sfcgal.xml:220 #, no-c-format msgid "" "Return an approximate medial axis for the areal input based on its straight " @@ -305,14 +292,14 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:233 reference_sfcgal.xml:558 reference_sfcgal.xml:633 -#: reference_sfcgal.xml:836 reference_sfcgal.xml:877 reference_sfcgal.xml:905 +#: reference_sfcgal.xml:227 reference_sfcgal.xml:619 reference_sfcgal.xml:694 +#: reference_sfcgal.xml:897 reference_sfcgal.xml:938 reference_sfcgal.xml:966 #, no-c-format msgid "Availability: 2.2.0" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:241 +#: reference_sfcgal.xml:235 #, no-c-format msgid "" "SELECT ST_ApproximateMedialAxis(ST_GeomFromText('POLYGON (( 190 190, 10 190, " @@ -320,25 +307,25 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:252 +#: reference_sfcgal.xml:246 #, no-c-format msgid "A polygon and its approximate medial axis" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:273 +#: reference_sfcgal.xml:267 #, no-c-format msgid "ST_IsPlanar" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:275 +#: reference_sfcgal.xml:269 #, no-c-format msgid "Check if a surface is or not planar" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:280 +#: reference_sfcgal.xml:274 #, no-c-format msgid "" "boolean ST_IsPlanar " @@ -346,7 +333,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:290 +#: reference_sfcgal.xml:284 #, no-c-format msgid "" "Availability: 2.2.0: This was documented in 2.1.0 but got accidentally left " @@ -354,19 +341,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:302 +#: reference_sfcgal.xml:296 #, no-c-format msgid "ST_Orientation" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:304 +#: reference_sfcgal.xml:298 #, no-c-format msgid "Determine surface orientation" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:309 +#: reference_sfcgal.xml:303 #, no-c-format msgid "" "integer ST_Orientation " @@ -374,7 +361,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:319 +#: reference_sfcgal.xml:313 #, no-c-format msgid "" "The function only applies to polygons. It returns -1 if the polygon is " @@ -382,19 +369,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:331 +#: reference_sfcgal.xml:325 #, no-c-format msgid "ST_ForceLHR" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:333 +#: reference_sfcgal.xml:327 #, no-c-format msgid "Force LHR orientation" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:338 +#: reference_sfcgal.xml:332 #, no-c-format msgid "" "geometry ST_ForceLHR " @@ -402,19 +389,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:359 +#: reference_sfcgal.xml:353 #, no-c-format msgid "ST_MinkowskiSum" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:361 +#: reference_sfcgal.xml:355 #, no-c-format msgid "Performs Minkowski sum" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:366 +#: reference_sfcgal.xml:360 #, no-c-format msgid "" "geometry ST_MinkowskiSum " @@ -423,7 +410,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:377 +#: reference_sfcgal.xml:371 #, no-c-format msgid "" "This function performs a 2D minkowski sum of a point, line or polygon with a " @@ -431,7 +418,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:378 +#: reference_sfcgal.xml:372 #, no-c-format msgid "" "A minkowski sum of two geometries A and B is the set of all points that are " @@ -441,7 +428,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:379 +#: reference_sfcgal.xml:373 #, no-c-format msgid "" "The first parameter can be any 2D geometry (point, linestring, polygon). If " @@ -451,7 +438,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:381 +#: reference_sfcgal.xml:375 #, no-c-format msgid "" "Implementation utilizes geometry ST_ConstrainedDelaunayTriangles geometry g1" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:476 +#, no-c-format +msgid "" +"Return a Constrained Delaunay triangulation around the vertices of the input geometry. Output is a TIN." +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:483 +#, no-c-format +msgid "Availability: 3.0.0" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:497 +#, no-c-format +msgid "ST_ConstrainedDelaunayTriangles of 2 polygons" +msgstr "" + +#. Tag: programlisting +#: reference_sfcgal.xml:500 +#, no-c-format +msgid "" +"select ST_ConstrainedDelaunayTriangles(\n" +" ST_Union(\n" +" 'POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'::" +"geometry,\n" +" ST_Buffer('POINT(110 170)'::geometry, 20)\n" +" )\n" +" );" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:507 +#, no-c-format +msgid "of 2 polygons. Triangle edges cross polygon boundaries." +msgstr "" + +#. Tag: programlisting +#: reference_sfcgal.xml:510 +#, no-c-format +msgid "" +"select ST_DelaunayTriangles(\n" +" ST_Union(\n" +" 'POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'::" +"geometry,\n" +" ST_Buffer('POINT(110 170)'::geometry, 20)\n" +" )\n" +" );" +msgstr "" + +#. Tag: para +#: reference_sfcgal.xml:519 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_sfcgal.xml:525 +#, no-c-format +msgid "ST_3DIntersection" +msgstr "" + +#. Tag: refpurpose +#: reference_sfcgal.xml:527 +#, no-c-format msgid "Perform 3D intersection" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:471 +#: reference_sfcgal.xml:532 #, no-c-format msgid "" "geometry ST_3DIntersection " @@ -560,13 +628,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:481 +#: reference_sfcgal.xml:542 #, no-c-format msgid "Return a geometry that is the shared portion between geom1 and geom2." msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:497 reference_sfcgal.xml:573 reference_sfcgal.xml:648 +#: reference_sfcgal.xml:558 reference_sfcgal.xml:634 reference_sfcgal.xml:709 #, no-c-format msgid "" "SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),\n" @@ -576,13 +644,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:503 +#: reference_sfcgal.xml:564 #, no-c-format msgid "Original 3D geometries overlaid. geom2 is shown semi-transparent" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:508 +#: reference_sfcgal.xml:569 #, no-c-format msgid "" "SELECT ST_3DIntersection(geom1,geom2)\n" @@ -593,19 +661,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:514 +#: reference_sfcgal.xml:575 #, no-c-format msgid "Intersection of geom1 and geom2" msgstr "" #. Tag: para -#: reference_sfcgal.xml:523 +#: reference_sfcgal.xml:584 #, no-c-format msgid "3D linestrings and polygons" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:524 +#: reference_sfcgal.xml:585 #, no-c-format msgid "" "SELECT ST_AsText(ST_3DIntersection(linestring, polygon)) As wkt\n" @@ -620,13 +688,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:526 +#: reference_sfcgal.xml:587 #, no-c-format msgid "Cube (closed Polyhedral Surface) and Polygon Z" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:527 +#: reference_sfcgal.xml:588 #, no-c-format msgid "" "SELECT ST_AsText(ST_3DIntersection(\n" @@ -641,14 +709,14 @@ msgid "" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:528 +#: reference_sfcgal.xml:589 #, no-c-format msgid "" "TIN Z (((0 0 0,0 0 0.5,0 0.5 0.5,0 0 0)),((0 0.5 0,0 0 0,0 0.5 0.5,0 0.5 0)))" msgstr "" #. Tag: para -#: reference_sfcgal.xml:530 +#: reference_sfcgal.xml:591 #, no-c-format msgid "" "Intersection of 2 solids that result in volumetric intersection is also a " @@ -656,7 +724,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:531 +#: reference_sfcgal.xml:592 #, no-c-format msgid "" "SELECT ST_AsText(ST_3DIntersection( ST_Extrude(ST_Buffer('POINT(10 20)'::" @@ -665,7 +733,7 @@ msgid "" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:532 +#: reference_sfcgal.xml:593 #, no-c-format msgid "" "POLYHEDRALSURFACE Z (((13.3333333333333 13.3333333333333 10,20 20 0,20 20 " @@ -698,19 +766,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:540 +#: reference_sfcgal.xml:601 #, no-c-format msgid "ST_3DDifference" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:542 +#: reference_sfcgal.xml:603 #, no-c-format msgid "Perform 3D difference" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:547 +#: reference_sfcgal.xml:608 #, no-c-format msgid "" "geometry ST_3DDifference " @@ -719,20 +787,20 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:557 +#: reference_sfcgal.xml:618 #, no-c-format msgid "Returns that part of geom1 that is not part of geom2." msgstr "" #. Tag: para -#: reference_sfcgal.xml:579 +#: reference_sfcgal.xml:640 #, no-c-format msgid "" "Original 3D geometries overlaid. geom2 is the part that will be removed." msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:584 +#: reference_sfcgal.xml:645 #, no-c-format msgid "" "SELECT ST_3DDifference(geom1,geom2)\n" @@ -743,13 +811,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:590 +#: reference_sfcgal.xml:651 #, no-c-format msgid "What's left after removing geom2" msgstr "" #. Tag: para -#: reference_sfcgal.xml:604 +#: reference_sfcgal.xml:665 #, no-c-format msgid "" ", , geometry ST_3DUnion " @@ -778,13 +846,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:654 +#: reference_sfcgal.xml:715 #, no-c-format msgid "Original 3D geometries overlaid. geom2 is the one with transparency." msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:659 +#: reference_sfcgal.xml:720 #, no-c-format msgid "" "SELECT ST_3DUnion(geom1,geom2)\n" @@ -795,13 +863,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:665 +#: reference_sfcgal.xml:726 #, no-c-format msgid "Union of geom1 and geom2" msgstr "" #. Tag: para -#: reference_sfcgal.xml:679 +#: reference_sfcgal.xml:740 #, no-c-format msgid "" ", , floatST_3DArea " @@ -829,7 +897,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:715 +#: reference_sfcgal.xml:776 #, no-c-format msgid "" "Note: By default a PolyhedralSurface built from WKT is a surface geometry, " @@ -837,7 +905,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:716 +#: reference_sfcgal.xml:777 #, no-c-format msgid "" "SELECT ST_3DArea(geom) As cube_surface_area,\n" @@ -855,7 +923,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:722 +#: reference_sfcgal.xml:783 #, no-c-format msgid "" ", , , geometry ST_Tesselate " @@ -885,7 +953,7 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:744 +#: reference_sfcgal.xml:805 #, no-c-format msgid "" "Takes as input a surface such a MULTI(POLYGON) or POLYHEDRALSURFACE and " @@ -893,7 +961,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:758 +#: reference_sfcgal.xml:819 #, no-c-format msgid "" "SELECT ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 " @@ -906,13 +974,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:764 +#: reference_sfcgal.xml:825 #, no-c-format msgid "Original Cube" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:769 +#: reference_sfcgal.xml:830 #, no-c-format msgid "" "SELECT ST_Tesselate(ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 " @@ -925,13 +993,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:770 +#: reference_sfcgal.xml:831 #, no-c-format msgid "ST_AsText output:" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:771 +#: reference_sfcgal.xml:832 #, no-c-format msgid "" "TIN Z (((0 0 0,0 0 1,0 1 1,0 0 0)),((0 1 0,0 0 0,0 1 1,0 1 0)),\n" @@ -944,13 +1012,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:777 +#: reference_sfcgal.xml:838 #, no-c-format msgid "Tesselated Cube with triangles colored" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:785 +#: reference_sfcgal.xml:846 #, no-c-format msgid "" "SELECT 'POLYGON (( 10 190, 10 70, 80 70, 80 130, 50 160, 120 160, 120 190, " @@ -958,7 +1026,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:796 +#: reference_sfcgal.xml:857 #, no-c-format msgid "" "SELECT\n" @@ -967,13 +1035,13 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:798 +#: reference_sfcgal.xml:859 #, no-c-format msgid "ST_AsText output" msgstr "" #. Tag: screen -#: reference_sfcgal.xml:799 +#: reference_sfcgal.xml:860 #, no-c-format msgid "" "TIN(((80 130,50 160,80 70,80 130)),((50 160,10 190,10 70,50 160)),\n" @@ -982,19 +1050,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:805 +#: reference_sfcgal.xml:866 #, no-c-format msgid "Tesselated Polygon" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:819 +#: reference_sfcgal.xml:880 #, no-c-format msgid "ST_Volume" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:821 +#: reference_sfcgal.xml:882 #, no-c-format msgid "" "Computes the volume of a 3D solid. If applied to surface (even closed) " @@ -1002,7 +1070,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:826 +#: reference_sfcgal.xml:887 #, no-c-format msgid "" "float ST_Volume " @@ -1010,13 +1078,13 @@ msgid "" msgstr "" #. Tag: title -#: reference_sfcgal.xml:844 +#: reference_sfcgal.xml:905 #, no-c-format msgid "Example" msgstr "" #. Tag: para -#: reference_sfcgal.xml:845 +#: reference_sfcgal.xml:906 #, no-c-format msgid "" "When closed surfaces are created with WKT, they are treated as areal rather " @@ -1025,7 +1093,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_sfcgal.xml:847 +#: reference_sfcgal.xml:908 #, no-c-format msgid "" "SELECT ST_Volume(geom) As cube_surface_vol,\n" @@ -1043,19 +1111,19 @@ msgid "" msgstr "" #. Tag: para -#: reference_sfcgal.xml:853 +#: reference_sfcgal.xml:914 #, no-c-format msgid ", , " msgstr "" #. Tag: refname -#: reference_sfcgal.xml:860 +#: reference_sfcgal.xml:921 #, no-c-format msgid "ST_MakeSolid" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:862 +#: reference_sfcgal.xml:923 #, no-c-format msgid "" "Cast the geometry into a solid. No check is performed. To obtain a valid " @@ -1064,7 +1132,7 @@ msgid "" msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:867 +#: reference_sfcgal.xml:928 #, no-c-format msgid "" "geometryST_MakeSolid " @@ -1072,19 +1140,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_sfcgal.xml:888 +#: reference_sfcgal.xml:949 #, no-c-format msgid "ST_IsSolid" msgstr "" #. Tag: refpurpose -#: reference_sfcgal.xml:890 +#: reference_sfcgal.xml:951 #, no-c-format msgid "Test if the geometry is a solid. No validity check is performed." msgstr "" #. Tag: funcprototype -#: reference_sfcgal.xml:895 +#: reference_sfcgal.xml:956 #, no-c-format msgid "" "booleanST_IsSolid " diff --git a/doc/po/templates/reference_srs.xml.pot b/doc/po/templates/reference_srs.xml.pot new file mode 100644 index 000000000..162ca57da --- /dev/null +++ b/doc/po/templates/reference_srs.xml.pot @@ -0,0 +1,493 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_srs.xml:5 +#, no-c-format +msgid "These functions work with the Spatial Reference System of geometries." +msgstr "" + +#. Tag: title +#: reference_srs.xml:9 +#, no-c-format +msgid "Spatial Reference System Functions" +msgstr "" + +#. Tag: refname +#: reference_srs.xml:13 +#, no-c-format +msgid "ST_SetSRID" +msgstr "" + +#. Tag: refpurpose +#: reference_srs.xml:15 +#, no-c-format +msgid "Set the SRID on a geometry to a particular integer value." +msgstr "" + +#. Tag: funcprototype +#: reference_srs.xml:21 +#, no-c-format +msgid "" +"geometry ST_SetSRID " +"geometry geom " +"integer srid" +msgstr "" + +#. Tag: title +#: reference_srs.xml:34 reference_srs.xml:81 reference_srs.xml:145 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_srs.xml:36 +#, 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_srs.xml:40 +#, 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 if you want to " +"transform the geometry into a new projection." +msgstr "" + +#. Tag: para +#: reference_srs.xml:45 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_srs.xml:46 reference_srs.xml:89 reference_srs.xml:179 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: title +#: reference_srs.xml:50 reference_srs.xml:94 reference_srs.xml:185 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: para +#: reference_srs.xml:51 +#, no-c-format +msgid "-- Mark a point as WGS 84 long lat --" +msgstr "" + +#. Tag: programlisting +#: reference_srs.xml:52 +#, 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 "" + +#. Tag: para +#: reference_srs.xml:53 +#, no-c-format +msgid "" +"-- Mark a point as WGS 84 long lat and then transform to web mercator " +"(Spherical Mercator) --" +msgstr "" + +#. Tag: programlisting +#: reference_srs.xml:54 +#, 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: title +#: reference_srs.xml:58 reference_srs.xml:99 reference_srs.xml:219 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_srs.xml:60 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_srs.xml:67 +#, no-c-format +msgid "ST_SRID" +msgstr "" + +#. Tag: refpurpose +#: reference_srs.xml:68 +#, no-c-format +msgid "" +"Returns the spatial reference identifier for the ST_Geometry as defined in " +"spatial_ref_sys table." +msgstr "" + +#. Tag: funcprototype +#: reference_srs.xml:73 +#, no-c-format +msgid "" +"integer ST_SRID " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_srs.xml:83 +#, no-c-format +msgid "" +"Returns the spatial reference identifier for the ST_Geometry as defined in " +"spatial_ref_sys table. " +msgstr "" + +#. Tag: para +#: reference_srs.xml:84 +#, 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_srs.xml:87 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.1" +msgstr "" + +#. Tag: para +#: reference_srs.xml:88 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.5" +msgstr "" + +#. Tag: programlisting +#: reference_srs.xml:96 +#, no-c-format +msgid "" +"SELECT ST_SRID(ST_GeomFromText('POINT(-71.1043 42.315)',4326));\n" +" --result\n" +" 4326" +msgstr "" + +#. Tag: para +#: reference_srs.xml:101 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_srs.xml:107 +#, no-c-format +msgid "ST_Transform" +msgstr "" + +#. Tag: refpurpose +#: reference_srs.xml:109 +#, no-c-format +msgid "" +"Return a new geometry with its coordinates transformed to a different " +"spatial reference system." +msgstr "" + +#. Tag: funcsynopsis +#: reference_srs.xml:114 +#, no-c-format +msgid "" +" geometry ST_Transform geometry g1 integer srid geometry " +"ST_Transform geometry " +"geom text " +"to_proj " +"geometry ST_Transform " +"geometry geom " +"text from_proj " +"text to_proj geometry ST_Transform geometry geom text from_proj integer to_srid " +msgstr "" + +#. Tag: para +#: reference_srs.xml:147 +#, no-c-format +msgid "" +"Returns a new geometry with its coordinates transformed to a different " +"spatial reference system. The destination spatial reference " +"to_srid may be identified by a valid SRID integer " +"parameter (i.e. it must exist in the spatial_ref_sys " +"table). Alternatively, a spatial reference defined as a PROJ.4 string can be " +"used for to_proj and/or from_proj, " +"however these methods are not optimized. If the destination spatial " +"reference system is expressed with a PROJ.4 string instead of an SRID, the " +"SRID of the output geometry will be set to zero. With the exception of " +"functions with from_proj, input geometries must have a " +"defined SRID." +msgstr "" + +#. Tag: para +#: reference_srs.xml:161 +#, no-c-format +msgid "" +"ST_Transform is often confused with . " +"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_srs.xml:166 +#, no-c-format +msgid "" +"Requires PostGIS be compiled with Proj support. Use to confirm you have proj support compiled in." +msgstr "" + +#. Tag: para +#: reference_srs.xml:170 +#, 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_srs.xml:174 +#, 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_srs.xml:176 +#, no-c-format +msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." +msgstr "" + +#. Tag: para +#: reference_srs.xml:177 +#, no-c-format +msgid "Enhanced: 2.3.0 support for direct PROJ.4 text was introduced." +msgstr "" + +#. Tag: para +#: reference_srs.xml:178 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.6" +msgstr "" + +#. Tag: para +#: reference_srs.xml:180 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_srs.xml:186 +#, no-c-format +msgid "Change Massachusetts state plane US feet geometry to WGS 84 long lat" +msgstr "" + +#. Tag: programlisting +#: reference_srs.xml:187 +#, 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_srs.xml:188 +#, 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_srs.xml:190 +#, 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 "" + +#. Tag: para +#: reference_srs.xml:192 +#, no-c-format +msgid "" +"Examples of using PROJ.4 text to transform with custom spatial references." +msgstr "" + +#. Tag: programlisting +#: reference_srs.xml:193 +#, no-c-format +msgid "" +"-- Find intersection of two polygons near the North pole, using a custom " +"Gnomic projection\n" +"-- See http://boundlessgeo.com/2012/02/flattening-the-peel/\n" +" WITH data AS (\n" +" SELECT\n" +" ST_GeomFromText('POLYGON((170 50,170 72,-130 72,-130 50,170 50))', " +"4326) AS p1,\n" +" ST_GeomFromText('POLYGON((-170 68,-170 90,-141 90,-141 68,-170 68))', " +"4326) AS p2,\n" +" '+proj=gnom +ellps=WGS84 +lat_0=70 +lon_0=-160 +no_defs'::text AS gnom\n" +" )\n" +" SELECT ST_AsText(\n" +" ST_Transform(\n" +" ST_Intersection(ST_Transform(p1, gnom), ST_Transform(p2, gnom)),\n" +" gnom, 4326))\n" +" FROM data;\n" +" st_astext\n" +" --------------------------------------------------------------------------------\n" +" POLYGON((-170 74.053793645338,-141 73.4268621378904,-141 68,-170 68,-170 " +"74.053793645338))" +msgstr "" + +#. Tag: title +#: reference_srs.xml:197 +#, no-c-format +msgid "Configuring transformation behaviour" +msgstr "" + +#. Tag: para +#: reference_srs.xml:198 +#, 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 either by testing " +"different to_proj values of PROJ.4 text, or altering the " +"proj4text value within the spatial_ref_sys table." +msgstr "" + +#. Tag: para +#: reference_srs.xml:208 +#, no-c-format +msgid "" +"For example, the proj4text parameter +datum=NAD87 is a shorthand form for " +"the following +nadgrids parameter:" +msgstr "" + +#. Tag: programlisting +#: reference_srs.xml:209 +#, no-c-format +msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat" +msgstr "" + +#. Tag: para +#: reference_srs.xml:210 +#, 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_srs.xml:211 +#, 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_srs.xml:212 +#, no-c-format +msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null" +msgstr "" + +#. Tag: para +#: reference_srs.xml:213 +#, 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_srs.xml:214 +#, 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 "" + +#. Tag: para +#: reference_srs.xml:221 +#, no-c-format +msgid "" +", , , " +msgstr "" diff --git a/doc/po/templates/reference_trajectory.xml.pot b/doc/po/templates/reference_trajectory.xml.pot new file mode 100644 index 000000000..8c7f5b2f6 --- /dev/null +++ b/doc/po/templates/reference_trajectory.xml.pot @@ -0,0 +1,341 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_trajectory.xml:5 +#, no-c-format +msgid "" +"These functions support working with trajectories. A trajectory is a linear " +"geometry with a measure (M value) on each coordinate. The measure values " +"must increase along the line. Spatio-temporal data can be modelled by using " +"relative times (such as the epoch) as the measure values." +msgstr "" + +#. Tag: title +#: reference_trajectory.xml:13 +#, no-c-format +msgid "Trajectory Functions" +msgstr "" + +#. Tag: refname +#: reference_trajectory.xml:18 +#, no-c-format +msgid "ST_IsValidTrajectory" +msgstr "" + +#. Tag: refpurpose +#: reference_trajectory.xml:19 +#, no-c-format +msgid "Returns true if the geometry is a valid trajectory." +msgstr "" + +#. Tag: funcprototype +#: reference_trajectory.xml:26 +#, no-c-format +msgid "" +"boolean ST_IsValidTrajectory " +"geometry line" +msgstr "" + +#. Tag: title +#: reference_trajectory.xml:34 reference_trajectory.xml:83 +#: reference_trajectory.xml:140 reference_trajectory.xml:194 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:35 +#, no-c-format +msgid "" +"Tests if a geometry encodes a valid trajectory. A valid trajectory is " +"represented as a LINESTRING with measures (M values). The " +"measure values must increase from each vertex to the next." +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:41 +#, no-c-format +msgid "" +"Valid trajectories are expected as input to spatio-temporal functions like " +"" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:45 reference_trajectory.xml:100 +#: reference_trajectory.xml:151 reference_trajectory.xml:206 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:46 reference_trajectory.xml:101 +#: reference_trajectory.xml:152 reference_trajectory.xml:207 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: title +#: reference_trajectory.xml:51 reference_trajectory.xml:105 +#: reference_trajectory.xml:157 reference_trajectory.xml:212 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_trajectory.xml:52 +#, no-c-format +msgid "" +"-- A valid trajectory\n" +"SELECT ST_IsValidTrajectory(ST_MakeLine(\n" +" ST_MakePointM(0,0,1),\n" +" ST_MakePointM(0,1,2))\n" +");\n" +" t\n" +"\n" +"-- An invalid trajectory\n" +"SELECT ST_IsValidTrajectory(ST_MakeLine(ST_MakePointM(0,0,1), " +"ST_MakePointM(0,1,0)));\n" +"NOTICE: Measure of vertex 1 (0) not bigger than measure of vertex 0 (1)\n" +" st_isvalidtrajectory\n" +"----------------------\n" +" f" +msgstr "" + +#. Tag: title +#: reference_trajectory.xml:56 reference_trajectory.xml:110 +#: reference_trajectory.xml:162 reference_trajectory.xml:218 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: reference_trajectory.xml:66 +#, no-c-format +msgid "ST_ClosestPointOfApproach" +msgstr "" + +#. Tag: refpurpose +#: reference_trajectory.xml:67 +#, no-c-format +msgid "" +"Returns the measure at which points interpolated along two trajectories are " +"closest." +msgstr "" + +#. Tag: funcprototype +#: reference_trajectory.xml:74 +#, no-c-format +msgid "" +"float8 ST_ClosestPointOfApproach " +"geometry track1 " +"geometry track2" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:85 +#, no-c-format +msgid "" +"Returns the smallest measure at which points interpolated along the given " +"trajectories are at the smallest distance." +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:89 reference_trajectory.xml:145 +#, no-c-format +msgid "" +"Inputs must be valid trajectories as checked by . Null is returned if the trajectories do not " +"overlap in their M ranges." +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:95 +#, no-c-format +msgid "" +"See for getting the actual points at the " +"given measure." +msgstr "" + +#. Tag: programlisting +#: reference_trajectory.xml:106 +#, no-c-format +msgid "" +"-- Return the time in which two objects moving between 10:00 and 11:00\n" +"-- are closest to each other and their distance at that point\n" +"WITH inp AS ( SELECT\n" +" ST_AddMeasure('LINESTRING Z (0 0 0, 10 0 5)'::geometry,\n" +" extract(epoch from '2015-05-26 10:00'::timestamptz),\n" +" extract(epoch from '2015-05-26 11:00'::timestamptz)\n" +" ) a,\n" +" ST_AddMeasure('LINESTRING Z (0 2 10, 12 1 2)'::geometry,\n" +" extract(epoch from '2015-05-26 10:00'::timestamptz),\n" +" extract(epoch from '2015-05-26 11:00'::timestamptz)\n" +" ) b\n" +"), cpa AS (\n" +" SELECT ST_ClosestPointOfApproach(a,b) m FROM inp\n" +"), points AS (\n" +" SELECT ST_Force3DZ(ST_GeometryN(ST_LocateAlong(a,m),1)) pa,\n" +" ST_Force3DZ(ST_GeometryN(ST_LocateAlong(b,m),1)) pb\n" +" FROM inp, cpa\n" +")\n" +"SELECT to_timestamp(m) t,\n" +" ST_Distance(pa,pb) distance\n" +"FROM points, cpa;\n" +"\n" +" t | distance\n" +"-------------------------------+------------------\n" +" 2015-05-26 10:45:31.034483+02 | 1.96036833151395" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:111 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: reference_trajectory.xml:123 +#, no-c-format +msgid "ST_DistanceCPA" +msgstr "" + +#. Tag: refpurpose +#: reference_trajectory.xml:124 +#, no-c-format +msgid "" +"Returns the distance between the closest point of approach of two " +"trajectories." +msgstr "" + +#. Tag: funcprototype +#: reference_trajectory.xml:131 +#, no-c-format +msgid "" +"float8 ST_DistanceCPA " +"geometry track1 " +"geometry track2" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:142 +#, no-c-format +msgid "" +"Returns the minimum distance two moving objects have ever been each other." +msgstr "" + +#. Tag: programlisting +#: reference_trajectory.xml:158 +#, no-c-format +msgid "" +"-- Return the minimum distance of two objects moving between 10:00 and " +"11:00\n" +"WITH inp AS ( SELECT\n" +" ST_AddMeasure('LINESTRING Z (0 0 0, 10 0 5)'::geometry,\n" +" extract(epoch from '2015-05-26 10:00'::timestamptz),\n" +" extract(epoch from '2015-05-26 11:00'::timestamptz)\n" +" ) a,\n" +" ST_AddMeasure('LINESTRING Z (0 2 10, 12 1 2)'::geometry,\n" +" extract(epoch from '2015-05-26 10:00'::timestamptz),\n" +" extract(epoch from '2015-05-26 11:00'::timestamptz)\n" +" ) b\n" +")\n" +"SELECT ST_DistanceCPA(a,b) distance FROM inp;\n" +"\n" +" distance\n" +"------------------\n" +" 1.96036833151395" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:163 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_trajectory.xml:175 +#, no-c-format +msgid "ST_CPAWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_trajectory.xml:176 +#, no-c-format +msgid "" +"Returns true if the closest point of approach of two " +"trajectories is within the specified distance." +msgstr "" + +#. Tag: funcprototype +#: reference_trajectory.xml:184 +#, no-c-format +msgid "" +"float8 ST_CPAWithin " +"geometry track1 " +"geometry track2 " +"float8 maxdist" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:196 +#, no-c-format +msgid "" +"Checks whether two moving objects have ever been within the specified " +"maximum distance." +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:200 +#, no-c-format +msgid "" +"Inputs must be valid trajectories as checked by . False is returned if the trajectories do not " +"overlap in their M ranges." +msgstr "" + +#. Tag: programlisting +#: reference_trajectory.xml:213 +#, no-c-format +msgid "" +"WITH inp AS ( SELECT\n" +" ST_AddMeasure('LINESTRING Z (0 0 0, 10 0 5)'::geometry,\n" +" extract(epoch from '2015-05-26 10:00'::timestamptz),\n" +" extract(epoch from '2015-05-26 11:00'::timestamptz)\n" +" ) a,\n" +" ST_AddMeasure('LINESTRING Z (0 2 10, 12 1 2)'::geometry,\n" +" extract(epoch from '2015-05-26 10:00'::timestamptz),\n" +" extract(epoch from '2015-05-26 11:00'::timestamptz)\n" +" ) b\n" +")\n" +"SELECT ST_CPAWithin(a,b,2), ST_DistanceCPA(a,b) distance FROM inp;\n" +"\n" +" st_cpawithin | distance\n" +"--------------+------------------\n" +" t | 1.96521473776207" +msgstr "" + +#. Tag: para +#: reference_trajectory.xml:219 +#, no-c-format +msgid "" +", , , " +msgstr "" diff --git a/doc/po/templates/reference_transaction.xml.pot b/doc/po/templates/reference_transaction.xml.pot index 4b9cd03ad..fed844a62 100644 --- a/doc/po/templates/reference_transaction.xml.pot +++ b/doc/po/templates/reference_transaction.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:03+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -14,46 +14,48 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#. Tag: title -#: reference_transaction.xml:3 +#. Tag: para +#: reference_transaction.xml:6 #, no-c-format -msgid "Long Transactions Support" +msgid "" +"These functions implement a row locking mechanism to support long " +"transactions. They are provided primarily for implementors of the Web Feature Service " +"specification." msgstr "" -#. Tag: para -#: reference_transaction.xml:5 +#. Tag: title +#: reference_transaction.xml:13 #, no-c-format -msgid "" -"This module and associated pl/pgsql functions have been implemented to " -"provide long locking support required by Web Feature Service specification." +msgid "Long Transaction Support" msgstr "" #. Tag: para -#: reference_transaction.xml:10 +#: reference_transaction.xml:16 #, no-c-format msgid "" -"Users must use serializable transaction level otherwise " -"locking mechanism would break." +"For the locking mechanism to operate correctly the serializable transaction isolation level " +"must be used." msgstr "" #. Tag: refname -#: reference_transaction.xml:18 +#: reference_transaction.xml:24 #, no-c-format msgid "AddAuth" msgstr "" #. Tag: refpurpose -#: reference_transaction.xml:20 +#: reference_transaction.xml:26 #, no-c-format msgid "" -"Add an authorization token to be used in current transaction." +"Adds an authorization token to be used in the current " +"transaction." msgstr "" #. Tag: funcprototype -#: reference_transaction.xml:25 +#: reference_transaction.xml:31 #, no-c-format msgid "" "boolean AddAuth text " @@ -61,46 +63,47 @@ msgid "" 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 +#: reference_transaction.xml:39 reference_transaction.xml:88 +#: reference_transaction.xml:134 reference_transaction.xml:178 +#: reference_transaction.xml:243 reference_transaction.xml:288 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_transaction.xml:35 +#: reference_transaction.xml:41 #, no-c-format msgid "" -"Add an authorization token to be used in current transaction." +"Adds an authorization token to be used in the current transaction." msgstr "" #. Tag: para -#: reference_transaction.xml:37 +#: reference_transaction.xml:43 #, no-c-format msgid "" -"Creates/adds to a temp table called temp_lock_have_table the current " -"transaction identifier and authorization token key." +"Adds the current transaction identifier and authorization token to a " +"temporary table called temp_lock_have_table." 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 +#: reference_transaction.xml:46 reference_transaction.xml:98 +#: reference_transaction.xml:142 reference_transaction.xml:187 +#: reference_transaction.xml:252 reference_transaction.xml:293 #, 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 +#: reference_transaction.xml:50 reference_transaction.xml:104 +#: reference_transaction.xml:148 reference_transaction.xml:193 +#: reference_transaction.xml:257 reference_transaction.xml:298 #, no-c-format msgid "Examples" msgstr "" #. Tag: programlisting -#: reference_transaction.xml:47 +#: reference_transaction.xml:52 #, no-c-format msgid "" "SELECT LockRow('towns', '353', 'priscilla');\n" @@ -117,29 +120,29 @@ msgid "" 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 +#: reference_transaction.xml:57 reference_transaction.xml:111 +#: reference_transaction.xml:155 reference_transaction.xml:200 +#: reference_transaction.xml:264 reference_transaction.xml:305 #, no-c-format msgid "See Also" msgstr "" #. Tag: refname -#: reference_transaction.xml:60 +#: reference_transaction.xml:65 #, no-c-format msgid "CheckAuth" msgstr "" #. Tag: refpurpose -#: reference_transaction.xml:62 +#: reference_transaction.xml:67 #, no-c-format msgid "" -"Creates trigger on a table to prevent/allow updates and deletes of rows " +"Creates a trigger on a table to prevent/allow updates and deletes of rows " "based on authorization token." msgstr "" #. Tag: funcsynopsis -#: reference_transaction.xml:66 +#: reference_transaction.xml:71 #, no-c-format msgid "" " integer CheckAuth " @@ -153,35 +156,36 @@ msgid "" msgstr "" #. Tag: para -#: reference_transaction.xml:85 +#: reference_transaction.xml:90 #, 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." +"based on an authorization token. Identify rows using <rowid_col> " +"column." msgstr "" #. Tag: para -#: reference_transaction.xml:87 +#: reference_transaction.xml:93 #, 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 +#: reference_transaction.xml:94 #, no-c-format msgid "" "If an authorization trigger already exists on this table function errors." msgstr "" #. Tag: para -#: reference_transaction.xml:89 +#: reference_transaction.xml:95 #, no-c-format msgid "If Transaction support is not enabled, function throws an exception." msgstr "" #. Tag: programlisting -#: reference_transaction.xml:100 +#: reference_transaction.xml:106 #, no-c-format msgid "" "SELECT CheckAuth('public', 'towns', 'gid');\n" @@ -191,22 +195,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_transaction.xml:113 +#: reference_transaction.xml:119 #, no-c-format msgid "DisableLongTransactions" msgstr "" #. Tag: refpurpose -#: reference_transaction.xml:115 +#: reference_transaction.xml:121 #, no-c-format -msgid "" -"Disable long transaction support. This function removes the long " -"transaction support metadata tables, and drops all triggers attached to lock-" -"checked tables." +msgid "Disables long transaction support." msgstr "" #. Tag: funcprototype -#: reference_transaction.xml:122 +#: reference_transaction.xml:126 #, no-c-format msgid "" "text DisableLongTransactions " @@ -214,16 +215,16 @@ msgid "" msgstr "" #. Tag: para -#: reference_transaction.xml:132 +#: reference_transaction.xml:136 #, no-c-format msgid "" -"Disable long transaction support. This function removes the long " +"Disables long transaction support. This function removes the long " "transaction support metadata tables, and drops all triggers attached to lock-" -"checked tables." +"checked tables." msgstr "" #. Tag: para -#: reference_transaction.xml:135 +#: reference_transaction.xml:139 #, no-c-format msgid "" "Drops meta table called authorization_table and a view " @@ -232,7 +233,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_transaction.xml:146 +#: reference_transaction.xml:150 #, no-c-format msgid "" "SELECT DisableLongTransactions();\n" @@ -241,22 +242,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_transaction.xml:159 +#: reference_transaction.xml:163 #, no-c-format msgid "EnableLongTransactions" msgstr "" #. Tag: refpurpose -#: reference_transaction.xml:161 +#: reference_transaction.xml:165 #, no-c-format -msgid "" -"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." +msgid "Enables long transaction support." msgstr "" #. Tag: funcprototype -#: reference_transaction.xml:169 +#: reference_transaction.xml:170 #, no-c-format msgid "" "text EnableLongTransactions " @@ -264,16 +262,16 @@ msgid "" msgstr "" #. Tag: para -#: reference_transaction.xml:179 +#: reference_transaction.xml:180 #, no-c-format msgid "" -"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." +"Enables long transaction support. This function creates the required " +"metadata tables. It must be called once before using the other functions in " +"this section. Calling it twice is harmless." msgstr "" #. Tag: para -#: reference_transaction.xml:183 +#: reference_transaction.xml:185 #, no-c-format msgid "" "Creates a meta table called authorization_table and a " @@ -281,7 +279,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: reference_transaction.xml:193 +#: reference_transaction.xml:195 #, no-c-format msgid "" "SELECT EnableLongTransactions();\n" @@ -290,19 +288,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_transaction.xml:206 +#: reference_transaction.xml:208 #, no-c-format msgid "LockRow" msgstr "" #. Tag: refpurpose -#: reference_transaction.xml:208 +#: reference_transaction.xml:210 #, no-c-format -msgid "Set lock/authorization for specific row in table" +msgid "Sets lock/authorization for a row in a table." msgstr "" #. Tag: funcsynopsis -#: reference_transaction.xml:212 +#: reference_transaction.xml:214 #, no-c-format msgid "" " integer LockRow " @@ -324,16 +322,18 @@ msgid "" msgstr "" #. Tag: para -#: reference_transaction.xml:243 +#: reference_transaction.xml:245 #, 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)" +"Sets lock/authorization for a specific row in a table. " +"an_auth_token is a text value. expire_dt is a timestamp which defaults to now() + 1 hour. Returns 1 if lock has been assigned, 0 otherwise (i.e. row is " +"already locked by another auth.)" msgstr "" #. Tag: programlisting -#: reference_transaction.xml:255 +#: reference_transaction.xml:259 #, no-c-format msgid "" "SELECT LockRow('public', 'towns', '2', 'joey');\n" @@ -349,21 +349,19 @@ msgid "" msgstr "" #. Tag: refname -#: reference_transaction.xml:268 +#: reference_transaction.xml:272 #, no-c-format msgid "UnlockRows" msgstr "" #. Tag: refpurpose -#: reference_transaction.xml:270 +#: reference_transaction.xml:274 #, no-c-format -msgid "" -"Remove all locks held by specified authorization id. Returns the " -"number of locks released." +msgid "Removes all locks held by an authorization token." msgstr "" #. Tag: funcprototype -#: reference_transaction.xml:276 +#: reference_transaction.xml:280 #, no-c-format msgid "" "integer UnlockRows " @@ -371,15 +369,15 @@ msgid "" msgstr "" #. Tag: para -#: reference_transaction.xml:286 +#: reference_transaction.xml:290 #, no-c-format msgid "" -"Remove all locks held by specified authorization id. Returns the " -"number of locks released." +"Removes all locks held by specified authorization token. Returns the number " +"of locks released." msgstr "" #. Tag: programlisting -#: reference_transaction.xml:296 +#: reference_transaction.xml:300 #, no-c-format msgid "" "SELECT LockRow('towns', '353', 'priscilla');\n" diff --git a/doc/po/templates/reference_transformation.xml.pot b/doc/po/templates/reference_transformation.xml.pot new file mode 100644 index 000000000..3d329bf58 --- /dev/null +++ b/doc/po/templates/reference_transformation.xml.pot @@ -0,0 +1,838 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_transformation.xml:5 +#, no-c-format +msgid "" +"These functions change the position and shape of geometries using affine " +"transformations." +msgstr "" + +#. Tag: title +#: reference_transformation.xml:10 +#, no-c-format +msgid "Affine Transformations" +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:14 +#, no-c-format +msgid "ST_Affine" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:16 +#, no-c-format +msgid "Apply a 3D affine transformation to a geometry." +msgstr "" + +#. Tag: funcsynopsis +#: reference_transformation.xml:20 +#, no-c-format +msgid "" +" geometry ST_Affine " +"geometry geomA " +"float a " +"float b " +"float c " +"float d " +"float e " +"float f " +"float g " +"float h " +"float i " +"float xoff " +"float yoff " +"float zoff geometry ST_Affine geometry geomA float a float b float d float e float xoff float yoff " +msgstr "" + +#. Tag: title +#: reference_transformation.xml:52 reference_transformation.xml:127 +#: reference_transformation.xml:176 reference_transformation.xml:223 +#: reference_transformation.xml:272 reference_transformation.xml:348 +#: reference_transformation.xml:419 reference_transformation.xml:471 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:54 +#, no-c-format +msgid "" +"Applies a 3D affine transformation to the geometry to do things like " +"translate, rotate, scale in one step." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:55 +#, no-c-format +msgid "" +"Version 1: The call ST_Affine(geom, a, b, c, d, e, f, g, h, " +"i, xoff, yoff, zoff) represents the transformation matrix " +"/ a b c xoff \\\n" +"| d e f yoff |\n" +"| g h i zoff |\n" +"\\ 0 0 0 1 / and the vertices are transformed as " +"follows: 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 All of the translate / scale " +"functions below are expressed via such an affine transformation." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:62 +#, no-c-format +msgid "" +"Version 2: Applies a 2d affine transformation to the geometry. The call " +"ST_Affine(geom, a, b, d, e, xoff, yoff) " +"represents the transformation matrix / 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 / and the vertices are transformed as " +"follows: x' = a*x + b*y + xoff\n" +"y' = d*x + e*y + yoff\n" +"z' = z This method is a subcase of the 3D method above." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:68 reference_transformation.xml:133 +#: reference_transformation.xml:183 reference_transformation.xml:231 +#: reference_transformation.xml:280 reference_transformation.xml:368 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:69 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from Affine to ST_Affine in 1.2.2" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:70 reference_transformation.xml:283 +#: reference_transformation.xml:364 reference_transformation.xml:424 +#: reference_transformation.xml:480 +#, 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_transformation.xml:72 reference_transformation.xml:138 +#: reference_transformation.xml:185 reference_transformation.xml:233 +#: reference_transformation.xml:287 reference_transformation.xml:371 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:73 reference_transformation.xml:139 +#: reference_transformation.xml:187 reference_transformation.xml:235 +#: reference_transformation.xml:288 reference_transformation.xml:374 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:74 reference_transformation.xml:136 +#: reference_transformation.xml:186 reference_transformation.xml:234 +#: reference_transformation.xml:285 reference_transformation.xml:372 +#: reference_transformation.xml:427 reference_transformation.xml:484 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:75 reference_transformation.xml:137 +#: reference_transformation.xml:286 reference_transformation.xml:373 +#: reference_transformation.xml:428 reference_transformation.xml:485 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: title +#: reference_transformation.xml:80 reference_transformation.xml:145 +#: reference_transformation.xml:192 reference_transformation.xml:241 +#: reference_transformation.xml:293 reference_transformation.xml:380 +#: reference_transformation.xml:432 reference_transformation.xml:490 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:82 +#, 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: title +#: reference_transformation.xml:87 reference_transformation.xml:152 +#: reference_transformation.xml:199 reference_transformation.xml:248 +#: reference_transformation.xml:300 reference_transformation.xml:387 +#: reference_transformation.xml:445 reference_transformation.xml:497 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:89 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:96 +#, no-c-format +msgid "ST_Rotate" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:98 +#, no-c-format +msgid "Rotates a geometry about an origin point." +msgstr "" + +#. Tag: funcsynopsis +#: reference_transformation.xml:102 +#, no-c-format +msgid "" +" geometry ST_Rotate " +"geometry geomA " +"float rotRadians geometry ST_Rotate geometry geomA float rotRadians float x0 float y0 geometry " +"ST_Rotate geometry " +"geomA float " +"rotRadians geometry " +"pointOrigin " +msgstr "" + +#. Tag: para +#: reference_transformation.xml:129 +#, no-c-format +msgid "" +"Rotates geometry rotRadians counter-clockwise about the origin point. 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_transformation.xml:134 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 additional parameters for specifying the origin of rotation " +"were added." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:135 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from Rotate to ST_Rotate in 1.2.2" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:147 +#, 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_transformation.xml:154 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:160 +#, no-c-format +msgid "ST_RotateX" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:162 +#, no-c-format +msgid "Rotates a geometry about the X axis." +msgstr "" + +#. Tag: funcprototype +#: reference_transformation.xml:167 +#, no-c-format +msgid "" +"geometry ST_RotateX " +"geometry geomA " +"float rotRadians" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:178 +#, no-c-format +msgid "Rotates a geometry geomA - rotRadians about the X axis." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:180 +#, no-c-format +msgid "" +"ST_RotateX(geomA, rotRadians) is short-hand for " +"ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, " +"sin(rotRadians), cos(rotRadians), 0, 0, 0)." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:184 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from RotateX to ST_RotateX in 1.2.2" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:194 +#, 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_transformation.xml:201 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:207 +#, no-c-format +msgid "ST_RotateY" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:209 +#, no-c-format +msgid "Rotates a geometry about the Y axis." +msgstr "" + +#. Tag: funcprototype +#: reference_transformation.xml:214 +#, no-c-format +msgid "" +"geometry ST_RotateY " +"geometry geomA " +"float rotRadians" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:225 +#, no-c-format +msgid "Rotates a geometry geomA - rotRadians about the y axis." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:227 +#, no-c-format +msgid "" +"ST_RotateY(geomA, rotRadians) is short-hand for " +"ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -" +"sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:230 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from RotateY to ST_RotateY in 1.2.2" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:243 +#, 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_transformation.xml:250 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:256 +#, no-c-format +msgid "ST_RotateZ" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:258 +#, no-c-format +msgid "Rotates a geometry about the Z axis." +msgstr "" + +#. Tag: funcprototype +#: reference_transformation.xml:263 +#, no-c-format +msgid "" +"geometry ST_RotateZ " +"geometry geomA " +"float rotRadians" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:274 +#, no-c-format +msgid "Rotates a geometry geomA - rotRadians about the Z axis." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:276 +#, no-c-format +msgid "This is a synonym for ST_Rotate" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:277 +#, no-c-format +msgid "" +"ST_RotateZ(geomA, rotRadians) is short-hand for SELECT " +"ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), " +"cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:282 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from RotateZ to ST_RotateZ in 1.2.2" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:295 +#, 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_transformation.xml:302 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:308 +#, no-c-format +msgid "ST_Scale" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:310 +#, no-c-format +msgid "Scales a geometry by given factors." +msgstr "" + +#. Tag: funcsynopsis +#: reference_transformation.xml:314 +#, no-c-format +msgid "" +" geometry ST_Scale " +"geometry geomA " +"float XFactor " +"float YFactor " +"float ZFactor geometry ST_Scale geometry geomA float XFactor float YFactor geometry " +"ST_Scale geometry " +"geom geometry " +"factor " +"geometry ST_Scale " +"geometry geom " +"geometry factor " +"geometry origin " +msgstr "" + +#. Tag: para +#: reference_transformation.xml:350 +#, no-c-format +msgid "" +"Scales the geometry to a new size by multiplying the ordinates with the " +"corresponding factor parameters." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:354 +#, no-c-format +msgid "" +"The version taking a geometry as the factor parameter " +"allows passing a 2d, 3dm, 3dz or 4d point to set scaling factor for all " +"supported dimensions. Missing dimensions in the factor " +"point are equivalent to no scaling the corresponding dimension." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:360 +#, no-c-format +msgid "" +"The three-geometry variant allows a \"false origin\" for the scaling to be " +"passed in. This allows \"scaling in place\", for example using the centroid " +"of the geometry as the false origin. Without a false origin, scaling takes " +"place relative to the actual origin, so all coordinates are just multipled " +"by the scale factor." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:367 reference_transformation.xml:483 +#, no-c-format +msgid "Availability: 1.1.0." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:369 +#, no-c-format +msgid "" +"Enhanced: 2.2.0 support for scaling all dimension (factor " +"parameter) was introduced." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:370 +#, no-c-format +msgid "" +"Enhanced: 2.5.0 support for scaling relative to a local origin " +"(origin parameter) was introduced." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:375 +#, no-c-format +msgid "&M_support;" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:382 +#, 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)\n" +"\n" +"--Version 3: Scale X Y Z M\n" +" SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)'),\n" +" ST_MakePoint(0.5, 0.75, 2, -1)));\n" +" st_asewkt\n" +"----------------------------------------\n" +" LINESTRING(0.5 1.5 6 -4,0.5 0.75 2 -1)\n" +"\n" +"--Version 4: Scale X Y using false origin\n" +"SELECT ST_AsText(ST_Scale('LINESTRING(1 1, 2 2)', 'POINT(2 2)', 'POINT(1 " +"1)'::geometry));\n" +" st_astext\n" +"---------------------\n" +" LINESTRING(1 1,3 3)" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:389 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:395 +#, no-c-format +msgid "ST_Translate" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:397 +#, no-c-format +msgid "Translates a geometry by given offsets." +msgstr "" + +#. Tag: funcsynopsis +#: reference_transformation.xml:401 +#, no-c-format +msgid "" +" geometry ST_Translate geometry g1 float deltax float deltay geometry " +"ST_Translate geometry " +"g1 float " +"deltax float " +"deltay float " +"deltaz " +msgstr "" + +#. Tag: para +#: reference_transformation.xml:421 +#, 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_transformation.xml:426 +#, no-c-format +msgid "Availability: 1.2.2" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:433 +#, no-c-format +msgid "Move a point 1 degree longitude" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:434 +#, 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 "" + +#. Tag: para +#: reference_transformation.xml:435 +#, no-c-format +msgid "Move a linestring 1 degree longitude and 1/2 degree latitude" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:436 +#, 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 "" + +#. Tag: para +#: reference_transformation.xml:437 +#, no-c-format +msgid "Move a 3d point" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:438 +#, 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 "" + +#. Tag: para +#: reference_transformation.xml:439 +#, no-c-format +msgid "Move a curve and a point" +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:440 +#, 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 "" + +#. Tag: para +#: reference_transformation.xml:446 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_transformation.xml:452 +#, no-c-format +msgid "ST_TransScale" +msgstr "" + +#. Tag: refpurpose +#: reference_transformation.xml:454 +#, no-c-format +msgid "Translates and scales a geometry by given offsets and factors." +msgstr "" + +#. Tag: funcprototype +#: reference_transformation.xml:459 +#, no-c-format +msgid "" +"geometry ST_TransScale " +"geometry geomA " +"float deltaX " +"float deltaY " +"float XFactor " +"float YFactor" +msgstr "" + +#. Tag: para +#: reference_transformation.xml:473 +#, no-c-format +msgid "" +"Translates the geometry using the deltaX and deltaY args, then scales it " +"using the XFactor, YFactor args, working in 2D only." +msgstr "" + +#. Tag: para +#: reference_transformation.xml:476 +#, no-c-format +msgid "" +"ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor) is short-" +"hand for ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, " +"deltaX*XFactor, deltaY*YFactor, 0)." +msgstr "" + +#. Tag: programlisting +#: reference_transformation.xml:492 +#, 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_transformation.xml:499 +#, no-c-format +msgid ", " +msgstr "" diff --git a/doc/po/templates/reference_troubleshooting.xml.pot b/doc/po/templates/reference_troubleshooting.xml.pot new file mode 100644 index 000000000..4fc582a66 --- /dev/null +++ b/doc/po/templates/reference_troubleshooting.xml.pot @@ -0,0 +1,223 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_troubleshooting.xml:5 +#, no-c-format +msgid "" +"These functions are utilities for troubleshooting and repairing geometry " +"data. They are only needed if the geometry data is corrupted in some way, " +"which should never happen under normal circumstances." +msgstr "" + +#. Tag: title +#: reference_troubleshooting.xml:10 +#, no-c-format +msgid "Troubleshooting Functions" +msgstr "" + +#. Tag: refname +#: reference_troubleshooting.xml:14 +#, no-c-format +msgid "PostGIS_AddBBox" +msgstr "" + +#. Tag: refpurpose +#: reference_troubleshooting.xml:16 +#, no-c-format +msgid "Add bounding box to the geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_troubleshooting.xml:21 +#, no-c-format +msgid "" +"geometry PostGIS_AddBBox " +"geometry geomA" +msgstr "" + +#. Tag: title +#: reference_troubleshooting.xml:29 reference_troubleshooting.xml:75 +#: reference_troubleshooting.xml:124 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_troubleshooting.xml:31 +#, 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_troubleshooting.xml:36 +#, 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_troubleshooting.xml:40 reference_troubleshooting.xml:88 +#: reference_troubleshooting.xml:129 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: title +#: reference_troubleshooting.xml:45 reference_troubleshooting.xml:93 +#: reference_troubleshooting.xml:134 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_troubleshooting.xml:47 +#, no-c-format +msgid "" +"UPDATE sometable\n" +" SET the_geom = PostGIS_AddBBox(the_geom)\n" +" WHERE PostGIS_HasBBox(the_geom) = false;" +msgstr "" + +#. Tag: title +#: reference_troubleshooting.xml:52 reference_troubleshooting.xml:100 +#: reference_troubleshooting.xml:141 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_troubleshooting.xml:54 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_troubleshooting.xml:60 +#, no-c-format +msgid "PostGIS_DropBBox" +msgstr "" + +#. Tag: refpurpose +#: reference_troubleshooting.xml:62 +#, no-c-format +msgid "Drop the bounding box cache from the geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_troubleshooting.xml:67 +#, no-c-format +msgid "" +"geometry PostGIS_DropBBox " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_troubleshooting.xml:77 +#, 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_troubleshooting.xml:82 +#, 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_troubleshooting.xml:95 +#, 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_troubleshooting.xml:102 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_troubleshooting.xml:109 +#, no-c-format +msgid "PostGIS_HasBBox" +msgstr "" + +#. Tag: refpurpose +#: reference_troubleshooting.xml:111 +#, no-c-format +msgid "Returns TRUE if the bbox of this geometry is cached, FALSE otherwise." +msgstr "" + +#. Tag: funcprototype +#: reference_troubleshooting.xml:116 +#, no-c-format +msgid "" +"boolean PostGIS_HasBBox " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_troubleshooting.xml:126 +#, no-c-format +msgid "" +"Returns TRUE if the bbox of this geometry is cached, FALSE otherwise. Use " +" and " +"to control caching." +msgstr "" + +#. Tag: programlisting +#: reference_troubleshooting.xml:136 +#, no-c-format +msgid "" +"SELECT the_geom\n" +"FROM sometable WHERE PostGIS_HasBBox(the_geom) = false;" +msgstr "" + +#. Tag: para +#: reference_troubleshooting.xml:143 +#, no-c-format +msgid ", " +msgstr "" diff --git a/doc/po/templates/reference_type.xml.pot b/doc/po/templates/reference_type.xml.pot index 52861d2ad..baebfb863 100644 --- a/doc/po/templates/reference_type.xml.pot +++ b/doc/po/templates/reference_type.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,110 +18,139 @@ msgstr "" #: 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." +"This section lists the custom PostgreSQL data types installed by PostGIS to " +"represent spatial data." 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." +"Each data type describes its type casting behaviour. A type cast converts values of one data type into another type. " +"PostgreSQL allows defining casting behavior for custom types, along with the " +"functions used to convert type values. Casts can have automatic behaviour, which allows automatic conversion of a " +"function argument to a type supported by the function." msgstr "" #. Tag: para -#: reference_type.xml:13 +#: reference_type.xml:14 #, 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." +"Some casts have explicit behaviour, which " +"means the cast must be specified using the syntax CAST(myval As " +"sometype) or myval::sometype. Explicit casting " +"avoids the issue of ambiguous casts, which can occur when using an " +"overloaded function which does not support a given type. For example, a " +"function may accept a box2d or a box3d, but not a geometry. Since geometry " +"has an automatic cast to both box types, this produces an \"ambiguous " +"function\" error. To prevent the error use an explicit cast to the desired " +"box type." msgstr "" #. Tag: para -#: reference_type.xml:17 +#: reference_type.xml:24 #, no-c-format msgid "" -"At least as of PostgreSQL 8.3 - 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." +"All data types can be cast to text, so this does not need " +"to be specified explicitly." msgstr "" #. Tag: title -#: reference_type.xml:20 +#: reference_type.xml:27 #, no-c-format -msgid "PostgreSQL PostGIS Geometry/Geography/Box Types" +msgid "PostGIS Geometry/Geography/Box Data Types" msgstr "" #. Tag: refname -#: reference_type.xml:24 +#: reference_type.xml:31 #, no-c-format msgid "box2d" msgstr "" #. Tag: refpurpose -#: reference_type.xml:25 +#: reference_type.xml:32 #, no-c-format msgid "" -"A box composed of x min, ymin, xmax, ymax. Often used to return the 2d " -"enclosing box of a geometry." +"A 2-dimensional bounding box. Used to describe the 2D extent of a geometry " +"or collection of geometries." msgstr "" #. Tag: title -#: reference_type.xml:29 reference_type.xml:40 reference_type.xml:79 -#: reference_type.xml:137 reference_type.xml:156 +#: reference_type.xml:37 reference_type.xml:60 reference_type.xml:111 +#: reference_type.xml:168 reference_type.xml:199 #, no-c-format msgid "Description" msgstr "" #. Tag: para -#: reference_type.xml:30 +#: reference_type.xml:38 +#, no-c-format +msgid "" +"box2d is a spatial data type used to represent the two-" +"dimensional enclosing box of a geometry or collection of geometries. For " +"example, the aggregate function returns a " +"box2d object." +msgstr "" + +#. Tag: para +#: reference_type.xml:41 #, 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." +"The representation contains the values xmin, ymin, xmax, ymax. These are the minimum and maxium values of the X and Y extents." +msgstr "" + +#. Tag: title +#: reference_type.xml:47 reference_type.xml:98 reference_type.xml:156 +#: reference_type.xml:187 reference_type.xml:229 +#, no-c-format +msgid "See Also" msgstr "" #. Tag: refname -#: reference_type.xml:35 +#: reference_type.xml:54 #, no-c-format msgid "box3d" msgstr "" #. Tag: refpurpose -#: reference_type.xml:36 +#: reference_type.xml:55 #, 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." +"A 3-dimensional bounding box. Used to describe the 3D extent of a geometry " +"or collection of geometries." msgstr "" #. Tag: para -#: reference_type.xml:41 +#: reference_type.xml:61 #, 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." +"box3d is a postgis spatial data type used to represent " +"the three-dimensional enclosing box of a geometry or collection of " +"geometries. For example, the aggregate " +"function returns a box3d object." +msgstr "" + +#. Tag: para +#: reference_type.xml:65 +#, no-c-format +msgid "" +"The representation contains the values xmin, ymin, zmin, xmax, " +"ymax, zmax. These are the minimum and maxium values of the X, Y " +"and Z extents." msgstr "" #. Tag: title -#: reference_type.xml:45 reference_type.xml:85 reference_type.xml:161 +#: reference_type.xml:71 reference_type.xml:117 reference_type.xml:210 #, no-c-format msgid "Casting Behavior" msgstr "" #. Tag: para -#: reference_type.xml:46 reference_type.xml:86 reference_type.xml:162 +#: reference_type.xml:72 reference_type.xml:118 reference_type.xml:211 #, no-c-format msgid "" "This section lists the automatic as well as explicit casts allowed for this " @@ -129,156 +158,185 @@ msgid "" msgstr "" #. Tag: entry -#: reference_type.xml:51 reference_type.xml:91 reference_type.xml:167 +#: reference_type.xml:77 reference_type.xml:123 reference_type.xml:216 #, no-c-format msgid "Cast To" msgstr "" #. Tag: entry -#: reference_type.xml:52 reference_type.xml:92 reference_type.xml:168 +#: reference_type.xml:78 reference_type.xml:124 reference_type.xml:217 #, no-c-format msgid "Behavior" msgstr "" #. Tag: entry -#: reference_type.xml:55 reference_type.xml:95 +#: reference_type.xml:81 reference_type.xml:127 #, no-c-format msgid "box" msgstr "" #. Tag: entry -#: reference_type.xml:56 reference_type.xml:60 reference_type.xml:64 -#: reference_type.xml:96 reference_type.xml:100 reference_type.xml:104 -#: reference_type.xml:108 reference_type.xml:112 reference_type.xml:116 +#: reference_type.xml:82 reference_type.xml:86 reference_type.xml:90 +#: reference_type.xml:128 reference_type.xml:132 reference_type.xml:136 +#: reference_type.xml:140 reference_type.xml:144 reference_type.xml:148 #, no-c-format msgid "automatic" msgstr "" #. Tag: entry -#: reference_type.xml:59 reference_type.xml:99 +#: reference_type.xml:85 reference_type.xml:131 #, no-c-format msgid "box2d" msgstr "" #. Tag: entry -#: reference_type.xml:63 reference_type.xml:171 +#: reference_type.xml:89 reference_type.xml:220 #, no-c-format msgid "geometry" msgstr "" #. Tag: refname -#: reference_type.xml:74 +#: reference_type.xml:106 #, no-c-format msgid "geometry" msgstr "" #. Tag: refpurpose -#: reference_type.xml:75 +#: reference_type.xml:107 #, no-c-format -msgid "Planar spatial data type." +msgid "The type representing spatial features with planar coordinate systems." msgstr "" #. Tag: para -#: reference_type.xml:80 +#: reference_type.xml:112 #, no-c-format msgid "" -"geometry is a fundamental PostGIS spatial data type used to represent a " -"feature in the Euclidean coordinate system." +"geometry is a fundamental PostGIS spatial data type used " +"to represent a feature in planar (Euclidean) coordinate systems." msgstr "" #. Tag: para -#: reference_type.xml:81 +#: reference_type.xml:113 #, no-c-format msgid "" -"All spatial operations on geometry are using units of the Spatial Reference " -"System the geomtry is in." +"All spatial operations on geometry use the units of the Spatial Reference " +"System the geometry is in." msgstr "" #. Tag: entry -#: reference_type.xml:103 +#: reference_type.xml:135 #, no-c-format msgid "box3d" msgstr "" #. Tag: entry -#: reference_type.xml:107 +#: reference_type.xml:139 #, no-c-format msgid "bytea" msgstr "" #. Tag: entry -#: reference_type.xml:111 +#: reference_type.xml:143 #, no-c-format msgid "geography" msgstr "" #. Tag: entry -#: reference_type.xml:115 +#: reference_type.xml:147 #, no-c-format msgid "text" msgstr "" -#. Tag: title -#: reference_type.xml:124 reference_type.xml:144 reference_type.xml:180 +#. Tag: para +#: reference_type.xml:157 #, no-c-format -msgid "See Also" +msgid ", " msgstr "" #. Tag: refname -#: reference_type.xml:131 +#: reference_type.xml:163 #, no-c-format msgid "geometry_dump" msgstr "" #. Tag: refpurpose -#: reference_type.xml:132 +#: reference_type.xml:164 +#, no-c-format +msgid "A composite type used to describe the parts of complex geometry." +msgstr "" + +#. Tag: para +#: reference_type.xml:169 +#, no-c-format +msgid "" +"geometry_dump is a composite data type containing the " +"fields:" +msgstr "" + +#. Tag: para +#: reference_type.xml:174 +#, no-c-format +msgid "geom - a references to a component geometry" +msgstr "" + +#. Tag: para +#: reference_type.xml:177 #, 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.)" +"path[] - a 1-dimensional integer array that defines the " +"navigation path within the dumped geometry to the geom " +"component. The path array starts at 1 (e.g. path[1] is " +"the first element.)" msgstr "" #. Tag: para -#: reference_type.xml:138 +#: reference_type.xml:182 #, 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." +"It is used by the ST_Dump* family of functions as an " +"output type to explode a complex geometry into its constituent parts." msgstr "" #. Tag: refname -#: reference_type.xml:151 +#: reference_type.xml:194 #, no-c-format msgid "geography" msgstr "" #. Tag: refpurpose -#: reference_type.xml:152 +#: reference_type.xml:195 #, no-c-format -msgid "Ellipsoidal spatial data type." +msgid "" +"The type representing spatial features with geodetic (ellipsoidal) " +"coordinate systems." msgstr "" #. Tag: para -#: reference_type.xml:157 +#: reference_type.xml:200 +#, no-c-format +msgid "" +"geography is a spatial data type used to represent a " +"feature in geodetic coordinate systems. Geodetic coordinate systems model " +"the earth using an ellipsoid." +msgstr "" + +#. Tag: para +#: reference_type.xml:203 #, no-c-format msgid "" -"geography is a spatial data type used to represent a feature in the round-" -"earth coordinate system." +"Spatial operations on the geography type provide more accurate results by " +"taking the ellipsoidal model into account." msgstr "" #. Tag: entry -#: reference_type.xml:172 +#: reference_type.xml:221 #, no-c-format msgid "explicit" msgstr "" #. Tag: para -#: reference_type.xml:181 +#: reference_type.xml:230 #, no-c-format -msgid ", " +msgid ", " msgstr "" diff --git a/doc/po/templates/reference_validation.xml.pot b/doc/po/templates/reference_validation.xml.pot new file mode 100644 index 000000000..2fef56fbf --- /dev/null +++ b/doc/po/templates/reference_validation.xml.pot @@ -0,0 +1,386 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_validation.xml:7 +#, no-c-format +msgid "" +"These functions test whether geometries are valid according to the OGC SFS " +"standard. They also provide information about the nature and location of " +"invalidity." +msgstr "" + +#. Tag: title +#: reference_validation.xml:14 +#, no-c-format +msgid "Geometry Validation" +msgstr "" + +#. Tag: refname +#: reference_validation.xml:18 +#, no-c-format +msgid "ST_IsValid" +msgstr "" + +#. Tag: refpurpose +#: reference_validation.xml:20 +#, no-c-format +msgid "Tests if a geometry is well-formed in 2D." +msgstr "" + +#. Tag: funcsynopsis +#: reference_validation.xml:25 +#, no-c-format +msgid "" +" boolean ST_IsValid " +"geometry g boolean ST_IsValid geometry g integer flags " +msgstr "" + +#. Tag: title +#: reference_validation.xml:41 reference_validation.xml:115 +#: reference_validation.xml:177 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_validation.xml:43 +#, no-c-format +msgid "" +"Test if an ST_Geometry value is well-formed in 2D according to the OGC " +"rules. For geometries that are invalid, the PostgreSQL NOTICE will provide " +"details of why it is not valid. For geometries with 3 and 4 dimensions, the " +"validity still only tested in 2 dimensions." +msgstr "" + +#. Tag: para +#: reference_validation.xml:48 +#, no-c-format +msgid "" +"For the version with flags, supported flags are " +"documented in This version does not " +"print a NOTICE explaining invalidity." +msgstr "" + +#. Tag: para +#: reference_validation.xml:53 +#, no-c-format +msgid "" +"For more information on the definition of geometry validity, refer to \"Ensuring OpenGIS compliancy of geometries\"" +msgstr "" + +#. Tag: para +#: reference_validation.xml:57 +#, no-c-format +msgid "" +"SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns " +"NULL." +msgstr "" + +#. Tag: para +#: reference_validation.xml:60 reference_validation.xml:133 +#: reference_validation.xml:186 +#, no-c-format +msgid "Performed by the GEOS module." +msgstr "" + +#. Tag: para +#: reference_validation.xml:62 +#, no-c-format +msgid "The version accepting flags is available starting with 2.0.0." +msgstr "" + +#. Tag: para +#: reference_validation.xml:65 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_validation.xml:66 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.9" +msgstr "" + +#. Tag: para +#: reference_validation.xml:69 +#, no-c-format +msgid "" +"Neither OGC-SFS nor SQL-MM specifications include a flag argument for " +"ST_IsValid. The flag is a PostGIS extension." +msgstr "" + +#. Tag: title +#: reference_validation.xml:79 reference_validation.xml:138 +#: reference_validation.xml:191 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_validation.xml:81 +#, 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: title +#: reference_validation.xml:85 reference_validation.xml:145 +#: reference_validation.xml:198 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_validation.xml:87 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_validation.xml:99 +#, no-c-format +msgid "ST_IsValidDetail" +msgstr "" + +#. Tag: refpurpose +#: reference_validation.xml:101 +#, no-c-format +msgid "" +"Returns a valid_detail row stating if a geometry is " +"valid, and if not a reason why and a location." +msgstr "" + +#. Tag: funcprototype +#: reference_validation.xml:106 +#, no-c-format +msgid "" +"valid_detail ST_IsValidDetail " +"geometry geom " +"integer flags" +msgstr "" + +#. Tag: para +#: reference_validation.xml:117 +#, 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_validation.xml:119 +#, 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_validation.xml:121 +#, no-c-format +msgid "The 'flags' argument is a bitfield. It can have the following values:" +msgstr "" + +#. Tag: para +#: reference_validation.xml:125 +#, 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_validation.xml:134 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "" + +#. Tag: programlisting +#: reference_validation.xml:140 +#, 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), array_agg(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_validation.xml:147 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_validation.xml:156 +#, no-c-format +msgid "ST_IsValidReason" +msgstr "" + +#. Tag: refpurpose +#: reference_validation.xml:158 +#, no-c-format +msgid "" +"Returns text stating if a geometry is valid, or a reason for invalidity." +msgstr "" + +#. Tag: funcsynopsis +#: reference_validation.xml:162 +#, no-c-format +msgid "" +" text ST_IsValidReason geometry geomA integer flags text " +"ST_IsValidReason geometry geomA " +msgstr "" + +#. Tag: para +#: reference_validation.xml:179 +#, 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_validation.xml:181 +#, no-c-format +msgid "" +"Useful in combination with ST_IsValid to generate a detailed report of " +"invalid geometries and reasons." +msgstr "" + +#. Tag: para +#: reference_validation.xml:183 +#, no-c-format +msgid "" +"Allowed flags are documented in ." +msgstr "" + +#. Tag: para +#: reference_validation.xml:187 +#, no-c-format +msgid "Availability: 1.4" +msgstr "" + +#. Tag: para +#: reference_validation.xml:188 +#, no-c-format +msgid "Availability: 2.0 version taking flags." +msgstr "" + +#. Tag: programlisting +#: reference_validation.xml:193 +#, 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), array_agg(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_validation.xml:200 +#, no-c-format +msgid ", " +msgstr "" diff --git a/doc/po/templates/reference_version.xml.pot b/doc/po/templates/reference_version.xml.pot new file mode 100644 index 000000000..b6011564f --- /dev/null +++ b/doc/po/templates/reference_version.xml.pot @@ -0,0 +1,731 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#: reference_version.xml:5 +#, no-c-format +msgid "These functions report and upgrade PostGIS versions." +msgstr "" + +#. Tag: title +#: reference_version.xml:10 +#, no-c-format +msgid "Version Functions" +msgstr "" + +#. Tag: refname +#: reference_version.xml:14 +#, no-c-format +msgid "PostGIS_Extensions_Upgrade" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:16 +#, no-c-format +msgid "" +"Packages and upgrades postgis extensions (e.g. postgis_raster, " +"postgis_topology, postgis_sfcgal) to latest available version." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:24 +#, no-c-format +msgid "" +"text PostGIS_Extensions_Upgrade " +"" +msgstr "" + +#. Tag: title +#: reference_version.xml:33 reference_version.xml:92 reference_version.xml:139 +#: reference_version.xml:181 reference_version.xml:222 +#: reference_version.xml:263 reference_version.xml:294 +#: reference_version.xml:335 reference_version.xml:376 +#: reference_version.xml:418 reference_version.xml:461 +#: reference_version.xml:509 reference_version.xml:555 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_version.xml:35 +#, no-c-format +msgid "" +"Packages and upgrades postgis extensions to latest version. Only extensions " +"you have installed in the database will be packaged and upgraded if needed. " +"Reports full postgis version and build configuration infos after. This is " +"short-hand for doing multiple CREATE EXTENSION .. FROM unpackaged and ALTER " +"EXTENSION .. UPDATE for each postgis extension. Currently only tries to " +"upgrade extensions postgis, postgis_raster, postgis_sfcgal, " +"postgis_topology, and postgis_tiger_geocoder." +msgstr "" + +#. Tag: para +#: reference_version.xml:44 +#, no-c-format +msgid "Availability: 2.5.0" +msgstr "" + +#. Tag: para +#: reference_version.xml:46 +#, no-c-format +msgid "" +"Changed: 3.0.0 to repackage loose extensions and support postgis_raster." +msgstr "" + +#. Tag: title +#: reference_version.xml:51 reference_version.xml:100 reference_version.xml:146 +#: reference_version.xml:187 reference_version.xml:229 +#: reference_version.xml:269 reference_version.xml:300 +#: reference_version.xml:342 reference_version.xml:383 +#: reference_version.xml:426 reference_version.xml:478 +#: reference_version.xml:524 reference_version.xml:561 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:53 +#, no-c-format +msgid "SELECT PostGIS_Extensions_Upgrade();" +msgstr "" + +#. Tag: screen +#: reference_version.xml:54 +#, no-c-format +msgid "" +"NOTICE: Packaging extension postgis\n" +"NOTICE: Packaging extension postgis_raster\n" +"NOTICE: Packaging extension postgis_sfcgal\n" +"NOTICE: Extension postgis_topology is not available or not packagable for " +"some reason\n" +"NOTICE: Extension postgis_tiger_geocoder is not available or not packagable " +"for some reason\n" +"\n" +" postgis_extensions_upgrade\n" +"----------------------------------------------------------------------------------\n" +"POSTGIS=\"3.0.0dev r16878\" [EXTENSION] PGSQL=\"96\"\n" +"GEOS=\"3.8.0dev-CAPI-1.11.0 a67b6f86\" SFCGAL=\"1.3.5\" PROJ=\"Rel. 4.9.3,\n" +"15 August 2016\" GDAL=\"GDAL 2.3.0dev, released 2017/99/99\"\n" +"LIBXML=\"2.9.4\" LIBJSON=\"0.12.1\" LIBPROTOBUF=\"1.2.1\" TOPOLOGY\n" +"[UNPACKAGED!] RASTER\n" +"(1 row)" +msgstr "" + +#. Tag: title +#: reference_version.xml:58 reference_version.xml:106 reference_version.xml:152 +#: reference_version.xml:193 reference_version.xml:235 +#: reference_version.xml:306 reference_version.xml:348 +#: reference_version.xml:389 reference_version.xml:432 +#: reference_version.xml:484 reference_version.xml:530 +#: reference_version.xml:567 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_version.xml:60 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_version.xml:75 +#, no-c-format +msgid "PostGIS_Full_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:77 +#, no-c-format +msgid "Reports full postgis version and build configuration infos." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:83 +#, no-c-format +msgid "" +"text PostGIS_Full_Version " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:94 +#, 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_version.xml:102 +#, no-c-format +msgid "" +"SELECT PostGIS_Full_Version();\n" +" postgis_full_version\n" +"----------------------------------------------------------------------------------\n" +"POSTGIS=\"3.0.0dev r17211\" [EXTENSION] PGSQL=\"110\" GEOS=\"3.8.0dev-" +"CAPI-1.11.0 df24b6bb\" SFCGAL=\"1.3.6\" PROJ=\"Rel. 5.2.0, September 15th, " +"2018\"\n" +"GDAL=\"GDAL 2.3.2, released 2018/09/21\" LIBXML=\"2.9.9\" LIBJSON=\"0.13.1\" " +"LIBPROTOBUF=\"1.3.1\" WAGYU=\"0.4.3 (Internal)\" TOPOLOGY RASTER\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_version.xml:108 +#, no-c-format +msgid "" +", , , , , , " +msgstr "" + +#. Tag: refname +#: reference_version.xml:122 +#, no-c-format +msgid "PostGIS_GEOS_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:124 +#, no-c-format +msgid "Returns the version number of the GEOS library." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:130 +#, no-c-format +msgid "" +"text PostGIS_GEOS_Version " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:141 +#, no-c-format +msgid "" +"Returns the version number of the GEOS library, or NULL " +"if GEOS support is not enabled." +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:148 +#, 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_version.xml:154 reference_version.xml:195 +#, no-c-format +msgid "" +", , , , " +"" +msgstr "" + +#. Tag: refname +#: reference_version.xml:164 +#, no-c-format +msgid "PostGIS_Liblwgeom_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:166 +#, no-c-format +msgid "" +"Returns the version number of the liblwgeom library. This should match the " +"version of PostGIS." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:172 +#, no-c-format +msgid "" +"text PostGIS_Liblwgeom_Version " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:183 +#, no-c-format +msgid "Returns the version number of the liblwgeom library/" +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:189 +#, no-c-format +msgid "" +"SELECT PostGIS_Liblwgeom_Version();\n" +"postgis_liblwgeom_version\n" +"--------------------------\n" +"2.3.3 r15473\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_version.xml:205 +#, no-c-format +msgid "PostGIS_LibXML_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:207 +#, no-c-format +msgid "Returns the version number of the libxml2 library." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:213 +#, no-c-format +msgid "" +"text PostGIS_LibXML_Version " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:224 +#, no-c-format +msgid "Returns the version number of the LibXML2 library." +msgstr "" + +#. Tag: para +#: reference_version.xml:225 +#, no-c-format +msgid "Availability: 1.5" +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:231 +#, no-c-format +msgid "" +"SELECT PostGIS_LibXML_Version();\n" +" postgis_libxml_version\n" +"----------------------\n" +" 2.7.6\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_version.xml:237 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_version.xml:247 +#, no-c-format +msgid "PostGIS_Lib_Build_Date" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:249 +#, no-c-format +msgid "Returns build date of the PostGIS library." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:254 +#, no-c-format +msgid "" +"text PostGIS_Lib_Build_Date " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:265 +#, no-c-format +msgid "Returns build date of the PostGIS library." +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:271 +#, 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_version.xml:277 +#, no-c-format +msgid "PostGIS_Lib_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:279 +#, no-c-format +msgid "" +"Returns the version number of the PostGIS library." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:285 +#, no-c-format +msgid "" +"text PostGIS_Lib_Version " +msgstr "" + +#. Tag: para +#: reference_version.xml:296 +#, no-c-format +msgid "Returns the version number of the PostGIS library." +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:302 +#, no-c-format +msgid "" +"SELECT PostGIS_Lib_Version();\n" +" postgis_lib_version\n" +"---------------------\n" +" 1.3.3\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_version.xml:308 +#, no-c-format +msgid "" +", , , , " +"" +msgstr "" + +#. Tag: refname +#: reference_version.xml:318 +#, no-c-format +msgid "PostGIS_PROJ_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:320 +#, no-c-format +msgid "Returns the version number of the PROJ4 library." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:326 +#, no-c-format +msgid "" +"text PostGIS_PROJ_Version " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:337 +#, no-c-format +msgid "" +"Returns the version number of the PROJ4 library, or NULL " +"if PROJ4 support is not enabled." +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:344 +#, 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_version.xml:350 reference_version.xml:434 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_version.xml:360 +#, no-c-format +msgid "PostGIS_Wagyu_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:362 +#, no-c-format +msgid "Returns the version number of the internal Wagyu library." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:367 +#, no-c-format +msgid "" +"text PostGIS_Wagyu_Version " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:378 +#, no-c-format +msgid "" +"Returns the version number of the internal Wagyu library, or NULL if Wagyu support is not enabled." +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:385 +#, no-c-format +msgid "" +"SELECT PostGIS_Wagyu_Version();\n" +" postgis_wagyu_version\n" +"-----------------------\n" +" 0.4.3 (Internal)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_version.xml:391 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_version.xml:402 +#, no-c-format +msgid "PostGIS_Scripts_Build_Date" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:404 +#, no-c-format +msgid "Returns build date of the PostGIS scripts." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:409 +#, no-c-format +msgid "" +"text PostGIS_Scripts_Build_Date " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:420 +#, no-c-format +msgid "Returns build date of the PostGIS scripts." +msgstr "" + +#. Tag: para +#: reference_version.xml:422 +#, no-c-format +msgid "Availability: 1.0.0RC1" +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:428 +#, 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_version.xml:444 +#, no-c-format +msgid "PostGIS_Scripts_Installed" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:446 +#, no-c-format +msgid "" +"Returns version of the postgis scripts installed in this " +"database." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:452 +#, no-c-format +msgid "" +"text PostGIS_Scripts_Installed " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:463 +#, no-c-format +msgid "" +"Returns version of the postgis scripts installed in this database." +msgstr "" + +#. Tag: para +#: reference_version.xml:467 +#, no-c-format +msgid "" +"If the output of this function doesn't match the output of you probably missed to properly upgrade an " +"existing database. See the Upgrading " +"section for more info." +msgstr "" + +#. Tag: para +#: reference_version.xml:474 reference_version.xml:520 +#, no-c-format +msgid "Availability: 0.9.0" +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:480 +#, no-c-format +msgid "" +"SELECT PostGIS_Scripts_Installed();\n" +" postgis_scripts_installed\n" +"-------------------------\n" +" 1.5.0SVN\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_version.xml:486 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_version.xml:492 +#, no-c-format +msgid "PostGIS_Scripts_Released" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:494 +#, no-c-format +msgid "" +"Returns the version number of the postgis.sql script released " +"with the installed postgis lib." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:500 +#, no-c-format +msgid "" +"text PostGIS_Scripts_Released " +"" +msgstr "" + +#. Tag: para +#: reference_version.xml:511 +#, no-c-format +msgid "" +"Returns the version number of the postgis.sql script released with the " +"installed postgis lib." +msgstr "" + +#. Tag: para +#: reference_version.xml:515 +#, no-c-format +msgid "" +"Starting with version 1.1.0 this function returns the same value of . Kept for backward compatibility." +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:526 +#, no-c-format +msgid "" +"SELECT PostGIS_Scripts_Released();\n" +" postgis_scripts_released\n" +"-------------------------\n" +" 1.3.4SVN\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_version.xml:532 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_version.xml:538 +#, no-c-format +msgid "PostGIS_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_version.xml:540 +#, no-c-format +msgid "" +"Returns PostGIS version number and compile-time options." +msgstr "" + +#. Tag: funcprototype +#: reference_version.xml:546 +#, no-c-format +msgid "" +"text PostGIS_Version " +msgstr "" + +#. Tag: para +#: reference_version.xml:557 +#, no-c-format +msgid "Returns PostGIS version number and compile-time options." +msgstr "" + +#. Tag: programlisting +#: reference_version.xml:563 +#, 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_version.xml:569 +#, no-c-format +msgid "" +", , , , " +msgstr "" diff --git a/doc/po/templates/release_notes.xml.pot b/doc/po/templates/release_notes.xml.pot index 3bff3c3d5..cf8c3fc68 100644 --- a/doc/po/templates/release_notes.xml.pot +++ b/doc/po/templates/release_notes.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-09-16 19:07+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -29,198 +29,350 @@ msgstr "" #. Tag: title #: release_notes.xml:6 #, no-c-format -msgid "Release 2.5.0rc1" +msgid "Release 3.0.0alpha3" msgstr "" #. Tag: para #: release_notes.xml:7 #, no-c-format -msgid "Release date: 2018/08/19" +msgid "Release date: 2019/07/01" msgstr "" -#. Tag: title -#: release_notes.xml:9 release_notes.xml:185 release_notes.xml:329 -#: release_notes.xml:394 release_notes.xml:416 release_notes.xml:452 -#: release_notes.xml:793 release_notes.xml:1252 release_notes.xml:1452 -#: release_notes.xml:1516 release_notes.xml:1813 +#. Tag: para +#: release_notes.xml:8 release_notes.xml:36 release_notes.xml:55 +#: release_notes.xml:69 #, no-c-format -msgid "New Features" +msgid "If compiling with PostgreSQL+JIT, LLVM >= 6 is required" msgstr "" #. Tag: para -#: release_notes.xml:10 +#: release_notes.xml:9 release_notes.xml:37 release_notes.xml:56 #, no-c-format msgid "" -"#1847, spgist 2d and 3d support for PG 11+ (Esteban Zimányi and Arthur " -"Lesuisse from Université Libre de Bruxelles (ULB), Darafei Praliaskouski)" +"Supported PostgreSQL versions for this release are: PostgreSQL 9.5 - " +"PostgreSQL 12 GEOS >= 3.6" msgstr "" -#. Tag: para -#: release_notes.xml:13 +#. Tag: title +#: release_notes.xml:13 release_notes.xml:41 #, no-c-format -msgid "#4056, ST_FilterByM (Nicklas Avén)" +msgid "Major highlights" msgstr "" #. Tag: para #: release_notes.xml:14 #, no-c-format -msgid "#4050, ST_ChaikinSmoothing (Nicklas Avén)" +msgid "4414, Include version number in address_standardizer lib (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:15 #, no-c-format -msgid "#3989, ST_Buffer single sided option (Stephen Knox)" +msgid "4352, Use CREATE OR REPLACE AGGREGATE for PG12+ (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:16 #, no-c-format -msgid "#3876, ST_Angle function (Rémi Cura)" +msgid "4334, Fix upgrade issues related to renamed parameters (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:17 #, no-c-format -msgid "#3564, ST_LineInterpolatePoints (Dan Baston)" +msgid "" +"4388, AddRasterConstraints: Ignore NULLs when generating constraints (Raúl " +"Marín)" msgstr "" #. Tag: para #: release_notes.xml:18 #, no-c-format -msgid "#3896, PostGIS_Extensions_Upgrade() (Regina Obe)" +msgid "4327, Avoid pfree'ing the result of getenv (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:19 #, no-c-format -msgid "" -"#3913, Upgrade when creating extension from unpackaged (Sandro Santilli)" +msgid "4406, Throw on invalid characters when decoding geohash (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:20 #, no-c-format -msgid "#2256, _postgis_index_extent() for extent from index (Paul Ramsey)" +msgid "4429, Avoid resource leaks with PROJ6 (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:21 #, no-c-format -msgid "#3176, Add ST_OrientedEnvelope (Dan Baston)" +msgid "4372, PROJ6: Speed improvements (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:22 #, no-c-format -msgid "#4029, Add ST_QuantizeCoordinates (Dan Baston)" +msgid "3437, Speed up ST_Intersects with Points (Raúl Marín)" msgstr "" #. Tag: para #: release_notes.xml:23 #, no-c-format -msgid "#4063, Optional false origin point for ST_Scale (Paul Ramsey)" +msgid "4438, Update serialization to support extended flags area (Paul Ramsey)" msgstr "" #. Tag: para #: release_notes.xml:24 #, no-c-format -msgid "" -"#4082, Add ST_BandFileSize and ST_BandFileTimestamp, extend ST_BandMetadata " -"(Even Rouault)" +msgid "4443, Fix wagyu configure dropping CPPFLAGS (Raúl Marín)" msgstr "" #. Tag: para -#: release_notes.xml:26 +#: release_notes.xml:25 #, no-c-format -msgid "#2597, Add ST_Grayscale (Bborie Park)" +msgid "4440, Type lookups in FDW fail (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:27 +#: release_notes.xml:26 #, no-c-format -msgid "#4007, Add ST_SetBandPath (Bborie Park)" +msgid "" +"4442, raster2pgsql now skips NODATA tiles. Use -k option if you still want " +"them in database for some reason. (Darafei Praliaskouski)" msgstr "" #. Tag: para #: release_notes.xml:28 #, no-c-format -msgid "#4008, Add ST_SetBandIndex (Bborie Park)" +msgid "" +"4441, Make GiST penalty friendly to multi-column indexes and build single-" +"column ones faster. (Darafei Praliaskouski)" msgstr "" #. Tag: title -#: release_notes.xml:32 release_notes.xml:233 +#: release_notes.xml:34 #, no-c-format -msgid "Breaking Changes" +msgid "Release 3.0.0alpha2" msgstr "" #. Tag: para -#: release_notes.xml:33 +#: release_notes.xml:35 #, no-c-format -msgid "#4054, ST_SimplifyVW changed from > tolerance to >= tolerance" +msgid "Release date: 2019/06/02" msgstr "" #. Tag: para -#: release_notes.xml:34 +#: release_notes.xml:42 +#, no-c-format +msgid "#4404, Fix selectivity issue with support functions (Paul Ramsey)" +msgstr "" + +#. Tag: para +#: release_notes.xml:43 #, no-c-format msgid "" -"#3885, version number removed from address_standardize lib file (Regina Obe)" +"#4311, Make wagyu the default option to validate polygons. This option " +"requires a C++11 compiler and will use CXXFLAGS (not CFLAGS). It is only " +"enabled if built with MVT support (protobuf) Add `--without-wagyu` to " +"disable this option and keep the behaviour from 2.5 (Raúl Marín)" msgstr "" #. Tag: para -#: release_notes.xml:36 +#: release_notes.xml:48 #, no-c-format msgid "" -"#3893, raster support functions can only be loaded in the same schema with " -"core PostGIS functions." +"#4198, Add ST_ConstrainedDelaunayTriangles SFCGAL function (Darafei " +"Praliaskouski)" +msgstr "" + +#. Tag: title +#: release_notes.xml:53 +#, no-c-format +msgid "Release 3.0.0alpha1" msgstr "" #. Tag: para -#: release_notes.xml:38 +#: release_notes.xml:54 #, no-c-format -msgid "#4035, remove dummy pgis_abs type from aggregate/collect routines." +msgid "Release date: 2019/05/26" +msgstr "" + +#. Tag: title +#: release_notes.xml:60 release_notes.xml:74 release_notes.xml:262 +#: release_notes.xml:406 release_notes.xml:471 release_notes.xml:493 +#: release_notes.xml:529 release_notes.xml:870 release_notes.xml:1329 +#: release_notes.xml:1529 release_notes.xml:1593 release_notes.xml:1890 +#, no-c-format +msgid "New Features" +msgstr "" + +#. Tag: para +#: release_notes.xml:61 +#, no-c-format +msgid "additional features enabled if you are running Proj6+" msgstr "" #. Tag: para -#: release_notes.xml:39 +#: release_notes.xml:62 +#, no-c-format +msgid "Read the NEWS file in the included tarball for more details" +msgstr "" + +#. Tag: title +#: release_notes.xml:67 +#, no-c-format +msgid "Release 2.5.0" +msgstr "" + +#. Tag: para +#: release_notes.xml:68 +#, no-c-format +msgid "Release date: 2018/09/23" +msgstr "" + +#. Tag: para +#: release_notes.xml:70 +#, no-c-format +msgid "" +"Supported PostgreSQL versions for this release are: PostgreSQL 9.4 - " +"PostgreSQL 12 (in development) GEOS >= 3.5" +msgstr "" + +#. Tag: para +#: release_notes.xml:75 #, no-c-format msgid "" -"#4069, drop support for GEOS < 3.5 and PostgreSQL < 9.4 (Regina Obe)" +"#1847, spgist 2d and 3d support for PG 11+ (Esteban Zimányi and Arthur " +"Lesuisse from Université Libre de Bruxelles (ULB), Darafei Praliaskouski)" +msgstr "" + +#. Tag: para +#: release_notes.xml:78 +#, no-c-format +msgid "#4056, ST_FilterByM (Nicklas Avén)" +msgstr "" + +#. Tag: para +#: release_notes.xml:79 +#, no-c-format +msgid "#4050, ST_ChaikinSmoothing (Nicklas Avén)" +msgstr "" + +#. Tag: para +#: release_notes.xml:80 +#, no-c-format +msgid "#3989, ST_Buffer single sided option (Stephen Knox)" msgstr "" #. Tag: para -#: release_notes.xml:40 +#: release_notes.xml:81 +#, no-c-format +msgid "#3876, ST_Angle function (Rémi Cura)" +msgstr "" + +#. Tag: para +#: release_notes.xml:82 +#, no-c-format +msgid "#3564, ST_LineInterpolatePoints (Dan Baston)" +msgstr "" + +#. Tag: para +#: release_notes.xml:83 +#, no-c-format +msgid "#3896, PostGIS_Extensions_Upgrade() (Regina Obe)" +msgstr "" + +#. Tag: para +#: release_notes.xml:84 #, no-c-format msgid "" -"#4082, ST_BandMetaData extended to include filesize, timestamp (Even Rouault)" +"#3913, Upgrade when creating extension from unpackaged (Sandro Santilli)" +msgstr "" + +#. Tag: para +#: release_notes.xml:85 +#, no-c-format +msgid "#2256, _postgis_index_extent() for extent from index (Paul Ramsey)" +msgstr "" + +#. Tag: para +#: release_notes.xml:86 +#, no-c-format +msgid "#3176, Add ST_OrientedEnvelope (Dan Baston)" +msgstr "" + +#. Tag: para +#: release_notes.xml:87 +#, no-c-format +msgid "#4029, Add ST_QuantizeCoordinates (Dan Baston)" +msgstr "" + +#. Tag: para +#: release_notes.xml:88 +#, no-c-format +msgid "#4063, Optional false origin point for ST_Scale (Paul Ramsey)" +msgstr "" + +#. Tag: para +#: release_notes.xml:89 +#, no-c-format +msgid "" +"#4082, Add ST_BandFileSize and ST_BandFileTimestamp, extend ST_BandMetadata " +"(Even Rouault)" +msgstr "" + +#. Tag: para +#: release_notes.xml:91 +#, no-c-format +msgid "#2597, Add ST_Grayscale (Bborie Park)" +msgstr "" + +#. Tag: para +#: release_notes.xml:92 +#, no-c-format +msgid "#4007, Add ST_SetBandPath (Bborie Park)" +msgstr "" + +#. Tag: para +#: release_notes.xml:93 +#, no-c-format +msgid "#4008, Add ST_SetBandIndex (Bborie Park)" msgstr "" #. Tag: title -#: release_notes.xml:43 release_notes.xml:208 +#: release_notes.xml:97 release_notes.xml:310 #, no-c-format -msgid "Enhancements and Fixes" +msgid "Breaking Changes" msgstr "" #. Tag: para -#: release_notes.xml:44 +#: release_notes.xml:98 +#, no-c-format +msgid "" +"Upgrade scripts from multiple old versions are now all symlinks to a single " +"upgrade script (Sandro Santilli)" +msgstr "" + +#. Tag: para +#: release_notes.xml:100 #, no-c-format msgid "#3944, Update to EPSG register v9.2 (Even Rouault)" msgstr "" #. Tag: para -#: release_notes.xml:45 +#: release_notes.xml:101 #, no-c-format msgid "#3927, Parallel implementation of ST_AsMVT" msgstr "" #. Tag: para -#: release_notes.xml:46 +#: release_notes.xml:102 #, no-c-format msgid "#3925, Simplify geometry using map grid cell size before generating MVT" msgstr "" #. Tag: para -#: release_notes.xml:47 +#: release_notes.xml:103 #, no-c-format msgid "" "#3899, BTree sort order is now defined on collections of EMPTY and same-" @@ -228,7 +380,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:49 +#: release_notes.xml:105 #, no-c-format msgid "" "#3864, Performance improvement for sorting POINT geometries (Darafei " @@ -236,78 +388,58 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:51 -#, no-c-format -msgid "" -"#3900, GCC warnings fixed, make -j is now working (Darafei Praliaskouski)" -msgstr "" - -#. Tag: para -#: release_notes.xml:52 +#: release_notes.xml:107 #, no-c-format msgid "" +"#3900, GCC warnings fixed, make -j is now working (Darafei Praliaskouski) - " "TopoGeo_addLinestring robustness improvements (Sandro Santilli) #1855, " "#1946, #3718, #3838" msgstr "" #. Tag: para -#: release_notes.xml:54 +#: release_notes.xml:110 #, no-c-format msgid "#3234, Do not accept EMPTY points as topology nodes (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:55 +#: release_notes.xml:111 #, no-c-format msgid "" "#1014, Hashable geometry, allowing direct use in CTE signatures (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:56 +#: release_notes.xml:112 #, no-c-format msgid "#3097, Really allow MULTILINESTRING blades in ST_Split() (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:57 release_notes.xml:101 +#: release_notes.xml:113 #, no-c-format msgid "" -"#3942, geojson: Do not include private header for json-c >= 0.13 (Björn " +"#3942, geojson: Do not include private header for json-c >= 0.13 (Björn " "Esser)" msgstr "" #. Tag: para -#: release_notes.xml:58 +#: release_notes.xml:114 #, no-c-format msgid "" "#3954, ST_GeometricMedian now supports point weights (Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:59 release_notes.xml:137 +#: release_notes.xml:115 #, no-c-format msgid "" -"#3965, ST_ClusterKMeans used to lose some clusters on initialization " -"(Darafei Praliaskouski)" +"#3965, #3971, #3977, #4071 ST_ClusterKMeans rewritten: better " +"initialization, faster convergence, K=2 even faster (Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:61 -#, no-c-format -msgid "" -"#3971, ST_ClusterKMeans now uses better initial seed (Darafei Praliaskouski)" -msgstr "" - -#. Tag: para -#: release_notes.xml:62 -#, no-c-format -msgid "" -"#3977, ST_ClusterKMeans is now faster and simpler (Darafei Praliaskouski)" -msgstr "" - -#. Tag: para -#: release_notes.xml:63 release_notes.xml:140 +#: release_notes.xml:117 release_notes.xml:217 #, no-c-format msgid "" "#3982, ST_AsEncodedPolyline supports LINESTRING EMPTY and MULTIPOINT EMPTY " @@ -315,7 +447,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:65 +#: release_notes.xml:119 #, no-c-format msgid "" "#3986, ST_AsText now has second argument to limit decimal digits (Marc " @@ -323,7 +455,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:67 release_notes.xml:109 +#: release_notes.xml:121 release_notes.xml:186 #, no-c-format msgid "" "#4020, Casting from box3d to geometry now returns correctly connected " @@ -331,14 +463,14 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:69 +#: release_notes.xml:123 #, no-c-format msgid "" "#2508, ST_OffsetCurve now works with collections (Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:70 +#: release_notes.xml:124 #, no-c-format msgid "" "#4006, ST_GeomFromGeoJSON support for json and jsonb as input (Paul Ramsey, " @@ -346,130 +478,236 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:72 +#: release_notes.xml:126 #, no-c-format msgid "" -"#4037, Invalid input geometry is fixed with MakeValid for GEOS exceptions in " -"ST_Intersection, ST_Union, ST_Difference, ST_SymDifference (Darafei " -"Praliaskouski)" +"#4038, ST_Subdivide now selects pivot for geometry split that reuses input " +"vertices. (Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:75 +#: release_notes.xml:128 #, no-c-format msgid "" -"#4038, ST_Subdivide now selects pivot for geometry split that reuses input " -"vertices. ST_ClipByBox2D is stubbed with ST_Intersection because of " -"robustness issues. (Darafei Praliaskouski)" +"#4025, #4032 Fixed precision issue in ST_ClosestPointOfApproach, " +"ST_DistanceCPA, and ST_CPAWithin (Paul Ramsey, Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:78 +#: release_notes.xml:130 #, no-c-format -msgid "" -"#4025, #4032 Fixed precision issue in ST_ClosestPointOfApproach, " -"ST_DistanceCPA, and ST_CPAWithin (Paul Ramsey, Darafei Praliaskouski)" +msgid "#4076, Reduce use of GEOS in topology implementation (Björn Harrtell)" msgstr "" #. Tag: para -#: release_notes.xml:80 +#: release_notes.xml:131 #, no-c-format msgid "" -"#4071, ST_ClusterKMeans crash on NULL/EMPTY fixed (Darafei Praliaskouski)" +"#4080, Add external raster band index to ST_BandMetaData - Add Raster Tips " +"section to Documentation for information about Raster behavior (e.g. Out-DB " +"performance, maximum open files)" msgstr "" #. Tag: para -#: release_notes.xml:81 +#: release_notes.xml:134 #, no-c-format -msgid "#4076, Reduce use of GEOS in topology implementation (Björn Harrtell)" +msgid "" +"#4084: Fixed wrong code-comment regarding front/back of BOX3D (Matthias Bay)" msgstr "" #. Tag: para -#: release_notes.xml:82 +#: release_notes.xml:135 #, no-c-format -msgid "#4080, Add external raster band index to ST_BandMetaData" +msgid "#4060, #4094, PostgreSQL JIT support (Raúl Marín, Laurenz Albe)" msgstr "" #. Tag: para -#: release_notes.xml:83 +#: release_notes.xml:136 #, no-c-format -msgid "" -"Add Raster Tips section to Documentation for information about Raster " -"behavior (e.g. Out-DB performance, maximum open files)" +msgid "#3960, ST_Centroid now uses lwgeom_centroid (Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:85 +#: release_notes.xml:137 #, no-c-format msgid "" -"#4084: Fixed wrong code-comment regarding front/back of BOX3D (Matthias Bay)" +"#4027, Remove duplicated code in lwgeom_geos (Darafei Praliaskouski, Daniel " +"Baston)" msgstr "" #. Tag: para -#: release_notes.xml:86 +#: release_notes.xml:139 #, no-c-format -msgid "#4060, #4094, PostgreSQL JIT support (Raúl Marín, Laurenz Albe)" +msgid "" +"#4115, Fix a bug that created MVTs with incorrect property values under " +"parallel plans (Raúl Marín)." msgstr "" #. Tag: para -#: release_notes.xml:87 +#: release_notes.xml:141 #, no-c-format msgid "#4120, ST_AsMVTGeom: Clip using tile coordinates (Raúl Marín)." msgstr "" #. Tag: para -#: release_notes.xml:88 +#: release_notes.xml:142 #, no-c-format -msgid "#4145, Speedup MVT column parsing (Raúl Marín)" +msgid "" +"#4132, ST_Intersection on Raster now works without throwing " +"TopologyException (Vinícius A.B. Schmidt, Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:89 +#: release_notes.xml:144 #, no-c-format -msgid "#4146, Fix compilation error against Postgres 12 (Raúl Marín)." +msgid "" +"#4177, #4180 Support for PostgreSQL 12 dev branch (Laurenz Albe, Raúl Marín)" msgstr "" #. Tag: para -#: release_notes.xml:90 +#: release_notes.xml:145 #, no-c-format -msgid "#4147, #4148, Honor SOURCE_DATE_EPOCH when present (Christoph Berg)" +msgid "" +"#4156, ST_ChaikinSmoothing: also smooth start/end point of polygon by " +"default (Darafei Praliaskouski)" msgstr "" #. Tag: title -#: release_notes.xml:95 +#: release_notes.xml:151 #, no-c-format -msgid "Release 2.4.4" +msgid "Release 2.4.5" msgstr "" #. Tag: para -#: release_notes.xml:96 +#: release_notes.xml:152 #, no-c-format -msgid "Release date: 2018/04/08" +msgid "Release date: 2018/09/12" msgstr "" #. Tag: para -#: release_notes.xml:97 release_notes.xml:129 release_notes.xml:150 -#: release_notes.xml:162 release_notes.xml:255 release_notes.xml:279 -#: release_notes.xml:293 release_notes.xml:392 release_notes.xml:413 -#: release_notes.xml:557 release_notes.xml:583 release_notes.xml:604 +#: release_notes.xml:153 release_notes.xml:174 release_notes.xml:206 +#: release_notes.xml:227 release_notes.xml:239 release_notes.xml:332 +#: release_notes.xml:356 release_notes.xml:370 release_notes.xml:469 +#: release_notes.xml:490 release_notes.xml:634 release_notes.xml:660 +#: release_notes.xml:681 #, no-c-format msgid "This is a bug fix and performance improvement release." msgstr "" #. Tag: title -#: release_notes.xml:98 release_notes.xml:370 release_notes.xml:530 -#: release_notes.xml:547 release_notes.xml:565 release_notes.xml:589 -#: release_notes.xml:617 release_notes.xml:678 release_notes.xml:689 -#: release_notes.xml:730 release_notes.xml:986 release_notes.xml:1012 -#: release_notes.xml:1054 release_notes.xml:1078 release_notes.xml:1141 -#: release_notes.xml:1296 release_notes.xml:1310 release_notes.xml:1348 -#: release_notes.xml:1386 release_notes.xml:1417 +#: release_notes.xml:154 release_notes.xml:175 release_notes.xml:447 +#: release_notes.xml:607 release_notes.xml:624 release_notes.xml:642 +#: release_notes.xml:666 release_notes.xml:694 release_notes.xml:755 +#: release_notes.xml:766 release_notes.xml:807 release_notes.xml:1063 +#: release_notes.xml:1089 release_notes.xml:1131 release_notes.xml:1155 +#: release_notes.xml:1218 release_notes.xml:1373 release_notes.xml:1387 +#: release_notes.xml:1425 release_notes.xml:1463 release_notes.xml:1494 #, no-c-format msgid "Bug Fixes" msgstr "" #. Tag: para -#: release_notes.xml:99 +#: release_notes.xml:155 +#, no-c-format +msgid "" +"#4031, Survive to big MaxError tolerances passed to ST_CurveToLine (Sandro " +"Santilli)" +msgstr "" + +#. Tag: para +#: release_notes.xml:156 +#, no-c-format +msgid "" +"#4058, Fix infinite loop in linearization of a big radius small arc (Sandro " +"Santilli)" +msgstr "" + +#. Tag: para +#: release_notes.xml:157 +#, no-c-format +msgid "" +"#4071, ST_ClusterKMeans crash on NULL/EMPTY fixed (Darafei Praliaskouski)" +msgstr "" + +#. Tag: para +#: release_notes.xml:158 +#, no-c-format +msgid "#4079, ensure St_AsMVTGeom outputs CW oriented polygons (Paul Ramsey)" +msgstr "" + +#. Tag: para +#: release_notes.xml:159 +#, no-c-format +msgid "" +"#4070, use standard interruption error code on GEOS interruptions (Paul " +"Ramsey)" +msgstr "" + +#. Tag: para +#: release_notes.xml:160 +#, no-c-format +msgid "#3980, delay freeing input until processing complete (lucasvr)" +msgstr "" + +#. Tag: para +#: release_notes.xml:161 +#, no-c-format +msgid "#4090, PG 11 support (Paul Ramsey, Raúl Marín)" +msgstr "" + +#. Tag: para +#: release_notes.xml:162 +#, no-c-format +msgid "" +"#4077, Serialization failure for particular empty geometry cases (Paul " +"Ramsey)" +msgstr "" + +#. Tag: para +#: release_notes.xml:163 +#, no-c-format +msgid "#3997, fix bug in lwgeom_median and avoid division by zero (Raúl Marín)" +msgstr "" + +#. Tag: para +#: release_notes.xml:164 +#, no-c-format +msgid "#4093, Inconsistent results from qsort callback (yugr)" +msgstr "" + +#. Tag: para +#: release_notes.xml:165 +#, no-c-format +msgid "#4081, Geography DWithin() issues for certain cases (Paul Ramsey)" +msgstr "" + +#. Tag: para +#: release_notes.xml:166 +#, no-c-format +msgid "#4105, Parallel build of tarball (Bas Couwenberg)" +msgstr "" + +#. Tag: para +#: release_notes.xml:167 +#, no-c-format +msgid "" +"#4163, MVT: Fix resource leak when the first geometry is NULL (Raúl Marín)" +msgstr "" + +#. Tag: title +#: release_notes.xml:172 +#, no-c-format +msgid "Release 2.4.4" +msgstr "" + +#. Tag: para +#: release_notes.xml:173 +#, no-c-format +msgid "Release date: 2018/04/08" +msgstr "" + +#. Tag: para +#: release_notes.xml:176 #, no-c-format msgid "" "#3055, [raster] ST_Clip() on a raster without band crashes the server " @@ -477,45 +715,53 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:103 +#: release_notes.xml:178 +#, no-c-format +msgid "" +"#3942, geojson: Do not include private header for json-c >= 0.13 (Björn " +"Esser)" +msgstr "" + +#. Tag: para +#: release_notes.xml:180 #, no-c-format msgid "#3952, ST_Transform fails in parallel mode (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:104 +#: release_notes.xml:181 #, no-c-format msgid "#3978, Fix KNN when upgrading from 2.1 or older (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:105 +#: release_notes.xml:182 #, no-c-format msgid "" "#4003, lwpoly_construct_circle: Avoid division by zero (Raúl Marín Rodríguez)" msgstr "" #. Tag: para -#: release_notes.xml:106 +#: release_notes.xml:183 #, no-c-format msgid "" "#4004, Avoid memory exhaustion when building a btree index (Edmund Horner)" msgstr "" #. Tag: para -#: release_notes.xml:107 +#: release_notes.xml:184 #, no-c-format msgid "#4016, proj 5.0.0 support (Raúl Marín Rodríguez)" msgstr "" #. Tag: para -#: release_notes.xml:108 +#: release_notes.xml:185 #, no-c-format msgid "#4017, lwgeom lexer memory corruption (Peter E)" msgstr "" #. Tag: para -#: release_notes.xml:111 +#: release_notes.xml:188 #, no-c-format msgid "" "#4025, #4032 Incorrect answers for temporally \"almost overlapping\" ranges " @@ -523,35 +769,35 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:113 +#: release_notes.xml:190 #, no-c-format msgid "#4052, schema qualify several functions in geography (Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:114 +#: release_notes.xml:191 #, no-c-format msgid "#4055, ST_ClusterIntersecting drops SRID (Daniel Baston)" msgstr "" #. Tag: title -#: release_notes.xml:117 release_notes.xml:502 release_notes.xml:559 -#: release_notes.xml:585 release_notes.xml:606 release_notes.xml:715 -#: release_notes.xml:743 release_notes.xml:862 release_notes.xml:1040 -#: release_notes.xml:1068 release_notes.xml:1127 release_notes.xml:1189 -#: release_notes.xml:1279 release_notes.xml:1480 release_notes.xml:1535 +#: release_notes.xml:194 release_notes.xml:579 release_notes.xml:636 +#: release_notes.xml:662 release_notes.xml:683 release_notes.xml:792 +#: release_notes.xml:820 release_notes.xml:939 release_notes.xml:1117 +#: release_notes.xml:1145 release_notes.xml:1204 release_notes.xml:1266 +#: release_notes.xml:1356 release_notes.xml:1557 release_notes.xml:1612 #, no-c-format msgid "Enhancements" msgstr "" #. Tag: para -#: release_notes.xml:118 +#: release_notes.xml:195 #, no-c-format msgid "#3946, Compile support for PgSQL 11 (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:119 +#: release_notes.xml:196 #, no-c-format msgid "" "#3992, Use PKG_PROG_PKG_CONFIG macro from pkg.m4 to detect pkg-config (Bas " @@ -559,38 +805,38 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:121 +#: release_notes.xml:198 #, no-c-format msgid "#4044, Upgrade support for PgSQL 11 (Regina Obe)" msgstr "" #. Tag: title -#: release_notes.xml:127 +#: release_notes.xml:204 #, no-c-format msgid "Release 2.4.3" msgstr "" #. Tag: para -#: release_notes.xml:128 +#: release_notes.xml:205 #, no-c-format msgid "Release date: 2018/01/17" msgstr "" #. Tag: title -#: release_notes.xml:131 release_notes.xml:152 release_notes.xml:164 -#: release_notes.xml:257 release_notes.xml:281 release_notes.xml:295 +#: release_notes.xml:208 release_notes.xml:229 release_notes.xml:241 +#: release_notes.xml:334 release_notes.xml:358 release_notes.xml:372 #, no-c-format msgid "Bug Fixes and Enhancements" msgstr "" #. Tag: para -#: release_notes.xml:132 +#: release_notes.xml:209 #, no-c-format msgid "#3713, Support encodings that happen to output a '\\' character" msgstr "" #. Tag: para -#: release_notes.xml:133 +#: release_notes.xml:210 #, no-c-format msgid "" "#3827, Set configure default to not do interrupt testing, was causing false " @@ -599,19 +845,27 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:136 +#: release_notes.xml:213 #, no-c-format msgid "#3930, Minimum bounding circle issues on 32-bit platforms" msgstr "" #. Tag: para -#: release_notes.xml:139 +#: release_notes.xml:214 +#, no-c-format +msgid "" +"#3965, ST_ClusterKMeans used to lose some clusters on initialization " +"(Darafei Praliaskouski)" +msgstr "" + +#. Tag: para +#: release_notes.xml:216 #, no-c-format msgid "#3956, Brin opclass object does not upgrade properly (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:142 +#: release_notes.xml:219 #, no-c-format msgid "" "#3975, ST_Transform runs query on spatial_ref_sys without schema " @@ -619,133 +873,133 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:148 +#: release_notes.xml:225 #, no-c-format msgid "Release 2.4.2" msgstr "" #. Tag: para -#: release_notes.xml:149 +#: release_notes.xml:226 #, no-c-format msgid "Release date: 2017/11/15" msgstr "" #. Tag: para -#: release_notes.xml:153 +#: release_notes.xml:230 #, no-c-format msgid "#3917, Fix zcta5 load" msgstr "" #. Tag: para -#: release_notes.xml:154 +#: release_notes.xml:231 #, no-c-format msgid "#3667, Fix for bug in geography ST_Segmentize" msgstr "" #. Tag: para -#: release_notes.xml:155 +#: release_notes.xml:232 #, no-c-format msgid "#3926, Add missing 2.2.6 and 2.3.4 upgrade paths (Muhammad Usama)" msgstr "" #. Tag: title -#: release_notes.xml:160 +#: release_notes.xml:237 #, no-c-format msgid "Release 2.4.1" msgstr "" #. Tag: para -#: release_notes.xml:161 +#: release_notes.xml:238 #, no-c-format msgid "Release date: 2017/10/18" msgstr "" #. Tag: para -#: release_notes.xml:165 +#: release_notes.xml:242 #, no-c-format msgid "#3864, Fix memory leaks in BTREE operators" msgstr "" #. Tag: para -#: release_notes.xml:166 +#: release_notes.xml:243 #, no-c-format msgid "#3869, Fix build with \"gold\" linker" msgstr "" #. Tag: para -#: release_notes.xml:167 +#: release_notes.xml:244 #, no-c-format msgid "#3845, Gracefully handle short-measure issue" msgstr "" #. Tag: para -#: release_notes.xml:168 +#: release_notes.xml:245 #, no-c-format msgid "#3871, Performance tweak for geometry cmp function" msgstr "" #. Tag: para -#: release_notes.xml:169 +#: release_notes.xml:246 #, no-c-format msgid "#3879, Division by zero in some arc cases" msgstr "" #. Tag: para -#: release_notes.xml:170 +#: release_notes.xml:247 #, no-c-format msgid "#3878, Single defn of signum in header" msgstr "" #. Tag: para -#: release_notes.xml:171 +#: release_notes.xml:248 #, no-c-format msgid "#3880, Undefined behaviour in TYPMOD_GET_SRID" msgstr "" #. Tag: para -#: release_notes.xml:172 +#: release_notes.xml:249 #, no-c-format msgid "#3875, Fix undefined behaviour in shift operation" msgstr "" #. Tag: para -#: release_notes.xml:173 +#: release_notes.xml:250 #, no-c-format msgid "#3864, Performance improvements for b-tree geometry sorts" msgstr "" #. Tag: para -#: release_notes.xml:174 +#: release_notes.xml:251 #, no-c-format msgid "#3874, lw_dist2d_pt_arc division by zero" msgstr "" #. Tag: para -#: release_notes.xml:175 +#: release_notes.xml:252 #, no-c-format msgid "#3882, undefined behaviour in zigzag with negative inputs" msgstr "" #. Tag: para -#: release_notes.xml:176 +#: release_notes.xml:253 #, no-c-format msgid "#3891, undefined behaviour in pointarray_to_encoded_polyline" msgstr "" #. Tag: para -#: release_notes.xml:177 +#: release_notes.xml:254 #, no-c-format msgid "#3895, throw error on malformed WKB input" msgstr "" #. Tag: para -#: release_notes.xml:178 +#: release_notes.xml:255 #, no-c-format msgid "#3886, fix rare missing boxes in geometry subdivision" msgstr "" #. Tag: para -#: release_notes.xml:179 +#: release_notes.xml:256 #, no-c-format msgid "" "#3907, Allocate enough space for all possible GBOX string outputs (Raúl " @@ -753,19 +1007,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:183 +#: release_notes.xml:260 #, no-c-format msgid "Release 2.4.0" msgstr "" #. Tag: para -#: release_notes.xml:184 +#: release_notes.xml:261 #, no-c-format msgid "Release date: 2017/09/30" msgstr "" #. Tag: para -#: release_notes.xml:186 +#: release_notes.xml:263 #, no-c-format msgid "" "#3822, Have postgis_full_version() also show and check version of PostgreSQL " @@ -773,19 +1027,19 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:188 +#: release_notes.xml:265 #, no-c-format msgid "#2411, curves support in ST_Reverse (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:189 +#: release_notes.xml:266 #, no-c-format msgid "#2951, ST_Centroid for geography (Danny Götte)" msgstr "" #. Tag: para -#: release_notes.xml:190 +#: release_notes.xml:267 #, no-c-format msgid "" "#3788, Allow postgis_restore.pl to work on directory-style (-Fd) dumps " @@ -793,26 +1047,26 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:192 +#: release_notes.xml:269 #, no-c-format msgid "" "#3772, Direction agnostic ST_CurveToLine output (Sandro Santilli / KKGeo)" msgstr "" #. Tag: para -#: release_notes.xml:193 +#: release_notes.xml:270 #, no-c-format msgid "#2464, ST_CurveToLine with MaxError tolerance (Sandro Santilli / KKGeo)" msgstr "" #. Tag: para -#: release_notes.xml:194 +#: release_notes.xml:271 #, no-c-format msgid "#3599, Geobuf output support via ST_AsGeobuf (Björn Harrtell)" msgstr "" #. Tag: para -#: release_notes.xml:195 +#: release_notes.xml:272 #, no-c-format msgid "" "#3661, Mapbox vector tile output support via ST_AsMVT (Björn Harrtell / " @@ -820,13 +1074,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:196 +#: release_notes.xml:273 #, no-c-format msgid "#3689, Add orientation checking and forcing functions (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:197 +#: release_notes.xml:274 #, no-c-format msgid "" "#3753, Gist penalty speed improvements for 2D and ND points (Darafei " @@ -834,13 +1088,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:199 +#: release_notes.xml:276 #, no-c-format msgid "#3677, ST_FrechetDistance (Shinichi Sugiyama)" msgstr "" #. Tag: para -#: release_notes.xml:200 +#: release_notes.xml:277 #, no-c-format msgid "" "Most aggregates (raster and geometry), and all stable / immutable (raster " @@ -848,27 +1102,33 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:202 +#: release_notes.xml:279 #, no-c-format msgid "#2249, ST_MakeEmptyCoverage for raster (David Zwarg, ainomieli)" msgstr "" #. Tag: para -#: release_notes.xml:203 +#: release_notes.xml:280 #, no-c-format msgid "#3709, Allow signed distance for ST_Project (Darafei Praliaskouski)" msgstr "" #. Tag: para -#: release_notes.xml:204 +#: release_notes.xml:281 #, no-c-format msgid "" "#524, Covers support for polygon on polygon, line on line, point on line for " "geography (Danny Götte)" msgstr "" +#. Tag: title +#: release_notes.xml:285 +#, no-c-format +msgid "Enhancements and Fixes" +msgstr "" + #. Tag: para -#: release_notes.xml:209 +#: release_notes.xml:286 #, no-c-format msgid "" "Many corrections to docs and several translations almost complete. Andreas " @@ -877,25 +1137,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:213 +#: release_notes.xml:290 #, no-c-format msgid "Support for PostgreSQL 10" msgstr "" #. Tag: para -#: release_notes.xml:214 +#: release_notes.xml:291 #, no-c-format msgid "Preliminary support for PostgreSQL 11" msgstr "" #. Tag: para -#: release_notes.xml:215 +#: release_notes.xml:292 #, no-c-format msgid "#3645, Avoid loading logically deleted records from shapefiles" msgstr "" #. Tag: para -#: release_notes.xml:216 +#: release_notes.xml:293 #, no-c-format msgid "" "#3747, Add zip4 and address_alphanumeric as attributes to norm_addy " @@ -903,7 +1163,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:218 +#: release_notes.xml:295 #, no-c-format msgid "" "#3748, address_standardizer lookup tables update so pagc_normalize_address " @@ -911,52 +1171,52 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:220 +#: release_notes.xml:297 #, no-c-format msgid "" "#3647, better handling of noding in ST_Node using GEOSNode (Wouter Geraedts)" msgstr "" #. Tag: para -#: release_notes.xml:222 +#: release_notes.xml:299 #, no-c-format msgid "#3684, Update to EPSG register v9 (Even Rouault)" msgstr "" #. Tag: para -#: release_notes.xml:224 +#: release_notes.xml:301 #, no-c-format msgid "" "#3830, Fix initialization of incompatible type (>=9.6) address_standardizer" msgstr "" #. Tag: para -#: release_notes.xml:225 +#: release_notes.xml:302 #, no-c-format msgid "#3662, Make shp2pgsql work in debug mode by sending debug to stderr" msgstr "" #. Tag: para -#: release_notes.xml:226 +#: release_notes.xml:303 #, no-c-format msgid "#3405, Fixed memory leak in lwgeom_to_points" msgstr "" #. Tag: para -#: release_notes.xml:227 +#: release_notes.xml:304 #, no-c-format msgid "#3832, Support wide integer fields as int8 in shp2pgsql" msgstr "" #. Tag: para -#: release_notes.xml:228 +#: release_notes.xml:305 #, no-c-format msgid "" "#3841, Deterministic sorting support for empty geometries in btree geography" msgstr "" #. Tag: para -#: release_notes.xml:229 +#: release_notes.xml:306 #, no-c-format msgid "" "#3844, Make = operator a strict equality test, and < > to rough " @@ -964,25 +1224,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:230 +#: release_notes.xml:307 #, no-c-format msgid "#3855, ST_AsTWKB memory and speed improvements" msgstr "" #. Tag: para -#: release_notes.xml:234 +#: release_notes.xml:311 #, no-c-format msgid "Dropped support for PostgreSQL 9.2." msgstr "" #. Tag: para -#: release_notes.xml:235 +#: release_notes.xml:312 #, no-c-format msgid "#3810, GEOS 3.4.0 or above minimum required to compile" msgstr "" #. Tag: para -#: release_notes.xml:236 +#: release_notes.xml:313 #, no-c-format msgid "" "Most aggregates now marked as parallel safe, which means most aggs have to " @@ -991,13 +1251,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:240 +#: release_notes.xml:317 #, no-c-format msgid "#3578, ST_NumInteriorRings(POLYGON EMPTY) now returns 0 instead of NULL" msgstr "" #. Tag: para -#: release_notes.xml:241 +#: release_notes.xml:318 #, no-c-format msgid "" "_ST_DumpPoints removed, was no longer needed after PostGIS 2.1.0 when " @@ -1005,7 +1265,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:243 +#: release_notes.xml:320 #, no-c-format msgid "" "B-Tree index operators < = > changed to provide better spatial " @@ -1017,31 +1277,31 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:253 +#: release_notes.xml:330 #, no-c-format msgid "Release 2.3.3" msgstr "" #. Tag: para -#: release_notes.xml:254 +#: release_notes.xml:331 #, no-c-format msgid "Release date: 2017/07/01" msgstr "" #. Tag: para -#: release_notes.xml:258 +#: release_notes.xml:335 #, no-c-format msgid "#3777, GROUP BY anomaly with empty geometries" msgstr "" #. Tag: para -#: release_notes.xml:259 +#: release_notes.xml:336 #, no-c-format msgid "#3711, Azimuth error upon adding 2.5D edges to topology" msgstr "" #. Tag: para -#: release_notes.xml:260 +#: release_notes.xml:337 #, no-c-format msgid "" "#3726, PDF manual from dblatex renders fancy quotes for programlisting (Mike " @@ -1049,7 +1309,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:262 +#: release_notes.xml:339 #, no-c-format msgid "" "#3738, raster: Using -s without -Y in raster2pgsql transforms raster data " @@ -1057,7 +1317,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:264 +#: release_notes.xml:341 #, no-c-format msgid "" "#3744, ST_Subdivide loses subparts of inverted geometries (Darafei " @@ -1065,7 +1325,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:266 +#: release_notes.xml:343 #, no-c-format msgid "" "#3750, @ and ~ operator not always schema qualified in geometry and raster " @@ -1073,63 +1333,63 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:269 +#: release_notes.xml:346 #, no-c-format msgid "#3682, Strange fieldlength for boolean in result of pgsql2shp" msgstr "" #. Tag: para -#: release_notes.xml:270 +#: release_notes.xml:347 #, no-c-format msgid "#3701, Escape double quotes issue in pgsql2shp" msgstr "" #. Tag: para -#: release_notes.xml:271 +#: release_notes.xml:348 #, no-c-format msgid "#3704, ST_AsX3D crashes on empty geometry" msgstr "" #. Tag: para -#: release_notes.xml:272 +#: release_notes.xml:349 #, no-c-format msgid "" "#3730, Change ST_Clip from Error to Notice when ST_Clip can't compute a band" msgstr "" #. Tag: title -#: release_notes.xml:277 +#: release_notes.xml:354 #, no-c-format msgid "Release 2.3.2" msgstr "" #. Tag: para -#: release_notes.xml:278 +#: release_notes.xml:355 #, no-c-format msgid "Release date: 2017/01/31" msgstr "" #. Tag: para -#: release_notes.xml:282 +#: release_notes.xml:359 #, no-c-format msgid "" "#3418, KNN recheck in 9.5+ fails with index returned tuples in wrong order" msgstr "" #. Tag: para -#: release_notes.xml:283 +#: release_notes.xml:360 #, no-c-format msgid "#3675, Relationship functions not using an index in some cases" msgstr "" #. Tag: para -#: release_notes.xml:284 +#: release_notes.xml:361 #, no-c-format msgid "#3680, PostGIS upgrade scripts missing GRANT for views" msgstr "" #. Tag: para -#: release_notes.xml:285 +#: release_notes.xml:362 #, no-c-format msgid "" "#3683, Unable to update postgis after postgres pg_upgrade going from < " @@ -1137,25 +1397,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:286 +#: release_notes.xml:363 #, no-c-format msgid "#3688, ST_AsLatLonText: round minutes" msgstr "" #. Tag: title -#: release_notes.xml:291 +#: release_notes.xml:368 #, no-c-format msgid "Release 2.3.1" msgstr "" #. Tag: para -#: release_notes.xml:292 +#: release_notes.xml:369 #, no-c-format msgid "Release date: 2016/11/28" msgstr "" #. Tag: para -#: release_notes.xml:296 +#: release_notes.xml:373 #, no-c-format msgid "" "#1973, st_concavehull() returns sometimes empty geometry collection Fix from " @@ -1163,7 +1423,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:298 +#: release_notes.xml:375 #, no-c-format msgid "" "#3501, add raster constraint max extent exceeds array size limit for large " @@ -1171,19 +1431,19 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:300 +#: release_notes.xml:377 #, no-c-format msgid "#3643, PostGIS not building on latest OSX XCode" msgstr "" #. Tag: para -#: release_notes.xml:301 +#: release_notes.xml:378 #, no-c-format msgid "#3644, Deadlock on interrupt" msgstr "" #. Tag: para -#: release_notes.xml:302 +#: release_notes.xml:379 #, no-c-format msgid "" "#3650, Mark ST_Extent, ST_3DExtent and ST_Mem* agg functions as parallel " @@ -1191,19 +1451,19 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:304 +#: release_notes.xml:381 #, no-c-format msgid "#3652, Crash on Collection(MultiCurve())" msgstr "" #. Tag: para -#: release_notes.xml:305 +#: release_notes.xml:382 #, no-c-format msgid "#3656, Fix upgrade of aggregates from 2.2 or lower version" msgstr "" #. Tag: para -#: release_notes.xml:306 +#: release_notes.xml:383 #, no-c-format msgid "" "#3659, Crash caused by raster GUC define after CREATE EXTENSION using wrong " @@ -1211,7 +1471,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:308 +#: release_notes.xml:385 #, no-c-format msgid "" "#3665, Index corruption and memory leak in BRIN indexes patch from Julien " @@ -1219,25 +1479,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:310 +#: release_notes.xml:387 #, no-c-format msgid "#3667, geography ST_Segmentize bug patch from Hugo Mercier (Oslandia)" msgstr "" #. Tag: title -#: release_notes.xml:315 +#: release_notes.xml:392 #, no-c-format msgid "Release 2.3.0" msgstr "" #. Tag: para -#: release_notes.xml:316 +#: release_notes.xml:393 #, no-c-format msgid "Release date: 2016/09/26" msgstr "" #. Tag: para -#: release_notes.xml:317 +#: release_notes.xml:394 #, no-c-format msgid "" "This is a new feature release, with new functions, improved performance, all " @@ -1245,13 +1505,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:320 release_notes.xml:756 release_notes.xml:1225 +#: release_notes.xml:397 release_notes.xml:833 release_notes.xml:1302 #, no-c-format msgid "Important / Breaking Changes" msgstr "" #. Tag: para -#: release_notes.xml:321 +#: release_notes.xml:398 #, no-c-format msgid "" "#3466, Casting from box3d to geometry now returns a 3D geometry (Julien " @@ -1259,69 +1519,69 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:323 +#: release_notes.xml:400 #, no-c-format msgid "#3396, ST_EstimatedExtent, throw WARNING instead of ERROR (Regina Obe)" msgstr "" #. Tag: para -#: release_notes.xml:330 +#: release_notes.xml:407 #, no-c-format msgid "" "Add support for custom TOC in postgis_restore.pl (Christoph Moench-Tegeder)" msgstr "" #. Tag: para -#: release_notes.xml:332 +#: release_notes.xml:409 #, no-c-format msgid "" "Add support for negative indexing in ST_PointN and ST_SetPoint (Rémi Cura)" msgstr "" #. Tag: para -#: release_notes.xml:334 +#: release_notes.xml:411 #, no-c-format msgid "Add parameters for geography ST_Buffer (Thomas Bonfort)" msgstr "" #. Tag: para -#: release_notes.xml:335 +#: release_notes.xml:412 #, no-c-format msgid "TopoGeom_addElement, TopoGeom_remElement (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:336 +#: release_notes.xml:413 #, no-c-format msgid "populate_topology_layer (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:337 +#: release_notes.xml:414 #, no-c-format msgid "#454, ST_WrapX and lwgeom_wrapx (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:338 +#: release_notes.xml:415 #, no-c-format msgid "#1758, ST_Normalize (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:339 +#: release_notes.xml:416 #, no-c-format msgid "#2236, shp2pgsql -d now emits \"DROP TABLE IF EXISTS\"" msgstr "" #. Tag: para -#: release_notes.xml:340 +#: release_notes.xml:417 #, no-c-format msgid "#2259, ST_VoronoiPolygons and ST_VoronoiLines (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:341 +#: release_notes.xml:418 #, no-c-format msgid "" "#2841 and #2996, ST_MinimumBoundingRadius and new ST_MinimumBoundingCircle " @@ -1329,37 +1589,37 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:343 +#: release_notes.xml:420 #, no-c-format msgid "#2991, Enable ST_Transform to use PROJ.4 text (Mike Toews)" msgstr "" #. Tag: para -#: release_notes.xml:344 +#: release_notes.xml:421 #, no-c-format msgid "#3059, Allow passing per-dimension parameters in ST_Expand (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:345 +#: release_notes.xml:422 #, no-c-format msgid "#3339, ST_GeneratePoints (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:346 +#: release_notes.xml:423 #, no-c-format msgid "#3362, ST_ClusterDBSCAN (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:347 +#: release_notes.xml:424 #, no-c-format msgid "#3364, ST_GeometricMedian (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:348 +#: release_notes.xml:425 #, no-c-format msgid "" "#3391, Add table inheritance support in ST_EstimatedExtent (Alessandro " @@ -1367,31 +1627,31 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:350 +#: release_notes.xml:427 #, no-c-format msgid "#3424, ST_MinimumClearance (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:351 +#: release_notes.xml:428 #, no-c-format msgid "#3428, ST_Points (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:352 +#: release_notes.xml:429 #, no-c-format msgid "#3465, ST_ClusterKMeans (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:353 +#: release_notes.xml:430 #, no-c-format msgid "#3469, ST_MakeLine with MULTIPOINTs (Paul Norman)" msgstr "" #. Tag: para -#: release_notes.xml:354 +#: release_notes.xml:431 #, no-c-format msgid "" "#3549, Support PgSQL 9.6 parallel query mode, as far as possible (Paul " @@ -1399,13 +1659,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:356 +#: release_notes.xml:433 #, no-c-format msgid "#3557, Geometry function costs based on query stats (Paul Norman)" msgstr "" #. Tag: para -#: release_notes.xml:357 +#: release_notes.xml:434 #, no-c-format msgid "" "#3591, Add support for BRIN indexes. PostgreSQL 9.4+ required. (Giuseppe " @@ -1413,7 +1673,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:360 +#: release_notes.xml:437 #, no-c-format msgid "" "#3496, Make postgis non-relocateable for extension install, schema qualify " @@ -1422,7 +1682,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:363 +#: release_notes.xml:440 #, no-c-format msgid "" "#3547, Update tiger geocoder to support TIGER 2016 and to support both http " @@ -1430,7 +1690,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:365 +#: release_notes.xml:442 #, no-c-format msgid "" "#3613, Segmentize geography using equal length segments (Hugo Mercier of " @@ -1438,19 +1698,19 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:371 +#: release_notes.xml:448 #, no-c-format msgid "All relevant bug fixes from PostGIS 2.2.3" msgstr "" #. Tag: para -#: release_notes.xml:372 +#: release_notes.xml:449 #, no-c-format msgid "#2841, ST_MinimumBoundingCircle not covering original" msgstr "" #. Tag: para -#: release_notes.xml:373 +#: release_notes.xml:450 #, no-c-format msgid "" "#3604, pgcommon/Makefile.in orders CFLAGS incorrectly leading to wrong " @@ -1458,19 +1718,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:378 release_notes.xml:1646 +#: release_notes.xml:455 release_notes.xml:1723 #, no-c-format msgid "Performance Enhancements" msgstr "" #. Tag: para -#: release_notes.xml:379 +#: release_notes.xml:456 #, no-c-format msgid "#75, Enhancement to PIP short circuit (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:380 +#: release_notes.xml:457 #, no-c-format msgid "" "#3383, Avoid deserializing small geometries during index operations (Dan " @@ -1478,43 +1738,43 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:382 +#: release_notes.xml:459 #, no-c-format msgid "#3400, Minor optimization of PIP routines (Dan Baston)" msgstr "" #. Tag: para -#: release_notes.xml:383 +#: release_notes.xml:460 #, no-c-format msgid "Make adding a line to topology interruptible (Sandro Santilli)" msgstr "" #. Tag: para -#: release_notes.xml:384 +#: release_notes.xml:461 #, no-c-format msgid "Documentation updates from Mike Toews" msgstr "" #. Tag: title -#: release_notes.xml:390 +#: release_notes.xml:467 #, no-c-format msgid "Release 2.2.2" msgstr "" #. Tag: para -#: release_notes.xml:391 +#: release_notes.xml:468 #, no-c-format msgid "Release date: 2016/03/22" msgstr "" #. Tag: para -#: release_notes.xml:395 +#: release_notes.xml:472 #, no-c-format msgid "#3463, Fix crash on face-collapsing edge change" msgstr "" #. Tag: para -#: release_notes.xml:396 +#: release_notes.xml:473 #, no-c-format msgid "" "#3422, Improve ST_Split robustness on standard precision double systems " @@ -1522,37 +1782,37 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:397 +#: release_notes.xml:474 #, no-c-format msgid "#3427, Update spatial_ref_sys to EPSG version 8.8" msgstr "" #. Tag: para -#: release_notes.xml:398 +#: release_notes.xml:475 #, no-c-format msgid "#3433, ST_ClusterIntersecting incorrect for MultiPoints" msgstr "" #. Tag: para -#: release_notes.xml:399 +#: release_notes.xml:476 #, no-c-format msgid "#3435, ST_AsX3D fix rendering of concave geometries" msgstr "" #. Tag: para -#: release_notes.xml:400 +#: release_notes.xml:477 #, no-c-format msgid "#3436, memory handling mistake in ptarray_clone_deep" msgstr "" #. Tag: para -#: release_notes.xml:401 +#: release_notes.xml:478 #, no-c-format msgid "#3437, ST_Intersects incorrect for MultiPoints" msgstr "" #. Tag: para -#: release_notes.xml:402 +#: release_notes.xml:479 #, no-c-format msgid "" "#3461, ST_GeomFromKML crashes Postgres when there are innerBoundaryIs and no " @@ -1560,20 +1820,20 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:403 +#: release_notes.xml:480 #, no-c-format msgid "" "#3429, upgrading to 2.3 or from 2.1 can cause loop/hang on some platforms" msgstr "" #. Tag: para -#: release_notes.xml:404 +#: release_notes.xml:481 #, no-c-format msgid "#3460, ST_ClusterWithin 'Tolerance not defined' error after upgrade" msgstr "" #. Tag: para -#: release_notes.xml:405 +#: release_notes.xml:482 #, no-c-format msgid "" "#3490, Raster data restore issues, materialized views. Scripts " @@ -1582,80 +1842,80 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:406 +#: release_notes.xml:483 #, no-c-format msgid "#3426, failing POINT EMPTY tests on fun architectures" msgstr "" #. Tag: title -#: release_notes.xml:411 +#: release_notes.xml:488 #, no-c-format msgid "Release 2.2.1" msgstr "" #. Tag: para -#: release_notes.xml:412 +#: release_notes.xml:489 #, no-c-format msgid "Release date: 2016/01/06" msgstr "" #. Tag: para -#: release_notes.xml:417 +#: release_notes.xml:494 #, no-c-format msgid "#2232, avoid accumulated error in SVG rounding" msgstr "" #. Tag: para -#: release_notes.xml:418 +#: release_notes.xml:495 #, no-c-format msgid "#3321, Fix performance regression in topology loading" msgstr "" #. Tag: para -#: release_notes.xml:419 +#: release_notes.xml:496 #, no-c-format msgid "#3329, Fix robustness regression in TopoGeo_addPoint" msgstr "" #. Tag: para -#: release_notes.xml:420 +#: release_notes.xml:497 #, no-c-format msgid "#3349, Fix installation path of postgis_topology scripts" msgstr "" #. Tag: para -#: release_notes.xml:421 +#: release_notes.xml:498 #, no-c-format msgid "#3351, set endnodes isolation on ST_RemoveIsoEdge (and lwt_RemIsoEdge)" msgstr "" #. Tag: para -#: release_notes.xml:423 +#: release_notes.xml:500 #, no-c-format msgid "#3355, geography ST_Segmentize has geometry bbox" msgstr "" #. Tag: para -#: release_notes.xml:424 +#: release_notes.xml:501 #, no-c-format msgid "" "#3359, Fix toTopoGeom loss of low-id primitives from TopoGeometry definition" msgstr "" #. Tag: para -#: release_notes.xml:426 +#: release_notes.xml:503 #, no-c-format msgid "#3360, _raster_constraint_info_scale invalid input syntax" msgstr "" #. Tag: para -#: release_notes.xml:427 +#: release_notes.xml:504 #, no-c-format msgid "#3375, crash in repeated point removal for collection(point)" msgstr "" #. Tag: para -#: release_notes.xml:428 +#: release_notes.xml:505 #, no-c-format msgid "" "#3378, Fix handling of hierarchical TopoGeometries in presence of multiple " @@ -1663,25 +1923,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:430 +#: release_notes.xml:507 #, no-c-format msgid "#3380, #3402, Decimate lines on topology load" msgstr "" #. Tag: para -#: release_notes.xml:431 +#: release_notes.xml:508 #, no-c-format msgid "#3388, #3410, Fix missing end-points in ST_Removepoints" msgstr "" #. Tag: para -#: release_notes.xml:432 +#: release_notes.xml:509 #, no-c-format msgid "#3389, Buffer overflow in lwgeom_to_geojson" msgstr "" #. Tag: para -#: release_notes.xml:433 +#: release_notes.xml:510 #, no-c-format msgid "" "#3390, Compilation under Alpine Linux 3.2 gives an error when compiling the " @@ -1689,25 +1949,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:435 +#: release_notes.xml:512 #, no-c-format msgid "#3393, ST_Area NaN for some polygons" msgstr "" #. Tag: para -#: release_notes.xml:436 +#: release_notes.xml:513 #, no-c-format msgid "#3401, Improve ST_Split robustness on 32bit systems" msgstr "" #. Tag: para -#: release_notes.xml:437 +#: release_notes.xml:514 #, no-c-format msgid "#3404, ST_ClusterWithin crashes backend" msgstr "" #. Tag: para -#: release_notes.xml:438 +#: release_notes.xml:515 #, no-c-format msgid "" "#3407, Fix crash on splitting a face or an edge defining multiple " @@ -1715,43 +1975,43 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:440 +#: release_notes.xml:517 #, no-c-format msgid "#3411, Clustering functions not using spatial index" msgstr "" #. Tag: para -#: release_notes.xml:441 +#: release_notes.xml:518 #, no-c-format msgid "#3412, Improve robustness of snapping step in TopoGeo_addLinestring" msgstr "" #. Tag: para -#: release_notes.xml:442 +#: release_notes.xml:519 #, no-c-format msgid "#3415, Fix OSX 10.9 build under pkgsrc" msgstr "" #. Tag: para -#: release_notes.xml:443 +#: release_notes.xml:520 #, no-c-format msgid "Fix memory leak in lwt_ChangeEdgeGeom [liblwgeom]" msgstr "" #. Tag: title -#: release_notes.xml:448 +#: release_notes.xml:525 #, no-c-format msgid "Release 2.2.0" msgstr "" #. Tag: para -#: release_notes.xml:449 +#: release_notes.xml:526 #, no-c-format msgid "Release date: 2015/10/07" msgstr "" #. Tag: para -#: release_notes.xml:450 +#: release_notes.xml:527 #, no-c-format msgid "" "This is a new feature release, with new functions, improved performance, and " @@ -1759,31 +2019,31 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:453 +#: release_notes.xml:530 #, no-c-format msgid "Topology API in liblwgeom (Sandro Santilli / Regione Toscana - SITA)" msgstr "" #. Tag: para -#: release_notes.xml:454 +#: release_notes.xml:531 #, no-c-format msgid "New lwgeom_unaryunion method in liblwgeom" msgstr "" #. Tag: para -#: release_notes.xml:455 +#: release_notes.xml:532 #, no-c-format msgid "New lwgeom_linemerge method in liblwgeom" msgstr "" #. Tag: para -#: release_notes.xml:456 +#: release_notes.xml:533 #, no-c-format msgid "New lwgeom_is_simple method in liblwgeom" msgstr "" #. Tag: para -#: release_notes.xml:457 +#: release_notes.xml:534 #, no-c-format msgid "" "#2697, " @@ -2919,7 +3179,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:680 +#: release_notes.xml:757 #, no-c-format msgid "" "#2700, Fix " @@ -2927,7 +3187,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:681 +#: release_notes.xml:758 #, no-c-format msgid "" "#2706, " @@ -2935,19 +3195,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:685 +#: release_notes.xml:762 #, no-c-format msgid "Release 2.1.2" msgstr "" #. Tag: para -#: release_notes.xml:686 release_notes.xml:983 +#: release_notes.xml:763 release_notes.xml:1060 #, no-c-format msgid "Release date: 2014/03/31" msgstr "" #. Tag: para -#: release_notes.xml:687 +#: release_notes.xml:764 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -2955,7 +3215,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:690 +#: release_notes.xml:767 #, no-c-format msgid "" "#2666, " @@ -2963,7 +3223,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:691 +#: release_notes.xml:768 #, no-c-format msgid "" "#2534, " @@ -2971,7 +3231,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:692 +#: release_notes.xml:769 #, no-c-format msgid "" "#2539, " @@ -2979,7 +3239,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:693 +#: release_notes.xml:770 #, no-c-format msgid "" "#2543, " @@ -2987,7 +3247,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:694 +#: release_notes.xml:771 #, no-c-format msgid "" "#2546, " @@ -2995,7 +3255,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:695 +#: release_notes.xml:772 #, no-c-format msgid "" "#2547, Fix " @@ -3003,7 +3263,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:696 release_notes.xml:993 +#: release_notes.xml:773 release_notes.xml:1070 #, no-c-format msgid "" "#2552, Fix " @@ -3011,7 +3271,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:698 release_notes.xml:994 +#: release_notes.xml:775 release_notes.xml:1071 #, no-c-format msgid "" "#2555, Fix " @@ -3019,7 +3279,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:699 +#: release_notes.xml:776 #, no-c-format msgid "" "#2556, " @@ -3027,7 +3287,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:700 +#: release_notes.xml:777 #, no-c-format msgid "" "#2580, Do " @@ -3035,7 +3295,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:701 release_notes.xml:995 +#: release_notes.xml:778 release_notes.xml:1072 #, no-c-format msgid "" "#2589, " @@ -3043,7 +3303,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:702 +#: release_notes.xml:779 #, no-c-format msgid "" "#2607, " @@ -3051,7 +3311,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:703 release_notes.xml:997 +#: release_notes.xml:780 release_notes.xml:1074 #, no-c-format msgid "" "#2610, " @@ -3059,7 +3319,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:704 +#: release_notes.xml:781 #, no-c-format msgid "" "#2615, " @@ -3067,7 +3327,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:705 +#: release_notes.xml:782 #, no-c-format msgid "" "#2619, " @@ -3075,7 +3335,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:706 +#: release_notes.xml:783 #, no-c-format msgid "" "#2634, " @@ -3083,7 +3343,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:707 release_notes.xml:999 +#: release_notes.xml:784 release_notes.xml:1076 #, no-c-format msgid "" "#2638, " @@ -3091,7 +3351,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:708 +#: release_notes.xml:785 #, no-c-format msgid "" "#2648, " @@ -3100,7 +3360,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:709 +#: release_notes.xml:786 #, no-c-format msgid "" "#2654, Drop " @@ -3108,7 +3368,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:710 +#: release_notes.xml:787 #, no-c-format msgid "" "#2655, Let " @@ -3116,7 +3376,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:711 +#: release_notes.xml:788 #, no-c-format msgid "" "#2674, Fix " @@ -3124,7 +3384,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:712 +#: release_notes.xml:789 #, no-c-format msgid "" "#2675, " @@ -3136,7 +3396,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:716 +#: release_notes.xml:793 #, no-c-format msgid "" "#2494, " @@ -3144,7 +3404,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:717 +#: release_notes.xml:794 #, no-c-format msgid "" "#2560, soft " @@ -3152,19 +3412,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:722 +#: release_notes.xml:799 #, no-c-format msgid "Release 2.1.1" msgstr "" #. Tag: para -#: release_notes.xml:723 +#: release_notes.xml:800 #, no-c-format msgid "Release date: 2013/11/06" msgstr "" #. Tag: para -#: release_notes.xml:724 +#: release_notes.xml:801 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -3172,13 +3432,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:726 release_notes.xml:1002 +#: release_notes.xml:803 release_notes.xml:1079 #, no-c-format msgid "Important Changes" msgstr "" #. Tag: para -#: release_notes.xml:727 +#: release_notes.xml:804 #, no-c-format msgid "" "#2514, " @@ -3187,7 +3447,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:731 +#: release_notes.xml:808 #, no-c-format msgid "" "#2396, Make " @@ -3195,7 +3455,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:732 +#: release_notes.xml:809 #, no-c-format msgid "" "#2434, Fix " @@ -3203,7 +3463,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:733 +#: release_notes.xml:810 #, no-c-format msgid "" "#2454, Fix " @@ -3211,7 +3471,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:734 +#: release_notes.xml:811 #, no-c-format msgid "" "#2489, Fix " @@ -3219,7 +3479,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:735 +#: release_notes.xml:812 #, no-c-format msgid "" "#2525, Fix " @@ -3227,7 +3487,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:736 +#: release_notes.xml:813 #, no-c-format msgid "" "#2449, Fix " @@ -3235,7 +3495,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:737 +#: release_notes.xml:814 #, no-c-format msgid "" "#2493, Fix " @@ -3243,7 +3503,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:738 release_notes.xml:988 +#: release_notes.xml:815 release_notes.xml:1065 #, no-c-format msgid "" "#2502, Fix " @@ -3251,7 +3511,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:739 release_notes.xml:989 +#: release_notes.xml:816 release_notes.xml:1066 #, no-c-format msgid "" "#2504, Fix " @@ -3259,7 +3519,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:740 +#: release_notes.xml:817 #, no-c-format msgid "" "#2512, " @@ -3268,7 +3528,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:744 +#: release_notes.xml:821 #, no-c-format msgid "" "#2478, " @@ -3276,7 +3536,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:745 +#: release_notes.xml:822 #, no-c-format msgid "" "#2463, " @@ -3284,19 +3544,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:751 +#: release_notes.xml:828 #, no-c-format msgid "Release 2.1.0" msgstr "" #. Tag: para -#: release_notes.xml:752 +#: release_notes.xml:829 #, no-c-format msgid "Release date: 2013/08/17" msgstr "" #. Tag: para -#: release_notes.xml:753 +#: release_notes.xml:830 #, no-c-format msgid "" "This is a minor release addressing both bug fixes and performance and " @@ -3306,7 +3566,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:757 +#: release_notes.xml:834 #, no-c-format msgid "" "#1653, " @@ -3315,7 +3575,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:759 +#: release_notes.xml:836 #, no-c-format msgid "" "#1962 " @@ -3325,7 +3585,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:763 +#: release_notes.xml:840 #, no-c-format msgid "" "#2026, " @@ -3333,7 +3593,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:764 +#: release_notes.xml:841 #, no-c-format msgid "" "#2089, " @@ -3341,7 +3601,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:765 +#: release_notes.xml:842 #, no-c-format msgid "" "#2150, " @@ -3351,7 +3611,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:768 +#: release_notes.xml:845 #, no-c-format msgid "" "ST_Intersects(raster, geometry) behaves in the same manner as " @@ -3359,7 +3619,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:770 +#: release_notes.xml:847 #, no-c-format msgid "" "point variant of ST_SetValue(raster) previously did not check SRID of input " @@ -3367,7 +3627,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:772 +#: release_notes.xml:849 #, no-c-format msgid "" "ST_Hillshade parameters azimuth and altitude are now in degrees instead of " @@ -3375,14 +3635,14 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:774 +#: release_notes.xml:851 #, no-c-format msgid "" "ST_Slope and ST_Aspect return pixel values in degrees instead of radians." msgstr "" #. Tag: para -#: release_notes.xml:775 +#: release_notes.xml:852 #, no-c-format msgid "" "#2104, " @@ -3394,37 +3654,37 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:781 +#: release_notes.xml:858 #, no-c-format msgid "ST_Estimated_Extent renamed to ST_EstimatedExtent" msgstr "" #. Tag: para -#: release_notes.xml:782 +#: release_notes.xml:859 #, no-c-format msgid "ST_Line_Interpolate_Point renamed to ST_LineInterpolatePoint" msgstr "" #. Tag: para -#: release_notes.xml:783 +#: release_notes.xml:860 #, no-c-format msgid "ST_Line_Substring renamed to ST_LineSubstring" msgstr "" #. Tag: para -#: release_notes.xml:784 +#: release_notes.xml:861 #, no-c-format msgid "ST_Line_Locate_Point renamed to ST_LineLocatePoint" msgstr "" #. Tag: para -#: release_notes.xml:785 +#: release_notes.xml:862 #, no-c-format msgid "ST_Force_XXX renamed to ST_ForceXXX" msgstr "" #. Tag: para -#: release_notes.xml:786 +#: release_notes.xml:863 #, no-c-format msgid "" "ST_MapAlgebraFctNgb and 1 and 2 raster variants of ST_MapAlgebraFct. Use " @@ -3432,7 +3692,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:788 +#: release_notes.xml:865 #, no-c-format msgid "" "1 and 2 raster variants of ST_MapAlgebraExpr. Use expression variants of " @@ -3440,7 +3700,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:794 +#: release_notes.xml:871 #, no-c-format msgid "" "- Refer to http://postgis.net/docs/manual-2.1/" @@ -3449,7 +3709,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:796 +#: release_notes.xml:873 #, no-c-format msgid "" "#310, " @@ -3457,7 +3717,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:797 +#: release_notes.xml:874 #, no-c-format msgid "" "#739, " @@ -3465,7 +3725,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:798 +#: release_notes.xml:875 #, no-c-format msgid "" "#945, " @@ -3474,55 +3734,55 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:801 +#: release_notes.xml:878 #, no-c-format msgid "toTopoGeom with TopoGeometry sink (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:802 +#: release_notes.xml:879 #, no-c-format msgid "clearTopoGeom (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:803 +#: release_notes.xml:880 #, no-c-format msgid "ST_Segmentize(geography) (Paul Ramsey / OpenGeo)" msgstr "" #. Tag: para -#: release_notes.xml:804 +#: release_notes.xml:881 #, no-c-format msgid "ST_DelaunayTriangles (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:805 +#: release_notes.xml:882 #, no-c-format msgid "ST_NearestValue, ST_Neighborhood (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:806 +#: release_notes.xml:883 #, no-c-format msgid "ST_PixelAsPoint, ST_PixelAsPoints (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:807 +#: release_notes.xml:884 #, no-c-format msgid "ST_PixelAsCentroid, ST_PixelAsCentroids (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:808 +#: release_notes.xml:885 #, no-c-format msgid "ST_Raster2WorldCoord, ST_World2RasterCoord (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:809 +#: release_notes.xml:886 #, no-c-format msgid "" "Additional raster/raster spatial relationship functions (ST_Contains, " @@ -3531,7 +3791,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:813 +#: release_notes.xml:890 #, no-c-format msgid "" "Added array variants of ST_SetValues() to set many pixel values of a band in " @@ -3539,7 +3799,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:815 +#: release_notes.xml:892 #, no-c-format msgid "" "#1293, " @@ -3547,7 +3807,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:816 +#: release_notes.xml:893 #, no-c-format msgid "" "#1627, " @@ -3555,7 +3815,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:817 +#: release_notes.xml:894 #, no-c-format msgid "" "#1643, " @@ -3565,14 +3825,14 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:819 +#: release_notes.xml:896 #, no-c-format msgid "" "GEOMETRYCOLLECTION support for ST_MakeValid (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:820 +#: release_notes.xml:897 #, no-c-format msgid "" "#1709, " @@ -3580,7 +3840,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:821 +#: release_notes.xml:898 #, no-c-format msgid "" "#1818, " @@ -3588,7 +3848,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:822 +#: release_notes.xml:899 #, no-c-format msgid "" "#1856, " @@ -3596,19 +3856,19 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:823 +#: release_notes.xml:900 #, no-c-format msgid "ST_PixelOfValue (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:824 +#: release_notes.xml:901 #, no-c-format msgid "Casts to/from PostgreSQL geotypes (point/path/polygon)." msgstr "" #. Tag: para -#: release_notes.xml:825 +#: release_notes.xml:902 #, no-c-format msgid "" "Added geomval array variant of ST_SetValues() to set many pixel values of a " @@ -3617,14 +3877,14 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:828 +#: release_notes.xml:905 #, no-c-format msgid "" "ST_Tile(raster) to break up a raster into tiles (Bborie Park / UC Davis)" msgstr "" #. Tag: para -#: release_notes.xml:829 +#: release_notes.xml:906 #, no-c-format msgid "" "#1895, new " @@ -3632,7 +3892,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:830 +#: release_notes.xml:907 #, no-c-format msgid "" "#2011, " @@ -3640,7 +3900,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:831 +#: release_notes.xml:908 #, no-c-format msgid "" "#2018, " @@ -3649,7 +3909,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:833 +#: release_notes.xml:910 #, no-c-format msgid "" "#2030, n-" @@ -3657,7 +3917,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:834 +#: release_notes.xml:911 #, no-c-format msgid "" "#2193, " @@ -3666,7 +3926,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:836 +#: release_notes.xml:913 #, no-c-format msgid "" "#2210, " @@ -3674,13 +3934,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:837 +#: release_notes.xml:914 #, no-c-format msgid "lwgeom_from_geojson in liblwgeom (Sandro Santilli / Vizzuality)" msgstr "" #. Tag: para -#: release_notes.xml:838 +#: release_notes.xml:915 #, no-c-format msgid "" "#1687, " @@ -3688,7 +3948,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:839 +#: release_notes.xml:916 #, no-c-format msgid "" "#2228, " @@ -3696,7 +3956,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:840 +#: release_notes.xml:917 #, no-c-format msgid "" "#2123, " @@ -3704,7 +3964,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:841 +#: release_notes.xml:918 #, no-c-format msgid "" "#613, " @@ -3712,7 +3972,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:842 +#: release_notes.xml:919 #, no-c-format msgid "" "#2276, " @@ -3720,7 +3980,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:843 +#: release_notes.xml:920 #, no-c-format msgid "" "#2280, " @@ -3728,7 +3988,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:844 +#: release_notes.xml:921 #, no-c-format msgid "" "#2163, " @@ -3736,7 +3996,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:845 +#: release_notes.xml:922 #, no-c-format msgid "" "#2164, " @@ -3744,7 +4004,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:846 +#: release_notes.xml:923 #, no-c-format msgid "" "#2302, " @@ -3752,7 +4012,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:847 +#: release_notes.xml:924 #, no-c-format msgid "" "#2290, " @@ -3760,7 +4020,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:848 +#: release_notes.xml:925 #, no-c-format msgid "" "#2254, Add " @@ -3775,7 +4035,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:863 +#: release_notes.xml:940 #, no-c-format msgid "" "For detail of new functions and function improvements, please refer to #823, tiger " @@ -3806,7 +4066,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:869 +#: release_notes.xml:946 #, no-c-format msgid "" "#826, " @@ -3815,7 +4075,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:871 +#: release_notes.xml:948 #, no-c-format msgid "" "#1363, " @@ -3823,7 +4083,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:872 +#: release_notes.xml:949 #, no-c-format msgid "" "#1364, " @@ -3831,7 +4091,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:873 +#: release_notes.xml:950 #, no-c-format msgid "" "#1655, " @@ -3839,7 +4099,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:874 +#: release_notes.xml:951 #, no-c-format msgid "" "#1661, Add " @@ -3847,7 +4107,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:875 +#: release_notes.xml:952 #, no-c-format msgid "" "#1719, Add " @@ -3855,7 +4115,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:876 +#: release_notes.xml:953 #, no-c-format msgid "" "#1780, " @@ -3863,7 +4123,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:877 +#: release_notes.xml:954 #, no-c-format msgid "" "#1796, Big " @@ -3871,7 +4131,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:878 +#: release_notes.xml:955 #, no-c-format msgid "" "#1802, " @@ -3879,7 +4139,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:879 +#: release_notes.xml:956 #, no-c-format msgid "" "#1823, add " @@ -3888,7 +4148,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:881 +#: release_notes.xml:958 #, no-c-format msgid "" "#1856, " @@ -3897,7 +4157,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:883 +#: release_notes.xml:960 #, no-c-format msgid "" "#1938, " @@ -3905,7 +4165,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:884 +#: release_notes.xml:961 #, no-c-format msgid "" "#1978, " @@ -3913,7 +4173,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:886 release_notes.xml:1096 +#: release_notes.xml:963 release_notes.xml:1173 #, no-c-format msgid "" "#1989, " @@ -3921,7 +4181,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:888 +#: release_notes.xml:965 #, no-c-format msgid "" "#2021, " @@ -3929,7 +4189,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:889 +#: release_notes.xml:966 #, no-c-format msgid "" "#2006, " @@ -3937,7 +4197,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:890 +#: release_notes.xml:967 #, no-c-format msgid "" "#2065, " @@ -3945,7 +4205,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:891 +#: release_notes.xml:968 #, no-c-format msgid "" "#2069, " @@ -3953,7 +4213,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:892 +#: release_notes.xml:969 #, no-c-format msgid "" "#2078, New " @@ -3962,7 +4222,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:894 +#: release_notes.xml:971 #, no-c-format msgid "" "#2097, " @@ -3970,7 +4230,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:895 +#: release_notes.xml:972 #, no-c-format msgid "" "#2105, " @@ -3978,7 +4238,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:897 +#: release_notes.xml:974 #, no-c-format msgid "" "#2119, " @@ -3987,7 +4247,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:899 release_notes.xml:1069 +#: release_notes.xml:976 release_notes.xml:1146 #, no-c-format msgid "" "#2141, More " @@ -3995,7 +4255,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:901 +#: release_notes.xml:978 #, no-c-format msgid "" "#2143, " @@ -4003,7 +4263,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:902 +#: release_notes.xml:979 #, no-c-format msgid "" "#2148, " @@ -4011,7 +4271,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:903 +#: release_notes.xml:980 #, no-c-format msgid "" "#2149, " @@ -4019,7 +4279,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:904 +#: release_notes.xml:981 #, no-c-format msgid "" "TopologySummary output now includes unregistered layers and a count of " @@ -4027,7 +4287,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:906 +#: release_notes.xml:983 #, no-c-format msgid "" "ST_HillShade(), ST_Aspect() and ST_Slope() have one new optional parameter " @@ -4035,7 +4295,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:909 +#: release_notes.xml:986 #, no-c-format msgid "" "Point variant of ST_SetValue(raster) is now a wrapper around geomval variant " @@ -4043,19 +4303,19 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:911 +#: release_notes.xml:988 #, no-c-format msgid "Proper support for raster band's isnodata flag in core API and loader." msgstr "" #. Tag: para -#: release_notes.xml:912 +#: release_notes.xml:989 #, no-c-format msgid "Additional default values for parameters of ST_Aspect and ST_HillShade" msgstr "" #. Tag: para -#: release_notes.xml:913 +#: release_notes.xml:990 #, no-c-format msgid "" "#2178, " @@ -4063,7 +4323,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:914 +#: release_notes.xml:991 #, no-c-format msgid "" "#2202, Make " @@ -4071,7 +4331,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:915 +#: release_notes.xml:992 #, no-c-format msgid "" "#2213, Add " @@ -4079,7 +4339,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:916 +#: release_notes.xml:993 #, no-c-format msgid "" "#2231, " @@ -4087,7 +4347,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:917 +#: release_notes.xml:994 #, no-c-format msgid "" "#2200, " @@ -4095,7 +4355,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:918 +#: release_notes.xml:995 #, no-c-format msgid "" "#2264, " @@ -4104,7 +4364,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:920 +#: release_notes.xml:997 #, no-c-format msgid "" "#2244, emit " @@ -4112,7 +4372,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:922 +#: release_notes.xml:999 #, no-c-format msgid "" "#2222, add " @@ -4121,13 +4381,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:926 +#: release_notes.xml:1003 #, no-c-format msgid "Fixes" msgstr "" #. Tag: para -#: release_notes.xml:927 release_notes.xml:1171 +#: release_notes.xml:1004 release_notes.xml:1248 #, no-c-format msgid "" "#1839, " @@ -4135,7 +4395,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:928 release_notes.xml:1172 +#: release_notes.xml:1005 release_notes.xml:1249 #, no-c-format msgid "" "#1840, fix " @@ -4143,7 +4403,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:929 +#: release_notes.xml:1006 #, no-c-format msgid "" "#1870, " @@ -4151,7 +4411,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:930 release_notes.xml:1178 +#: release_notes.xml:1007 release_notes.xml:1255 #, no-c-format msgid "" "#1872, fix " @@ -4159,7 +4419,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:931 release_notes.xml:1181 +#: release_notes.xml:1008 release_notes.xml:1258 #, no-c-format msgid "" "#1875, " @@ -4168,7 +4428,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:933 +#: release_notes.xml:1010 #, no-c-format msgid "" "#1932, fix " @@ -4176,7 +4436,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:934 release_notes.xml:1089 +#: release_notes.xml:1011 release_notes.xml:1166 #, no-c-format msgid "" "#1936, " @@ -4184,7 +4444,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:935 +#: release_notes.xml:1012 #, no-c-format msgid "" "#1939, " @@ -4192,7 +4452,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:937 +#: release_notes.xml:1014 #, no-c-format msgid "" "#1951, " @@ -4200,7 +4460,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:938 release_notes.xml:1091 +#: release_notes.xml:1015 release_notes.xml:1168 #, no-c-format msgid "" "#1957, " @@ -4208,7 +4468,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:939 release_notes.xml:1092 +#: release_notes.xml:1016 release_notes.xml:1169 #, no-c-format msgid "" "#1976, " @@ -4216,7 +4476,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:940 +#: release_notes.xml:1017 #, no-c-format msgid "" "#1981, " @@ -4224,7 +4484,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:941 release_notes.xml:1099 +#: release_notes.xml:1018 release_notes.xml:1176 #, no-c-format msgid "" "#1996, " @@ -4232,7 +4492,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:942 +#: release_notes.xml:1019 #, no-c-format msgid "" "#2062, " @@ -4240,7 +4500,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:943 release_notes.xml:1110 +#: release_notes.xml:1020 release_notes.xml:1187 #, no-c-format msgid "" "#2057, " @@ -4248,7 +4508,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:944 +#: release_notes.xml:1021 #, no-c-format msgid "" "#2077, " @@ -4256,7 +4516,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:945 release_notes.xml:1103 +#: release_notes.xml:1022 release_notes.xml:1180 #, no-c-format msgid "" "#2019, " @@ -4264,7 +4524,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:946 +#: release_notes.xml:1023 #, no-c-format msgid "" "#2100, " @@ -4272,7 +4532,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:947 release_notes.xml:1055 +#: release_notes.xml:1024 release_notes.xml:1132 #, no-c-format msgid "" "#2126, " @@ -4280,7 +4540,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:948 release_notes.xml:1016 +#: release_notes.xml:1025 release_notes.xml:1093 #, no-c-format msgid "" "#2165, " @@ -4288,7 +4548,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:949 release_notes.xml:1017 +#: release_notes.xml:1026 release_notes.xml:1094 #, no-c-format msgid "" "#2168, " @@ -4296,7 +4556,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:950 +#: release_notes.xml:1027 #, no-c-format msgid "" "#2182, Fix " @@ -4304,7 +4564,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:951 release_notes.xml:1063 +#: release_notes.xml:1028 release_notes.xml:1140 #, no-c-format msgid "" "#2188, Fix " @@ -4313,7 +4573,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:953 +#: release_notes.xml:1030 #, no-c-format msgid "" "#2198, Fix " @@ -4322,7 +4582,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:955 release_notes.xml:1019 +#: release_notes.xml:1032 release_notes.xml:1096 #, no-c-format msgid "" "#2201, " @@ -4330,7 +4590,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:956 +#: release_notes.xml:1033 #, no-c-format msgid "" "#2203, " @@ -4339,7 +4599,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:958 +#: release_notes.xml:1035 #, no-c-format msgid "" "#2215, " @@ -4347,7 +4607,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:960 +#: release_notes.xml:1037 #, no-c-format msgid "" "#2251, Fix " @@ -4355,7 +4615,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:962 +#: release_notes.xml:1039 #, no-c-format msgid "" "#2133, Fix " @@ -4363,7 +4623,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:963 release_notes.xml:1020 +#: release_notes.xml:1040 release_notes.xml:1097 #, no-c-format msgid "" "#2257, GBOX " @@ -4371,7 +4631,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:964 release_notes.xml:1021 +#: release_notes.xml:1041 release_notes.xml:1098 #, no-c-format msgid "" "#2271, " @@ -4379,7 +4639,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:965 +#: release_notes.xml:1042 #, no-c-format msgid "" "#2282, Fix " @@ -4387,7 +4647,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:966 release_notes.xml:1024 +#: release_notes.xml:1043 release_notes.xml:1101 #, no-c-format msgid "" "#2307, " @@ -4395,7 +4655,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:967 +#: release_notes.xml:1044 #, no-c-format msgid "" "#2309, " @@ -4403,7 +4663,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:968 +#: release_notes.xml:1045 #, no-c-format msgid "" "#2336, FIPS " @@ -4411,7 +4671,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:969 +#: release_notes.xml:1046 #, no-c-format msgid "" "#2348, " @@ -4419,7 +4679,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:970 release_notes.xml:1025 +#: release_notes.xml:1047 release_notes.xml:1102 #, no-c-format msgid "" "#2351, " @@ -4427,7 +4687,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:971 +#: release_notes.xml:1048 #, no-c-format msgid "" "#2359, Fix " @@ -4435,7 +4695,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:972 release_notes.xml:1027 +#: release_notes.xml:1049 release_notes.xml:1104 #, no-c-format msgid "" "#2371, " @@ -4443,7 +4703,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:973 +#: release_notes.xml:1050 #, no-c-format msgid "" "#2383, " @@ -4451,7 +4711,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:974 +#: release_notes.xml:1051 #, no-c-format msgid "" "#2384, " @@ -4459,13 +4719,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:976 release_notes.xml:1044 +#: release_notes.xml:1053 release_notes.xml:1121 #, no-c-format msgid "Known Issues" msgstr "" #. Tag: para -#: release_notes.xml:977 release_notes.xml:1045 +#: release_notes.xml:1054 release_notes.xml:1122 #, no-c-format msgid "" "#2111, " @@ -4473,13 +4733,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:982 +#: release_notes.xml:1059 #, no-c-format msgid "Release 2.0.5" msgstr "" #. Tag: para -#: release_notes.xml:984 +#: release_notes.xml:1061 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -4488,7 +4748,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:987 +#: release_notes.xml:1064 #, no-c-format msgid "" "#2494, " @@ -4496,7 +4756,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:990 +#: release_notes.xml:1067 #, no-c-format msgid "" "#2528, Fix " @@ -4504,7 +4764,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:991 +#: release_notes.xml:1068 #, no-c-format msgid "" "#2532, Add " @@ -4512,7 +4772,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:992 +#: release_notes.xml:1069 #, no-c-format msgid "" "#2533, " @@ -4520,7 +4780,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:996 +#: release_notes.xml:1073 #, no-c-format msgid "" "#2607, " @@ -4528,7 +4788,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:998 +#: release_notes.xml:1075 #, no-c-format msgid "" "#2619, " @@ -4536,7 +4796,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1003 +#: release_notes.xml:1080 #, no-c-format msgid "" "##2514, " @@ -4545,19 +4805,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1008 +#: release_notes.xml:1085 #, no-c-format msgid "Release 2.0.4" msgstr "" #. Tag: para -#: release_notes.xml:1009 +#: release_notes.xml:1086 #, no-c-format msgid "Release date: 2013/09/06" msgstr "" #. Tag: para -#: release_notes.xml:1010 +#: release_notes.xml:1087 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -4566,7 +4826,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1013 +#: release_notes.xml:1090 #, no-c-format msgid "" "#2110, " @@ -4574,13 +4834,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1014 +#: release_notes.xml:1091 #, no-c-format msgid "Allow adding points at precision distance with TopoGeo_addPoint" msgstr "" #. Tag: para -#: release_notes.xml:1015 +#: release_notes.xml:1092 #, no-c-format msgid "" "#1968, Fix " @@ -4588,7 +4848,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1018 +#: release_notes.xml:1095 #, no-c-format msgid "" "#2186, gui " @@ -4596,7 +4856,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1022 +#: release_notes.xml:1099 #, no-c-format msgid "" "#2267, " @@ -4604,7 +4864,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1023 +#: release_notes.xml:1100 #, no-c-format msgid "" "#2277, " @@ -4612,7 +4872,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1026 +#: release_notes.xml:1103 #, no-c-format msgid "" "#2359, " @@ -4620,7 +4880,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1028 +#: release_notes.xml:1105 #, no-c-format msgid "" "#2372, " @@ -4628,13 +4888,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1029 +#: release_notes.xml:1106 #, no-c-format msgid "Fix build with systemwide liblwgeom installed" msgstr "" #. Tag: para -#: release_notes.xml:1030 +#: release_notes.xml:1107 #, no-c-format msgid "" "#2383, Fix " @@ -4642,7 +4902,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1031 +#: release_notes.xml:1108 #, no-c-format msgid "" "#2410, Fix " @@ -4650,7 +4910,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1032 +#: release_notes.xml:1109 #, no-c-format msgid "" "#2412, " @@ -4658,7 +4918,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1033 +#: release_notes.xml:1110 #, no-c-format msgid "" "#2415, " @@ -4666,7 +4926,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1034 +#: release_notes.xml:1111 #, no-c-format msgid "" "#2420, " @@ -4674,7 +4934,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1035 +#: release_notes.xml:1112 #, no-c-format msgid "" "#2423, " @@ -4682,7 +4942,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1036 +#: release_notes.xml:1113 #, no-c-format msgid "" "#2424, " @@ -4690,7 +4950,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1037 +#: release_notes.xml:1114 #, no-c-format msgid "" "#2427, Make " @@ -4698,7 +4958,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1041 +#: release_notes.xml:1118 #, no-c-format msgid "" "#2269, " @@ -4706,19 +4966,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1050 +#: release_notes.xml:1127 #, no-c-format msgid "Release 2.0.3" msgstr "" #. Tag: para -#: release_notes.xml:1051 +#: release_notes.xml:1128 #, no-c-format msgid "Release date: 2013/03/01" msgstr "" #. Tag: para -#: release_notes.xml:1052 +#: release_notes.xml:1129 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -4727,7 +4987,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1056 +#: release_notes.xml:1133 #, no-c-format msgid "" "#2134, Make " @@ -4735,13 +4995,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1057 +#: release_notes.xml:1134 #, no-c-format msgid "Fix various memory leaks in liblwgeom" msgstr "" #. Tag: para -#: release_notes.xml:1058 +#: release_notes.xml:1135 #, no-c-format msgid "" "#2173, Fix " @@ -4751,7 +5011,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1059 +#: release_notes.xml:1136 #, no-c-format msgid "" "#2174, Fix " @@ -4759,7 +5019,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1060 +#: release_notes.xml:1137 #, no-c-format msgid "" "#2176, Fix " @@ -4767,7 +5027,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1061 +#: release_notes.xml:1138 #, no-c-format msgid "" "#2184, " @@ -4775,13 +5035,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1062 +#: release_notes.xml:1139 #, no-c-format msgid "postgis_restore.pl support for mixed case geometry column name in dumps" msgstr "" #. Tag: para -#: release_notes.xml:1064 +#: release_notes.xml:1141 #, no-c-format msgid "" "#2216, More " @@ -4789,31 +5049,31 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1065 +#: release_notes.xml:1142 #, no-c-format msgid "Fix Memory leak in GeoJSON parser" msgstr "" #. Tag: para -#: release_notes.xml:1070 +#: release_notes.xml:1147 #, no-c-format msgid "Speedup ST_ChangeEdgeGeom" msgstr "" #. Tag: title -#: release_notes.xml:1074 +#: release_notes.xml:1151 #, no-c-format msgid "Release 2.0.2" msgstr "" #. Tag: para -#: release_notes.xml:1075 +#: release_notes.xml:1152 #, no-c-format msgid "Release date: 2012/12/03" msgstr "" #. Tag: para -#: release_notes.xml:1076 +#: release_notes.xml:1153 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -4821,7 +5081,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1079 +#: release_notes.xml:1156 #, no-c-format msgid "" "#1287, Drop " @@ -4830,7 +5090,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1081 +#: release_notes.xml:1158 #, no-c-format msgid "" "#1391, " @@ -4838,7 +5098,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1082 +#: release_notes.xml:1159 #, no-c-format msgid "" "#1828, Poor " @@ -4846,7 +5106,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1083 +#: release_notes.xml:1160 #, no-c-format msgid "" "#1838, " @@ -4854,7 +5114,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1084 +#: release_notes.xml:1161 #, no-c-format msgid "" "#1869, " @@ -4862,7 +5122,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1085 +#: release_notes.xml:1162 #, no-c-format msgid "" "#1885, " @@ -4870,7 +5130,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1086 +#: release_notes.xml:1163 #, no-c-format msgid "" "#1891, Use " @@ -4878,7 +5138,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1087 +#: release_notes.xml:1164 #, no-c-format msgid "" "#1900, Fix " @@ -4886,7 +5146,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1088 +#: release_notes.xml:1165 #, no-c-format msgid "" "#1932, Fix " @@ -4894,7 +5154,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1090 +#: release_notes.xml:1167 #, no-c-format msgid "" "#1955, " @@ -4902,7 +5162,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1093 +#: release_notes.xml:1170 #, no-c-format msgid "" "#1978, " @@ -4910,7 +5170,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1094 +#: release_notes.xml:1171 #, no-c-format msgid "" "#1981, " @@ -4918,7 +5178,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1095 +#: release_notes.xml:1172 #, no-c-format msgid "" "#1987, " @@ -4926,7 +5186,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1098 +#: release_notes.xml:1175 #, no-c-format msgid "" "#1991, " @@ -4934,7 +5194,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1100 +#: release_notes.xml:1177 #, no-c-format msgid "" "#1998, Fix " @@ -4942,7 +5202,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1101 +#: release_notes.xml:1178 #, no-c-format msgid "" "#2001, " @@ -4950,7 +5210,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1102 +#: release_notes.xml:1179 #, no-c-format msgid "" "#2015, " @@ -4958,7 +5218,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1104 +#: release_notes.xml:1181 #, no-c-format msgid "" "#2025, Fix " @@ -4966,7 +5226,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1105 +#: release_notes.xml:1182 #, no-c-format msgid "" "#2026, " @@ -4974,7 +5234,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1106 +#: release_notes.xml:1183 #, no-c-format msgid "" "#2033, Fix " @@ -4982,7 +5242,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1107 +#: release_notes.xml:1184 #, no-c-format msgid "" "#2051, Fix " @@ -4990,7 +5250,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1108 +#: release_notes.xml:1185 #, no-c-format msgid "" "#2052, Fix " @@ -4998,7 +5258,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1109 +#: release_notes.xml:1186 #, no-c-format msgid "" "#2056, " @@ -5006,7 +5266,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1111 +#: release_notes.xml:1188 #, no-c-format msgid "" "#2060, Fix " @@ -5014,7 +5274,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1112 +#: release_notes.xml:1189 #, no-c-format msgid "" "#2072, " @@ -5023,7 +5283,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1114 +#: release_notes.xml:1191 #, no-c-format msgid "" "#2077, " @@ -5031,7 +5291,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1115 +#: release_notes.xml:1192 #, no-c-format msgid "" "#2092, " @@ -5039,7 +5299,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1116 +#: release_notes.xml:1193 #, no-c-format msgid "" "#2099, Fix " @@ -5047,7 +5307,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1117 +#: release_notes.xml:1194 #, no-c-format msgid "" "#2100, " @@ -5055,7 +5315,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1118 +#: release_notes.xml:1195 #, no-c-format msgid "" "#2108, " @@ -5063,7 +5323,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1119 +#: release_notes.xml:1196 #, no-c-format msgid "" "#2109, " @@ -5071,7 +5331,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1120 +#: release_notes.xml:1197 #, no-c-format msgid "" "#2117, " @@ -5079,7 +5339,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1121 +#: release_notes.xml:1198 #, no-c-format msgid "" "#2129, Fix " @@ -5087,7 +5347,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1122 +#: release_notes.xml:1199 #, no-c-format msgid "" "#2130, Fix " @@ -5095,13 +5355,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1124 +#: release_notes.xml:1201 #, no-c-format msgid "Update URL of Maven jar" msgstr "" #. Tag: para -#: release_notes.xml:1128 +#: release_notes.xml:1205 #, no-c-format msgid "" "#1581, " @@ -5110,7 +5370,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1130 +#: release_notes.xml:1207 #, no-c-format msgid "" "#1928, " @@ -5119,7 +5379,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1132 +#: release_notes.xml:1209 #, no-c-format msgid "" "#2082, Add " @@ -5127,7 +5387,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1133 +#: release_notes.xml:1210 #, no-c-format msgid "" "#2087, " @@ -5135,19 +5395,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1137 +#: release_notes.xml:1214 #, no-c-format msgid "Release 2.0.1" msgstr "" #. Tag: para -#: release_notes.xml:1138 +#: release_notes.xml:1215 #, no-c-format msgid "Release date: 2012/06/22" msgstr "" #. Tag: para -#: release_notes.xml:1139 +#: release_notes.xml:1216 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -5155,7 +5415,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1142 +#: release_notes.xml:1219 #, no-c-format msgid "" "#1264, fix " @@ -5163,7 +5423,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1143 +#: release_notes.xml:1220 #, no-c-format msgid "" "#1468 " @@ -5171,7 +5431,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1144 +#: release_notes.xml:1221 #, no-c-format msgid "" "#1694, fix " @@ -5179,7 +5439,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1145 +#: release_notes.xml:1222 #, no-c-format msgid "" "#1708, " @@ -5187,7 +5447,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1146 +#: release_notes.xml:1223 #, no-c-format msgid "" "#1714, more " @@ -5195,7 +5455,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1147 +#: release_notes.xml:1224 #, no-c-format msgid "" "#1755, " @@ -5203,7 +5463,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1148 +#: release_notes.xml:1225 #, no-c-format msgid "" "#1759, " @@ -5211,7 +5471,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1149 +#: release_notes.xml:1226 #, no-c-format msgid "" "#1761, " @@ -5219,7 +5479,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1150 +#: release_notes.xml:1227 #, no-c-format msgid "" "#1763, " @@ -5227,7 +5487,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1151 +#: release_notes.xml:1228 #, no-c-format msgid "" "#1766, " @@ -5235,7 +5495,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1152 +#: release_notes.xml:1229 #, no-c-format msgid "" "#1774, " @@ -5243,7 +5503,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1153 +#: release_notes.xml:1230 #, no-c-format msgid "" "#1775, " @@ -5251,7 +5511,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1154 +#: release_notes.xml:1231 #, no-c-format msgid "" "#1776, fix " @@ -5259,7 +5519,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1155 +#: release_notes.xml:1232 #, no-c-format msgid "" "#1779, " @@ -5267,7 +5527,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1156 +#: release_notes.xml:1233 #, no-c-format msgid "" "#1782, fix " @@ -5275,7 +5535,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1157 +#: release_notes.xml:1234 #, no-c-format msgid "" "#1789, fix " @@ -5283,7 +5543,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1158 +#: release_notes.xml:1235 #, no-c-format msgid "" "#1790, fix " @@ -5291,7 +5551,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1159 +#: release_notes.xml:1236 #, no-c-format msgid "" "#1791, fix " @@ -5299,7 +5559,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1160 +#: release_notes.xml:1237 #, no-c-format msgid "" "#1797, fix " @@ -5307,7 +5567,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1161 +#: release_notes.xml:1238 #, no-c-format msgid "" "#1805, put " @@ -5315,7 +5575,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1162 +#: release_notes.xml:1239 #, no-c-format msgid "" "#1813, Only " @@ -5323,7 +5583,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1163 +#: release_notes.xml:1240 #, no-c-format msgid "" "#1819, fix " @@ -5332,7 +5592,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1165 +#: release_notes.xml:1242 #, no-c-format msgid "" "#1820 " @@ -5340,7 +5600,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1166 +#: release_notes.xml:1243 #, no-c-format msgid "" "#1822, " @@ -5348,7 +5608,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1167 +#: release_notes.xml:1244 #, no-c-format msgid "" "#1825, fix " @@ -5356,7 +5616,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1168 +#: release_notes.xml:1245 #, no-c-format msgid "" "#1829, fix " @@ -5364,7 +5624,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1169 +#: release_notes.xml:1246 #, no-c-format msgid "" "#1834, " @@ -5372,7 +5632,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1173 +#: release_notes.xml:1250 #, no-c-format msgid "" "#1851, fix " @@ -5380,7 +5640,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1174 +#: release_notes.xml:1251 #, no-c-format msgid "" "#1857, fix " @@ -5388,7 +5648,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1175 +#: release_notes.xml:1252 #, no-c-format msgid "" "#1865, data " @@ -5396,7 +5656,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1177 +#: release_notes.xml:1254 #, no-c-format msgid "" "#1867, " @@ -5404,7 +5664,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1179 +#: release_notes.xml:1256 #, no-c-format msgid "" "#1873, fix " @@ -5412,7 +5672,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1183 +#: release_notes.xml:1260 #, no-c-format msgid "" "#1881, " @@ -5420,7 +5680,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1185 +#: release_notes.xml:1262 #, no-c-format msgid "" "#1883, " @@ -5429,13 +5689,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1190 +#: release_notes.xml:1267 #, no-c-format msgid "More detailed exception message from topology editing functions." msgstr "" #. Tag: para -#: release_notes.xml:1191 +#: release_notes.xml:1268 #, no-c-format msgid "" "#1786, " @@ -5443,7 +5703,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1192 +#: release_notes.xml:1269 #, no-c-format msgid "" "#1806, " @@ -5451,7 +5711,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1193 +#: release_notes.xml:1270 #, no-c-format msgid "" "#1812, Add " @@ -5459,19 +5719,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1197 +#: release_notes.xml:1274 #, no-c-format msgid "Release 2.0.0" msgstr "" #. Tag: para -#: release_notes.xml:1198 +#: release_notes.xml:1275 #, no-c-format msgid "Release date: 2012/04/03" msgstr "" #. Tag: para -#: release_notes.xml:1199 +#: release_notes.xml:1276 #, no-c-format msgid "" "This is a major release. A hard upgrade is required. Yes this means a full " @@ -5482,13 +5742,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1203 +#: release_notes.xml:1280 #, no-c-format msgid "Testers - Our unsung heroes" msgstr "" #. Tag: para -#: release_notes.xml:1204 +#: release_notes.xml:1281 #, no-c-format msgid "" "We are most indebted to the numerous members in the PostGIS community who " @@ -5497,7 +5757,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1207 +#: release_notes.xml:1284 #, no-c-format msgid "" "Below are those who have been most valiant, provided very detailed and " @@ -5505,31 +5765,31 @@ msgid "" msgstr "" #. Tag: member -#: release_notes.xml:1211 +#: release_notes.xml:1288 #, no-c-format msgid "Andrea Peri - Lots of testing on topology, checking for correctness" msgstr "" #. Tag: member -#: release_notes.xml:1212 +#: release_notes.xml:1289 #, no-c-format msgid "Andreas Forø Tollefsen - raster testing" msgstr "" #. Tag: member -#: release_notes.xml:1213 +#: release_notes.xml:1290 #, no-c-format msgid "Chris English - topology stress testing loader functions" msgstr "" #. Tag: member -#: release_notes.xml:1214 +#: release_notes.xml:1291 #, no-c-format msgid "Salvatore Larosa - topology robustness testing" msgstr "" #. Tag: member -#: release_notes.xml:1215 +#: release_notes.xml:1292 #, no-c-format msgid "" "Brian Hamlin - Benchmarking (also experimental experimental branches before " @@ -5538,19 +5798,19 @@ msgid "" msgstr "" #. Tag: member -#: release_notes.xml:1220 +#: release_notes.xml:1297 #, no-c-format msgid "Mike Pease - Tiger geocoder testing - very detailed reports of issues" msgstr "" #. Tag: member -#: release_notes.xml:1221 +#: release_notes.xml:1298 #, no-c-format msgid "Tom van Tilburg - raster testing" msgstr "" #. Tag: para -#: release_notes.xml:1226 +#: release_notes.xml:1303 #, no-c-format msgid "" "#722, #944 " @@ -5596,7 +5856,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1240 +#: release_notes.xml:1317 #, no-c-format msgid "" "#1081, " @@ -5608,7 +5868,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1243 +#: release_notes.xml:1320 #, no-c-format msgid "" "#1083 " @@ -5618,7 +5878,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1247 +#: release_notes.xml:1324 #, no-c-format msgid "" "#817 " @@ -5626,7 +5886,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1248 +#: release_notes.xml:1325 #, no-c-format msgid "" "#548 " @@ -5635,7 +5895,7 @@ msgid "" msgstr "" #. Tag: ulink -#: release_notes.xml:1253 +#: release_notes.xml:1330 #, no-c-format msgid "" "KNN Gist index based centroid (<->) and box (<#>) distance " @@ -5643,7 +5903,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1254 +#: release_notes.xml:1331 #, no-c-format msgid "" "Support for TIN and PolyHedralSurface and enhancement of many functions to " @@ -5651,7 +5911,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1255 +#: release_notes.xml:1332 #, no-c-format msgid "" "#1335 " @@ -5858,13 +6118,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1300 +#: release_notes.xml:1377 #, no-c-format msgid "Release specific credits" msgstr "" #. Tag: para -#: release_notes.xml:1301 +#: release_notes.xml:1378 #, no-c-format msgid "" "We thank #547, " @@ -5903,7 +6163,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1312 +#: release_notes.xml:1389 #, no-c-format msgid "" "#621, " @@ -5911,7 +6171,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1313 +#: release_notes.xml:1390 #, no-c-format msgid "" "#627, " @@ -5919,7 +6179,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1314 +#: release_notes.xml:1391 #, no-c-format msgid "" "#810, " @@ -5927,7 +6187,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1315 +#: release_notes.xml:1392 #, no-c-format msgid "" "#852, " @@ -5935,7 +6195,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1316 +#: release_notes.xml:1393 #, no-c-format msgid "" "#877, " @@ -5943,7 +6203,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1317 +#: release_notes.xml:1394 #, no-c-format msgid "" "#1028, " @@ -5951,7 +6211,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1318 +#: release_notes.xml:1395 #, no-c-format msgid "" "#1056, Fix " @@ -5959,7 +6219,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1319 +#: release_notes.xml:1396 #, no-c-format msgid "" "#1121, " @@ -5967,7 +6227,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1320 +#: release_notes.xml:1397 #, no-c-format msgid "" "#1135, " @@ -5975,7 +6235,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1321 +#: release_notes.xml:1398 #, no-c-format msgid "" "#1146, " @@ -5983,7 +6243,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1322 +#: release_notes.xml:1399 #, no-c-format msgid "" "#1170, " @@ -5991,7 +6251,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1323 +#: release_notes.xml:1400 #, no-c-format msgid "" "#1179, " @@ -5999,7 +6259,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1324 +#: release_notes.xml:1401 #, no-c-format msgid "" "#1184, " @@ -6007,7 +6267,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1325 +#: release_notes.xml:1402 #, no-c-format msgid "" "#1227, " @@ -6015,7 +6275,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1326 +#: release_notes.xml:1403 #, no-c-format msgid "" "#1252, SRID " @@ -6023,7 +6283,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1327 +#: release_notes.xml:1404 #, no-c-format msgid "" "#1264, " @@ -6031,7 +6291,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1328 +#: release_notes.xml:1405 #, no-c-format msgid "" "#1344, " @@ -6039,7 +6299,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1329 +#: release_notes.xml:1406 #, no-c-format msgid "" "#1389, " @@ -6047,7 +6307,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1330 +#: release_notes.xml:1407 #, no-c-format msgid "" "#1406, " @@ -6055,7 +6315,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1331 +#: release_notes.xml:1408 #, no-c-format msgid "" "#1595, " @@ -6063,7 +6323,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1332 +#: release_notes.xml:1409 #, no-c-format msgid "" "#1596, " @@ -6071,7 +6331,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1333 +#: release_notes.xml:1410 #, no-c-format msgid "" "#1602, fix " @@ -6079,7 +6339,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1334 +#: release_notes.xml:1411 #, no-c-format msgid "" "#1697, fix " @@ -6087,7 +6347,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1335 +#: release_notes.xml:1412 #, no-c-format msgid "" "#1772, fix " @@ -6095,7 +6355,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1336 +#: release_notes.xml:1413 #, no-c-format msgid "" "#1799, " @@ -6103,31 +6363,31 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1337 +#: release_notes.xml:1414 #, no-c-format msgid "Alter parameter order in 900913 (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:1338 +#: release_notes.xml:1415 #, no-c-format msgid "Support builds with \"gmake\" (Greg Troxel)" msgstr "" #. Tag: title -#: release_notes.xml:1343 +#: release_notes.xml:1420 #, no-c-format msgid "Release 1.5.3" msgstr "" #. Tag: para -#: release_notes.xml:1344 +#: release_notes.xml:1421 #, no-c-format msgid "Release date: 2011/06/25" msgstr "" #. Tag: para -#: release_notes.xml:1345 +#: release_notes.xml:1422 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -6136,7 +6396,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1349 +#: release_notes.xml:1426 #, no-c-format msgid "" "#1056, " @@ -6144,7 +6404,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1351 +#: release_notes.xml:1428 #, no-c-format msgid "" "#1007, " @@ -6153,7 +6413,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1353 +#: release_notes.xml:1430 #, no-c-format msgid "" "#940, " @@ -6162,7 +6422,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1355 +#: release_notes.xml:1432 #, no-c-format msgid "" "#845, " @@ -6171,7 +6431,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1357 +#: release_notes.xml:1434 #, no-c-format msgid "" "#884, " @@ -6179,7 +6439,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1358 +#: release_notes.xml:1435 #, no-c-format msgid "" "#779, " @@ -6187,7 +6447,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1359 +#: release_notes.xml:1436 #, no-c-format msgid "" "#666, " @@ -6195,7 +6455,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1360 +#: release_notes.xml:1437 #, no-c-format msgid "" "#631, Update " @@ -6203,7 +6463,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1361 +#: release_notes.xml:1438 #, no-c-format msgid "" "#630, " @@ -6212,7 +6472,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1363 +#: release_notes.xml:1440 #, no-c-format msgid "" "#624, Memory " @@ -6220,7 +6480,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1364 +#: release_notes.xml:1441 #, no-c-format msgid "" "#609, Bad " @@ -6228,7 +6488,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1365 +#: release_notes.xml:1442 #, no-c-format msgid "" "#604, " @@ -6236,7 +6496,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1366 +#: release_notes.xml:1443 #, no-c-format msgid "" "#573 " @@ -6245,7 +6505,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1368 +#: release_notes.xml:1445 #, no-c-format msgid "" "#457 " @@ -6253,7 +6513,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1370 +#: release_notes.xml:1447 #, no-c-format msgid "" "#441 " @@ -6261,7 +6521,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1371 +#: release_notes.xml:1448 #, no-c-format msgid "" "#411 Ability " @@ -6269,7 +6529,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1373 +#: release_notes.xml:1450 #, no-c-format msgid "" "#409 " @@ -6277,7 +6537,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1375 +#: release_notes.xml:1452 #, no-c-format msgid "" "#373 " @@ -6285,19 +6545,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1381 +#: release_notes.xml:1458 #, no-c-format msgid "Release 1.5.2" msgstr "" #. Tag: para -#: release_notes.xml:1382 +#: release_notes.xml:1459 #, no-c-format msgid "Release date: 2010/09/27" msgstr "" #. Tag: para -#: release_notes.xml:1383 +#: release_notes.xml:1460 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -6306,7 +6566,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1387 +#: release_notes.xml:1464 #, no-c-format msgid "" "Loader: fix handling of empty (0-verticed) geometries in shapefiles. (Sandro " @@ -6314,7 +6574,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1388 +#: release_notes.xml:1465 #, no-c-format msgid "" "#536, " @@ -6323,7 +6583,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1389 +#: release_notes.xml:1466 #, no-c-format msgid "" "#573, " @@ -6331,14 +6591,14 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1390 +#: release_notes.xml:1467 #, no-c-format msgid "" "Loader: Add support for command-q shutdown in Mac GTK build (Paul Ramsey)" msgstr "" #. Tag: para -#: release_notes.xml:1391 +#: release_notes.xml:1468 #, no-c-format msgid "" "#393, " @@ -6347,7 +6607,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1392 +#: release_notes.xml:1469 #, no-c-format msgid "" "#507, Fix " @@ -6355,7 +6615,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1393 +#: release_notes.xml:1470 #, no-c-format msgid "" "spatial_ref_sys.sql Add datum conversion for projection SRID 3021 (Paul " @@ -6363,7 +6623,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1394 +#: release_notes.xml:1471 #, no-c-format msgid "" "Geography - remove crash for case when all geographies are out of the " @@ -6371,7 +6631,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1395 +#: release_notes.xml:1472 #, no-c-format msgid "" "#469, Fix " @@ -6379,7 +6639,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1396 +#: release_notes.xml:1473 #, no-c-format msgid "" "#532, " @@ -6387,7 +6647,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1397 +#: release_notes.xml:1474 #, no-c-format msgid "" "#562, " @@ -6395,7 +6655,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1398 +#: release_notes.xml:1475 #, no-c-format msgid "" "#513, shape " @@ -6404,7 +6664,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1399 +#: release_notes.xml:1476 #, no-c-format msgid "" "#527, shape " @@ -6412,7 +6672,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1400 +#: release_notes.xml:1477 #, no-c-format msgid "" "#504, " @@ -6420,7 +6680,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1401 +#: release_notes.xml:1478 #, no-c-format msgid "" "#458, " @@ -6429,7 +6689,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1402 +#: release_notes.xml:1479 #, no-c-format msgid "" "#474, " @@ -6437,7 +6697,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1403 +#: release_notes.xml:1480 #, no-c-format msgid "" "#581, LWGEOM-" @@ -6445,7 +6705,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1404 +#: release_notes.xml:1481 #, no-c-format msgid "" "#513, Add " @@ -6453,13 +6713,13 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1405 +#: release_notes.xml:1482 #, no-c-format msgid "Fix further build issues against PostgreSQL 9.0 (Mark Cave-Ayland)" msgstr "" #. Tag: para -#: release_notes.xml:1406 +#: release_notes.xml:1483 #, no-c-format msgid "" "#572, " @@ -6467,7 +6727,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1407 +#: release_notes.xml:1484 #, no-c-format msgid "" "#603, " @@ -6475,19 +6735,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:1412 +#: release_notes.xml:1489 #, no-c-format msgid "Release 1.5.1" msgstr "" #. Tag: para -#: release_notes.xml:1413 +#: release_notes.xml:1490 #, no-c-format msgid "Release date: 2010/03/11" msgstr "" #. Tag: para -#: release_notes.xml:1414 +#: release_notes.xml:1491 #, no-c-format msgid "" "This is a bug fix release, addressing issues that have been filed since the " @@ -6496,7 +6756,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1418 +#: release_notes.xml:1495 #, no-c-format msgid "" "#410, update " @@ -6505,7 +6765,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1419 +#: release_notes.xml:1496 #, no-c-format msgid "" "#411, allow " @@ -6514,7 +6774,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1420 +#: release_notes.xml:1497 #, no-c-format msgid "" "#414, " @@ -6522,7 +6782,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1421 +#: release_notes.xml:1498 #, no-c-format msgid "" "#419, allow " @@ -6531,7 +6791,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1422 +#: release_notes.xml:1499 #, no-c-format msgid "" "#421, fix " @@ -6539,7 +6799,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1423 +#: release_notes.xml:1500 #, no-c-format msgid "" "#441, fix " @@ -6547,7 +6807,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1424 +#: release_notes.xml:1501 #, no-c-format msgid "" "#443, " @@ -6555,7 +6815,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:1425 +#: release_notes.xml:1502 #, no-c-format msgid "" "#450, between 1.0.0RC6 and 1.0.2highly " @@ -7986,79 +8246,79 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2044 +#: release_notes.xml:2121 #, no-c-format msgid "Fixed a premature exit in postgis_restore.pl" msgstr "" #. Tag: para -#: release_notes.xml:2046 +#: release_notes.xml:2123 #, no-c-format msgid "BUGFIX in geometrycollection handling of GEOS-CAPI connector" msgstr "" #. Tag: para -#: release_notes.xml:2049 +#: release_notes.xml:2126 #, no-c-format msgid "Solaris 2.7 and MingW support improvements" msgstr "" #. Tag: para -#: release_notes.xml:2051 +#: release_notes.xml:2128 #, no-c-format msgid "BUGFIX in line_locate_point()" msgstr "" #. Tag: para -#: release_notes.xml:2053 +#: release_notes.xml:2130 #, no-c-format msgid "Fixed handling of postgresql paths" msgstr "" #. Tag: para -#: release_notes.xml:2055 +#: release_notes.xml:2132 #, no-c-format msgid "BUGFIX in line_substring()" msgstr "" #. Tag: para -#: release_notes.xml:2057 +#: release_notes.xml:2134 #, no-c-format msgid "Added support for localized cluster in regress tester" msgstr "" #. Tag: para -#: release_notes.xml:2063 +#: release_notes.xml:2140 #, no-c-format msgid "New Z and M interpolation in line_substring()" msgstr "" #. Tag: para -#: release_notes.xml:2065 +#: release_notes.xml:2142 #, no-c-format msgid "New Z and M interpolation in line_interpolate_point()" msgstr "" #. Tag: para -#: release_notes.xml:2067 +#: release_notes.xml:2144 #, no-c-format msgid "added NumInteriorRing() alias due to OpenGIS ambiguity" msgstr "" #. Tag: title -#: release_notes.xml:2072 +#: release_notes.xml:2149 #, no-c-format msgid "Release 1.1.0" msgstr "" #. Tag: para -#: release_notes.xml:2074 +#: release_notes.xml:2151 #, no-c-format msgid "Release date: 2005/12/21" msgstr "" #. Tag: para -#: release_notes.xml:2076 +#: release_notes.xml:2153 #, no-c-format msgid "" "This is a Minor release, containing many improvements and new things. Most " @@ -8068,7 +8328,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2081 +#: release_notes.xml:2158 #, no-c-format msgid "" "It is highly recommended that you upgrade to GEOS-2.2.x " @@ -8077,13 +8337,13 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:2086 +#: release_notes.xml:2163 #, no-c-format msgid "Credits" msgstr "" #. Tag: para -#: release_notes.xml:2088 +#: release_notes.xml:2165 #, no-c-format msgid "" "This release includes code from Mark Cave Ayland for caching of proj4 " @@ -8097,7 +8357,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2102 +#: release_notes.xml:2179 #, no-c-format msgid "" "If you are upgrading from release 1.0.3 or later you DO NOTDO NOTDO NOT need " @@ -8615,25 +8875,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2381 +#: release_notes.xml:2458 #, no-c-format msgid "Memory leak plugged in GiST indexing" msgstr "" #. Tag: para -#: release_notes.xml:2383 +#: release_notes.xml:2460 #, no-c-format msgid "Segfault fix in transform() handling of proj4 errors" msgstr "" #. Tag: para -#: release_notes.xml:2385 +#: release_notes.xml:2462 #, no-c-format msgid "Fixed some proj4 texts in spatial_ref_sys (missing +proj)" msgstr "" #. Tag: para -#: release_notes.xml:2387 +#: release_notes.xml:2464 #, no-c-format msgid "" "Loader: fixed string functions usage, reworked NULL objects check, fixed " @@ -8641,67 +8901,67 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2390 +#: release_notes.xml:2467 #, no-c-format msgid "Fixed bug in MakeLine dimension handling" msgstr "" #. Tag: para -#: release_notes.xml:2392 +#: release_notes.xml:2469 #, no-c-format msgid "Fixed bug in translate() corrupting output bounding box" msgstr "" #. Tag: para -#: release_notes.xml:2398 +#: release_notes.xml:2475 #, no-c-format msgid "Documentation improvements" msgstr "" #. Tag: para -#: release_notes.xml:2400 +#: release_notes.xml:2477 #, no-c-format msgid "More robust selectivity estimator" msgstr "" #. Tag: para -#: release_notes.xml:2402 +#: release_notes.xml:2479 #, no-c-format msgid "Minor speedup in distance()" msgstr "" #. Tag: para -#: release_notes.xml:2404 +#: release_notes.xml:2481 #, no-c-format msgid "Minor cleanups" msgstr "" #. Tag: para -#: release_notes.xml:2406 +#: release_notes.xml:2483 #, no-c-format msgid "GiST indexing cleanup" msgstr "" #. Tag: para -#: release_notes.xml:2408 +#: release_notes.xml:2485 #, no-c-format msgid "Looser syntax acceptance in box3d parser" msgstr "" #. Tag: title -#: release_notes.xml:2413 +#: release_notes.xml:2490 #, no-c-format msgid "Release 1.0.3" msgstr "" #. Tag: para -#: release_notes.xml:2415 +#: release_notes.xml:2492 #, no-c-format msgid "Release date: 2005/08/08" msgstr "" #. Tag: para -#: release_notes.xml:2417 +#: release_notes.xml:2494 #, no-c-format msgid "" "Contains some bug fixes - including a severe one affecting " @@ -8709,7 +8969,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2424 +#: release_notes.xml:2501 #, no-c-format msgid "" "Due to a bug in a bounding box computation routine, the upgrade procedure " @@ -8718,7 +8978,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2428 +#: release_notes.xml:2505 #, no-c-format msgid "" "An hard upgrade procedure (dump/" @@ -8728,7 +8988,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2433 +#: release_notes.xml:2510 #, no-c-format msgid "" "If you are upgrading from versions 1.0.0RC6 or up, this release includes a " @@ -8742,79 +9002,79 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2446 +#: release_notes.xml:2523 #, no-c-format msgid "Severe bugfix in lwgeom's 2d bounding box computation" msgstr "" #. Tag: para -#: release_notes.xml:2448 +#: release_notes.xml:2525 #, no-c-format msgid "Bugfix in WKT (-w) POINT handling in loader" msgstr "" #. Tag: para -#: release_notes.xml:2450 +#: release_notes.xml:2527 #, no-c-format msgid "Bugfix in dumper on 64bit machines" msgstr "" #. Tag: para -#: release_notes.xml:2452 +#: release_notes.xml:2529 #, no-c-format msgid "Bugfix in dumper handling of user-defined queries" msgstr "" #. Tag: para -#: release_notes.xml:2454 +#: release_notes.xml:2531 #, no-c-format msgid "Bugfix in create_undef.pl script" msgstr "" #. Tag: para -#: release_notes.xml:2460 +#: release_notes.xml:2537 #, no-c-format msgid "Small performance improvement in canonical input function" msgstr "" #. Tag: para -#: release_notes.xml:2462 +#: release_notes.xml:2539 #, no-c-format msgid "Minor cleanups in loader" msgstr "" #. Tag: para -#: release_notes.xml:2464 +#: release_notes.xml:2541 #, no-c-format msgid "Support for multibyte field names in loader" msgstr "" #. Tag: para -#: release_notes.xml:2466 +#: release_notes.xml:2543 #, no-c-format msgid "Improvement in the postgis_restore.pl script" msgstr "" #. Tag: para -#: release_notes.xml:2468 +#: release_notes.xml:2545 #, no-c-format msgid "New rebuild_bbox_caches.pl util script" msgstr "" #. Tag: title -#: release_notes.xml:2473 +#: release_notes.xml:2550 #, no-c-format msgid "Release 1.0.2" msgstr "" #. Tag: para -#: release_notes.xml:2475 +#: release_notes.xml:2552 #, no-c-format msgid "Release date: 2005/07/04" msgstr "" #. Tag: para -#: release_notes.xml:2482 release_notes.xml:2522 +#: release_notes.xml:2559 release_notes.xml:2599 #, no-c-format msgid "" "If you are upgrading from release 1.0.0RC6 or up you DO NOTDO NOT " @@ -8984,7 +9244,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2577 release_notes.xml:2668 +#: release_notes.xml:2654 release_notes.xml:2745 #, no-c-format msgid "" "Upgrading from any other precedent release requires a dump/reload. See the " @@ -8992,87 +9252,87 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2585 +#: release_notes.xml:2662 #, no-c-format msgid "BUGFIX in transform() releasing random memory address" msgstr "" #. Tag: para -#: release_notes.xml:2587 +#: release_notes.xml:2664 #, no-c-format msgid "BUGFIX in force_3dm() allocating less memory then required" msgstr "" #. Tag: para -#: release_notes.xml:2590 +#: release_notes.xml:2667 #, no-c-format msgid "BUGFIX in join selectivity estimator (defaults, leaks, tuplecount, sd)" msgstr "" #. Tag: para -#: release_notes.xml:2597 +#: release_notes.xml:2674 #, no-c-format msgid "BUGFIX in shp2pgsql escape of values starting with tab or single-quote" msgstr "" #. Tag: para -#: release_notes.xml:2600 +#: release_notes.xml:2677 #, no-c-format msgid "NEW manual pages for loader/dumper" msgstr "" #. Tag: para -#: release_notes.xml:2602 +#: release_notes.xml:2679 #, no-c-format msgid "NEW shp2pgsql support for old (HWGEOM) postgis versions" msgstr "" #. Tag: para -#: release_notes.xml:2604 +#: release_notes.xml:2681 #, no-c-format msgid "NEW -p (prepare) flag for shp2pgsql" msgstr "" #. Tag: para -#: release_notes.xml:2606 +#: release_notes.xml:2683 #, no-c-format msgid "NEW manual chapter about OGC compliancy enforcement" msgstr "" #. Tag: para -#: release_notes.xml:2608 +#: release_notes.xml:2685 #, no-c-format msgid "NEW autoconf support for JTS lib" msgstr "" #. Tag: para -#: release_notes.xml:2610 +#: release_notes.xml:2687 #, no-c-format msgid "BUGFIX in estimator testers (support for LWGEOM and schema parsing)" msgstr "" #. Tag: title -#: release_notes.xml:2616 +#: release_notes.xml:2693 #, no-c-format msgid "Release 1.0.0RC6" msgstr "" #. Tag: para -#: release_notes.xml:2618 +#: release_notes.xml:2695 #, no-c-format msgid "Release date: 2005/03/30" msgstr "" #. Tag: para -#: release_notes.xml:2620 +#: release_notes.xml:2697 #, no-c-format msgid "" "Sixth release candidate for 1.0.0. Contains a few bug fixes and cleanups." msgstr "" #. Tag: para -#: release_notes.xml:2626 release_notes.xml:2702 release_notes.xml:2769 -#: release_notes.xml:2866 release_notes.xml:2920 +#: release_notes.xml:2703 release_notes.xml:2779 release_notes.xml:2846 +#: release_notes.xml:2943 release_notes.xml:2997 #, no-c-format msgid "" "You need a dump/reload to upgrade from precedent releases. See the DO NOT " @@ -9145,43 +9405,43 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2676 +#: release_notes.xml:2753 #, no-c-format msgid "BUGFIX (segfaulting) in box3d computation (yes, another!)." msgstr "" #. Tag: para -#: release_notes.xml:2679 +#: release_notes.xml:2756 #, no-c-format msgid "BUGFIX (segfaulting) in estimated_extent()." msgstr "" #. Tag: para -#: release_notes.xml:2685 +#: release_notes.xml:2762 #, no-c-format msgid "Small build scripts and utilities refinements." msgstr "" #. Tag: para -#: release_notes.xml:2687 +#: release_notes.xml:2764 #, no-c-format msgid "Additional performance tips documented." msgstr "" #. Tag: title -#: release_notes.xml:2692 +#: release_notes.xml:2769 #, no-c-format msgid "Release 1.0.0RC4" msgstr "" #. Tag: para -#: release_notes.xml:2694 +#: release_notes.xml:2771 #, no-c-format msgid "Release date: 2005/03/18" msgstr "" #. Tag: para -#: release_notes.xml:2696 +#: release_notes.xml:2773 #, no-c-format msgid "" "Fourth release candidate for 1.0.0. Contains bug fixes and a few " @@ -9189,80 +9449,80 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2710 +#: release_notes.xml:2787 #, no-c-format msgid "BUGFIX (segfaulting) in geom_accum()." msgstr "" #. Tag: para -#: release_notes.xml:2712 +#: release_notes.xml:2789 #, no-c-format msgid "BUGFIX in 64bit architectures support." msgstr "" #. Tag: para -#: release_notes.xml:2714 +#: release_notes.xml:2791 #, no-c-format msgid "BUGFIX in box3d computation function with collections." msgstr "" #. Tag: para -#: release_notes.xml:2716 +#: release_notes.xml:2793 #, no-c-format msgid "NEW subselects support in selectivity estimator." msgstr "" #. Tag: para -#: release_notes.xml:2718 +#: release_notes.xml:2795 #, no-c-format msgid "Early return from force_collection." msgstr "" #. Tag: para -#: release_notes.xml:2720 +#: release_notes.xml:2797 #, no-c-format msgid "Consistency check fix in SnapToGrid()." msgstr "" #. Tag: para -#: release_notes.xml:2722 +#: release_notes.xml:2799 #, no-c-format msgid "Box2d output changed back to 15 significant digits." msgstr "" #. Tag: para -#: release_notes.xml:2728 +#: release_notes.xml:2805 #, no-c-format msgid "NEW distance_sphere() function." msgstr "" #. Tag: para -#: release_notes.xml:2730 +#: release_notes.xml:2807 #, no-c-format msgid "" "Changed get_proj4_from_srid implementation to use PL/PGSQL instead of SQL." msgstr "" #. Tag: para -#: release_notes.xml:2737 +#: release_notes.xml:2814 #, no-c-format msgid "BUGFIX in loader and dumper handling of MultiLine shapes" msgstr "" #. Tag: para -#: release_notes.xml:2739 +#: release_notes.xml:2816 #, no-c-format msgid "BUGFIX in loader, skipping all but first hole of polygons." msgstr "" #. Tag: para -#: release_notes.xml:2742 +#: release_notes.xml:2819 #, no-c-format msgid "jdbc2: code cleanups, Makefile improvements" msgstr "" #. Tag: para -#: release_notes.xml:2744 +#: release_notes.xml:2821 #, no-c-format msgid "" "FLEX and YACC variables set *after* pgsql Makefile.global is included and " @@ -9270,62 +9530,62 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2748 +#: release_notes.xml:2825 #, no-c-format msgid "Added already generated parser in release" msgstr "" #. Tag: para -#: release_notes.xml:2750 +#: release_notes.xml:2827 #, no-c-format msgid "Build scripts refinements" msgstr "" #. Tag: para -#: release_notes.xml:2752 +#: release_notes.xml:2829 #, no-c-format msgid "improved version handling, central Version.config" msgstr "" #. Tag: para -#: release_notes.xml:2754 +#: release_notes.xml:2831 #, no-c-format msgid "improvements in postgis_restore.pl" msgstr "" #. Tag: title -#: release_notes.xml:2759 +#: release_notes.xml:2836 #, no-c-format msgid "Release 1.0.0RC3" msgstr "" #. Tag: para -#: release_notes.xml:2761 +#: release_notes.xml:2838 #, no-c-format msgid "Release date: 2005/02/24" msgstr "" #. Tag: para -#: release_notes.xml:2763 +#: release_notes.xml:2840 #, no-c-format msgid "" "Third release candidate for 1.0.0. Contains many bug fixes and improvements." msgstr "" #. Tag: para -#: release_notes.xml:2777 +#: release_notes.xml:2854 #, no-c-format msgid "BUGFIX in transform(): missing SRID, better error handling." msgstr "" #. Tag: para -#: release_notes.xml:2780 +#: release_notes.xml:2857 #, no-c-format msgid "BUGFIX in memory alignment handling" msgstr "" #. Tag: para -#: release_notes.xml:2782 +#: release_notes.xml:2859 #, no-c-format msgid "" "BUGFIX in force_collection() causing mapserver connector failures on simple " @@ -9333,43 +9593,43 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2785 +#: release_notes.xml:2862 #, no-c-format msgid "BUGFIX in GeometryFromText() missing to add a bbox cache." msgstr "" #. Tag: para -#: release_notes.xml:2787 +#: release_notes.xml:2864 #, no-c-format msgid "reduced precision of box2d output." msgstr "" #. Tag: para -#: release_notes.xml:2789 +#: release_notes.xml:2866 #, no-c-format msgid "prefixed DEBUG macros with PGIS_ to avoid clash with pgsql one" msgstr "" #. Tag: para -#: release_notes.xml:2792 +#: release_notes.xml:2869 #, no-c-format msgid "plugged a leak in GEOS2POSTGIS converter" msgstr "" #. Tag: para -#: release_notes.xml:2794 +#: release_notes.xml:2871 #, no-c-format msgid "Reduced memory usage by early releasing query-context palloced one." msgstr "" #. Tag: para -#: release_notes.xml:2801 +#: release_notes.xml:2878 #, no-c-format msgid "BUGFIX in 72 index bindings." msgstr "" #. Tag: para -#: release_notes.xml:2803 +#: release_notes.xml:2880 #, no-c-format msgid "" "BUGFIX in probe_geometry_columns() to work with PG72 and support multiple " @@ -9377,31 +9637,31 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2806 +#: release_notes.xml:2883 #, no-c-format msgid "NEW bool::text cast" msgstr "" #. Tag: para -#: release_notes.xml:2808 +#: release_notes.xml:2885 #, no-c-format msgid "Some functions made IMMUTABLE from STABLE, for performance improvement." msgstr "" #. Tag: para -#: release_notes.xml:2815 +#: release_notes.xml:2892 #, no-c-format msgid "jdbc2: small patches, box2d/3d tests, revised docs and license." msgstr "" #. Tag: para -#: release_notes.xml:2818 +#: release_notes.xml:2895 #, no-c-format msgid "jdbc2: bug fix and testcase in for pgjdbc 8.0 type autoregistration" msgstr "" #. Tag: para -#: release_notes.xml:2821 +#: release_notes.xml:2898 #, no-c-format msgid "" "jdbc2: Removed use of jdk1.4 only features to enable build with older jdk " @@ -9409,67 +9669,67 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2824 +#: release_notes.xml:2901 #, no-c-format msgid "jdbc2: Added support for building against pg72jdbc2.jar" msgstr "" #. Tag: para -#: release_notes.xml:2826 +#: release_notes.xml:2903 #, no-c-format msgid "jdbc2: updated and cleaned makefile" msgstr "" #. Tag: para -#: release_notes.xml:2828 +#: release_notes.xml:2905 #, no-c-format msgid "jdbc2: added BETA support for jts geometry classes" msgstr "" #. Tag: para -#: release_notes.xml:2830 +#: release_notes.xml:2907 #, no-c-format msgid "jdbc2: Skip known-to-fail tests against older PostGIS servers." msgstr "" #. Tag: para -#: release_notes.xml:2833 +#: release_notes.xml:2910 #, no-c-format msgid "jdbc2: Fixed handling of measured geometries in EWKT." msgstr "" #. Tag: para -#: release_notes.xml:2839 +#: release_notes.xml:2916 #, no-c-format msgid "new performance tips chapter in manual" msgstr "" #. Tag: para -#: release_notes.xml:2841 +#: release_notes.xml:2918 #, no-c-format msgid "documentation updates: pgsql72 requirement, lwpostgis.sql" msgstr "" #. Tag: para -#: release_notes.xml:2843 +#: release_notes.xml:2920 #, no-c-format msgid "few changes in autoconf" msgstr "" #. Tag: para -#: release_notes.xml:2845 +#: release_notes.xml:2922 #, no-c-format msgid "BUILDDATE extraction made more portable" msgstr "" #. Tag: para -#: release_notes.xml:2847 +#: release_notes.xml:2924 #, no-c-format msgid "fixed spatial_ref_sys.sql to avoid vacuuming the whole database." msgstr "" #. Tag: para -#: release_notes.xml:2850 +#: release_notes.xml:2927 #, no-c-format msgid "" "spatial_ref_sys: changed Paris entries to match the ones distributed with 0." @@ -9477,19 +9737,19 @@ msgid "" msgstr "" #. Tag: title -#: release_notes.xml:2856 +#: release_notes.xml:2933 #, no-c-format msgid "Release 1.0.0RC2" msgstr "" #. Tag: para -#: release_notes.xml:2858 +#: release_notes.xml:2935 #, no-c-format msgid "Release date: 2005/01/26" msgstr "" #. Tag: para -#: release_notes.xml:2860 +#: release_notes.xml:2937 #, no-c-format msgid "" "Second release candidate for 1.0.0 containing bug fixes and a few " @@ -9497,85 +9757,85 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2874 +#: release_notes.xml:2951 #, no-c-format msgid "BUGFIX in pointarray box3d computation" msgstr "" #. Tag: para -#: release_notes.xml:2876 +#: release_notes.xml:2953 #, no-c-format msgid "BUGFIX in distance_spheroid definition" msgstr "" #. Tag: para -#: release_notes.xml:2878 +#: release_notes.xml:2955 #, no-c-format msgid "BUGFIX in transform() missing to update bbox cache" msgstr "" #. Tag: para -#: release_notes.xml:2880 +#: release_notes.xml:2957 #, no-c-format msgid "NEW jdbc driver (jdbc2)" msgstr "" #. Tag: para -#: release_notes.xml:2882 +#: release_notes.xml:2959 #, no-c-format msgid "GEOMETRYCOLLECTION(EMPTY) syntax support for backward compatibility" msgstr "" #. Tag: para -#: release_notes.xml:2885 +#: release_notes.xml:2962 #, no-c-format msgid "Faster binary outputs" msgstr "" #. Tag: para -#: release_notes.xml:2887 +#: release_notes.xml:2964 #, no-c-format msgid "Stricter OGC WKB/WKT constructors" msgstr "" #. Tag: para -#: release_notes.xml:2893 +#: release_notes.xml:2970 #, no-c-format msgid "More correct STABLE, IMMUTABLE, STRICT uses in lwpostgis.sql" msgstr "" #. Tag: para -#: release_notes.xml:2896 +#: release_notes.xml:2973 #, no-c-format msgid "stricter OGC WKB/WKT constructors" msgstr "" #. Tag: para -#: release_notes.xml:2902 +#: release_notes.xml:2979 #, no-c-format msgid "Faster and more robust loader (both i18n and not)" msgstr "" #. Tag: para -#: release_notes.xml:2904 +#: release_notes.xml:2981 #, no-c-format msgid "Initial autoconf script" msgstr "" #. Tag: title -#: release_notes.xml:2909 +#: release_notes.xml:2986 #, no-c-format msgid "Release 1.0.0RC1" msgstr "" #. Tag: para -#: release_notes.xml:2911 +#: release_notes.xml:2988 #, no-c-format msgid "Release date: 2005/01/13" msgstr "" #. Tag: para -#: release_notes.xml:2913 +#: release_notes.xml:2990 #, no-c-format msgid "" "This is the first candidate of a major postgis release, with internal " @@ -9584,25 +9844,25 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2928 +#: release_notes.xml:3005 #, no-c-format msgid "Faster canonical input parsing." msgstr "" #. Tag: para -#: release_notes.xml:2930 +#: release_notes.xml:3007 #, no-c-format msgid "Lossless canonical output." msgstr "" #. Tag: para -#: release_notes.xml:2932 +#: release_notes.xml:3009 #, no-c-format msgid "EWKB Canonical binary IO with PG>73." msgstr "" #. Tag: para -#: release_notes.xml:2934 +#: release_notes.xml:3011 #, no-c-format msgid "" "Support for up to 4d coordinates, providing lossless shapefile->postgis-" @@ -9610,7 +9870,7 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2937 +#: release_notes.xml:3014 #, no-c-format msgid "" "New function: UpdateGeometrySRID(), AsGML(), SnapToGrid(), ForceRHR(), " @@ -9618,31 +9878,31 @@ msgid "" msgstr "" #. Tag: para -#: release_notes.xml:2940 +#: release_notes.xml:3017 #, no-c-format msgid "Vertical positioning indexed operators." msgstr "" #. Tag: para -#: release_notes.xml:2942 +#: release_notes.xml:3019 #, no-c-format msgid "JOIN selectivity function." msgstr "" #. Tag: para -#: release_notes.xml:2944 +#: release_notes.xml:3021 #, no-c-format msgid "More geometry constructors / editors." msgstr "" #. Tag: para -#: release_notes.xml:2946 +#: release_notes.xml:3023 #, no-c-format msgid "PostGIS extension API." msgstr "" #. Tag: para -#: release_notes.xml:2948 +#: release_notes.xml:3025 #, no-c-format msgid "UTF8 support in loader." msgstr "" diff --git a/doc/po/templates/reporting.xml.pot b/doc/po/templates/reporting.xml.pot index c5fc4c908..a26576073 100644 --- a/doc/po/templates/reporting.xml.pot +++ b/doc/po/templates/reporting.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:03+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/using_postgis_app.xml.pot b/doc/po/templates/using_postgis_app.xml.pot index f7b84107c..5d0d24a95 100644 --- a/doc/po/templates/using_postgis_app.xml.pot +++ b/doc/po/templates/using_postgis_app.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:03+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/doc/po/templates/using_postgis_dataman.xml.pot b/doc/po/templates/using_postgis_dataman.xml.pot index e3e2909ad..5b03911fd 100644 --- a/doc/po/templates/using_postgis_dataman.xml.pot +++ b/doc/po/templates/using_postgis_dataman.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2018-07-21 17:36+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -2633,7 +2633,7 @@ msgstr "" #. Tag: term #: using_postgis_dataman.xml:1474 #, no-c-format -msgid "-s [<FROM_SRID%gt;:]<SRID>" +msgid "-s [<FROM_SRID>:]<SRID>" msgstr "" #. Tag: para @@ -2642,18 +2642,17 @@ msgstr "" 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." +"which case the geometries will be reprojected to the target SRID." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1487 +#: using_postgis_dataman.xml:1486 #, no-c-format msgid "-k" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1489 +#: using_postgis_dataman.xml:1488 #, no-c-format msgid "" "Keep identifiers' case (column, schema and attributes). Note that attributes " @@ -2661,13 +2660,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1497 +#: using_postgis_dataman.xml:1496 #, no-c-format msgid "-i" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1499 +#: using_postgis_dataman.xml:1498 #, no-c-format msgid "" "Coerce all integers to standard 32-bit integers, do not create 64-bit " @@ -2675,25 +2674,25 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1507 +#: using_postgis_dataman.xml:1506 #, no-c-format msgid "-I" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1509 +#: using_postgis_dataman.xml:1508 #, no-c-format msgid "Create a GiST index on the geometry column." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1516 +#: using_postgis_dataman.xml:1515 #, no-c-format msgid "-m" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1518 +#: using_postgis_dataman.xml:1517 #, no-c-format msgid "" "-m a_file_name Specify a file containing a set of " @@ -2703,7 +2702,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1523 +#: using_postgis_dataman.xml:1522 #, no-c-format msgid "" "COLUMNNAME DBFFIELD1\n" @@ -2711,13 +2710,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1529 +#: using_postgis_dataman.xml:1528 #, no-c-format msgid "-S" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1531 +#: using_postgis_dataman.xml:1530 #, no-c-format msgid "" "Generate simple geometries instead of MULTI geometries. Will only succeed if " @@ -2726,13 +2725,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1540 +#: using_postgis_dataman.xml:1539 #, no-c-format msgid "-t <dimensionality>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1542 +#: using_postgis_dataman.xml:1541 #, no-c-format msgid "" "Force the output geometry to have the specified dimensionality. Use the " @@ -2740,7 +2739,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1546 +#: using_postgis_dataman.xml:1545 #, no-c-format msgid "" "If the input has fewer dimensions that specified, the output will have those " @@ -2749,13 +2748,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1555 +#: using_postgis_dataman.xml:1554 #, no-c-format msgid "-w" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1557 +#: using_postgis_dataman.xml:1556 #, no-c-format msgid "" "Output WKT format, instead of WKB. Note that this can introduce coordinate " @@ -2763,13 +2762,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1565 +#: using_postgis_dataman.xml:1564 #, no-c-format msgid "-e" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1567 +#: using_postgis_dataman.xml:1566 #, no-c-format msgid "" "Execute each statement on its own, without using a transaction. This allows " @@ -2779,13 +2778,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1577 +#: using_postgis_dataman.xml:1576 #, no-c-format msgid "-W <encoding>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1579 +#: using_postgis_dataman.xml:1578 #, no-c-format msgid "" "Specify encoding of the input data (dbf file). When used, all attributes of " @@ -2796,25 +2795,25 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1589 +#: using_postgis_dataman.xml:1588 #, no-c-format msgid "-N <policy>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1591 +#: using_postgis_dataman.xml:1590 #, no-c-format msgid "NULL geometries handling policy (insert*,skip,abort)" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1597 +#: using_postgis_dataman.xml:1596 #, no-c-format msgid "-n" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1599 +#: using_postgis_dataman.xml:1598 #, no-c-format msgid "" "-n Only import DBF file. If your data has no corresponding shapefile, it " @@ -2824,13 +2823,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1607 +#: using_postgis_dataman.xml:1606 #, no-c-format msgid "-G" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1609 +#: using_postgis_dataman.xml:1608 #, no-c-format msgid "" "Use geography type instead of geometry (requires lon/lat data) in WGS84 long " @@ -2838,13 +2837,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1615 +#: using_postgis_dataman.xml:1614 #, no-c-format msgid "-T <tablespace>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1617 +#: using_postgis_dataman.xml:1616 #, no-c-format msgid "" "Specify the tablespace for the new table. Indexes will still use the default " @@ -2853,13 +2852,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1625 +#: using_postgis_dataman.xml:1624 #, no-c-format msgid "-X <tablespace>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1627 +#: using_postgis_dataman.xml:1626 #, no-c-format msgid "" "Specify the tablespace for the new table's indexes. This applies to the " @@ -2867,7 +2866,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1635 +#: using_postgis_dataman.xml:1634 #, no-c-format msgid "" "An example session using the loader to create an input file and uploading it " @@ -2875,7 +2874,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1640 +#: using_postgis_dataman.xml:1639 #, no-c-format msgid "" "# shp2pgsql -c -D -s 4269 -i -I shaperoads.shp myschema.roadstable > " @@ -2884,25 +2883,25 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1642 +#: using_postgis_dataman.xml:1641 #, 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:1646 +#: using_postgis_dataman.xml:1645 #, no-c-format msgid "# shp2pgsql shaperoads.shp myschema.roadstable | psql -d roadsdb" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:1651 +#: using_postgis_dataman.xml:1650 #, no-c-format msgid "Retrieving GIS Data" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1653 +#: using_postgis_dataman.xml:1652 #, no-c-format msgid "" "Data can be extracted from the database using either SQL or the Shape file " @@ -2911,13 +2910,13 @@ msgid "" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:1659 +#: using_postgis_dataman.xml:1658 #, no-c-format msgid "Using SQL to Retrieve Data" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1661 +#: using_postgis_dataman.xml:1660 #, no-c-format msgid "" "The most straightforward means of pulling data out of the database is to use " @@ -2926,7 +2925,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1666 +#: using_postgis_dataman.xml:1665 #, no-c-format msgid "" "db=# SELECT road_id, ST_AsText(road_geom) AS geom, road_name FROM roads;\n" @@ -2944,7 +2943,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1668 +#: using_postgis_dataman.xml:1667 #, no-c-format msgid "" "However, there will be times when some kind of restriction is necessary to " @@ -2955,25 +2954,25 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1676 +#: using_postgis_dataman.xml:1675 #, no-c-format msgid "ST_Intersects" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1679 +#: using_postgis_dataman.xml:1678 #, no-c-format msgid "This function tells whether two geometries share any space." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1684 +#: using_postgis_dataman.xml:1683 #, no-c-format msgid "=" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1687 +#: using_postgis_dataman.xml:1686 #, no-c-format msgid "" "This tests whether two geometries are geometrically identical. For example, " @@ -2982,13 +2981,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1691 +#: using_postgis_dataman.xml:1690 #, no-c-format msgid "Note: before PostGIS 2.4 this compared only boxes of geometries." msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1696 +#: using_postgis_dataman.xml:1695 #, no-c-format msgid "" "Next, you can use these operators in queries. Note that when specifying " @@ -2998,7 +2997,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1702 +#: using_postgis_dataman.xml:1701 #, no-c-format msgid "" "SELECT road_id, road_name\n" @@ -3008,7 +3007,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1704 +#: using_postgis_dataman.xml:1703 #, no-c-format msgid "" "The above query would return the single record from the \"ROADS_GEOM\" table " @@ -3016,14 +3015,14 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1707 +#: using_postgis_dataman.xml:1706 #, no-c-format msgid "" "To check whether some of the roads passes in the area defined by a polygon:" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1709 +#: using_postgis_dataman.xml:1708 #, no-c-format msgid "" "SELECT road_id, road_name\n" @@ -3032,7 +3031,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1713 +#: using_postgis_dataman.xml:1712 #, no-c-format msgid "" "The most common spatial query will probably be a \"frame-based\" query, used " @@ -3041,7 +3040,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1716 +#: using_postgis_dataman.xml:1715 #, no-c-format msgid "" "When using the \"&&\" operator, you can specify either a BOX3D as " @@ -3050,13 +3049,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1720 +#: using_postgis_dataman.xml:1719 #, no-c-format msgid "Using a \"BOX3D\" object for the frame, such a query looks like this:" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1722 +#: using_postgis_dataman.xml:1721 #, no-c-format msgid "" "SELECT ST_AsText(roads_geom) AS geom\n" @@ -3066,20 +3065,20 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1724 +#: using_postgis_dataman.xml:1723 #, 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:1730 +#: using_postgis_dataman.xml:1729 #, no-c-format msgid "Using the Dumper" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1732 +#: using_postgis_dataman.xml:1731 #, no-c-format msgid "" "The pgsql2shp table dumper connects directly to the " @@ -3088,92 +3087,92 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1736 +#: using_postgis_dataman.xml:1735 #, no-c-format msgid "" "pgsql2shp [<options>] <database> [<schema>.]<table>" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1738 +#: using_postgis_dataman.xml:1737 #, no-c-format msgid "pgsql2shp [<options>] <database> <query>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1740 +#: using_postgis_dataman.xml:1739 #, no-c-format msgid "The commandline options are:" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1744 +#: using_postgis_dataman.xml:1743 #, no-c-format msgid "-f <filename>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1747 +#: using_postgis_dataman.xml:1746 #, no-c-format msgid "Write the output to a particular filename." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1752 +#: using_postgis_dataman.xml:1751 #, no-c-format msgid "-h <host>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1755 +#: using_postgis_dataman.xml:1754 #, no-c-format msgid "The database host to connect to." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1760 +#: using_postgis_dataman.xml:1759 #, no-c-format msgid "-p <port>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1763 +#: using_postgis_dataman.xml:1762 #, no-c-format msgid "The port to connect to on the database host." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1768 +#: using_postgis_dataman.xml:1767 #, no-c-format msgid "-P <password>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1771 +#: using_postgis_dataman.xml:1770 #, no-c-format msgid "The password to use when connecting to the database." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1776 +#: using_postgis_dataman.xml:1775 #, no-c-format msgid "-u <user>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1779 +#: using_postgis_dataman.xml:1778 #, no-c-format msgid "The username to use when connecting to the database." msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1784 +#: using_postgis_dataman.xml:1783 #, no-c-format msgid "-g <geometry column>" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1787 +#: using_postgis_dataman.xml:1786 #, no-c-format msgid "" "In the case of tables with multiple geometry columns, the geometry column to " @@ -3181,13 +3180,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1793 +#: using_postgis_dataman.xml:1792 #, no-c-format msgid "-b" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1796 +#: using_postgis_dataman.xml:1795 #, no-c-format msgid "" "Use a binary cursor. This will make the operation faster, but will not work " @@ -3195,13 +3194,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1803 +#: using_postgis_dataman.xml:1802 #, no-c-format msgid "-r" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1806 +#: using_postgis_dataman.xml:1805 #, no-c-format msgid "" "Raw mode. Do not drop the gid field, or escape column " @@ -3209,13 +3208,13 @@ msgid "" msgstr "" #. Tag: term -#: using_postgis_dataman.xml:1812 +#: using_postgis_dataman.xml:1811 #, no-c-format msgid "-m filename" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1814 +#: using_postgis_dataman.xml:1813 #, no-c-format msgid "" "Remap identifiers to ten character names. The content of the file is lines " @@ -3224,13 +3223,13 @@ msgid "" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:1827 +#: using_postgis_dataman.xml:1826 #, no-c-format msgid "Building Indexes" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1829 +#: using_postgis_dataman.xml:1828 #, no-c-format msgid "" "Indexes are what make using a spatial database for large data sets possible. " @@ -3242,7 +3241,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1838 +#: using_postgis_dataman.xml:1837 #, no-c-format msgid "" "B-Trees are used for data which can be sorted along one axis; for example, " @@ -3252,7 +3251,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1845 +#: using_postgis_dataman.xml:1844 #, no-c-format msgid "" "GiST (Generalized Search Trees) indexes break up data into \"things to one " @@ -3262,13 +3261,13 @@ msgid "" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:1854 +#: using_postgis_dataman.xml:1853 #, no-c-format msgid "GiST Indexes" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1856 +#: using_postgis_dataman.xml:1855 #, no-c-format msgid "" "GiST stands for \"Generalized Search Tree\" and is a generic form of " @@ -3278,7 +3277,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1861 +#: using_postgis_dataman.xml:1860 #, no-c-format msgid "" "Once a GIS data table exceeds a few thousand rows, you will want to build an " @@ -3288,20 +3287,20 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1866 +#: using_postgis_dataman.xml:1865 #, 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:1870 +#: using_postgis_dataman.xml:1869 #, no-c-format msgid "CREATE INDEX [indexname] ON [tablename] USING GIST ( [geometryfield] );" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1872 +#: using_postgis_dataman.xml:1871 #, no-c-format msgid "" "The above syntax will always build a 2D-index. To get the an n-dimensional " @@ -3309,7 +3308,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1873 +#: using_postgis_dataman.xml:1872 #, no-c-format msgid "" "CREATE INDEX [indexname] ON [tablename] USING GIST ([geometryfield] " @@ -3317,7 +3316,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1875 +#: using_postgis_dataman.xml:1874 #, no-c-format msgid "" "Building a spatial index is a computationally intensive exercise. It also " @@ -3326,7 +3325,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1876 +#: using_postgis_dataman.xml:1875 #, no-c-format msgid "" "CREATE INDEX CONCURRENTLY [indexname] ON [tablename] USING GIST " @@ -3334,7 +3333,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1878 using_postgis_dataman.xml:1991 +#: using_postgis_dataman.xml:1877 using_postgis_dataman.xml:1990 #, no-c-format msgid "" "After building an index, it is sometimes helpful to force PostgreSQL to " @@ -3342,19 +3341,19 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1881 using_postgis_dataman.xml:1994 +#: using_postgis_dataman.xml:1880 using_postgis_dataman.xml:1993 #, no-c-format msgid "VACUUM ANALYZE [table_name] [(column_name)];" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:1886 +#: using_postgis_dataman.xml:1885 #, no-c-format msgid "BRIN Indexes" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1888 +#: using_postgis_dataman.xml:1887 #, no-c-format msgid "" "BRIN stands for \"Block Range Index\" and is a generic form of indexing that " @@ -3368,7 +3367,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1897 +#: using_postgis_dataman.xml:1896 #, no-c-format msgid "" "Once a GIS data table exceeds a few thousand rows, you will want to build an " @@ -3381,7 +3380,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1906 +#: using_postgis_dataman.xml:1905 #, no-c-format msgid "" "The idea of a BRIN index is to store only the bouding box englobing all the " @@ -3393,7 +3392,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1914 +#: using_postgis_dataman.xml:1913 #, no-c-format msgid "" "Building a BRIN index is way less intensive than building a GiST index. It's " @@ -3404,7 +3403,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1920 +#: using_postgis_dataman.xml:1919 #, no-c-format msgid "" "You can choose the number of blocks to summarize in a range. If you decrease " @@ -3413,20 +3412,20 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1924 +#: using_postgis_dataman.xml:1923 #, no-c-format msgid "" "The syntax for building a BRIN index on a \"geometry\" column is as follows:" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1927 +#: using_postgis_dataman.xml:1926 #, no-c-format msgid "CREATE INDEX [indexname] ON [tablename] USING BRIN ( [geometryfield] );" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1928 +#: using_postgis_dataman.xml:1927 #, no-c-format msgid "" "The above syntax will always build a 2D-index. To get a 3D-dimensional " @@ -3434,7 +3433,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1929 +#: using_postgis_dataman.xml:1928 #, no-c-format msgid "" "CREATE INDEX [indexname] ON [tablename] USING BRIN ([geometryfield] " @@ -3442,13 +3441,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1930 +#: using_postgis_dataman.xml:1929 #, no-c-format msgid "You can also get a 4D-dimensional index using the 4D operator class" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1931 +#: using_postgis_dataman.xml:1930 #, no-c-format msgid "" "CREATE INDEX [indexname] ON [tablename] USING BRIN ([geometryfield] " @@ -3456,7 +3455,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1932 +#: using_postgis_dataman.xml:1931 #, no-c-format msgid "" "These above syntaxes will use the default number or block in a range, which " @@ -3465,7 +3464,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1933 +#: using_postgis_dataman.xml:1932 #, no-c-format msgid "" "CREATE INDEX [indexname] ON [tablename] USING BRIN ( [geometryfield] ) WITH " @@ -3473,7 +3472,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1934 +#: using_postgis_dataman.xml:1933 #, no-c-format msgid "" "Also, keep in mind that a BRIN index will only store one index value for a " @@ -3484,7 +3483,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1942 +#: using_postgis_dataman.xml:1941 #, no-c-format msgid "" "Also the \"geography\" datatype is supported for BRIN indexing. The syntax " @@ -3492,14 +3491,14 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1945 +#: using_postgis_dataman.xml:1944 #, no-c-format msgid "" "CREATE INDEX [indexname] ON [tablename] USING BRIN ( [geographyfield] );" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1946 +#: using_postgis_dataman.xml:1945 #, no-c-format msgid "" "The above syntax will always build a 2D-index for geospatial objects on the " @@ -3507,7 +3506,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1948 +#: using_postgis_dataman.xml:1947 #, no-c-format msgid "" "Currently, just the \"inclusion support\" is considered here, meaning that " @@ -3519,13 +3518,13 @@ msgid "" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:1957 +#: using_postgis_dataman.xml:1956 #, no-c-format msgid "SP-GiST Indexes" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1959 +#: using_postgis_dataman.xml:1958 #, no-c-format msgid "" "SP-GiST stands for \"Space-Partitioned Generalized Search Tree\" and is a " @@ -3538,7 +3537,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1967 +#: using_postgis_dataman.xml:1966 #, no-c-format msgid "" "As it is the case for GiST indexes, SP-GiST indexes are lossy, in the sense " @@ -3549,7 +3548,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1974 +#: using_postgis_dataman.xml:1973 #, no-c-format msgid "" "Once a GIS data table exceeds a few thousand rows, an SP-GiST index may be " @@ -3558,14 +3557,14 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1978 +#: using_postgis_dataman.xml:1977 #, no-c-format msgid "" "CREATE INDEX [indexname] ON [tablename] USING SPGIST ( [geometryfield] );" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1980 +#: using_postgis_dataman.xml:1979 #, no-c-format msgid "" "The above syntax will build a 2-dimensional index. A 3-dimensional index for " @@ -3573,7 +3572,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1983 +#: using_postgis_dataman.xml:1982 #, no-c-format msgid "" "CREATE INDEX [indexname] ON [tablename] USING SPGIST ([geometryfield] " @@ -3581,7 +3580,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1985 +#: using_postgis_dataman.xml:1984 #, no-c-format msgid "" "Building a spatial index is a computationally intensive operation. It also " @@ -3590,7 +3589,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:1989 +#: using_postgis_dataman.xml:1988 #, no-c-format msgid "" "CREATE INDEX CONCURRENTLY [indexname] ON [tablename] USING SPGIST " @@ -3598,14 +3597,14 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1996 +#: using_postgis_dataman.xml:1995 #, no-c-format msgid "" "An SP-GiST index can accelerate queries involving the following operators:" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1998 +#: using_postgis_dataman.xml:1997 #, no-c-format msgid "" "<<, &<, &>, >>, <<|, &<|, |&>, " @@ -3613,25 +3612,25 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:1999 +#: using_postgis_dataman.xml:1998 #, no-c-format msgid "&/&, ~==, @>>, and <<@, for 3-dimensional indexes." msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2001 +#: using_postgis_dataman.xml:2000 #, no-c-format msgid "There is no support for kNN searches at the moment." msgstr "" #. Tag: title -#: using_postgis_dataman.xml:2004 +#: using_postgis_dataman.xml:2003 #, no-c-format msgid "Using Indexes" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2006 +#: using_postgis_dataman.xml:2005 #, no-c-format msgid "" "Ordinarily, indexes invisibly speed up data access: once the index is built, " @@ -3643,7 +3642,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2013 +#: using_postgis_dataman.xml:2012 #, no-c-format msgid "" "If you find your spatial indexes are not being used (or your attribute " @@ -3651,7 +3650,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2019 +#: using_postgis_dataman.xml:2018 #, no-c-format msgid "" "Firstly, read query plan and check your query actually tries to compute the " @@ -3661,7 +3660,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2026 +#: using_postgis_dataman.xml:2025 #, no-c-format msgid "" "Second, make sure statistics are gathered about the number and distributions " @@ -3671,7 +3670,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2031 +#: using_postgis_dataman.xml:2030 #, no-c-format msgid "" "You should regularly vacuum your databases anyways - many PostgreSQL DBAs " @@ -3680,7 +3679,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2036 +#: using_postgis_dataman.xml:2035 #, no-c-format msgid "" "If vacuuming does not help, you can temporarily force the planner to use the " @@ -3694,7 +3693,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2048 +#: using_postgis_dataman.xml:2047 #, no-c-format msgid "" "If set enable_seqscan to off; helps your query to run, " @@ -3707,7 +3706,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2058 +#: using_postgis_dataman.xml:2057 #, no-c-format msgid "" "If set enable_seqscan to off; does not help your query, " @@ -3717,13 +3716,13 @@ msgid "" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:2069 +#: using_postgis_dataman.xml:2068 #, no-c-format msgid "Complex Queries" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2071 +#: using_postgis_dataman.xml:2070 #, no-c-format msgid "" "The raison d'etre of spatial database functionality is " @@ -3738,7 +3737,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2079 +#: using_postgis_dataman.xml:2078 #, no-c-format msgid "" "If your reason is because you are modeling something that doesn't have a " @@ -3751,7 +3750,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2083 +#: using_postgis_dataman.xml:2082 #, no-c-format msgid "" "Even in the case where you are planning a Mars expedition to transport the " @@ -3766,13 +3765,13 @@ msgid "" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:2089 +#: using_postgis_dataman.xml:2088 #, no-c-format msgid "Taking Advantage of Indexes" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2091 +#: using_postgis_dataman.xml:2090 #, no-c-format msgid "" "When constructing a query it is important to remember that only the bounding-" @@ -3783,7 +3782,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2098 +#: using_postgis_dataman.xml:2097 #, no-c-format msgid "" "SELECT the_geom\n" @@ -3792,7 +3791,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2100 +#: using_postgis_dataman.xml:2099 #, no-c-format msgid "" "This query is selecting all the geometries in geom_table which are within " @@ -3804,7 +3803,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2108 +#: using_postgis_dataman.xml:2107 #, no-c-format msgid "" "SELECT the_geom\n" @@ -3813,7 +3812,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2110 +#: using_postgis_dataman.xml:2109 #, no-c-format msgid "" "This query selects the same geometries, but it does it in a more efficient " @@ -3830,13 +3829,13 @@ msgid "" msgstr "" #. Tag: title -#: using_postgis_dataman.xml:2125 +#: using_postgis_dataman.xml:2124 #, no-c-format msgid "Examples of Spatial SQL" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2127 +#: using_postgis_dataman.xml:2126 #, no-c-format msgid "" "The examples in this section will make use of two tables, a table of linear " @@ -3845,7 +3844,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2131 +#: using_postgis_dataman.xml:2130 #, no-c-format msgid "" "Column | Type | Description\n" @@ -3856,14 +3855,14 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2133 +#: using_postgis_dataman.xml:2132 #, no-c-format msgid "" "The table definition for the bc_municipality table is:" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2136 +#: using_postgis_dataman.xml:2135 #, no-c-format msgid "" "Column | Type | Description\n" @@ -3875,19 +3874,19 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2141 +#: using_postgis_dataman.xml:2140 #, no-c-format msgid "What is the total length of all roads, expressed in kilometers?" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2146 +#: using_postgis_dataman.xml:2145 #, no-c-format msgid "You can answer this question with a very simple piece of SQL:" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2149 +#: using_postgis_dataman.xml:2148 #, no-c-format msgid "" "SELECT sum(ST_Length(the_geom))/1000 AS km_roads FROM bc_roads;\n" @@ -3899,13 +3898,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2155 +#: using_postgis_dataman.xml:2154 #, no-c-format msgid "How large is the city of Prince George, in hectares?" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2159 +#: using_postgis_dataman.xml:2158 #, no-c-format msgid "" "This query combines an attribute condition (on the municipality name) with a " @@ -3913,7 +3912,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2163 +#: using_postgis_dataman.xml:2162 #, no-c-format msgid "" "SELECT\n" @@ -3928,13 +3927,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2169 +#: using_postgis_dataman.xml:2168 #, no-c-format msgid "What is the largest municipality in the province, by area?" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2174 +#: using_postgis_dataman.xml:2173 #, no-c-format msgid "" "This query brings a spatial measurement into the query condition. There are " @@ -3942,7 +3941,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2178 +#: using_postgis_dataman.xml:2177 #, no-c-format msgid "" "SELECT\n" @@ -3960,7 +3959,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2180 +#: using_postgis_dataman.xml:2179 #, no-c-format msgid "" "Note that in order to answer this query we have to calculate the area of " @@ -3972,13 +3971,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2192 +#: using_postgis_dataman.xml:2191 #, no-c-format msgid "What is the length of roads fully contained within each municipality?" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2197 +#: using_postgis_dataman.xml:2196 #, no-c-format msgid "" "This is an example of a \"spatial join\", because we are bringing together " @@ -3988,7 +3987,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2203 +#: using_postgis_dataman.xml:2202 #, no-c-format msgid "" "SELECT\n" @@ -4013,7 +4012,7 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2205 +#: using_postgis_dataman.xml:2204 #, no-c-format msgid "" "This query takes a while, because every road in the table is summarized into " @@ -4023,13 +4022,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2214 +#: using_postgis_dataman.xml:2213 #, 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:2219 +#: using_postgis_dataman.xml:2218 #, no-c-format msgid "" "This is an example of an \"overlay\", which takes in two tables and outputs " @@ -4040,7 +4039,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2226 +#: using_postgis_dataman.xml:2225 #, no-c-format msgid "" "CREATE TABLE pg_roads as\n" @@ -4057,13 +4056,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2232 +#: using_postgis_dataman.xml:2231 #, no-c-format msgid "What is the length in kilometers of \"Douglas St\" in Victoria?" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2237 +#: using_postgis_dataman.xml:2236 #, no-c-format msgid "" "SELECT\n" @@ -4083,13 +4082,13 @@ msgid "" msgstr "" #. Tag: para -#: using_postgis_dataman.xml:2243 +#: using_postgis_dataman.xml:2242 #, no-c-format msgid "What is the largest municipality polygon that has a hole?" msgstr "" #. Tag: programlisting -#: using_postgis_dataman.xml:2248 +#: using_postgis_dataman.xml:2247 #, no-c-format msgid "" "SELECT gid, name, ST_Area(the_geom) AS area\n" diff --git a/doc/po/templates/using_raster_dataman.xml.pot b/doc/po/templates/using_raster_dataman.xml.pot index a0087070b..e0a82825d 100644 --- a/doc/po/templates/using_raster_dataman.xml.pot +++ b/doc/po/templates/using_raster_dataman.xml.pot @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2017-01-28 07:03+0000\n" +"Report-Msgid-Bugs-To: https://bugs.kde.org\n" +"POT-Creation-Date: 2019-08-03 21:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -358,103 +358,97 @@ msgid "Optional parameters used to manipulate database objects" msgstr "" #. Tag: term -#: using_raster_dataman.xml:206 using_raster_dataman.xml:235 +#: using_raster_dataman.xml:206 #, no-c-format -msgid "-q" +msgid "-f COLUMN" msgstr "" #. Tag: para #: using_raster_dataman.xml:208 #, no-c-format -msgid "Wrap PostgreSQL identifiers in quotes" +msgid "Specify name of destination raster column, default is 'rast'" msgstr "" #. Tag: term -#: using_raster_dataman.xml:213 +#: using_raster_dataman.xml:214 #, no-c-format -msgid "-f COLUMN" +msgid "-F" msgstr "" #. Tag: para -#: using_raster_dataman.xml:215 +#: using_raster_dataman.xml:216 #, no-c-format -msgid "Specify name of destination raster column, default is 'rast'" +msgid "Add a column with the name of the file" msgstr "" #. Tag: term #: using_raster_dataman.xml:221 #, no-c-format -msgid "-F" +msgid "-n COLUMN" msgstr "" #. Tag: para #: using_raster_dataman.xml:223 #, no-c-format -msgid "Add a column with the name of the file" +msgid "Specify the name of the filename column. Implies -F." msgstr "" #. Tag: term #: using_raster_dataman.xml:228 #, no-c-format -msgid "-n COLUMN" +msgid "-q" msgstr "" #. Tag: para #: using_raster_dataman.xml:230 #, no-c-format -msgid "Specify the name of the filename column. Implies -F." -msgstr "" - -#. Tag: para -#: using_raster_dataman.xml:237 -#, no-c-format msgid "Wrap PostgreSQL identifiers in quotes." msgstr "" #. Tag: term -#: using_raster_dataman.xml:242 +#: using_raster_dataman.xml:235 #, no-c-format msgid "-I" msgstr "" #. Tag: para -#: using_raster_dataman.xml:244 +#: using_raster_dataman.xml:237 #, no-c-format msgid "Create a GiST index on the raster column." msgstr "" #. Tag: term -#: using_raster_dataman.xml:251 +#: using_raster_dataman.xml:244 #, no-c-format msgid "-M" msgstr "" #. Tag: para -#: using_raster_dataman.xml:253 +#: using_raster_dataman.xml:246 #, no-c-format msgid "Vacuum analyze the raster table." msgstr "" #. Tag: term -#: using_raster_dataman.xml:261 +#: using_raster_dataman.xml:254 #, no-c-format msgid "-k" msgstr "" #. Tag: para -#: using_raster_dataman.xml:263 +#: using_raster_dataman.xml:256 #, no-c-format msgid "Skip NODATA value checks for each raster band." msgstr "" #. Tag: term -#: using_raster_dataman.xml:271 +#: using_raster_dataman.xml:264 #, no-c-format msgid "-T tablespace" msgstr "" #. Tag: para -#: using_raster_dataman.xml:273 +#: using_raster_dataman.xml:266 #, no-c-format msgid "" "Specify the tablespace for the new table. Note that indices (including the " @@ -463,13 +457,13 @@ msgid "" msgstr "" #. Tag: term -#: using_raster_dataman.xml:282 +#: using_raster_dataman.xml:275 #, no-c-format msgid "-X tablespace" msgstr "" #. Tag: para -#: using_raster_dataman.xml:284 +#: using_raster_dataman.xml:277 #, no-c-format msgid "" "Specify the tablespace for the table's new index. This applies to the " @@ -477,37 +471,37 @@ msgid "" msgstr "" #. Tag: term -#: using_raster_dataman.xml:293 +#: using_raster_dataman.xml:286 #, no-c-format msgid "-Y" msgstr "" #. Tag: para -#: using_raster_dataman.xml:295 +#: using_raster_dataman.xml:288 #, no-c-format msgid "Use copy statements instead of insert statements." msgstr "" #. Tag: term -#: using_raster_dataman.xml:306 +#: using_raster_dataman.xml:299 #, no-c-format msgid "-e" msgstr "" #. Tag: para -#: using_raster_dataman.xml:307 +#: using_raster_dataman.xml:300 #, no-c-format msgid "Execute each statement individually, do not use a transaction." msgstr "" #. Tag: term -#: using_raster_dataman.xml:311 +#: using_raster_dataman.xml:304 #, no-c-format msgid "-E ENDIAN" msgstr "" #. Tag: para -#: using_raster_dataman.xml:312 +#: using_raster_dataman.xml:305 #, no-c-format msgid "" "Control endianness of generated binary output of raster; specify 0 for XDR " @@ -515,13 +509,13 @@ msgid "" msgstr "" #. Tag: term -#: using_raster_dataman.xml:316 +#: using_raster_dataman.xml:309 #, no-c-format msgid "-V version" msgstr "" #. Tag: para -#: using_raster_dataman.xml:317 +#: using_raster_dataman.xml:310 #, no-c-format msgid "" "Specify version of output format. Default is 0. Only 0 is supported at this " @@ -529,7 +523,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:320 +#: using_raster_dataman.xml:313 #, no-c-format msgid "" "An example session using the loader to create an input file and uploading it " @@ -537,7 +531,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:321 +#: using_raster_dataman.xml:314 #, no-c-format msgid "" "You can leave the schema name out e.g demelevation " @@ -546,7 +540,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:323 +#: using_raster_dataman.xml:316 #, no-c-format msgid "" "raster2pgsql -s 4326 -I -C -M *.tif -F -t 100x100 public.demelevation > elev." @@ -555,13 +549,13 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:325 +#: using_raster_dataman.xml:318 #, 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:327 +#: using_raster_dataman.xml:320 #, no-c-format msgid "" "raster2pgsql -s 4326 -I -C -M *.tif -F -t 100x100 public.demelevation | psql " @@ -569,7 +563,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:329 +#: using_raster_dataman.xml:322 #, no-c-format msgid "" "Load rasters Massachusetts state plane meters aerial tiles into a schema " @@ -583,7 +577,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:331 +#: using_raster_dataman.xml:324 #, no-c-format msgid "" "raster2pgsql -I -C -e -Y -F -s 26986 -t 128x128 -l 2,4 bostonaerials2008/*." @@ -591,7 +585,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:333 +#: using_raster_dataman.xml:326 #, no-c-format msgid "" "--get a list of raster types supported:\n" @@ -599,13 +593,13 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:335 +#: using_raster_dataman.xml:328 #, no-c-format msgid "The -G commands outputs a list something like" msgstr "" #. Tag: screen -#: using_raster_dataman.xml:336 +#: using_raster_dataman.xml:329 #, no-c-format msgid "" "Available GDAL raster formats:\n" @@ -709,13 +703,13 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:339 +#: using_raster_dataman.xml:332 #, no-c-format msgid "Creating rasters using PostGIS raster functions" msgstr "" #. Tag: para -#: using_raster_dataman.xml:340 +#: using_raster_dataman.xml:333 #, no-c-format msgid "" "On many occasions, you'll want to create rasters and raster tables right in " @@ -724,7 +718,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:342 +#: using_raster_dataman.xml:335 #, no-c-format msgid "" "Create a table with a raster column to hold the new raster records which can " @@ -732,13 +726,13 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:343 +#: using_raster_dataman.xml:336 #, no-c-format msgid "CREATE TABLE myrasters(rid serial primary key, rast raster);" msgstr "" #. Tag: para -#: using_raster_dataman.xml:346 +#: using_raster_dataman.xml:339 #, no-c-format msgid "" "There are many functions to help with that goal. If you are creating rasters " @@ -748,7 +742,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:348 +#: using_raster_dataman.xml:341 #, no-c-format msgid "" "You can also create rasters from geometries. To achieve that you'll want to " @@ -759,7 +753,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:350 +#: using_raster_dataman.xml:343 #, no-c-format msgid "" "There are even many more options for creating new raster tables from " @@ -768,7 +762,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:352 +#: using_raster_dataman.xml:345 #, no-c-format msgid "" "Once you are done populating your table initially, you'll want to create a " @@ -776,7 +770,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:353 +#: using_raster_dataman.xml:346 #, no-c-format msgid "" "CREATE INDEX myrasters_rast_st_convexhull_idx ON myrasters USING " @@ -784,7 +778,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:354 +#: using_raster_dataman.xml:347 #, no-c-format msgid "" "Note the use of since most raster " @@ -792,7 +786,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:355 +#: using_raster_dataman.xml:348 #, no-c-format msgid "" "Pre-2.0 versions of PostGIS raster were based on the envelop rather than the " @@ -801,20 +795,20 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:356 +#: using_raster_dataman.xml:349 #, no-c-format msgid "" "Apply raster constraints using " msgstr "" #. Tag: title -#: using_raster_dataman.xml:361 +#: using_raster_dataman.xml:354 #, no-c-format msgid "Raster Catalogs" msgstr "" #. Tag: para -#: using_raster_dataman.xml:362 +#: using_raster_dataman.xml:355 #, no-c-format msgid "" "There are two raster catalog views that come packaged with PostGIS. Both " @@ -824,7 +818,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:366 +#: using_raster_dataman.xml:359 #, no-c-format msgid "" "raster_columns this view catalogs all the raster table " @@ -832,7 +826,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:369 +#: using_raster_dataman.xml:362 #, no-c-format msgid "" "raster_overviews this view catalogs all the raster table " @@ -842,13 +836,13 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:373 +#: using_raster_dataman.xml:366 #, no-c-format msgid "Raster Columns Catalog" msgstr "" #. Tag: para -#: using_raster_dataman.xml:374 +#: using_raster_dataman.xml:367 #, no-c-format msgid "" "The raster_columns is a catalog of all raster table " @@ -859,7 +853,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:376 +#: using_raster_dataman.xml:369 #, no-c-format msgid "" "If you created your tables not with the loader or forgot to specify the " @@ -870,7 +864,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:381 +#: using_raster_dataman.xml:374 #, no-c-format msgid "" "r_table_catalog The database the table is in. This will " @@ -878,7 +872,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:384 +#: using_raster_dataman.xml:377 #, no-c-format msgid "" "r_table_schema The database schema the raster table " @@ -886,13 +880,13 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:387 +#: using_raster_dataman.xml:380 #, no-c-format msgid "r_table_name raster table" msgstr "" #. Tag: para -#: using_raster_dataman.xml:390 +#: using_raster_dataman.xml:383 #, no-c-format msgid "" "r_raster_column the column in the r_table_namesrid The spatial reference identifier of the raster. " @@ -911,7 +905,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:396 +#: using_raster_dataman.xml:389 #, no-c-format msgid "" "scale_x The scaling between geometric spatial coordinates " @@ -921,7 +915,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:399 +#: using_raster_dataman.xml:392 #, no-c-format msgid "" "scale_y The scaling between geometric spatial coordinates " @@ -932,7 +926,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:402 +#: using_raster_dataman.xml:395 #, no-c-format msgid "" "blocksize_x The width (number of pixels across) of each " @@ -940,7 +934,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:405 +#: using_raster_dataman.xml:398 #, no-c-format msgid "" "blocksize_y The width (number of pixels down) of each " @@ -948,7 +942,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:408 +#: using_raster_dataman.xml:401 #, no-c-format msgid "" "same_alignment A boolean that is true if all the raster " @@ -957,7 +951,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:411 +#: using_raster_dataman.xml:404 #, no-c-format msgid "" "regular_blocking If the raster column has the spatially " @@ -966,7 +960,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:414 +#: using_raster_dataman.xml:407 #, no-c-format msgid "" "num_bands The number of bands in each tile of your raster " @@ -974,7 +968,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:417 +#: using_raster_dataman.xml:410 #, no-c-format msgid "" "pixel_types An array defining the pixel type for each " @@ -984,7 +978,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:420 +#: using_raster_dataman.xml:413 #, no-c-format msgid "" "nodata_values An array of double precision numbers " @@ -996,7 +990,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:423 +#: using_raster_dataman.xml:416 #, no-c-format msgid "" "out_db An array of boolean flags indicating if the raster " @@ -1005,7 +999,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:426 +#: using_raster_dataman.xml:419 #, no-c-format msgid "" "extent This is the extent of all the raster rows in your " @@ -1016,7 +1010,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:429 +#: using_raster_dataman.xml:422 #, no-c-format msgid "" "spatial_index A boolean that is true if raster column has " @@ -1024,13 +1018,13 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:434 +#: using_raster_dataman.xml:427 #, no-c-format msgid "Raster Overviews" msgstr "" #. Tag: para -#: using_raster_dataman.xml:435 +#: using_raster_dataman.xml:428 #, no-c-format msgid "" "raster_overviews catalogs information about raster table " @@ -1045,7 +1039,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:436 +#: using_raster_dataman.xml:429 #, no-c-format msgid "" "Overview tables contain the same constraints as other raster tables as well " @@ -1053,7 +1047,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:437 +#: using_raster_dataman.xml:430 #, no-c-format msgid "" "The information in raster_overviews does not duplicate " @@ -1065,13 +1059,13 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:438 +#: using_raster_dataman.xml:431 #, no-c-format msgid "Two main reasons for overviews are:" msgstr "" #. Tag: para -#: using_raster_dataman.xml:440 +#: using_raster_dataman.xml:433 #, no-c-format msgid "" "Low resolution representation of the core tables commonly used for fast " @@ -1079,7 +1073,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:441 +#: using_raster_dataman.xml:434 #, no-c-format msgid "" "Computations are generally faster to do on them than their higher resolution " @@ -1090,7 +1084,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:444 +#: using_raster_dataman.xml:437 #, no-c-format msgid "" "The raster_overviews catalog contains the following " @@ -1098,7 +1092,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:447 +#: using_raster_dataman.xml:440 #, no-c-format msgid "" "o_table_catalog The database the overview table is in. " @@ -1106,7 +1100,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:450 +#: using_raster_dataman.xml:443 #, no-c-format msgid "" "o_table_schema The database schema the overview raster " @@ -1114,20 +1108,20 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:453 +#: using_raster_dataman.xml:446 #, no-c-format msgid "o_table_name raster overview table name" msgstr "" #. Tag: para -#: using_raster_dataman.xml:456 +#: using_raster_dataman.xml:449 #, no-c-format msgid "" "o_raster_column the raster column in the overview table." msgstr "" #. Tag: para -#: using_raster_dataman.xml:460 +#: using_raster_dataman.xml:453 #, no-c-format msgid "" "r_table_catalog The database the raster table that this " @@ -1135,7 +1129,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:463 +#: using_raster_dataman.xml:456 #, no-c-format msgid "" "r_table_schema The database schema the raster table that " @@ -1143,14 +1137,14 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:466 +#: using_raster_dataman.xml:459 #, no-c-format msgid "" "r_table_name raster table that this overview services." msgstr "" #. Tag: para -#: using_raster_dataman.xml:469 +#: using_raster_dataman.xml:462 #, no-c-format msgid "" "r_raster_column the raster column that this overview " @@ -1158,7 +1152,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:472 +#: using_raster_dataman.xml:465 #, no-c-format msgid "" "overview_factor - this is the pyramid level of the " @@ -1178,13 +1172,13 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:484 +#: using_raster_dataman.xml:477 #, no-c-format msgid "Building Custom Applications with PostGIS Raster" msgstr "" #. Tag: para -#: using_raster_dataman.xml:485 +#: using_raster_dataman.xml:478 #, no-c-format msgid "" "The fact that PostGIS raster provides you with SQL functions to render " @@ -1198,14 +1192,14 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:488 +#: using_raster_dataman.xml:481 #, no-c-format msgid "" "PHP Example Outputting using ST_AsPNG in concert with other raster functions" msgstr "" #. Tag: para -#: using_raster_dataman.xml:489 +#: using_raster_dataman.xml:482 #, no-c-format msgid "" "In this section, we'll demonstrate how to use the PHP PostgreSQL driver and " @@ -1215,7 +1209,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:492 using_raster_dataman.xml:504 +#: using_raster_dataman.xml:485 using_raster_dataman.xml:497 #, no-c-format msgid "" "The sample query demonstrates how to combine a whole bunch of raster " @@ -1227,7 +1221,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:495 +#: using_raster_dataman.xml:488 #, no-c-format msgid "" "You would call the below using http://mywebserver/" @@ -1236,7 +1230,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:496 +#: using_raster_dataman.xml:489 #, no-c-format msgid "" " except implemented " @@ -1307,7 +1301,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:508 +#: using_raster_dataman.xml:501 #, no-c-format msgid "" "You would call the below using http://mywebserver/TestRaster." @@ -1316,7 +1310,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:509 +#: using_raster_dataman.xml:502 #, no-c-format msgid "" "-- web.config connection string section --\n" @@ -1328,7 +1322,7 @@ msgid "" msgstr "" #. Tag: programlisting -#: using_raster_dataman.xml:510 +#: using_raster_dataman.xml:503 #, no-c-format msgid "" "// Code for TestRaster.ashx\n" @@ -1402,13 +1396,13 @@ msgid "" msgstr "" #. Tag: title -#: using_raster_dataman.xml:513 +#: using_raster_dataman.xml:506 #, no-c-format msgid "Java console app that outputs raster query as Image file" msgstr "" #. Tag: para -#: using_raster_dataman.xml:514 +#: using_raster_dataman.xml:507 #, no-c-format msgid "" "This is a simple java console app that takes a query that returns one image " @@ -1416,7 +1410,7 @@ msgid "" msgstr "" #. Tag: para -#: using_raster_dataman.xml:515 +#: using_raster_dataman.xml:508 #, no-c-format msgid "" "You can download the latest PostgreSQL JDBC drivers from